cursorconnect 0.1.11 → 0.1.12

package/bridge-runtime/connector-version.json

@@ -1 +1 @@
-{"cliVersion":"0.1.11","bundledAt":"2026-05-26T11:25:16Z"}
+{"cliVersion":"0.1.12","bundledAt":"2026-05-26T12:45:47Z"}

package/bridge-runtime/dist/agent-title-match.d.ts

@@ -5,6 +5,10 @@ export declare function agentTitleMatchScore(sidebarTitle: string, jsonlLabel: s
 export declare function findAgentById(jsonl: AgentsIndex, agentId: string): AgentSummary | undefined;
 /** Best JSONL agent for a Cursor sidebar row (generated title vs first user message). */
 export declare function matchJsonlAgentForSidebarTitle(rowTitle: string, jsonl: AgentsIndex, composerIdByTitle?: Record<string, string>): AgentSummary | undefined;
+export declare function resolveComposerUuidFromPartial(partialId: string, opts?: {
+    composerIdByTitle?: Record<string, string>;
+    agentsIndex?: AgentsIndex;
+}): string | undefined;
 export declare function isSyntheticAgentId(agentId: string): boolean;
 export type ResolveJsonlOpts = {
     title?: string;

package/bridge-runtime/dist/agent-title-match.js

@@ -1,6 +1,7 @@
 import { basename, join } from 'path';
 import { existsSync, readdirSync, readFileSync } from 'fs';
 import { normalizeComposerTitle, titlesAlign } from './composer-title-index.js';
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 export function normalizeAgentTitle(title) {
     return title
         .trim()
@@ -83,6 +84,61 @@ export function matchJsonlAgentForSidebarTitle(rowTitle, jsonl, composerIdByTitl
     }
     return best?.agent;
 }
+/** Editor auxiliary tabs expose truncated `data-resource-name` — match folder prefix. */
+function findJsonlAgentIdByFolderPrefix(projectsDir, prefix) {
+    const p = prefix.toLowerCase().replace(/[^0-9a-f-]/g, '');
+    if (p.length < 32)
+        return null;
+    if (!existsSync(projectsDir))
+        return null;
+    for (const project of readdirSync(projectsDir, { withFileTypes: true })) {
+        if (!project.isDirectory())
+            continue;
+        const base = join(projectsDir, project.name, 'agent-transcripts');
+        if (!existsSync(base))
+            continue;
+        const hit = walkFolderPrefix(base, p, 0);
+        if (hit)
+            return hit;
+    }
+    return null;
+}
+function walkFolderPrefix(dir, prefix, depth) {
+    if (depth > 5 || !existsSync(dir))
+        return null;
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+        if (!entry.isDirectory())
+            continue;
+        const name = entry.name.toLowerCase();
+        if (name.startsWith(prefix) || prefix.startsWith(name)) {
+            const jsonl = join(dir, entry.name, `${entry.name}.jsonl`);
+            if (existsSync(jsonl))
+                return entry.name;
+        }
+        const nested = walkFolderPrefix(join(dir, entry.name), prefix, depth + 1);
+        if (nested)
+            return nested;
+    }
+    return null;
+}
+export function resolveComposerUuidFromPartial(partialId, opts) {
+    if (UUID_RE.test(partialId))
+        return partialId;
+    const p = partialId.toLowerCase();
+    if (p.length < 32 || !/^[0-9a-f-]/.test(p))
+        return undefined;
+    for (const uuid of Object.values(opts?.composerIdByTitle ?? {})) {
+        if (uuid.toLowerCase().startsWith(p))
+            return uuid;
+    }
+    for (const repo of opts?.agentsIndex?.repos ?? []) {
+        for (const agent of repo.agents) {
+            if (agent.id.toLowerCase().startsWith(p))
+                return agent.id;
+        }
+    }
+    return undefined;
+}
 function findJsonlByAgentId(projectsDir, agentId) {
     if (!existsSync(projectsDir))
         return null;
@@ -169,7 +225,6 @@ function collectJsonlAgents(projectsDir) {
     }
     return out;
 }
-const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 export function isSyntheticAgentId(agentId) {
     return (!agentId ||
         /^tab-\d+$/.test(agentId) ||
@@ -180,6 +235,11 @@ export function isSyntheticAgentId(agentId) {
 export function resolveJsonlAgentId(projectsDir, agentId, opts) {
     if (findJsonlByAgentId(projectsDir, agentId))
         return agentId;
+    const fromPartial = resolveComposerUuidFromPartial(agentId, {
+        composerIdByTitle: opts?.composerIdByTitle,
+    }) ?? findJsonlAgentIdByFolderPrefix(projectsDir, agentId);
+    if (fromPartial && findJsonlByAgentId(projectsDir, fromPartial))
+        return fromPartial;
     const title = opts?.title?.trim();
     const map = opts?.composerIdByTitle;
     if (title && map) {

package/bridge-runtime/dist/cdp-bridge.js

@@ -1,5 +1,6 @@
 import { EventEmitter } from 'events';
 import { CdpClient } from './cdp-client.js';
+import { annotateWindowKind } from './cursor-window-kind.js';
 import { detectForegroundTargetId } from './focused-window.js';
 export class CDPBridge extends EventEmitter {
     config;
@@ -41,7 +42,7 @@ export class CDPBridge extends EventEmitter {
             const targets = (await res.json());
             this.windows = targets
                 .filter((t) => t.type === 'page' && t.url.includes('workbench'))
-                .map((t) => ({
+                .map((t) => annotateWindowKind({
                 id: t.id,
                 title: parseWindowTitle(t.title),
                 workspace: parseWindowTitle(t.title),

package/bridge-runtime/dist/chat-sync.js

@@ -19,6 +19,9 @@ function lookupComposerIdByTitle(title, map) {
 }
 export function resolveCursorActiveComposerId(state) {
     const activeTab = state.tabs.find((t) => t.active);
+    if (activeTab?.composerId && isComposerUuid(activeTab.composerId)) {
+        return activeTab.composerId;
+    }
     if (isComposerUuid(state.activeComposerId))
         return state.activeComposerId;
     const fromTabTitle = lookupComposerIdByTitle(activeTab?.title, state.composerIdByTitle);

package/bridge-runtime/dist/command-executor.d.ts

@@ -20,6 +20,8 @@ export declare class CommandExecutor {
     private clearComposerAttachments;
     /** Empty Cursor composer (DOM + keyboard). */
     private clearComposerInput;
+    /** Replace composer text (after unqueue / restore). */
+    private setComposerInputText;
     /** Put saved Cursor draft back after send from Connect (avoids merging with phone text). */
     private restoreComposerDraft;
     private focusComposerInput;

package/bridge-runtime/dist/command-executor.js

@@ -1,5 +1,8 @@
 import { existsSync } from 'fs';
 import { clearComposerAttachmentsScript, clearComposerInputScript, extractComposerDraftImagesScript, } from './composer-images.js';
+import { generationStopDomAction } from './generation-stop-dom.js';
+import { focusEditorAuxiliaryTab } from './editor-tab-focus-dom.js';
+import { queueRemoveDomAction } from './queue-remove-dom.js';
 import { isPathUnderUploadDir } from './image-upload-store.js';
 const RETRY_DELAY_MS = 400;
 export class CommandExecutor {
@@ -37,8 +40,38 @@ export class CommandExecutor {
                     return await this.approveAll(cmd);
                 case 'start_multitasking':
                     return await this.clickByLabel(cmd, 'Start Multitasking');
-                case 'remove_queued':
-                    return await this.clickSelector(cmd, cmd.selectorPath);
+                case 'remove_queued': {
+                    const client = this.client;
+                    if (!client)
+                        return { id: cmd.id, ok: false, error: 'No CDP client' };
+                    if (cmd.agentId) {
+                        const focused = await this.focusAgent(cmd.agentId, cmd.id, cmd.tabTitle);
+                        if (!focused.ok && !cmd.text?.trim()) {
+                            return { id: cmd.id, ok: false, error: focused.error };
+                        }
+                        if (focused.ok)
+                            await sleep(350);
+                    }
+                    const removed = (await client.callFunction(queueRemoveDomAction, 'remove', { text: cmd.text?.trim(), selectorPath: cmd.selectorPath }));
+                    if (!removed?.ok) {
+                        return {
+                            id: cmd.id,
+                            ok: false,
+                            error: removed?.reason ?? 'Queue item not found in Cursor',
+                        };
+                    }
+                    await sleep(350);
+                    const restoreText = cmd.text?.trim();
+                    if (restoreText) {
+                        await this.setComposerInputText(restoreText);
+                    }
+                    const composerDraft = await this.readComposerDraft();
+                    return {
+                        id: cmd.id,
+                        ok: true,
+                        composerDraft: restoreText || composerDraft || undefined,
+                    };
+                }
                 case 'stop_agent':
                     return await this.stopAgent(cmd);
                 case 'click_selector':
@@ -76,12 +109,10 @@ export class CommandExecutor {
         }
         const inputStrategies = this.selectors.chatInput.strategies;
         const submitStrategies = this.selectors.submitButton.strategies;
-        const stopStrategies = this.selectors.stopButton.strategies;
         const wantQueue = cmd.queue === true || cmd.queue === 'true' || cmd.queue === '1';
         const prep = (await client.evaluate(`
       (() => {
         const inputSels = ${JSON.stringify(inputStrategies)};
-        const stopSels = ${JSON.stringify(stopStrategies)};
         const scopes = [
           document.querySelector('[class*="agent-panel"]'),
           document.querySelector('[class*="composer-panel"]'),
@@ -108,29 +139,15 @@ export class CommandExecutor {
         input.focus();
         (input).click();
 
-        let agentBusy = false;
-        for (const scope of scopes) {
-          for (const sel of stopSels) {
-            try {
-              const btn = scope.querySelector(sel);
-              if (!btn) continue;
-              const disabled =
-                btn.hasAttribute('disabled') || btn.getAttribute('aria-disabled') === 'true';
-              if (disabled) continue;
-              agentBusy = true;
-              break;
-            } catch {}
-          }
-          if (agentBusy) break;
-        }
-
-        return { ok: true, agentBusy };
+        return { ok: true, agentBusy: false };
       })()
     `));
         if (!prep?.ok) {
             return { id: cmd.id, ok: false, error: prep?.error ?? 'Chat input not found' };
         }
-        const shouldQueue = wantQueue || prep.agentBusy === true;
+        const agentBusy = (await client.callFunction(generationStopDomAction, 'has')) ===
+            true;
+        const shouldQueue = wantQueue || agentBusy;
         const savedDraft = await this.readComposerDraft();
         const savedDraftImages = await this.readComposerDraftImages();
         const sentFromConnect = Boolean(text || imagePaths.length > 0);
@@ -215,18 +232,32 @@ export class CommandExecutor {
             return { id: commandId, ok: false, error: 'No client or agentId' };
         }
         const tabSelectors = this.selectors.chatTabList.strategies;
+        const editorFocused = (await client.callFunction(focusEditorAuxiliaryTab, { title: chatTitle ?? '', agentId })) === true;
+        if (editorFocused) {
+            return { id: commandId, ok: true };
+        }
         const ok = await client.evaluate(`
       (() => {
         const wantId = ${JSON.stringify(agentId)};
         const wantTitle = ${JSON.stringify(chatTitle ?? '')};
         const selectors = ${JSON.stringify(tabSelectors)};
-        const norm = (s) => (s || '').trim().replace(/\\s+/g, ' ').replace(/\\d+\\s*(?:s|m|h|d|w)\\b/gi, '').replace(/\\d+[smhdw]$/i, '').trim().toLowerCase();
+        const stripEditorSuffix = (s) =>
+          (s || '').replace(/,\\s*Chat Editors:\\s*Editor Group\\s*\\d+\\s*$/i, '').trim();
+        const norm = (s) =>
+          stripEditorSuffix(s)
+            .replace(/\\s+/g, ' ')
+            .replace(/\\d+\\s*(?:s|m|h|d|w)\\b/gi, '')
+            .replace(/\\d+[smhdw]$/i, '')
+            .trim()
+            .toLowerCase();
         const titleNorm = wantTitle ? norm(wantTitle) : '';
         const wantNorm = wantId.startsWith('title:') ? wantId.slice(6) : norm(wantId);
         const tryClick = (el) => {
           if (!el) return false;
           el.scrollIntoView({ block: 'nearest', behavior: 'instant' });
-          (el).click();
+          el.dispatchEvent(new MouseEvent('mousedown', { bubbles: true, cancelable: true }));
+          el.dispatchEvent(new MouseEvent('mouseup', { bubbles: true, cancelable: true }));
+          el.click();
           return true;
         };
         const matchBtn = (btn) => {
@@ -407,37 +438,7 @@ export class CommandExecutor {
                 return { id: cmd.id, ok: false, error: focused.error };
             await sleep(350);
         }
-        const strategies = this.selectors.stopButton.strategies;
-        const ok = await client.evaluate(`
-      (() => {
-        const strategies = ${JSON.stringify(strategies)};
-        const scopes = [
-          document.querySelector('[class*="agent-panel"]'),
-          document.querySelector('[class*="composer-panel"]'),
-          document.querySelector('.composer-bar'),
-          document.querySelector('[class*="composer-bar"]'),
-          document,
-        ].filter(Boolean);
-        const tryClick = (btn) => {
-          if (!btn) return false;
-          const disabled =
-            btn.hasAttribute('disabled') || btn.getAttribute('aria-disabled') === 'true';
-          if (disabled) return false;
-          btn.scrollIntoView({ block: 'center' });
-          (btn).click();
-          return true;
-        };
-        for (const scope of scopes) {
-          for (const sel of strategies) {
-            try {
-              const btn = scope.querySelector(sel);
-              if (tryClick(btn)) return true;
-            } catch {}
-          }
-        }
-        return false;
-      })()
-    `);
+        const ok = (await client.callFunction(generationStopDomAction, 'click')) === true;
         if (!ok) {
             return { id: cmd.id, ok: false, error: 'Stop button not found (agent not running?)' };
         }
@@ -492,10 +493,38 @@ export class CommandExecutor {
         if (!(await this.focusComposerInput()))
             return;
         await sleep(80);
-        await client.pressKey('a', 'KeyA', 65, 2);
+        // CDP modifiers: 4=Meta (⌘ on Mac), 2=Ctrl — Lexical often ignores Ctrl+A on macOS.
+        await client.pressKey('a', 'KeyA', 65, 4);
         await sleep(40);
+        let left = (await this.readComposerDraft())?.trim() ?? '';
+        if (left) {
+            await client.pressKey('a', 'KeyA', 65, 2);
+            await sleep(40);
+        }
         await client.pressKey('Backspace', 'Backspace', 8);
         await sleep(80);
+        left = (await this.readComposerDraft())?.trim() ?? '';
+        if (left) {
+            try {
+                await client.evaluate(clearComposerInputScript(inputStrategies));
+            }
+            catch {
+                /* best-effort */
+            }
+        }
+    }
+    /** Replace composer text (after unqueue / restore). */
+    async setComposerInputText(text) {
+        const draft = text.trim();
+        if (!draft)
+            return;
+        await this.clearComposerInput();
+        const client = this.client;
+        if (!client || !(await this.focusComposerInput()))
+            return;
+        await sleep(80);
+        await client.typeText(draft);
+        await sleep(120);
     }
     /** Put saved Cursor draft back after send from Connect (avoids merging with phone text). */
     async restoreComposerDraft(text, imagePaths) {

package/bridge-runtime/dist/composer-images.js

@@ -78,24 +78,41 @@ export function clearComposerInputScript(inputSelectors) {
     input.scrollIntoView({ block: 'center' });
     input.focus();
     input.click();
+    const root = input.querySelector('[data-lexical-editor="true"]') || input;
     try {
       const sel = window.getSelection();
       const range = document.createRange();
-      range.selectNodeContents(input);
+      range.selectNodeContents(root);
       sel?.removeAllRanges();
       sel?.addRange(range);
       document.execCommand('selectAll', false, null);
       document.execCommand('delete', false, null);
     } catch {}
-    const left = (input.innerText || input.textContent || '')
+    const fireInput = () => {
+      root.dispatchEvent(
+        new InputEvent('input', { bubbles: true, inputType: 'deleteContentBackward' })
+      );
+    };
+    let left = (root.innerText || root.textContent || '')
       .replace(/\\u200b/g, ' ')
       .replace(/\\s+/g, ' ')
       .trim();
     if (left) {
-      input.textContent = '';
-      input.dispatchEvent(
-        new InputEvent('input', { bubbles: true, inputType: 'deleteContentBackward' })
-      );
+      root.textContent = '';
+      fireInput();
+      left = (root.innerText || root.textContent || '').trim();
+    }
+    if (left) {
+      try {
+        root.dispatchEvent(
+          new KeyboardEvent('keydown', { key: 'a', code: 'KeyA', metaKey: true, bubbles: true })
+        );
+        root.dispatchEvent(
+          new KeyboardEvent('keydown', { key: 'a', code: 'KeyA', ctrlKey: true, bubbles: true })
+        );
+        document.execCommand('delete', false, null);
+        fireInput();
+      } catch {}
     }
     return true;
   })()`;

package/bridge-runtime/dist/cursor-window-kind.d.ts

@@ -0,0 +1,10 @@
+import type { CursorWindowKind } from './types.js';
+/** CDP target title for the dedicated Agents window (not editor auxiliary bar). */
+export declare function isAgentsWindowTitle(title: string): boolean;
+export declare function windowKindFromTitle(title: string): CursorWindowKind;
+export declare function annotateWindowKind<T extends {
+    title: string;
+    kind?: CursorWindowKind;
+}>(win: T): T & {
+    kind: CursorWindowKind;
+};

package/bridge-runtime/dist/cursor-window-kind.js

@@ -0,0 +1,10 @@
+/** CDP target title for the dedicated Agents window (not editor auxiliary bar). */
+export function isAgentsWindowTitle(title) {
+    return /^cursor agents$/i.test(title.trim());
+}
+export function windowKindFromTitle(title) {
+    return isAgentsWindowTitle(title) ? 'agents' : 'editor';
+}
+export function annotateWindowKind(win) {
+    return { ...win, kind: win.kind ?? windowKindFromTitle(win.title) };
+}

package/bridge-runtime/dist/dom-extractor.d.ts

@@ -7,7 +7,7 @@ export declare class DOMExtractor {
     private onState;
     private containerMissStreak;
     private composerTitleIndex;
-    constructor(selectors: SelectorConfig, onState: (state: CursorState | null, error?: string) => void);
+    constructor(selectors: SelectorConfig, onState: (state: Partial<CursorState> | null, error?: string) => void);
     start(client: CdpClient, intervalMs: number): void;
     stop(): void;
     pollNow(): void;

package/bridge-runtime/dist/dom-extractor.js

@@ -54,7 +54,6 @@ export class DOMExtractor {
                 ...partial,
                 composerIdByTitle: this.composerTitleIndex.snapshot(),
                 pendingApprovals: partial.pendingApprovals ?? [],
-                windows: [],
                 updatedAt: Date.now(),
             });
         }

package/bridge-runtime/dist/editor-chat-list.d.ts

@@ -0,0 +1,6 @@
+import type { CursorState, RepoGroup } from './types.js';
+export type CursorListMode = 'agents-window' | 'editor';
+export declare function resolveCursorListMode(state: CursorState): CursorListMode;
+/** Editor layout: one Cursor editor window → repo folder; auxiliary-bar tabs → chats. */
+export declare function buildEditorRepos(state: CursorState): RepoGroup[];
+export declare function computeEditorListPatch(state: CursorState): Pick<CursorState, 'editorRepos' | 'cursorListMode'> | null;

package/bridge-runtime/dist/editor-chat-list.js

@@ -0,0 +1,79 @@
+import { normalizeAgentTitle, resolveComposerUuidFromPartial, } from './agent-title-match.js';
+import { windowKindFromTitle } from './cursor-window-kind.js';
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function resolveTabComposerId(tab, state) {
+    const raw = tab.composerId || tab.id;
+    if (UUID_RE.test(raw))
+        return raw;
+    const fromTitle = state.composerIdByTitle?.[normalizeAgentTitle(tab.title)];
+    if (fromTitle && UUID_RE.test(fromTitle))
+        return fromTitle;
+    const fromPartial = resolveComposerUuidFromPartial(raw, {
+        composerIdByTitle: state.composerIdByTitle,
+    });
+    if (fromPartial)
+        return fromPartial;
+    return raw;
+}
+export function resolveCursorListMode(state) {
+    const windows = state.windows ?? [];
+    const active = windows.find((w) => w.id === state.activeWindowId);
+    const activeKind = active?.kind ?? (active ? windowKindFromTitle(active.title) : undefined);
+    if (activeKind === 'editor')
+        return 'editor';
+    if (activeKind === 'agents')
+        return 'agents-window';
+    const hasEditor = windows.some((w) => (w.kind ?? windowKindFromTitle(w.title)) === 'editor');
+    if (hasEditor && !windows.some((w) => (w.kind ?? windowKindFromTitle(w.title)) === 'agents')) {
+        return 'editor';
+    }
+    return 'agents-window';
+}
+const EDITOR_SKIP_TAB = /^(new agent|marketplace)$/i;
+function tabToAgent(tab, winId, state) {
+    const isHome = winId === state.activeWindowId;
+    const composerId = resolveTabComposerId(tab, state);
+    let isWorking = tab.isWorking === true;
+    // Home window only: DOM may set isWorking on active tab after detectAgentWorking.
+    if (!isWorking && tab.active && isHome && state.agentWorking === true) {
+        isWorking = true;
+    }
+    return {
+        id: composerId,
+        title: tab.title,
+        updatedAt: Date.now(),
+        messageCount: 0,
+        isWorking,
+        hasUnread: tab.hasUnread,
+        needsAttention: tab.needsAttention,
+    };
+}
+/** Editor layout: one Cursor editor window → repo folder; auxiliary-bar tabs → chats. */
+export function buildEditorRepos(state) {
+    const editorWindows = (state.windows ?? []).filter((w) => (w.kind ?? windowKindFromTitle(w.title)) === 'editor');
+    if (!editorWindows.length)
+        return [];
+    const snapById = new Map((state.windowSnapshots ?? []).map((s) => [s.windowId, s]));
+    const homeId = state.activeWindowId;
+    return editorWindows.map((win) => {
+        const isHome = win.id === homeId;
+        const tabs = (isHome ? state.tabs ?? [] : snapById.get(win.id)?.tabs ?? []).filter((t) => t.title?.trim() && !EDITOR_SKIP_TAB.test(t.title.trim()));
+        return {
+            id: win.id,
+            name: win.title,
+            path: '',
+            agents: tabs.map((tab) => tabToAgent(tab, win.id, state)),
+        };
+    });
+}
+export function computeEditorListPatch(state) {
+    const editorRepos = buildEditorRepos(state);
+    const cursorListMode = resolveCursorListMode(state);
+    const prevRepos = state.editorRepos ?? [];
+    const prevMode = state.cursorListMode;
+    if (prevMode === cursorListMode &&
+        JSON.stringify(prevRepos) === JSON.stringify(editorRepos)) {
+        return null;
+    }
+    return { editorRepos, cursorListMode };
+}

package/bridge-runtime/dist/editor-list-sync.d.ts

@@ -0,0 +1,3 @@
+import type { StateManager } from './state-manager.js';
+/** Keeps `editorRepos` + `cursorListMode` in sync without touching agents:index flow. */
+export declare function installEditorListSync(stateManager: StateManager): void;

package/bridge-runtime/dist/editor-list-sync.js

@@ -0,0 +1,11 @@
+import { computeEditorListPatch } from './editor-chat-list.js';
+/** Keeps `editorRepos` + `cursorListMode` in sync without touching agents:index flow. */
+export function installEditorListSync(stateManager) {
+    const sync = () => {
+        const patch = computeEditorListPatch(stateManager.getState());
+        if (patch)
+            stateManager.patchNow(patch);
+    };
+    stateManager.on('state:patch', sync);
+    stateManager.on('state:full', sync);
+}

package/bridge-runtime/dist/editor-tab-focus-dom.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Focus an editor auxiliary-bar chat tab (VS Code workbench).
+ * CDP callFunction entry — keep helpers inside.
+ */
+export declare function focusEditorAuxiliaryTab(opts: {
+    title?: string;
+    agentId?: string;
+}): boolean;

package/bridge-runtime/dist/editor-tab-focus-dom.js

@@ -0,0 +1,80 @@
+/**
+ * Focus an editor auxiliary-bar chat tab (VS Code workbench).
+ * CDP callFunction entry — keep helpers inside.
+ */
+export function focusEditorAuxiliaryTab(opts) {
+    const wantTitle = (opts.title ?? '').trim();
+    const wantId = (opts.agentId ?? '').trim();
+    const stripEditorSuffix = (s) => s.replace(/,\s*Chat Editors:\s*Editor Group\s*\d+\s*$/i, '').trim();
+    const norm = (s) => stripEditorSuffix(s)
+        .replace(/\s+/g, ' ')
+        .replace(/\d+\s*(?:s|m|h|d|w)\b/gi, '')
+        .replace(/\d+[smhdw]$/i, '')
+        .trim()
+        .toLowerCase();
+    const titleNorm = wantTitle ? norm(wantTitle) : '';
+    const wantLower = wantId.toLowerCase();
+    const aux = document.querySelector('#workbench\\.parts\\.auxiliarybar');
+    if (!aux || document.querySelector('[class*="agent-panel"]'))
+        return false;
+    function titleMatches(aria, visible) {
+        if (!titleNorm)
+            return false;
+        const ariaNorm = aria ? norm(aria) : '';
+        const visibleNorm = visible ? norm(visible) : '';
+        const candidates = [ariaNorm, visibleNorm].filter(Boolean);
+        for (const c of candidates) {
+            if (c === titleNorm)
+                return true;
+            if (c.length >= 8 && titleNorm.length >= 8 && (c.includes(titleNorm) || titleNorm.includes(c))) {
+                return true;
+            }
+        }
+        return false;
+    }
+    function idMatches(resource) {
+        if (wantLower.length < 8 || !resource)
+            return false;
+        const r = resource.toLowerCase();
+        if (r === wantLower)
+            return true;
+        if (wantLower.length >= 32 && (r.startsWith(wantLower) || wantLower.startsWith(r)))
+            return true;
+        if (wantLower.length >= 8 && r.length >= 32 && r.startsWith(wantLower))
+            return true;
+        return false;
+    }
+    function activateTab(tab) {
+        const el = tab;
+        el.scrollIntoView({ block: 'nearest', behavior: 'instant' });
+        const label = tab.querySelector('.label-name, .tab-label, [class*="label-name"]') || tab;
+        const target = label ?? el;
+        target.dispatchEvent(new MouseEvent('mousedown', { bubbles: true, cancelable: true }));
+        target.dispatchEvent(new MouseEvent('mouseup', { bubbles: true, cancelable: true }));
+        target.click();
+    }
+    const tabs = aux.querySelectorAll('div.tab[role="tab"]');
+    for (const tab of tabs) {
+        const aria = tab.getAttribute('aria-label') || '';
+        const visible = (tab.textContent || '').trim();
+        const resource = tab.getAttribute('data-resource-name') || '';
+        if (!titleMatches(aria, visible) && !idMatches(resource))
+            continue;
+        activateTab(tab);
+        const active = aux.querySelector('div.tab[role="tab"].active, div.tab[role="tab"][aria-selected="true"]');
+        if (!active)
+            return true;
+        const activeAria = active.getAttribute('aria-label') || '';
+        const activeVisible = (active.textContent || '').trim();
+        if (titleNorm && !titleMatches(activeAria, activeVisible)) {
+            return false;
+        }
+        if (wantLower.length >= 32 && resource) {
+            const activeRes = active.getAttribute('data-resource-name') || '';
+            if (!idMatches(activeRes) && activeRes.toLowerCase() !== wantLower)
+                return false;
+        }
+        return true;
+    }
+    return false;
+}

package/bridge-runtime/dist/extract-page.d.ts

@@ -3,5 +3,5 @@ import type { ExtractedPageState, SelectorConfig } from './types.js';
 /**
  * Runs inside Cursor renderer — must be self-contained.
  */
-export declare function extractionFunction(containerSelectors: string[], tabSelectors: string[], inputSelectors: string[], approveSelectors: string[], approveTextMatch: string[], rejectSelectors: string[], rejectTextMatch: string[]): ExtractedPageState | null;
+export declare function extractionFunction(containerSelectors: string[], tabSelectors: string[], editorAuxiliaryTabSelectors: string[], inputSelectors: string[], approveSelectors: string[], approveTextMatch: string[], rejectSelectors: string[], rejectTextMatch: string[]): ExtractedPageState | null;
 export declare function extractPageState(client: CdpClient, selectors: SelectorConfig): Promise<ExtractedPageState | null>;