pi-oracle 0.7.14 → 0.7.16

package/CHANGELOG.md

@@ -2,6 +2,30 @@
 
 ## Unreleased
 
+## 0.7.16 - 2026-06-24
+
+### Changed
+- updated the local pi development and validation baseline to `@earendil-works/*` `0.80.2`
+- exposed packaged `/oracle` and `/oracle-followup` prompt templates through the package manifest so TUI slash completion can discover them
+- reduced always-on `oracle_submit` prompt metadata while keeping detailed dispatch rules in the prompt templates
+
+### Fixed
+- made `/oracle-*` command output visible in JSON mode through a displayed custom message instead of UI notifications only
+- deferred Chrome user-agent probing until oracle config is loaded, with a timeout on the Chrome version probe
+
+## 0.7.15 - 2026-06-23
+
+### Changed
+- updated the local pi development and validation baseline to `@earendil-works/*` `0.80.1`
+- refreshed oracle README and sanity contracts for pi `0.80.1`
+- moved script-only `@earendil-works/pi-ai` type imports to `@earendil-works/pi-ai/compat`, matching the Pi 0.80 source typechecking migration guidance
+
+### Compatibility
+- reviewed the pi `0.80.0` and `0.80.1` changelogs plus current extension lifecycle, project-trust, security, and package docs; no oracle runtime behavior change was required
+
+### Validation
+- ran `npm run release:check`, including `npm run verify:oracle`, fresh live ChatGPT preset proof for every canonical preset, and Crabbox macOS, Ubuntu, and Windows native `platform-build` plus `real-extension` suites
+
 ## 0.7.14 - 2026-06-22
 
 ### Changed

package/README.md

@@ -2,7 +2,7 @@
 
 `pi-oracle` lets a `pi` agent send hard, long-running work to ChatGPT.com or Grok through the web app, with repo archives, background execution, saved results, and a best-effort wake-up back into `pi` when the answer is ready.
 
-> Status: experimental public beta. Validated on macOS, Linux, and Windows native with Chromium-family browsers and pi `0.79.10`. Pi `0.79.10+` is the suggested tested floor for project-trust-aware package/runtime validation, but pi-bundled runtime packages remain optional wildcard peers so npm peer ranges do not block users from trying newer pi releases. Normal oracle jobs run in an isolated browser profile, not your active browser window.
+> Status: experimental public beta. Current local validation baseline is pi `0.80.2`; the platform-smoke harness covers macOS, Linux, and Windows native with Chromium-family browsers. Pi `0.80.2+` is the suggested tested floor for project-trust-aware package/runtime validation, but pi-bundled runtime packages remain optional wildcard peers so npm peer ranges do not block users from trying newer pi releases. Normal oracle jobs run in an isolated browser profile, not your active browser window.
 
 ## What a successful run looks like
 
@@ -71,13 +71,15 @@ Or from GitHub:
 pi install https://github.com/fitchmultz/pi-oracle
 ```
 
+To update the package later, use `pi update --extensions`, `pi update --all`, or `pi update npm:pi-oracle`. Bare `pi update` updates pi itself only. Versioned npm/git refs stay pinned until you change the configured source.
+
 ### 2. Check requirements
 
 You need:
 
 - macOS, Linux, or Windows native
 - Node.js 22 or newer
-- Suggested tested floor: `pi` 0.79.10 or newer; older pi versions are not blocked by package metadata but are outside the current validation baseline
+- Suggested tested floor: `pi` 0.80.2 or newer; older pi versions are not blocked by package metadata but are outside the current validation baseline
 - Google Chrome/Chromium or another Chromium-family browser
 - ChatGPT or Grok already signed in to the configured local browser profile for the provider you plan to use
 - `agent-browser` and `tar` available on the machine; `zstd` is also required when submitting ChatGPT `.tar.zst` archives

package/docs/ORACLE_DESIGN.md

@@ -7,7 +7,7 @@ Companion doc:
 - `docs/ORACLE_RECOVERY_DRILL.md` — safe expired-auth recovery validation drill
 
 Compatibility target:
-- `pi` 0.79.10+ is the suggested tested floor for current project-trust-aware package/runtime validation
+- `pi` 0.80.2+ is the suggested tested floor for current project-trust-aware package/runtime validation
 - package metadata keeps pi runtime packages as optional wildcard peers, so this suggested floor is not enforced as a hard npm install requirement
 - current extension lifecycle only; no backward-compatibility shims for removed `session_switch` / `session_fork` events
 
@@ -639,6 +639,9 @@ Remaining non-blocking hardening work:
 - keep hardening model-selection verification against future ChatGPT UI variation
 
 Recent proof points:
+- Pi 0.80.2 local gate: `npm run verify:oracle` passed on 2026-06-24 after the JSON command output, prompt-manifest, schema, and lazy Chrome-probe audit fixes
+- Pi 0.80.2 isolated extension smokes: `.artifacts/real-smoke/run-1782321054924-jnq0x3` passed source proof, and `.artifacts/real-smoke/run-1782321056224-yuq5a2` passed packed-install proof
+- Pi 0.80.2 JSON command smoke: `pi --no-extensions -e ./extensions/oracle/index.ts --mode json --no-session --no-approve "/oracle-status"` emitted displayed `oracle-command-output` JSON events
 - Pi 0.79.10 local gate: `npm run verify:oracle` passed on 2026-06-22 after the 0.79.10 baseline refresh and `CONFIG_DIR_NAME` cleanup
 - Pi 0.79.10 isolated extension smokes: `.artifacts/real-smoke/run-1782137209549-0xe67z` passed packed-install proof, and `.artifacts/real-smoke/run-1782137217821-95a1po` passed source model-agent proof
 - Pi 0.79.10 platform artifacts: `.artifacts/platform-smoke/run-1782137574391-7lay68` (macOS platform-build), `.artifacts/platform-smoke/run-1782137619352-gku7jz` (macOS real-extension), `.artifacts/platform-smoke/run-1782137587082-d7kg4p` (Ubuntu platform-build), `.artifacts/platform-smoke/run-1782137619176-lgxezy` (Ubuntu real-extension), `.artifacts/platform-smoke/run-1782137625964-66z0oc` (Windows native platform-build), `.artifacts/platform-smoke/run-1782137752969-pbmdj1` (Windows native real-extension)

package/extensions/oracle/lib/commands.ts

@@ -83,12 +83,21 @@ function isProjectTrusted(ctx: ExtensionCommandContext): boolean {
   return (ctx as { isProjectTrusted?: () => boolean }).isProjectTrusted?.() ?? true;
 }
 
-function emitCommandOutput(ctx: ExtensionCommandContext, message: string, level: "info" | "warning" | "error" = "info"): void {
+function emitCommandOutput(pi: ExtensionAPI, ctx: ExtensionCommandContext, message: string, level: "info" | "warning" | "error" = "info"): void {
   if (ctx.mode === "print") {
     process.stdout.write(`${message}\n`);
     return;
   }
-  ctx.ui.notify(message, level);
+  if (ctx.hasUI) {
+    ctx.ui.notify(message, level);
+    return;
+  }
+  pi.sendMessage({
+    customType: "oracle-command-output",
+    content: message,
+    display: true,
+    details: { level },
+  });
 }
 
 export function registerOracleCommands(pi: ExtensionAPI, authWorkerPath: string, workerPath: string, _promptTemplates: OracleCommandPromptTemplates = {}): void {
@@ -98,11 +107,11 @@ export function registerOracleCommands(pi: ExtensionAPI, authWorkerPath: string,
       try {
         const provider = parseOracleAuthProvider(args);
         const providerLabel = provider === "grok" ? "Grok" : provider === "chatgpt" ? "ChatGPT" : "configured provider";
-        emitCommandOutput(ctx, `Syncing ${providerLabel} cookies from the configured local browser profile into the oracle auth seed profile…`, "info");
+        emitCommandOutput(pi, ctx, `Syncing ${providerLabel} cookies from the configured local browser profile into the oracle auth seed profile…`, "info");
         const result = await runOracleAuthBootstrap(authWorkerPath, ctx.cwd, provider, { projectConfigTrusted: isProjectTrusted(ctx) });
-        emitCommandOutput(ctx, result, "info");
+        emitCommandOutput(pi, ctx, result, "info");
       } catch (error) {
-        emitCommandOutput(ctx, error instanceof Error ? error.message : String(error), "warning");
+        emitCommandOutput(pi, ctx, error instanceof Error ? error.message : String(error), "warning");
       }
     },
   });
@@ -113,12 +122,12 @@ export function registerOracleCommands(pi: ExtensionAPI, authWorkerPath: string,
       const explicitJobId = args.trim();
       const jobId = explicitJobId || getLatestJobId(ctx.cwd);
       if (!jobId) {
-        emitCommandOutput(ctx, "No oracle jobs found for this project", "info");
+        emitCommandOutput(pi, ctx, "No oracle jobs found for this project", "info");
         return;
       }
       const job = readScopedJob(jobId, ctx.cwd);
       if (!job) {
-        emitCommandOutput(ctx, `Oracle job ${jobId} was not found in this project`, "warning");
+        emitCommandOutput(pi, ctx, `Oracle job ${jobId} was not found in this project`, "warning");
         return;
       }
       if (isTerminalOracleJob(job)) {
@@ -130,7 +139,7 @@ export function registerOracleCommands(pi: ExtensionAPI, authWorkerPath: string,
       }
       const summary = await summarizeJob(job.id);
       const recentJobs = !explicitJobId ? listRecentJobIds(ctx.cwd) : undefined;
-      emitCommandOutput(ctx, [summary, recentJobs ? `Recent jobs: ${recentJobs}` : undefined].filter(Boolean).join("\n"), "info");
+      emitCommandOutput(pi, ctx, [summary, recentJobs ? `Recent jobs: ${recentJobs}` : undefined].filter(Boolean).join("\n"), "info");
     },
   });
 
@@ -140,12 +149,12 @@ export function registerOracleCommands(pi: ExtensionAPI, authWorkerPath: string,
       const explicitJobId = args.trim();
       const jobId = explicitJobId || getLatestJobId(ctx.cwd);
       if (!jobId) {
-        emitCommandOutput(ctx, "No oracle jobs found for this project", "info");
+        emitCommandOutput(pi, ctx, "No oracle jobs found for this project", "info");
         return;
       }
       const job = readScopedJob(jobId, ctx.cwd);
       if (!job) {
-        emitCommandOutput(ctx, `Oracle job ${jobId} was not found in this project`, "warning");
+        emitCommandOutput(pi, ctx, `Oracle job ${jobId} was not found in this project`, "warning");
         return;
       }
       if (isTerminalOracleJob(job)) {
@@ -155,7 +164,7 @@ export function registerOracleCommands(pi: ExtensionAPI, authWorkerPath: string,
           cwd: ctx.cwd,
         });
       }
-      emitCommandOutput(ctx, await summarizeJob(job.id, { responsePreview: true }), "info");
+      emitCommandOutput(pi, ctx, await summarizeJob(job.id, { responsePreview: true }), "info");
     },
   });
 
@@ -164,20 +173,20 @@ export function registerOracleCommands(pi: ExtensionAPI, authWorkerPath: string,
     handler: async (args, ctx) => {
       const jobId = args.trim();
       if (!jobId) {
-        emitCommandOutput(ctx, "Usage: /oracle-cancel <job-id>\nUse /oracle-status to find the job id you want to cancel.", "warning");
+        emitCommandOutput(pi, ctx, "Usage: /oracle-cancel <job-id>\nUse /oracle-status to find the job id you want to cancel.", "warning");
         return;
       }
 
       const job = readScopedJob(jobId, ctx.cwd);
       if (!job) {
-        emitCommandOutput(ctx, `Oracle job ${jobId} not found in this project`, "warning");
+        emitCommandOutput(pi, ctx, `Oracle job ${jobId} not found in this project`, "warning");
         return;
       }
       if (!isOpenOracleJob(job)) {
         if (isTerminalOracleJob(job)) {
-          emitCommandOutput(ctx, `Job is already terminal: ${job.status}. Use /oracle-read ${job.id} for details or /oracle-clean ${job.id} to remove it.`, "info");
+          emitCommandOutput(pi, ctx, `Job is already terminal: ${job.status}. Use /oracle-read ${job.id} for details or /oracle-clean ${job.id} to remove it.`, "info");
         } else {
-          emitCommandOutput(ctx, `Oracle job ${jobId} is not cancellable (${job.status})`, "info");
+          emitCommandOutput(pi, ctx, `Oracle job ${jobId} is not cancellable (${job.status})`, "info");
         }
         return;
       }
@@ -187,7 +196,7 @@ export function registerOracleCommands(pi: ExtensionAPI, authWorkerPath: string,
         await promoteQueuedJobs({ workerPath, source: "oracle_cancel_command" });
       }
       refreshOracleStatus(ctx);
-      emitCommandOutput(ctx, formatOracleCancelOutcome(cancelled), "info");
+      emitCommandOutput(pi, ctx, formatOracleCancelOutcome(cancelled), "info");
     },
   });
 
@@ -196,19 +205,20 @@ export function registerOracleCommands(pi: ExtensionAPI, authWorkerPath: string,
     handler: async (args, ctx: ExtensionCommandContext) => {
       const target = args.trim();
       if (!target) {
-        emitCommandOutput(ctx, "Usage: /oracle-clean <job-id|all>", "warning");
+        emitCommandOutput(pi, ctx, "Usage: /oracle-clean <job-id|all>", "warning");
         return;
       }
 
       const jobs = target === "all" ? listJobsForCwd(ctx.cwd) : [readScopedJob(target, ctx.cwd)].filter(Boolean);
       if (jobs.length === 0) {
-        emitCommandOutput(ctx, "No matching oracle jobs found", "warning");
+        emitCommandOutput(pi, ctx, "No matching oracle jobs found", "warning");
         return;
       }
 
       const nonTerminalJobs = jobs.filter((job): job is NonNullable<typeof job> => Boolean(job && !isTerminalOracleJob(job)));
       if (nonTerminalJobs.length > 0) {
         emitCommandOutput(
+          pi,
           ctx,
           `Refusing to remove non-terminal oracle job${nonTerminalJobs.length === 1 ? "" : "s"}: ${nonTerminalJobs.map((job) => job.id).join(", ")}`,
           "warning",
@@ -246,7 +256,7 @@ export function registerOracleCommands(pi: ExtensionAPI, authWorkerPath: string,
         : removedCount === jobs.length
           ? `Removed ${removedCount} oracle job director${removedCount === 1 ? "y" : "ies"}.`
           : `Removed ${removedCount} of ${jobs.length} oracle job director${jobs.length === 1 ? "y" : "ies"}; retained ${jobs.length - removedCount} due to cleanup blockers or warnings.`;
-      emitCommandOutput(ctx, `${removalSummary}${warningSuffix}`, cleanupWarnings.length > 0 ? "warning" : "info");
+      emitCommandOutput(pi, ctx, `${removalSummary}${warningSuffix}`, cleanupWarnings.length > 0 ? "warning" : "info");
     },
   });
 }

package/extensions/oracle/lib/config.ts

@@ -308,7 +308,7 @@ function detectDefaultChromeUserAgent(executablePath: string | undefined): strin
   const platformToken = chromeUserAgentPlatformToken(process.platform);
   if (!platformToken) return undefined;
   try {
-    const versionOutput = execFileSync(executablePath, ["--version"], { encoding: "utf8", env: sweetCookieSafeStoragePasswordScrubbedEnv() }).trim();
+    const versionOutput = execFileSync(executablePath, ["--version"], { encoding: "utf8", env: sweetCookieSafeStoragePasswordScrubbedEnv(), timeout: 1000 }).trim();
     const versionMatch = versionOutput.match(/(\d+\.\d+\.\d+\.\d+)/);
     if (!versionMatch) return undefined;
     return `Mozilla/5.0 (${platformToken}) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/${versionMatch[1]} Safari/537.36`;
@@ -318,8 +318,17 @@ function detectDefaultChromeUserAgent(executablePath: string | undefined): strin
 }
 
 const detectedChromeExecutablePath = detectDefaultChromeExecutablePath();
-const detectedChromeUserAgent = detectDefaultChromeUserAgent(detectedChromeExecutablePath);
+let detectedChromeUserAgent: string | undefined;
+let detectedChromeUserAgentResolved = false;
 const agentExtensionsDir = join(getAgentDir(), "extensions");
+
+function getDetectedChromeUserAgent(): string | undefined {
+  if (!detectedChromeUserAgentResolved) {
+    detectedChromeUserAgent = detectDefaultChromeUserAgent(detectedChromeExecutablePath);
+    detectedChromeUserAgentResolved = true;
+  }
+  return detectedChromeUserAgent;
+}
 const detectedChromeProfileName = detectDefaultBrowserProfileSource(process.platform);
 
 export interface OracleConfigLoadOptions {
@@ -442,7 +451,7 @@ export const DEFAULT_CONFIG: OracleConfig = {
     authUrl: "https://chatgpt.com/auth/login",
     runMode: "headless",
     executablePath: detectedChromeExecutablePath,
-    userAgent: detectedChromeUserAgent,
+    userAgent: undefined,
     args: ["--disable-blink-features=AutomationControlled"],
   },
   auth: {
@@ -732,5 +741,14 @@ export function loadOracleConfig(cwd: string, options?: OracleConfigLoadOptions)
   const details = getOracleConfigLoadDetails(cwd, options);
   const globalConfig = readJson(details.agentConfigPath);
   const projectConfig = details.projectConfigLoaded ? filterProjectConfig(readJson(details.projectConfigPath)) : undefined;
-  return validateOracleConfig(deepMerge(deepMerge(DEFAULT_CONFIG, globalConfig), projectConfig));
+  const globalBrowser = isObject(globalConfig) ? globalConfig.browser : undefined;
+  const hasConfiguredUserAgent = isObject(globalBrowser) && globalBrowser.userAgent !== undefined;
+  const defaults = {
+    ...DEFAULT_CONFIG,
+    browser: {
+      ...DEFAULT_CONFIG.browser,
+      userAgent: hasConfiguredUserAgent ? undefined : getDetectedChromeUserAgent(),
+    },
+  };
+  return validateOracleConfig(deepMerge(deepMerge(defaults, globalConfig), projectConfig));
 }

package/extensions/oracle/lib/tools.ts

@@ -10,13 +10,14 @@ import { join } from "node:path";
 import { createArchive, type ArchiveCreationResult, type ArchiveSizeBreakdownRow } from "./archive.js";
 import { runOracleAuthBootstrap } from "./auth.js";
 import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
-import { Type } from "typebox";
+import { Type, type Static } from "typebox";
 import { formatOracleCancelOutcome, formatOracleJobSummary, formatOracleSubmitResponse } from "../shared/job-observability-helpers.mjs";
 import { getLatestOracleJobLifecycleEvent, getLatestOracleTerminalLifecycleEvent, transitionOracleJobPhase } from "../shared/job-lifecycle-helpers.mjs";
 import { isLockTimeoutError, withGlobalReconcileLock, withLock } from "./locks.js";
 import {
   coerceOracleSubmitPresetId,
   loadOracleConfig,
+  GROK_MODES,
   ORACLE_PROVIDERS,
   ORACLE_SUBMIT_PRESET_IDS,
   resolveOracleConfigForProvider,
@@ -64,6 +65,16 @@ import {
   tryAcquireRuntimeLease,
 } from "./runtime.js";
 
+const ORACLE_PROVIDER_PARAM_DESCRIPTION = `Oracle web provider. Omit to use the configured default provider. Supported providers: ${ORACLE_PROVIDERS.join(", ")}.`;
+const ORACLE_PROVIDER_PARAM = Type.Optional(Type.String({
+  description: ORACLE_PROVIDER_PARAM_DESCRIPTION,
+  enum: [...ORACLE_PROVIDERS],
+}));
+const ORACLE_GROK_MODE_PARAM = Type.Optional(Type.String({
+  description: "Provider mode. For Grok, only heavy is currently supported. Omit to use the configured default mode.",
+  enum: [...GROK_MODES],
+}));
+
 const ORACLE_SUBMIT_PARAMS = Type.Object({
   prompt: Type.String({ description: "Prompt text to send to ChatGPT or Grok web." }),
   files: Type.Array(Type.String({
@@ -74,11 +85,7 @@ const ORACLE_SUBMIT_PARAMS = Type.Object({
     description: "Exact project-relative files/directories to include in the oracle archive.",
     minItems: 1,
   }),
-  provider: Type.Optional(
-    Type.String({
-      description: `Oracle web provider. Omit to use the configured default provider. Supported providers: ${ORACLE_PROVIDERS.join(", ")}. Use grok when the user asks to oracle to Grok. Grok archives are capped at 200 MiB.`,
-    }),
-  ),
+  provider: ORACLE_PROVIDER_PARAM,
   preset: Type.Optional(
     Type.String({
       description:
@@ -86,40 +93,36 @@ const ORACLE_SUBMIT_PARAMS = Type.Object({
         "Matching human-readable preset labels and common hyphen/space variants are normalized automatically. Do not pass preset when provider is grok.",
     }),
   ),
-  mode: Type.Optional(
-    Type.String({
-      description: "Provider mode. For Grok, only heavy is currently supported. Omit to use the configured default mode.",
-    }),
-  ),
+  mode: ORACLE_GROK_MODE_PARAM,
   followUpJobId: Type.Optional(Type.String({ description: "Earlier oracle job id whose chat thread should be continued." })),
   chatGptConversationId: Type.Optional(Type.String({
     description: "Existing ChatGPT conversation id, or full https://chatgpt.com/c/... URL, to continue. Omit for default behavior: starting a fresh oracle thread. Do not combine with followUpJobId.",
     minLength: 1,
     pattern: "^.*\\S.*$",
   })),
-});
+}, { additionalProperties: false });
 
 const ORACLE_PREFLIGHT_PARAMS = Type.Object({
-  provider: Type.Optional(Type.String({ description: `Provider readiness to check. Omit to use the configured default provider. Supported providers: ${ORACLE_PROVIDERS.join(", ")}.` })),
+  provider: ORACLE_PROVIDER_PARAM,
   followUpJobId: Type.Optional(Type.String({ description: "Earlier oracle job id whose provider/thread readiness should be checked." })),
   chatGptConversationId: Type.Optional(Type.String({
     description: "Existing ChatGPT conversation id, or full https://chatgpt.com/c/... URL, whose provider/thread readiness should be checked. Do not combine with followUpJobId.",
     minLength: 1,
     pattern: "^.*\\S.*$",
   })),
-});
+}, { additionalProperties: false });
 
 const ORACLE_AUTH_PARAMS = Type.Object({
-  provider: Type.Optional(Type.String({ description: `Provider auth seed to refresh. Omit to use the configured default provider. Supported providers: ${ORACLE_PROVIDERS.join(", ")}.` })),
-});
+  provider: ORACLE_PROVIDER_PARAM,
+}, { additionalProperties: false });
 
 const ORACLE_READ_PARAMS = Type.Object({
   jobId: Type.String({ description: "Oracle job id." }),
-});
+}, { additionalProperties: false });
 
 const ORACLE_CANCEL_PARAMS = Type.Object({
   jobId: Type.String({ description: "Oracle job id." }),
-});
+}, { additionalProperties: false });
 
 const MAX_QUEUED_JOBS_PER_ACTIVE_RUNTIME = 1;
 const MAX_QUEUED_ARCHIVE_BYTES_PER_ACTIVE_RUNTIME = resolveOracleProviderArchivePlan("chatgpt").maxArchiveBytes;
@@ -132,6 +135,24 @@ function normalizeOracleProvider(value: unknown, fallback: OracleProvider, toolN
   throw new Error(`Unknown ${toolName} provider: ${value}. Use chatgpt or grok.`);
 }
 
+function prepareOracleProviderAliases<T>(args: unknown, toolName: string): T {
+  const record = asRecord(args);
+  if (!record) return args as T;
+  return {
+    ...record,
+    provider: typeof record.provider === "string" ? normalizeOracleProvider(record.provider, "chatgpt", toolName) : record.provider,
+  } as T;
+}
+
+function prepareOracleSubmitArguments(args: unknown): Static<typeof ORACLE_SUBMIT_PARAMS> {
+  const record = asRecord(args);
+  if (!record) return args as Static<typeof ORACLE_SUBMIT_PARAMS>;
+  return {
+    ...prepareOracleProviderAliases<Record<string, unknown>>(record, "oracle_submit"),
+    mode: typeof record.mode === "string" ? normalizeGrokMode(record.mode, "heavy") : record.mode,
+  } as Static<typeof ORACLE_SUBMIT_PARAMS>;
+}
+
 function normalizeGrokMode(value: unknown, fallback: "heavy"): "heavy" {
   if (value === undefined) return fallback;
   if (typeof value !== "string") throw new Error("oracle_submit mode must be a string");
@@ -789,6 +810,7 @@ export function registerOracleTools(pi: ExtensionAPI, workerPath: string, authWo
       "Call oracle_preflight before doing expensive /oracle preparation. Pass provider='grok' when the user explicitly asks for Grok, followUpJobId for same-thread follow-ups from oracle-created jobs, or chatGptConversationId when the user explicitly provides an existing ChatGPT browser conversation id/URL. If ready is false, stop immediately and report the suggested next step instead of reading files or crafting archive inputs.",
     ],
     parameters: ORACLE_PREFLIGHT_PARAMS,
+    prepareArguments: (args) => prepareOracleProviderAliases(args, "oracle_preflight"),
     async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
       const details = await runOraclePreflight(ctx, params);
       return {
@@ -809,6 +831,7 @@ export function registerOracleTools(pi: ExtensionAPI, workerPath: string, authWo
       "If oracle_auth itself fails, stop and report the failure instead of looping.",
     ],
     parameters: ORACLE_AUTH_PARAMS,
+    prepareArguments: (args) => prepareOracleProviderAliases(args, "oracle_auth"),
     async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
       try {
         const projectCwd = getProjectId(ctx.cwd);
@@ -838,26 +861,16 @@ export function registerOracleTools(pi: ExtensionAPI, workerPath: string, authWo
       "Optional thread target: pass `chatGptConversationId` only when the user explicitly provides an existing ChatGPT browser conversation id/URL to continue; omit it for the default fresh oracle thread.",
     promptSnippet: "Dispatch a background ChatGPT or Grok web oracle job after gathering repo context.",
     promptGuidelines: [
-      "Gather context before calling oracle_submit.",
-      "If the user explicitly provides an existing ChatGPT browser conversation id or https://chatgpt.com/c/... URL, pass it as chatGptConversationId and force provider='chatgpt'; otherwise omit chatGptConversationId so oracle_submit starts a fresh thread by default.",
-      "If the immediately preceding oracle run failed because ChatGPT or Grok login is required or the worker explicitly said to rerun /oracle-auth, call oracle_auth once before retrying the submission; pass provider='grok' for Grok retries. Do not loop auth refreshes.",
-      "Prefer context-rich archives up to the provider ceiling because more relevant surrounding context is usually better than less: 250 MB for ChatGPT and 200 MiB for Grok.",
-      "By default, archive the whole repo by passing '.' for broad or unclear requests; default archive exclusions apply automatically, including common bulky outputs and obvious credentials/private data like .env files, key material, credential dotfiles, local database files, and nested secrets directories anywhere in the repo.",
-      "For narrower asks, still include nearby tests, docs, configs, and adjacent modules when they may improve answer quality. Only narrow aggressively when the user explicitly asks, privacy/sensitivity requires it, or size pressure forces it.",
-      "Do not default to a one-file archive for a single function, file, or stack trace if the relevant surrounding context still fits comfortably within the limit.",
-      "When files='.' and the post-exclusion archive is still too large, submit automatically prunes the largest nested directories matching generic generated-output names like build/, dist/, out/, coverage/, and tmp/ outside obvious source roots like src/ and lib/ until the archive fits or no candidate remains; successful submissions report what was pruned.",
-      "If a submitted oracle job later fails because upload is rejected, retry smaller: remove the largest obviously irrelevant/generated content first, then narrow to modified files plus adjacent files plus directly relevant subtrees, then explain the cut or ask the user if still needed.",
-      "If oracle_submit fails before dispatch with details.error.code === 'archive_too_large' or an upload-limit message, treat that as retryable and retry automatically with a smaller archive.",
-      "For archive_too_large retries, use the reported top-level size summary and any auto-pruned paths to decide what to cut: first remove the largest obviously irrelevant/generated/history/export content, then if needed narrow to the directly relevant subtrees plus adjacent docs/tests/config.",
-      "Do not loop forever: stop after at most two total oracle_submit attempts for the same request, and if it still does not fit explain what was cut and why.",
-      "For any other submit-time error, stop and report the error instead of retrying automatically.",
-      "If oracle_submit returns a queued job instead of an immediately dispatched one, treat that as success and stop exactly the same way.",
-      "After a successful or queued oracle_submit, stop; do not continue the task while the oracle job is running. If oracle_submit failed with retryable archive_too_large, narrow the archive and retry first.",
-      "For ChatGPT, use `preset` as the only model-selection parameter on oracle_submit. " +
-      `Canonical ids: ${ORACLE_SUBMIT_PRESET_IDS.join(", ")}. ` +
-      "matching human-readable preset labels are normalized automatically. Omit preset to use the configured default. For Grok, pass provider='grok' and omit preset; only Heavy is supported today.",
+      "Call oracle_preflight first, then gather enough context to choose archive inputs before oracle_submit.",
+      "Use context-rich archives when they fit; use files='.' for broad repo-wide asks. Default exclusions already skip common bulky outputs and obvious credentials/private data.",
+      "Pass chatGptConversationId only when the user explicitly provides an existing ChatGPT conversation id/URL; otherwise omit it for a fresh thread.",
+      "If auth is stale, call oracle_auth at most once before retrying. If oracle_auth fails, stop and report it.",
+      "If details.error.code is 'archive_too_large', retry once with a smaller archive using the reported size/pruning details; do not loop.",
+      "After a successful or queued oracle_submit, stop and report only the dispatch summary. Do not keep working while the oracle job runs.",
+      "For ChatGPT, use preset only when the user requests model control; otherwise omit it. For Grok, pass provider='grok' and omit preset.",
     ],
     parameters: ORACLE_SUBMIT_PARAMS,
+    prepareArguments: prepareOracleSubmitArguments,
     async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
       try {
         const projectCwd = getProjectId(ctx.cwd);
@@ -878,6 +891,9 @@ export function registerOracleTools(pi: ExtensionAPI, workerPath: string, authWo
         if (provider === "grok" && typeof params.preset === "string") {
           throw new Error("oracle_submit preset is only valid for ChatGPT. For Grok, use provider='grok' and mode='heavy'.");
         }
+        if (provider === "chatgpt" && typeof params.mode === "string") {
+          throw new Error("oracle_submit mode is only valid for Grok. For ChatGPT, omit mode and use preset for model selection.");
+        }
         const selection = provider === "grok"
           ? resolveOracleGrokMode(normalizeGrokMode(params.mode, baseConfig.defaults.grokMode))
           : resolveOracleSubmitPreset(typeof params.preset === "string" ? coerceOracleSubmitPresetId(params.preset) : baseConfig.defaults.preset);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-oracle",
-  "version": "0.7.14",
+  "version": "0.7.16",
   "description": "ChatGPT and Grok web-oracle extension for pi with isolated browser auth, async jobs, and project-context archives.",
   "private": false,
   "license": "MIT",
@@ -42,6 +42,9 @@
   "pi": {
     "extensions": [
       "./extensions/oracle/index.ts"
+    ],
+    "prompts": [
+      "./prompts"
     ]
   },
   "scripts": {
@@ -83,8 +86,8 @@
     "protobufjs": "7.6.1"
   },
   "devDependencies": {
-    "@earendil-works/pi-ai": "^0.79.10",
-    "@earendil-works/pi-coding-agent": "^0.79.10",
+    "@earendil-works/pi-ai": "^0.80.2",
+    "@earendil-works/pi-coding-agent": "^0.80.2",
     "@types/node": "^22.19.19",
     "esbuild": "^0.28.0",
     "tsx": "^4.22.3",

package/prompts/oracle-followup.md

@@ -1,5 +1,6 @@
 ---
 description: Continue an earlier oracle job in the same provider thread
+argument-hint: <job-id> <request>
 ---
 You are preparing an `/oracle-followup` job.
 

package/prompts/oracle.md

@@ -1,5 +1,6 @@
 ---
 description: Prepare and dispatch a ChatGPT or Grok web oracle job
+argument-hint: <request>
 ---
 You are preparing an /oracle job.
 

package/scripts/platform-smoke/Dockerfile.ubuntu

@@ -4,5 +4,5 @@ USER root
 RUN apt-get update \
   && apt-get install -y --no-install-recommends zstd rsync \
   && rm -rf /var/lib/apt/lists/*
-RUN npm install -g agent-browser@0.27.0
+RUN npm install -g agent-browser@0.29.1
 USER circleci