@companion-ai/feynman 0.5.24 → 0.5.26

package/RELEASES.md

@@ -6,6 +6,19 @@ GitHub release notes are generated from the matching `## vX.Y.Z` section in this
 
 ## Unreleased
 
+## v0.5.26 - 2026-10-05
+
+- **GitHub Copilot users get a research model by default.** Copilot names Claude models with dots (`claude-opus-5.5`), which Feynman did not recognize, so a new Copilot login fell back to alphabetical order and set `claude-haiku-4.5` as the default; Copilot then rejected it with "The requested model is not supported" for several users. Feynman now picks Copilot's newest Claude Opus, then Sonnet, then GPT. If `feynman status` shows `github-copilot/claude-haiku-4.5` and you did not choose it, run `feynman model set` to pick another.
+- `alpha_ask_paper` answers with the arXiv metadata and abstract, marked as a fallback, when alphaXiv does not answer (for example after the login expires), like `alpha_search` and `alpha_get_paper` already did.
+- `-p` is short for `--prompt`, as in Pi. `--setup`, `--list-models`, `--new`, `feynman setup model`, and `feynman model <provider/model>` now say which command was meant.
+- pi-web-access 0.36.0: `web_search` accepts lists that a model sent as a JSON string (nicobailon/pi-web-access#491), `fetch_content` asks docs sites for markdown first, Brave prepaid keys keep working, and a `fetch_content` call whose only URL failed is reported as an error.
+
+## v0.5.25 - 2026-10-05
+
+- **Pi 1.0.2 and pi-subagents 0.76.0.** Pi now uses the patched brace-expansion 5.0.12 (GHSA-q2hr-2g5m-vwhr, GHSA-qhr7-859c-m2p7, GHSA-6j4f-fj2g-mc7p), so Feynman's npm audit has no exceptions left, and an npm install pulls about 120 fewer packages. Pi also retries "model at capacity" errors instead of ending the turn, and Sign in with ChatGPT reports a busy callback port instead of "OAuth state mismatch". pi-subagents frees async slots held by abandoned workflows.
+- **A timed-out paper search no longer ends a research step.** A Semantic Scholar or OpenAlex topic search that hits the 25 s timeout is answered from the other index, and other sources say which one did not respond instead of "This operation was aborted".
+- **arXiv batch versions.** Looking up a bare arXiv ID alongside an older version now returns the latest version for the bare ID regardless of feed order. An unavailable explicit version is reported in `not_found` instead of resolving to a different version. Thanks to @Kunyanli230 (#322).
+
 ## v0.5.24 - 2026-10-03
 
 - **Pi 1.0.** Feynman now runs on Pi 1.0.0, with pi-subagents 0.75.0 (background subagents start on Pi 1.0) and pi-btw 0.7.1 (allows Pi 1.x). The terminal UI is fullscreen by default and keeps its own scrollback; run `feynman --tui-mode regular`, or set `"tuiMode": "regular"` in `~/.feynman/agent/settings.json`, to use the terminal's normal scrollback. Launch warnings show inside the fullscreen UI. Pi 1.0 also adds MCP OAuth hardening, a copy-code Anthropic login for headless machines, and lower codemode token use.

package/dist/cli.js

@@ -34,6 +34,12 @@ import { ASH, printAsciiHeader, printInfo, printPanel, printSection, RESET, SAGE
 import { createModelRuntime } from "./model/registry.js";
 import { cliCommandSections, formatCliWorkflowUsage, legacyFlags, readPromptSpecs, topLevelCommandNames, } from "../metadata/commands.mjs";
 const TOP_LEVEL_COMMANDS = new Set(topLevelCommandNames);
+// Flags users reach for that Feynman spells differently.
+const UNKNOWN_OPTION_HINTS = {
+    "--setup": "feynman setup",
+    "--list-models": "feynman model list",
+    "--new": "feynman --new-session",
+};
 // Removed commands fail instead of falling through to a chat prompt.
 const REMOVED_COMMANDS = new Set(["jobs", "paper", "rank", "serve", "watch"]);
 const ALPHA_HUB_PACKAGE_PATH = ["@companion-ai", "alpha-hub"];
@@ -226,7 +232,8 @@ async function handleModelCommand(subcommand, args, feynmanSettingsPath, feynman
         }
         return;
     }
-    throw new Error(`Unknown model command: ${subcommand}\nRun \`feynman model help\` to see model commands.`);
+    const setHint = /[/:]/.test(subcommand) ? `Did you mean \`feynman model set ${subcommand}\`? ` : "";
+    throw new Error(`Unknown model command: ${subcommand}\n${setHint}Run \`feynman model help\` to see model commands.`);
 }
 async function handleUpdateCommand(piOptions, feynmanVersion, source) {
     const latestFeynmanVersionPromise = fetchLatestFeynmanVersion();
@@ -468,7 +475,7 @@ async function runMain(input) {
             "no-session": { type: "boolean" },
             "no-themes": { type: "boolean" },
             "tui-mode": { type: "string" },
-            prompt: { type: "string" },
+            prompt: { type: "string", short: "p" },
             resume: { type: "boolean", short: "r" },
             "service-tier": { type: "string" },
             session: { type: "string" },
@@ -488,7 +495,9 @@ async function runMain(input) {
     catch (error) {
         if (error && typeof error === "object" && "code" in error && error.code === "ERR_PARSE_ARGS_UNKNOWN_OPTION") {
             const message = error instanceof Error ? error.message : String(error);
-            throw new Error(`${message}\nRun \`feynman help\` to see available commands and flags.`);
+            const option = /Unknown option '([^']+)'/.exec(message)?.[1];
+            const hint = option ? UNKNOWN_OPTION_HINTS[option] : undefined;
+            throw new Error(`${message}\n${hint ? `Did you mean \`${hint}\`? ` : ""}Run \`feynman help\` to see available commands and flags.`);
         }
         throw error;
     }
@@ -559,7 +568,7 @@ async function runMain(input) {
             return;
         }
         if (rest[0]) {
-            throw new Error(`Unknown setup command: ${rest[0]}`);
+            throw new Error(`Unknown setup command: ${rest[0]}${rest[0] === "model" ? "\nTo choose a model, run `feynman model login` or `feynman model set`." : ""}`);
         }
         await runSetup({
             settingsPath: feynmanSettingsPath,

package/dist/model/catalog.js

@@ -70,6 +70,19 @@ const RESEARCH_MODEL_FAMILY_PREFERENCES = [
         matches: (model) => model.provider === "opencode" && /^gpt-\d+(?:\.\d+)*(?:-.+)?$/i.test(model.id),
         reason: "newest OpenCode Zen GPT fallback when direct OpenAI access is unavailable",
     },
+    // GitHub Copilot writes Claude versions with dots (claude-opus-5.5).
+    {
+        matches: (model) => model.provider === "github-copilot" && /^claude-opus-\d+(?:[.-]\d+)*$/i.test(model.id),
+        reason: "newest Claude Opus model available through GitHub Copilot",
+    },
+    {
+        matches: (model) => model.provider === "github-copilot" && /^claude-sonnet-\d+(?:[.-]\d+)*$/i.test(model.id),
+        reason: "newest Claude Sonnet model available through GitHub Copilot",
+    },
+    {
+        matches: (model) => model.provider === "github-copilot" && /^gpt-\d+(?:\.\d+)*(?:-.+)?$/i.test(model.id),
+        reason: "newest GPT model available through GitHub Copilot",
+    },
 ];
 const RESEARCH_MODEL_FALLBACK_PREFERENCES = [
     exactResearchModel("opencode/kimi-k2.7-code", "good OpenCode Zen fallback for coding and research work"),
@@ -188,7 +201,7 @@ function compareCurrentModelFamily(left, right) {
     return modelSpec(left).localeCompare(modelSpec(right));
 }
 function currentFamilyPreference(model) {
-    const anthropic = /^claude-(opus|sonnet)-(\d+(?:-\d+)*)$/i.exec(model.id);
+    const anthropic = /^claude-(opus|sonnet)-(\d+(?:[.-]\d+)*)$/i.exec(model.id);
     if (anthropic) {
         const family = anthropic[1].toLowerCase();
         const parsedVersion = parseClaudeVersion(anthropic[2]);
@@ -202,7 +215,7 @@ function currentFamilyPreference(model) {
         };
     }
     const openAi = /^gpt-(\d+(?:\.\d+)*)(?:-(.+))?$/i.exec(model.id);
-    if (openAi && (model.provider === "openai" || model.provider === "openai-codex" || model.provider === "opencode")) {
+    if (openAi && ["openai", "openai-codex", "opencode", "github-copilot"].includes(model.provider)) {
         const suffix = openAi[2]?.toLowerCase();
         return {
             family: `${model.provider}/gpt`,
@@ -236,7 +249,7 @@ function currentFamilyPreference(model) {
     return undefined;
 }
 function parseClaudeVersion(rawVersion) {
-    const rawParts = rawVersion.split("-");
+    const rawParts = rawVersion.split(/[.-]/);
     if (rawParts.length >= 2 && /^\d{8}$/.test(rawParts[rawParts.length - 1])) {
         const baseParts = rawParts.slice(0, -1).map(Number);
         return {

package/extensions/research-tools/alpha.ts

@@ -134,7 +134,11 @@ export function registerAlphaTools(pi: ExtensionAPI, signedIn = isLoggedIn()): v
 			question: Type.String({ description: "Question about the paper." }),
 		}),
 		async execute(_toolCallId, params) {
-			const result = await withPaperFallback(() => askPaper(params.paper, params.question));
+			const arxivId = ARXIV_ID.exec(params.paper.trim())?.[1];
+			const result = await withPaperFallback(() => askPaper(params.paper, params.question), arxivId ? {
+				source: "arXiv metadata and abstract; the question was not answered, so answer it from the abstract or read the full text with fetch_content on the arXiv PDF",
+				run: () => searchArxiv({ query: arxivId }),
+			} : undefined);
 			return { content: [{ type: "text", text: formatText(result) }], details: result };
 		},
 	});

package/extensions/research-tools/science-database-arxiv.ts

@@ -167,13 +167,16 @@ async function getArxivPapers(query: string): Promise<Record<string, unknown>> {
 	const feed = recordValue(xmlParser.parse(xml).feed);
 	const byId = new Map<string, Record<string, unknown>>();
 	for (const row of arxivFeedEntries(feed).map(parseArxivEntry).filter((item): item is Record<string, unknown> => Boolean(item))) {
-		if (row.arxiv_id) byId.set(String(row.arxiv_id), row);
+		if (row.arxiv_id) {
+			const bare = String(row.arxiv_id);
+			const latest = byId.get(bare);
+			if (!latest || Number(row.version) >= Number(latest.version)) byId.set(bare, row);
+		}
 		if (row.id_versioned) byId.set(String(row.id_versioned), row);
 	}
 	const seen = new Map<Record<string, unknown>, string>();
 	for (const id of ids) {
-		const bare = id.replace(/v\d+$/i, "");
-		const row = byId.get(id) ?? byId.get(bare);
+		const row = byId.get(id);
 		if (!row) notFound.push(id);
 		else if (seen.has(row)) duplicates.push({ requested: id, resolved_as: seen.get(row) });
 		else {

package/extensions/research-tools/science-databases.ts

@@ -385,7 +385,14 @@ async function searchSemanticScholar(params: ScienceDatabaseSearchParams): Promi
 const OPENALEX_LOOKUP_QUERY =
 	/^(?:openalex_\w+|rate-limit|authors?|author-search|sources?|venues?|citations?|references?|work|detail)(?::|\s|$)|^(?:W\d+|doi:\s*10\.|10\.\S+\/)/i;
 
+// Each request aborts after REQUEST_TIMEOUT_MS, which fetch reports as a bare
+// "This operation was aborted".
+function isTimeout(error: unknown): boolean {
+	return error instanceof Error && error.name === "AbortError";
+}
+
 function isIndexUnavailable(error: unknown): boolean {
+	if (isTimeout(error)) return true;
 	if (error instanceof ScienceDatabaseRequestError) return error.status === 429 || error.status >= 500;
 	return error instanceof Error && /^OpenAlex request failed: (?:429|5\d\d)\b/.test(error.message);
 }
@@ -469,7 +476,13 @@ export function registerScienceDatabaseTools(pi: ExtensionAPI): void {
 			], { description: "PubMed sort order. For semanticscholar, prefer the default citation-count sort; use pub_date (newest first) only when recency matters. relevance falls back to the default when the anonymous pool is rate-limited. Ignored for other sources." })),
 		}),
 		async execute(_toolCallId, params) {
-			const result = await scienceDatabaseSearch(params as ScienceDatabaseSearchParams);
+			let result: Record<string, unknown>;
+			try {
+				result = await scienceDatabaseSearch(params as ScienceDatabaseSearchParams);
+			} catch (error) {
+				if (!isTimeout(error)) throw error;
+				throw new Error(`${params.source} did not respond within ${REQUEST_TIMEOUT_MS / 1000} s. Retry, or search another source.`);
+			}
 			return {
 				content: [{ type: "text", text: formatText(result) }],
 				details: result,

package/metadata/commands.mjs

@@ -147,7 +147,7 @@ export const cliCommandSections = [
 ];
 
 export const legacyFlags = [
-	{ usage: '--prompt "<text>"', description: "Run one prompt and exit." },
+	{ usage: '--prompt, -p "<text>"', description: "Run one prompt and exit." },
 	{ 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." },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@companion-ai/feynman",
-  "version": "0.5.24",
+  "version": "0.5.26",
   "description": "Research-first CLI agent built on Pi and alphaXiv",
   "license": "MIT",
   "type": "module",
@@ -82,13 +82,13 @@
     "fast-xml-parser": "5.11.1",
     "pi-btw": "0.7.1",
     "pi-docparser": "4.0.0",
-    "pi-subagents": "0.75.0",
-    "pi-web-access": "0.35.0",
+    "pi-subagents": "0.76.0",
+    "pi-web-access": "0.36.0",
     "posthog-node": "^5.53.0"
   },
   "peerDependencies": {
-    "@earendil-works/pi-ai": "1.0.0",
-    "@earendil-works/pi-coding-agent": "1.0.0",
+    "@earendil-works/pi-ai": "1.0.2",
+    "@earendil-works/pi-coding-agent": "1.0.2",
     "@earendil-works/pi-tui": "*",
     "typebox": "*"
   },