@companion-ai/feynman 0.2.4 → 0.2.6

package/.feynman/settings.json

@@ -6,13 +6,10 @@
     "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",
-    "npm:@kaiserlich-dev/pi-session-search",
     "npm:pi-schedule-prompt",
-    "npm:@samfp/pi-memory",
     "npm:@tmustier/pi-ralph-wiggum"
   ],
   "quietStartup": true,

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/bin/feynman.js

@@ -1,2 +1,8 @@
 #!/usr/bin/env node
-import "../dist/index.js";
+const v = process.versions.node.split(".").map(Number);
+if (v[0] < 20) {
+  console.error(`feynman requires Node.js 20 or later (you have ${process.versions.node})`);
+  console.error("upgrade: https://nodejs.org or nvm install 20");
+  process.exit(1);
+}
+import("../dist/index.js");

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,71 @@
+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:pi-schedule-prompt",
+    "npm:@tmustier/pi-ralph-wiggum",
+];
+export const OPTIONAL_PACKAGE_PRESETS = {
+    "generative-ui": {
+        description: "Interactive Glimpse UI widgets.",
+        sources: ["npm:pi-generative-ui"],
+    },
+    memory: {
+        description: "Cross-session memory and preference recall.",
+        sources: ["npm:@samfp/pi-memory"],
+    },
+    "session-search": {
+        description: "Indexed session recall with SQLite-backed search.",
+        sources: ["npm:@kaiserlich-dev/pi-session-search"],
+    },
+    "all-extras": {
+        description: "Install all optional packages.",
+        sources: ["npm:pi-generative-ui", "npm:@samfp/pi-memory", "npm:@kaiserlich-dev/pi-session-search"],
+    },
+};
+const LEGACY_DEFAULT_PACKAGE_SOURCES = [
+    ...CORE_PACKAGE_SOURCES,
+    "npm:pi-generative-ui",
+    "npm:@kaiserlich-dev/pi-session-search",
+    "npm:@samfp/pi-memory",
+];
+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];
+    }
+    if (normalized === "search") {
+        return [...OPTIONAL_PACKAGE_PRESETS["session-search"].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/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,8 +1,11 @@
 {
   "name": "@companion-ai/feynman",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "Research-first CLI agent built on Pi and alphaXiv",
   "type": "module",
+  "engines": {
+    "node": ">=20.18.1"
+  },
   "bin": {
     "feynman": "bin/feynman.js"
   },
@@ -57,9 +60,6 @@
     "tsx": "^4.21.0",
     "typescript": "^5.9.3"
   },
-  "engines": {
-    "node": ">=20.18.1"
-  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/getcompanion-ai/feynman.git"

package/scripts/patch-embedded-pi.mjs

@@ -5,6 +5,7 @@ import { fileURLToPath } from "node:url";
 
 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 +54,75 @@ 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",
+	);
+
+	console.log("[feynman] installing research packages...");
+	const result = spawnSync("npm", ["install", "--prefer-offline", "--no-audit", "--no-fund", "--prefix", workspaceDir, ...packageSpecs], {
+		stdio: "inherit",
+		timeout: 300000,
+	});
+
+	if (result.status !== 0) {
+		console.warn("[feynman] warning: package install failed, Pi will retry on first launch");
+	}
+}
+
+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"));