@companion-ai/feynman 0.2.5 → 0.2.7

package/.feynman/settings.json

@@ -6,7 +6,6 @@
     "npm:pi-web-access",
     "npm:pi-markdown-preview",
     "npm:@walterra/pi-charts",
-    "npm:pi-generative-ui",
     "npm:pi-mermaid",
     "npm:@aliou/pi-processes",
     "npm:pi-zotero",

package/README.md

@@ -61,7 +61,7 @@ Four bundled research agents, dispatched automatically or via subagent commands.
 - **Docker** — isolated container execution for safe experiments on your machine
 - **[Agent Computer](https://agentcomputer.ai)** — secure cloud execution for long-running research and GPU workloads
 - **Web search** — Gemini or Perplexity, zero-config default via signed-in Chromium
-- **Session search** — indexed recall across prior research sessions
+- **Session search** — optional indexed recall across prior research sessions
 - **Preview** — browser and PDF export of generated artifacts
 
 ---
@@ -76,6 +76,8 @@ feynman status                      # current config summary
 feynman model login [provider]      # model auth
 feynman model set <provider/model>  # set default model
 feynman alpha login                 # alphaXiv auth
+feynman packages list               # core vs optional packages
+feynman packages install memory     # opt into heavier packages on demand
 feynman search status               # web search config
 ```
 

package/dist/cli.js

@@ -8,6 +8,7 @@ import { AuthStorage, DefaultPackageManager, ModelRegistry, SettingsManager } fr
 import { syncBundledAssets } from "./bootstrap/sync.js";
 import { ensureFeynmanHome, getDefaultSessionDir, getFeynmanAgentDir, getFeynmanHome } from "./config/paths.js";
 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 { printSearchStatus } from "./search/commands.js";
@@ -125,6 +126,65 @@ async function handleUpdateCommand(workingDir, feynmanAgentDir, source) {
     await settingsManager.flush();
     console.log("All packages up to date.");
 }
+async function handlePackagesCommand(subcommand, args, workingDir, feynmanAgentDir) {
+    const settingsManager = SettingsManager.create(workingDir, feynmanAgentDir);
+    const configuredSources = new Set(settingsManager
+        .getPackages()
+        .map((entry) => (typeof entry === "string" ? entry : entry.source))
+        .filter((entry) => typeof entry === "string"));
+    if (!subcommand || subcommand === "list") {
+        printPanel("Feynman Packages", [
+            "Core packages are installed by default to keep first-run setup fast.",
+        ]);
+        printSection("Core");
+        for (const source of CORE_PACKAGE_SOURCES) {
+            printInfo(source);
+        }
+        printSection("Optional");
+        for (const preset of listOptionalPackagePresets()) {
+            const installed = preset.sources.every((source) => configuredSources.has(source));
+            printInfo(`${preset.name}${installed ? " (installed)" : ""}  ${preset.description}`);
+        }
+        printInfo("Install with: feynman packages install <preset>");
+        return;
+    }
+    if (subcommand !== "install") {
+        throw new Error(`Unknown packages command: ${subcommand}`);
+    }
+    const target = args[0];
+    if (!target) {
+        throw new Error("Usage: feynman packages install <generative-ui|memory|session-search|all-extras>");
+    }
+    const sources = getOptionalPackagePresetSources(target);
+    if (!sources) {
+        throw new Error(`Unknown package preset: ${target}`);
+    }
+    const packageManager = new DefaultPackageManager({
+        cwd: workingDir,
+        agentDir: feynmanAgentDir,
+        settingsManager,
+    });
+    packageManager.setProgressCallback((event) => {
+        if (event.type === "start") {
+            console.log(`Installing ${event.source}...`);
+        }
+        else if (event.type === "complete") {
+            console.log(`Installed ${event.source}`);
+        }
+        else if (event.type === "error") {
+            console.error(`Failed to install ${event.source}: ${event.message ?? "unknown error"}`);
+        }
+    });
+    for (const source of sources) {
+        if (configuredSources.has(source)) {
+            console.log(`${source} already installed`);
+            continue;
+        }
+        await packageManager.install(source);
+    }
+    await settingsManager.flush();
+    console.log("Optional packages installed.");
+}
 function handleSearchCommand(subcommand) {
     if (!subcommand || subcommand === "status") {
         printSearchStatus();
@@ -267,6 +327,10 @@ export async function main() {
         handleSearchCommand(rest[0]);
         return;
     }
+    if (command === "packages") {
+        await handlePackagesCommand(rest[0], rest.slice(1), workingDir, feynmanAgentDir);
+        return;
+    }
     if (command === "update") {
         await handleUpdateCommand(workingDir, feynmanAgentDir, rest[0]);
         return;

package/dist/pi/package-presets.js

@@ -0,0 +1,56 @@
+export const CORE_PACKAGE_SOURCES = [
+    "npm:pi-subagents",
+    "npm:pi-btw",
+    "npm:pi-docparser",
+    "npm:pi-web-access",
+    "npm:pi-markdown-preview",
+    "npm:@walterra/pi-charts",
+    "npm:pi-mermaid",
+    "npm:@aliou/pi-processes",
+    "npm:pi-zotero",
+    "npm:@kaiserlich-dev/pi-session-search",
+    "npm:pi-schedule-prompt",
+    "npm:@samfp/pi-memory",
+    "npm:@tmustier/pi-ralph-wiggum",
+];
+export const OPTIONAL_PACKAGE_PRESETS = {
+    "generative-ui": {
+        description: "Interactive Glimpse UI widgets.",
+        sources: ["npm:pi-generative-ui"],
+    },
+};
+const LEGACY_DEFAULT_PACKAGE_SOURCES = [
+    ...CORE_PACKAGE_SOURCES,
+    "npm:pi-generative-ui",
+];
+function arraysMatchAsSets(left, right) {
+    if (left.length !== right.length) {
+        return false;
+    }
+    const rightSet = new Set(right);
+    return left.every((entry) => rightSet.has(entry));
+}
+export function shouldPruneLegacyDefaultPackages(packages) {
+    if (!Array.isArray(packages)) {
+        return false;
+    }
+    if (packages.some((entry) => typeof entry !== "string")) {
+        return false;
+    }
+    return arraysMatchAsSets(packages, LEGACY_DEFAULT_PACKAGE_SOURCES);
+}
+export function getOptionalPackagePresetSources(name) {
+    const normalized = name.trim().toLowerCase();
+    if (normalized === "ui") {
+        return [...OPTIONAL_PACKAGE_PRESETS["generative-ui"].sources];
+    }
+    const preset = OPTIONAL_PACKAGE_PRESETS[normalized];
+    return preset ? [...preset.sources] : undefined;
+}
+export function listOptionalPackagePresets() {
+    return Object.entries(OPTIONAL_PACKAGE_PRESETS).map(([name, preset]) => ({
+        name: name,
+        description: preset.description,
+        sources: [...preset.sources],
+    }));
+}

package/dist/pi/settings.js

@@ -1,6 +1,7 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname } from "node:path";
 import { AuthStorage, ModelRegistry } from "@mariozechner/pi-coding-agent";
+import { CORE_PACKAGE_SOURCES, shouldPruneLegacyDefaultPackages } from "./package-presets.js";
 export function parseModelSpec(spec, modelRegistry) {
     const trimmed = spec.trim();
     const separator = trimmed.includes(":") ? ":" : trimmed.includes("/") ? "/" : null;
@@ -83,6 +84,12 @@ export function normalizeFeynmanSettings(settingsPath, bundledSettingsPath, defa
     settings.theme = "feynman";
     settings.quietStartup = true;
     settings.collapseChangelog = true;
+    if (!Array.isArray(settings.packages) || settings.packages.length === 0) {
+        settings.packages = [...CORE_PACKAGE_SOURCES];
+    }
+    else if (shouldPruneLegacyDefaultPackages(settings.packages)) {
+        settings.packages = [...CORE_PACKAGE_SOURCES];
+    }
     const authStorage = AuthStorage.create(authPath);
     const modelRegistry = new ModelRegistry(authStorage);
     const availableModels = modelRegistry.getAvailable().map((model) => ({

package/extensions/research-tools/shared.ts

@@ -14,14 +14,7 @@ export const FEYNMAN_VERSION = (() => {
 	}
 })();
 
-export const FEYNMAN_AGENT_LOGO = [
-	"███████╗███████╗██╗   ██╗███╗   ██╗███╗   ███╗ █████╗ ███╗   ██╗",
-	"██╔════╝██╔════╝╚██╗ ██╔╝████╗  ██║████╗ ████║██╔══██╗████╗  ██║",
-	"█████╗  █████╗   ╚████╔╝ ██╔██╗ ██║██╔████╔██║███████║██╔██╗ ██║",
-	"██╔══╝  ██╔══╝    ╚██╔╝  ██║╚██╗██║██║╚██╔╝██║██╔══██║██║╚██╗██║",
-	"██║     ███████╗   ██║   ██║ ╚████║██║ ╚═╝ ██║██║  ██║██║ ╚████║",
-	"╚═╝     ╚══════╝   ╚═╝   ╚═╝  ╚═══╝╚═╝     ╚═╝╚═╝  ╚═╝╚═╝  ╚═══╝",
-];
+export { FEYNMAN_ASCII_LOGO as FEYNMAN_AGENT_LOGO } from "../../logo.mjs";
 
 export const FEYNMAN_RESEARCH_TOOLS = [
 	"alpha_search",

package/metadata/commands.mjs

@@ -98,6 +98,8 @@ export const cliCommandSections = [
 	{
 		title: "Utilities",
 		commands: [
+			{ usage: "feynman packages list", description: "Show core and optional Pi package presets." },
+			{ usage: "feynman packages install <preset>", description: "Install optional package presets on demand." },
 			{ usage: "feynman search status", description: "Show Pi web-access status and config path." },
 			{ usage: "feynman update [package]", description: "Update installed packages, or a specific package." },
 		],
@@ -118,7 +120,7 @@ export const legacyFlags = [
 	{ usage: "--setup-preview", description: "Alias for `feynman setup preview`." },
 ];
 
-export const topLevelCommandNames = ["alpha", "chat", "doctor", "help", "model", "search", "setup", "status", "update"];
+export const topLevelCommandNames = ["alpha", "chat", "doctor", "help", "model", "packages", "search", "setup", "status", "update"];
 
 export function formatSlashUsage(command) {
 	return `/${command.name}${command.args ? ` ${command.args}` : ""}`;

package/package.json

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

package/scripts/patch-embedded-pi.mjs

@@ -2,9 +2,11 @@ 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";
 
 const here = dirname(fileURLToPath(import.meta.url));
 const appRoot = resolve(here, "..");
+const isGlobalInstall = process.env.npm_config_global === "true" || process.env.npm_config_location === "global";
 
 function findNodeModules() {
 	let dir = appRoot;
@@ -53,7 +55,88 @@ const settingsPath = resolve(appRoot, ".feynman", "settings.json");
 const workspaceDir = resolve(appRoot, ".feynman", "npm");
 const workspacePackageJsonPath = resolve(workspaceDir, "package.json");
 
-// Pi handles package installation from .feynman/settings.json at runtime — no manual install needed
+function resolveExecutable(name, fallbackPaths = []) {
+	for (const candidate of fallbackPaths) {
+		if (existsSync(candidate)) return candidate;
+	}
+
+	const result = spawnSync("sh", ["-lc", `command -v ${name}`], {
+		encoding: "utf8",
+		stdio: ["ignore", "pipe", "ignore"],
+	});
+	if (result.status === 0) {
+		const resolved = result.stdout.trim();
+		if (resolved) return resolved;
+	}
+	return null;
+}
+
+function ensurePackageWorkspace() {
+	if (!existsSync(settingsPath)) return;
+
+	const settings = JSON.parse(readFileSync(settingsPath, "utf8"));
+	const packageSpecs = Array.isArray(settings.packages)
+		? settings.packages
+				.filter((v) => typeof v === "string" && v.startsWith("npm:"))
+				.map((v) => v.slice(4))
+		: [];
+
+	if (packageSpecs.length === 0) return;
+	if (existsSync(resolve(workspaceRoot, packageSpecs[0]))) return;
+
+	mkdirSync(workspaceDir, { recursive: true });
+	writeFileSync(
+		workspacePackageJsonPath,
+		JSON.stringify({ name: "feynman-packages", private: true }, null, 2) + "\n",
+		"utf8",
+	);
+
+	const frames = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+	let frame = 0;
+	const start = Date.now();
+	const spinner = setInterval(() => {
+		const elapsed = Math.round((Date.now() - start) / 1000);
+		process.stderr.write(`\r${frames[frame++ % frames.length]} setting up feynman... ${elapsed}s`);
+	}, 80);
+
+	const result = spawnSync("npm", ["install", "--prefer-offline", "--no-audit", "--no-fund", "--loglevel", "error", "--prefix", workspaceDir, ...packageSpecs], {
+		stdio: ["ignore", "ignore", "pipe"],
+		timeout: 300000,
+	});
+
+	clearInterval(spinner);
+	const elapsed = Math.round((Date.now() - start) / 1000);
+
+	if (result.status !== 0) {
+		process.stderr.write(`\r✗ setup failed (${elapsed}s)\n`);
+		if (result.stderr?.length) process.stderr.write(result.stderr);
+	} else {
+		process.stderr.write(`\r✓ feynman ready (${elapsed}s)\n`);
+	}
+}
+
+ensurePackageWorkspace();
+
+function ensurePandoc() {
+	if (!isGlobalInstall) return;
+	if (process.platform !== "darwin") return;
+	if (process.env.FEYNMAN_SKIP_PANDOC_INSTALL === "1") return;
+	if (resolveExecutable("pandoc", ["/opt/homebrew/bin/pandoc", "/usr/local/bin/pandoc"])) return;
+
+	const brewPath = resolveExecutable("brew", ["/opt/homebrew/bin/brew", "/usr/local/bin/brew"]);
+	if (!brewPath) return;
+
+	console.log("[feynman] installing pandoc...");
+	const result = spawnSync(brewPath, ["install", "pandoc"], {
+		stdio: "inherit",
+		timeout: 300000,
+	});
+	if (result.status !== 0) {
+		console.warn("[feynman] warning: pandoc install failed, run `feynman --setup-preview` later");
+	}
+}
+
+ensurePandoc();
 
 if (existsSync(packageJsonPath)) {
 	const pkg = JSON.parse(readFileSync(packageJsonPath, "utf8"));
@@ -282,12 +365,33 @@ 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 = `<span style="font-size:32px;font-weight:700;color:#10b981;font-family:system-ui,sans-serif;letter-spacing:-0.02em">feynman</span>`;';
+		const feynmanLogo = `const LOGO_SVG = \`${FEYNMAN_ASCII_LOGO_HTML}\`;`;
 		source = source.replace(piLogo, feynmanLogo);
 		writeFileSync(oauthPagePath, source, "utf8");
 	}
 }
 
+const alphaHubAuthPath = findPackageRoot("@companion-ai/alpha-hub")
+	? resolve(findPackageRoot("@companion-ai/alpha-hub"), "src", "lib", "auth.js")
+	: null;
+
+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>'`;
+	if (source.includes(oldSuccess)) {
+		source = source.replace(oldSuccess, `'${successPage}'`);
+	}
+	if (source.includes(oldError)) {
+		source = source.replace(oldError, `'${errorPage}'`);
+	}
+	writeFileSync(alphaHubAuthPath, source, "utf8");
+}
+
 if (existsSync(piMemoryPath)) {
 	let source = readFileSync(piMemoryPath, "utf8");
 	const memoryOriginal = 'const MEMORY_DIR = join(homedir(), ".pi", "memory");';