@companion-ai/feynman 0.5.19 → 0.5.20

package/RELEASES.md

@@ -6,6 +6,10 @@ GitHub release notes are generated from the matching `## vX.Y.Z` section in this
 
 ## Unreleased
 
+## v0.5.20 - 2026-10-01
+
+- **Settings saved by Windows Notepad or PowerShell no longer stop Feynman.** Both can save UTF-8 with a byte-order mark, which JSON parsing rejects, so Feynman refused to start with "Invalid Feynman settings ... expected a JSON object", and other commands read the file as empty. Feynman now ignores the mark in `settings.json`, `auth.json`, and `web-search.json`, as Pi does. A settings file with a real JSON error now names the error, for example a trailing comma, instead of the generic message.
+
 ## v0.5.19 - 2026-10-01
 
 - **Word drafts open without LibreOffice.** `document_parse` needs LibreOffice for `.docx` files, which most machines lack, so reviewing a thesis or draft in Word format failed. When LibreOffice is missing, Feynman now reads the document's paragraph text directly from the `.docx` and says so; install LibreOffice for page layout, tables, footnotes, and images.

package/dist/config/json-file.js

@@ -0,0 +1,9 @@
+import { readFileSync } from "node:fs";
+// Windows Notepad and PowerShell 5.1 save UTF-8 with a byte-order mark, which
+// JSON.parse rejects. Pi strips it when it reads the same files.
+export function parseJsonText(source) {
+    return JSON.parse(source.replace(/^/, ""));
+}
+export function readJsonFile(path) {
+    return parseJsonText(readFileSync(path, "utf8"));
+}

package/dist/model/catalog.js

@@ -1,5 +1,5 @@
-import { readFileSync } from "node:fs";
 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
@@ -334,7 +334,7 @@ export async function getSupportedModelRecords(authPath) {
 function readExpiredOAuthProviders(authPath) {
     const expired = new Set();
     try {
-        const parsed = JSON.parse(readFileSync(authPath, "utf8"));
+        const parsed = readJsonFile(authPath);
         for (const [provider, credential] of Object.entries(parsed)) {
             if (!credential || typeof credential !== "object")
                 continue;

package/dist/model/service-tier.js

@@ -1,5 +1,6 @@
-import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { mkdirSync, writeFileSync } from "node:fs";
 import { dirname } from "node:path";
+import { readJsonFile } from "../config/json-file.js";
 export const FEYNMAN_SERVICE_TIERS = [
     "auto",
     "default",
@@ -12,7 +13,7 @@ const OPENAI_SERVICE_TIERS = new Set(["auto", "default", "flex", "priority"]);
 const ANTHROPIC_SERVICE_TIERS = new Set(["auto", "standard_only"]);
 function readSettings(settingsPath) {
     try {
-        return JSON.parse(readFileSync(settingsPath, "utf8"));
+        return readJsonFile(settingsPath);
     }
     catch {
         return {};

package/dist/pi/settings.js

@@ -1,5 +1,6 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
+import { parseJsonText, readJsonFile } from "../config/json-file.js";
 import { BUNDLED_PI_PACKAGES, getFeynmanPackageSources, resolvePackageRoot } from "./runtime.js";
 import { choosePreferredModelRecord, getAvailableModelRecords } from "../model/catalog.js";
 // Written by Feynman <= 0.4.0 next to a subagent extension path it managed.
@@ -50,7 +51,7 @@ export function readJson(path) {
         return {};
     }
     try {
-        return JSON.parse(readFileSync(path, "utf8"));
+        return readJsonFile(path);
     }
     catch (error) {
         if (process.env.FEYNMAN_DEBUG === "1") {
@@ -66,10 +67,11 @@ function readConfigObject(path, label) {
     const source = readFileSync(path, "utf8");
     let value;
     try {
-        value = JSON.parse(source);
+        value = parseJsonText(source);
     }
-    catch {
-        throw new Error(`Invalid ${label} at ${path}: expected a JSON object. The file was not changed.`);
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        throw new Error(`Invalid ${label} at ${path}: ${reason}. Fix the JSON or delete the file. The file was not changed.`);
     }
     if (!isRecord(value)) {
         throw new Error(`Invalid ${label} at ${path}: expected a JSON object. The file was not changed.`);

package/dist/pi/web-access.js

@@ -1,5 +1,6 @@
-import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { chmodSync, existsSync, mkdirSync, writeFileSync } from "node:fs";
 import { dirname, resolve } from "node:path";
+import { readJsonFile } from "../config/json-file.js";
 import { getFeynmanAgentDir, getFeynmanHome } from "../config/paths.js";
 // pi-web-access reads web-search.json from PI_CODING_AGENT_DIR.
 export function getPiWebSearchConfigPath(home) {
@@ -20,7 +21,7 @@ export function loadPiWebAccessConfig(configPath = getPiWebSearchConfigPath()) {
         return {};
     }
     try {
-        const parsed = JSON.parse(readFileSync(configPath, "utf8"));
+        const parsed = readJsonFile(configPath);
         return parsed && typeof parsed === "object" ? parsed : {};
     }
     catch {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@companion-ai/feynman",
-  "version": "0.5.19",
+  "version": "0.5.20",
   "description": "Research-first CLI agent built on Pi and alphaXiv",
   "license": "MIT",
   "type": "module",