palmier 1.0.3 → 1.0.5

package/README.md

@@ -179,6 +179,7 @@ palmier passwords clear
 The wizard:
 - Detects installed agent CLIs and caches the result; agents previously installed by Palmier have their installed version re-probed so the recorded version stays in sync with manual upgrades
 - Offers to install missing supported agents from npm (one at a time, arrow-key menu). After each install the agent's version is stamped (becoming "Palmier-managed"), the wizard kicks off authentication, and waits for you to press Enter before offering the next install. On re-init, the agents list is saved after every install so an interrupted wizard is resumable.
+- Offers to install the **Playwright CLI** for browser automation (see [Browser Automation](#browser-automation)). Skipped on re-init if it's already managed.
 - Asks for the HTTP port
 - Detects the default network interface (used for auto-LAN)
 - Shows a summary (including any existing scheduled tasks to recover) and asks for confirmation
@@ -200,10 +201,19 @@ Agents installed by the user outside the wizard (e.g., `npm install -g <pkg>` di
 
 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.
 
+### Browser Automation
+
+Some capabilities (like the [saved-password autofill](#saved-passwords)) drive a real browser through the [`playwright-cli`](https://www.npmjs.com/package/@playwright/cli) skill. `palmier init` offers to install and manage the Playwright CLI (`@playwright/cli`) for this, and on install also runs `playwright-cli install --skills` in your Palmier task directory (`~/palmier`) so agents get the Playwright skills that teach them how to drive the browser. When you opt in, Palmier manages it **just like an agent CLI** — the version is stamped, re-probed live on each daemon start, and the PWA shows a "Browser Automation Update Available" dialog (same flow as agents) when a newer version is published. Its version is shown in the app's host drawer. The browser binaries Playwright needs are downloaded lazily on first use, not during init.
+
+Unlike agents, the Playwright CLI has **no explicit uninstall** — it's not offered in any uninstall picker. It is removed only by a full `palmier uninstall`.
+
 ### 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.
-- **Palmier-managed agents** — same flow per agent: when npm publishes a newer version, the PWA shows an "Agent Update Available" dialog. Clicking "Update Now" runs `npm update -g <pkg>` on the host (no daemon restart needed). Dismissals are per host, per agent, per version.
+- **Palmier itself** — when a newer version of `palmier` is published to npm, the PWA shows an "Update Available" dialog. Clicking "Update Now" runs `npm update -g palmier` on the host and restarts the daemon. Clicking "Dismiss" only hides it for the current session — reopening or reloading the app shows it again until you update.
+- **Palmier-managed agents** — same flow per agent: when npm publishes a newer version, the PWA shows an "Agent Update Available" dialog. Clicking "Update Now" runs `npm update -g <pkg>` on the host (no daemon restart needed).
+- **Managed Playwright CLI** — same flow: a "Browser Automation Update Available" dialog runs `npm update -g @playwright/cli`.
+
+Dismissals are session-only: they are never persisted, so a reload re-arms every update dialog until the update is applied.
 
 ### Re-detecting the LAN Network
 
@@ -226,7 +236,7 @@ The default network interface is detected once during `palmier init` and saved t
 | `palmier serve` | Run the persistent RPC handler (default command) |
 | `palmier restart` | Restart the palmier serve daemon |
 | `palmier run <task-id>` | Execute a specific task |
-| `palmier uninstall` | Stop daemon, remove all scheduled tasks, and uninstall Palmier-managed agent CLIs |
+| `palmier uninstall` | Stop daemon, remove all scheduled tasks, and uninstall Palmier-managed agent CLIs and the managed Playwright CLI |
 
 ## Uninstalling
 
@@ -234,7 +244,7 @@ To fully remove Palmier from a machine:
 
 1. **Unpair your device** in the PWA (via the host menu).
 
-2. **Stop the daemon, remove all scheduled tasks, and uninstall Palmier-managed agent CLIs:**
+2. **Stop the daemon, remove all scheduled tasks, and uninstall Palmier-managed agent CLIs and the managed Playwright CLI:**
 
    ```bash
    palmier uninstall

package/dist/agents/agent.js

@@ -16,6 +16,7 @@ import { kiroAgent } from "./kiro.js";
 import { clineAgent } from "./cline.js";
 import { qoderAgent } from "./qoder.js";
 import { hermesAgent } from "./hermes.js";
+import { grokAgent } from "./grok.js";
 export function getPromptCommandLine(agent, prompt) {
     return { args: [...agent.promptArgs, prompt] };
 }
@@ -70,6 +71,7 @@ const agentRegistry = {
     cline: clineAgent,
     qoder: qoderAgent,
     hermes: hermesAgent,
+    grok: grokAgent,
 };
 const TIER_ONE_ORDER = ["claude", "codex", "copilot"];
 export function listInstallableAgents() {

package/dist/agents/claude.js

@@ -14,7 +14,7 @@ export const claudeAgent = {
         const prompt = followupPrompt ?? getAgentInstructions(task);
         const args = ["--permission-mode", yolo ? "bypassPermissions" : "acceptEdits", "-p"];
         if (!yolo) {
-            args.push("--allowedTools", "Bash(curl)", "WebFetch");
+            args.push("--allowedTools", "WebFetch", "Skill(playwright-cli:*)", "Bash(curl:*)", "Bash(wget:*)", "Bash(playwright:*)", "Bash(playwright-cli:*)");
             const allPerms = [...(task.frontmatter.permissions ?? []), ...(extraPermissions ?? [])];
             for (const p of allPerms) {
                 args.push(p.name);
@@ -23,6 +23,15 @@ export const claudeAgent = {
         if (followupPrompt) {
             args.push("-c");
         }
-        return { args, stdin: prompt };
+        return {
+            args,
+            stdin: prompt,
+            // Don't let the Bash tool kill the curl that blocks on user input — the
+            // user may take arbitrarily long to answer. Max non-overflowing setTimeout.
+            env: {
+                BASH_DEFAULT_TIMEOUT_MS: "2147483647",
+                BASH_MAX_TIMEOUT_MS: "2147483647",
+            },
+        };
     },
 };

package/dist/agents/grok.d.ts

@@ -0,0 +1,2 @@
+import type { AgentTool } from "./agent.js";
+export declare const grokAgent: AgentTool;

package/dist/agents/grok.js

@@ -0,0 +1,21 @@
+import { getAgentInstructions } from "./shared-prompt.js";
+export const grokAgent = {
+    label: "Grok Build",
+    command: "grok",
+    promptArgs: ["-p"],
+    probeArg: "--version",
+    supportsYolo: true,
+    getTaskRunCommandLine(task, followupPrompt, extraPermissions) {
+        const yolo = extraPermissions === "yolo";
+        const prompt = followupPrompt ?? getAgentInstructions(task);
+        const args = [];
+        if (yolo) {
+            args.push("--always-approve");
+        }
+        if (followupPrompt) {
+            args.push("-c");
+        }
+        args.push("-p", prompt);
+        return { args };
+    },
+};

package/dist/agents/wizard.d.ts

@@ -25,4 +25,10 @@ export declare function pickAndUninstallAgent(current: DetectedAgent[]): Promise
  *  Shared between the `palmier agents` interactive picker and the bulk
  *  managed-agent removal in `palmier uninstall`. */
 export declare function uninstallAgent(agent: DetectedAgent): boolean;
+/** `npm install -g <pkg>`. Shared by the agent installer and the Playwright CLI
+ *  tool manager. Logs progress and a permissions hint on failure. */
+export declare function npmInstallGlobal(npmPackage: string): boolean;
 export declare function uninstallManagedAgents(agents: DetectedAgent[]): void;
+/** `npm uninstall -g <pkg>`. Shared by the agent uninstaller and the Playwright
+ *  CLI tool manager (the latter only via `palmier uninstall`, never a picker). */
+export declare function npmUninstallGlobal(npmPackage: string): boolean;

package/dist/agents/wizard.js

@@ -105,16 +105,18 @@ export async function pickAndUninstallAgent(current) {
 export function uninstallAgent(agent) {
     if (!agent.npmPackage)
         return false;
-    if (!uninstallAgentPackage(agent.npmPackage)) {
+    if (!npmUninstallGlobal(agent.npmPackage)) {
         console.log(red(`  Skipped ${agent.label}; uninstall it manually with npm uninstall -g ${agent.npmPackage}.`));
         return false;
     }
     console.log(green(`  ${agent.label} uninstalled.`));
     return true;
 }
-function installAgentPackage(agent) {
-    console.log(`\nInstalling ${cyan(agent.npmPackage)}...\n`);
-    const cmd = `npm install -g ${agent.npmPackage}`;
+/** `npm install -g <pkg>`. Shared by the agent installer and the Playwright CLI
+ *  tool manager. Logs progress and a permissions hint on failure. */
+export function npmInstallGlobal(npmPackage) {
+    console.log(`\nInstalling ${cyan(npmPackage)}...\n`);
+    const cmd = `npm install -g ${npmPackage}`;
     const result = spawnSync(cmd, { shell: true, stdio: "inherit" });
     if (result.error) {
         console.log(`\n${red(`Failed to run npm: ${result.error.message}`)}`);
@@ -134,6 +136,9 @@ function installAgentPackage(agent) {
     }
     return true;
 }
+function installAgentPackage(agent) {
+    return npmInstallGlobal(agent.npmPackage);
+}
 export function uninstallManagedAgents(agents) {
     const managed = agents.filter((a) => a.version && a.npmPackage);
     if (managed.length === 0) {
@@ -156,7 +161,9 @@ export function uninstallManagedAgents(agents) {
         console.log(`\n${yellow(`Uninstalled ${succeeded} of ${managed.length} agent CLIs (${failed} skipped).`)}`);
     }
 }
-function uninstallAgentPackage(npmPackage) {
+/** `npm uninstall -g <pkg>`. Shared by the agent uninstaller and the Playwright
+ *  CLI tool manager (the latter only via `palmier uninstall`, never a picker). */
+export function npmUninstallGlobal(npmPackage) {
     console.log(`\nUninstalling ${cyan(npmPackage)}...\n`);
     const cmd = `npm uninstall -g ${npmPackage}`;
     const result = spawnSync(cmd, { shell: true, stdio: "inherit" });

package/dist/commands/info.js

@@ -1,6 +1,7 @@
 import { loadConfig } from "../config.js";
 import { loadClients } from "../client-store.js";
 import { buildLanUrl } from "../network.js";
+import { PLAYWRIGHT_CLI_LABEL } from "../playwright-cli.js";
 export async function infoCommand() {
     const config = loadConfig();
     const clients = loadClients();
@@ -16,6 +17,9 @@ export async function infoCommand() {
     else {
         console.log(`Agents:       (none detected — run \`palmier agents\`)`);
     }
+    if (config.playwrightCliVersion) {
+        console.log(`Browser:      ${PLAYWRIGHT_CLI_LABEL} (v${config.playwrightCliVersion})`);
+    }
     console.log(`Clients:      ${clients.length} active`);
     if (clients.length === 0) {
         console.log("");

package/dist/commands/init.js

@@ -5,6 +5,7 @@ import { homedir } from "os";
 import { loadConfig, saveConfig } from "../config.js";
 import { detectAgents } from "../agents/agent.js";
 import { colors, pickAndInstallAgent, printInstalledAgents } from "../agents/wizard.js";
+import { installPlaywrightCli, installPlaywrightSkills, getPlaywrightCliVersion, PLAYWRIGHT_CLI_LABEL } from "../playwright-cli.js";
 import { getPlatform } from "../platform/index.js";
 import { pairCommand } from "./pair.js";
 import { detectDefaultInterface, getInterfaceIpv4 } from "../network.js";
@@ -47,6 +48,24 @@ export async function initCommand() {
     const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
     const ask = (q) => new Promise((resolve) => rl.question(q, resolve));
     try {
+        // Browser automation is optional. Palmier manages the Playwright CLI like an
+        // agent CLI (install, version-stamp, update) once the user opts in. Trust the
+        // actual global install, not just the saved marker: `palmier uninstall`
+        // removes the package but leaves host.json, so a stale playwrightCliVersion
+        // must not suppress the prompt.
+        let playwrightCliVersion = previousConfig?.playwrightCliVersion
+            ? getPlaywrightCliVersion() ?? undefined
+            : undefined;
+        if (!playwrightCliVersion) {
+            const answer = (await ask(`\nInstall ${PLAYWRIGHT_CLI_LABEL} for browser automation? Lets agents control a browser — e.g. autofill saved passwords. (Y/n): `)).trim().toLowerCase();
+            if (answer !== "n" && answer !== "no") {
+                if (installPlaywrightCli()) {
+                    playwrightCliVersion = getPlaywrightCliVersion() ?? undefined;
+                    console.log(green(`  ${PLAYWRIGHT_CLI_LABEL} installed.`));
+                    installPlaywrightSkills(projectRoot);
+                }
+            }
+        }
         let httpPort = 7256;
         const portAnswer = await ask(`HTTP port (default ${httpPort}): `);
         const parsed = parseInt(portAnswer.trim(), 10);
@@ -72,6 +91,9 @@ export async function initCommand() {
         console.log(`  ${dim("Remote (web):")}   ${cyan("https://app.palmier.me")}`);
         console.log(`                  Pair a browser on any device. Traffic always goes through the relay.\n`);
         console.log(`  ${dim("Agents:")}         ${agents.map((a) => a.version ? `${a.label} v${a.version}` : a.label).join(", ")}\n`);
+        if (playwrightCliVersion) {
+            console.log(`  ${dim("Browser:")}        ${PLAYWRIGHT_CLI_LABEL} v${playwrightCliVersion}\n`);
+        }
         const existingTasks = listTasks(projectRoot);
         if (existingTasks.length > 0) {
             console.log(`  ${dim("Recover tasks:")}  ${existingTasks.length} existing task(s) found:`);
@@ -114,6 +136,7 @@ export async function initCommand() {
             natsJwt: registerResponse.natsJwt,
             natsNkeySeed: registerResponse.natsNkeySeed,
             agents,
+            ...(playwrightCliVersion ? { playwrightCliVersion } : {}),
             httpPort,
             defaultInterface,
         };

package/dist/commands/serve.js

@@ -9,6 +9,7 @@ import { getTaskDir, readTaskStatus, writeTaskStatus, parseTaskFile, appendRunMe
 import { publishHostEvent } from "../events.js";
 import { getPlatform } from "../platform/index.js";
 import { detectAgents } from "../agents/agent.js";
+import { getPlaywrightCliVersion } from "../playwright-cli.js";
 import { saveConfig } from "../config.js";
 import { CONFIG_DIR } from "../config.js";
 import { StringCodec } from "nats";
@@ -102,6 +103,12 @@ export async function serveCommand() {
     console.log(`Starting Palmier daemon v${currentVersion}...`);
     const agents = await detectAgents(config.agents);
     config.agents = agents;
+    // Keep the managed Playwright CLI version in sync with manual upgrades, and
+    // drop the marker if the package was removed out-of-band. Only touched when
+    // Palmier already manages it.
+    if (config.playwrightCliVersion) {
+        config.playwrightCliVersion = getPlaywrightCliVersion() ?? undefined;
+    }
     saveConfig(config);
     console.log(`Detected agents: ${agents.map((a) => a.key).join(", ") || "none"}`);
     let nc;

package/dist/commands/uninstall.js

@@ -1,6 +1,7 @@
 import { getPlatform } from "../platform/index.js";
 import { loadConfig } from "../config.js";
 import { uninstallManagedAgents } from "../agents/wizard.js";
+import { uninstallPlaywrightCli, PLAYWRIGHT_CLI_LABEL } from "../playwright-cli.js";
 export async function uninstallCommand() {
     console.log("Stopping daemon and removing scheduled tasks...");
     const platform = getPlatform();
@@ -14,6 +15,10 @@ export async function uninstallCommand() {
     if (config?.agents) {
         uninstallManagedAgents(config.agents);
     }
+    if (config?.playwrightCliVersion) {
+        console.log(`\nUninstalling ${PLAYWRIGHT_CLI_LABEL}...`);
+        uninstallPlaywrightCli();
+    }
     console.log("\nUninstall finished.");
     console.log("To remove the palmier package itself: npm uninstall -g palmier");
     console.log("To also remove configuration and task data, see https://github.com/caihongxu/palmier#uninstalling");

package/dist/playwright-cli.d.ts

@@ -0,0 +1,15 @@
+/** Palmier-managed browser-automation tool. Managed like an agent CLI (install,
+ *  version-stamp, re-probe, PWA update prompt) but never offered for explicit
+ *  uninstall — it's only removed by `palmier uninstall`. */
+export declare const PLAYWRIGHT_CLI_PACKAGE = "@playwright/cli";
+export declare const PLAYWRIGHT_CLI_COMMAND = "playwright-cli";
+export declare const PLAYWRIGHT_CLI_LABEL = "Playwright CLI";
+/** Installed global version, or null when not installed. Doubles as the
+ *  "is it installed" check (mirrors how agents resolve their version). */
+export declare function getPlaywrightCliVersion(): string | null;
+export declare function installPlaywrightCli(): boolean;
+/** Install the Playwright agent skills so agent CLIs know how to drive the
+ *  browser. Runs in `cwd` (the Palmier task directory) so the skills land where
+ *  agents execute. Best-effort: a failure leaves the CLI installed and managed. */
+export declare function installPlaywrightSkills(cwd: string): boolean;
+export declare function uninstallPlaywrightCli(): boolean;

package/dist/playwright-cli.js

@@ -0,0 +1,32 @@
+import { spawnSync } from "child_process";
+import { getNpmInstalledVersion } from "./agents/agent.js";
+import { npmInstallGlobal, npmUninstallGlobal } from "./agents/wizard.js";
+/** Palmier-managed browser-automation tool. Managed like an agent CLI (install,
+ *  version-stamp, re-probe, PWA update prompt) but never offered for explicit
+ *  uninstall — it's only removed by `palmier uninstall`. */
+export const PLAYWRIGHT_CLI_PACKAGE = "@playwright/cli";
+export const PLAYWRIGHT_CLI_COMMAND = "playwright-cli";
+export const PLAYWRIGHT_CLI_LABEL = "Playwright CLI";
+/** Installed global version, or null when not installed. Doubles as the
+ *  "is it installed" check (mirrors how agents resolve their version). */
+export function getPlaywrightCliVersion() {
+    return getNpmInstalledVersion(PLAYWRIGHT_CLI_PACKAGE);
+}
+export function installPlaywrightCli() {
+    return npmInstallGlobal(PLAYWRIGHT_CLI_PACKAGE);
+}
+/** Install the Playwright agent skills so agent CLIs know how to drive the
+ *  browser. Runs in `cwd` (the Palmier task directory) so the skills land where
+ *  agents execute. Best-effort: a failure leaves the CLI installed and managed. */
+export function installPlaywrightSkills(cwd) {
+    console.log(`\nInstalling Playwright skills...\n`);
+    const result = spawnSync(`${PLAYWRIGHT_CLI_COMMAND} install --skills`, { cwd, shell: true, stdio: "inherit" });
+    if (result.error || result.status !== 0) {
+        console.log(`\nCould not install Playwright skills. Run \`${PLAYWRIGHT_CLI_COMMAND} install --skills\` manually.`);
+        return false;
+    }
+    return true;
+}
+export function uninstallPlaywrightCli() {
+    return npmUninstallGlobal(PLAYWRIGHT_CLI_PACKAGE);
+}