palmier 0.2.4 → 0.2.5

package/README.md

@@ -8,9 +8,9 @@ The host supports three connection modes:
 
 | Mode | Transport | Setup | Features |
 |------|-----------|-------|----------|
-| **`nats`** | NATS only | `palmier init --server <url>` → select nats | All features |
-| **`auto`** | Both NATS + HTTP | `palmier init --server <url>` → select auto | All features. PWA auto-detects best route. |
-| **`lan`** | HTTP only | `palmier init --lan` | No push notifications or email MCP. No server needed. |
+| **`nats`** | NATS only | `palmier init` → Full access, skip LAN | All features |
+| **`auto`** | Both NATS + HTTP | `palmier init` → Full access + LAN | All features. PWA auto-detects best route. |
+| **`lan`** | HTTP only | `palmier init` → LAN only | No push notifications or email MCP. No server needed. |
 
 In **auto** mode, the PWA connects directly to the host via HTTP when on the same LAN (lower latency), and falls back to NATS when the host is unreachable. Push notifications and email relay always flow through NATS/server, so no features are lost.
 
@@ -32,8 +32,7 @@ npm install -g palmier
 
 | Command | Description |
 |---|---|
-| `palmier init --server <url>` | Provision the host via the server (prompts for nats/auto mode) |
-| `palmier init --lan` | Provision standalone LAN host (no server needed) |
+| `palmier init` | Interactive setup wizard (full access or LAN only) |
 | `palmier pair` | Generate an OTP code to pair a new device |
 | `palmier sessions list` | List active session tokens |
 | `palmier sessions revoke <token>` | Revoke a specific session token |
@@ -46,20 +45,17 @@ npm install -g palmier
 
 ## Setup
 
-### Server-provisioned (nats or auto mode)
+### Quick Start
 
 1. Install the host: `npm install -g palmier`
-2. Run `palmier init --server https://your-server-url` in your project directory.
-3. Select connection mode: `auto` (recommended) or `nats`.
-4. The host registers with the server, saves config, installs a systemd service, and generates a pairing code.
+2. Run `palmier init` in your project directory.
+3. The wizard walks you through:
+   - **Full access** or **LAN only** mode
+   - Server URL (for full access, defaults to `https://www.palmier.me`)
+   - Optional LAN access (for full access — auto-detects best route when enabled)
+4. The host saves config, installs a systemd service, and generates a pairing code.
 5. Enter the pairing code in the Palmier PWA to connect your device.
 
-### Standalone LAN mode
-
-1. Install the host: `npm install -g palmier`
-2. Run `palmier init --lan` in your project directory.
-3. A pairing code and address are displayed. Enter both in the PWA.
-
 ### Pairing additional devices
 
 Run `palmier pair` on the host to generate a new OTP code. Each paired device gets its own session token.
@@ -142,7 +138,7 @@ src/
     codex.ts          # Codex CLI agent implementation
     openclaw.ts       # OpenClaw agent implementation
   commands/
-    init.ts           # Provisioning logic (--server and --lan flows, auto-pair)
+    init.ts           # Interactive setup wizard (auto-pair)
     pair.ts           # OTP code generation and pairing handler
     sessions.ts       # Session token management CLI (list, revoke, revoke-all)
     info.ts           # Print host connection info

package/dist/agents/claude.js

@@ -1,5 +1,8 @@
 import { execSync } from "child_process";
 import { TASK_OUTCOME_SUFFIX } from "./shared-prompt.js";
+// execSync's shell option takes a string (shell path), not boolean.
+// On Windows we need a shell so .cmd shims resolve correctly.
+const SHELL = process.platform === "win32" ? "cmd.exe" : undefined;
 export class ClaudeAgent {
     getPlanGenerationCommandLine(prompt) {
         return {
@@ -18,13 +21,13 @@ export class ClaudeAgent {
     }
     async init() {
         try {
-            execSync("claude --version");
+            execSync("claude --version", { shell: SHELL });
         }
         catch {
             return false;
         }
         try {
-            execSync("claude mcp add --transport stdio palmier --scope user -- palmier mcpserver");
+            execSync("claude mcp add --transport stdio palmier --scope user -- palmier mcpserver", { shell: SHELL });
         }
         catch (err) {
             console.warn("Warning: failed to install MCP for Claude:", err instanceof Error ? err.message : err);

package/dist/agents/codex.js

@@ -1,5 +1,7 @@
 import { execSync } from "child_process";
 import { TASK_OUTCOME_SUFFIX } from "./shared-prompt.js";
+// On Windows we need a shell so .cmd shims resolve correctly.
+const SHELL = process.platform === "win32" ? "cmd.exe" : undefined;
 export class CodexAgent {
     getPlanGenerationCommandLine(prompt) {
         // TODO: fill in
@@ -24,13 +26,13 @@ export class CodexAgent {
     }
     async init() {
         try {
-            execSync("codex --version");
+            execSync("codex --version", { shell: SHELL });
         }
         catch {
             return false;
         }
         try {
-            execSync("codex mcp add palmier palmier mcpserver");
+            execSync("codex mcp add palmier palmier mcpserver", { shell: SHELL });
         }
         catch (err) {
             console.warn("Warning: failed to install MCP for Codex:", err instanceof Error ? err.message : err);

package/dist/agents/gemini.js

@@ -1,5 +1,7 @@
 import { execSync } from "child_process";
 import { TASK_OUTCOME_SUFFIX } from "./shared-prompt.js";
+// On Windows we need a shell so .cmd shims resolve correctly.
+const SHELL = process.platform === "win32" ? "cmd.exe" : undefined;
 export class GeminiAgent {
     getPlanGenerationCommandLine(prompt) {
         // TODO: fill in
@@ -22,13 +24,13 @@ export class GeminiAgent {
     }
     async init() {
         try {
-            execSync("gemini --version");
+            execSync("gemini --version", { shell: SHELL });
         }
         catch {
             return false;
         }
         try {
-            execSync("gemini mcp add --scope user palmier palmier mcpserver");
+            execSync("gemini mcp add --scope user palmier palmier mcpserver", { shell: SHELL });
         }
         catch (err) {
             console.warn("Warning: failed to install MCP for Gemini:", err instanceof Error ? err.message : err);

package/dist/commands/info.js

@@ -1,5 +1,6 @@
 import * as os from "os";
 import { loadConfig } from "../config.js";
+import { loadSessions } from "../session-store.js";
 /**
  * Detect the first non-internal IPv4 address.
  */
@@ -20,21 +21,27 @@ function detectLanIp() {
 export async function infoCommand() {
     const config = loadConfig();
     const mode = config.mode ?? "nats";
-    console.log(`Mode:    ${mode}`);
-    console.log(`Host ID: ${config.hostId}`);
+    const sessions = loadSessions();
+    console.log(`Host ID:      ${config.hostId}`);
+    console.log(`Mode:         ${mode}`);
+    console.log(`Project root: ${config.projectRoot}`);
     if (mode === "lan" || mode === "auto") {
         const lanIp = detectLanIp();
         const port = config.directPort ?? 7400;
-        console.log("");
-        console.log("Direct connection info:");
-        console.log(`  Address: ${lanIp}:${port}`);
-        console.log(`  Token:   ${config.directToken}`);
+        console.log(`LAN address:  ${lanIp}:${port}`);
+    }
+    // Detected agents
+    if (config.agents && config.agents.length > 0) {
+        console.log(`Agents:       ${config.agents.map((a) => a.label).join(", ")}`);
+    }
+    else {
+        console.log(`Agents:       (none detected — run \`palmier agents\`)`);
     }
-    if (mode === "nats" || mode === "auto") {
+    // Sessions
+    console.log(`Sessions:     ${sessions.length} active`);
+    if (sessions.length === 0) {
         console.log("");
-        console.log("NATS connection info:");
-        console.log(`  URL:   ${config.natsUrl}`);
-        console.log(`  WS:    ${config.natsWsUrl}`);
+        console.log("No paired clients. Run `palmier pair` to connect a device.");
     }
 }
 //# sourceMappingURL=info.js.map

package/dist/commands/init.d.ts

@@ -1,13 +1,5 @@
-export interface InitOptions {
-    server?: string;
-    lan?: boolean;
-    host?: string;
-    port?: number;
-}
 /**
- * Provision this host. Two flows:
- *   - palmier init --lan              → standalone LAN mode, no server needed
- *   - palmier init --server <url>     → register with server, prompts for nats/auto mode
+ * Interactive wizard to provision this host.
  */
-export declare function initCommand(options: InitOptions): Promise<void>;
+export declare function initCommand(): Promise<void>;
 //# sourceMappingURL=init.d.ts.map

package/dist/commands/init.js

@@ -1,63 +1,91 @@
-import * as fs from "fs";
-import * as path from "path";
-import * as os from "os";
 import * as readline from "readline";
 import { randomUUID, randomBytes } from "crypto";
-import { execSync } from "child_process";
-import { homedir } from "os";
 import { saveConfig } from "../config.js";
 import { detectAgents } from "../agents/agent.js";
+import { detectLanIp } from "../transports/http-transport.js";
+import { getPlatform } from "../platform/index.js";
 import { pairCommand } from "./pair.js";
 /**
- * Provision this host. Two flows:
- *   - palmier init --lan              → standalone LAN mode, no server needed
- *   - palmier init --server <url>     → register with server, prompts for nats/auto mode
+ * Interactive wizard to provision this host.
  */
-export async function initCommand(options) {
-    if (options.lan) {
-        await initLan(options);
-    }
-    else if (options.server) {
-        await initWithServer(options);
+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 {
+        console.log("\n=== Palmier Host Setup ===\n");
+        let step = 1;
+        // Step 1: Access mode
+        const accessMode = await promptAccessMode(ask, step++);
+        let registerResponse;
+        if (accessMode === "full") {
+            // Step 2: Server URL
+            const serverUrl = await promptServerUrl(ask, step++);
+            // Register with server
+            console.log(`\nRegistering host with ${serverUrl}...`);
+            registerResponse = await registerHost(serverUrl);
+            console.log("Host registered successfully.");
+        }
+        let enableLan = accessMode === "lan";
+        if (accessMode === "full") {
+            // Step N: Optional LAN
+            enableLan = await promptEnableLan(ask, step++);
+        }
+        // Determine mode
+        const mode = accessMode === "lan" ? "lan" : enableLan ? "auto" : "nats";
+        // Build config
+        const config = {
+            hostId: registerResponse?.hostId ?? randomUUID(),
+            projectRoot: process.cwd(),
+            mode,
+        };
+        if (registerResponse) {
+            config.natsUrl = registerResponse.natsUrl;
+            config.natsWsUrl = registerResponse.natsWsUrl;
+            config.natsToken = registerResponse.natsToken;
+        }
+        if (enableLan) {
+            setupLan(config, step++);
+        }
+        console.log("\nDetecting installed agents...");
+        config.agents = await detectAgents();
+        saveConfig(config);
+        console.log(`\nHost provisioned (${mode} mode). ID: ${config.hostId}`);
+        console.log("Config saved to ~/.config/palmier/host.json");
+        getPlatform().installDaemon(config);
+        console.log("\nStarting pairing...");
+        rl.close();
+        await pairCommand();
     }
-    else {
-        console.error("Either --lan or --server <url> is required.");
-        process.exit(1);
+    catch (err) {
+        rl.close();
+        throw err;
     }
 }
-/**
- * Flow A: Standalone LAN mode. No web server needed.
- */
-async function initLan(options) {
-    const hostId = randomUUID();
-    const directToken = randomBytes(32).toString("hex");
-    const directPort = options.port ?? 7400;
-    const lanIp = options.host ?? detectLanIp();
-    const config = {
-        hostId,
-        mode: "lan",
-        directPort,
-        directToken,
-        projectRoot: process.cwd(),
-    };
-    console.log("Detecting installed agents...");
-    config.agents = await detectAgents();
-    saveConfig(config);
-    console.log(`Host provisioned (LAN mode). ID: ${hostId}`);
-    console.log("Config saved to ~/.config/palmier/host.json");
-    installSystemdService(config);
-    // Auto-enter pair mode so user can connect their PWA immediately
+async function promptAccessMode(ask, step) {
+    console.log(`Step ${step}: Choose access mode\n`);
+    console.log("  1) Full access  — built-in email and push notification support");
+    console.log("  2) LAN only     — no data relayed by palmier server, requires same network");
     console.log("");
-    console.log("Starting pairing...");
-    await pairCommand();
+    const answer = await ask("Select [1]: ");
+    const trimmed = answer.trim();
+    if (trimmed === "2") {
+        return "lan";
+    }
+    return "full";
 }
-/**
- * Flow B: Register directly with server. No provisioning token needed.
- */
-async function initWithServer(options) {
-    const serverUrl = options.server;
-    console.log(`Registering host at ${serverUrl}...`);
-    let registerResponse;
+async function promptServerUrl(ask, step) {
+    const defaultUrl = "https://www.palmier.me";
+    console.log(`\nStep ${step}: Enter your Palmier server URL\n`);
+    while (true) {
+        const answer = await ask(`Server URL [${defaultUrl}]: `);
+        const trimmed = (answer.trim() || defaultUrl).replace(/\/+$/, "");
+        if (trimmed.startsWith("http://") || trimmed.startsWith("https://")) {
+            return trimmed;
+        }
+        console.log("  URL must start with http:// or https://. Please try again.\n");
+    }
+}
+async function registerHost(serverUrl) {
     try {
         const res = await fetch(`${serverUrl}/api/hosts/register`, {
             method: "POST",
@@ -69,121 +97,41 @@ async function initWithServer(options) {
             console.error(`Failed to register host: ${res.status} ${res.statusText}\n${body}`);
             process.exit(1);
         }
-        registerResponse = (await res.json());
+        return (await res.json());
     }
     catch (err) {
         console.error(`Failed to reach server: ${err}`);
         process.exit(1);
     }
-    // Prompt for connection mode
-    const mode = await promptMode();
-    // Build config
-    const config = {
-        hostId: registerResponse.hostId,
-        projectRoot: process.cwd(),
-        mode,
-        natsUrl: registerResponse.natsUrl,
-        natsWsUrl: registerResponse.natsWsUrl,
-        natsToken: registerResponse.natsToken,
-    };
-    if (mode === "auto") {
-        const directToken = randomBytes(32).toString("hex");
-        const directPort = options.port ?? 7400;
-        const lanIp = options.host ?? detectLanIp();
-        config.directPort = directPort;
-        config.directToken = directToken;
-        console.log("");
-        console.log("Direct connection info (for LAN clients):");
-        console.log(`  Address: ${lanIp}:${directPort}`);
-        console.log(`  Token:   ${directToken}`);
-    }
-    console.log("Detecting installed agents...");
-    config.agents = await detectAgents();
-    saveConfig(config);
-    console.log(`Host provisioned (${mode} mode). ID: ${config.hostId}`);
-    console.log("Config saved to ~/.config/palmier/host.json");
-    installSystemdService(config);
-    // Auto-enter pair mode so user can connect their PWA immediately
-    console.log("");
-    console.log("Starting pairing...");
-    await pairCommand();
-}
-/**
- * Prompt user to select connection mode.
- */
-async function promptMode() {
-    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-    const question = (q) => new Promise((resolve) => rl.question(q, resolve));
-    console.log("");
-    console.log("Connection mode:");
-    console.log("  1) auto — Both LAN and NATS (recommended)");
-    console.log("  2) nats — NATS only");
-    console.log("");
-    const answer = await question("Select [1]: ");
-    rl.close();
-    if (answer.trim() === "2" || answer.trim().toLowerCase() === "nats") {
-        return "nats";
-    }
-    return "auto";
 }
-/**
- * Detect the first non-internal IPv4 address.
- */
-function detectLanIp() {
-    const interfaces = os.networkInterfaces();
-    for (const name of Object.keys(interfaces)) {
-        for (const iface of interfaces[name] ?? []) {
-            if (iface.family === "IPv4" && !iface.internal) {
-                return iface.address;
-            }
-        }
-    }
-    return "127.0.0.1";
+async function promptEnableLan(ask, step) {
+    console.log(`\nStep ${step}: Enable LAN access?\n`);
+    console.log("  When enabled, the app will automatically use a direct LAN connection");
+    console.log("  when on the same network, and fall back to the server otherwise.\n");
+    const answer = await ask("Enable LAN access? (Y/n): ");
+    return answer.trim().toLowerCase() !== "n";
 }
-/**
- * Install systemd user service for palmier serve.
- */
-function installSystemdService(config) {
-    const unitDir = path.join(homedir(), ".config", "systemd", "user");
-    fs.mkdirSync(unitDir, { recursive: true });
-    const palmierBin = process.argv[1] || "palmier";
-    const serviceContent = `[Unit]
-Description=Palmier Host
-After=network-online.target
-Wants=network-online.target
-
-[Service]
-Type=simple
-ExecStart=${palmierBin} serve
-WorkingDirectory=${config.projectRoot}
-Restart=on-failure
-RestartSec=5
-Environment=PATH=${process.env.PATH || "/usr/local/bin:/usr/bin:/bin"}
-
-[Install]
-WantedBy=default.target
-`;
-    const servicePath = path.join(unitDir, "palmier.service");
-    fs.writeFileSync(servicePath, serviceContent, "utf-8");
-    console.log("Systemd service installed at:", servicePath);
-    // Enable and start the service
-    try {
-        execSync("systemctl --user daemon-reload", { stdio: "inherit" });
-        execSync("systemctl --user enable --now palmier.service", { stdio: "inherit" });
-        console.log("Palmier host service enabled and started.");
-    }
-    catch (err) {
-        console.error(`Warning: failed to enable systemd service: ${err}`);
-        console.error("You may need to start it manually: systemctl --user enable --now palmier.service");
+function setupLan(config, step) {
+    const directPort = 7400;
+    const directToken = randomBytes(32).toString("hex");
+    const lanIp = detectLanIp();
+    config.directPort = directPort;
+    config.directToken = directToken;
+    console.log(`\nStep ${step}: LAN setup\n`);
+    console.log(`  LAN IP:  ${lanIp}`);
+    console.log(`  Port:    ${directPort}`);
+    console.log("");
+    const platform = process.platform;
+    if (platform === "win32") {
+        console.log("  Firewall: You may need to allow incoming connections on this port:");
+        console.log(`    netsh advfirewall firewall add rule name="Palmier" dir=in action=allow protocol=TCP localport=${directPort}`);
     }
-    // Enable lingering so service runs without active login session
-    try {
-        execSync(`loginctl enable-linger ${process.env.USER || ""}`, { stdio: "inherit" });
-        console.log("Login lingering enabled.");
+    else if (platform === "darwin") {
+        console.log("  Firewall: macOS will prompt you to allow incoming connections automatically.");
     }
-    catch (err) {
-        console.error(`Warning: failed to enable linger: ${err}`);
+    else {
+        console.log("  Firewall: You may need to allow incoming connections on this port:");
+        console.log(`    sudo ufw allow ${directPort}/tcp`);
     }
-    console.log("\nHost initialization complete!");
 }
 //# sourceMappingURL=init.js.map

package/dist/commands/run.js

@@ -5,6 +5,7 @@ import { loadConfig } from "../config.js";
 import { connectNats } from "../nats-client.js";
 import { parseTaskFile, getTaskDir, writeTaskFile, writeTaskStatus, readTaskStatus, appendHistory } from "../task.js";
 import { getAgent } from "../agents/agent.js";
+import { getPlatform } from "../platform/index.js";
 import { TASK_SUCCESS_MARKER, TASK_FAILURE_MARKER, TASK_REPORT_PREFIX, TASK_PERMISSION_PREFIX } from "../agents/shared-prompt.js";
 import { StringCodec } from "nats";
 /**
@@ -76,7 +77,7 @@ export async function runCommand(taskId) {
             console.log("Task confirmed by user.");
         }
         // Execution loop: retry on permission failure if user grants
-        const guiEnv = getGuiEnv();
+        const guiEnv = getPlatform().getGuiEnv();
         const agent = getAgent(task.frontmatter.agent);
         let lastOutput = "";
         let lastOutcome = "fail";
@@ -300,16 +301,4 @@ function parseTaskOutcome(output) {
         return "finish";
     return "finish";
 }
-/**
- * Return env vars for the default physical GUI session (:0).
- */
-function getGuiEnv() {
-    const uid = process.getuid?.();
-    const runtimeDir = process.env.XDG_RUNTIME_DIR ||
-        (uid !== undefined ? `/run/user/${uid}` : "");
-    return {
-        DISPLAY: ":0",
-        ...(runtimeDir ? { XDG_RUNTIME_DIR: runtimeDir } : {}),
-    };
-}
 //# sourceMappingURL=run.js.map

package/dist/commands/sessions.js

@@ -7,12 +7,9 @@ export async function sessionsListCommand() {
     }
     console.log(`${sessions.length} active session(s):\n`);
     for (const s of sessions) {
-        const truncated = s.token.slice(0, 8) + "...";
         const label = s.label ? ` (${s.label})` : "";
-        console.log(`  ${truncated}${label}  created ${s.createdAt}`);
+        console.log(`  ${s.token}${label}  created ${s.createdAt}`);
     }
-    console.log("");
-    console.log("To revoke, use the full token: palmier sessions revoke <token>");
 }
 export async function sessionsRevokeCommand(token) {
     if (revokeSession(token)) {

package/dist/config.js

@@ -9,7 +9,7 @@ const CONFIG_FILE = path.join(CONFIG_DIR, "host.json");
  */
 export function loadConfig() {
     if (!fs.existsSync(CONFIG_FILE)) {
-        throw new Error("Host not provisioned. Run `palmier init --token <token>` or `palmier init --lan` first.\n" +
+        throw new Error("Host not provisioned. Run `palmier init` first.\n" +
             `Expected config at: ${CONFIG_FILE}`);
     }
     const raw = fs.readFileSync(CONFIG_FILE, "utf-8");

package/dist/index.js

@@ -22,12 +22,8 @@ program
 program
     .command("init")
     .description("Provision this host")
-    .option("--server <url>", "Register with Palmier server at the given URL")
-    .option("--lan", "Standalone LAN mode (no server needed)")
-    .option("--host <ip>", "Override detected LAN IP address")
-    .option("--port <port>", "Direct HTTP port (default: 7400)", parseInt)
-    .action(async (options) => {
-    await initCommand(options);
+    .action(async () => {
+    await initCommand();
 });
 program
     .command("info")
@@ -42,7 +38,7 @@ program
     await runCommand(taskId);
 });
 program
-    .command("serve", { isDefault: true })
+    .command("serve")
     .description("Start the persistent RPC handler")
     .action(async () => {
     await serveCommand();
@@ -86,6 +82,10 @@ sessionsCmd
     .action(async () => {
     await sessionsRevokeAllCommand();
 });
+// No subcommand → default to serve
+if (process.argv.length <= 2) {
+    process.argv.push("serve");
+}
 program.parseAsync(process.argv).catch((err) => {
     console.error(err);
     process.exit(1);

package/dist/platform/index.d.ts

@@ -0,0 +1,4 @@
+import type { PlatformService } from "./platform.js";
+export declare function getPlatform(): PlatformService;
+export type { PlatformService } from "./platform.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/platform/index.js

@@ -0,0 +1,12 @@
+import { LinuxPlatform } from "./linux.js";
+import { WindowsPlatform } from "./windows.js";
+let _instance;
+export function getPlatform() {
+    if (!_instance) {
+        _instance = process.platform === "win32"
+            ? new WindowsPlatform()
+            : new LinuxPlatform();
+    }
+    return _instance;
+}
+//# sourceMappingURL=index.js.map

package/dist/platform/linux.d.ts

@@ -0,0 +1,11 @@
+import type { PlatformService } from "./platform.js";
+import type { HostConfig, ParsedTask } from "../types.js";
+export declare class LinuxPlatform implements PlatformService {
+    installDaemon(config: HostConfig): void;
+    installTaskTimer(config: HostConfig, task: ParsedTask): void;
+    removeTaskTimer(taskId: string): void;
+    startTask(taskId: string): Promise<void>;
+    stopTask(taskId: string): Promise<void>;
+    getGuiEnv(): Record<string, string>;
+}
+//# sourceMappingURL=linux.d.ts.map