palmier 1.0.3 → 1.0.4

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,17 @@ 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. 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.
+- **Managed Playwright CLI** — same flow: a "Browser Automation Update Available" dialog runs `npm update -g @playwright/cli`. Dismissals are per host, per version.
 
 ### Re-detecting the LAN Network
 
@@ -226,7 +234,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 +242,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);

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/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, 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,22 @@ 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; an
+        // already-managed install is re-probed rather than re-prompted.
+        let playwrightCliVersion = previousConfig?.playwrightCliVersion;
+        if (playwrightCliVersion) {
+            playwrightCliVersion = getPlaywrightCliVersion() ?? playwrightCliVersion;
+        }
+        else {
+            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.`));
+                }
+            }
+        }
         let httpPort = 7256;
         const portAnswer = await ask(`HTTP port (default ${httpPort}): `);
         const parsed = parseInt(portAnswer.trim(), 10);
@@ -72,6 +89,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 +134,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,11 @@ 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, same
+    // as agents. Only touched when Palmier already manages it.
+    if (config.playwrightCliVersion) {
+        config.playwrightCliVersion = getPlaywrightCliVersion() ?? config.playwrightCliVersion;
+    }
     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,10 @@
+/** 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_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;
+export declare function uninstallPlaywrightCli(): boolean;

package/dist/playwright-cli.js

@@ -0,0 +1,18 @@
+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_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);
+}
+export function uninstallPlaywrightCli() {
+    return npmUninstallGlobal(PLAYWRIGHT_CLI_PACKAGE);
+}

package/dist/rpc-handler.js

@@ -11,6 +11,7 @@ import { validateClient, revokeClient } from "./client-store.js";
 import { publishHostEvent } from "./events.js";
 import { getLinkedDevice, setLinkedDevice, clearLinkedDevice, clearLinkedDeviceIfMatches } from "./linked-device.js";
 import { currentVersion, performUpdate, performAgentUpdate } from "./update-checker.js";
+import { PLAYWRIGHT_CLI_PACKAGE, PLAYWRIGHT_CLI_LABEL } from "./playwright-cli.js";
 import { saveConfig } from "./config.js";
 import { parseReportFiles, parseTaskOutcome, stripPalmierMarkers } from "./commands/run.js";
 import { clearTaskQueue } from "./event-queues.js";
@@ -185,6 +186,9 @@ export function createRpcHandler(config, nc) {
                     linked_client_token: getLinkedDevice()?.clientToken ?? null,
                     pending_prompts: listPending(),
                     lan_url: buildLanUrl(config.httpPort ?? 7256, config.defaultInterface),
+                    playwright_cli: config.playwrightCliVersion
+                        ? { label: PLAYWRIGHT_CLI_LABEL, npmPackage: PLAYWRIGHT_CLI_PACKAGE, version: config.playwrightCliVersion }
+                        : null,
                 };
             }
             case "task.list": {
@@ -663,6 +667,18 @@ export function createRpcHandler(config, nc) {
                 saveConfig(config);
                 return { ok: true, version: newVersion ?? entry.version };
             }
+            case "host.updatePlaywrightCli": {
+                if (!config.playwrightCliVersion)
+                    return { error: "Playwright CLI is not managed by Palmier" };
+                const error = await performAgentUpdate(PLAYWRIGHT_CLI_PACKAGE);
+                if (error)
+                    return { error };
+                const newVersion = getNpmInstalledVersion(PLAYWRIGHT_CLI_PACKAGE);
+                if (newVersion)
+                    config.playwrightCliVersion = newVersion;
+                saveConfig(config);
+                return { ok: true, version: newVersion ?? config.playwrightCliVersion };
+            }
             case "device.link": {
                 const params = request.params;
                 if (!params.fcmToken)

package/dist/types.d.ts

@@ -14,6 +14,9 @@ export interface HostConfig {
         /** Runtime marker for "managed by Palmier" — present iff Palmier installed/manages this agent. */
         version?: string;
     }>;
+    /** Installed version of the Palmier-managed Playwright CLI (`@playwright/cli`).
+     * Present iff Palmier manages it; mirrors the agents' `version` marker. */
+    playwrightCliVersion?: string;
     httpPort?: number;
     /** OS network interface name of the IPv4 default route, captured on the
      * most recent `palmier pair`. Used to resolve the host's LAN URL live for

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "palmier",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "Palmier host CLI - provisions, executes tasks, and serves NATS RPC",
   "license": "Apache-2.0",
   "author": "Hongxu Cai",