palmier 0.9.20 → 0.9.21

package/README.md

@@ -191,10 +191,12 @@ Agents are re-detected on every daemon start; managed-agent versions are re-prob
 
 ### Palmier-managed Agents
 
-An agent is considered **Palmier-managed** if it was installed via `palmier init` (or its update is initiated via the PWA). Palmier-managed agents have a known installed version stamped at install/update time; that version is what the PWA uses to drive the agent soft-update dialog and what's recorded into each session's run metadata so a session always shows the agent version it actually ran with — even after the live agent is upgraded.
+An agent is considered **Palmier-managed** if it was installed via `palmier init`, `palmier agents`, or its update is initiated via the PWA. Palmier-managed agents have a known installed version stamped at install/update time; that version is what the PWA uses to drive the agent soft-update dialog and what's recorded into each session's run metadata so a session always shows the agent version it actually ran with — even after the live agent is upgraded.
 
 Agents installed by the user outside the wizard (e.g., `npm install -g <pkg>` directly) are detected and usable but are **not** considered Palmier-managed. The PWA shows them under a separate "Version not managed by Palmier" section and does not offer auto-update for them.
 
+Run `palmier agents` to manage agent CLIs after setup: it lists installed agents and offers an interactive picker to install or uninstall one. `palmier init` only prompts for an agent install when none are detected; once any agent is installed, init just lists them and continues with host registration.
+
 ### Updates
 
 - **Palmier itself** — when a newer version of `palmier` is published to npm, the PWA shows a dismissible "Update Available" dialog. Clicking "Update Now" runs `npm update -g palmier` on the host and restarts the daemon. Clicking "Dismiss" suppresses the dialog for that exact version (per host, per device); a future release re-arms it.
@@ -209,6 +211,7 @@ The default network interface is detected once during `palmier init` and saved t
 | Command | Description |
 |---|---|
 | `palmier init` | Interactive setup wizard |
+| `palmier agents` | List, install, and uninstall agent CLIs |
 | `palmier pair` | Generate a pairing code to pair a new device |
 | `palmier clients list` | List active client tokens |
 | `palmier clients revoke <token>` | Revoke a specific client token |

package/dist/agents/wizard.d.ts

@@ -0,0 +1,23 @@
+import { type DetectedAgent } from "./agent.js";
+export declare const colors: {
+    bold: (s: string) => string;
+    dim: (s: string) => string;
+    green: (s: string) => string;
+    cyan: (s: string) => string;
+    red: (s: string) => string;
+    yellow: (s: string) => string;
+};
+export declare function printInstalledAgents(agents: DetectedAgent[]): void;
+export interface InstallPickerOptions {
+    /** Show a "Cancel" entry as the first choice. */
+    allowCancel?: boolean;
+    /** Override the picker prompt message. */
+    message?: string;
+}
+/** Show the install picker and run the npm install + auth flow for the chosen
+ *  agent. Returns the new DetectedAgent record on success, or null if the user
+ *  cancelled, no installables remain, or the install failed. */
+export declare function pickAndInstallAgent(current: DetectedAgent[], options?: InstallPickerOptions): Promise<DetectedAgent | null>;
+/** Show the uninstall picker. Runs `npm uninstall -g` for the chosen agent
+ *  and returns the agent key on success, or null on cancel/failure/no candidates. */
+export declare function pickAndUninstallAgent(current: DetectedAgent[]): Promise<string | null>;

package/dist/agents/wizard.js

@@ -0,0 +1,160 @@
+import { spawnSync } from "child_process";
+import * as readline from "readline";
+import { selectFromList } from "../prompts.js";
+import { getAgent, getNpmInstalledVersion, listInstallableAgents, } from "./agent.js";
+export const colors = {
+    bold: (s) => `\x1b[1m${s}\x1b[0m`,
+    dim: (s) => `\x1b[2m${s}\x1b[0m`,
+    green: (s) => `\x1b[32m${s}\x1b[0m`,
+    cyan: (s) => `\x1b[36m${s}\x1b[0m`,
+    red: (s) => `\x1b[31m${s}\x1b[0m`,
+    yellow: (s) => `\x1b[33m${s}\x1b[0m`,
+};
+const { bold, dim, green, cyan, red } = colors;
+export function printInstalledAgents(agents) {
+    if (agents.length === 0) {
+        console.log(`  ${dim("(none installed)")}`);
+        return;
+    }
+    for (const a of agents) {
+        const version = a.version ? ` ${dim(`v${a.version}`)}` : "";
+        const note = a.version ? "" : ` ${dim("(not managed by Palmier)")}`;
+        console.log(`  ${green("✓")} ${a.label}${version}${note}`);
+    }
+}
+/** Show the install picker and run the npm install + auth flow for the chosen
+ *  agent. Returns the new DetectedAgent record on success, or null if the user
+ *  cancelled, no installables remain, or the install failed. */
+export async function pickAndInstallAgent(current, options = {}) {
+    const detectedKeys = new Set(current.map((a) => a.key));
+    const missing = listInstallableAgents()
+        .filter((a) => !detectedKeys.has(a.key))
+        .sort((a, b) => a.label.localeCompare(b.label));
+    if (missing.length === 0) {
+        console.log(`\n${dim("All supported agents are already installed.")}`);
+        return null;
+    }
+    const installChoices = missing.map((a) => ({
+        label: a.freeUsage ? `${a.label} ${green(`[${a.freeUsage}]`)}` : a.label,
+        hint: a.npmPackage,
+    }));
+    const choices = options.allowCancel
+        ? [{ label: "Cancel", hint: "go back" }, ...installChoices]
+        : installChoices;
+    const message = options.message ?? `\n${bold("Select an agent to install:")}`;
+    const idx = await selectFromList(message, choices);
+    if (idx === null)
+        return null;
+    if (options.allowCancel && idx === 0)
+        return null;
+    const choice = missing[options.allowCancel ? idx - 1 : idx];
+    if (!installAgentPackage(choice))
+        return null;
+    console.log(green(`  ${choice.label} installed.`));
+    const tool = getAgent(choice.key);
+    const version = getNpmInstalledVersion(choice.npmPackage) ?? undefined;
+    const record = {
+        key: choice.key,
+        label: choice.label,
+        ...(tool.supportsPermissions ? { supportsPermissions: true } : {}),
+        ...(tool.supportsYolo ? { supportsYolo: true } : {}),
+        npmPackage: choice.npmPackage,
+        ...(version ? { version } : {}),
+    };
+    if (tool.authArgs && tool.authArgs.length > 0) {
+        runAgentAuthFlow(choice.label, tool.command, tool.authArgs);
+    }
+    else {
+        console.log(`\n${bold("Next: authenticate the CLI.")}`);
+        console.log(`  Run ${cyan(choice.command)} in another terminal and follow the sign-in prompts.`);
+        console.log(`  Palmier will use the CLI on your behalf once it's signed in.`);
+    }
+    await waitForEnter("Press Enter once authentication is complete...");
+    return record;
+}
+/** Show the uninstall picker. Runs `npm uninstall -g` for the chosen agent
+ *  and returns the agent key on success, or null on cancel/failure/no candidates. */
+export async function pickAndUninstallAgent(current) {
+    const uninstallable = current.filter((a) => a.npmPackage);
+    if (uninstallable.length === 0) {
+        console.log(`\n${dim("No agents available to uninstall.")}`);
+        return null;
+    }
+    const choices = [
+        { label: "Cancel", hint: "go back" },
+        ...uninstallable.map((a) => ({
+            label: a.label,
+            hint: a.npmPackage,
+        })),
+    ];
+    const idx = await selectFromList(`\n${bold("Select an agent to uninstall:")}`, choices);
+    if (idx === null || idx === 0)
+        return null;
+    const target = uninstallable[idx - 1];
+    if (!target.npmPackage)
+        return null;
+    if (!uninstallAgentPackage(target.npmPackage))
+        return null;
+    console.log(green(`  ${target.label} uninstalled.`));
+    return target.key;
+}
+function installAgentPackage(agent) {
+    console.log(`\nInstalling ${cyan(agent.npmPackage)}...\n`);
+    const cmd = `npm install -g ${agent.npmPackage}`;
+    const result = spawnSync(cmd, { shell: true, stdio: "inherit" });
+    if (result.error) {
+        console.log(`\n${red(`Failed to run npm: ${result.error.message}`)}`);
+        console.log(`Make sure ${cyan("npm")} is on your PATH, then retry.`);
+        return false;
+    }
+    if (result.status !== 0) {
+        const exitInfo = result.signal ? `signal ${result.signal}` : `exit ${result.status}`;
+        console.log(`\n${red(`${cmd} failed (${exitInfo}).`)}`);
+        if (process.platform === "win32") {
+            console.log(`If this is a permissions error, try opening a terminal as Administrator and re-running.`);
+        }
+        else {
+            console.log(`If this is a permissions error, try running with ${cyan("sudo")} or fix your global npm prefix.`);
+        }
+        return false;
+    }
+    return true;
+}
+function uninstallAgentPackage(npmPackage) {
+    console.log(`\nUninstalling ${cyan(npmPackage)}...\n`);
+    const cmd = `npm uninstall -g ${npmPackage}`;
+    const result = spawnSync(cmd, { shell: true, stdio: "inherit" });
+    if (result.error) {
+        console.log(`\n${red(`Failed to run npm: ${result.error.message}`)}`);
+        return false;
+    }
+    if (result.status !== 0) {
+        const exitInfo = result.signal ? `signal ${result.signal}` : `exit ${result.status}`;
+        console.log(`\n${red(`${cmd} failed (${exitInfo}).`)}`);
+        return false;
+    }
+    return true;
+}
+function runAgentAuthFlow(label, command, args) {
+    const cmd = `${command} ${args.join(" ")}`;
+    console.log(`\n${bold(`Authenticating ${label}...`)} ${dim(`(${cmd})`)}\n`);
+    const result = spawnSync(cmd, { shell: true, stdio: "inherit" });
+    console.log("");
+    if (result.error) {
+        console.log(red(`Auth failed: could not run ${cmd} — ${result.error.message}`));
+        console.log(`Re-run ${cyan(cmd)} manually after this.\n`);
+        return;
+    }
+    if (result.status !== 0) {
+        const exitInfo = result.signal ? `signal ${result.signal}` : `exit ${result.status}`;
+        console.log(red(`Auth failed (${exitInfo}).`));
+        console.log(`Re-run ${cyan(cmd)} manually after this.\n`);
+        return;
+    }
+    console.log(green(`Successfully authenticated ${label}.\n`));
+}
+async function waitForEnter(message) {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    await new Promise((resolve) => rl.question(`\n${dim(message)} `, resolve));
+    rl.close();
+}

package/dist/commands/agents.d.ts

@@ -0,0 +1 @@
+export declare function agentsCommand(): Promise<void>;

package/dist/commands/agents.js

@@ -0,0 +1,59 @@
+import { loadConfig, saveConfig } from "../config.js";
+import { detectAgents } from "../agents/agent.js";
+import { colors, pickAndInstallAgent, pickAndUninstallAgent, printInstalledAgents, } from "../agents/wizard.js";
+import { selectFromList } from "../prompts.js";
+import { getPlatform } from "../platform/index.js";
+const { bold, dim, cyan } = colors;
+export async function agentsCommand() {
+    let config = null;
+    try {
+        config = loadConfig();
+    }
+    catch { /* host not yet initialized */ }
+    let agents = await detectAgents(config?.agents);
+    let dirty = false;
+    while (true) {
+        console.log(`\n${bold("=== Installed agents ===")}\n`);
+        printInstalledAgents(agents);
+        const idx = await selectFromList(`\n${bold("What would you like to do?")}`, [
+            { label: "Install an agent", hint: "add a supported CLI" },
+            { label: "Uninstall an agent", hint: "remove a supported CLI" },
+            { label: "Done", hint: "exit" },
+        ]);
+        if (idx === null || idx === 2)
+            break;
+        if (idx === 0) {
+            const installed = await pickAndInstallAgent(agents, { allowCancel: true });
+            if (installed) {
+                agents = [...agents.filter((a) => a.key !== installed.key), installed];
+                dirty = true;
+            }
+        }
+        else if (idx === 1) {
+            const removedKey = await pickAndUninstallAgent(agents);
+            if (removedKey) {
+                agents = agents.filter((a) => a.key !== removedKey);
+                dirty = true;
+            }
+        }
+        agents = await detectAgents(agents);
+    }
+    if (!dirty)
+        return;
+    if (config) {
+        config.agents = agents;
+        saveConfig(config);
+        console.log(`\nConfig saved to ${dim("~/.config/palmier/host.json")}`);
+        try {
+            await getPlatform().restartDaemon();
+            console.log(dim("Daemon restarted."));
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.log(dim(`(Daemon restart skipped: ${message})`));
+        }
+    }
+    else {
+        console.log(`\n${dim(`Run ${cyan("palmier init")} to register this host with the new agent set.`)}`);
+    }
+}

package/dist/commands/init.js

@@ -1,17 +1,12 @@
 import * as readline from "readline";
-import { spawnSync } from "child_process";
 import { loadConfig, saveConfig } from "../config.js";
-import { detectAgents, getAgent, getNpmInstalledVersion, listInstallableAgents } from "../agents/agent.js";
+import { detectAgents } from "../agents/agent.js";
+import { colors, pickAndInstallAgent, printInstalledAgents } from "../agents/wizard.js";
 import { getPlatform } from "../platform/index.js";
 import { pairCommand } from "./pair.js";
 import { detectDefaultInterface, getInterfaceIpv4 } from "../network.js";
 import { listTasks } from "../task.js";
-import { selectFromList } from "../prompts.js";
-const bold = (s) => `\x1b[1m${s}\x1b[0m`;
-const dim = (s) => `\x1b[2m${s}\x1b[0m`;
-const green = (s) => `\x1b[32m${s}\x1b[0m`;
-const cyan = (s) => `\x1b[36m${s}\x1b[0m`;
-const red = (s) => `\x1b[31m${s}\x1b[0m`;
+const { bold, dim, green, cyan, red } = colors;
 export async function initCommand() {
     console.log(`\n${bold("=== Palmier Host Setup ===")}\n`);
     console.log(`By continuing, you agree to the ${cyan("Terms of Service")} (https://www.palmier.me/terms)`);
@@ -23,18 +18,26 @@ export async function initCommand() {
     }
     catch { /* first init */ }
     let agents = await detectAgents(previousConfig?.agents);
-    logDetectedAgents(agents);
-    await offerAgentInstall(agents, () => {
-        if (previousConfig) {
-            previousConfig.agents = agents;
-            saveConfig(previousConfig);
-        }
-    });
     if (agents.length === 0) {
-        console.log(`\n${red("No agent CLIs detected.")} Palmier requires at least one supported agent CLI.\n`);
-        console.log(`See supported agents: https://www.palmier.me/agents\n`);
-        console.log(`Install at least one agent CLI, then run ${cyan("palmier init")} again.`);
-        process.exit(1);
+        console.log(`\n${red("No agent CLIs detected.")} Palmier needs at least one to run.`);
+        const installed = await pickAndInstallAgent(agents);
+        if (installed) {
+            agents = [...agents, installed];
+            if (previousConfig) {
+                previousConfig.agents = agents;
+                saveConfig(previousConfig);
+            }
+        }
+        if (agents.length === 0) {
+            console.log(`\nSee supported agents: https://www.palmier.me/agents\n`);
+            console.log(`Install at least one agent CLI, then run ${cyan("palmier init")} again.`);
+            process.exit(1);
+        }
+    }
+    else {
+        console.log(`\n${bold("Installed agents:")}`);
+        printInstalledAgents(agents);
+        console.log(`\n${dim(`Tip: run ${cyan("palmier agents")} to install more or uninstall.\n`)}`);
     }
     const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
     const ask = (q) => new Promise((resolve) => rl.question(q, resolve));
@@ -129,109 +132,6 @@ export async function initCommand() {
         throw err;
     }
 }
-async function offerAgentInstall(agents, onAgentInstalled) {
-    while (true) {
-        const detectedKeys = new Set(agents.map((a) => a.key));
-        const missing = listInstallableAgents()
-            .filter((a) => !detectedKeys.has(a.key))
-            .sort((a, b) => a.label.localeCompare(b.label));
-        if (missing.length === 0)
-            return;
-        const hasAgents = agents.length > 0;
-        const message = hasAgents
-            ? `\n${bold("Install additional agents?")} The following supported agents can be installed:`
-            : `\n${red("No agent CLIs detected.")} Palmier can install one for you via npm:`;
-        const installChoices = missing.map((a) => ({
-            label: a.freeUsage ? `${a.label} ${green(`[${a.freeUsage}]`)}` : a.label,
-            hint: `${a.npmPackage}`,
-        }));
-        const choices = hasAgents
-            ? [{ label: "No — continue to the next step ", hint: "skip installation" }, ...installChoices]
-            : installChoices;
-        const idx = await selectFromList(message, choices);
-        if (idx === null)
-            return;
-        if (hasAgents && idx === 0)
-            return;
-        const choice = missing[hasAgents ? idx - 1 : idx];
-        if (!installAgentPackage(choice))
-            return;
-        console.log(green(`  ${choice.label} installed.`));
-        // Stamp the agent record with version *before* auth so that an interrupted
-        // wizard (Ctrl+C during sign-in, etc.) still leaves the agent recorded as
-        // Palmier-managed in the persisted config on next run.
-        const tool = getAgent(choice.key);
-        const version = getNpmInstalledVersion(choice.npmPackage) ?? undefined;
-        agents.push({
-            key: choice.key,
-            label: choice.label,
-            ...(tool.supportsPermissions ? { supportsPermissions: true } : {}),
-            ...(tool.supportsYolo ? { supportsYolo: true } : {}),
-            npmPackage: choice.npmPackage,
-            ...(version ? { version } : {}),
-        });
-        onAgentInstalled?.();
-        if (tool.authArgs && tool.authArgs.length > 0) {
-            runAgentAuthFlow(choice.label, tool.command, tool.authArgs);
-        }
-        else {
-            console.log(`\n${bold("Next: authenticate the CLI.")}`);
-            console.log(`  Run ${cyan(choice.command)} in another terminal and follow the sign-in prompts.`);
-            console.log(`  Palmier will use the CLI on your behalf once it's signed in.`);
-        }
-        await waitForEnter("Press Enter once authentication is complete...");
-    }
-}
-async function waitForEnter(message) {
-    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-    await new Promise((resolve) => rl.question(`\n${dim(message)} `, resolve));
-    rl.close();
-}
-function logDetectedAgents(agents) {
-    if (agents.length === 0)
-        return;
-    console.log(`  Found: ${green(agents.map((a) => a.version ? `${a.label} v${a.version}` : a.label).join(", "))}`);
-}
-function runAgentAuthFlow(label, command, args) {
-    const cmd = `${command} ${args.join(" ")}`;
-    console.log(`\n${bold(`Authenticating ${label}...`)} ${dim(`(${cmd})`)}\n`);
-    const result = spawnSync(cmd, { shell: true, stdio: "inherit" });
-    console.log("");
-    if (result.error) {
-        console.log(red(`Auth failed: could not run ${cmd} — ${result.error.message}`));
-        console.log(`Re-run ${cyan(cmd)} manually after init finishes.\n`);
-        return;
-    }
-    if (result.status !== 0) {
-        const exitInfo = result.signal ? `signal ${result.signal}` : `exit ${result.status}`;
-        console.log(red(`Auth failed (${exitInfo}).`));
-        console.log(`Re-run ${cyan(cmd)} manually after init finishes.\n`);
-        return;
-    }
-    console.log(green(`Successfully authenticated ${label}.\n`));
-}
-function installAgentPackage(agent) {
-    console.log(`\nInstalling ${cyan(agent.npmPackage)}...\n`);
-    const cmd = `npm install -g ${agent.npmPackage}`;
-    const result = spawnSync(cmd, { shell: true, stdio: "inherit" });
-    if (result.error) {
-        console.log(`\n${red(`Failed to run npm: ${result.error.message}`)}`);
-        console.log(`Make sure ${cyan("npm")} is on your PATH, then retry.`);
-        return false;
-    }
-    if (result.status !== 0) {
-        const exitInfo = result.signal ? `signal ${result.signal}` : `exit ${result.status}`;
-        console.log(`\n${red(`${cmd} failed (${exitInfo}).`)}`);
-        if (process.platform === "win32") {
-            console.log(`If this is a permissions error, try opening a terminal as Administrator and re-running ${cyan("palmier init")}.`);
-        }
-        else {
-            console.log(`If this is a permissions error, try running with ${cyan("sudo")} or fix your global npm prefix.`);
-        }
-        return false;
-    }
-    return true;
-}
 async function registerHost(serverUrl, existingHostId) {
     try {
         const res = await fetch(`${serverUrl}/api/hosts/register`, {

package/dist/index.js

@@ -11,6 +11,7 @@ import { serveCommand } from "./commands/serve.js";
 import { pairCommand } from "./commands/pair.js";
 import { restartCommand } from "./commands/restart.js";
 import { clientsListCommand, clientsRevokeCommand, clientsRevokeAllCommand } from "./commands/clients.js";
+import { agentsCommand } from "./commands/agents.js";
 import { uninstallCommand } from "./commands/uninstall.js";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const pkg = JSON.parse(readFileSync(join(__dirname, "../package.json"), "utf-8"));
@@ -76,6 +77,12 @@ clientsCmd
     .action(async () => {
     await clientsRevokeAllCommand();
 });
+program
+    .command("agents")
+    .description("List, install, and uninstall agent CLIs")
+    .action(async () => {
+    await agentsCommand();
+});
 program
     .command("uninstall")
     .description("Stop the daemon and remove all scheduled tasks")