@steipete/oracle 0.5.3 → 0.5.6

package/README.md

@@ -17,6 +17,8 @@ Oracle bundles your prompt and files so another AI can answer with real context.
 
 Install globally: `npm install -g @steipete/oracle`
 
+Use `npx -y @steipete/oracle …` (not `pnpx`)—pnpx's sandboxed cache can’t load the sqlite bindings and will throw missing `node_sqlite3.node` errors.
+
 ```bash
 # Copy the bundle and paste into ChatGPT
 npx @steipete/oracle --render --copy -p "Review the TS data layer for schema drift" --file "src/**/*.ts,*/*.test.ts"

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

@@ -291,8 +291,9 @@ function buildResponseObserverExpression(timeoutMs) {
           if (!stop) {
             return;
           }
-          const ariaLabel = stop.getAttribute('aria-label') || '';
-          if (ariaLabel.toLowerCase().includes('stop')) {
+          const isStopButton =
+            stop.getAttribute('data-testid') === 'stop-button' || stop.getAttribute('aria-label')?.toLowerCase()?.includes('stop');
+          if (isStopButton) {
             return;
           }
           dispatchClickSequence(stop);

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

@@ -7,32 +7,163 @@ export async function uploadAttachmentFile(deps, attachment, logger) {
     if (!dom) {
         throw new Error('DOM domain unavailable while uploading attachments.');
     }
-    const documentNode = await dom.getDocument();
-    const selectors = FILE_INPUT_SELECTORS;
-    let targetNodeId;
-    for (const selector of selectors) {
-        const result = await dom.querySelector({ nodeId: documentNode.root.nodeId, selector });
-        if (result.nodeId) {
-            targetNodeId = result.nodeId;
-            break;
+    const isAttachmentPresent = async (name) => {
+        const check = await runtime.evaluate({
+            expression: `(() => {
+        const expected = ${JSON.stringify(name.toLowerCase())};
+        const selectors = [
+          '[data-testid*="attachment"]',
+          '[data-testid*="chip"]',
+          '[data-testid*="upload"]'
+        ];
+        const chips = selectors.some((selector) =>
+          Array.from(document.querySelectorAll(selector)).some((node) =>
+            (node?.textContent || '').toLowerCase().includes(expected),
+          ),
+        );
+        if (chips) return true;
+        const cardTexts = Array.from(document.querySelectorAll('[aria-label="Remove file"]')).map((btn) =>
+          btn?.parentElement?.parentElement?.innerText?.toLowerCase?.() ?? '',
+        );
+        if (cardTexts.some((text) => text.includes(expected))) return true;
+
+        const filesPill = Array.from(document.querySelectorAll('button,div')).some((node) => {
+          const text = (node?.textContent || '').toLowerCase();
+          return /\bfiles\b/.test(text) && text.includes('file');
+        });
+        if (filesPill) return true;
+
+        const inputs = Array.from(document.querySelectorAll('input[type="file"]')).some((el) =>
+          Array.from(el.files || []).some((f) => f?.name?.toLowerCase?.().includes(expected)),
+        );
+        return inputs;
+      })()`,
+            returnByValue: true,
+        });
+        return Boolean(check?.result?.value);
+    };
+    // New ChatGPT UI hides the real file input behind a composer "+" menu; click it pre-emptively.
+    await Promise.resolve(runtime.evaluate({
+        expression: `(() => {
+        const selectors = [
+          '#composer-plus-btn',
+          'button[data-testid="composer-plus-btn"]',
+          '[data-testid*="plus"]',
+          'button[aria-label*="add"]',
+          'button[aria-label*="attachment"]',
+          'button[aria-label*="file"]',
+        ];
+        for (const selector of selectors) {
+          const el = document.querySelector(selector);
+          if (el instanceof HTMLElement) {
+            el.click();
+            return true;
+          }
         }
+        return false;
+      })()`,
+        returnByValue: true,
+    })).catch(() => undefined);
+    await delay(250);
+    // Helper to click the upload menu item (if present) to reveal the real attachment input.
+    await Promise.resolve(runtime.evaluate({
+        expression: `(() => {
+        const menuItems = Array.from(document.querySelectorAll('[data-testid*="upload"],[data-testid*="attachment"], [role="menuitem"], [data-radix-collection-item]'));
+        for (const el of menuItems) {
+          const text = (el.textContent || '').toLowerCase();
+          const tid = el.getAttribute?.('data-testid')?.toLowerCase?.() || '';
+          if (tid.includes('upload') || tid.includes('attachment') || text.includes('upload') || text.includes('file')) {
+            if (el instanceof HTMLElement) { el.click(); return true; }
+          }
+        }
+        return false;
+      })()`,
+        returnByValue: true,
+    })).catch(() => undefined);
+    const expectedName = path.basename(attachment.path);
+    if (await isAttachmentPresent(expectedName)) {
+        logger(`Attachment already present: ${path.basename(attachment.path)}`);
+        return;
     }
-    if (!targetNodeId) {
-        await logDomFailure(runtime, logger, 'file-input');
+    // Find a real input; prefer non-image accept fields and tag it for DOM.setFileInputFiles.
+    const markResult = await runtime.evaluate({
+        expression: `(() => {
+      const inputs = Array.from(document.querySelectorAll('input[type="file"]'));
+      const acceptIsImageOnly = (accept) => {
+        if (!accept) return false;
+        const parts = String(accept)
+          .split(',')
+          .map((p) => p.trim().toLowerCase())
+          .filter(Boolean);
+        return parts.length > 0 && parts.every((p) => p.startsWith('image/'));
+      };
+      const nonImage = inputs.filter((el) => !acceptIsImageOnly(el.getAttribute('accept')));
+      const target = (nonImage.length ? nonImage[nonImage.length - 1] : inputs[inputs.length - 1]) ?? null;
+      if (target) {
+        target.setAttribute('data-oracle-upload-target', 'true');
+        return true;
+      }
+      return false;
+    })()`,
+        returnByValue: true,
+    });
+    const marked = Boolean(markResult?.result?.value);
+    if (!marked) {
+        await logDomFailure(runtime, logger, 'file-input-missing');
         throw new Error('Unable to locate ChatGPT file attachment input.');
     }
-    await dom.setFileInputFiles({ nodeId: targetNodeId, files: [attachment.path] });
-    const expectedName = path.basename(attachment.path);
-    const ready = await waitForAttachmentSelection(runtime, expectedName, 10_000);
-    if (!ready) {
-        await logDomFailure(runtime, logger, 'file-upload');
-        throw new Error('Attachment did not register with the ChatGPT composer in time.');
+    const documentNode = await dom.getDocument();
+    const resultNode = await dom.querySelector({ nodeId: documentNode.root.nodeId, selector: 'input[type="file"][data-oracle-upload-target="true"]' });
+    if (!resultNode?.nodeId) {
+        await logDomFailure(runtime, logger, 'file-input-missing');
+        throw new Error('Unable to locate ChatGPT file attachment input.');
+    }
+    const resolvedNodeId = resultNode.nodeId;
+    const dispatchEvents = FILE_INPUT_SELECTORS
+        .map((selector) => `
+      (() => {
+        const el = document.querySelector(${JSON.stringify(selector)});
+        if (el instanceof HTMLInputElement) {
+          el.dispatchEvent(new Event('input', { bubbles: true }));
+          el.dispatchEvent(new Event('change', { bubbles: true }));
+        }
+      })();
+    `)
+        .join('\\n');
+    const tryFileInput = async () => {
+        await dom.setFileInputFiles({ nodeId: resolvedNodeId, files: [attachment.path] });
+        await runtime.evaluate({ expression: `(function(){${dispatchEvents} return true;})()`, returnByValue: true });
+    };
+    await tryFileInput();
+    // Snapshot the attachment state immediately after setting files so we can detect silent failures.
+    const snapshotExpr = `(() => {
+    const chips = Array.from(document.querySelectorAll('[data-testid*="attachment"],[data-testid*="chip"],[data-testid*="upload"],[aria-label="Remove file"]'))
+      .map((node) => (node?.textContent || '').trim())
+      .filter(Boolean);
+    const inputs = Array.from(document.querySelectorAll('input[type="file"]')).map((el) => ({
+      files: Array.from(el.files || []).map((f) => f?.name ?? ''),
+    }));
+    return { chips, inputs };
+  })()`;
+    const snapshot = await runtime
+        .evaluate({ expression: snapshotExpr, returnByValue: true })
+        .then((res) => res?.result?.value)
+        .catch(() => undefined);
+    if (snapshot) {
+        logger?.(`Attachment snapshot after setFileInputFiles: chips=${JSON.stringify(snapshot.chips || [])} inputs=${JSON.stringify(snapshot.inputs || [])}`);
+    }
+    const inputHasFile = snapshot?.inputs?.some((entry) => (entry.files || []).some((name) => name?.toLowerCase?.().includes(expectedName.toLowerCase()))) ?? false;
+    if (await waitForAttachmentAnchored(runtime, expectedName, 20_000)) {
+        await waitForAttachmentVisible(runtime, expectedName, 20_000, logger);
+        logger(inputHasFile ? 'Attachment queued (file input, confirmed present)' : 'Attachment queued (file input)');
+        return;
     }
-    await waitForAttachmentVisible(runtime, expectedName, 10_000, logger);
-    logger('Attachment queued');
+    await logDomFailure(runtime, logger, 'file-upload-missing');
+    throw new Error('Attachment did not register with the ChatGPT composer in time.');
 }
-export async function waitForAttachmentCompletion(Runtime, timeoutMs, logger) {
+export async function waitForAttachmentCompletion(Runtime, timeoutMs, expectedNames = [], logger) {
     const deadline = Date.now() + timeoutMs;
+    const expectedNormalized = expectedNames.map((name) => name.toLowerCase());
     const expression = `(() => {
     const sendSelectors = ${JSON.stringify(SEND_BUTTON_SELECTORS)};
     let button = null;
@@ -58,24 +189,40 @@ export async function waitForAttachmentCompletion(Runtime, timeoutMs, logger) {
         return text.includes('upload') || text.includes('processing') || text.includes('uploading');
       });
     });
-    const fileSelectors = ${JSON.stringify(FILE_INPUT_SELECTORS)};
-    const filesAttached = fileSelectors.some((selector) =>
-      Array.from(document.querySelectorAll(selector)).some((node) => {
-        const el = node instanceof HTMLInputElement ? node : null;
-        return Boolean(el?.files?.length);
-      }),
+    const attachmentSelectors = ['[data-testid*="chip"]', '[data-testid*="attachment"]', '[data-testid*="upload"]'];
+    const attachedNames = [];
+    for (const selector of attachmentSelectors) {
+      for (const node of Array.from(document.querySelectorAll(selector))) {
+        const text = node?.textContent?.toLowerCase?.();
+        if (text) attachedNames.push(text);
+      }
+    }
+    for (const input of Array.from(document.querySelectorAll('input[type="file"]'))) {
+      if (!(input instanceof HTMLInputElement) || !input.files?.length) continue;
+      for (const file of Array.from(input.files)) {
+        if (file?.name) attachedNames.push(file.name.toLowerCase());
+      }
+    }
+    const cardTexts = Array.from(document.querySelectorAll('[aria-label="Remove file"]')).map((btn) =>
+      btn?.parentElement?.parentElement?.innerText?.toLowerCase?.() ?? '',
     );
-    return { state: button ? (disabled ? 'disabled' : 'ready') : 'missing', uploading, filesAttached };
+    attachedNames.push(...cardTexts.filter(Boolean));
+    const filesAttached = attachedNames.length > 0;
+    return { state: button ? (disabled ? 'disabled' : 'ready') : 'missing', uploading, filesAttached, attachedNames };
   })()`;
     while (Date.now() < deadline) {
         const { result } = await Runtime.evaluate({ expression, returnByValue: true });
         const value = result?.value;
         if (value && !value.uploading) {
-            if (value.state === 'ready') {
-                return;
-            }
-            if (value.state === 'missing' && value.filesAttached) {
-                return;
+            const attached = new Set((value.attachedNames ?? []).map((name) => name.toLowerCase()));
+            const missing = expectedNormalized.filter((name) => !attached.has(name));
+            if (missing.length === 0) {
+                if (value.state === 'ready') {
+                    return;
+                }
+                if (value.state === 'missing' && value.filesAttached) {
+                    return;
+                }
             }
         }
         await delay(250);
@@ -85,15 +232,76 @@ export async function waitForAttachmentCompletion(Runtime, timeoutMs, logger) {
     throw new Error('Attachments did not finish uploading before timeout.');
 }
 export async function waitForAttachmentVisible(Runtime, expectedName, timeoutMs, logger) {
-    const deadline = Date.now() + Math.min(timeoutMs, 2_000);
+    // Attachments can take a few seconds to render in the composer (headless/remote Chrome is slower),
+    // so respect the caller-provided timeout instead of capping at 2s.
+    const deadline = Date.now() + timeoutMs;
     const expression = `(() => {
     const expected = ${JSON.stringify(expectedName)};
+    const normalized = expected.toLowerCase();
+    const matchNode = (node) => {
+      if (!node) return false;
+      const text = (node.textContent || '').toLowerCase();
+      const aria = node.getAttribute?.('aria-label')?.toLowerCase?.() ?? '';
+      const title = node.getAttribute?.('title')?.toLowerCase?.() ?? '';
+      const testId = node.getAttribute?.('data-testid')?.toLowerCase?.() ?? '';
+      const alt = node.getAttribute?.('alt')?.toLowerCase?.() ?? '';
+      return [text, aria, title, testId, alt].some((value) => value.includes(normalized));
+    };
+
     const turns = Array.from(document.querySelectorAll('article[data-testid^="conversation-turn"]'));
     const userTurns = turns.filter((node) => node.querySelector('[data-message-author-role="user"]'));
     const lastUser = userTurns[userTurns.length - 1];
-    if (!lastUser) return { found: false, userTurns: userTurns.length };
-    const chips = Array.from(lastUser.querySelectorAll('a, div')).some((el) => (el.textContent || '').includes(expected));
-    return { found: chips, userTurns: userTurns.length };
+    if (lastUser) {
+      const turnMatch = Array.from(lastUser.querySelectorAll('*')).some(matchNode);
+      if (turnMatch) return { found: true, userTurns: userTurns.length, source: 'turn' };
+    }
+
+    const composerSelectors = [
+      '[data-testid*="composer"]',
+      'form textarea',
+      'form [data-testid*="attachment"]',
+      '[data-testid*="upload"]',
+      '[data-testid*="chip"]',
+      'form',
+      'button',
+      'label'
+    ];
+    const composerMatch = composerSelectors.some((selector) =>
+      Array.from(document.querySelectorAll(selector)).some(matchNode),
+    );
+    if (composerMatch) {
+      return { found: true, userTurns: userTurns.length, source: 'composer' };
+    }
+
+    const attachmentSelectors = ['[data-testid*="attachment"]','[data-testid*="chip"]','[data-testid*="upload"]'];
+    const attachmentMatch = attachmentSelectors.some((selector) =>
+      Array.from(document.querySelectorAll(selector)).some(matchNode),
+    );
+    if (attachmentMatch) {
+      return { found: true, userTurns: userTurns.length, source: 'attachments' };
+    }
+
+    const cardTexts = Array.from(document.querySelectorAll('[aria-label="Remove file"]')).map((btn) =>
+      btn?.parentElement?.parentElement?.innerText?.toLowerCase?.() ?? '',
+    );
+    if (cardTexts.some((text) => text.includes(normalized))) {
+      return { found: true, userTurns: userTurns.length, source: 'attachment-cards' };
+    }
+
+    const attrMatch = Array.from(document.querySelectorAll('[aria-label], [title], [data-testid]')).some(matchNode);
+    if (attrMatch) {
+      return { found: true, userTurns: userTurns.length, source: 'attrs' };
+    }
+
+    const bodyMatch = (document.body?.innerText || '').toLowerCase().includes(normalized);
+    if (bodyMatch) {
+      return { found: true, userTurns: userTurns.length, source: 'body' };
+    }
+
+    const inputHit = Array.from(document.querySelectorAll('input[type="file"]')).some((el) =>
+      Array.from(el.files || []).some((file) => file?.name?.toLowerCase?.().includes(normalized)),
+    );
+    return { found: inputHit, userTurns: userTurns.length, source: inputHit ? 'input' : undefined };
   })()`;
     while (Date.now() < deadline) {
         const { result } = await Runtime.evaluate({ expression, returnByValue: true });
@@ -107,31 +315,41 @@ export async function waitForAttachmentVisible(Runtime, expectedName, timeoutMs,
     await logDomFailure(Runtime, logger ?? (() => { }), 'attachment-visible');
     throw new Error('Attachment did not appear in ChatGPT composer.');
 }
-async function waitForAttachmentSelection(Runtime, expectedName, timeoutMs) {
+async function waitForAttachmentAnchored(Runtime, expectedName, timeoutMs) {
     const deadline = Date.now() + timeoutMs;
     const expression = `(() => {
-    const selectors = ${JSON.stringify(FILE_INPUT_SELECTORS)};
+    const normalized = ${JSON.stringify(expectedName.toLowerCase())};
+    const selectors = ['[data-testid*="attachment"]','[data-testid*="chip"]','[data-testid*="upload"]'];
     for (const selector of selectors) {
-      const inputs = Array.from(document.querySelectorAll(selector));
-      for (const input of inputs) {
-        if (!(input instanceof HTMLInputElement) || !input.files) {
-          continue;
-        }
-        const names = Array.from(input.files ?? []).map((file) => file?.name ?? '');
-        if (names.some((name) => name === ${JSON.stringify(expectedName)})) {
-          return { matched: true, names };
+      for (const node of Array.from(document.querySelectorAll(selector))) {
+        const text = (node?.textContent || '').toLowerCase();
+        if (text.includes(normalized)) {
+          return { found: true, text };
         }
       }
     }
-    return { matched: false, names: [] };
+    const cards = Array.from(document.querySelectorAll('[aria-label="Remove file"]')).map((btn) =>
+      btn?.parentElement?.parentElement?.innerText?.toLowerCase?.() ?? '',
+    );
+    if (cards.some((text) => text.includes(normalized))) {
+      return { found: true, text: cards.find((t) => t.includes(normalized)) };
+    }
+
+    // As a last resort, treat file inputs that hold the target name as anchored. Some UIs delay chip rendering.
+    const inputHit = Array.from(document.querySelectorAll('input[type="file"]')).some((el) =>
+      Array.from(el.files || []).some((file) => file?.name?.toLowerCase?.().includes(normalized)),
+    );
+    if (inputHit) {
+      return { found: true, text: 'input-only' };
+    }
+    return { found: false };
   })()`;
     while (Date.now() < deadline) {
         const { result } = await Runtime.evaluate({ expression, returnByValue: true });
-        const matched = Boolean(result?.value?.matched);
-        if (matched) {
+        if (result?.value?.found) {
             return true;
         }
-        await delay(150);
+        await delay(200);
     }
     return false;
 }

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

@@ -11,6 +11,7 @@ const ENTER_KEY_EVENT = {
 const ENTER_KEY_TEXT = '\r';
 export async function submitPrompt(deps, prompt, logger) {
     const { runtime, input } = deps;
+    await waitForDomReady(runtime, logger);
     const encodedPrompt = JSON.stringify(prompt);
     const focusResult = await runtime.evaluate({
         expression: `(() => {
@@ -89,7 +90,7 @@ export async function submitPrompt(deps, prompt, logger) {
       })()`,
         });
     }
-    const clicked = await attemptSendButton(runtime);
+    const clicked = await attemptSendButton(runtime, logger, deps?.attachmentNames);
     if (!clicked) {
         await input.dispatchKeyEvent({
             type: 'keyDown',
@@ -109,7 +110,27 @@ export async function submitPrompt(deps, prompt, logger) {
     await verifyPromptCommitted(runtime, prompt, 30_000, logger);
     await clickAnswerNowIfPresent(runtime, logger);
 }
-async function attemptSendButton(Runtime) {
+async function waitForDomReady(Runtime, logger) {
+    const deadline = Date.now() + 10_000;
+    while (Date.now() < deadline) {
+        const { result } = await Runtime.evaluate({
+            expression: `(() => {
+        const ready = document.readyState === 'complete';
+        const composer = document.querySelector('[data-testid*="composer"]') || document.querySelector('form');
+        const fileInput = document.querySelector('input[type="file"]');
+        return { ready, composer: Boolean(composer), fileInput: Boolean(fileInput) };
+      })()`,
+            returnByValue: true,
+        });
+        const value = result?.value;
+        if (value?.ready && value.composer) {
+            return;
+        }
+        await delay(150);
+    }
+    logger?.('Page did not reach ready/composer state within 10s; continuing cautiously.');
+}
+async function attemptSendButton(Runtime, _logger, attachmentNames) {
     const script = `(() => {
     ${buildClickDispatcher()}
     const selectors = ${JSON.stringify(SEND_BUTTON_SELECTORS)};
@@ -133,8 +154,31 @@ async function attemptSendButton(Runtime) {
     dispatchClickSequence(button);
     return 'clicked';
   })()`;
-    const deadline = Date.now() + 2_000;
+    const deadline = Date.now() + 8_000;
     while (Date.now() < deadline) {
+        const needAttachment = Array.isArray(attachmentNames) && attachmentNames.length > 0;
+        if (needAttachment) {
+            const ready = await Runtime.evaluate({
+                expression: `(() => {
+          const names = ${JSON.stringify(attachmentNames.map((n) => n.toLowerCase()))};
+          const match = (n, name) => (n?.textContent || '').toLowerCase().includes(name);
+          const chipsReady = names.every((name) =>
+            Array.from(document.querySelectorAll('[data-testid*="chip"],[data-testid*="attachment"],a,div,span')).some((node) => match(node, name)),
+          );
+          const inputsReady = names.every((name) =>
+            Array.from(document.querySelectorAll('input[type="file"]')).some((el) =>
+              Array.from(el.files || []).some((f) => f?.name?.toLowerCase?.().includes(name)),
+            ),
+          );
+          return chipsReady || inputsReady;
+        })()`,
+                returnByValue: true,
+            });
+            if (!ready?.result?.value) {
+                await delay(150);
+                continue;
+            }
+        }
         const { result } = await Runtime.evaluate({ expression: script, returnByValue: true });
         if (result.value === 'clicked') {
             return true;
@@ -187,24 +231,37 @@ async function verifyPromptCommitted(Runtime, prompt, timeoutMs, logger) {
     const fallback = document.querySelector(${fallbackSelectorLiteral});
     const normalize = (value) => value?.toLowerCase?.().replace(/\\s+/g, ' ').trim() ?? '';
     const normalizedPrompt = normalize(${encodedPrompt});
+    const normalizedPromptPrefix = normalizedPrompt.slice(0, 120);
     const CONVERSATION_SELECTOR = ${JSON.stringify(CONVERSATION_TURN_SELECTOR)};
     const articles = Array.from(document.querySelectorAll(CONVERSATION_SELECTOR));
-    const userMatched = articles.some((node) => normalize(node?.innerText).includes(normalizedPrompt));
+    const normalizedTurns = articles.map((node) => normalize(node?.innerText));
+    const userMatched = normalizedTurns.some((text) => text.includes(normalizedPrompt));
+    const prefixMatched =
+      normalizedPromptPrefix.length > 30 &&
+      normalizedTurns.some((text) => text.includes(normalizedPromptPrefix));
+    const lastTurn = normalizedTurns[normalizedTurns.length - 1] ?? '';
     return {
       userMatched,
+      prefixMatched,
       fallbackValue: fallback?.value ?? '',
       editorValue: editor?.innerText ?? '',
+      lastTurn,
+      turnsCount: normalizedTurns.length,
     };
   })()`;
     while (Date.now() < deadline) {
         const { result } = await Runtime.evaluate({ expression: script, returnByValue: true });
         const info = result.value;
-        if (info?.userMatched) {
+        if (info?.userMatched || info?.prefixMatched) {
             return;
         }
         await delay(100);
     }
     if (logger) {
+        logger(`Prompt commit check failed; latest state: ${await Runtime.evaluate({
+            expression: script,
+            returnByValue: true,
+        }).then((res) => JSON.stringify(res?.result?.value)).catch(() => 'unavailable')}`);
         await logDomFailure(Runtime, logger, 'prompt-commit');
     }
     throw new Error('Prompt did not appear in conversation before timeout (send may have failed)');

package/dist/src/browser/chromeLifecycle.js

@@ -32,7 +32,7 @@ export async function launchChrome(config, userDataDir, logger) {
     logger(`Launched Chrome${pidLabel} on port ${launcher.port}${hostLabel}`);
     return Object.assign(launcher, { host: connectHost ?? '127.0.0.1' });
 }
-export function registerTerminationHooks(chrome, userDataDir, keepBrowser, logger) {
+export function registerTerminationHooks(chrome, userDataDir, keepBrowser, logger, opts) {
     const signals = ['SIGINT', 'SIGTERM', 'SIGQUIT'];
     let handling;
     const handleSignal = (signal) => {
@@ -40,14 +40,23 @@ export function registerTerminationHooks(chrome, userDataDir, keepBrowser, logge
             return;
         }
         handling = true;
-        if (keepBrowser) {
-            logger(`Received ${signal}; leaving Chrome running for potential reattach`);
+        const inFlight = opts?.isInFlight?.() ?? false;
+        const leaveRunning = keepBrowser || inFlight;
+        if (leaveRunning) {
+            logger(`Received ${signal}; leaving Chrome running${inFlight ? ' (assistant response pending)' : ''}`);
         }
         else {
             logger(`Received ${signal}; terminating Chrome process`);
         }
         void (async () => {
-            if (!keepBrowser) {
+            if (leaveRunning) {
+                // Ensure reattach hints are written before we exit.
+                await opts?.emitRuntimeHint?.().catch(() => undefined);
+                if (inFlight) {
+                    logger('Session still in flight; reattach with "oracle session <slug>" to continue.');
+                }
+            }
+            else {
                 try {
                     await chrome.kill();
                 }

package/dist/src/browser/constants.js

@@ -29,6 +29,9 @@ export const FILE_INPUT_SELECTORS = [
     'input[type="file"][multiple]:not([accept])',
     'input[type="file"][multiple]',
     'input[type="file"]:not([accept])',
+    'form input[type="file"][accept]',
+    'input[type="file"][accept]',
+    'input[type="file"]',
     'input[type="file"][data-testid*="file"]',
 ];
 // Legacy single selectors kept for compatibility with older call-sites
@@ -48,11 +51,11 @@ export const UPLOAD_STATUS_SELECTORS = [
 ];
 export const STOP_BUTTON_SELECTOR = '[data-testid="stop-button"]';
 export const SEND_BUTTON_SELECTORS = [
-    '[data-testid="send-button"]',
-    'button[data-testid="composer-send-button"]',
-    'button[aria-label="Send message"]',
-    'button[aria-label*="Send"]',
+    'button[data-testid="send-button"]',
+    'button[data-testid*="composer-send"]',
+    'form button[type="submit"]',
     'button[type="submit"][data-testid*="send"]',
+    'button[aria-label*="Send"]',
 ];
 export const SEND_BUTTON_SELECTOR = SEND_BUTTON_SELECTORS[0];
 export const MODEL_BUTTON_SELECTOR = '[data-testid="model-switcher-dropdown-button"]';

package/dist/src/browser/index.js

@@ -98,7 +98,10 @@ export async function runBrowserMode(options) {
     const chromeHost = chrome.host ?? '127.0.0.1';
     let removeTerminationHooks = null;
     try {
-        removeTerminationHooks = registerTerminationHooks(chrome, userDataDir, effectiveKeepBrowser, logger);
+        removeTerminationHooks = registerTerminationHooks(chrome, userDataDir, effectiveKeepBrowser, logger, {
+            isInFlight: () => runStatus !== 'complete',
+            emitRuntimeHint,
+        });
     }
     catch {
         // ignore failure; cleanup still happens below
@@ -251,6 +254,7 @@ export async function runBrowserMode(options) {
             await raceWithDisconnect(ensurePromptReady(Runtime, config.inputTimeoutMs, logger));
             logger(`Prompt textarea ready (after model switch, ${promptText.length.toLocaleString()} chars queued)`);
         }
+        const attachmentNames = attachments.map((a) => path.basename(a.path));
         if (attachments.length > 0) {
             if (!DOM) {
                 throw new Error('Chrome DOM domain unavailable while uploading attachments.');
@@ -260,10 +264,10 @@ export async function runBrowserMode(options) {
                 await uploadAttachmentFile({ runtime: Runtime, dom: DOM }, attachment, logger);
             }
             const waitBudget = Math.max(config.inputTimeoutMs ?? 30_000, 30_000);
-            await raceWithDisconnect(waitForAttachmentCompletion(Runtime, waitBudget, logger));
+            await raceWithDisconnect(waitForAttachmentCompletion(Runtime, waitBudget, attachmentNames, logger));
             logger('All attachments uploaded');
         }
-        await raceWithDisconnect(submitPrompt({ runtime: Runtime, input: Input }, promptText, logger));
+        await raceWithDisconnect(submitPrompt({ runtime: Runtime, input: Input, attachmentNames }, promptText, logger));
         stopThinkingMonitor = startThinkingStatusMonitor(Runtime, logger, options.verbose ?? false);
         const answer = await raceWithDisconnect(waitForAssistantResponse(Runtime, config.timeoutMs, logger));
         answerText = answer.text;
@@ -632,6 +636,7 @@ async function runRemoteBrowserMode(promptText, attachments, config, logger, opt
             await ensurePromptReady(Runtime, config.inputTimeoutMs, logger);
             logger(`Prompt textarea ready (after model switch, ${promptText.length.toLocaleString()} chars queued)`);
         }
+        const attachmentNames = attachments.map((a) => path.basename(a.path));
         if (attachments.length > 0) {
             if (!DOM) {
                 throw new Error('Chrome DOM domain unavailable while uploading attachments.');
@@ -642,10 +647,10 @@ async function runRemoteBrowserMode(promptText, attachments, config, logger, opt
                 await uploadAttachmentViaDataTransfer({ runtime: Runtime, dom: DOM }, attachment, logger);
             }
             const waitBudget = Math.max(config.inputTimeoutMs ?? 30_000, 30_000);
-            await waitForAttachmentCompletion(Runtime, waitBudget, logger);
+            await waitForAttachmentCompletion(Runtime, waitBudget, attachmentNames, logger);
             logger('All attachments uploaded');
         }
-        await submitPrompt({ runtime: Runtime, input: Input }, promptText, logger);
+        await submitPrompt({ runtime: Runtime, input: Input, attachmentNames }, promptText, logger);
         stopThinkingMonitor = startThinkingStatusMonitor(Runtime, logger, options.verbose ?? false);
         const answer = await waitForAssistantResponse(Runtime, config.timeoutMs, logger);
         answerText = answer.text;

package/dist/src/oracle/errors.js

@@ -101,7 +101,7 @@ export function toTransportError(error, model) {
                 messageText.includes('does not exist') ||
                 messageText.includes('unknown model') ||
                 messageText.includes('model_not_found'))) {
-            return new OracleTransportError('model-unavailable', 'gpt-5.1-pro is not yet available on this API base. Use gpt-5-pro for now until OpenAI enables it. // TODO: Remove once gpt-5.1-pro is available', apiError);
+            return new OracleTransportError('model-unavailable', 'gpt-5.1-pro is not yet available on this API base. Using gpt-5-pro until OpenAI enables it. // TODO: Remove once gpt-5.1-pro is available', apiError);
         }
         if (apiError.status === 404 || apiError.status === 405) {
             return new OracleTransportError('unsupported-endpoint', 'HTTP 404/405 from the Responses API; this base URL or gateway likely does not expose /v1/responses. Set OPENAI_BASE_URL to api.openai.com/v1, update your Azure API version/deployment, or use the browser engine.', apiError);

package/dist/src/oracle/run.js

@@ -186,14 +186,17 @@ export async function runOracle(options, deps = {}) {
             : DEFAULT_TIMEOUT_NON_PRO_MS / 1000
         : options.timeoutSeconds;
     const timeoutMs = timeoutSeconds * 1000;
+    const apiModelFromConfig = modelConfig.apiModel ?? modelConfig.model;
+    const modelDowngraded = apiModelFromConfig === 'gpt-5.1-pro';
+    const resolvedApiModelId = modelDowngraded ? 'gpt-5-pro' : apiModelFromConfig;
     // Track the concrete model id we dispatch to (especially for Gemini preview aliases)
     const effectiveModelId = options.effectiveModelId ??
         (options.model.startsWith('gemini')
             ? resolveGeminiModelId(options.model)
-            : modelConfig.apiModel ?? modelConfig.model);
+            : resolvedApiModelId);
     const headerModelLabel = richTty ? chalk.cyan(modelConfig.model) : modelConfig.model;
     const requestBody = buildRequestBody({
-        modelConfig,
+        modelConfig: { ...modelConfig, apiModel: resolvedApiModelId },
         systemPrompt,
         userPrompt: promptWithFiles,
         searchEnabled,
@@ -219,6 +222,9 @@ export async function runOracle(options, deps = {}) {
         if (baseUrl) {
             log(dim(`Base URL: ${formatBaseUrlForLog(baseUrl)}`));
         }
+        if (modelDowngraded) {
+            log(dim('gpt-5.1-pro is not yet available via API; sending request with gpt-5-pro instead.'));
+        }
         if (options.background && !supportsBackground) {
             log(dim('Background runs are not supported for this model; streaming in foreground instead.'));
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steipete/oracle",
-  "version": "0.5.3",
+  "version": "0.5.6",
   "description": "CLI wrapper around OpenAI Responses API with GPT-5.1 Pro, GPT-5.1, and GPT-5.1 Codex high reasoning modes.",
   "type": "module",
   "main": "dist/bin/oracle-cli.js",
@@ -8,6 +8,26 @@
     "oracle": "dist/bin/oracle-cli.js",
     "oracle-mcp": "dist/bin/oracle-mcp.js"
   },
+  "scripts": {
+    "docs:list": "tsx scripts/docs-list.ts",
+    "build": "tsc -p tsconfig.build.json && pnpm run build:vendor",
+    "build:vendor": "node -e \"const fs=require('fs'); const path=require('path'); const src=path.join('vendor','oracle-notifier'); const dest=path.join('dist','vendor','oracle-notifier'); fs.mkdirSync(dest,{recursive:true}); if(fs.existsSync(src)){ fs.cpSync(src,dest,{recursive:true,force:true}); }\"",
+    "start": "pnpm run build && node ./dist/scripts/run-cli.js",
+    "oracle": "pnpm start",
+    "check": "pnpm run typecheck",
+    "typecheck": "tsc --noEmit",
+    "lint": "pnpm run typecheck && biome lint .",
+    "test": "vitest run",
+    "test:mcp": "pnpm run build && pnpm run test:mcp:unit && pnpm run test:mcp:mcporter",
+    "test:mcp:unit": "vitest run tests/mcp*.test.ts tests/mcp/**/*.test.ts",
+    "test:mcp:mcporter": "npx -y mcporter list oracle-local --schema --config config/mcporter.json && npx -y mcporter call oracle-local.sessions limit:1 --config config/mcporter.json",
+    "test:browser": "pnpm run build && tsx scripts/test-browser.ts && ./scripts/browser-smoke.sh",
+    "test:live": "ORACLE_LIVE_TEST=1 vitest run tests/live --exclude tests/live/openai-live.test.ts",
+    "test:pro": "ORACLE_LIVE_TEST=1 vitest run tests/live/openai-live.test.ts",
+    "test:coverage": "vitest run --coverage",
+    "prepare": "pnpm run build",
+    "mcp": "pnpm run build && node ./dist/bin/oracle-mcp.js"
+  },
   "files": [
     "dist/**/*",
     "assets-oracle-icon.png",
@@ -30,11 +50,7 @@
         "name": "node",
         "version": ">=20"
       }
-    ],
-    "packageManager": {
-      "name": "pnpm",
-      "version": ">=8"
-    }
+    ]
   },
   "keywords": [],
   "author": "",
@@ -87,23 +103,19 @@
   "optionalDependencies": {
     "win-dpapi": "npm:@primno/dpapi@2.0.1"
   },
-  "scripts": {
-    "docs:list": "tsx scripts/docs-list.ts",
-    "build": "tsc -p tsconfig.build.json && pnpm run build:vendor",
-    "build:vendor": "node -e \"const fs=require('fs'); const path=require('path'); const src=path.join('vendor','oracle-notifier'); const dest=path.join('dist','vendor','oracle-notifier'); fs.mkdirSync(dest,{recursive:true}); if(fs.existsSync(src)){ fs.cpSync(src,dest,{recursive:true,force:true}); }\"",
-    "start": "pnpm run build && node ./dist/scripts/run-cli.js",
-    "oracle": "pnpm start",
-    "check": "pnpm run typecheck",
-    "typecheck": "tsc --noEmit",
-    "lint": "pnpm run typecheck && biome lint .",
-    "test": "vitest run",
-    "test:mcp": "pnpm run build && pnpm run test:mcp:unit && pnpm run test:mcp:mcporter",
-    "test:mcp:unit": "vitest run tests/mcp*.test.ts tests/mcp/**/*.test.ts",
-    "test:mcp:mcporter": "npx -y mcporter list oracle-local --schema --config config/mcporter.json && npx -y mcporter call oracle-local.sessions limit:1 --config config/mcporter.json",
-    "test:browser": "pnpm run build && tsx scripts/test-browser.ts && ./scripts/browser-smoke.sh",
-    "test:live": "ORACLE_LIVE_TEST=1 vitest run tests/live --exclude tests/live/openai-live.test.ts",
-    "test:pro": "ORACLE_LIVE_TEST=1 vitest run tests/live/openai-live.test.ts",
-    "test:coverage": "vitest run --coverage",
-    "mcp": "pnpm run build && node ./dist/bin/oracle-mcp.js"
-  }
-}
+  "pnpm": {
+    "overrides": {
+      "zod": "4.1.13",
+      "win-dpapi": "npm:@primno/dpapi@2.0.1",
+      "zod-to-json-schema": "3.25.0",
+      "devtools-protocol": "0.0.1551306"
+    },
+    "onlyBuiltDependencies": [
+      "@cdktf/node-pty-prebuilt-multiarch",
+      "keytar",
+      "sqlite3",
+      "win-dpapi"
+    ]
+  },
+  "packageManager": "pnpm@10.23.0+sha512.21c4e5698002ade97e4efe8b8b4a89a8de3c85a37919f957e7a0f30f38fbc5bbdd05980ffe29179b2fb6e6e691242e098d945d1601772cad0fef5fb6411e2a4b"
+}

package/vendor/oracle-notifier/README.md

@@ -0,0 +1,24 @@
+# Oracle Notifier helper (macOS, arm64)
+
+Builds a tiny signed helper app for macOS notifications with the Oracle icon.
+
+## Build
+
+```bash
+cd vendor/oracle-notifier
+# Optional: notarize by setting App Store Connect key credentials
+export APP_STORE_CONNECT_API_KEY_P8="$(cat AuthKey_XXXXXX.p8)" # with literal newlines or \n escaped
+export APP_STORE_CONNECT_KEY_ID=XXXXXX
+export APP_STORE_CONNECT_ISSUER_ID=YYYYYYYY-YYYY-YYYY-YYYY-YYYYYYYYYYYY
+./build-notifier.sh
+```
+
+- Requires Xcode command line tools (swiftc) and a macOS Developer ID certificate. Without a valid cert, the build fails (no ad-hoc fallback).
+- If `APP_STORE_CONNECT_*` vars are set, the script notarizes and staples the ticket.
+- Output: `OracleNotifier.app` (arm64 only), bundled with `OracleIcon.icns`.
+
+## Usage
+The CLI prefers this helper on macOS; if it fails or is missing, it falls back to toasted-notifier/terminal-notifier.
+
+## Permissions
+After first run, allow notifications for “Oracle Notifier” in System Settings → Notifications.