@steipete/oracle 0.10.0 → 0.11.1

package/dist/src/browser/actions/deepResearch.js

@@ -0,0 +1,662 @@
+import { DEEP_RESEARCH_PLUS_BUTTON, DEEP_RESEARCH_DROPDOWN_ITEM_TEXT, DEEP_RESEARCH_PILL_LABEL, DEEP_RESEARCH_POLL_INTERVAL_MS, DEEP_RESEARCH_AUTO_CONFIRM_WAIT_MS, DEEP_RESEARCH_DEFAULT_TIMEOUT_MS, FINISHED_ACTIONS_SELECTOR, STOP_BUTTON_SELECTOR, CONVERSATION_TURN_SELECTOR, } from "../constants.js";
+import { delay } from "../utils.js";
+import { buildClickDispatcher } from "./domEvents.js";
+import { captureAssistantMarkdown, readAssistantSnapshot } from "./assistantResponse.js";
+import { BrowserAutomationError } from "../../oracle/errors.js";
+/**
+ * Activates Deep Research mode through ChatGPT's slash command, with the
+ * composer tools menu as a fallback for older UI variants.
+ */
+export async function activateDeepResearch(Runtime, _Input, logger) {
+    const expression = buildActivateDeepResearchExpression();
+    const outcome = await Runtime.evaluate({
+        expression,
+        awaitPromise: true,
+        returnByValue: true,
+    });
+    const result = outcome.result?.value;
+    switch (result?.status) {
+        case "activated":
+            logger("Deep Research mode activated");
+            return;
+        case "already-active":
+            logger("Deep Research mode already active");
+            return;
+        case "plus-button-missing":
+            throw new BrowserAutomationError("Could not find the composer plus button to activate Deep Research.", { stage: "deep-research-activate", code: "plus-button-missing" });
+        case "dropdown-item-missing": {
+            const hint = result.available?.length
+                ? ` Available options: ${result.available.join(", ")}`
+                : "";
+            throw new BrowserAutomationError(`"Deep research" option not found in composer dropdown.${hint} ` +
+                "This feature may require a ChatGPT Plus or Pro subscription.", { stage: "deep-research-activate", code: "dropdown-item-missing" });
+        }
+        case "pill-not-confirmed":
+            throw new BrowserAutomationError("Deep Research pill did not appear after selection. The UI may have changed.", { stage: "deep-research-activate", code: "pill-not-confirmed" });
+        default:
+            throw new BrowserAutomationError("Unexpected result from Deep Research activation.", {
+                stage: "deep-research-activate",
+            });
+    }
+}
+/**
+ * After prompt submission, waits for the research plan to appear and
+ * auto-confirm (~60s countdown + 10s safety margin).
+ */
+export async function waitForResearchPlanAutoConfirm(Runtime, logger, autoConfirmWaitMs = DEEP_RESEARCH_AUTO_CONFIRM_WAIT_MS) {
+    // Phase A: Detect research plan appearance (up to 60s)
+    const planDeadline = Date.now() + 60_000;
+    let planDetected = false;
+    while (Date.now() < planDeadline) {
+        const { result } = await Runtime.evaluate({
+            expression: `(() => {
+        const iframes = document.querySelectorAll('iframe');
+        const hasResearchIframe = Array.from(iframes).some(f => {
+          const rect = f.getBoundingClientRect();
+          return rect.width > 200 && rect.height > 200;
+        });
+        const assistantText = (document.querySelector('[data-message-author-role="assistant"]')?.textContent || '').toLowerCase();
+        const hasResearchText = assistantText.includes('researching') ||
+          assistantText.includes('research plan') ||
+          assistantText.includes('survey') ||
+          assistantText.includes('analyze');
+        return { hasResearchIframe, hasResearchText };
+      })()`,
+            returnByValue: true,
+        });
+        const val = result?.value;
+        if (val?.hasResearchIframe || val?.hasResearchText) {
+            planDetected = true;
+            logger("Research plan detected, waiting for auto-confirm countdown...");
+            break;
+        }
+        await delay(2_000);
+    }
+    if (!planDetected) {
+        logger("Warning: Research plan not detected within 60s; continuing (may have auto-confirmed already)");
+        return;
+    }
+    // Phase B: Wait for auto-confirm countdown
+    const confirmStart = Date.now();
+    while (Date.now() - confirmStart < autoConfirmWaitMs) {
+        const { result } = await Runtime.evaluate({
+            expression: `(() => {
+        const iframes = document.querySelectorAll('iframe');
+        const hasLargeIframe = Array.from(iframes).some(f => {
+          const rect = f.getBoundingClientRect();
+          return rect.width > 200 && rect.height > 200;
+        });
+        const text = (document.body?.innerText || '').toLowerCase();
+        const isResearching = text.includes('researching...') ||
+          text.includes('reading sources') ||
+          text.includes('considering');
+        return { hasLargeIframe, isResearching };
+      })()`,
+            returnByValue: true,
+        });
+        const val = result?.value;
+        if (val?.isResearching) {
+            logger("Research plan confirmed, execution started");
+            return;
+        }
+        await delay(5_000);
+    }
+    logger("Auto-confirm wait complete, proceeding to monitor research progress");
+}
+/**
+ * Polls for Deep Research completion over 5-30+ minutes.
+ * Returns the full response text, optional HTML, and turn metadata.
+ */
+export async function waitForDeepResearchCompletion(Runtime, logger, timeoutMs = DEEP_RESEARCH_DEFAULT_TIMEOUT_MS, minTurnIndex, Page, client) {
+    const start = Date.now();
+    let lastLogTime = start;
+    let lastTextLength = 0;
+    const minTurnLiteral = typeof minTurnIndex === "number" && Number.isFinite(minTurnIndex) && minTurnIndex >= 0
+        ? Math.floor(minTurnIndex)
+        : -1;
+    logger(`Monitoring Deep Research (timeout: ${Math.round(timeoutMs / 60_000)}min)...`);
+    while (Date.now() - start < timeoutMs) {
+        const { result } = await Runtime.evaluate({
+            expression: buildDeepResearchCompletionPollExpression(minTurnLiteral),
+            returnByValue: true,
+        });
+        const val = result?.value;
+        if (val?.accountBlocked) {
+            throw new BrowserAutomationError("ChatGPT account security block detected during Deep Research. Open chatgpt.com in Chrome, secure the account, then rerun Oracle.", { stage: "chatgpt-account-blocked", code: "chatgpt-account-blocked" });
+        }
+        const frameResult = Page
+            ? await readDeepResearchFrameResult(Runtime, Page).catch(() => null)
+            : client
+                ? await readDeepResearchTargetResult(client).catch(() => null)
+                : null;
+        const scopedToNewTurns = minTurnLiteral >= 0;
+        if (frameResult?.completed &&
+            frameResult.text &&
+            (!scopedToNewTurns || val?.hasActiveScopedResearch)) {
+            logger(`Deep Research completed (${Math.round((Date.now() - start) / 1000)}s elapsed)`);
+            return {
+                text: frameResult.text,
+                html: frameResult.html,
+                meta: { turnId: null, messageId: null },
+            };
+        }
+        // Completion detected
+        if (val?.finished) {
+            logger(`Deep Research completed (${Math.round((Date.now() - start) / 1000)}s elapsed)`);
+            return await extractDeepResearchResult(Runtime, logger, minTurnIndex ?? undefined);
+        }
+        // Progress logging every 60 seconds
+        const now = Date.now();
+        if (now - lastLogTime >= 60_000) {
+            const elapsed = Math.round((now - start) / 1000);
+            const chars = Math.max(val?.textLength ?? 0, frameResult?.textLength ?? 0);
+            const phase = frameResult?.inProgress || val?.hasIframe
+                ? "researching"
+                : val?.stopVisible
+                    ? "generating"
+                    : "waiting";
+            logger(`Deep Research ${phase}... ${elapsed}s elapsed, ~${chars} chars`);
+            lastLogTime = now;
+        }
+        lastTextLength = Math.max(val?.textLength ?? 0, frameResult?.textLength ?? 0, lastTextLength);
+        await delay(DEEP_RESEARCH_POLL_INTERVAL_MS);
+    }
+    // Timeout — throw with metadata for potential reattach
+    const elapsed = Math.round((Date.now() - start) / 1000);
+    throw new BrowserAutomationError(`Deep Research did not complete within ${Math.round(timeoutMs / 60_000)} minutes (${elapsed}s elapsed). ` +
+        "Use 'oracle session <id>' to reattach later, or increase --timeout.", {
+        stage: "deep-research-timeout",
+        code: "deep-research-timeout",
+        elapsedMs: Date.now() - start,
+        lastTextLength,
+    });
+}
+/**
+ * Extracts the Deep Research result using existing assistant response
+ * extraction logic (readAssistantSnapshot + captureAssistantMarkdown).
+ */
+export async function extractDeepResearchResult(Runtime, logger, minTurnIndex) {
+    const snapshot = await readAssistantSnapshot(Runtime, minTurnIndex);
+    const meta = {
+        turnId: snapshot?.turnId ?? null,
+        messageId: snapshot?.messageId ?? null,
+    };
+    // Try the copy-button approach first for clean markdown
+    const markdown = await captureAssistantMarkdown(Runtime, meta, logger);
+    if (markdown && !isDeepResearchPlaceholderText(markdown)) {
+        return { text: markdown, html: snapshot?.html ?? undefined, meta };
+    }
+    // Fall back to snapshot text
+    if (snapshot?.text && !isDeepResearchPlaceholderText(snapshot.text)) {
+        return { text: snapshot.text, html: snapshot.html ?? undefined, meta };
+    }
+    throw new BrowserAutomationError("Deep Research completed but failed to extract the response text.", { stage: "deep-research-extract", code: "extraction-failed" });
+}
+function isDeepResearchPlaceholderText(text) {
+    const normalized = text.toLowerCase().replace(/\s+/g, " ").trim();
+    return (normalized === "called tool" ||
+        normalized === "used tool" ||
+        normalized === "użyto narzędzia" ||
+        normalized === "narzędzie wywołane");
+}
+export function isDeepResearchPlaceholderTextForTest(text) {
+    return isDeepResearchPlaceholderText(text);
+}
+async function readDeepResearchFrameResult(Runtime, Page) {
+    const pageWithFrames = Page;
+    if (typeof pageWithFrames.getFrameTree !== "function" ||
+        typeof pageWithFrames.createIsolatedWorld !== "function") {
+        return null;
+    }
+    const frameTree = (await pageWithFrames.getFrameTree())?.frameTree;
+    const frameId = findDeepResearchFrameId(frameTree);
+    if (!frameId) {
+        return null;
+    }
+    const world = await pageWithFrames.createIsolatedWorld({
+        frameId,
+        worldName: "oracle-deep-research",
+        grantUniveralAccess: true,
+    });
+    if (typeof world.executionContextId !== "number") {
+        return null;
+    }
+    const { result } = await Runtime.evaluate({
+        expression: buildDeepResearchFrameStatusExpression(),
+        contextId: world.executionContextId,
+        returnByValue: true,
+    });
+    return result?.value ?? null;
+}
+async function readDeepResearchTargetResult(client) {
+    const rawClient = client;
+    if (typeof rawClient.send !== "function") {
+        return null;
+    }
+    const sessionIds = new Set();
+    const ownedSessionIds = new Set();
+    const onAttached = (params, sessionId) => {
+        const targetInfo = params
+            ?.targetInfo;
+        const eventSessionId = params?.sessionId ?? sessionId;
+        const url = targetInfo?.url ?? "";
+        const type = targetInfo?.type ?? "";
+        if (eventSessionId && isDeepResearchTarget(url, type)) {
+            sessionIds.add(eventSessionId);
+            ownedSessionIds.add(eventSessionId);
+        }
+    };
+    client.on?.("Target.attachedToTarget", onAttached);
+    try {
+        await rawClient.send("Target.setDiscoverTargets", { discover: true }).catch(() => undefined);
+        await rawClient
+            .send("Target.setAutoAttach", {
+            autoAttach: true,
+            waitForDebuggerOnStart: false,
+            flatten: true,
+        })
+            .catch(() => undefined);
+        await delay(100);
+        const targets = (await rawClient.send("Target.getTargets", {}));
+        for (const target of targets?.targetInfos ?? []) {
+            if (!target.targetId || !isDeepResearchTarget(target.url ?? "", target.type ?? "")) {
+                continue;
+            }
+            const attached = (await rawClient
+                .send("Target.attachToTarget", { targetId: target.targetId, flatten: true })
+                .catch(() => null));
+            if (attached?.sessionId) {
+                sessionIds.add(attached.sessionId);
+                ownedSessionIds.add(attached.sessionId);
+            }
+        }
+        for (const sessionId of sessionIds) {
+            const value = await readDeepResearchTargetSession(rawClient, sessionId);
+            if (value?.completed) {
+                return value;
+            }
+            if (value?.inProgress || value?.textLength) {
+                return value;
+            }
+        }
+        return null;
+    }
+    finally {
+        await rawClient
+            .send("Target.setAutoAttach", {
+            autoAttach: false,
+            waitForDebuggerOnStart: false,
+            flatten: true,
+        })
+            .catch(() => undefined);
+        await Promise.all(Array.from(ownedSessionIds, (sessionId) => rawClient.send("Target.detachFromTarget", { sessionId }).catch(() => undefined)));
+        client.removeListener?.("Target.attachedToTarget", onAttached);
+    }
+}
+async function readDeepResearchTargetSession(rawClient, sessionId) {
+    await rawClient.send("Runtime.enable", {}, sessionId).catch(() => undefined);
+    await rawClient.send("Page.enable", {}, sessionId).catch(() => undefined);
+    const frameTree = (await rawClient
+        .send("Page.getFrameTree", {}, sessionId)
+        .catch(() => null));
+    const frameIds = collectDeepResearchFrameIds(frameTree?.frameTree);
+    let best = null;
+    for (const frameId of frameIds) {
+        const world = (await rawClient
+            .send("Page.createIsolatedWorld", {
+            frameId,
+            worldName: "oracle-deep-research",
+            grantUniveralAccess: true,
+        }, sessionId)
+            .catch(() => null));
+        if (typeof world?.executionContextId !== "number") {
+            continue;
+        }
+        const value = await evaluateDeepResearchFrameStatus(rawClient, sessionId, world.executionContextId);
+        if (value?.completed) {
+            return value;
+        }
+        if ((value?.textLength ?? 0) > (best?.textLength ?? 0) || value?.inProgress) {
+            best = value;
+        }
+    }
+    const topFrameValue = await evaluateDeepResearchFrameStatus(rawClient, sessionId);
+    if (topFrameValue?.completed) {
+        return topFrameValue;
+    }
+    if ((topFrameValue?.textLength ?? 0) > (best?.textLength ?? 0) || topFrameValue?.inProgress) {
+        best = topFrameValue;
+    }
+    return best;
+}
+async function evaluateDeepResearchFrameStatus(rawClient, sessionId, contextId) {
+    const response = (await rawClient
+        .send("Runtime.evaluate", {
+        expression: buildDeepResearchFrameStatusExpression(),
+        returnByValue: true,
+        ...(typeof contextId === "number" ? { contextId } : {}),
+    }, sessionId)
+        .catch(() => null));
+    return response?.result?.value ?? null;
+}
+function isDeepResearchTarget(url, type) {
+    const lowerUrl = url.toLowerCase();
+    const lowerType = type.toLowerCase();
+    return (lowerType === "iframe" ||
+        lowerUrl.includes("connector_openai_deep_research") ||
+        lowerUrl.includes("deep-research"));
+}
+function findDeepResearchFrameId(tree) {
+    if (!tree?.frame) {
+        return null;
+    }
+    const url = tree.frame.url ?? "";
+    const name = tree.frame.name ?? "";
+    if (url.includes("connector_openai_deep_research") ||
+        url.includes("deep-research") ||
+        name.includes("deep-research")) {
+        return tree.frame.id ?? null;
+    }
+    for (const child of tree.childFrames ?? []) {
+        const match = findDeepResearchFrameId(child);
+        if (match) {
+            return match;
+        }
+    }
+    return null;
+}
+function collectDeepResearchFrameIds(tree) {
+    if (!tree?.frame) {
+        return [];
+    }
+    const ids = [];
+    const url = tree.frame.url ?? "";
+    const name = tree.frame.name ?? "";
+    if (url.includes("connector_openai_deep_research") ||
+        url.includes("deep-research") ||
+        name.includes("deep-research") ||
+        name === "root") {
+        if (tree.frame.id) {
+            ids.push(tree.frame.id);
+        }
+    }
+    for (const child of tree.childFrames ?? []) {
+        ids.push(...collectDeepResearchFrameIds(child));
+    }
+    return ids;
+}
+function buildDeepResearchFrameStatusExpression() {
+    return `(() => {
+    const rawText = document.body?.innerText || '';
+    const html = document.body?.innerHTML || '';
+    const isPlaceholder = (line) => /^(called tool|used tool|użyto narzędzia|narzędzie wywołane)$/i.test(line);
+    const isCompletionLine = (line) =>
+      /^(research completed|badanie ukończone)\\b/i.test(line);
+    const isCounterLine = (line) =>
+      /^(\\d+\\s+)?(citation|citations|source|sources|search|searches|cytat|cytaty|cytatów|źródło|źródła|wyszukiwanie|wyszukiwania|wyszukiwań)\\b/i.test(line);
+    const normalizeReport = (text) => {
+      const lines = String(text || '')
+        .split(/\\n+/)
+        .map((line) => line.trim())
+        .filter(Boolean)
+        .filter((line) => !/^\\d+$/.test(line));
+      const reportIndex = lines.findIndex((line) => /deep research report/i.test(line));
+      const candidates = reportIndex >= 0 ? lines.slice(reportIndex + 1) : lines;
+      let started = false;
+      const reportLines = candidates.filter((line) => {
+        if (!started) {
+          if (
+            /deep research report/i.test(line) ||
+            isCompletionLine(line) ||
+            isCounterLine(line) ||
+            isPlaceholder(line)
+          ) {
+            return false;
+          }
+          started = true;
+        }
+        return true;
+      });
+      if (reportLines.length > 1 && reportLines[0] === reportLines[1]) {
+        reportLines.shift();
+      }
+      return reportLines.join('\\n').trim();
+    };
+    const reportText = normalizeReport(rawText);
+    const completed = /research completed|badanie ukończone/i.test(rawText) &&
+      reportText.length >= 40 &&
+      !isPlaceholder(reportText);
+    const inProgress = /researching|badanie|searching|searches|wyszukiwa|citation|cytat|source|źród|reading|completed|ukończone/i.test(rawText);
+    return {
+      completed,
+      inProgress,
+      textLength: reportText.length || rawText.trim().length,
+      text: completed ? reportText : undefined,
+      html: completed ? html : undefined,
+    };
+  })()`;
+}
+export function findDeepResearchFrameIdForTest(tree) {
+    return findDeepResearchFrameId(tree);
+}
+export function buildDeepResearchFrameStatusExpressionForTest() {
+    return buildDeepResearchFrameStatusExpression();
+}
+/**
+ * Quick status check for Deep Research — used during reattach to determine
+ * whether research has completed, is still in progress, or is in an unknown state.
+ */
+export async function checkDeepResearchStatus(Runtime, _logger) {
+    const { result } = await Runtime.evaluate({
+        expression: buildDeepResearchStatusExpression(),
+        returnByValue: true,
+    });
+    const val = result?.value;
+    return {
+        completed: val?.completed ?? false,
+        inProgress: val?.inProgress ?? false,
+        hasIframe: val?.hasIframe ?? false,
+        textLength: val?.textLength ?? 0,
+        placeholderOnly: val?.placeholderOnly ?? false,
+    };
+}
+// ---------------------------------------------------------------------------
+// DOM expression builder
+// ---------------------------------------------------------------------------
+function buildDeepResearchStatusExpression() {
+    const finishedSelector = JSON.stringify(FINISHED_ACTIONS_SELECTOR);
+    const stopSelector = JSON.stringify(STOP_BUTTON_SELECTOR);
+    return `(() => {
+    const stopVisible = Boolean(document.querySelector(${stopSelector}));
+    const iframes = Array.from(document.querySelectorAll('iframe')).filter(f => {
+      const rect = f.getBoundingClientRect();
+      return rect.width > 200 && rect.height > 200;
+    });
+    const turns = document.querySelectorAll('[data-message-author-role="assistant"]');
+    const lastTurn = turns[turns.length - 1];
+    const finished = Boolean(lastTurn?.querySelector?.(${finishedSelector}));
+    const text = (lastTurn?.textContent || '').trim();
+    const normalized = text.toLowerCase().replace(/\\s+/g, ' ').trim();
+    const placeholderOnly = /^(called tool|used tool|użyto narzędzia|narzędzie wywołane)$/.test(normalized);
+    const textLength = text.length;
+    return {
+      completed: finished && !placeholderOnly && textLength >= 40,
+      inProgress: stopVisible || iframes.length > 0,
+      hasIframe: iframes.length > 0,
+      textLength,
+      placeholderOnly,
+    };
+  })()`;
+}
+function buildDeepResearchCompletionPollExpression(minTurnIndex) {
+    const finishedSelector = JSON.stringify(FINISHED_ACTIONS_SELECTOR);
+    const stopSelector = JSON.stringify(STOP_BUTTON_SELECTOR);
+    const turnSelector = JSON.stringify(CONVERSATION_TURN_SELECTOR);
+    return `(() => {
+    const MIN_TURN_INDEX = ${minTurnIndex};
+    const stopVisible = Boolean(document.querySelector(${stopSelector}));
+    const scopedToNewTurns = MIN_TURN_INDEX >= 0;
+    const pageText = String(document.body?.innerText || '').toLowerCase().replace(/\\s+/g, ' ');
+    const accountBlocked = pageText.includes('suspicious activity detected') &&
+      pageText.includes('secure your account') &&
+      pageText.includes('regain access');
+    const isAssistantTurn = (node) => {
+      const attr = String(node.getAttribute('data-message-author-role') || node.getAttribute('data-turn') || node.dataset?.turn || '').toLowerCase();
+      return attr === 'assistant' ||
+        Boolean(node.querySelector('[data-message-author-role="assistant"], [data-turn="assistant"]')) ||
+        String(node.getAttribute('data-testid') || '').toLowerCase().includes('conversation-turn') &&
+          /chatgpt\\s+said/i.test(node.innerText || node.textContent || '');
+    };
+    const conversationTurns = Array.from(document.querySelectorAll(${turnSelector}));
+    const allAssistantTurns = Array.from(document.querySelectorAll('[data-message-author-role="assistant"], [data-turn="assistant"]'));
+    const scopedTurns = scopedToNewTurns
+      ? conversationTurns.slice(MIN_TURN_INDEX).filter(isAssistantTurn)
+      : allAssistantTurns;
+    const lastTurn = scopedTurns[scopedTurns.length - 1] || (scopedToNewTurns ? null : allAssistantTurns[allAssistantTurns.length - 1]);
+    const text = (lastTurn?.textContent || '').trim();
+    const normalized = text.toLowerCase().replace(/\\s+/g, ' ').trim();
+    const textLength = text.length;
+    const isToolStub = normalized === 'called tool' ||
+      normalized === 'used tool' ||
+      normalized === 'użyto narzędzia' ||
+      normalized === 'narzędzie wywołane';
+    const finished = Boolean(lastTurn?.querySelector(${finishedSelector})) &&
+      textLength >= 40 &&
+      !isToolStub;
+    const hasIframe = Array.from(document.querySelectorAll('iframe')).some(f => {
+      const rect = f.getBoundingClientRect();
+      return rect.width > 200 && rect.height > 200;
+    });
+    const hasActiveScopedResearch = scopedToNewTurns && Boolean(lastTurn) && hasIframe &&
+      (textLength < 40 || isToolStub || /chatgpt\\s+said:?$/i.test(text));
+    return { finished, stopVisible, textLength, hasIframe, isToolStub, hasActiveScopedResearch, accountBlocked };
+  })()`;
+}
+export function buildDeepResearchStatusExpressionForTest() {
+    return buildDeepResearchStatusExpression();
+}
+export function buildDeepResearchCompletionPollExpressionForTest(minTurnIndex = -1) {
+    return buildDeepResearchCompletionPollExpression(minTurnIndex);
+}
+function buildActivateDeepResearchExpression() {
+    const plusBtnSelector = JSON.stringify(DEEP_RESEARCH_PLUS_BUTTON);
+    const targetText = JSON.stringify(DEEP_RESEARCH_DROPDOWN_ITEM_TEXT);
+    const pillLabel = JSON.stringify(DEEP_RESEARCH_PILL_LABEL);
+    // pillLabel is used inside the expression for verification
+    void pillLabel;
+    return `(async () => {
+    ${buildClickDispatcher()}
+
+    const findDeepResearchPill = () => {
+      const pills = document.querySelectorAll('.__composer-pill-composite, .__composer-pill, [class*="composer-pill"]');
+      for (const pill of pills) {
+        const text = pill.textContent?.trim() || '';
+        const aria = pill.getAttribute('aria-label') ||
+          pill.querySelector('button')?.getAttribute('aria-label') ||
+          '';
+        if (text.toLowerCase().includes('deep research') ||
+            aria.toLowerCase().includes('deep research')) {
+          return pill;
+        }
+      }
+      return null;
+    };
+
+    const waitForPill = () => new Promise((resolve) => {
+      let elapsed = 0;
+      const tick = () => {
+        if (findDeepResearchPill()) {
+          resolve(true); return;
+        }
+        elapsed += 200;
+        if (elapsed > 5000) { resolve(false); return; }
+        setTimeout(tick, 200);
+      };
+      setTimeout(tick, 200);
+    });
+
+    const clearComposer = (composer) => {
+      if (!composer) return;
+      if ('value' in composer) composer.value = '';
+      else composer.textContent = '';
+      composer.dispatchEvent(new InputEvent('input', { bubbles: true, inputType: 'deleteContentBackward', data: null }));
+    };
+
+    const setComposerText = (composer, text) => {
+      composer.focus?.();
+      if ('value' in composer) composer.value = text;
+      else composer.textContent = text;
+      composer.dispatchEvent(new InputEvent('input', { bubbles: true, inputType: 'insertText', data: text }));
+    };
+
+    const findDeepResearchItem = () => {
+      const target = ${targetText}.toLowerCase();
+      const candidates = Array.from(document.querySelectorAll('[data-radix-collection-item], [role="option"], [cmdk-item], button, [role="menuitem"], [role="menuitemradio"]'));
+      return candidates.find(item => (item.textContent || '').trim().toLowerCase() === target) || null;
+    };
+
+    // Step 0: Check if already active
+    if (findDeepResearchPill()) {
+      return { status: 'already-active' };
+    }
+
+    // Step 1: Prefer the official slash command flow.
+    const composer = document.querySelector('[contenteditable="true"], textarea');
+    if (composer) {
+      setComposerText(composer, '/Deepresearch');
+      await new Promise(resolve => setTimeout(resolve, 600));
+      const slashItem = findDeepResearchItem();
+      if (slashItem) {
+        dispatchClickSequence(slashItem);
+        if (await waitForPill()) return { status: 'activated' };
+      }
+      clearComposer(composer);
+    }
+
+    // Step 2: Fall back to the composer tools menu.
+    const plusBtn = document.querySelector(${plusBtnSelector}) ||
+      Array.from(document.querySelectorAll('button')).find(
+        b => (b.getAttribute('aria-label') || '').toLowerCase().includes('add files')
+      );
+    if (!plusBtn) return { status: 'plus-button-missing' };
+    dispatchClickSequence(plusBtn);
+
+    // Step 3: Wait for dropdown
+    const waitForDropdown = () => new Promise((resolve) => {
+      let elapsed = 0;
+      const tick = () => {
+        const items = document.querySelectorAll('[data-radix-collection-item], [role="menuitem"], [role="menuitemradio"], [role="option"], [cmdk-item]');
+        if (items.length > 0) { resolve(items); return; }
+        elapsed += 150;
+        if (elapsed > 3000) { resolve(null); return; }
+        setTimeout(tick, 150);
+      };
+      setTimeout(tick, 150);
+    });
+    const items = await waitForDropdown();
+    if (!items) return { status: 'dropdown-item-missing', available: [] };
+
+    // Step 4: Find "Deep research" item
+    const target = ${targetText}.toLowerCase();
+    let match = null;
+    const available = [];
+    for (const item of items) {
+      const text = (item.textContent || '').trim();
+      available.push(text);
+      if (text.toLowerCase() === target) {
+        match = item;
+      }
+    }
+    if (!match) return { status: 'dropdown-item-missing', available };
+
+    // Step 5: Click it
+    dispatchClickSequence(match);
+
+    // Step 6: Verify pill appeared
+    const pillConfirmed = await waitForPill();
+    return pillConfirmed ? { status: 'activated' } : { status: 'pill-not-confirmed' };
+  })()`;
+}
+export function buildActivateDeepResearchExpressionForTest() {
+    return buildActivateDeepResearchExpression();
+}