@companion-ai/feynman 0.2.8 → 0.2.10

package/dist/cli.js

@@ -10,12 +10,12 @@ import { ensureFeynmanHome, getDefaultSessionDir, getFeynmanAgentDir, getFeynman
 import { launchPiChat } from "./pi/launch.js";
 import { CORE_PACKAGE_SOURCES, getOptionalPackagePresetSources, listOptionalPackagePresets } from "./pi/package-presets.js";
 import { normalizeFeynmanSettings, normalizeThinkingLevel, parseModelSpec } from "./pi/settings.js";
-import { loginModelProvider, logoutModelProvider, printModelList, setDefaultModelSpec, } from "./model/commands.js";
+import { getCurrentModelSpec, loginModelProvider, logoutModelProvider, printModelList, setDefaultModelSpec, } from "./model/commands.js";
 import { printSearchStatus } from "./search/commands.js";
 import { runDoctor, runStatus } from "./setup/doctor.js";
 import { setupPreviewDependencies } from "./setup/preview.js";
 import { runSetup } from "./setup/setup.js";
-import { printInfo, printPanel, printSection } from "./ui/terminal.js";
+import { printAsciiHeader, printInfo, printPanel, printSection } from "./ui/terminal.js";
 import { cliCommandSections, formatCliWorkflowUsage, legacyFlags, readPromptSpecs, topLevelCommandNames, } from "../metadata/commands.mjs";
 const TOP_LEVEL_COMMANDS = new Set(topLevelCommandNames);
 function printHelpLine(usage, description) {
@@ -25,7 +25,7 @@ function printHelpLine(usage, description) {
 }
 function printHelp(appRoot) {
     const workflowCommands = readPromptSpecs(appRoot).filter((command) => command.section === "Research Workflows" && command.topLevelCli);
-    printPanel("Feynman", [
+    printAsciiHeader([
         "Research-first agent shell built on Pi.",
         "Use `feynman setup` first if this is a new machine.",
     ]);
@@ -87,7 +87,7 @@ async function handleModelCommand(subcommand, args, feynmanSettingsPath, feynman
         return;
     }
     if (subcommand === "login") {
-        await loginModelProvider(feynmanAuthPath, args[0]);
+        await loginModelProvider(feynmanAuthPath, args[0], feynmanSettingsPath);
         return;
     }
     if (subcommand === "logout") {
@@ -347,6 +347,21 @@ export async function main() {
             throw new Error(`Unknown model: ${explicitModelSpec}`);
         }
     }
+    if (!explicitModelSpec && !getCurrentModelSpec(feynmanSettingsPath) && process.stdin.isTTY && process.stdout.isTTY) {
+        await runSetup({
+            settingsPath: feynmanSettingsPath,
+            bundledSettingsPath,
+            authPath: feynmanAuthPath,
+            workingDir,
+            sessionDir,
+            appRoot,
+            defaultThinkingLevel: thinkingLevel,
+        });
+        if (!getCurrentModelSpec(feynmanSettingsPath)) {
+            return;
+        }
+        normalizeFeynmanSettings(feynmanSettingsPath, bundledSettingsPath, thinkingLevel, feynmanAuthPath);
+    }
     await launchPiChat({
         appRoot,
         workingDir,

package/dist/model/commands.js

@@ -3,7 +3,7 @@ import { writeFileSync } from "node:fs";
 import { readJson } from "../pi/settings.js";
 import { promptChoice, promptText } from "../setup/prompts.js";
 import { printInfo, printSection, printSuccess, printWarning } from "../ui/terminal.js";
-import { buildModelStatusSnapshotFromRecords, getAvailableModelRecords, getSupportedModelRecords, } from "./catalog.js";
+import { buildModelStatusSnapshotFromRecords, chooseRecommendedModel, getAvailableModelRecords, getSupportedModelRecords, } from "./catalog.js";
 function collectModelStatus(settingsPath, authPath) {
     return buildModelStatusSnapshotFromRecords(getSupportedModelRecords(authPath), getAvailableModelRecords(authPath), getCurrentModelSpec(settingsPath));
 }
@@ -80,7 +80,7 @@ export function printModelList(settingsPath, authPath) {
         printInfo(`${spec}${markers.length > 0 ? ` (${markers.join(", ")})` : ""}`);
     }
 }
-export async function loginModelProvider(authPath, providerId) {
+export async function loginModelProvider(authPath, providerId, settingsPath) {
     const provider = providerId ? resolveOAuthProvider(authPath, providerId) : await selectOAuthProvider(authPath, "login");
     if (!provider) {
         if (providerId) {
@@ -111,6 +111,19 @@ export async function loginModelProvider(authPath, providerId) {
         signal: abortController.signal,
     });
     printSuccess(`Model provider login complete: ${provider.id}`);
+    if (settingsPath) {
+        const currentSpec = getCurrentModelSpec(settingsPath);
+        const available = getAvailableModelRecords(authPath);
+        const currentValid = currentSpec
+            ? available.some((m) => `${m.provider}/${m.id}` === currentSpec)
+            : false;
+        if ((!currentSpec || !currentValid) && available.length > 0) {
+            const recommended = chooseRecommendedModel(authPath);
+            if (recommended) {
+                setDefaultModelSpec(settingsPath, authPath, recommended.spec);
+            }
+        }
+    }
 }
 export async function logoutModelProvider(authPath, providerId) {
     const provider = providerId ? resolveOAuthProvider(authPath, providerId) : await selectOAuthProvider(authPath, "logout");
@@ -138,28 +151,20 @@ export function setDefaultModelSpec(settingsPath, authPath, spec) {
     printSuccess(`Default model set to ${resolvedSpec}`);
 }
 export async function runModelSetup(settingsPath, authPath) {
-    const status = collectModelStatus(settingsPath, authPath);
+    let status = collectModelStatus(settingsPath, authPath);
     if (status.availableModels.length === 0) {
-        printWarning("No Pi models are currently authenticated for Feynman.");
-        for (const line of status.guidance) {
-            printInfo(line);
+        await loginModelProvider(authPath, undefined, settingsPath);
+        status = collectModelStatus(settingsPath, authPath);
+        if (status.availableModels.length === 0) {
+            return;
         }
-        printInfo("Tip: run `feynman model login <provider>` if your provider supports Pi OAuth login.");
-        return;
     }
-    const choices = status.availableModels.map((spec) => {
-        const markers = [
-            spec === status.recommended ? "recommended" : undefined,
-            spec === status.current ? "current" : undefined,
-        ].filter(Boolean);
-        return `${spec}${markers.length > 0 ? ` (${markers.join(", ")})` : ""}`;
-    });
-    choices.push(`Keep current (${status.current ?? "unset"})`);
-    const defaultIndex = status.current ? Math.max(0, status.availableModels.indexOf(status.current)) : 0;
-    const selection = await promptChoice("Select your default research model:", choices, defaultIndex >= 0 ? defaultIndex : 0);
-    if (selection >= status.availableModels.length) {
-        printInfo("Skipped (keeping current model)");
+    if (status.currentValid) {
+        printInfo(`Model: ${status.current}`);
         return;
     }
-    setDefaultModelSpec(settingsPath, authPath, status.availableModels[selection]);
+    const recommended = status.recommended ?? status.availableModels[0];
+    if (recommended) {
+        setDefaultModelSpec(settingsPath, authPath, recommended);
+    }
 }

package/dist/setup/setup.js

@@ -1,119 +1,38 @@
 import { isLoggedIn as isAlphaLoggedIn, login as loginAlpha } from "@companion-ai/alpha-hub/lib";
-import { getDefaultSessionDir, getFeynmanHome } from "../config/paths.js";
-import { getPiWebAccessStatus, getPiWebSearchConfigPath } from "../pi/web-access.js";
+import { getPiWebAccessStatus } from "../pi/web-access.js";
 import { normalizeFeynmanSettings } from "../pi/settings.js";
 import { getCurrentModelSpec, runModelSetup } from "../model/commands.js";
 import { buildModelStatusSnapshotFromRecords, getAvailableModelRecords, getSupportedModelRecords } from "../model/catalog.js";
 import { PANDOC_FALLBACK_PATHS, resolveExecutable } from "../system/executables.js";
-import { promptText } from "./prompts.js";
 import { setupPreviewDependencies } from "./preview.js";
-import { runDoctor } from "./doctor.js";
-import { printInfo, printPanel, printSection, printSuccess } from "../ui/terminal.js";
-async function explainWebAccess() {
-    const status = getPiWebAccessStatus();
-    printSection("Web Access");
-    printInfo("Feynman uses the bundled `pi-web-access` package directly.");
-    printInfo("Default v1 path: sign into gemini.google.com in a supported Chromium browser.");
-    printInfo(`Current search route: ${status.routeLabel}`);
-    printInfo(`Pi config path: ${status.configPath}`);
-    printInfo("Advanced users can edit the Pi config directly if they want API keys or a different route.");
-}
-function isPreviewConfigured() {
-    return Boolean(resolveExecutable("pandoc", PANDOC_FALLBACK_PATHS));
-}
+import { printInfo, printSection, printSuccess } from "../ui/terminal.js";
 function isInteractiveTerminal() {
     return Boolean(process.stdin.isTTY && process.stdout.isTTY);
 }
 function printNonInteractiveSetupGuidance() {
-    printPanel("Feynman Setup", [
-        "Non-interactive terminal detected.",
-    ]);
-    printInfo("Use the explicit commands instead of the interactive setup wizard:");
-    printInfo("  feynman status");
+    printInfo("Non-interactive terminal. Use explicit commands:");
     printInfo("  feynman model login <provider>");
     printInfo("  feynman model set <provider/model>");
-    printInfo("  feynman search status");
-    printInfo(`  edit ${getPiWebSearchConfigPath()}    # optional advanced web config`);
     printInfo("  feynman alpha login");
     printInfo("  feynman doctor");
-    printInfo("  feynman   # Pi's /login flow still works inside chat if you prefer it");
-}
-async function runPreviewSetup() {
-    const result = setupPreviewDependencies();
-    printSuccess(result.message);
-}
-function printConfigurationLocation(appRoot) {
-    printSection("Configuration Location");
-    printInfo(`Data folder:  ${getFeynmanHome()}`);
-    printInfo(`Sessions:     ${getDefaultSessionDir()}`);
-    printInfo(`Install dir:  ${appRoot}`);
 }
-function printSetupSummary(settingsPath, authPath) {
-    const modelStatus = buildModelStatusSnapshotFromRecords(getSupportedModelRecords(authPath), getAvailableModelRecords(authPath), getCurrentModelSpec(settingsPath));
-    printSection("Setup Summary");
-    printInfo(`Model: ${getCurrentModelSpec(settingsPath) ?? "not set"}`);
-    printInfo(`Model valid: ${modelStatus.currentValid ? "yes" : "no"}`);
-    printInfo(`Recommended model: ${modelStatus.recommended ?? "not available"}`);
-    printInfo(`alphaXiv: ${isAlphaLoggedIn() ? "configured" : "missing"}`);
-    printInfo(`Web access: pi-web-access (${getPiWebAccessStatus().routeLabel})`);
-    printInfo(`Preview: ${isPreviewConfigured() ? "configured" : "not configured"}`);
-    for (const line of modelStatus.guidance) {
-        printInfo(line);
+export async function runSetup(options) {
+    if (!isInteractiveTerminal()) {
+        printNonInteractiveSetupGuidance();
+        return;
     }
-}
-async function runFullSetup(options) {
-    printConfigurationLocation(options.appRoot);
     await runModelSetup(options.settingsPath, options.authPath);
     if (!isAlphaLoggedIn()) {
         await loginAlpha();
         printSuccess("alphaXiv login complete");
     }
-    else {
-        printInfo("alphaXiv login already configured");
-    }
-    await explainWebAccess();
-    await runPreviewSetup();
+    const result = setupPreviewDependencies();
+    printSuccess(result.message);
     normalizeFeynmanSettings(options.settingsPath, options.bundledSettingsPath, options.defaultThinkingLevel ?? "medium", options.authPath);
-    runDoctor({
-        settingsPath: options.settingsPath,
-        authPath: options.authPath,
-        sessionDir: options.sessionDir,
-        workingDir: options.workingDir,
-        appRoot: options.appRoot,
-    });
-    printSetupSummary(options.settingsPath, options.authPath);
-}
-function hasExistingSetup(settingsPath, authPath) {
-    const modelStatus = buildModelStatusSnapshotFromRecords(getSupportedModelRecords(authPath), getAvailableModelRecords(authPath), getCurrentModelSpec(settingsPath));
-    return Boolean(modelStatus.current ||
-        modelStatus.availableModels.length > 0 ||
-        isAlphaLoggedIn() ||
-        isPreviewConfigured());
-}
-async function runDefaultInteractiveSetup(options) {
-    const existing = hasExistingSetup(options.settingsPath, options.authPath);
-    printPanel("Feynman Setup Wizard", [
-        "Guided setup for the research-first Pi agent.",
-        "Press Ctrl+C at any time to exit.",
-    ]);
-    if (existing) {
-        printSection("Full Setup");
-        printInfo("Existing configuration detected. Rerunning the full guided setup.");
-    }
-    else {
-        printInfo("We'll walk you through:");
-        printInfo("  1. Model Selection");
-        printInfo("  2. alphaXiv Login");
-        printInfo("  3. Preview Dependencies");
-    }
-    printInfo("Press Enter to begin, or Ctrl+C to exit.");
-    await promptText("Press Enter to start");
-    await runFullSetup(options);
-}
-export async function runSetup(options) {
-    if (!isInteractiveTerminal()) {
-        printNonInteractiveSetupGuidance();
-        return;
-    }
-    await runDefaultInteractiveSetup(options);
+    const modelStatus = buildModelStatusSnapshotFromRecords(getSupportedModelRecords(options.authPath), getAvailableModelRecords(options.authPath), getCurrentModelSpec(options.settingsPath));
+    printSection("Ready");
+    printInfo(`Model: ${getCurrentModelSpec(options.settingsPath) ?? "not set"}`);
+    printInfo(`alphaXiv: ${isAlphaLoggedIn() ? "configured" : "not configured"}`);
+    printInfo(`Preview: ${resolveExecutable("pandoc", PANDOC_FALLBACK_PATHS) ? "configured" : "not configured"}`);
+    printInfo(`Web: ${getPiWebAccessStatus().routeLabel}`);
 }

package/dist/ui/terminal.js

@@ -1,3 +1,4 @@
+import { FEYNMAN_ASCII_LOGO } from "../../logo.mjs";
 const RESET = "\x1b[0m";
 const BOLD = "\x1b[1m";
 const DIM = "\x1b[2m";
@@ -31,6 +32,16 @@ export function printSection(title) {
     console.log("");
     console.log(paint(`◆ ${title}`, TEAL, BOLD));
 }
+export function printAsciiHeader(subtitleLines = []) {
+    console.log("");
+    for (const line of FEYNMAN_ASCII_LOGO) {
+        console.log(paint(`  ${line}`, TEAL, BOLD));
+    }
+    for (const line of subtitleLines) {
+        console.log(paint(`  ${line}`, ASH));
+    }
+    console.log("");
+}
 export function printPanel(title, subtitleLines = []) {
     const inner = 53;
     const border = "─".repeat(inner + 2);

package/extensions/research-tools/header.ts

@@ -230,8 +230,10 @@ export function installFeynmanHeader(
 
 				push("");
 				if (cardW >= 70) {
+					const maxLogoW = Math.max(...FEYNMAN_AGENT_LOGO.map((l) => l.length));
+					const logoOffset = " ".repeat(Math.max(0, Math.floor((cardW - maxLogoW) / 2)));
 					for (const logoLine of FEYNMAN_AGENT_LOGO) {
-						push(theme.fg("accent", theme.bold(centerText(truncateVisible(logoLine, cardW), cardW))));
+						push(theme.fg("accent", theme.bold(`${logoOffset}${truncateVisible(logoLine, cardW)}`)));
 					}
 					push("");
 				}

package/logo.d.mts

@@ -1,3 +1,3 @@
 export declare const FEYNMAN_ASCII_LOGO: string[];
 export declare const FEYNMAN_ASCII_LOGO_TEXT: string;
-export declare const FEYNMAN_ASCII_LOGO_HTML: string;
+export declare const FEYNMAN_LOGO_HTML: string;

package/logo.mjs

@@ -1,12 +1,15 @@
 export const FEYNMAN_ASCII_LOGO = [
-	"███████╗███████╗██╗   ██╗███╗   ██╗███╗   ███╗ █████╗ ███╗   ██╗",
-	"██╔════╝██╔════╝╚██╗ ██╔╝████╗  ██║████╗ ████║██╔══██╗████╗  ██║",
-	"█████╗  █████╗   ╚████╔╝ ██╔██╗ ██║██╔████╔██║███████║██╔██╗ ██║",
-	"██╔══╝  ██╔══╝    ╚██╔╝  ██║╚██╗██║██║╚██╔╝██║██╔══██║██║╚██╗██║",
-	"██║     ███████╗   ██║   ██║ ╚████║██║ ╚═╝ ██║██║  ██║██║ ╚████║",
-	"╚═╝     ╚══════╝   ╚═╝   ╚═╝  ╚═══╝╚═╝     ╚═╝╚═╝  ╚═╝╚═╝  ╚═══╝",
+	"   ██████",
+	" ███",
+	"█████████      ████████   ███      ███  ███ ██████    ██ ███ ████     ███████     ███ ██████",
+	" ███         ███     ███   ███    ███   ████     ███  ███  ██  ███          ███   ████     ███",
+	" ███        ████████████    ███  ███    ███      ███  ███  ██  ███    █████████   ███      ███",
+	" ███         ███             ██ ███     ███      ███  ███  ██  ███  ███     ███   ███      ███",
+	"███████        ████████       ████      ███      ███  ███  ██  ███    ██████ ███  ███      ███",
+	"                              ███",
+	"                           █████",
 ];
 
 export const FEYNMAN_ASCII_LOGO_TEXT = FEYNMAN_ASCII_LOGO.join("\n");
 
-export const FEYNMAN_LOGO_HTML = `<link href="https://fonts.googleapis.com/css2?family=Silkscreen:wght@700&display=swap" rel="stylesheet"><span style="font-family:'Silkscreen',cursive;font-size:48px;font-weight:700;color:#10b981">feynman</span>`;
+export const FEYNMAN_LOGO_HTML = `<style>@import url('https://fonts.googleapis.com/css2?family=VT323&display=swap');.logo{width:auto!important;height:auto!important}</style><span style="font-family:'VT323',monospace;font-size:64px;letter-spacing:-0.05em;color:#10b981">feynman</span>`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@companion-ai/feynman",
-  "version": "0.2.8",
+  "version": "0.2.10",
   "description": "Research-first CLI agent built on Pi and alphaXiv",
   "type": "module",
   "engines": {

package/scripts/patch-embedded-pi.mjs

@@ -2,7 +2,7 @@ import { spawnSync } from "node:child_process";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-import { FEYNMAN_ASCII_LOGO_HTML } from "../logo.mjs";
+import { FEYNMAN_LOGO_HTML } from "../logo.mjs";
 
 const here = dirname(fileURLToPath(import.meta.url));
 const appRoot = resolve(here, "..");
@@ -365,7 +365,7 @@ if (oauthPagePath && existsSync(oauthPagePath)) {
 	let source = readFileSync(oauthPagePath, "utf8");
 	const piLogo = 'const LOGO_SVG = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 800 800" aria-hidden="true"><path fill="#fff" fill-rule="evenodd" d="M165.29 165.29 H517.36 V400 H400 V517.36 H282.65 V634.72 H165.29 Z M282.65 282.65 V400 H400 V282.65 Z"/><path fill="#fff" d="M517.36 400 H634.72 V634.72 H517.36 Z"/></svg>`;';
 	if (source.includes(piLogo)) {
-		const feynmanLogo = `const LOGO_SVG = \`${FEYNMAN_ASCII_LOGO_HTML}\`;`;
+		const feynmanLogo = `const LOGO_SVG = \`${FEYNMAN_LOGO_HTML}\`;`;
 		source = source.replace(piLogo, feynmanLogo);
 		writeFileSync(oauthPagePath, source, "utf8");
 	}
@@ -377,17 +377,17 @@ const alphaHubAuthPath = findPackageRoot("@companion-ai/alpha-hub")
 
 if (alphaHubAuthPath && existsSync(alphaHubAuthPath)) {
 	let source = readFileSync(alphaHubAuthPath, "utf8");
-	const callbackStyle = `style="font-family:system-ui,sans-serif;display:flex;flex-direction:column;align-items:center;justify-content:center;min-height:80vh;background:#050a08;color:#f0f5f2"`;
-	const logoHtml = FEYNMAN_ASCII_LOGO_HTML.replace('color:#10b981', 'color:#34d399');
-	const successPage = `<html><body ${callbackStyle}>${logoHtml}<h2 style="color:#34d399;margin-top:24px">Logged in</h2><p style="color:#8aaa9a">You can close this tab.</p></body></html>`;
-	const errorPage = `<html><body ${callbackStyle}>${logoHtml}<h2 style="color:#ef4444;margin-top:24px">Login failed</h2><p style="color:#8aaa9a">You can close this tab.</p></body></html>`;
-	const oldSuccess = `'<html><body><h2>Logged in to Alpha Hub</h2><p>You can close this tab.</p></body></html>'`;
-	const oldError = `'<html><body><h2>Login failed</h2><p>You can close this tab.</p></body></html>'`;
+	const oldSuccess = "'<html><body><h2>Logged in to Alpha Hub</h2><p>You can close this tab.</p></body></html>'";
+	const oldError = "'<html><body><h2>Login failed</h2><p>You can close this tab.</p></body></html>'";
+	const bodyAttr = `style="font-family:system-ui,sans-serif;text-align:center;padding-top:20vh;background:#050a08;color:#f0f5f2"`;
+	const logo = `<h1 style="font-family:monospace;font-size:48px;color:#34d399;margin:0">feynman</h1>`;
+	const newSuccess = `'<html><body ${bodyAttr}>${logo}<h2 style="color:#34d399;margin-top:16px">Logged in</h2><p style="color:#8aaa9a">You can close this tab.</p></body></html>'`;
+	const newError = `'<html><body ${bodyAttr}>${logo}<h2 style="color:#ef4444;margin-top:16px">Login failed</h2><p style="color:#8aaa9a">You can close this tab.</p></body></html>'`;
 	if (source.includes(oldSuccess)) {
-		source = source.replace(oldSuccess, `'${successPage}'`);
+		source = source.replace(oldSuccess, newSuccess);
 	}
 	if (source.includes(oldError)) {
-		source = source.replace(oldError, `'${errorPage}'`);
+		source = source.replace(oldError, newError);
 	}
 	writeFileSync(alphaHubAuthPath, source, "utf8");
 }