@companion-ai/feynman 0.5.39 → 0.5.41

package/RELEASES.md

@@ -6,6 +6,22 @@ GitHub release notes are generated from the matching `## vX.Y.Z` section in this
 
 ## Unreleased
 
+## v0.5.41 - 2026-10-12
+
+- **A fresh `npm install` works again.** Pi 1.2.0, released today, made new npm installs of Feynman 0.5.40 fail on every command except `-v` (`does not provide an export named 'MCP_TYPESCRIPT_PREAMBLE'`). Pi 1.1.0 asks for its own sub-packages with open version ranges, so npm pulled Pi 1.2.0's copies. Feynman now pins those sub-packages to the Pi version it ships. The curl and PowerShell installers were not affected.
+- **An expired sign-in no longer looks like no model.** Feynman treated a ChatGPT, Claude or Copilot sign-in whose short-lived access token had expired as if no model were set up. `feynman` reopened the setup menu, and since 0.5.36 `feynman -p` refused to run. Pi renews the token on the next request, so Feynman now leaves that to Pi and asks you to sign in again only when renewal really fails.
+- **`--model` accepts the names Pi accepts.** Bare model IDs (`claude-opus-5-5`), short names (`sonnet`) and a thinking suffix (`anthropic/claude-opus-5-5:high`) now work, preferring a provider you are signed in to; `provider/model` and `provider:model` still work. Pro-class models stay blocked.
+- **After you sign in, the model list matches your account.** `feynman model login` refreshes that provider's model list, so an OpenRouter key gets the models it can actually use before Feynman picks a default.
+- A provider error hint now appears once the run has stopped, not in the middle of an automatic retry.
+- Launching Feynman no longer erases your terminal's scrollback.
+- The llama.cpp provider is recognized as a local model.
+- **Preview and PDF export find more browsers.** Chromium, Edge and Brave on Linux, Edge under `Program Files (x86)` and Brave in your user folder on Windows, and apps in `~/Applications` on macOS. Thanks to @A-ryanVAT-S (#343).
+
+## v0.5.40 - 2026-10-12
+
+- **alphaXiv sign-in messages name the right command.** When you weren't signed in, `feynman alpha search`, `get` and the paper tools said to run `alpha login`, a command that isn't installed with Feynman. They now say `feynman alpha login`. (Alpha Hub 0.1.7.)
+- Security: Alpha Hub now requires `@modelcontextprotocol/sdk` 1.32.1 or later, so a fresh install can't resolve a version affected by GHSA-6qxp-vccf-f47h.
+
 ## v0.5.39 - 2026-10-12
 
 - **Web search and fetching are steadier (pi-web-access 0.39.0).** Search summaries now read each source's snippet, so providers that return only links still produce a summary. `auto` search moves on when a provider returns nothing, a stalled Perplexity request gives up after 30 seconds, and a DuckDuckGo bot check is reported as a block instead of an empty search. `fetch_content` answers end with the `get_search_content` call that reads the stored page, answer mode with several URLs shows every page's answer, and PDFs can go to a document parser you run yourself (`pdf.provider: "endpoint"` in `~/.feynman/agent/web-search.json`).

package/dist/cli.js

@@ -19,7 +19,7 @@ import { ensureFeynmanAgentDir } from "./bootstrap/home.js";
 import { ensureFeynmanHome, getDefaultSessionDir, getFeynmanAgentDir, getFeynmanHome } from "./config/paths.js";
 import { getLastPiStderr, launchPiChat, runPi } from "./pi/launch.js";
 import { installPiPackage, removePiPackage, listOptionalPackagePresets, normalizeOptionalPackagePresetName, resolvePackageSource, updatePiPackages, } from "./pi/packages.js";
-import { canonicalizeModelSpec, ensureFeynmanSettings, normalizeThinkingLevel, readJson, } from "./pi/settings.js";
+import { resolveExplicitModelSpec, ensureFeynmanSettings, normalizeThinkingLevel, readJson, } from "./pi/settings.js";
 import { BUNDLED_PI_PACKAGES, buildPiEnv, findWindowsBash, WINDOWS_BASH_MISSING_NOTICE } from "./pi/runtime.js";
 import { getConfiguredServiceTier, normalizeServiceTier, setConfiguredServiceTier } from "./model/service-tier.js";
 import { authenticateModelProvider, getCurrentModelSpec, isLocalModelProvider, loginModelProvider, logoutModelProvider, printModelList, selectDefaultModel, setDefaultModelSpec, } from "./model/commands.js";
@@ -421,7 +421,9 @@ export async function main() {
             ...commandTelemetry,
             duration_ms: durationMs,
             exit_code: exitCode,
-            ...(exitCode === 0 ? {} : { pi_stderr: getLastPiStderr() }),
+            // A fixed reason for a deliberate non-zero exit, so it isn't read as a crash.
+            ...(exitReason ? { exit_reason: exitReason } : {}),
+            ...(exitCode === 0 || exitReason ? {} : { pi_stderr: getLastPiStderr() }),
         };
         captureTelemetryEvent(exitCode === 0 ? "feynman_command_completed" : "feynman_command_failed", completeProperties);
     }
@@ -440,6 +442,8 @@ export async function main() {
         await shutdownPostHogTelemetry();
     }
 }
+// Set when Feynman exits non-zero on purpose (see the completion telemetry in main).
+let exitReason;
 async function runMain(input) {
     const { appRoot, feynmanVersion } = input;
     const bundledSettingsPath = resolve(appRoot, ".feynman", "settings.json");
@@ -641,10 +645,14 @@ async function runMain(input) {
             throw new Error(`Pro-class model disabled: ${requestedExplicitModelSpec}. Choose an approved research model.`);
         }
         const modelRuntime = await createModelRuntime(feynmanAuthPath);
-        const canonicalModelSpec = canonicalizeModelSpec(requestedExplicitModelSpec, modelRuntime);
+        const canonicalModelSpec = resolveExplicitModelSpec(requestedExplicitModelSpec, modelRuntime);
         if (!canonicalModelSpec) {
             throw new Error(`Unknown model: ${requestedExplicitModelSpec}. Run \`feynman model list\` to see available models.`);
         }
+        // Check the resolved model too: a short name can resolve to a Pro-class one.
+        if (isProClassModelSpec(canonicalModelSpec.replace(/:(off|minimal|low|medium|high|xhigh|max)$/, ""))) {
+            throw new Error(`Pro-class model disabled: ${canonicalModelSpec}. Choose an approved research model.`);
+        }
         explicitModelSpec = canonicalModelSpec;
     }
     const workflowCommandNames = new Set(readPromptSpecs(appRoot).filter((s) => s.topLevelCli).map((s) => s.name));
@@ -666,6 +674,7 @@ async function runMain(input) {
         if (!getCurrentModelSpec(feynmanSettingsPath)) {
             console.error(noModelMessage(promptGiven));
             process.exitCode = 1;
+            exitReason = "no_model";
             return;
         }
         await ensureFeynmanSettings(feynmanSettingsPath, bundledSettingsPath, appRoot, defaultThinkingLevel, feynmanAuthPath);
@@ -674,6 +683,7 @@ async function runMain(input) {
         && (await getAuthenticatedModelRecords(feynmanAuthPath)).length === 0) {
         console.error(noModelMessage(promptGiven));
         process.exitCode = 1;
+        exitReason = "no_model";
         return;
     }
     // Pi's own session flags pass through; Feynman continues the latest

package/dist/index.js

@@ -1,6 +1,8 @@
 import { ensureSupportedNodeVersion } from "./system/node-version.js";
 async function run() {
     ensureSupportedNodeVersion();
+    // alphaXiv login hints from the bundled alpha-hub then name `feynman alpha login`.
+    process.env.ALPHA_HUB_CLI ??= "feynman alpha";
     const { main } = await import("./cli.js");
     await main();
 }

package/dist/model/catalog.js

@@ -1,5 +1,3 @@
-import { getEnvApiKey } from "@earendil-works/pi-ai/compat";
-import { readJsonFile } from "../config/json-file.js";
 import { createModelRuntime } from "./registry.js";
 const PRO_CLASS_MODEL_PATTERN = /(?:^|[-_.:/])pro(?:$|[-_.:/])/i;
 // Pi catalogs these exact DeepSeek V4 Pro model IDs as ordinary open-weight
@@ -329,10 +327,8 @@ function sortProviders(left, right) {
     return left.label.localeCompare(right.label);
 }
 export async function getAuthenticatedModelRecords(authPath) {
-    const expiredOAuthProviders = readExpiredOAuthProviders(authPath);
     const modelRuntime = await createModelRuntime(authPath);
     return (await modelRuntime.getAvailable())
-        .filter((model) => !expiredOAuthProviders.has(model.provider))
         .map((model) => ({ provider: model.provider, id: model.id, name: model.name }));
 }
 export async function getAvailableModelRecords(authPath) {
@@ -344,26 +340,6 @@ export async function getSupportedModelRecords(authPath) {
         .getModels()
         .map((model) => ({ provider: model.provider, id: model.id, name: model.name }));
 }
-function readExpiredOAuthProviders(authPath) {
-    const expired = new Set();
-    try {
-        const parsed = readJsonFile(authPath);
-        for (const [provider, credential] of Object.entries(parsed)) {
-            if (!credential || typeof credential !== "object")
-                continue;
-            const typedCredential = credential;
-            if (typedCredential.type !== "oauth" || typeof typedCredential.expires !== "number")
-                continue;
-            if (typedCredential.expires > Date.now())
-                continue;
-            if (getEnvApiKey(provider))
-                continue;
-            expired.add(provider);
-        }
-    }
-    catch { }
-    return expired;
-}
 export async function chooseRecommendedModel(authPath) {
     const preferred = choosePreferredModelRecord(await getAvailableModelRecords(authPath));
     if (!preferred) {

package/dist/model/commands.js

@@ -1,7 +1,7 @@
+import { SettingsManager } from "@earendil-works/pi-coding-agent";
 import { readFileSync, writeFileSync } from "node:fs";
 import { exec as execCallback } from "node:child_process";
-import { randomUUID } from "node:crypto";
-import { dirname, resolve } from "node:path";
+import { dirname } from "node:path";
 import { promisify } from "node:util";
 import { readJson } from "../pi/settings.js";
 import { promptChoice, promptSecret, promptSelect, promptText, SetupCancelledError, validateApiKeyInput } from "../setup/prompts.js";
@@ -125,7 +125,8 @@ function normalizeCustomProviderBaseUrl(api, baseUrl) {
 function isLocalBaseUrl(baseUrl) {
     return /^(https?:\/\/)?(localhost|127\.0\.0\.1|0\.0\.0\.0)(:|\/|$)/i.test(baseUrl);
 }
-const LOCAL_PROVIDER_IDS = new Set(["ollama", "lm-studio", "vllm", "llama-cpp", "llamacpp"]);
+// "llama.cpp" is the id of Pi's bundled llama.cpp provider.
+const LOCAL_PROVIDER_IDS = new Set(["ollama", "lm-studio", "vllm", "llama.cpp", "llama-cpp", "llamacpp"]);
 export function isLocalModelProvider(authPath, providerId) {
     if (!providerId) {
         return false;
@@ -653,6 +654,7 @@ async function configureApiKeyProvider(authPath, providerId) {
             printWarning(result.error);
         }
     }
+    await refreshProviderModels(modelRuntime, provider.id);
     return true;
 }
 async function resolveAvailableModelSpec(authPath, input) {
@@ -672,8 +674,8 @@ async function resolveAvailableModelSpec(authPath, input) {
     // When multiple providers expose the same bare model ID, prefer providers the
     // user explicitly configured in auth storage.
     if (exactIdMatches.length > 1) {
-        const authData = readJson(authPath);
-        const configuredProviders = new Set(Object.keys(authData));
+        const credentials = await (await createModelRuntime(authPath)).listCredentials();
+        const configuredProviders = new Set(credentials.map((credential) => credential.providerId));
         const configuredMatches = exactIdMatches.filter((model) => configuredProviders.has(model.provider));
         if (configuredMatches.length === 1) {
             return `${configuredMatches[0].provider}/${configuredMatches[0].id}`;
@@ -733,13 +735,11 @@ export async function authenticateModelProvider(authPath, settingsPath) {
 }
 // Sign in with ChatGPT sends a stable installation ID. Pi's own /login keeps it
 // as `deviceId` in the agent settings.json; share that one.
-export function getOrCreateDeviceId(authPath) {
-    const settingsPath = resolve(dirname(authPath), "settings.json");
-    const settings = readJson(settingsPath);
-    if (typeof settings.deviceId === "string" && settings.deviceId)
-        return settings.deviceId;
-    const deviceId = randomUUID();
-    writeFileSync(settingsPath, `${JSON.stringify({ ...settings, deviceId }, null, 2)}\n`, "utf8");
+// Pi's own device ID, the one its /login sends, kept in the agent settings.
+export async function getOrCreateDeviceId(authPath) {
+    const settings = SettingsManager.create(process.cwd(), dirname(authPath));
+    const deviceId = settings.getOrCreateDeviceId();
+    await settings.flush();
     return deviceId;
 }
 // A provider answers invalid_grant when it rejects the authorization code, and
@@ -752,6 +752,12 @@ export function describeOAuthLoginFailure(providerId, error) {
     const alternative = providerId === "openai" ? " Or sign in with `feynman model login openai-codex` instead." : "";
     return new Error(`${error.message}\nThe sign-in was rejected, usually because of a stale browser session. Sign out of the provider's site in your browser, or use a private window, then run \`feynman model login ${providerId}\` again.${alternative}`);
 }
+// Pi's /login refreshes the provider's model list from the network after
+// signing in (OpenRouter keys get the models that key may use); do the same,
+// so the recommended default comes from that list. A failure keeps the saved list.
+async function refreshProviderModels(modelRuntime, providerId) {
+    await modelRuntime.refresh({ providers: [providerId], allowNetwork: true, signal: AbortSignal.timeout(15_000) }).catch(() => undefined);
+}
 export async function loginModelProvider(authPath, providerId, settingsPath) {
     if (providerId) {
         const resolvedProvider = await resolveModelProviderForCommand(authPath, providerId);
@@ -776,6 +782,7 @@ export async function loginModelProvider(authPath, providerId, settingsPath) {
     }
     const modelRuntime = await createModelRuntime(authPath);
     const abortController = new AbortController();
+    const deviceId = await getOrCreateDeviceId(authPath);
     await modelRuntime.login(provider.id, "oauth", {
         prompt: async (prompt) => {
             if (prompt.type === "select") {
@@ -819,10 +826,11 @@ export async function loginModelProvider(authPath, providerId, settingsPath) {
             }
         },
         signal: abortController.signal,
-    }, { getDeviceId: () => getOrCreateDeviceId(authPath) }).catch((error) => {
+    }, { getDeviceId: () => deviceId }).catch((error) => {
         throw describeOAuthLoginFailure(provider.id, error);
     });
     printSuccess(`Model provider login complete: ${provider.id}`);
+    await refreshProviderModels(modelRuntime, provider.id);
     await maybeSetRecommendedDefaultModel(settingsPath, authPath);
     return true;
 }

package/dist/pi/launch.js

@@ -42,8 +42,9 @@ export async function runPi(options, args, env, stdin = "inherit") {
 }
 export async function launchPiChat(options) {
     let telemetryNotice;
+    // No screen clear: Pi's fullscreen mode uses the alternate screen, and
+    // `--tui-mode regular` keeps the terminal's scrollback.
     if (process.stdout.isTTY && options.mode !== "rpc") {
-        process.stdout.write("\x1b[2J\x1b[3J\x1b[H");
         telemetryNotice = telemetryFirstRunNotice();
     }
     const executables = await resolveAllExecutables();

package/dist/pi/runtime.js

@@ -1,7 +1,7 @@
 import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { createRequire } from "node:module";
 import { delimiter, dirname, resolve, win32 } from "node:path";
-import { BROWSER_FALLBACK_PATHS, MERMAID_FALLBACK_PATHS, PANDOC_FALLBACK_PATHS, resolveExecutable, } from "../system/executables.js";
+import { MERMAID_FALLBACK_PATHS, PANDOC_FALLBACK_PATHS, resolveBrowser, resolveExecutable, } from "../system/executables.js";
 import { getPostHogChildEnv } from "../telemetry/posthog.js";
 // Pi packages shipped as Feynman dependencies and loaded from their install
 // paths through settings.json `packages` (Pi's documented local-path source).
@@ -145,7 +145,7 @@ export function buildPiEnv(options, executables) {
     const binPath = [getFeynmanCommandShimDir(options.feynmanAgentDir), resolve(options.appRoot, "node_modules", ".bin")].join(delimiter);
     const pandocPath = process.env.PANDOC_PATH ?? executables?.pandoc ?? resolveExecutable("pandoc", PANDOC_FALLBACK_PATHS);
     const mermaidPath = process.env.MERMAID_CLI_PATH ?? executables?.mermaid ?? resolveExecutable("mmdc", MERMAID_FALLBACK_PATHS);
-    const browserPath = process.env.PUPPETEER_EXECUTABLE_PATH ?? executables?.browser ?? resolveExecutable("google-chrome", BROWSER_FALLBACK_PATHS);
+    const browserPath = process.env.PUPPETEER_EXECUTABLE_PATH ?? executables?.browser ?? resolveBrowser();
     return {
         ...process.env,
         PATH: [binPath, process.env.PATH ?? "", process.platform === "win32" ? findWindowsBash()?.addDir : undefined]

package/dist/pi/settings.js

@@ -1,5 +1,6 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
+import { resolveCliModel } from "@earendil-works/pi-coding-agent";
 import { parseJsonText, readJsonFile } from "../config/json-file.js";
 import { BUNDLED_PI_PACKAGES, getFeynmanPackageSources, resolvePackageRoot } from "./runtime.js";
 import { choosePreferredModelRecord, getAvailableModelRecords } from "../model/catalog.js";
@@ -32,6 +33,29 @@ export function canonicalizeModelSpec(spec, modelLookup) {
     const model = parseModelSpec(spec, modelLookup);
     return model ? `${model.provider}/${model.id}` : undefined;
 }
+// `--model` input, resolved the way Pi resolves it (bare ids, fuzzy names, a
+// `:<thinking>` suffix) after Feynman's exact provider/id and provider:id
+// forms. Pi's fuzzy match ignores sign-ins, so the same model id on a provider
+// you are signed in to wins.
+export function resolveExplicitModelSpec(spec, modelRuntime) {
+    const exact = canonicalizeModelSpec(spec, modelRuntime);
+    if (exact)
+        return exact;
+    let result = resolveCliModel({ cliModel: spec.trim(), modelRuntime });
+    if (!result.model)
+        return undefined;
+    if (!modelRuntime.hasConfiguredAuth(result.model.provider)) {
+        for (const provider of new Set(modelRuntime.getAvailableSnapshot().map((model) => model.provider))) {
+            const signedIn = resolveCliModel({ cliProvider: provider, cliModel: spec.trim(), modelRuntime });
+            if (signedIn.model && !signedIn.warning) {
+                result = signedIn;
+                break;
+            }
+        }
+    }
+    const model = result.model;
+    return `${model.provider}/${model.id}${result.thinkingLevel ? `:${result.thinkingLevel}` : ""}`;
+}
 export function normalizeThinkingLevel(value) {
     if (!value) {
         return undefined;

package/dist/setup/doctor.js

@@ -3,7 +3,7 @@ import { getValidToken as getValidAlphaToken } from "@companion-ai/alpha-hub/lib
 import { readFileSync } from "node:fs";
 import { verifyAlphaAuthStatus } from "../alpha-auth-status.js";
 import { formatPiWebAccessDoctorLines, getPiWebAccessStatus } from "../pi/web-access.js";
-import { BROWSER_FALLBACK_PATHS, PANDOC_FALLBACK_PATHS, resolveExecutable } from "../system/executables.js";
+import { PANDOC_FALLBACK_PATHS, resolveBrowser, resolveExecutable } from "../system/executables.js";
 import { readJson } from "../pi/settings.js";
 import { findWindowsBash, validatePiInstallation, WINDOWS_BASH_MISSING_NOTICE } from "../pi/runtime.js";
 import { isTelemetryDisabled } from "../telemetry/posthog.js";
@@ -41,7 +41,7 @@ function findProvidersMissingApiKey(modelsJsonPath) {
 }
 export async function collectStatusSnapshot(options) {
     const pandocPath = resolveExecutable("pandoc", PANDOC_FALLBACK_PATHS);
-    const browserPath = process.env.PUPPETEER_EXECUTABLE_PATH ?? resolveExecutable("google-chrome", BROWSER_FALLBACK_PATHS);
+    const browserPath = process.env.PUPPETEER_EXECUTABLE_PATH ?? resolveBrowser();
     const missingPiBits = validatePiInstallation(options.appRoot);
     const webStatus = getPiWebAccessStatus();
     const modelStatus = buildModelStatusSnapshotFromRecords(await getSupportedModelRecords(options.authPath), await getAvailableModelRecords(options.authPath), getCurrentModelSpec(options.settingsPath));
@@ -105,7 +105,7 @@ export async function runDoctor(options) {
     const supportedModels = await getSupportedModelRecords(options.authPath);
     const modelStatus = await collectStatusSnapshot(options);
     const pandocPath = resolveExecutable("pandoc", PANDOC_FALLBACK_PATHS);
-    const browserPath = process.env.PUPPETEER_EXECUTABLE_PATH ?? resolveExecutable("google-chrome", BROWSER_FALLBACK_PATHS);
+    const browserPath = process.env.PUPPETEER_EXECUTABLE_PATH ?? resolveBrowser();
     const missingPiBits = validatePiInstallation(options.appRoot);
     printPanel("Feynman Doctor", [
         "Checks config, auth, runtime wiring, and preview dependencies.",

package/dist/system/executables.js

@@ -1,7 +1,9 @@
 import { execFile, spawnSync } from "node:child_process";
 import { existsSync } from "node:fs";
+import { homedir } from "node:os";
 import { dirname, delimiter } from "node:path";
 const isWindows = process.platform === "win32";
+const isLinux = process.platform === "linux";
 const programFiles = process.env.PROGRAMFILES ?? "C:\\Program Files";
 const localAppData = process.env.LOCALAPPDATA ?? "";
 export const PANDOC_FALLBACK_PATHS = isWindows
@@ -16,14 +18,35 @@ export const BROWSER_FALLBACK_PATHS = isWindows
         `${programFiles} (x86)\\Google\\Chrome\\Application\\chrome.exe`,
         `${localAppData}\\Google\\Chrome\\Application\\chrome.exe`,
         `${programFiles}\\Microsoft\\Edge\\Application\\msedge.exe`,
+        `${programFiles} (x86)\\Microsoft\\Edge\\Application\\msedge.exe`,
         `${programFiles}\\BraveSoftware\\Brave-Browser\\Application\\brave.exe`,
+        `${localAppData}\\BraveSoftware\\Brave-Browser\\Application\\brave.exe`,
     ]
-    : [
-        "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
-        "/Applications/Chromium.app/Contents/MacOS/Chromium",
-        "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser",
-        "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge",
-    ];
+    : isLinux
+        ? [
+            "/usr/bin/google-chrome",
+            "/usr/bin/google-chrome-stable",
+            "/usr/bin/chromium",
+            "/usr/bin/chromium-browser",
+            "/snap/bin/chromium",
+            "/usr/bin/microsoft-edge",
+            "/usr/bin/brave-browser",
+            "/opt/google/chrome/chrome",
+        ]
+        : ["/Applications", `${homedir()}/Applications`].flatMap((dir) => [
+            `${dir}/Google Chrome.app/Contents/MacOS/Google Chrome`,
+            `${dir}/Chromium.app/Contents/MacOS/Chromium`,
+            `${dir}/Brave Browser.app/Contents/MacOS/Brave Browser`,
+            `${dir}/Microsoft Edge.app/Contents/MacOS/Microsoft Edge`,
+        ]);
+export const BROWSER_COMMANDS = [
+    "google-chrome",
+    "google-chrome-stable",
+    "chromium",
+    "chromium-browser",
+    "microsoft-edge",
+    "brave-browser",
+];
 export const MERMAID_FALLBACK_PATHS = isWindows
     ? []
     : ["/opt/homebrew/bin/mmdc", "/usr/local/bin/mmdc"];
@@ -81,11 +104,32 @@ export async function resolveExecutableAsync(name, fallbackPaths = []) {
         });
     });
 }
+export function resolveBrowser({ fallbackPaths = BROWSER_FALLBACK_PATHS, fileExists = existsSync, resolveCommand = (name) => resolveExecutable(name), } = {}) {
+    const fallback = fallbackPaths.find((candidate) => fileExists(candidate));
+    if (fallback) {
+        return fallback;
+    }
+    for (const name of BROWSER_COMMANDS) {
+        const resolved = resolveCommand(name);
+        if (resolved) {
+            return resolved;
+        }
+    }
+    return undefined;
+}
+export async function resolveBrowserAsync() {
+    const fallback = findInFallbackPaths(BROWSER_FALLBACK_PATHS);
+    if (fallback) {
+        return fallback;
+    }
+    const resolved = await Promise.all(BROWSER_COMMANDS.map((name) => resolveExecutableAsync(name)));
+    return resolved.find(Boolean);
+}
 export async function resolveAllExecutables() {
     const [pandoc, mermaid, browser] = await Promise.all([
         resolveExecutableAsync("pandoc", PANDOC_FALLBACK_PATHS),
         resolveExecutableAsync("mmdc", MERMAID_FALLBACK_PATHS),
-        resolveExecutableAsync("google-chrome", BROWSER_FALLBACK_PATHS),
+        resolveBrowserAsync(),
     ]);
     return { pandoc, mermaid, browser };
 }

package/extensions/research-tools/alpha.ts

@@ -34,7 +34,7 @@ async function withPaperFallback<T>(
 	try {
 		return await run();
 	} catch (error) {
-		const message = (error instanceof Error ? error.message : String(error)).replace("`alpha login`", "`feynman alpha login`");
+		const message = error instanceof Error ? error.message : String(error);
 		if (fallback) {
 			try {
 				return { fallbackNote: `alphaXiv did not answer (${message}); these results are from ${fallback.source}.`, ...(await fallback.run()) };

package/extensions/research-tools/model-error-hint.ts

@@ -1,3 +1,4 @@
+import type { AssistantMessage } from "@earendil-works/pi-ai";
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 
 // Most failed research runs end on a provider error (quota, a key, a model the
@@ -24,9 +25,18 @@ export function modelErrorHint(provider: string, error: string): string | undefi
 }
 
 export function registerModelErrorHint(pi: ExtensionAPI): void {
-	pi.on("message_end", (event, ctx) => {
+	// Pi retries rate limits and outages itself; hint only about the error the
+	// run actually ended on, once it has settled.
+	let lastError: AssistantMessage | undefined;
+	pi.on("message_end", (event) => {
 		const message = event.message;
-		if (message.role !== "assistant" || message.stopReason !== "error" || !ctx.hasUI) return;
+		if (message.role !== "assistant") return;
+		lastError = message.stopReason === "error" ? message : undefined;
+	});
+	pi.on("agent_settled", (event, ctx) => {
+		const message = lastError;
+		lastError = undefined;
+		if (!message || event.aborted || !ctx.hasUI) return;
 		const hint = modelErrorHint(message.provider, message.errorMessage ?? "");
 		ctx.ui.notify(
 			`${hint ?? `${message.provider} returned an error.`} If this looks like a Feynman bug, report it at https://github.com/Companion-Inc/feynman/issues (Pi's /bug goes to Pi's developers).`,

package/extensions/research-tools/telemetry.ts

@@ -252,7 +252,8 @@ export function registerResearchTelemetry(
 			$ai_cache_creation_input_tokens: message.usage.cacheWrite,
 			// Pi reports input tokens with cache reads and writes already subtracted.
 			$ai_cache_reporting_exclusive: true,
-			$ai_latency: requestStartedAt === undefined ? undefined : (now() - requestStartedAt) / 1000,
+			// Pi times each response itself; older messages may lack it.
+			$ai_latency: message.durationMs !== undefined ? message.durationMs / 1000 : requestStartedAt === undefined ? undefined : (now() - requestStartedAt) / 1000,
 			$ai_http_status: httpStatus,
 			$ai_is_error: message.stopReason === "error",
 			$ai_error: message.stopReason === "error" ? errorText(message.errorMessage) : undefined,
@@ -264,8 +265,8 @@ export function registerResearchTelemetry(
 		if (run) run.stopReason = message.stopReason;
 	});
 
-	pi.on("agent_settled", (_event, ctx) => {
-		finishRun(ctx.cwd, stopStatus(run?.stopReason));
+	pi.on("agent_settled", (event, ctx) => {
+		finishRun(ctx.cwd, event.aborted ? "aborted" : stopStatus(run?.stopReason));
 	});
 
 	pi.on("session_shutdown", async (event, ctx) => {

package/metadata/commands.mjs

@@ -151,7 +151,7 @@ export const legacyFlags = [
 	{ usage: "--alpha-login", description: "Sign in to alphaXiv and exit." },
 	{ usage: "--alpha-logout", description: "Clear alphaXiv auth and exit." },
 	{ usage: "--alpha-status", description: "Show alphaXiv auth status and exit." },
-	{ usage: "--model <provider/model|provider:model>", description: "Force a specific approved research model." },
+	{ usage: "--model <model>", description: "Force an approved research model: provider/model, a bare ID, or a short name; add :high etc. for thinking." },
 	{ usage: "--service-tier <tier>", description: "Override request service tier for this run." },
 	{ usage: "--thinking <level>", description: "Set thinking level: off | minimal | low | medium | high | xhigh | max." },
 	{ usage: "--cwd <path>", description: "Set the working directory for tools." },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@companion-ai/feynman",
-  "version": "0.5.39",
+  "version": "0.5.41",
   "description": "The open source AI research agent.",
   "license": "MIT",
   "type": "module",
@@ -78,7 +78,11 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.8.1",
-    "@companion-ai/alpha-hub": "0.1.6",
+    "@companion-ai/alpha-hub": "0.1.7",
+    "@earendil-works/chord": "1.1.0",
+    "@earendil-works/pi-codemode": "1.1.0",
+    "@earendil-works/pi-mcp": "1.1.0",
+    "@earendil-works/pi-telemetry": "1.1.0",
     "fast-xml-parser": "5.11.1",
     "pi-btw": "0.8.0",
     "pi-docparser": "4.0.0",
@@ -87,6 +91,7 @@
     "posthog-node": "^5.53.0"
   },
   "peerDependencies": {
+    "@earendil-works/pi-agent-core": "1.1.0",
     "@earendil-works/pi-ai": "1.1.0",
     "@earendil-works/pi-coding-agent": "1.1.0",
     "@earendil-works/pi-tui": "*",