@steipete/oracle 0.20.3 → 0.21.0

package/dist/src/browser/config.js

@@ -58,6 +58,7 @@ export const DEFAULT_BROWSER_CONFIG = {
     researchMode: "off",
     archiveConversations: "auto",
     resumeConversationUrl: null,
+    captureProviderNative: false,
 };
 export function resolveBrowserConfig(config) {
     const debugPortEnv = parseDebugPort(process.env.ORACLE_BROWSER_PORT ?? process.env.ORACLE_BROWSER_DEBUG_PORT);
@@ -117,6 +118,7 @@ export function resolveBrowserConfig(config) {
         researchMode,
         archiveConversations,
         resumeConversationUrl: config?.resumeConversationUrl ?? DEFAULT_BROWSER_CONFIG.resumeConversationUrl,
+        captureProviderNative: config?.captureProviderNative ?? DEFAULT_BROWSER_CONFIG.captureProviderNative,
         manualLogin,
         manualLoginProfileDir: manualLogin ? resolvedProfileDir : null,
         manualLoginCookieSync: config?.manualLoginCookieSync ?? DEFAULT_BROWSER_CONFIG.manualLoginCookieSync,

package/dist/src/browser/index.js

@@ -16,6 +16,7 @@ import { INPUT_SELECTORS } from "./constants.js";
 import { uploadAttachmentViaDataTransfer } from "./actions/remoteFileTransfer.js";
 import { ensureThinkingTime } from "./actions/thinkingTime.js";
 import { throwIfAssistantUiError } from "./actions/assistantResponse.js";
+import { finalizeProviderNativeCapture, } from "./chatgptConversation.js";
 import { startThinkingStatusMonitor } from "./actions/thinkingStatus.js";
 import { classifyChatGptUiWarningText, collectChatGptUiWarnings, createAssistantTimeoutError, throwChatGptUiWarningIfPresent, } from "./uiWarnings.js";
 import { activateDeepResearch, captureDeepResearchTargetKeys, waitForDeepResearchCompletion, waitForResearchPlanAutoConfirm, } from "./actions/deepResearch.js";
@@ -443,6 +444,31 @@ function formatBrowserLeaseDiagnostics(options) {
         `launch=${options.launchDisposition ?? "unknown"}`,
     ].join("; ");
 }
+/**
+ * Provider-native capture, gated on explicit opt-in.
+ *
+ * Off by default because it costs two extra authenticated requests per run and
+ * only matters when a caller intends to treat the transcript as evidence rather
+ * than as an answer. When it is on and it fails, the run is unaffected: the
+ * summary records why, and nothing throws.
+ */
+async function runProviderNativeCapture(params) {
+    if (!params.config.captureProviderNative) {
+        return { artifacts: [] };
+    }
+    const conversationId = params.conversationUrl
+        ? extractConversationIdFromUrl(params.conversationUrl)
+        : undefined;
+    return finalizeProviderNativeCapture({
+        Runtime: params.Runtime,
+        conversationId,
+        conversationUrl: params.conversationUrl,
+        sessionId: params.sessionId,
+        answerMarkdown: params.answerMarkdown,
+        answerMessageId: params.answerMessageId,
+        logger: params.logger,
+    });
+}
 function buildSkippedModelSelectionEvidence(desiredModel, strategy) {
     return {
         requestedModel: desiredModel ?? null,
@@ -682,6 +708,7 @@ async function runBrowserModeInternal(options, cancellation) {
     const startedAt = Date.now();
     let answerText = "";
     let answerMarkdown = "";
+    let answerMessageId;
     let answerHtml = "";
     let runStatus = "attempted";
     let connectionClosedUnexpectedly = false;
@@ -1227,15 +1254,23 @@ async function runBrowserModeInternal(options, cancellation) {
                 conversationUrl: lastUrl,
                 logger,
             }), logger);
+            const providerCapture = await runProviderNativeCapture({
+                Runtime,
+                config,
+                conversationUrl: lastUrl,
+                sessionId: options.sessionId,
+                answerMarkdown: researchResult.text,
+                logger,
+            });
             const transcriptArtifact = await saveOptionalArtifact(() => saveBrowserTranscriptArtifact({
                 sessionId: options.sessionId,
                 prompt: promptText,
                 answerMarkdown: researchResult.text,
                 conversationUrl: lastUrl,
-                artifacts: appendArtifacts(undefined, [reportArtifact]),
+                artifacts: appendArtifacts(appendArtifacts(undefined, [reportArtifact]), providerCapture.artifacts),
                 logger,
             }), logger);
-            const savedArtifacts = appendArtifacts(undefined, [reportArtifact, transcriptArtifact]);
+            const savedArtifacts = appendArtifacts(appendArtifacts(undefined, [reportArtifact, transcriptArtifact]), providerCapture.artifacts);
             const archive = await maybeArchiveCompletedConversation({
                 Runtime,
                 logger,
@@ -1249,6 +1284,7 @@ async function runBrowserModeInternal(options, cancellation) {
                 answerMarkdown: researchResult.text,
                 answerHtml: researchResult.html,
                 artifacts: savedArtifacts,
+                providerNativeCapture: providerCapture.summary,
                 archive,
                 modelSelection: modelSelectionEvidence,
                 thinkingSelection: thinkingSelectionEvidence,
@@ -1561,6 +1597,7 @@ async function runBrowserModeInternal(options, cancellation) {
                     turnAnswerMarkdown = bestText;
                 }
             }
+            answerMessageId = turnAnswer.meta.messageId ?? undefined;
             return {
                 label,
                 answerText: turnAnswerText,
@@ -1664,15 +1701,25 @@ async function runBrowserModeInternal(options, cancellation) {
         });
         const savedImageArtifacts = appendArtifacts(undefined, imageArtifacts.savedImages);
         const savedBrowserArtifacts = appendArtifacts(savedImageArtifacts, fileArtifacts.savedFiles);
+        const providerCapture = await runProviderNativeCapture({
+            Runtime,
+            config,
+            conversationUrl: lastUrl,
+            sessionId: options.sessionId,
+            answerMarkdown,
+            answerMessageId,
+            logger,
+        });
+        const browserArtifactsWithCapture = appendArtifacts(savedBrowserArtifacts, providerCapture.artifacts);
         const transcriptArtifact = await saveOptionalArtifact(() => saveBrowserTranscriptArtifact({
             sessionId: options.sessionId,
             prompt: promptText,
             answerMarkdown,
             conversationUrl: lastUrl,
-            artifacts: savedBrowserArtifacts,
+            artifacts: browserArtifactsWithCapture,
             logger,
         }), logger);
-        const savedArtifacts = appendArtifacts(savedBrowserArtifacts, [transcriptArtifact]);
+        const savedArtifacts = appendArtifacts(browserArtifactsWithCapture, [transcriptArtifact]);
         const archive = await maybeArchiveCompletedConversation({
             Runtime,
             logger,
@@ -1692,6 +1739,7 @@ async function runBrowserModeInternal(options, cancellation) {
             answerMarkdown,
             answerHtml: answerHtml.length > 0 ? answerHtml : undefined,
             artifacts: savedArtifacts,
+            providerNativeCapture: providerCapture.summary,
             generatedImages: imageArtifacts.generatedImages,
             savedImages: imageArtifacts.savedImages,
             downloadableFiles: fileArtifacts.files,
@@ -2233,6 +2281,7 @@ async function runRemoteBrowserMode(promptText, attachments, config, logger, opt
     const startedAt = Date.now();
     let answerText = "";
     let answerMarkdown = "";
+    let answerMessageId;
     let answerHtml = "";
     let connectionClosedUnexpectedly = false;
     let runStatus = "attempted";
@@ -2552,15 +2601,23 @@ async function runRemoteBrowserMode(promptText, attachments, config, logger, opt
                 conversationUrl: lastUrl,
                 logger,
             }), logger);
+            const providerCapture = await runProviderNativeCapture({
+                Runtime,
+                config,
+                conversationUrl: lastUrl,
+                sessionId: options.sessionId,
+                answerMarkdown: researchResult.text,
+                logger,
+            });
             const transcriptArtifact = await saveOptionalArtifact(() => saveBrowserTranscriptArtifact({
                 sessionId: options.sessionId,
                 prompt: promptText,
                 answerMarkdown: researchResult.text,
                 conversationUrl: lastUrl,
-                artifacts: appendArtifacts(undefined, [reportArtifact]),
+                artifacts: appendArtifacts(appendArtifacts(undefined, [reportArtifact]), providerCapture.artifacts),
                 logger,
             }), logger);
-            const savedArtifacts = appendArtifacts(undefined, [reportArtifact, transcriptArtifact]);
+            const savedArtifacts = appendArtifacts(appendArtifacts(undefined, [reportArtifact, transcriptArtifact]), providerCapture.artifacts);
             const archive = await maybeArchiveCompletedConversation({
                 Runtime,
                 logger,
@@ -2575,6 +2632,7 @@ async function runRemoteBrowserMode(promptText, attachments, config, logger, opt
                 answerMarkdown: researchResult.text,
                 answerHtml: researchResult.html,
                 artifacts: savedArtifacts,
+                providerNativeCapture: providerCapture.summary,
                 archive,
                 modelSelection: modelSelectionEvidence,
                 thinkingSelection: thinkingSelectionEvidence,
@@ -2852,6 +2910,7 @@ async function runRemoteBrowserMode(promptText, attachments, config, logger, opt
                     turnAnswerMarkdown = bestText;
                 }
             }
+            answerMessageId = turnAnswer.meta.messageId ?? undefined;
             return {
                 label,
                 answerText: turnAnswerText,
@@ -2947,15 +3006,25 @@ async function runRemoteBrowserMode(promptText, attachments, config, logger, opt
         });
         const savedImageArtifacts = appendArtifacts(undefined, imageArtifacts.savedImages);
         const savedBrowserArtifacts = appendArtifacts(savedImageArtifacts, fileArtifacts.savedFiles);
+        const providerCapture = await runProviderNativeCapture({
+            Runtime,
+            config,
+            conversationUrl: lastUrl,
+            sessionId: options.sessionId,
+            answerMarkdown,
+            answerMessageId,
+            logger,
+        });
+        const browserArtifactsWithCapture = appendArtifacts(savedBrowserArtifacts, providerCapture.artifacts);
         const transcriptArtifact = await saveOptionalArtifact(() => saveBrowserTranscriptArtifact({
             sessionId: options.sessionId,
             prompt: promptText,
             answerMarkdown,
             conversationUrl: lastUrl,
-            artifacts: savedBrowserArtifacts,
+            artifacts: browserArtifactsWithCapture,
             logger,
         }), logger);
-        const savedArtifacts = appendArtifacts(savedBrowserArtifacts, [transcriptArtifact]);
+        const savedArtifacts = appendArtifacts(browserArtifactsWithCapture, [transcriptArtifact]);
         const archive = await maybeArchiveCompletedConversation({
             Runtime,
             logger,
@@ -2991,6 +3060,7 @@ async function runRemoteBrowserMode(promptText, attachments, config, logger, opt
             submittedPromptHash,
             ownedRecoveryTarget,
             artifacts: savedArtifacts,
+            providerNativeCapture: providerCapture.summary,
             generatedImages: imageArtifacts.generatedImages,
             savedImages: imageArtifacts.savedImages,
             downloadableFiles: fileArtifacts.files,

package/dist/src/browser/sessionRunner.js

@@ -313,6 +313,7 @@ async function executeAssembledBrowserSession({ runOptions, browserConfig, log,
         archive: browserResult.archive,
         modelSelection,
         thinkingSelection,
+        providerNativeCapture: browserResult.providerNativeCapture,
         warnings,
         answerText,
         artifacts: savedArtifacts,

package/dist/src/cli/browserConfig.js

@@ -238,6 +238,7 @@ export async function buildBrowserConfig(options) {
             ? options.browserResearch
             : "off",
         archiveConversations: options.browserArchive,
+        captureProviderNative: options.browserCaptureProviderNative,
     };
 }
 function assertBrowserModelAvailable(model, modelStrategy) {

package/dist/src/cli/browserDefaults.js

@@ -111,6 +111,10 @@ export function applyBrowserDefaultsFromConfig(options, config, getSource) {
         browser.thinkingTime !== undefined) {
         options.browserThinkingTime = normalizeThinkingTimeLevel(browser.thinkingTime) ?? undefined;
     }
+    if (isUnset("browserCaptureProviderNative") &&
+        typeof browser.captureProviderNative === "boolean") {
+        options.browserCaptureProviderNative = browser.captureProviderNative;
+    }
     if (isUnset("browserResearch") && browser.researchMode !== undefined) {
         options.browserResearch = browser.researchMode;
     }

package/dist/src/cli/sessionRunner.js

@@ -161,6 +161,7 @@ export async function performSessionRun({ sessionMeta, runOptions, mode, browser
                     archive: result.archive,
                     modelSelection: result.modelSelection,
                     thinkingSelection: result.thinkingSelection,
+                    providerNativeCapture: result.providerNativeCapture,
                     warnings: browserWarnings.length > 0 ? browserWarnings : undefined,
                 },
                 artifacts: mergeArtifacts(sessionMeta.artifacts, mergeArtifacts(result.artifacts, outputArtifacts.artifacts)),

package/dist/src/config.js

@@ -131,6 +131,7 @@ function sanitizeProjectConfig(config) {
     if (config.browser) {
         sanitized.browser = {};
         const browser = config.browser;
+        // Full-conversation retention is user-owned; never allow captureProviderNative here.
         const allowedBrowserKeys = [
             "attachRunning",
             "timeoutMs",

package/dist/src/remote/server.js

@@ -867,6 +867,7 @@ function sanitizeResult(result, warnings = []) {
         answerChars: result.answerChars,
         modelSelection: result.modelSelection,
         thinkingSelection: result.thinkingSelection,
+        providerNativeCapture: result.providerNativeCapture,
         researchPlan: result.researchPlan,
         archive: result.archive,
         tabUrl: result.tabUrl,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steipete/oracle",
-  "version": "0.20.3",
+  "version": "0.21.0",
   "description": "CLI wrapper around OpenAI Responses API with GPT-5.6 Sol, GPT-5.6, GPT-5.5 Pro, GPT-5.5, GPT-5.4, GPT-5.2, GPT-5.1, and GPT-5.1 Codex high reasoning modes.",
   "keywords": [],
   "homepage": "https://askoracle.sh",