palmier 1.1.19 → 1.1.21

package/README.md

@@ -182,7 +182,7 @@ The wizard:
 - 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
+- Shows a summary (including the Palmier daemon version and any existing scheduled tasks to recover) and asks for confirmation
 - Registers with the Palmier server, saves configuration to `~/.config/palmier/host.json`
 - Installs a background daemon (systemd user service on Linux, LaunchAgent on macOS, Task Scheduler on Windows). On re-init, also restarts the daemon so the running process picks up the new agents/versions for `host.info`.
 - Auto-enters pair mode to connect your first device

package/dist/agents/agent.d.ts

@@ -30,7 +30,7 @@ export interface AgentTool {
     supportsPermissions?: boolean;
     /** Whether this agent supports yolo mode (auto-approve all tools). */
     supportsYolo?: boolean;
-    /** When true, the run loop will not persist the agent's stderr output. */
+    /** When true, the run loop persists the agent's stderr output only if the invocation fails. */
     suppressStdErr?: boolean;
     /** Matches the model name (capture group 1) in the banner the CLI prints on stderr.
      *  Takes precedence over the agent's self-reported model marker. */

package/dist/commands/init.js

@@ -10,6 +10,7 @@ import { getPlatform } from "../platform/index.js";
 import { pairCommand } from "./pair.js";
 import { detectDefaultInterface, getInterfaceIpv4 } from "../network.js";
 import { listTasks, taskDisplayName } from "../task.js";
+import { currentVersion } from "../update-checker.js";
 const { bold, dim, green, cyan, red } = colors;
 export async function initCommand() {
     console.log(`\n${bold("=== Palmier Host Setup ===")}\n`);
@@ -74,6 +75,7 @@ export async function initCommand() {
         const defaultInterface = (await detectDefaultInterface()) ?? undefined;
         const lanIp = defaultInterface ? getInterfaceIpv4(defaultInterface) : null;
         console.log(`\n${bold("Setup summary:")}\n`);
+        console.log(`  ${dim("Daemon:")}         Palmier v${currentVersion}\n`);
         console.log(`  ${dim("Task storage:")}   ${bold(projectRoot)}`);
         console.log(`                  All tasks and execution data will be stored here.\n`);
         console.log(`  ${dim("Local:")}          ${cyan(`http://localhost:${httpPort}`)}`);

package/dist/commands/run.js

@@ -2,7 +2,6 @@ import * as fs from "fs";
 import * as path from "path";
 import { spawnCommand } from "../spawn-command.js";
 import { loadConfig } from "../config.js";
-import { connectNats } from "../nats-client.js";
 import { parseTaskFile, taskDisplayName, getTaskDir, writeTaskFile, writeTaskStatus, readTaskStatus, appendHistory, createRunDir, appendRunMessage, readRunMessages, getRunDir, beginStreamingMessage, formatAgentModelComment } from "../task.js";
 import { getAgent } from "../agents/agent.js";
 import { getPlatform } from "../platform/index.js";
@@ -20,6 +19,7 @@ async function invokeAgentWithRetries(ctx, invokeTask) {
         let writer;
         let activeStream;
         const lineBufs = { stdout: "", stderr: "" };
+        let suppressedStderr = "";
         let notifyPending = false;
         let notifyTimer;
         let agentModel;
@@ -31,7 +31,7 @@ async function invokeAgentWithRetries(ctx, invokeTask) {
             notifyPending = true;
             notifyTimer = setTimeout(() => {
                 notifyPending = false;
-                publishHostEvent(ctx.nc, ctx.config.hostId, ctx.taskId, { event_type: "result-updated", run_id: ctx.runId });
+                publishHostEvent(ctx.taskId, { event_type: "result-updated", run_id: ctx.runId });
             }, 500);
         }
         function ensureWriter(stream) {
@@ -51,7 +51,9 @@ async function invokeAgentWithRetries(ctx, invokeTask) {
             throttledNotify();
         }
         function onStderr(chunk) {
-            if (!ctx.agent.suppressStdErr)
+            if (ctx.agent.suppressStdErr)
+                suppressedStderr += chunk;
+            else
                 emit("stderr", chunk);
             const cliModel = captureCliModel(chunk);
             if (cliModel && !agentModelWritten)
@@ -72,6 +74,12 @@ async function invokeAgentWithRetries(ctx, invokeTask) {
             }
             flushAgentModel();
         }
+        function flushTrailingLine(stream) {
+            const trailing = lineBufs[stream];
+            if (trailing && !trailing.startsWith("[PALMIER")) {
+                ensureWriter(stream).write(trailing);
+            }
+        }
         const { args, stdin, env: agentEnv, files } = ctx.agent.getTaskRunCommandLine(invokeTask, undefined, ctx.task.frontmatter.yolo_mode ? "yolo" : ctx.transientPermissions);
         const command = ctx.agent.command;
         const runDir = getRunDir(ctx.taskDir, ctx.runId);
@@ -88,25 +96,23 @@ async function invokeAgentWithRetries(ctx, invokeTask) {
             onStdout: (chunk) => emit("stdout", chunk),
             onStderr,
         });
-        if (notifyTimer)
-            clearTimeout(notifyTimer);
         const outcome = result.exitCode !== 0 ? "failed" : parseTaskOutcome(result.output);
         const linkedFiles = listLinkedTaskFiles(ctx.taskDir, ctx.runId, result.output);
         const requiredPermissions = parsePermissions(result.output);
-        for (const stream of ["stdout", "stderr"]) {
-            const trailing = lineBufs[stream];
-            if (trailing && !trailing.startsWith("[PALMIER")) {
-                ensureWriter(stream).write(trailing);
-            }
-        }
+        flushTrailingLine("stdout");
+        if (outcome === "failed")
+            emit("stderr", suppressedStderr);
+        flushTrailingLine("stderr");
         if (requiredPermissions.length > 0) {
             const permLines = requiredPermissions.map((p) => `- **${p.name}** ${p.description}`).join("\n");
             ensureWriter("stdout").write(`\n\n**Permissions requested:**\n${permLines}\n`);
         }
+        if (notifyTimer)
+            clearTimeout(notifyTimer);
         writer?.end();
-        await publishHostEvent(ctx.nc, ctx.config.hostId, ctx.taskId, { event_type: "result-updated", run_id: ctx.runId });
+        await publishHostEvent(ctx.taskId, { event_type: "result-updated", run_id: ctx.runId });
         if (linkedFiles.length > 0) {
-            await publishHostEvent(ctx.nc, ctx.config.hostId, ctx.taskId, {
+            await publishHostEvent(ctx.taskId, {
                 event_type: "report-generated",
                 run_id: ctx.runId,
                 name: taskDisplayName(ctx.task.frontmatter),
@@ -153,7 +159,7 @@ export function stripPalmierMarkers(output) {
 }
 async function appendAndNotify(ctx, msg) {
     appendRunMessage(ctx.taskDir, ctx.runId, msg);
-    await publishHostEvent(ctx.nc, ctx.config.hostId, ctx.taskId, { event_type: "result-updated", run_id: ctx.runId });
+    await publishHostEvent(ctx.taskId, { event_type: "result-updated", run_id: ctx.runId });
 }
 /** The latest run dir with no status messages yet — freshly created by the RPC handler. */
 function findLatestPendingRunId(taskDir) {
@@ -182,7 +188,6 @@ export async function runCommand(taskId) {
     const taskDir = getTaskDir(config.projectRoot, taskId);
     const task = parseTaskFile(taskDir);
     console.log(`Running task: ${taskId}`);
-    let nc;
     const taskName = taskDisplayName(task.frontmatter);
     const existingRunId = findLatestPendingRunId(taskDir);
     const agentVersion = config.agents?.find((a) => a.key === task.frontmatter.agent)?.version;
@@ -191,9 +196,6 @@ export async function runCommand(taskId) {
         appendHistory(config.projectRoot, { task_id: taskId, run_id: runId });
     }
     const cleanup = async () => {
-        if (nc && !nc.isClosed()) {
-            await nc.drain();
-        }
         if (task.frontmatter.one_off) {
             try {
                 getPlatform().removeTaskTimer(taskId);
@@ -202,32 +204,31 @@ export async function runCommand(taskId) {
         }
     };
     try {
-        nc = await connectNats(config);
-        await publishTaskEvent(nc, config, taskDir, taskId, "started", taskName, runId);
+        await publishTaskEvent(taskDir, taskId, "started", taskName, runId);
         appendRunMessage(taskDir, runId, { role: "status", time: Date.now(), content: "", type: "started" });
-        await publishHostEvent(nc, config.hostId, taskId, { event_type: "result-updated", run_id: runId });
+        await publishHostEvent(taskId, { event_type: "result-updated", run_id: runId });
         if (task.frontmatter.requires_confirmation) {
             const confirmed = await requestConfirmation(config, task, taskDir);
             const confirmPrompt = `**Task Confirmation**\n\nRun task "${taskName || task.frontmatter.user_prompt}"?`;
             appendRunMessage(taskDir, runId, { role: "assistant", time: Date.now(), content: confirmPrompt, type: "confirmation" });
-            await publishHostEvent(nc, config.hostId, taskId, { event_type: "result-updated", run_id: runId });
+            await publishHostEvent(taskId, { event_type: "result-updated", run_id: runId });
             if (!confirmed) {
                 console.log("Task aborted by user.");
                 appendRunMessage(taskDir, runId, { role: "user", time: Date.now(), content: "Aborted", type: "confirmation" });
                 appendRunMessage(taskDir, runId, { role: "status", time: Date.now(), content: "", type: "aborted" });
-                await publishTaskEvent(nc, config, taskDir, taskId, "aborted", taskName, runId);
+                await publishTaskEvent(taskDir, taskId, "aborted", taskName, runId);
                 await cleanup();
                 return;
             }
             console.log("Task confirmed by user.");
             appendRunMessage(taskDir, runId, { role: "user", time: Date.now(), content: "Confirmed", type: "confirmation" });
             appendRunMessage(taskDir, runId, { role: "status", time: Date.now(), content: "", type: "confirmation" });
-            await publishHostEvent(nc, config.hostId, taskId, { event_type: "result-updated", run_id: runId });
+            await publishHostEvent(taskId, { event_type: "result-updated", run_id: runId });
         }
         const guiEnv = getPlatform().getGuiEnv();
         const agent = getAgent(task.frontmatter.agent);
         const ctx = {
-            agent, task, taskDir, runId, guiEnv, nc, config, taskId,
+            agent, task, taskDir, runId, guiEnv, config, taskId,
             transientPermissions: [],
         };
         // Command-output and on_new_* tasks share the same trigger machinery: the
@@ -240,7 +241,7 @@ export async function runCommand(taskId) {
             const result = await runEventTriggeredMode(ctx);
             const outcome = resolveOutcome(taskDir, result.outcome);
             appendRunMessage(taskDir, runId, { role: "status", time: Date.now(), content: "", type: outcome });
-            await publishTaskEvent(nc, config, taskDir, taskId, outcome, taskName, runId);
+            await publishTaskEvent(taskDir, taskId, outcome, taskName, runId);
             console.log(`Task ${taskId} completed (triggered).`);
         }
         else {
@@ -252,7 +253,7 @@ export async function runCommand(taskId) {
             const result = await invokeAgentWithRetries(ctx, task);
             const outcome = resolveOutcome(taskDir, result.outcome);
             appendRunMessage(taskDir, runId, { role: "status", time: Date.now(), content: "", type: outcome });
-            await publishTaskEvent(nc, config, taskDir, taskId, outcome, taskName, runId);
+            await publishTaskEvent(taskDir, taskId, outcome, taskName, runId);
             console.log(`Task ${taskId} completed.`);
         }
     }
@@ -266,7 +267,7 @@ export async function runCommand(taskId) {
             content: errorMsg,
         });
         appendRunMessage(taskDir, runId, { role: "status", time: Date.now(), content: "", type: outcome });
-        await publishTaskEvent(nc, config, taskDir, taskId, outcome, taskName, runId);
+        await publishTaskEvent(taskDir, taskId, outcome, taskName, runId);
         process.exitCode = 1;
     }
     finally {
@@ -317,12 +318,12 @@ async function runEventTriggeredMode(ctx) {
     catch (err) {
         const errorMsg = err instanceof Error ? err.message : String(err);
         appendRunMessage(ctx.taskDir, ctx.runId, { role: "status", time: Date.now(), content: errorMsg, type: "error" });
-        await publishHostEvent(ctx.nc, ctx.config.hostId, ctx.taskId, { event_type: "result-updated", run_id: ctx.runId });
+        await publishHostEvent(ctx.taskId, { event_type: "result-updated", run_id: ctx.runId });
         return { outcome: "failed", endTime: Date.now() };
     }
     return { outcome: lastOutcome, endTime: Date.now() };
 }
-async function publishTaskEvent(nc, config, taskDir, taskId, eventType, taskName, runId) {
+async function publishTaskEvent(taskDir, taskId, eventType, taskName, runId) {
     writeTaskStatus(taskDir, {
         running_state: eventType,
         time_stamp: Date.now(),
@@ -333,7 +334,7 @@ async function publishTaskEvent(nc, config, taskDir, taskId, eventType, taskName
         payload.name = taskName;
     if (runId)
         payload.run_id = runId;
-    await publishHostEvent(nc, config.hostId, taskId, payload);
+    await publishHostEvent(taskId, payload);
 }
 async function requestPermission(config, task, taskDir, requiredPermissions) {
     const port = config.httpPort ?? 7256;

package/dist/commands/serve.js

@@ -25,7 +25,7 @@ const DAEMON_PID_FILE = path.join(CONFIG_DIR, "daemon.pid");
  * clean up OS scheduler units for one-off tasks that have already terminated.
  * The system scheduler (Task Scheduler / systemd) is the authoritative source.
  */
-async function checkStaleTasks(config, nc) {
+async function checkStaleTasks(config) {
     const tasksRoot = path.join(config.projectRoot, "tasks");
     if (!fs.existsSync(tasksRoot))
         return;
@@ -59,7 +59,7 @@ async function checkStaleTasks(config, nc) {
                     type: "failed",
                 });
             }
-            await publishHostEvent(nc, config.hostId, taskId, {
+            await publishHostEvent(taskId, {
                 event_type: "running-state",
                 running_state: "failed",
                 name: taskDisplayName(task.frontmatter) || taskId,
@@ -91,7 +91,7 @@ async function checkStaleTasks(config, nc) {
                     content: "",
                     type: "failed",
                 });
-                await publishHostEvent(nc, config.hostId, taskId, { event_type: "result-updated", run_id: runId });
+                await publishHostEvent(taskId, { event_type: "result-updated", run_id: runId });
             }
         }
     }
@@ -112,37 +112,18 @@ export async function serveCommand() {
     saveConfig(config);
     console.log(`Detected agents: ${agents.map((a) => a.key).join(", ") || "none"}`);
     let nc;
-    try {
-        nc = await connectNats(config);
+    const handleRpc = createRpcHandler(config);
+    function attachNats(conn) {
+        nc = conn;
         console.log("[nats] Connected");
-    }
-    catch (err) {
-        console.warn(`[nats] Connection failed (server mode unavailable): ${err}`);
-    }
-    await checkStaleTasks(config, nc);
-    // Reinstall scheduler entries for all tasks (recovery after init/reinstall)
-    const platform = getPlatform();
-    const allTasks = listTasks(config.projectRoot);
-    for (const task of allTasks) {
-        try {
-            platform.installTaskTimer(config, task);
-        }
-        catch (err) {
-            console.error(`Warning: failed to install timer for task ${task.frontmatter.id}: ${err}`);
-        }
-    }
-    // Spawn the long-running command process for every enabled command task —
-    // the daemon owns these the same way it owns the device-event subscriptions.
-    startEnabledCommandRunners(config);
-    setInterval(() => {
-        checkStaleTasks(config, nc).catch((err) => {
-            console.error("[monitor] Error checking stale tasks:", err);
-        });
-    }, POLL_INTERVAL_MS);
-    const handleRpc = createRpcHandler(config, nc);
-    const httpPort = config.httpPort ?? 7256;
-    if (nc) {
-        startNatsTransport(config, handleRpc, nc);
+        (async () => {
+            for await (const s of conn.status()) {
+                if (s.type === "pingTimer")
+                    continue;
+                console.log(`[nats] Status: ${s.type}${typeof s.data === "string" ? ` (${s.data})` : ""}`);
+            }
+        })();
+        startNatsTransport(config, handleRpc, conn);
         const sc = StringCodec();
         // Match phone numbers regardless of formatting; letters preserved for shortcodes.
         function normalizeSender(raw) {
@@ -168,7 +149,7 @@ export async function serveCommand() {
                 dispatchTrigger(task.frontmatter.id, payload);
             }
         }
-        const notifSub = nc.subscribe(`host.${config.hostId}.device.notifications`);
+        const notifSub = conn.subscribe(`host.${config.hostId}.device.notifications`);
         (async () => {
             for await (const msg of notifSub) {
                 const raw = sc.decode(msg.data);
@@ -183,7 +164,7 @@ export async function serveCommand() {
                 dispatchDeviceEvent("on_new_notification", raw, parsed);
             }
         })();
-        const smsSub = nc.subscribe(`host.${config.hostId}.device.sms`);
+        const smsSub = conn.subscribe(`host.${config.hostId}.device.sms`);
         (async () => {
             for await (const msg of smsSub) {
                 const raw = sc.decode(msg.data);
@@ -199,5 +180,42 @@ export async function serveCommand() {
             }
         })();
     }
-    await startHttpTransport(config, handleRpc, httpPort, nc);
+    // The client's own reconnect only covers a connection that was once up, so a
+    // daemon started while offline (e.g. at logon before Wi-Fi) must keep dialing.
+    async function connectWithRetry() {
+        for (let delayMs = 5_000;; delayMs = Math.min(delayMs * 2, 60_000)) {
+            try {
+                attachNats(await connectNats(config));
+                return;
+            }
+            catch (err) {
+                console.warn(`[nats] Connection failed, retrying in ${delayMs / 1000}s: ${err}`);
+            }
+            await new Promise((r) => setTimeout(r, delayMs));
+        }
+    }
+    // Don't block startup on the relay: local mode must work offline.
+    connectWithRetry();
+    await checkStaleTasks(config);
+    // Reinstall scheduler entries for all tasks (recovery after init/reinstall)
+    const platform = getPlatform();
+    const allTasks = listTasks(config.projectRoot);
+    for (const task of allTasks) {
+        try {
+            platform.installTaskTimer(config, task);
+        }
+        catch (err) {
+            console.error(`Warning: failed to install timer for task ${task.frontmatter.id}: ${err}`);
+        }
+    }
+    // Spawn the long-running command process for every enabled command task —
+    // the daemon owns these the same way it owns the device-event subscriptions.
+    startEnabledCommandRunners(config);
+    setInterval(() => {
+        checkStaleTasks(config).catch((err) => {
+            console.error("[monitor] Error checking stale tasks:", err);
+        });
+    }, POLL_INTERVAL_MS);
+    const httpPort = config.httpPort ?? 7256;
+    await startHttpTransport(config, handleRpc, httpPort, () => nc);
 }

package/dist/events.d.ts

@@ -1,2 +1,2 @@
-import { type NatsConnection } from "nats";
-export declare function publishHostEvent(nc: NatsConnection | undefined, hostId: string, taskId: string, payload: Record<string, unknown>): Promise<void>;
+/** Hands the event to the daemon, which forwards it to the relay and local SSE clients. */
+export declare function publishHostEvent(taskId: string, payload: Record<string, unknown>): Promise<void>;

package/dist/events.js

@@ -1,12 +1,6 @@
-import { StringCodec } from "nats";
 import { loadConfig } from "./config.js";
-const sc = StringCodec();
-export async function publishHostEvent(nc, hostId, taskId, payload) {
-    const subject = `host-event.${hostId}.${taskId}`;
-    if (nc) {
-        nc.publish(subject, sc.encode(JSON.stringify(payload)));
-        console.log(`[nats] ${subject} →`, payload);
-    }
+/** Hands the event to the daemon, which forwards it to the relay and local SSE clients. */
+export async function publishHostEvent(taskId, payload) {
     const config = loadConfig();
     const port = config.httpPort ?? 7256;
     try {

package/dist/nats-client.js

@@ -6,6 +6,12 @@ export async function connectNats(config) {
     const nc = await connect({
         servers: config.natsUrl,
         authenticator: jwtAuthenticator(config.natsJwt, new TextEncoder().encode(config.natsNkeySeed)),
+        // Sleep or a network switch kills the socket silently; the 2-min default
+        // ping leaves the host unreachable for minutes, and the default 10
+        // reconnect attempts close the connection for good after a short outage.
+        maxReconnectAttempts: -1,
+        pingInterval: 20_000,
+        maxPingOut: 2,
     });
     return nc;
 }

package/dist/platform/windows.d.ts

@@ -12,7 +12,10 @@ import type { HostConfig, ParsedTask } from "../types.js";
  *   monthly: "MM HH D * *"
  */
 export declare function scheduleValueToXml(scheduleType: "crons" | "specific_times", value: string): string;
-export declare function buildTaskXml(tr: string, triggers: string[], foreground?: boolean): string;
+export declare function buildTaskXml(tr: string, triggers: string[], opts?: {
+    foreground?: boolean;
+    persistent?: boolean;
+}): string;
 export declare class WindowsPlatform implements PlatformService {
     installDaemon(config: HostConfig): void;
     uninstallDaemon(): void;

package/dist/platform/windows.js

@@ -40,7 +40,7 @@ export function scheduleValueToXml(scheduleType, value) {
     }
     return `<CalendarTrigger><StartBoundary>${base}</StartBoundary><ScheduleByDay><DaysInterval>1</DaysInterval></ScheduleByDay></CalendarTrigger>`;
 }
-export function buildTaskXml(tr, triggers, foreground) {
+export function buildTaskXml(tr, triggers, opts = {}) {
     const [command, ...argParts] = tr.match(/"[^"]*"|[^\s]+/g) ?? [];
     const commandStr = command?.replace(/"/g, "") ?? "";
     const argsStr = argParts.map((a) => a.replace(/"/g, "")).join(" ");
@@ -49,7 +49,7 @@ export function buildTaskXml(tr, triggers, foreground) {
         `<Task version="1.3" xmlns="http://schemas.microsoft.com/windows/2004/02/mit/task">`,
         `  <Principals>`,
         `    <Principal>`,
-        `      <LogonType>${foreground ? "InteractiveToken" : "S4U"}</LogonType>`,
+        `      <LogonType>${opts.foreground ? "InteractiveToken" : "S4U"}</LogonType>`,
         `      <RunLevel>LeastPrivilege</RunLevel>`,
         `    </Principal>`,
         `  </Principals>`,
@@ -58,6 +58,12 @@ export function buildTaskXml(tr, triggers, foreground) {
         `    <DisallowStartIfOnBatteries>false</DisallowStartIfOnBatteries>`,
         `    <StopIfGoingOnBatteries>false</StopIfGoingOnBatteries>`,
         `    <UseUnifiedSchedulingEngine>true</UseUnifiedSchedulingEngine>`,
+        // Omitting ExecutionTimeLimit means Task Scheduler's 72h default, which
+        // kills a long-running process; PT0S disables the limit.
+        ...(opts.persistent ? [
+            `    <ExecutionTimeLimit>PT0S</ExecutionTimeLimit>`,
+            `    <RestartOnFailure><Interval>PT1M</Interval><Count>999</Count></RestartOnFailure>`,
+        ] : []),
         `  </Settings>`,
         `  <Triggers>${triggers.join("")}</Triggers>`,
         `  <Actions>`,
@@ -171,7 +177,7 @@ export class WindowsPlatform {
     ensureDaemonTask(script) {
         const tn = `\\Palmier\\${DAEMON_TASK_NAME}`;
         const tr = `"${process.execPath}" "${script}" serve`;
-        const xml = buildTaskXml(tr, [`<BootTrigger><Enabled>true</Enabled></BootTrigger>`]);
+        const xml = buildTaskXml(tr, [`<BootTrigger><Enabled>true</Enabled></BootTrigger>`], { persistent: true });
         const xmlPath = path.join(CONFIG_DIR, "daemon-task.xml");
         try {
             const bom = Buffer.from([0xFF, 0xFE]);
@@ -234,7 +240,7 @@ export class WindowsPlatform {
         // MultipleInstancesPolicy. S4U keeps the console hidden unless
         // foreground_mode is set. Works unelevated because the caller (daemon)
         // runs elevated.
-        const xml = buildTaskXml(tr, triggerElements, task.frontmatter.foreground_mode);
+        const xml = buildTaskXml(tr, triggerElements, { foreground: task.frontmatter.foreground_mode });
         const xmlPath = path.join(CONFIG_DIR, `task-${taskId}.xml`);
         try {
             // schtasks /xml requires UTF-16LE with BOM.