@companion-ai/feynman 0.5.4 → 0.5.5

package/.nvmrc

@@ -1 +1 @@
-24.20.0
+24.21.0

package/README.md

@@ -27,7 +27,7 @@ irm https://feynman.is/install.ps1 | iex
 
 The one-line installer fetches the latest tagged release as a standalone bundle with its own Node.js runtime and verifies its SHA-256 before installing. To pin a version, pass it explicitly, for example `curl -fsSL https://feynman.is/install | bash -s -- 0.5.3`. Rerun the installer to upgrade; `feynman update` only updates optional Pi packages you installed.
 
-**npm alternative** (uses your local Node.js `>=22.22.0 <26`):
+**npm alternative** (uses your local Node.js `>=22.22.0`):
 
 ```bash
 npm install -g @companion-ai/feynman

package/RELEASES.md

@@ -6,6 +6,24 @@ GitHub release notes are generated from the matching `## vX.Y.Z` section in this
 
 ## Unreleased
 
+## v0.5.5 - 2026-09-24
+
+### Node.js 26
+
+- Feynman now runs on Node.js 26, the current release. The upper version limit is gone: Feynman needs Node.js 22.22.0 or newer, like Pi itself. Tests run on Node 22, 24, and 26.
+- The standalone installers bundle Node.js 24.21.0, the latest LTS release.
+
+### alphaXiv
+
+- When an alphaXiv call fails, the tool error now points the agent to `feynman_science_database_search` (arXiv or Semantic Scholar) or `fetch_content`, so a research run continues on another source instead of retrying a broken tool. A "not logged in" error names `feynman alpha login`.
+- The alphaXiv docs explain signing in from a machine without a browser (SSH, Docker, WSL): open the printed URL anywhere and paste the final `127.0.0.1:9876/callback` URL back into the terminal.
+
+### Other
+
+- The setup docs explain the most common reason local models write no files: a small context window. They show how to raise Ollama's context and set `contextWindow` and `maxTokens` in `models.json`.
+- feynman.is/privacy and feynman.is/telemetry go to the telemetry section, which lists what is collected and how to opt out.
+- Updated dependencies: pi-btw 0.6.1, posthog-node 5.53, @clack/prompts 1.8.1, and the website toolchain (Astro 7.3, @astrojs/react 7). CI uses actions/checkout and actions/setup-node v7 and wrangler 4.139.
+
 ## v0.5.4 - 2026-09-24
 
 ### Use Feynman from ACP editors

package/bin/feynman.js

@@ -3,7 +3,6 @@ import { resolve } from "node:path";
 import { pathToFileURL } from "node:url";
 
 const MIN_NODE_VERSION = "22.22.0";
-const MAX_NODE_MAJOR = 25;
 const PREFERRED_NODE_MAJOR = 24;
 
 function parseNodeVersion(version) {
@@ -21,15 +20,12 @@ function compareNodeVersions(left, right) {
   return left.patch - right.patch;
 }
 
-const parsedNodeVersion = parseNodeVersion(process.versions.node);
-if (compareNodeVersions(parsedNodeVersion, parseNodeVersion(MIN_NODE_VERSION)) < 0 || parsedNodeVersion.major > MAX_NODE_MAJOR) {
+if (compareNodeVersions(parseNodeVersion(process.versions.node), parseNodeVersion(MIN_NODE_VERSION)) < 0) {
   const isWindows = process.platform === "win32";
-  console.error(`feynman supports Node.js ${MIN_NODE_VERSION} through ${MAX_NODE_MAJOR}.x (detected ${process.versions.node}).`);
-  console.error(parsedNodeVersion.major > MAX_NODE_MAJOR
-    ? "This newer Node release is not supported yet."
-    : isWindows
-      ? "Install a supported Node.js release from https://nodejs.org, or use the standalone installer:"
-      : `Switch to a supported Node release with \`nvm install ${PREFERRED_NODE_MAJOR} && nvm use ${PREFERRED_NODE_MAJOR}\`, or use the standalone installer:`);
+  console.error(`feynman requires Node.js ${MIN_NODE_VERSION} or newer (detected ${process.versions.node}).`);
+  console.error(isWindows
+    ? "Install a supported Node.js release from https://nodejs.org, or use the standalone installer:"
+    : `Switch to a supported Node release with \`nvm install ${PREFERRED_NODE_MAJOR} && nvm use ${PREFERRED_NODE_MAJOR}\`, or use the standalone installer:`);
   console.error(isWindows
     ? "irm https://feynman.is/install.ps1 | iex"
     : "curl -fsSL https://feynman.is/install | bash");

package/dist/system/node-version.js

@@ -1,5 +1,4 @@
 export const MIN_NODE_VERSION = "22.22.0";
-export const MAX_NODE_MAJOR = 25;
 export const PREFERRED_NODE_MAJOR = 24;
 function parseNodeVersion(version) {
     const [major = "0", minor = "0", patch = "0"] = version.replace(/^v/, "").split(".");
@@ -17,20 +16,15 @@ function compareNodeVersions(left, right) {
     return left.patch - right.patch;
 }
 export function isSupportedNodeVersion(version = process.versions.node) {
-    const parsed = parseNodeVersion(version);
-    return compareNodeVersions(parsed, parseNodeVersion(MIN_NODE_VERSION)) >= 0 && parsed.major <= MAX_NODE_MAJOR;
+    return compareNodeVersions(parseNodeVersion(version), parseNodeVersion(MIN_NODE_VERSION)) >= 0;
 }
 export function getUnsupportedNodeVersionLines(version = process.versions.node) {
     const isWindows = process.platform === "win32";
-    const parsed = parseNodeVersion(version);
-    const rangeText = `Node.js ${MIN_NODE_VERSION} through ${MAX_NODE_MAJOR}.x`;
     return [
-        `feynman supports ${rangeText} (detected ${version}).`,
-        parsed.major > MAX_NODE_MAJOR
-            ? "This newer Node release is not supported yet."
-            : isWindows
-                ? "Install a supported Node.js release from https://nodejs.org, or use the standalone installer:"
-                : `Switch to a supported Node release with \`nvm install ${PREFERRED_NODE_MAJOR} && nvm use ${PREFERRED_NODE_MAJOR}\`, or use the standalone installer:`,
+        `feynman requires Node.js ${MIN_NODE_VERSION} or newer (detected ${version}).`,
+        isWindows
+            ? "Install a supported Node.js release from https://nodejs.org, or use the standalone installer:"
+            : `Switch to a supported Node release with \`nvm install ${PREFERRED_NODE_MAJOR} && nvm use ${PREFERRED_NODE_MAJOR}\`, or use the standalone installer:`,
         isWindows
             ? "irm https://feynman.is/install.ps1 | iex"
             : "curl -fsSL https://feynman.is/install | bash",

package/extensions/research-tools/alpha.ts

@@ -18,6 +18,19 @@ function formatText(value: unknown): string {
 	return JSON.stringify(value, null, 2);
 }
 
+// alphaXiv's API has changed without notice before; when a call fails, point
+// the model at the other paper sources instead of leaving it on a broken tool.
+async function withPaperFallback<T>(run: () => Promise<T>): Promise<T> {
+	try {
+		return await run();
+	} catch (error) {
+		const message = (error instanceof Error ? error.message : String(error)).replace("`alpha login`", "`feynman alpha login`");
+		throw new Error(
+			`${message}\nalphaXiv did not answer this call. Use feynman_science_database_search (source "arxiv" or "semanticscholar") or fetch_content on https://arxiv.org/abs/<id> instead.`,
+		);
+	}
+}
+
 // Pi converts Type.Array inputs before validating them, which would turn null into ["null"].
 // Preserve the JSON Schema array contract without the Type.Array conversion marker.
 const paperSectionsSchema = Type.Unsafe<string[]>({
@@ -47,7 +60,7 @@ export function registerAlphaTools(pi: ExtensionAPI): void {
 			),
 		}),
 		async execute(_toolCallId, params) {
-			const result = await searchPapers(params.query, params.mode?.trim() || "semantic");
+			const result = await withPaperFallback(() => searchPapers(params.query, params.mode?.trim() || "semantic"));
 			return { content: [{ type: "text", text: formatText(result) }], details: result };
 		},
 	});
@@ -69,7 +82,7 @@ export function registerAlphaTools(pi: ExtensionAPI): void {
 			sections: Type.Optional(paperSectionsSchema),
 		}),
 		async execute(_toolCallId, params) {
-			const result = await getPaper(params.paper, { fullText: params.fullText });
+			const result = await withPaperFallback(() => getPaper(params.paper, { fullText: params.fullText }));
 			const extracted = extractPaperSections(result.content, params.section, params.sections);
 			const filteredResult = extracted.requested.length
 				? {
@@ -92,7 +105,7 @@ export function registerAlphaTools(pi: ExtensionAPI): void {
 			question: Type.String({ description: "Question about the paper." }),
 		}),
 		async execute(_toolCallId, params) {
-			const result = await askPaper(params.paper, params.question);
+			const result = await withPaperFallback(() => askPaper(params.paper, params.question));
 			return { content: [{ type: "text", text: formatText(result) }], details: result };
 		},
 	});

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@companion-ai/feynman",
-  "version": "0.5.4",
+  "version": "0.5.5",
   "description": "Research-first CLI agent built on Pi and alphaXiv",
   "license": "MIT",
   "type": "module",
   "engines": {
-    "node": ">=22.22.0 <26"
+    "node": ">=22.22.0"
   },
   "bin": {
     "feynman": "bin/feynman.js"
@@ -77,16 +77,16 @@
     }
   },
   "dependencies": {
-    "@clack/prompts": "^1.7.0",
+    "@clack/prompts": "^1.8.1",
     "@companion-ai/alpha-hub": "0.1.6",
     "@earendil-works/pi-ai": "*",
     "@earendil-works/pi-coding-agent": "*",
     "fast-xml-parser": "5.11.1",
-    "pi-btw": "0.6.0",
+    "pi-btw": "0.6.1",
     "pi-docparser": "4.0.0",
     "pi-subagents": "0.71.0",
     "pi-web-access": "0.31.0",
-    "posthog-node": "^5.51.6"
+    "posthog-node": "^5.53.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": "*",
@@ -95,10 +95,10 @@
     "typebox": "*"
   },
   "devDependencies": {
-    "@types/node": "^26.4.1",
-    "tsx": "^4.23.13",
+    "@types/node": "^26.6.2",
+    "tsx": "^4.23.15",
     "typescript": "^7.0.2",
-    "yaml": "2.9.0"
+    "yaml": "2.9.1"
   },
   "repository": {
     "type": "git",

package/scripts/check-node-version.mjs

@@ -1,5 +1,4 @@
 const MIN_NODE_VERSION = "22.22.0";
-const MAX_NODE_MAJOR = 25;
 const PREFERRED_NODE_MAJOR = 24;
 
 function parseNodeVersion(version) {
@@ -18,20 +17,16 @@ function compareNodeVersions(left, right) {
 }
 
 function isSupportedNodeVersion(version = process.versions.node) {
-	const parsed = parseNodeVersion(version);
-	return compareNodeVersions(parsed, parseNodeVersion(MIN_NODE_VERSION)) >= 0 && parsed.major <= MAX_NODE_MAJOR;
+	return compareNodeVersions(parseNodeVersion(version), parseNodeVersion(MIN_NODE_VERSION)) >= 0;
 }
 
 function getUnsupportedNodeVersionLines(version = process.versions.node) {
 	const isWindows = process.platform === "win32";
-	const parsed = parseNodeVersion(version);
 	return [
-		`feynman supports Node.js ${MIN_NODE_VERSION} through ${MAX_NODE_MAJOR}.x (detected ${version}).`,
-		parsed.major > MAX_NODE_MAJOR
-			? "This newer Node release is not supported yet."
-			: isWindows
-				? "Install a supported Node.js release from https://nodejs.org, or use the standalone installer:"
-				: `Switch to a supported Node release with \`nvm install ${PREFERRED_NODE_MAJOR} && nvm use ${PREFERRED_NODE_MAJOR}\`, or use the standalone installer:`,
+		`feynman requires Node.js ${MIN_NODE_VERSION} or newer (detected ${version}).`,
+		isWindows
+			? "Install a supported Node.js release from https://nodejs.org, or use the standalone installer:"
+			: `Switch to a supported Node release with \`nvm install ${PREFERRED_NODE_MAJOR} && nvm use ${PREFERRED_NODE_MAJOR}\`, or use the standalone installer:`,
 		isWindows
 			? "irm https://feynman.is/install.ps1 | iex"
 			: "curl -fsSL https://feynman.is/install | bash",
@@ -42,11 +37,5 @@ if (!isSupportedNodeVersion()) {
 	for (const line of getUnsupportedNodeVersionLines()) {
 		console.error(line);
 	}
-	// Too-new Node must not abort the install: failing preinstall makes npm roll
-	// back to the previously installed version, which pins users to a release that
-	// predates the fix they are trying to get (issue #177). The launcher in
-	// bin/feynman.js enforces the supported range at runtime with the same message.
-	if (parseNodeVersion(process.versions.node).major <= MAX_NODE_MAJOR) {
-		process.exit(1);
-	}
+	process.exit(1);
 }