@companion-ai/feynman 0.5.25 → 0.5.26

package/RELEASES.md

@@ -6,6 +6,13 @@ 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.

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/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.25",
+  "version": "0.5.26",
   "description": "Research-first CLI agent built on Pi and alphaXiv",
   "license": "MIT",
   "type": "module",
@@ -83,7 +83,7 @@
     "pi-btw": "0.7.1",
     "pi-docparser": "4.0.0",
     "pi-subagents": "0.76.0",
-    "pi-web-access": "0.35.0",
+    "pi-web-access": "0.36.0",
     "posthog-node": "^5.53.0"
   },
   "peerDependencies": {