@steipete/oracle 0.14.0 → 0.15.0

package/dist/src/browser/chatgptFiles.js

@@ -458,7 +458,7 @@ async function configureBrowserDownloadPath(params) {
     }
     return false;
 }
-function buildClickAssistantDownloadButtonsExpression(minTurnIndex, expectedLabels = [], allowGenericDownloadLabels = true) {
+function buildClickAssistantDownloadButtonsExpression(minTurnIndex, expectedLabels = [], allowGenericDownloadLabels = true, options = {}) {
     const minTurnLiteral = typeof minTurnIndex === "number" && Number.isFinite(minTurnIndex) && minTurnIndex >= 0
         ? Math.floor(minTurnIndex)
         : -1;
@@ -466,12 +466,22 @@ function buildClickAssistantDownloadButtonsExpression(minTurnIndex, expectedLabe
     const assistantLiteral = JSON.stringify(ASSISTANT_ROLE_SELECTOR);
     const expectedLabelsLiteral = JSON.stringify(expectedLabels);
     const allowGenericDownloadLabelsLiteral = JSON.stringify(allowGenericDownloadLabels);
+    const markClickedLiteral = JSON.stringify(options.markClicked === true);
+    const maxClicksLiteral = typeof options.maxClicks === "number" &&
+        Number.isFinite(options.maxClicks) &&
+        options.maxClicks > 0
+        ? Math.floor(options.maxClicks)
+        : 0;
     return `(() => {
     const MIN_TURN_INDEX = ${minTurnLiteral};
     const CONVERSATION_SELECTOR = ${conversationLiteral};
     const ASSISTANT_SELECTOR = ${assistantLiteral};
     const EXPECTED_LABELS = ${expectedLabelsLiteral};
     const ALLOW_GENERIC_DOWNLOAD_LABELS = ${allowGenericDownloadLabelsLiteral};
+    const MARK_CLICKED = ${markClickedLiteral};
+    const MAX_CLICKS = ${maxClicksLiteral};
+    const HAS_EXPECTED_LABELS = EXPECTED_LABELS.length > 0;
+    const CLICKED_ATTRIBUTE = 'data-oracle-download-clicked';
     const isAssistantTurn = (node) => {
       if (!(node instanceof HTMLElement)) return false;
       const turnAttr = (node.getAttribute('data-turn') || node.dataset?.turn || '').toLowerCase();
@@ -482,33 +492,67 @@ function buildClickAssistantDownloadButtonsExpression(minTurnIndex, expectedLabe
       if (testId.includes('assistant')) return true;
       return Boolean(node.querySelector(ASSISTANT_SELECTOR) || node.querySelector('[data-testid*="assistant"]'));
     };
+    const expectedFileButton = (button) => {
+      const text = (button.textContent || '').trim().toLowerCase();
+      return EXPECTED_LABELS.some((label) => {
+        const downloadLabel = 'download ' + label;
+        return text === label ||
+          text.startsWith(label + ' ') ||
+          text === downloadLabel ||
+          text.startsWith(downloadLabel + ' ');
+      });
+    };
+    const genericBehaviorButton = (button) => {
+      const text = (button.textContent || '').trim().toLowerCase();
+      return ALLOW_GENERIC_DOWNLOAD_LABELS && /^download\\b/.test(text);
+    };
+    const genericFallbackButton = (button) => {
+      if (!ALLOW_GENERIC_DOWNLOAD_LABELS) return false;
+      const text = (button.textContent || '').trim().toLowerCase();
+      const aria = (button.getAttribute('aria-label') || '').trim().toLowerCase();
+      const testId = (button.getAttribute('data-testid') || '').trim().toLowerCase();
+      return text === 'download' || aria === 'download' || testId === 'download-files-turn-action-button';
+    };
     const turns = Array.from(document.querySelectorAll(CONVERSATION_SELECTOR));
-    const selected = new Set();
+    const expectedMatches = new Set();
+    const genericBehaviorMatches = new Set();
+    const genericFallbackMatches = new Set();
+    const genericAllMatches = new Set();
     for (let index = turns.length - 1; index >= 0; index -= 1) {
       const turn = turns[index];
       if (!isAssistantTurn(turn)) continue;
       if (MIN_TURN_INDEX >= 0 && index < MIN_TURN_INDEX) continue;
       const messageRoot = turn.querySelector(ASSISTANT_SELECTOR) || turn;
-      const buttons = Array.from(messageRoot.querySelectorAll('button'));
-      const primary = buttons.filter((button) => {
-        const text = (button.textContent || '').trim().toLowerCase();
-        const expectedFile = EXPECTED_LABELS.some(
-          (label) => text === label || text.startsWith(label + ' ')
-        );
-        return String(button.className || '').includes('behavior-btn') &&
-          (expectedFile || (ALLOW_GENERIC_DOWNLOAD_LABELS && /^download\\b/.test(text)));
-      });
-      const fallback = primary.length > 0 ? [] : buttons.filter((button) => {
-        if (!ALLOW_GENERIC_DOWNLOAD_LABELS) return false;
-        const text = (button.textContent || '').trim().toLowerCase();
-        const aria = (button.getAttribute('aria-label') || '').trim().toLowerCase();
-        const testId = (button.getAttribute('data-testid') || '').trim().toLowerCase();
-        return text === 'download' || aria === 'download' || testId === 'download-files-turn-action-button';
+      const buttons = Array.from(messageRoot.querySelectorAll('button'))
+        .filter((button) => !(MARK_CLICKED && button.getAttribute(CLICKED_ATTRIBUTE) === 'true'));
+      const behaviorButtons = buttons.filter((button) =>
+        String(button.className || '').includes('behavior-btn')
+      );
+      behaviorButtons.filter(expectedFileButton).forEach((button) => expectedMatches.add(button));
+      const genericBehavior = behaviorButtons.filter(genericBehaviorButton);
+      genericBehavior.forEach((button) => {
+        genericBehaviorMatches.add(button);
+        genericAllMatches.add(button);
       });
-      [...primary, ...fallback].forEach((button) => selected.add(button));
+      if (genericBehavior.length === 0) {
+        buttons.filter(genericFallbackButton).forEach((button) => {
+          genericFallbackMatches.add(button);
+          genericAllMatches.add(button);
+        });
+      }
     }
-    const selectedButtons = Array.from(selected);
-    selectedButtons.forEach((button) => button.click());
+    const selected = expectedMatches.size > 0
+      ? expectedMatches
+      : HAS_EXPECTED_LABELS
+        ? genericBehaviorMatches.size > 0
+          ? genericBehaviorMatches
+          : genericFallbackMatches
+        : genericAllMatches;
+    const selectedButtons = Array.from(selected).slice(0, MAX_CLICKS > 0 ? MAX_CLICKS : undefined);
+    selectedButtons.forEach((button) => {
+      if (MARK_CLICKED) button.setAttribute(CLICKED_ATTRIBUTE, 'true');
+      button.click();
+    });
     return selectedButtons.map((button) => ({
       text: (button.textContent || '').trim(),
       ariaLabel: button.getAttribute('aria-label') || '',
@@ -516,6 +560,80 @@ function buildClickAssistantDownloadButtonsExpression(minTurnIndex, expectedLabe
     }));
   })()`;
 }
+function describeDownloadableFile(file) {
+    return (file.filename ??
+        file.label ??
+        filenameFromUrl(file.sandboxUrl) ??
+        filenameFromUrl(file.downloadUrl) ??
+        filenameFromUrl(file.url) ??
+        file.sandboxUrl ??
+        file.downloadUrl ??
+        file.url);
+}
+function expectedDownloadedFilename(file) {
+    const filename = file.filename ??
+        filenameFromUrl(file.sandboxUrl) ??
+        filenameFromUrl(file.downloadUrl) ??
+        filenameFromUrl(file.url);
+    const basename = path.basename(String(filename ?? "").trim());
+    return basename && basename !== "." ? basename : undefined;
+}
+async function moveDownloadedFileToExpectedName(filePath, file) {
+    const filename = expectedDownloadedFilename(file);
+    if (!filename) {
+        return filePath;
+    }
+    const targetPath = path.join(path.dirname(filePath), filename);
+    if (path.resolve(targetPath) === path.resolve(filePath)) {
+        return filePath;
+    }
+    const expected = path.parse(filename);
+    const escapeRegExp = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const duplicatePattern = new RegExp(`^${escapeRegExp(expected.name)} ?\\(\\d+\\)${escapeRegExp(expected.ext)}$`);
+    if (!duplicatePattern.test(path.basename(filePath))) {
+        return filePath;
+    }
+    const targetExists = await fs
+        .stat(targetPath)
+        .then((stat) => stat.isFile())
+        .catch(() => false);
+    if (targetExists) {
+        return filePath;
+    }
+    await fs.rename(filePath, targetPath);
+    return targetPath;
+}
+async function clickAssistantDownloadButtons(params) {
+    const expression = buildClickAssistantDownloadButtonsExpression(params.minTurnIndex, params.expectedLabels ?? [], params.allowGenericDownloadLabels, { markClicked: params.markClicked, maxClicks: params.maxClicks });
+    const deadline = Date.now() + (params.timeoutMs ?? DOWNLOAD_BUTTON_WAIT_MS);
+    while (Date.now() < deadline) {
+        const { result } = await params.Runtime.evaluate({
+            expression,
+            returnByValue: true,
+        });
+        const clicked = Array.isArray(result?.value) ? result.value : [];
+        if (clicked.length > 0) {
+            return clicked;
+        }
+        await new Promise((resolve) => setTimeout(resolve, 250));
+    }
+    return [];
+}
+async function savedBrowserFileFromPath(filePath) {
+    const filename = path.basename(filePath);
+    const stat = await fs.stat(filePath);
+    return {
+        kind: "file",
+        path: filePath,
+        label: filename,
+        mimeType: mimeTypeFromFilename(filename),
+        sizeBytes: stat.size,
+        sourceUrl: "browser-download",
+        url: "browser-download",
+        finalUrl: "browser-download",
+        filename,
+    };
+}
 export async function saveAssistantDownloadButtonArtifacts(params) {
     if ((!params.sessionId && !params.downloadPath) ||
         (!params.Client && !params.Browser && !params.Page)) {
@@ -539,41 +657,72 @@ export async function saveAssistantDownloadButtonArtifacts(params) {
         params.logger?.("[browser] Browser download path could not be configured; skipping button fallback.");
         return [];
     }
-    let clicked = [];
-    const expression = buildClickAssistantDownloadButtonsExpression(params.minTurnIndex, resolveDownloadButtonLabels(params.files ?? []), params.allowGenericDownloadLabels);
-    const deadline = Date.now() + DOWNLOAD_BUTTON_WAIT_MS;
-    while (Date.now() < deadline) {
-        const { result } = await params.Runtime.evaluate({
-            expression,
-            returnByValue: true,
+    const buttonWaitMs = params.buttonWaitMs ?? DOWNLOAD_BUTTON_WAIT_MS;
+    const downloadWaitMs = params.downloadWaitMs ?? DOWNLOAD_BUTTON_WAIT_MS;
+    const expectedFiles = params.files ?? [];
+    if (expectedFiles.length === 0) {
+        const clicked = await clickAssistantDownloadButtons({
+            Runtime: params.Runtime,
+            minTurnIndex: params.minTurnIndex,
+            expectedLabels: [],
+            allowGenericDownloadLabels: params.allowGenericDownloadLabels,
+            timeoutMs: buttonWaitMs,
         });
-        clicked = Array.isArray(result?.value) ? result.value : [];
-        if (clicked.length > 0) {
+        if (clicked.length === 0) {
+            params.logger?.("[browser] No assistant download buttons found for button fallback.");
+            return [];
+        }
+        params.logger?.(`[browser] Clicked ${clicked.length} assistant download button(s).`);
+        const downloaded = await waitForCompletedDownloadFiles(artifactsDir, before, clicked.length, downloadWaitMs);
+        return Promise.all(downloaded.map(savedBrowserFileFromPath));
+    }
+    let clickedCount = 0;
+    let knownEntries = before;
+    const downloadedPaths = [];
+    const missingFiles = [];
+    const unattemptedFiles = [];
+    for (const [fileIndex, file] of expectedFiles.entries()) {
+        const expectedLabels = resolveDownloadButtonLabels([file]);
+        const clicked = await clickAssistantDownloadButtons({
+            Runtime: params.Runtime,
+            minTurnIndex: params.minTurnIndex,
+            expectedLabels,
+            allowGenericDownloadLabels: params.allowGenericDownloadLabels === true,
+            markClicked: true,
+            maxClicks: 1,
+            timeoutMs: buttonWaitMs,
+        });
+        const displayName = describeDownloadableFile(file);
+        if (clicked.length === 0) {
+            missingFiles.push(displayName);
+            knownEntries = new Set(await fs.readdir(artifactsDir).catch(() => []));
+            continue;
+        }
+        clickedCount += clicked.length;
+        const downloaded = await waitForCompletedDownloadFiles(artifactsDir, knownEntries, 1, downloadWaitMs);
+        if (downloaded.length === 0) {
+            missingFiles.push(displayName);
+            unattemptedFiles.push(...expectedFiles.slice(fileIndex + 1).map(describeDownloadableFile));
+            missingFiles.push(...unattemptedFiles);
+            params.logger?.(`[browser] Download timed out for ${displayName}${unattemptedFiles.length > 0
+                ? `; skipped remaining expected file(s) to avoid misassigning a late completion: ${unattemptedFiles.join(", ")}`
+                : ""}`);
             break;
         }
-        await new Promise((resolve) => setTimeout(resolve, 250));
+        const normalizedDownloads = await Promise.all(downloaded.map((filePath, index) => index === 0 ? moveDownloadedFileToExpectedName(filePath, file) : filePath));
+        downloadedPaths.push(...normalizedDownloads);
+        knownEntries = new Set(await fs.readdir(artifactsDir).catch(() => []));
     }
-    if (clicked.length === 0) {
+    if (clickedCount === 0) {
         params.logger?.("[browser] No assistant download buttons found for button fallback.");
-        return [];
     }
-    params.logger?.(`[browser] Clicked ${clicked.length} assistant download button(s).`);
-    const downloaded = await waitForCompletedDownloadFiles(artifactsDir, before, clicked.length);
-    return Promise.all(downloaded.map(async (filePath) => {
-        const filename = path.basename(filePath);
-        const stat = await fs.stat(filePath);
-        return {
-            kind: "file",
-            path: filePath,
-            label: filename,
-            mimeType: mimeTypeFromFilename(filename),
-            sizeBytes: stat.size,
-            sourceUrl: "browser-download",
-            url: "browser-download",
-            finalUrl: "browser-download",
-            filename,
-        };
-    }));
+    else {
+        params.logger?.(`[browser] Clicked ${clickedCount} assistant download button(s).`);
+    }
+    if (missingFiles.length > 0) {
+        params.logger?.(`[browser] Download button fallback did not save expected file(s): ${missingFiles.join(", ")}`);
+    }
+    return Promise.all([...new Set(downloadedPaths)].map(savedBrowserFileFromPath));
 }
 async function fetchDownloadWithNode(downloadUrl, getCookieHeader) {
     let currentUrl = new URL(downloadUrl);

package/dist/src/browser/chatgptImages.js

@@ -9,6 +9,33 @@ import { resolveSessionArtifactsDir } from "./artifacts.js";
 import { saveAssistantDownloadButtonArtifacts } from "./chatgptFiles.js";
 const GENERATED_IMAGE_WAIT_MIN_MS = 15_000;
 const GENERATED_IMAGE_WAIT_MAX_MS = 15 * 60_000;
+const CHATGPT_GENERATED_IMAGE_BASE_URL = "https://chatgpt.com/";
+function isAllowedChatGptHost(hostname) {
+    const value = hostname.toLowerCase();
+    return value === "chatgpt.com" || value === "chat.openai.com";
+}
+function normalizeGeneratedImageUrl(value) {
+    const raw = String(value ?? "").trim();
+    if (!raw)
+        return undefined;
+    let url;
+    try {
+        url = new URL(raw, CHATGPT_GENERATED_IMAGE_BASE_URL);
+    }
+    catch {
+        return undefined;
+    }
+    if (url.protocol !== "https:" || url.port || !isAllowedChatGptHost(url.hostname)) {
+        return undefined;
+    }
+    if (url.pathname !== "/backend-api/estuary/content") {
+        return undefined;
+    }
+    if (!(url.searchParams.get("id") ?? "").startsWith("file_")) {
+        return undefined;
+    }
+    return url.href;
+}
 function extractFileId(url) {
     try {
         return new URL(url).searchParams.get("id") ?? undefined;
@@ -41,8 +68,12 @@ function buildAssistantImageExpression(minTurnIndex) {
     const CONVERSATION_SELECTOR = ${conversationLiteral};
     const ASSISTANT_SELECTOR = ${assistantLiteral};
     const isGeneratedImage = (img) => {
-      const url = img?.src || '';
-      if (!url.includes('/backend-api/estuary/content?id=file_')) return false;
+      const url = new URL(img?.src || '', location.origin || 'https://chatgpt.com');
+      const host = url.hostname.toLowerCase();
+      if (url.protocol !== 'https:' || url.port) return false;
+      if (host !== 'chatgpt.com' && host !== 'chat.openai.com') return false;
+      if (url.pathname !== '/backend-api/estuary/content') return false;
+      if (!String(url.searchParams.get('id') || '').startsWith('file_')) return false;
       const alt = String(img.alt || '').toLowerCase();
       if (alt.includes('generated image')) return true;
       let node = img;
@@ -104,13 +135,16 @@ export async function readAssistantGeneratedImages(Runtime, minTurnIndex) {
     });
     const raw = Array.isArray(result?.value) ? result.value : [];
     const normalized = raw
-        .map((item) => ({
-        url: typeof item?.url === "string" ? item.url : "",
-        alt: typeof item?.alt === "string" ? item.alt : undefined,
-        width: typeof item?.width === "number" ? item.width : undefined,
-        height: typeof item?.height === "number" ? item.height : undefined,
-        fileId: typeof item?.url === "string" ? extractFileId(item.url) : undefined,
-    }))
+        .map((item) => {
+        const url = normalizeGeneratedImageUrl(typeof item?.url === "string" ? item.url : "");
+        return {
+            url: url ?? "",
+            alt: typeof item?.alt === "string" ? item.alt : undefined,
+            width: typeof item?.width === "number" ? item.width : undefined,
+            height: typeof item?.height === "number" ? item.height : undefined,
+            fileId: url ? extractFileId(url) : undefined,
+        };
+    })
         .filter((item) => item.url.length > 0);
     return dedupeImages(normalized);
 }
@@ -209,8 +243,51 @@ async function buildCookieHeader(Network) {
         .map((cookie) => `${cookie.name}=${cookie.value}`)
         .join("; ");
 }
+async function fetchGeneratedImageInBrowserContext(Runtime, url) {
+    const expression = `
+    (async () => {
+      const url = ${JSON.stringify(url)};
+      const response = await fetch(url, { credentials: 'include', redirect: 'follow' });
+      const contentType = response.headers.get('content-type') || '';
+      const buffer = await response.arrayBuffer();
+      const bytes = new Uint8Array(buffer);
+      let binary = '';
+      for (let index = 0; index < bytes.length; index += 0x8000) {
+        binary += String.fromCharCode(...bytes.slice(index, index + 0x8000));
+      }
+      return {
+        ok: response.ok,
+        status: response.status,
+        statusText: response.statusText,
+        contentType,
+        finalUrl: response.url,
+        b64: btoa(binary),
+      };
+    })()
+  `;
+    const { result, exceptionDetails } = await Runtime.evaluate({
+        expression,
+        awaitPromise: true,
+        returnByValue: true,
+        timeout: 120_000,
+    });
+    if (exceptionDetails) {
+        throw new Error("browser-context fetch threw an exception");
+    }
+    const value = result?.value;
+    if (!value?.ok || typeof value.b64 !== "string") {
+        const status = typeof value?.status === "number" ? value.status : "unknown";
+        const statusText = typeof value?.statusText === "string" ? value.statusText : "";
+        throw new Error(`browser-context fetch failed: ${status} ${statusText}`.trim());
+    }
+    return {
+        buffer: Buffer.from(value.b64, "base64"),
+        contentType: typeof value.contentType === "string" ? value.contentType : null,
+        finalUrl: typeof value.finalUrl === "string" && value.finalUrl ? value.finalUrl : url,
+    };
+}
 export async function saveChatGptGeneratedImages(params) {
-    const { Network, images, outputPath, logger } = params;
+    const { Network, Runtime, images, outputPath, logger } = params;
     if (!images.length)
         return { saved: false, imageCount: 0, savedImages: [], errors: [] };
     const cookieHeader = await buildCookieHeader(Network);
@@ -228,20 +305,41 @@ export async function saveChatGptGeneratedImages(params) {
     for (let index = 0; index < images.length; index += 1) {
         const image = images[index];
         try {
-            const response = await fetch(image.url, {
-                headers: {
-                    cookie: cookieHeader,
-                    "user-agent": "Mozilla/5.0",
-                },
-                redirect: "follow",
-            });
-            if (!response.ok) {
-                throw new Error(`download failed: ${response.status} ${response.statusText}`);
+            const imageUrl = normalizeGeneratedImageUrl(image.url);
+            if (!imageUrl) {
+                throw new Error("rejected non-ChatGPT generated image URL");
+            }
+            let contentType = null;
+            let finalUrl = imageUrl;
+            let buffer;
+            try {
+                const response = await fetch(imageUrl, {
+                    headers: {
+                        cookie: cookieHeader,
+                        "user-agent": "Mozilla/5.0",
+                    },
+                    redirect: "follow",
+                });
+                if (!response.ok) {
+                    throw new Error(`download failed: ${response.status} ${response.statusText}`);
+                }
+                contentType = response.headers.get("content-type");
+                finalUrl = response.url;
+                buffer = Buffer.from(await response.arrayBuffer());
+            }
+            catch (downloadError) {
+                if (!Runtime) {
+                    throw downloadError;
+                }
+                const message = downloadError instanceof Error ? downloadError.message : String(downloadError);
+                logger?.(`[browser] ChatGPT generated image download failed via Node fetch; retrying in browser context (${image.fileId ?? imageUrl}: ${message}).`);
+                const browserFetch = await fetchGeneratedImageInBrowserContext(Runtime, imageUrl);
+                contentType = browserFetch.contentType;
+                finalUrl = browserFetch.finalUrl;
+                buffer = browserFetch.buffer;
             }
-            const contentType = response.headers.get("content-type");
             const extension = contentTypeToExtension(contentType);
             const targetPath = resolveSiblingImagePath(path.resolve(outputPath), index, extension);
-            const buffer = Buffer.from(await response.arrayBuffer());
             await fs.writeFile(targetPath, buffer);
             savedImages.push({
                 kind: "image",
@@ -249,9 +347,9 @@ export async function saveChatGptGeneratedImages(params) {
                 label: index === 0 ? "Generated image" : `Generated image ${index + 1}`,
                 mimeType: contentType ?? undefined,
                 sizeBytes: buffer.length,
-                sourceUrl: image.url,
-                url: image.url,
-                finalUrl: response.url,
+                sourceUrl: imageUrl,
+                url: imageUrl,
+                finalUrl,
                 alt: image.alt,
                 width: image.width,
                 height: image.height,
@@ -336,6 +434,7 @@ export async function collectGeneratedImageArtifacts(params) {
     let generatedImages = await readAssistantGeneratedImagesWithFallback(params.Runtime, params.minTurnIndex ?? undefined);
     let latestAnswerText = params.answerText;
     if (explicitTargetPath && generatedImages.length === 0) {
+        await params.checkBlockingUiWarning?.();
         const targetPath = path.resolve(explicitTargetPath);
         const buttonImages = await saveGeneratedImageButtonArtifacts({
             Browser: params.Browser,
@@ -352,6 +451,7 @@ export async function collectGeneratedImageArtifacts(params) {
         const deadline = Date.now() + resolveGeneratedImageWaitTimeoutMs(params.waitTimeoutMs);
         while (Date.now() < deadline) {
             await delay(1500);
+            await params.checkBlockingUiWarning?.();
             generatedImages = await readAssistantGeneratedImagesWithFallback(params.Runtime, params.minTurnIndex ?? undefined);
             if (generatedImages.length > 0) {
                 break;
@@ -363,6 +463,7 @@ export async function collectGeneratedImageArtifacts(params) {
             }
         }
         if (generatedImages.length === 0) {
+            await params.checkBlockingUiWarning?.();
             const delayedButtonImages = await saveGeneratedImageButtonArtifacts({
                 Browser: params.Browser,
                 Client: params.Client,
@@ -396,6 +497,7 @@ export async function collectGeneratedImageArtifacts(params) {
     }
     const saved = await saveChatGptGeneratedImages({
         Network: params.Network,
+        Runtime: params.Runtime,
         images: generatedImages,
         outputPath: targetPath,
         logger: params.logger,

package/dist/src/browser/chromeLifecycle.js

@@ -15,20 +15,31 @@ export async function launchChrome(config, userDataDir, logger) {
     const debugPort = config.debugPort ?? parseDebugPortEnv();
     const chromeFlags = buildChromeFlags(config.headless ?? false, debugBindAddress);
     const usePatchedLauncher = Boolean(connectHost && connectHost !== "127.0.0.1");
+    // copy-profile reuses a copied signed-in profile whose cookies are
+    // Keychain-encrypted, so it must launch with the real Keychain (not mocked):
+    // strip the keychain-mocking flags from both chrome-launcher's defaults and
+    // Oracle's set, and ignore the defaults so they aren't re-added.
+    const usingCopiedProfile = Boolean(config.copyProfileSource);
+    if (usingCopiedProfile && config.chromeProfile) {
+        chromeFlags.push(`--profile-directory=${config.chromeProfile}`);
+    }
+    const launchOptions = resolveChromeLaunchOptions(chromeFlags, usingCopiedProfile);
     const launcher = usePatchedLauncher
         ? await launchWithCustomHost({
-            chromeFlags,
+            chromeFlags: launchOptions.chromeFlags,
             chromePath: config.chromePath ?? undefined,
             userDataDir,
             host: connectHost ?? "127.0.0.1",
             requestedPort: debugPort ?? undefined,
+            ignoreDefaultFlags: launchOptions.ignoreDefaultFlags,
         })
         : await launch({
             chromePath: config.chromePath ?? undefined,
-            chromeFlags,
+            chromeFlags: launchOptions.chromeFlags,
             userDataDir,
             handleSIGINT: false,
             port: debugPort ?? undefined,
+            ignoreDefaultFlags: launchOptions.ignoreDefaultFlags,
         });
     const pidLabel = typeof launcher.pid === "number" ? ` (pid ${launcher.pid})` : "";
     const hostLabel = connectHost ? ` on ${connectHost}` : "";
@@ -44,10 +55,14 @@ export function registerTerminationHooks(chrome, userDataDir, keepBrowser, logge
         }
         handling = true;
         const inFlight = opts?.isInFlight?.() ?? false;
-        const leaveRunning = keepBrowser || inFlight;
+        const forceCleanup = opts?.forceProfileCleanup ?? false;
+        const leaveRunning = (keepBrowser || inFlight) && !forceCleanup;
         if (leaveRunning) {
             logger(`Received ${signal}; leaving Chrome running${inFlight ? " (assistant response pending)" : ""}`);
         }
+        else if (forceCleanup && (keepBrowser || inFlight)) {
+            logger(`Received ${signal}; terminating Chrome and removing the copied profile (copy-profile is not retained)`);
+        }
         else {
             logger(`Received ${signal}; terminating Chrome process`);
         }
@@ -343,6 +358,9 @@ function createSessionBoundChromeClient(browser, sessionId) {
         // Raw `send` here is the browser-level send (not session-bound), so callers
         // that issue Target.* via `send` must pass this page session id explicitly to
         // stay scoped to this tab (e.g. Deep Research OOPIF auto-attach).
+        // chrome-remote-interface defines `send` on the client prototype, so object
+        // spread does not preserve it. Bind it explicitly for raw session commands.
+        send: typeof browser.send === "function" ? browser.send.bind(browser) : undefined,
         oraclePageSessionId: sessionId,
         Network: bindDomain("Network"),
         Page: bindDomain("Page"),
@@ -472,6 +490,18 @@ function buildChromeFlags(headless, debugBindAddress) {
     }
     return flags;
 }
+function resolveChromeLaunchOptions(chromeFlags, usingCopiedProfile) {
+    if (!usingCopiedProfile) {
+        return { chromeFlags, ignoreDefaultFlags: false };
+    }
+    return {
+        chromeFlags: [...Launcher.defaultFlags(), ...chromeFlags].filter((flag) => flag !== "--use-mock-keychain" && flag !== "--password-store=basic"),
+        ignoreDefaultFlags: true,
+    };
+}
+export function resolveChromeLaunchOptionsForTest(chromeFlags, usingCopiedProfile) {
+    return resolveChromeLaunchOptions(chromeFlags, usingCopiedProfile);
+}
 function parseDebugPortEnv() {
     const raw = process.env.ORACLE_BROWSER_PORT ?? process.env.ORACLE_BROWSER_DEBUG_PORT;
     if (!raw)
@@ -514,13 +544,14 @@ function isWsl() {
     const release = os.release();
     return release.toLowerCase().includes("microsoft");
 }
-async function launchWithCustomHost({ chromeFlags, chromePath, userDataDir, host, requestedPort, }) {
+async function launchWithCustomHost({ chromeFlags, chromePath, userDataDir, host, requestedPort, ignoreDefaultFlags, }) {
     const launcher = new Launcher({
         chromePath: chromePath ?? undefined,
         chromeFlags,
         userDataDir,
         handleSIGINT: false,
         port: requestedPort ?? undefined,
+        ignoreDefaultFlags,
     });
     if (host) {
         const patched = launcher;

package/dist/src/browser/deepResearchResult.js

@@ -0,0 +1,23 @@
+export function isDeepResearchIncompleteText(text) {
+    const normalized = text.toLowerCase().replace(/\s+/g, " ").trim();
+    const lines = text
+        .split(/\n+/)
+        .map((line) => line.trim())
+        .filter(Boolean);
+    const tailIsPlanningPanel = text.length <= 1_500 &&
+        lines.length >= 4 &&
+        lines.length <= 20 &&
+        /^update$/i.test(lines[1] ?? "") &&
+        /^stop research$/i.test(lines.at(-1) ?? "") &&
+        /^determining steps for creating a report(?:\.\.\.)?$/i.test(lines.at(-2) ?? "");
+    return (normalized === "called tool" ||
+        normalized === "used tool" ||
+        normalized === "użyto narzędzia" ||
+        normalized === "narzędzie wywołane" ||
+        normalized === "planning" ||
+        normalized === "researching" ||
+        normalized === "searching the web" ||
+        (text.trimStart().startsWith("<system-reminder>") &&
+            /<system-reminder>[\s\S]*#\s*plan mode\b/i.test(text)) ||
+        tailIsPlanningPanel);
+}