@companion-ai/feynman 0.5.4 → 0.5.6

package/.feynman/settings.json

@@ -2,9 +2,5 @@
   "theme": "feynman",
   "quietStartup": true,
   "collapseChangelog": true,
-  "editorPaddingX": 1,
-  "retry": {
-    "maxRetries": 6,
-    "baseDelayMs": 5000
-  }
+  "editorPaddingX": 1
 }

package/.nvmrc

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

package/README.md

@@ -7,6 +7,7 @@
 <p align="center">
   <a href="https://feynman.is/docs"><img alt="Docs" src="https://img.shields.io/badge/docs-feynman.is-0d9668?style=flat-square" /></a>
   <a href="https://github.com/Companion-Inc/feynman/blob/main/LICENSE"><img alt="License" src="https://img.shields.io/github/license/Companion-Inc/feynman?style=flat-square" /></a>
+  <a href="https://deepwiki.com/Companion-Inc/feynman"><img alt="Ask DeepWiki" src="https://deepwiki.com/badge.svg" /></a>
 </p>
 
 ---
@@ -27,7 +28,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
@@ -149,7 +150,7 @@ Feynman runs on stock [Pi](https://github.com/earendil-works/pi) (`@earendil-wor
 
 ### Telemetry
 
-Feynman sends anonymous usage telemetry to PostHog by default and prints a one-time notice on first run. It sends commands, workflow names and outcomes, tool names, model and provider names, token counts, latency, and error flags under a random install ID. It never sends prompts, model output, paper content, file paths, or tool arguments. Set `FEYNMAN_TELEMETRY=off` (or `DO_NOT_TRACK=1`) to disable it; `feynman status` shows the current setting. The full event list is in the [configuration docs](https://feynman.is/docs/getting-started/configuration#telemetry).
+Feynman sends anonymous usage telemetry to PostHog by default and prints a one-time notice on first run. It sends commands, workflow names and outcomes, tool names, model and provider names, token counts, latency, and error messages with stack traces (home folder shown as `~`) under a random install ID. It never sends prompts, model output, paper content, or tool arguments. Set `FEYNMAN_TELEMETRY=off` (or `DO_NOT_TRACK=1`) to disable it; `feynman status` shows the current setting. The full event list is in the [configuration docs](https://feynman.is/docs/getting-started/configuration#telemetry).
 
 ---
 

package/RELEASES.md

@@ -6,6 +6,36 @@ GitHub release notes are generated from the matching `## vX.Y.Z` section in this
 
 ## Unreleased
 
+## v0.5.6 - 2026-09-26
+
+### Failures report what went wrong
+
+- Usage telemetry now carries readable error text instead of a hash: the error message and stack trace (also sent to PostHog error tracking), the last lines of Pi's error output when a run exits with an error, a failed tool's error text, and the provider's error message on a failed model call. Your home folder is shown as `~`. Paths inside your projects can appear in this text. Prompts, model output, paper content, and tool arguments are still never sent. Opt out with `FEYNMAN_TELEMETRY=off` as before.
+- CI runs and the test suite no longer report telemetry, so usage numbers count real installs only.
+
+### Fixes
+
+- A dead network connection now fails in about 15 seconds with `Connection error.` instead of retrying silently for over five minutes. Feynman had set a 6-retry, 5-second backoff that also applied to connection errors; it now uses Pi's default, and the old value is removed from existing settings. Rate limits are still retried with the provider's `Retry-After`.
+- `feynman setup` and `feynman model login` in a window Node cannot prompt in (Git Bash's default window, a script, or an AI coding agent) now explain how to proceed: `winpty`, PowerShell, or setting the provider's API key variable and running `feynman model set`.
+
+## 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/cli.js

@@ -17,7 +17,7 @@ import { getValidToken as getValidAlphaToken } from "@companion-ai/alpha-hub/lib
 import { verifyAlphaAuthStatus } from "./alpha-auth-status.js";
 import { ensureFeynmanAgentDir } from "./bootstrap/home.js";
 import { ensureFeynmanHome, getDefaultSessionDir, getFeynmanAgentDir, getFeynmanHome } from "./config/paths.js";
-import { launchPiChat, runPi } from "./pi/launch.js";
+import { getLastPiStderr, launchPiChat, runPi } from "./pi/launch.js";
 import { installPiPackage, listOptionalPackagePresets, normalizeOptionalPackagePresetName, resolvePackageSource, updatePiPackages, } from "./pi/packages.js";
 import { canonicalizeModelSpec, ensureFeynmanSettings, normalizeThinkingLevel, readJson, } from "./pi/settings.js";
 import { BUNDLED_PI_PACKAGES, buildPiEnv } from "./pi/runtime.js";
@@ -29,7 +29,7 @@ import { fetchLatestFeynmanVersion, getFeynmanUpgradeLines, isNewerVersion } fro
 import { runDoctor, runStatus } from "./setup/doctor.js";
 import { setupPreviewDependencies } from "./setup/preview.js";
 import { runSetup } from "./setup/setup.js";
-import { captureTelemetryEvent, getCliTelemetryMetadata, initializePostHogTelemetry, shutdownPostHogTelemetry, telemetryErrorProperties, telemetryFirstRunNotice, } from "./telemetry/posthog.js";
+import { captureTelemetryEvent, captureTelemetryException, getCliTelemetryMetadata, initializePostHogTelemetry, shutdownPostHogTelemetry, telemetryErrorProperties, telemetryFirstRunNotice, } from "./telemetry/posthog.js";
 import { ASH, printAsciiHeader, printInfo, printPanel, printSection, RESET, SAGE } from "./ui/terminal.js";
 import { createModelRuntime } from "./model/registry.js";
 import { cliCommandSections, formatCliWorkflowUsage, legacyFlags, readPromptSpecs, topLevelCommandNames, } from "../metadata/commands.mjs";
@@ -395,6 +395,7 @@ export async function main() {
             ...commandTelemetry,
             duration_ms: durationMs,
             exit_code: exitCode,
+            ...(exitCode === 0 ? {} : { pi_stderr: getLastPiStderr() }),
         };
         captureTelemetryEvent(exitCode === 0 ? "feynman_command_completed" : "feynman_command_failed", completeProperties);
     }
@@ -406,6 +407,7 @@ export async function main() {
             ...telemetryErrorProperties(error),
         };
         captureTelemetryEvent("feynman_command_failed", failureProperties);
+        await captureTelemetryException(error, commandTelemetry).catch(() => { });
         throw error;
     }
     finally {

package/dist/pi/launch.js

@@ -7,6 +7,12 @@ export function exitCodeFromSignal(signal) {
     const signalNumber = constants.signals[signal];
     return typeof signalNumber === "number" ? 128 + signalNumber : 1;
 }
+// The end of Pi's stderr from the last run, reported with a failed command so
+// crashes inside Pi are debuggable.
+let lastPiStderr = "";
+export function getLastPiStderr() {
+    return lastPiStderr;
+}
 export async function runPi(options, args, env, stdin = "inherit") {
     const piCliPath = resolvePiCliPath(options.appRoot);
     if (!piCliPath) {
@@ -14,9 +20,14 @@ export async function runPi(options, args, env, stdin = "inherit") {
     }
     const child = spawn(process.execPath, [piCliPath, ...args], {
         cwd: options.workingDir,
-        stdio: [stdin, "inherit", "inherit"],
+        stdio: [stdin, "inherit", "pipe"],
         env,
     });
+    lastPiStderr = "";
+    child.stderr?.on("data", (chunk) => {
+        process.stderr.write(chunk);
+        lastPiStderr = (lastPiStderr + chunk.toString("utf8")).slice(-8000);
+    });
     return await new Promise((resolvePromise, reject) => {
         child.on("error", reject);
         child.on("exit", (code, signal) => {

package/dist/pi/settings.js

@@ -163,6 +163,10 @@ export async function ensureFeynmanSettings(settingsPath, bundledSettingsPath, a
     }
     settings.packages = reconcileFeynmanPackages(settings.packages, appRoot);
     removeLegacyResearcherExtension(settings);
+    // 0.5.0-0.5.5 seeded a 6-retry, 5s backoff that left a dead connection
+    // retrying silently for over five minutes; drop that exact value for Pi's default.
+    if (isRecord(settings.retry) && JSON.stringify(settings.retry) === '{"maxRetries":6,"baseDelayMs":5000}')
+        delete settings.retry;
     // A ~/.agents/<name>.md would otherwise silently replace Feynman's agents.
     if (settings.subagents === undefined)
         settings.subagents = {};

package/dist/setup/prompts.js

@@ -5,9 +5,18 @@ export class SetupCancelledError extends Error {
         this.name = "SetupCancelledError";
     }
 }
+export function nonInteractiveTerminalMessage(env = process.env, platform = process.platform) {
+    return [
+        "feynman setup requires an interactive terminal.",
+        platform === "win32" && env.MSYSTEM
+            ? "Git Bash's default window is not one Node can prompt in: run `winpty feynman setup`, or use PowerShell or Windows Terminal."
+            : "Run it yourself in a terminal window, not through a script or an AI coding agent.",
+        "To skip the prompts, set your provider's API key variable (for example OPENAI_API_KEY or ANTHROPIC_API_KEY) and run `feynman model set <provider/model>`.",
+    ].join("\n");
+}
 function ensureInteractiveTerminal() {
     if (!process.stdin.isTTY || !process.stdout.isTTY) {
-        throw new Error("feynman setup requires an interactive terminal.");
+        throw new Error(nonInteractiveTerminalMessage());
     }
 }
 function guardCancelled(value) {

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/dist/telemetry/posthog.js

@@ -1,5 +1,6 @@
-import { randomUUID, createHash } from "node:crypto";
+import { randomUUID } from "node:crypto";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
 import { dirname, resolve } from "node:path";
 import { PostHog } from "posthog-node";
 import { getFeynmanHome, getFeynmanStateDir } from "../config/paths.js";
@@ -11,7 +12,7 @@ const TELEMETRY_DISABLED_VALUES = new Set(["0", "false", "no", "off", "disabled"
 const TELEMETRY_KEY_PATTERN = /^[A-Za-z0-9_$./-]+$/;
 export const TELEMETRY_NOTICE = [
     "Attention: Feynman collects anonymous usage telemetry: commands, workflows, tool names, models, token counts, and errors.",
-    "It never sends prompts, paper content, file paths, or tool arguments.",
+    "Errors include their message and stack trace, with your home folder shown as ~. It never sends prompts, model output, paper content, or tool arguments.",
     "To opt out, set FEYNMAN_TELEMETRY=off. Learn more: https://www.feynman.is/docs/getting-started/configuration#telemetry",
 ].join("\n");
 let posthogClient;
@@ -145,13 +146,26 @@ function normalizeTelemetryKey(key) {
         return undefined;
     return normalized.slice(0, 80);
 }
-function normalizeTelemetryValue(value) {
+// Error text is sent as-is (home folder shown as ~) so failures can be debugged.
+const RAW_TEXT_KEYS = new Set(["error_message", "pi_stderr"]);
+const RAW_TEXT_LIMIT = 4000;
+export function redactTelemetryText(text, home = homedir()) {
+    let redacted = text;
+    if (home) {
+        for (const variant of new Set([home, home.replace(/\\/g, "/")]))
+            redacted = redacted.split(variant).join("~");
+    }
+    return redacted.length > RAW_TEXT_LIMIT ? `...${redacted.slice(-RAW_TEXT_LIMIT)}` : redacted;
+}
+function normalizeTelemetryValue(value, raw = false) {
     if (value === undefined)
         return undefined;
     if (value === null || typeof value === "boolean")
         return value;
     if (typeof value === "number")
         return Number.isFinite(value) ? value : undefined;
+    if (raw)
+        return value.trim() ? redactTelemetryText(value.trim()) : undefined;
     const trimmed = value.replace(/\s+/g, " ").trim();
     if (!trimmed)
         return undefined;
@@ -161,7 +175,7 @@ export function normalizeTelemetryProperties(properties = {}) {
     const normalized = {};
     for (const [key, value] of Object.entries(properties)) {
         const normalizedKey = normalizeTelemetryKey(key);
-        const normalizedValue = normalizeTelemetryValue(value);
+        const normalizedValue = normalizeTelemetryValue(value, RAW_TEXT_KEYS.has(normalizedKey ?? ""));
         if (!normalizedKey || normalizedValue === undefined)
             continue;
         normalized[normalizedKey] = normalizedValue;
@@ -179,11 +193,6 @@ function baseTelemetryProperties(config) {
         $process_person_profile: false,
     });
 }
-export function stableTelemetryHash(value) {
-    if (!value)
-        return undefined;
-    return createHash("sha256").update(value).digest("hex").slice(0, 16);
-}
 function telemetryErrorName(error) {
     if (!(error instanceof Error))
         return typeof error;
@@ -193,7 +202,7 @@ export function telemetryErrorProperties(error) {
     const message = error instanceof Error ? error.message : String(error);
     return {
         error_name: telemetryErrorName(error),
-        error_message_hash: stableTelemetryHash(message),
+        error_message: message,
     };
 }
 export function initializePostHogTelemetry(options = {}) {
@@ -234,6 +243,20 @@ export function captureTelemetryEvent(event, properties = {}) {
         },
     });
 }
+/** Send an error with its stack trace to PostHog error tracking. */
+export async function captureTelemetryException(error, properties = {}) {
+    if (!activeConfig || !posthogClient)
+        return;
+    const source = error instanceof Error ? error : new Error(String(error));
+    const redacted = new Error(redactTelemetryText(source.message));
+    redacted.name = source.name;
+    redacted.stack = source.stack ? redactTelemetryText(source.stack) : undefined;
+    // The immediate variant is awaited, so the event is sent before the CLI exits.
+    await posthogClient.captureExceptionImmediate(redacted, activeConfig.distinctId, {
+        ...baseTelemetryProperties(activeConfig),
+        ...normalizeTelemetryProperties(properties),
+    });
+}
 export async function captureTelemetryEventImmediate(event, properties = {}) {
     if (!activeConfig || !posthogClient)
         return;

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/extensions/research-tools/telemetry.ts

@@ -1,4 +1,5 @@
 import { readdirSync, statSync } from "node:fs";
+import { homedir } from "node:os";
 import { join } from "node:path";
 
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
@@ -75,6 +76,20 @@ function createPostHogClient(config: ResearchTelemetryConfig): ResearchTelemetry
 	return client;
 }
 
+// Error text is sent as-is so failures can be debugged; the home folder is shown as ~.
+export function errorText(value: unknown, home = homedir()): string | undefined {
+	const text = typeof value === "string" ? value : undefined;
+	if (!text?.trim()) return undefined;
+	let redacted = text.trim();
+	if (home) for (const variant of new Set([home, home.replace(/\\/g, "/")])) redacted = redacted.split(variant).join("~");
+	return redacted.length > 4000 ? `...${redacted.slice(-4000)}` : redacted;
+}
+
+function toolErrorText(result: unknown): string | undefined {
+	const content = (result as { content?: Array<{ type?: string; text?: string }> } | undefined)?.content;
+	return errorText(Array.isArray(content) ? content.filter((part) => part?.type === "text").map((part) => part.text).join("\n") : undefined);
+}
+
 export function workflowName(text: string, workflows: ReadonlySet<string>): string {
 	const name = /^\/([A-Za-z0-9_-]+)(?:\s|$)/.exec(text.trimStart())?.[1];
 	return name && workflows.has(name) ? name : "chat";
@@ -195,7 +210,12 @@ export function registerResearchTelemetry(
 	});
 
 	pi.on("tool_execution_end", (event) => {
-		capture("feynman_tool_used", { tool: event.toolName, is_error: event.isError, subagent: !primary });
+		capture("feynman_tool_used", {
+			tool: event.toolName,
+			is_error: event.isError,
+			subagent: !primary,
+			...(event.isError ? { error_message: toolErrorText(event.result) } : {}),
+		});
 		if (!run) return;
 		run.toolCalls += 1;
 		if (event.toolName === "subagent") run.subagentCalls += 1;
@@ -226,6 +246,7 @@ export function registerResearchTelemetry(
 			$ai_latency: 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,
 			$ai_stop_reason: message.stopReason,
 			subagent: !primary,
 		});

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@companion-ai/feynman",
-  "version": "0.5.4",
+  "version": "0.5.6",
   "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);
 }