@companion-ai/feynman 0.5.21 → 0.5.22

package/RELEASES.md

@@ -6,6 +6,11 @@ GitHub release notes are generated from the matching `## vX.Y.Z` section in this
 
 ## Unreleased
 
+## v0.5.22 - 2026-10-01
+
+- **Launch warnings and the first-run telemetry notice show inside the session.** Feynman printed them to the terminal just before starting Pi, where Pi 1.0's fullscreen interface (coming in a later Feynman release) hides them for the whole session. They now appear in Pi's own interface: the Windows "No Bash found" warning, the small-local-model warning for research workflows, and the one-time telemetry disclosure. A one-shot `--prompt` run still prints them to stderr.
+- `feynman doctor` reports Pi's new `quietStartup: "header"` setting as "header only" instead of "disabled".
+
 ## v0.5.21 - 2026-10-01
 
 - **LiteLLM and custom providers that read their key from an environment variable work again.** Since Pi 0.99, `models.json` resolves an environment variable only when written as `$NAME`; a bare name is sent as the key itself. Feynman's LiteLLM setup wrote `LITELLM_MASTER_KEY`, so requests went out as `Authorization: Bearer LITELLM_MASTER_KEY` and the proxy rejected them, and custom providers set up with a variable name broke the same way. Feynman now writes `$NAME`, and on start rewrites any `apiKey` in `models.json` that is a bare all-caps variable name, such as `LITELLM_MASTER_KEY`, to `$LITELLM_MASTER_KEY`. Literal keys, placeholders such as `local`, and `!command` values are left alone.

package/dist/pi/launch.js

@@ -41,15 +41,10 @@ export async function runPi(options, args, env, stdin = "inherit") {
     });
 }
 export async function launchPiChat(options) {
+    let telemetryNotice;
     if (process.stdout.isTTY && options.mode !== "rpc") {
         process.stdout.write("\x1b[2J\x1b[3J\x1b[H");
-        // Clearing the screen erased the first-run notice printed at startup.
-        const telemetryNotice = telemetryFirstRunNotice();
-        if (telemetryNotice)
-            process.stderr.write(`${telemetryNotice}\n`);
-    }
-    if (options.preLaunchNotice) {
-        process.stdout.write(`${options.preLaunchNotice}\n`);
+        telemetryNotice = telemetryFirstRunNotice();
     }
     const executables = await resolveAllExecutables();
     ensureFeynmanCommandShim(options.appRoot, options.feynmanAgentDir);
@@ -59,5 +54,13 @@ export async function launchPiChat(options) {
     // explicit prompt forever.
     const explicitPrompt = Boolean(options.oneShotPrompt || options.initialPrompt);
     const stdin = explicitPrompt && options.mode !== "rpc" && !process.stdin.isTTY ? "ignore" : "inherit";
-    process.exitCode = await runPi(options, buildPiArgs(options), buildPiEnv(options, executables), stdin);
+    // Pi's fullscreen UI hides anything printed before it starts, so the TUI
+    // session shows these itself; one-shot and JSON runs print them as before.
+    const notice = [telemetryNotice, options.preLaunchNotice].filter(Boolean).join("\n");
+    const tui = options.mode !== "rpc" && options.mode !== "json" && !options.oneShotPrompt;
+    if (notice && !tui)
+        process.stderr.write(`${notice}\n`);
+    const env = buildPiEnv(options, executables);
+    env.FEYNMAN_LAUNCH_NOTICE = notice && tui ? notice : undefined;
+    process.exitCode = await runPi(options, buildPiArgs(options), env, stdin);
 }

package/dist/setup/doctor.js

@@ -171,7 +171,7 @@ export async function runDoctor(options) {
     for (const line of formatPiWebAccessDoctorLines()) {
         console.log(line);
     }
-    console.log(`quiet startup: ${settings.quietStartup === true ? "enabled" : "disabled"}`);
+    console.log(`quiet startup: ${settings.quietStartup === "header" ? "header only" : settings.quietStartup === true ? "enabled" : "disabled"}`);
     console.log(`theme: ${typeof settings.theme === "string" ? settings.theme : "not set"}`);
     if (missingPiBits.length > 0) {
         console.log("pi runtime: missing files");

package/extensions/research-tools/launch-notice.ts

@@ -0,0 +1,12 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+
+export function registerLaunchNotice(pi: ExtensionAPI): void {
+	pi.on("session_start", (_event, ctx) => {
+		const notice = process.env.FEYNMAN_LAUNCH_NOTICE;
+		delete process.env.FEYNMAN_LAUNCH_NOTICE;
+		if (notice && ctx.mode === "tui" && ctx.hasUI) {
+			// Pi labels warnings itself.
+			ctx.ui.notify(notice.replace(/^Warning: /gm, ""), "warning");
+		}
+	});
+}

package/extensions/research-tools.ts

@@ -7,6 +7,7 @@ import { registerDocxFallback } from "./research-tools/docx-fallback.js";
 import { installFeynmanHeader } from "./research-tools/header.js";
 import { registerHelpCommand } from "./research-tools/help.js";
 import { registerHuggingFaceTools } from "./research-tools/huggingface.js";
+import { registerLaunchNotice } from "./research-tools/launch-notice.js";
 import { registerInitCommand, registerOutputsCommand } from "./research-tools/project.js";
 import { registerServiceTierControls } from "./research-tools/service-tier.js";
 import { registerScienceDatabaseTools } from "./research-tools/science-databases.js";
@@ -27,6 +28,7 @@ export default function researchTools(pi: ExtensionAPI): void {
 	registerDocxFallback(pi);
 	registerHelpCommand(pi);
 	registerInitCommand(pi);
+	registerLaunchNotice(pi);
 	registerOutputsCommand(pi);
 	registerServiceTierControls(pi);
 	registerScienceDatabaseTools(pi);

package/package.json

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