@herbertgao/pi-extensions 2026.8.2 → 2026.8.4

package/node_modules/remote-pi/dist/commands/list_commands.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Plan/28 Wave B Slice 1 — `list_commands` handler.
+ *
+ * Builds the catalog the app's slash-command picker renders. Sources:
+ *
+ *   1. **Builtins**: from `BUILTIN_SLASH_COMMANDS_MIRROR` (manual mirror of
+ *      the Pi SDK's hardcoded list — see `builtin_mirror.ts` for why).
+ *   2. **Extension / prompt / skill**: from `pi.getCommands()` at runtime,
+ *      so anything our extension (or future plugins) register shows up
+ *      automatically.
+ *
+ * Invokability of extension-registered commands is `true` by default — the
+ * pi-extension owns its own command handlers and the Wave B Slice 2
+ * dispatcher will call them directly via a local registry. Prompt and
+ * skill commands stay `false` until we wire dispatch for them.
+ */
+import type { SlashCommandInfo } from "@mariozechner/pi-coding-agent";
+import type { ClientMessage, ServerMessage, WireCommand } from "../protocol/types.js";
+import { findBuiltin } from "./builtin_mirror.js";
+/**
+ * Minimal channel surface the handler needs to reply to the requesting
+ * owner. `PlainPeerChannel` satisfies it; tests can pass a fake.
+ */
+export interface CommandReplySender {
+    send(msg: ServerMessage): void;
+}
+/**
+ * Subset of `ExtensionAPI` used by `handleListCommands`. Narrowing the
+ * signature lets us instantiate fakes in tests without rebuilding the
+ * whole `ExtensionAPI` surface.
+ */
+export interface CommandSourcePi {
+    getCommands(): SlashCommandInfo[];
+}
+type ListCommandsMsg = Extract<ClientMessage, {
+    type: "list_commands";
+}>;
+/**
+ * Build the wire catalog and send the reply. Pure modulo I/O on `sender`.
+ *
+ * Implementation notes:
+ * - Builtins come first so the app's default ordering keeps the most
+ *   familiar names (`/compact`, `/model`) near the top of the picker.
+ *   The app may re-sort; this is only a default.
+ * - Skills returned by `pi.getCommands()` are already prefixed with
+ *   `skill:` in their `name` (per the SDK's runtime — see
+ *   `agent-session.js`'s `_bindExtensionCore`). We forward verbatim.
+ * - If a mirror entry's name collides with a registered command of a
+ *   different source (extension overriding a builtin), the registered
+ *   one wins — we strip the duplicate builtin from the output. This
+ *   matches the TUI's actual dispatch order.
+ */
+export declare function handleListCommands(pi: CommandSourcePi, sender: CommandReplySender, msg: ListCommandsMsg): void;
+/**
+ * Convert a `SlashCommandInfo` from the SDK into the wire schema.
+ * Visible so the dispatcher (Wave B Slice 2) can reuse the source/
+ * invokability decisions without redoing them.
+ */
+export declare function sdkCommandToWire(c: SlashCommandInfo): WireCommand;
+export { findBuiltin };

package/node_modules/remote-pi/dist/commands/list_commands.js

@@ -0,0 +1,73 @@
+/**
+ * Plan/28 Wave B Slice 1 — `list_commands` handler.
+ *
+ * Builds the catalog the app's slash-command picker renders. Sources:
+ *
+ *   1. **Builtins**: from `BUILTIN_SLASH_COMMANDS_MIRROR` (manual mirror of
+ *      the Pi SDK's hardcoded list — see `builtin_mirror.ts` for why).
+ *   2. **Extension / prompt / skill**: from `pi.getCommands()` at runtime,
+ *      so anything our extension (or future plugins) register shows up
+ *      automatically.
+ *
+ * Invokability of extension-registered commands is `true` by default — the
+ * pi-extension owns its own command handlers and the Wave B Slice 2
+ * dispatcher will call them directly via a local registry. Prompt and
+ * skill commands stay `false` until we wire dispatch for them.
+ */
+import { BUILTIN_SLASH_COMMANDS_MIRROR, builtinToWire, findBuiltin, } from "./builtin_mirror.js";
+/**
+ * Build the wire catalog and send the reply. Pure modulo I/O on `sender`.
+ *
+ * Implementation notes:
+ * - Builtins come first so the app's default ordering keeps the most
+ *   familiar names (`/compact`, `/model`) near the top of the picker.
+ *   The app may re-sort; this is only a default.
+ * - Skills returned by `pi.getCommands()` are already prefixed with
+ *   `skill:` in their `name` (per the SDK's runtime — see
+ *   `agent-session.js`'s `_bindExtensionCore`). We forward verbatim.
+ * - If a mirror entry's name collides with a registered command of a
+ *   different source (extension overriding a builtin), the registered
+ *   one wins — we strip the duplicate builtin from the output. This
+ *   matches the TUI's actual dispatch order.
+ */
+export function handleListCommands(pi, sender, msg) {
+    const registered = pi.getCommands();
+    const registeredNames = new Set(registered.map((c) => c.name));
+    const builtinWire = BUILTIN_SLASH_COMMANDS_MIRROR
+        .filter((b) => !registeredNames.has(b.name))
+        .map(builtinToWire);
+    const registeredWire = registered.map((c) => sdkCommandToWire(c));
+    const commands = [...builtinWire, ...registeredWire];
+    sender.send({
+        type: "commands_list",
+        in_reply_to: msg.id,
+        commands,
+    });
+}
+/**
+ * Convert a `SlashCommandInfo` from the SDK into the wire schema.
+ * Visible so the dispatcher (Wave B Slice 2) can reuse the source/
+ * invokability decisions without redoing them.
+ */
+export function sdkCommandToWire(c) {
+    const source = c.source; // "extension" | "prompt" | "skill"
+    // Extension commands are dispatched via our own local registry in
+    // Slice 2, so they're invokable today. Prompt templates and skills
+    // don't have a public invocation API yet — surface them as hints.
+    const invokable = source === "extension";
+    return {
+        name: c.name,
+        description: c.description,
+        source,
+        invokable,
+        // The SDK doesn't expose a `takesArgs` flag on `SlashCommandInfo`.
+        // Be permissive: assume any registered command may take args, so the
+        // app keeps the input editable after the chip. Builtins use the
+        // explicit per-name flag from the mirror.
+        takes_args: true,
+    };
+}
+// Re-export for callers that want builtin lookup without importing both
+// modules. Keeps the public surface of "commands" small.
+export { findBuiltin };
+//# sourceMappingURL=list_commands.js.map

package/node_modules/remote-pi/dist/commands/list_commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_commands.js","sourceRoot":"","sources":["../../src/commands/list_commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,EACL,6BAA6B,EAC7B,aAAa,EACb,WAAW,GACZ,MAAM,qBAAqB,CAAC;AAqB7B;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,kBAAkB,CAChC,EAAmB,EACnB,MAA0B,EAC1B,GAAoB;IAEpB,MAAM,UAAU,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;IAEpC,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/D,MAAM,WAAW,GAAkB,6BAA6B;SAC7D,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;SAC3C,GAAG,CAAC,aAAa,CAAC,CAAC;IAEtB,MAAM,cAAc,GAAkB,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACzD,gBAAgB,CAAC,CAAC,CAAC,CACpB,CAAC;IAEF,MAAM,QAAQ,GAAkB,CAAC,GAAG,WAAW,EAAE,GAAG,cAAc,CAAC,CAAC;IACpE,MAAM,CAAC,IAAI,CAAC;QACV,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,GAAG,CAAC,EAAE;QACnB,QAAQ;KACT,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,CAAmB;IAClD,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAE,mCAAmC;IAC7D,kEAAkE;IAClE,mEAAmE;IACnE,kEAAkE;IAClE,MAAM,SAAS,GAAG,MAAM,KAAK,WAAW,CAAC;IACzC,OAAO;QACL,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,MAAM;QACN,SAAS;QACT,mEAAmE;QACnE,qEAAqE;QACrE,gEAAgE;QAChE,0CAA0C;QAC1C,UAAU,EAAE,IAAI;KACjB,CAAC;AACJ,CAAC;AAED,wEAAwE;AACxE,yDAAyD;AACzD,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/node_modules/remote-pi/dist/config.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Default community relay. Stored in canonical http(s):// form — conversion
+ * to ws(s):// happens at the transport layer (see `toWebSocketUrl`). The
+ * community relay's reverse proxy maps `:443 → :3000` (the WS port), so the
+ * URL has no explicit port and the WebSocket upgrade rides on the same TLS
+ * connection as the HTTPS endpoints used by the mesh client.
+ */
+export declare const kDefaultRelayUrl = "https://relay-rp1.jacobmoura.work";
+export type RemotePiConfig = {
+    relay?: string;
+};
+export declare function loadConfig(): RemotePiConfig;
+export declare function saveConfig(patch: Partial<RemotePiConfig>): void;
+export type RelayResolution = {
+    url: string;
+    source: "env" | "config" | "default";
+};
+/**
+ * Resolves the effective relay URL in **canonical http(s):// form**.
+ *
+ * Precedence:
+ *   1. `REMOTE_PI_RELAY` env var (ops/CI escape hatch)
+ *   2. `~/.pi/remote/config.json` `relay` field (set via /remote-pi set-relay)
+ *   3. `kDefaultRelayUrl` (community default)
+ *
+ * Any ws(s):// values found (legacy configs or env overrides) are coerced
+ * to http(s):// defensively — the canonical form across the codebase is
+ * http(s)://, and the transport layer converts to ws(s):// at WS-open time.
+ */
+export declare function resolveRelayUrl(): RelayResolution;
+/**
+ * Strict validator for **user-provided** relay URLs (via `/remote-pi
+ * set-relay` or `/remote-pi relay url`).
+ *
+ * Only accepts `http://` and `https://`. `ws://`/`wss://` are deliberately
+ * **rejected** — the canonical form stored in config is http(s):// and the
+ * extension converts to ws(s):// internally when opening the WebSocket.
+ * Forcing a single scheme at the user boundary avoids two-form drift.
+ */
+export declare function isValidRelayUrl(url: string): boolean;
+/**
+ * Returns true if the URL uses ws:// or wss:// scheme — for emitting a
+ * targeted error message when the user pastes a WebSocket URL by mistake.
+ */
+export declare function isWebSocketScheme(url: string): boolean;
+/**
+ * Converts an http(s):// URL to the corresponding ws(s):// form. Used by
+ * the transport layer right before opening the WebSocket — config storage
+ * and the mesh HTTP client both stay on http(s)://.
+ *
+ *   https://host  → wss://host
+ *   http://host   → ws://host
+ *   ws(s)://host  → pass-through (defensive — env overrides or legacy
+ *                   configs may still carry ws(s)://)
+ */
+export declare function toWebSocketUrl(url: string): string;
+/**
+ * Inverse of `toWebSocketUrl`. Used by `resolveRelayUrl` to coerce any
+ * ws(s):// values back to canonical http(s):// before returning them to
+ * the rest of the codebase.
+ */
+export declare function toHttpUrl(url: string): string;

package/node_modules/remote-pi/dist/config.js

@@ -0,0 +1,115 @@
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+const CONFIG_DIR = path.join(os.homedir(), ".pi", "remote");
+const CONFIG_FILE = path.join(CONFIG_DIR, "config.json");
+/**
+ * Default community relay. Stored in canonical http(s):// form — conversion
+ * to ws(s):// happens at the transport layer (see `toWebSocketUrl`). The
+ * community relay's reverse proxy maps `:443 → :3000` (the WS port), so the
+ * URL has no explicit port and the WebSocket upgrade rides on the same TLS
+ * connection as the HTTPS endpoints used by the mesh client.
+ */
+export const kDefaultRelayUrl = "https://relay-rp1.jacobmoura.work";
+export function loadConfig() {
+    try {
+        const raw = fs.readFileSync(CONFIG_FILE, "utf8");
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== "object")
+            return {};
+        return parsed;
+    }
+    catch {
+        return {};
+    }
+}
+export function saveConfig(patch) {
+    fs.mkdirSync(CONFIG_DIR, { recursive: true });
+    const current = loadConfig();
+    const next = { ...current, ...patch };
+    fs.writeFileSync(CONFIG_FILE, JSON.stringify(next, null, 2));
+}
+/**
+ * Resolves the effective relay URL in **canonical http(s):// form**.
+ *
+ * Precedence:
+ *   1. `REMOTE_PI_RELAY` env var (ops/CI escape hatch)
+ *   2. `~/.pi/remote/config.json` `relay` field (set via /remote-pi set-relay)
+ *   3. `kDefaultRelayUrl` (community default)
+ *
+ * Any ws(s):// values found (legacy configs or env overrides) are coerced
+ * to http(s):// defensively — the canonical form across the codebase is
+ * http(s)://, and the transport layer converts to ws(s):// at WS-open time.
+ */
+export function resolveRelayUrl() {
+    const env = process.env["REMOTE_PI_RELAY"];
+    if (env && env.length > 0)
+        return { url: toHttpUrl(env), source: "env" };
+    const cfg = loadConfig();
+    if (cfg.relay && cfg.relay.length > 0)
+        return { url: toHttpUrl(cfg.relay), source: "config" };
+    return { url: toHttpUrl(kDefaultRelayUrl), source: "default" };
+}
+/**
+ * Strict validator for **user-provided** relay URLs (via `/remote-pi
+ * set-relay` or `/remote-pi relay url`).
+ *
+ * Only accepts `http://` and `https://`. `ws://`/`wss://` are deliberately
+ * **rejected** — the canonical form stored in config is http(s):// and the
+ * extension converts to ws(s):// internally when opening the WebSocket.
+ * Forcing a single scheme at the user boundary avoids two-form drift.
+ */
+export function isValidRelayUrl(url) {
+    if (!url)
+        return false;
+    const lower = url.toLowerCase();
+    if (!lower.startsWith("http://") && !lower.startsWith("https://"))
+        return false;
+    try {
+        new URL(url);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Returns true if the URL uses ws:// or wss:// scheme — for emitting a
+ * targeted error message when the user pastes a WebSocket URL by mistake.
+ */
+export function isWebSocketScheme(url) {
+    const lower = url.toLowerCase();
+    return lower.startsWith("ws://") || lower.startsWith("wss://");
+}
+/**
+ * Converts an http(s):// URL to the corresponding ws(s):// form. Used by
+ * the transport layer right before opening the WebSocket — config storage
+ * and the mesh HTTP client both stay on http(s)://.
+ *
+ *   https://host  → wss://host
+ *   http://host   → ws://host
+ *   ws(s)://host  → pass-through (defensive — env overrides or legacy
+ *                   configs may still carry ws(s)://)
+ */
+export function toWebSocketUrl(url) {
+    const lower = url.toLowerCase();
+    if (lower.startsWith("https://"))
+        return "wss://" + url.slice("https://".length);
+    if (lower.startsWith("http://"))
+        return "ws://" + url.slice("http://".length);
+    return url;
+}
+/**
+ * Inverse of `toWebSocketUrl`. Used by `resolveRelayUrl` to coerce any
+ * ws(s):// values back to canonical http(s):// before returning them to
+ * the rest of the codebase.
+ */
+export function toHttpUrl(url) {
+    const lower = url.toLowerCase();
+    if (lower.startsWith("wss://"))
+        return "https://" + url.slice("wss://".length);
+    if (lower.startsWith("ws://"))
+        return "http://" + url.slice("ws://".length);
+    return url;
+}
+//# sourceMappingURL=config.js.map

package/node_modules/remote-pi/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/node_modules/remote-pi/dist/daemon/client.d.ts

@@ -0,0 +1,20 @@
+import { type ControlReplyFor, type ControlRequest } from "./control_protocol.js";
+export declare class SupervisorOfflineError extends Error {
+    readonly sockPath: string;
+    constructor(sockPath: string);
+}
+/**
+ * Sends a single request and returns the typed reply data.
+ *
+ * Throws:
+ *   - `SupervisorOfflineError` when the supervisor isn't reachable.
+ *   - `Error` from `parseReply` when the reply line is malformed.
+ *   - The supervisor's own error string when `ok: false`.
+ */
+export declare function callSupervisor<Op extends ControlRequest["op"]>(req: Extract<ControlRequest, {
+    op: Op;
+}>): Promise<ControlReplyFor<Op>>;
+/** Returns true when the supervisor is reachable. Used by `/remote-pi
+ *  daemons` to decide whether to query runtime state or fall back to
+ *  registry-only listing. */
+export declare function supervisorOnline(): Promise<boolean>;

package/node_modules/remote-pi/dist/daemon/client.js

@@ -0,0 +1,131 @@
+import { existsSync } from "node:fs";
+import { createConnection } from "node:net";
+import { encodeRequest, parseReply, } from "./control_protocol.js";
+import { getSupervisorSockPath } from "./supervisor.js";
+import { usesNamedPipe } from "../session/ipc.js";
+/**
+ * Tiny client for the `remote-pi` CLI to call the supervisor over the
+ * `~/.pi/remote/supervisor.sock` UDS.
+ *
+ * Each call opens a fresh connection, sends one request line, reads one
+ * reply line, closes. No connection pooling — the CLI is short-lived,
+ * latency is dominated by the socket round-trip (<1ms).
+ *
+ * `SupervisorOfflineError` is the common error: thrown when the socket
+ * file is missing OR the connect fails (no listener). The CLI handler
+ * formats it as a friendly "Run `remote-pi install` first" message.
+ */
+const CONNECT_TIMEOUT_MS = 1000;
+const REPLY_TIMEOUT_MS = 5000;
+export class SupervisorOfflineError extends Error {
+    sockPath;
+    constructor(sockPath) {
+        super(`Supervisor is not running. UDS not responding at ${sockPath}.\n` +
+            "Run `remote-pi install` to set it up, or start it manually with `pi-supervisord`.");
+        this.sockPath = sockPath;
+        this.name = "SupervisorOfflineError";
+    }
+}
+/**
+ * Sends a single request and returns the typed reply data.
+ *
+ * Throws:
+ *   - `SupervisorOfflineError` when the supervisor isn't reachable.
+ *   - `Error` from `parseReply` when the reply line is malformed.
+ *   - The supervisor's own error string when `ok: false`.
+ */
+export async function callSupervisor(req) {
+    const sockPath = getSupervisorSockPath();
+    // POSIX fast-fail on a missing socket file. Windows pipes have no file —
+    // skip the check and let `_connect` fail fast if the pipe isn't there.
+    if (!usesNamedPipe() && !existsSync(sockPath))
+        throw new SupervisorOfflineError(sockPath);
+    const sock = await _connect(sockPath);
+    try {
+        sock.write(encodeRequest(req));
+        const line = await _readLine(sock);
+        const reply = parseReply(line);
+        if (!reply.ok)
+            throw new Error(reply.error);
+        return reply.data;
+    }
+    finally {
+        sock.destroy();
+    }
+}
+/** Returns true when the supervisor is reachable. Used by `/remote-pi
+ *  daemons` to decide whether to query runtime state or fall back to
+ *  registry-only listing. */
+export async function supervisorOnline() {
+    const sockPath = getSupervisorSockPath();
+    if (!usesNamedPipe() && !existsSync(sockPath))
+        return false;
+    try {
+        const sock = await _connect(sockPath);
+        sock.destroy();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// ── internals ───────────────────────────────────────────────────────────────
+function _connect(sockPath) {
+    return new Promise((resolve, reject) => {
+        const sock = createConnection({ path: sockPath });
+        let settled = false;
+        const timer = setTimeout(() => {
+            if (settled)
+                return;
+            settled = true;
+            sock.destroy();
+            reject(new SupervisorOfflineError(sockPath));
+        }, CONNECT_TIMEOUT_MS);
+        sock.once("connect", () => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            sock.setEncoding("utf8");
+            resolve(sock);
+        });
+        sock.once("error", () => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            reject(new SupervisorOfflineError(sockPath));
+        });
+    });
+}
+function _readLine(sock) {
+    return new Promise((resolve, reject) => {
+        let buf = "";
+        const timer = setTimeout(() => {
+            reject(new Error("supervisor reply timeout"));
+            sock.destroy();
+        }, REPLY_TIMEOUT_MS);
+        sock.on("data", (chunk) => {
+            buf += chunk;
+            const nl = buf.indexOf("\n");
+            if (nl >= 0) {
+                clearTimeout(timer);
+                resolve(buf.slice(0, nl));
+            }
+        });
+        sock.on("end", () => {
+            clearTimeout(timer);
+            const nl = buf.indexOf("\n");
+            if (nl >= 0)
+                return resolve(buf.slice(0, nl));
+            if (buf.length > 0)
+                return resolve(buf);
+            reject(new Error("supervisor closed connection without replying"));
+        });
+        sock.on("error", (err) => {
+            clearTimeout(timer);
+            reject(err);
+        });
+    });
+}
+//# sourceMappingURL=client.js.map

package/node_modules/remote-pi/dist/daemon/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/daemon/client.ts"],"names":[],"mappings":"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"}

package/node_modules/remote-pi/dist/daemon/control_protocol.d.ts

@@ -0,0 +1,176 @@
+/**
+ * CLI ↔ supervisor IPC contract for `~/.pi/remote/supervisor.sock`.
+ *
+ * Framing: one JSON object per line, newline-terminated. The CLI sends a
+ * single `ControlRequest`, the supervisor sends a single `ControlReply`,
+ * both close the connection. No multiplexing, no streaming — each command
+ * is a short round-trip.
+ *
+ * Plan/26 W2. The Pi RPC protocol (`pi --mode rpc`) used by the daemon
+ * children themselves is a separate contract — see
+ * `node_modules/@earendil-works/pi-coding-agent/dist/modes/rpc/rpc-types.d.ts`.
+ * This file is strictly the supervisor's own control plane.
+ */
+import type { CronJob } from "./cron_registry.js";
+import type { CronLogEntry } from "./cron_log.js";
+/** Per-daemon runtime state observable through the supervisor. */
+export type DaemonState = "running" | "stopped" | "starting" | "crashed";
+export interface DaemonInfo {
+    id: string;
+    cwd: string;
+    name: string;
+    state: DaemonState;
+    pid?: number;
+    uptime_s?: number;
+    restart_count?: number;
+}
+/** Requests sent CLI → supervisor. */
+export type ControlRequest = {
+    op: "list";
+} | {
+    op: "status";
+} | {
+    op: "start_all";
+} | {
+    op: "start";
+    id: string;
+} | {
+    op: "stop_all";
+} | {
+    op: "stop";
+    id: string;
+} | {
+    op: "restart_all";
+} | {
+    op: "restart";
+    id: string;
+} | {
+    op: "send";
+    id: string;
+    text: string;
+} | {
+    op: "register";
+    cwd: string;
+} | {
+    op: "unregister";
+    id: string;
+} | {
+    op: "cron_add";
+    daemon_id: string;
+    schedule: string;
+    prompt: string;
+    tz?: string;
+    skip_if_busy?: boolean;
+    wake?: boolean;
+    catchup?: boolean;
+} | {
+    op: "cron_list";
+} | {
+    op: "cron_remove";
+    job_id: string;
+} | {
+    op: "cron_enable";
+    job_id: string;
+    enabled: boolean;
+} | {
+    op: "cron_run";
+    job_id: string;
+} | {
+    op: "cron_log";
+    job_id?: string;
+    tail?: number;
+};
+/** Replies sent supervisor → CLI. Tagged by `ok` boolean. */
+export type ControlReply<T = unknown> = {
+    ok: true;
+    data?: T;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Response shapes per op. Keep in sync with the supervisor handlers in
+ * `daemon/supervisor.ts`. Used for typed client calls.
+ */
+export interface ControlReplyShapes {
+    list: {
+        daemons: DaemonInfo[];
+    };
+    status: {
+        daemons: DaemonInfo[];
+    };
+    start_all: {
+        started: string[];
+        already_running: string[];
+    };
+    start: {
+        id: string;
+        state: DaemonState;
+        started: boolean;
+    };
+    stop_all: {
+        stopped: string[];
+        already_stopped: string[];
+    };
+    stop: {
+        id: string;
+        state: DaemonState;
+        stopped: boolean;
+    };
+    restart_all: {
+        restarted: string[];
+    };
+    restart: {
+        id: string;
+        state: DaemonState;
+        restarted: boolean;
+    };
+    send: {
+        id: string;
+        delivered: boolean;
+    };
+    register: {
+        id: string;
+        cwd: string;
+    };
+    unregister: {
+        removed: boolean;
+        cwd?: string;
+    };
+    cron_add: {
+        job: CronJobView;
+    };
+    cron_list: {
+        jobs: CronJobView[];
+    };
+    cron_remove: {
+        removed: boolean;
+    };
+    cron_enable: {
+        job_id: string;
+        enabled: boolean;
+        updated: boolean;
+    };
+    cron_run: {
+        job_id: string;
+        result: string;
+    };
+    cron_log: {
+        entries: CronLogEntry[];
+    };
+}
+/** A cron job plus its computed `next_run` (ISO), for `cron list`. */
+export type CronJobView = CronJob & {
+    next_run?: string | null;
+};
+/** Convenience for typed `Client.request<...>("op")` calls. */
+export type ControlReplyFor<Op extends ControlRequest["op"]> = Op extends keyof ControlReplyShapes ? ControlReplyShapes[Op] : never;
+export declare function encodeRequest(req: ControlRequest): string;
+export declare function encodeReply<T>(reply: ControlReply<T>): string;
+/**
+ * Parses a single JSON line into a request. Throws on malformed input —
+ * the supervisor catches and replies `{ok:false, error}` so the client
+ * gets a clean error rather than an unframed disconnect.
+ */
+export declare function parseRequest(line: string): ControlRequest;
+export declare function parseReply(line: string): ControlReply<unknown>;