opencode-mux 0.1.0

package/dist/cli.js

@@ -0,0 +1,300 @@
+import { spawn } from "node:child_process";
+import { appendFileSync, closeSync, mkdirSync, openSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { parentFromPassThrough, parseArgs } from "./args.js";
+import { loadConfig } from "./config.js";
+import { nodeExec } from "./exec.js";
+import { connectServer } from "./server.js";
+import { currentPane, shellQuote, tmuxAdapter } from "./tmux.js";
+import { createThemeStyles } from "./theme.js";
+import { PaneTracker } from "./tracker.js";
+import { VERSION } from "./version.js";
+import { createWatcher, defaultPaneArgv } from "./watch.js";
+/** Real subprocess launcher with optional file redirects (never throws). */
+export function nodeSpawn(command, args, opts = {}) {
+    let outFd;
+    let errFd;
+    try {
+        outFd = opts.stdoutFile !== undefined ? openSync(opts.stdoutFile, "a") : undefined;
+        errFd = opts.stderrFile !== undefined ? openSync(opts.stderrFile, "a") : undefined;
+    }
+    catch (error) {
+        try {
+            if (outFd !== undefined)
+                closeSync(outFd);
+        }
+        catch {
+            // already closed
+        }
+        return {
+            pid: null,
+            done: Promise.resolve({ ok: false, code: null, error: String(error), stdout: "", stderr: "" }),
+            kill: () => { },
+        };
+    }
+    const child = spawn(command, args, {
+        stdio: opts.inherit ? "inherit" : ["ignore", outFd ?? "pipe", errFd ?? "pipe"],
+    });
+    let stdout = "";
+    let stderr = "";
+    child.stdout?.setEncoding("utf8");
+    child.stderr?.setEncoding("utf8");
+    child.stdout?.on("data", (chunk) => {
+        stdout += chunk;
+    });
+    child.stderr?.on("data", (chunk) => {
+        stderr += chunk;
+    });
+    const closeFds = () => {
+        try {
+            if (outFd !== undefined)
+                closeSync(outFd);
+        }
+        catch {
+            // already closed
+        }
+        try {
+            if (errFd !== undefined)
+                closeSync(errFd);
+        }
+        catch {
+            // already closed
+        }
+    };
+    const done = new Promise((resolve) => {
+        child.on("error", (error) => {
+            closeFds();
+            resolve({ ok: false, code: null, error: String(error), stdout, stderr });
+        });
+        child.on("close", (code) => {
+            closeFds();
+            resolve({ ok: code === 0, code, error: null, stdout, stderr });
+        });
+    });
+    return {
+        pid: child.pid ?? null,
+        done,
+        kill: () => {
+            child.kill();
+        },
+    };
+}
+export function usageText() {
+    return [
+        "opencode-mux — drop-in opencode wrapper that opens tmux panes for subagent sessions",
+        "",
+        "Usage:",
+        "  opencode-mux [mux options] [opencode arguments...]",
+        "",
+        "Mux options:",
+        "  --config <path>       config file (default ~/.config/opencode-mux.conf)",
+        "  --layout <name>       pane layout: main-vertical | main-horizontal | tiled | even-horizontal | even-vertical (default main-vertical)",
+        "  --main-pane-size <pct> main pane size for main-* layouts, percent of window (20-80, default 60)",
+        "  --close <mode>        pane lifecycle: auto | keep (default auto)",
+        "  --grace <seconds>     close delay after a session finishes (default 1)",
+        "  --parent <id>         only watch children of this session",
+        "  --session-name <name> tmux session name (default mux)",
+        "  -h, --help            show this help and exit",
+        "  --version             print the version and exit",
+        "",
+        "All other arguments are passed through to opencode unchanged.",
+        "",
+    ].join("\n");
+}
+export function watchLogPath(env) {
+    const state = env.XDG_STATE_HOME !== undefined && env.XDG_STATE_HOME !== "" ? env.XDG_STATE_HOME : join(homedir(), ".local", "state");
+    return join(state, "opencode-mux", "watch.log");
+}
+/** Parses "2.0.5" or "opencode v2.0.5" into the major version; junk → null. */
+export function parseMajorVersion(version) {
+    const match = /(?:^|\s)v?(\d+)\./.exec(version.trim());
+    return match === null ? null : Number(match[1]);
+}
+/**
+ * Maps an opencode version to the client protocol generation it speaks: 2.0.0–2.0.5
+ * serve GET /api/status (legacy), 2.0.6+ serve GET /api/info (new). Each client
+ * generation's Service.ensure() probes only its own endpoint and stops a mismatched
+ * registered server, so the binary's generation must select the matching client.
+ * Returns null for unsupported or unparseable versions.
+ */
+export function serviceGeneration(version) {
+    const match = /(?:^|\s)v?(\d+)\.(\d+)\.(\d+)/.exec(version.trim());
+    if (match === null)
+        return null;
+    const major = Number(match[1]);
+    if (major !== 2)
+        return null;
+    const minor = Number(match[2]);
+    return minor === 0 && Number(match[3]) < 6 ? "legacy" : "new";
+}
+/** Re-emits resolved CLI flags as mux argv (for the watcher child process). */
+export function flagsToArgv(flags) {
+    const argv = [];
+    if (flags.layout !== undefined)
+        argv.push("--layout", flags.layout);
+    if (flags.mainPaneSize !== undefined)
+        argv.push("--main-pane-size", String(flags.mainPaneSize));
+    if (flags.closePanes !== undefined)
+        argv.push("--close", flags.closePanes);
+    if (flags.graceSeconds !== undefined)
+        argv.push("--grace", String(flags.graceSeconds));
+    if (flags.parent !== undefined)
+        argv.push("--parent", flags.parent ?? "");
+    if (flags.sessionName !== undefined)
+        argv.push("--session-name", flags.sessionName);
+    return argv;
+}
+/** argv for the spawned watcher process: marker + config path + explicit flags. */
+export function buildWatcherArgv(opts) {
+    return [
+        "--mux-watch",
+        ...(opts.configPath !== undefined ? ["--config", opts.configPath] : []),
+        ...flagsToArgv(opts.flags),
+    ];
+}
+/** argv the re-exec'd instance runs inside the fresh tmux session. */
+export function buildReexecArgv(entryPath, originalArgv) {
+    return [entryPath, ...originalArgv];
+}
+/** tmux new-session argv that boots the detached session and its command. */
+export function buildNewSessionCommand(input) {
+    return [
+        "new-session",
+        "-d",
+        "-e",
+        "MUX_OWNED_SESSION=1",
+        "-s",
+        input.sessionName,
+        "-c",
+        input.cwd,
+        ...buildReexecArgv(input.entryPath, input.originalArgv).map(shellQuote),
+    ];
+}
+async function resolveConfig(parsed, env) {
+    if (parsed.flags.parent === undefined) {
+        const inferred = parentFromPassThrough(parsed.passThrough);
+        if (inferred !== null)
+            parsed.flags.parent = inferred;
+    }
+    return loadConfig({ path: parsed.configPath, flags: parsed.flags, env });
+}
+async function runWatch(parsed, env, deps, generation) {
+    const targetPane = currentPane(env);
+    if (targetPane === null) {
+        process.stderr.write("opencode-mux: watcher requires TMUX_PANE (run inside tmux)\n");
+        return 1;
+    }
+    const config = await resolveConfig(parsed, env);
+    const logFile = watchLogPath(env);
+    mkdirSync(dirname(logFile), { recursive: true });
+    const append = (line) => {
+        try {
+            appendFileSync(logFile, `[${new Date().toISOString()}] ${line}\n`);
+        }
+        catch {
+            // log failures are non-fatal
+        }
+    };
+    const { client } = await (deps.connectServer ?? connectServer)({ generation });
+    const tracker = new PaneTracker({ graceMs: config.graceSeconds * 1000, closePanes: config.closePanes });
+    const watcher = createWatcher({
+        client,
+        tmux: tmuxAdapter(nodeExec()),
+        tracker,
+        log: append,
+        targetPane,
+        layout: config.layout,
+        mainPaneSize: config.mainPaneSize,
+        themeStyles: createThemeStyles({ env, cwd: deps.cwd ?? process.cwd() }),
+        parentID: config.parent,
+        paneArgv: defaultPaneArgv,
+        tickEveryMs: 500,
+    });
+    const controller = new AbortController();
+    const onSignal = () => controller.abort();
+    process.on("SIGINT", onSignal);
+    process.on("SIGTERM", onSignal);
+    try {
+        await watcher.start(controller.signal);
+    }
+    finally {
+        process.off("SIGINT", onSignal);
+        process.off("SIGTERM", onSignal);
+    }
+    return 0;
+}
+export async function main(argv, deps) {
+    const parsed = parseArgs(argv);
+    if (parsed.help) {
+        process.stdout.write(usageText());
+        return 0;
+    }
+    if (parsed.version) {
+        process.stdout.write(`opencode-mux ${VERSION}\n`);
+        return 0;
+    }
+    const tmuxCommand = deps.tmuxCommand ?? "tmux";
+    const opencodeCommand = deps.opencodeCommand ?? "opencode";
+    const nodeCommand = deps.nodeCommand ?? "node";
+    const env = deps.env;
+    const tmuxCheck = await deps.spawn(tmuxCommand, ["-V"]).done;
+    if (!tmuxCheck.ok) {
+        process.stderr.write("opencode-mux: tmux is required but was not found on PATH.\nInstall it with: apt install tmux (Debian/Ubuntu) or brew install tmux (macOS)\n");
+        return 1;
+    }
+    const opencodeCheck = await deps.spawn(opencodeCommand, ["--version"]).done;
+    if (!opencodeCheck.ok) {
+        process.stderr.write("opencode-mux: opencode is required but was not found on PATH.\nInstall or upgrade it: https://opencode.ai/v2/docs/\n");
+        return 1;
+    }
+    const versionText = opencodeCheck.stdout.trim() || opencodeCheck.stderr.trim();
+    if (parseMajorVersion(versionText) !== 2) {
+        process.stderr.write(`opencode-mux: opencode v2 is required, found version "${versionText || "unknown"}".\nUpgrade it: https://opencode.ai/v2/docs/\n`);
+        return 1;
+    }
+    const generation = serviceGeneration(versionText);
+    if (generation === null) {
+        process.stderr.write(`opencode-mux: unsupported opencode version "${versionText || "unknown"}" (expected a 2.x.y release).\nUpgrade it: https://opencode.ai/v2/docs/\n`);
+        return 1;
+    }
+    if (parsed.watch)
+        return runWatch(parsed, env, deps, generation);
+    const config = await resolveConfig(parsed, env);
+    const insideTmux = env.TMUX !== undefined && env.TMUX !== "" && env.TMUX_PANE !== undefined && env.TMUX_PANE !== "";
+    if (!insideTmux) {
+        const created = await deps
+            .spawn(tmuxCommand, buildNewSessionCommand({
+            entryPath: deps.entryPath,
+            originalArgv: argv,
+            sessionName: config.sessionName,
+            cwd: deps.cwd ?? process.cwd(),
+        }))
+            .done;
+        if (!created.ok) {
+            process.stderr.write(`opencode-mux: failed to start tmux session: ${created.error ?? "unknown error"}\n`);
+            return 1;
+        }
+        // Session-scoped appearance, so the mux looks coherent regardless of the
+        // user's global config. These touch only our own session — never -g.
+        // Failures are non-fatal: attach proceeds and the exit code is unchanged.
+        await deps.spawn(tmuxCommand, ["set-option", "-t", config.sessionName, "status", "off"]).done;
+        await deps.spawn(tmuxCommand, ["set-option", "-t", config.sessionName, "mouse", "on"]).done;
+        const attached = await deps.spawn(tmuxCommand, ["attach", "-t", config.sessionName], { inherit: true }).done;
+        return attached.ok ? 0 : attached.code ?? 1;
+    }
+    const logFile = watchLogPath(env);
+    mkdirSync(dirname(logFile), { recursive: true });
+    const watcher = deps.spawn(nodeCommand, [deps.entryPath, ...buildWatcherArgv({ configPath: parsed.configPath, flags: parsed.flags })], {
+        stdoutFile: logFile,
+        stderrFile: logFile,
+    });
+    const tui = await deps.spawn(opencodeCommand, parsed.passThrough, { inherit: true }).done;
+    watcher.kill();
+    await watcher.done;
+    if (env.MUX_OWNED_SESSION === "1") {
+        await deps.spawn(tmuxCommand, ["kill-session", "-t", config.sessionName]).done;
+    }
+    return tui.ok ? 0 : tui.code ?? 1;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,28 @@
+export type Layout = "main-vertical" | "main-horizontal" | "tiled" | "even-horizontal" | "even-vertical";
+export type ClosePanes = "auto" | "keep";
+export interface MuxConfig {
+    sessionName: string;
+    layout: Layout;
+    closePanes: ClosePanes;
+    graceSeconds: number;
+    mainPaneSize: number;
+    parent: string | null;
+}
+export interface CliFlags {
+    layout?: Layout;
+    closePanes?: ClosePanes;
+    graceSeconds?: number;
+    mainPaneSize?: number;
+    parent?: string | null;
+    sessionName?: string;
+}
+export declare const DEFAULT_CONFIG: MuxConfig;
+/** Serialized default config, written when the config file is missing. */
+export declare function defaultConfText(): string;
+export declare function parseConfText(text: string): Partial<MuxConfig>;
+export declare function configPath(env?: NodeJS.ProcessEnv): string;
+export declare function loadConfig(opts?: {
+    path?: string;
+    flags?: CliFlags;
+    env?: NodeJS.ProcessEnv;
+}): Promise<MuxConfig>;

package/dist/config.js

@@ -0,0 +1,119 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+export const DEFAULT_CONFIG = {
+    sessionName: "mux",
+    layout: "main-vertical",
+    closePanes: "auto",
+    graceSeconds: 1,
+    mainPaneSize: 60,
+    parent: null,
+};
+/** Serialized default config, written when the config file is missing. */
+export function defaultConfText() {
+    return [
+        "# opencode-mux configuration",
+        "# This file was created automatically with defaults.",
+        `session_name=${DEFAULT_CONFIG.sessionName}`,
+        `layout=${DEFAULT_CONFIG.layout}`,
+        `main_pane_size=${DEFAULT_CONFIG.mainPaneSize}`,
+        `close_panes=${DEFAULT_CONFIG.closePanes}`,
+        `grace=${DEFAULT_CONFIG.graceSeconds}`,
+        `parent=${DEFAULT_CONFIG.parent ?? ""}`,
+        "",
+    ].join("\n");
+}
+const LAYOUTS = new Set(["main-vertical", "main-horizontal", "tiled", "even-horizontal", "even-vertical"]);
+const CLOSE_MODES = new Set(["auto", "keep"]);
+export function parseConfText(text) {
+    const out = {};
+    for (const rawLine of text.split(/\r?\n/)) {
+        const line = rawLine.trim();
+        if (line === "" || line.startsWith("#"))
+            continue;
+        const eq = line.indexOf("=");
+        if (eq === -1)
+            continue; // malformed line: ignore
+        const key = line.slice(0, eq).trim();
+        const value = line.slice(eq + 1).trim();
+        switch (key) {
+            case "session_name":
+                if (value !== "")
+                    out.sessionName = value;
+                break;
+            case "layout":
+                if (LAYOUTS.has(value)) {
+                    out.layout = value;
+                }
+                else {
+                    throw new Error(`opencode-mux: invalid layout "${value}" (expected main-vertical | main-horizontal | tiled | even-horizontal | even-vertical)`);
+                }
+                break;
+            case "close_panes":
+                if (CLOSE_MODES.has(value)) {
+                    out.closePanes = value;
+                }
+                else {
+                    throw new Error(`opencode-mux: invalid close_panes "${value}" (expected auto | keep)`);
+                }
+                break;
+            case "main_pane_size": {
+                const n = Number(value);
+                if (!Number.isFinite(n) || n < 20 || n > 80) {
+                    throw new Error(`opencode-mux: invalid main_pane_size "${value}" (expected a number between 20 and 80)`);
+                }
+                out.mainPaneSize = Math.floor(n);
+                break;
+            }
+            case "grace": {
+                const n = Number(value);
+                if (!Number.isFinite(n) || n < 0) {
+                    throw new Error(`opencode-mux: invalid grace "${value}" (expected a non-negative number of seconds)`);
+                }
+                out.graceSeconds = Math.floor(n);
+                break;
+            }
+            case "parent":
+                out.parent = value === "" ? null : value;
+                break;
+            default:
+                break; // unknown keys are ignored for forward compatibility
+        }
+    }
+    return out;
+}
+export function configPath(env = process.env) {
+    const xdg = env.XDG_CONFIG_HOME;
+    const base = xdg && xdg !== "" ? xdg : join(homedir(), ".config");
+    return join(base, "opencode-mux.conf");
+}
+export async function loadConfig(opts = {}) {
+    const path = opts.path ?? configPath(opts.env ?? process.env);
+    let fromFile = {};
+    try {
+        fromFile = parseConfText(await readFile(path, "utf8"));
+    }
+    catch (error) {
+        if (error.code !== "ENOENT")
+            throw error;
+        // The config file is optional: create it with defaults when missing
+        // (best effort — a read-only environment still runs on defaults).
+        try {
+            await mkdir(dirname(path), { recursive: true });
+            await writeFile(path, defaultConfText(), "utf8");
+        }
+        catch {
+            // ignore write failures
+        }
+    }
+    const flags = opts.flags ?? {};
+    return {
+        sessionName: flags.sessionName ?? fromFile.sessionName ?? DEFAULT_CONFIG.sessionName,
+        layout: flags.layout ?? fromFile.layout ?? DEFAULT_CONFIG.layout,
+        closePanes: flags.closePanes ?? fromFile.closePanes ?? DEFAULT_CONFIG.closePanes,
+        graceSeconds: flags.graceSeconds ?? fromFile.graceSeconds ?? DEFAULT_CONFIG.graceSeconds,
+        mainPaneSize: flags.mainPaneSize ?? fromFile.mainPaneSize ?? DEFAULT_CONFIG.mainPaneSize,
+        parent: flags.parent !== undefined ? flags.parent : (fromFile.parent ?? DEFAULT_CONFIG.parent),
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/exec.d.ts

@@ -0,0 +1,12 @@
+export interface ExecResult {
+    ok: boolean;
+    code: number | null;
+    stdout: string;
+    stderr: string;
+    error: string | null;
+}
+export interface Exec {
+    run(command: string, args: string[]): Promise<ExecResult>;
+}
+/** Real subprocess runner; never throws — failures are returned as results. */
+export declare function nodeExec(): Exec;

package/dist/exec.js

@@ -0,0 +1,28 @@
+import { spawn } from "node:child_process";
+/** Real subprocess runner; never throws — failures are returned as results. */
+export function nodeExec() {
+    return {
+        run(command, args) {
+            return new Promise((resolve) => {
+                const child = spawn(command, args, { stdio: ["ignore", "pipe", "pipe"] });
+                let stdout = "";
+                let stderr = "";
+                child.stdout.setEncoding("utf8");
+                child.stderr.setEncoding("utf8");
+                child.stdout.on("data", (chunk) => {
+                    stdout += chunk;
+                });
+                child.stderr.on("data", (chunk) => {
+                    stderr += chunk;
+                });
+                child.on("error", (err) => {
+                    resolve({ ok: false, code: null, stdout, stderr, error: String(err) });
+                });
+                child.on("close", (code) => {
+                    resolve({ ok: code === 0, code, stdout, stderr, error: null });
+                });
+            });
+        },
+    };
+}
+//# sourceMappingURL=exec.js.map

package/dist/exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../src/exec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAc3C,+EAA+E;AAC/E,MAAM,UAAU,QAAQ;IACtB,OAAO;QACL,GAAG,CAAC,OAAO,EAAE,IAAI;YACf,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;gBAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;gBAC1E,IAAI,MAAM,GAAG,EAAE,CAAC;gBAChB,IAAI,MAAM,GAAG,EAAE,CAAC;gBAChB,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;gBACjC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;gBACjC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;oBACxC,MAAM,IAAI,KAAK,CAAC;gBAClB,CAAC,CAAC,CAAC;gBACH,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;oBACxC,MAAM,IAAI,KAAK,CAAC;gBAClB,CAAC,CAAC,CAAC;gBACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;oBACxB,OAAO,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACzE,CAAC,CAAC,CAAC;gBACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;oBACzB,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,KAAK,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;gBACjE,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,20 @@
+import { Service } from "@opencode/client/service";
+import type { OpenCodeClient, OpenCodeEvent, SessionInfo } from "@opencode/client";
+/** Client protocol generation, matched to the daemon's service protocol. */
+export type ServiceGeneration = "legacy" | "new";
+export interface ConnectServerDeps {
+    /** Selects the SDK line whose Service.ensure() speaks the daemon's protocol (/api/status vs /api/info). */
+    generation?: ServiceGeneration;
+    ensure?: typeof Service.ensure;
+    headers?: typeof Service.headers;
+}
+export interface ServerConnection {
+    url: string;
+    client: OpenCodeClient;
+}
+/** Connects to the shared local opencode service (injectable for tests). */
+export declare function connectServer(deps?: ConnectServerDeps): Promise<ServerConnection>;
+/** Adopts already-existing child sessions; parentID null means watch all. */
+export declare function childSessions(client: OpenCodeClient, parentID: string | null): Promise<SessionInfo[]>;
+/** Live event stream; ends when the server restarts (watcher exits, next launch resumes). */
+export declare function events(client: OpenCodeClient, signal: AbortSignal): Promise<AsyncIterable<OpenCodeEvent>>;

package/dist/server.js

@@ -0,0 +1,29 @@
+import { OpenCode } from "@opencode/client";
+import { Service } from "@opencode/client/service";
+import { OpenCode as LegacyOpenCode } from "@opencode/client-legacy";
+import { Service as LegacyService } from "@opencode/client-legacy/service";
+import { isChildSession } from "./session.js";
+/** Connects to the shared local opencode service (injectable for tests). */
+export async function connectServer(deps = {}) {
+    const legacy = deps.generation === "legacy";
+    const service = legacy ? LegacyService : Service;
+    const ensure = deps.ensure ?? service.ensure;
+    const headers = deps.headers ?? service.headers;
+    const endpoint = await ensure();
+    // Legacy 2.0.5's generated client has the same public session/event surface as 2.0.6
+    // but different internal RpcClient typings; adapt with a narrow cast at the boundary.
+    const client = legacy
+        ? LegacyOpenCode.make({ baseUrl: endpoint.url, headers: headers(endpoint) })
+        : OpenCode.make({ baseUrl: endpoint.url, headers: headers(endpoint) });
+    return { url: endpoint.url, client };
+}
+/** Adopts already-existing child sessions; parentID null means watch all. */
+export async function childSessions(client, parentID) {
+    const response = await client.session.list(parentID === null ? {} : { parentID });
+    return response.data.filter(isChildSession);
+}
+/** Live event stream; ends when the server restarts (watcher exits, next launch resumes). */
+export async function events(client, signal) {
+    return client.event.subscribe({ signal });
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAEnD,OAAO,EAAE,QAAQ,IAAI,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAiB9C,4EAA4E;AAC5E,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAA0B,EAAE;IAC9D,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,KAAK,QAAQ,CAAC;IAC5C,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC;IACjD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAChD,MAAM,QAAQ,GAAG,MAAM,MAAM,EAAE,CAAC;IAChC,qFAAqF;IACrF,sFAAsF;IACtF,MAAM,MAAM,GAAG,MAAM;QACnB,CAAC,CAAE,cAAc,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,CAA+B;QAC3G,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACzE,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC;AACvC,CAAC;AAED,6EAA6E;AAC7E,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAAsB,EAAE,QAAuB;IACjF,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;IAClF,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;AAC9C,CAAC;AAED,6FAA6F;AAC7F,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,MAAsB,EAAE,MAAmB;IACtE,OAAO,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;AAC5C,CAAC"}

package/dist/session.d.ts

@@ -0,0 +1,22 @@
+import type { OpenCodeEvent, SessionInfo } from "@opencode/client";
+export type EventClass = {
+    kind: "created";
+    sessionID: string;
+    parentID?: string;
+    title?: string;
+    slug: string;
+} | {
+    kind: "terminal";
+    sessionID: string;
+} | {
+    kind: "busy";
+    sessionID: string;
+} | {
+    kind: "other";
+};
+/** Classifies an SDK event into what the watcher reacts to. */
+export declare function classifyEvent(event: OpenCodeEvent): EventClass;
+/** True when the session is a subagent session (has a parent). */
+export declare function isChildSession(info: SessionInfo): boolean;
+/** Pane label: non-empty title, otherwise the fallback (slug or session id). */
+export declare function childTitle(title: string | undefined, fallback: string): string;

package/dist/session.js

@@ -0,0 +1,42 @@
+/** Classifies an SDK event into what the watcher reacts to. */
+export function classifyEvent(event) {
+    switch (event.type) {
+        case "session.created":
+            return {
+                kind: "created",
+                sessionID: event.data.sessionID,
+                parentID: event.data.parentID,
+                title: event.data.title,
+                slug: event.data.slug,
+            };
+        case "session.idle":
+        case "session.deleted":
+            return { kind: "terminal", sessionID: event.data.sessionID };
+        case "session.execution.started":
+            return { kind: "busy", sessionID: event.data.sessionID };
+        case "session.execution.succeeded":
+        case "session.execution.failed":
+        case "session.execution.interrupted":
+            // The daemon's turn-lifecycle signal (session.idle is deprecated and
+            // session.status is client-derived): opencode's own app reducer derives
+            // session busy/idle from these exact events.
+            return { kind: "terminal", sessionID: event.data.sessionID };
+        case "session.status":
+            if (event.data.status.type === "idle")
+                return { kind: "terminal", sessionID: event.data.sessionID };
+            if (event.data.status.type === "busy")
+                return { kind: "busy", sessionID: event.data.sessionID };
+            return { kind: "other" };
+        default:
+            return { kind: "other" };
+    }
+}
+/** True when the session is a subagent session (has a parent). */
+export function isChildSession(info) {
+    return info.parentID !== undefined;
+}
+/** Pane label: non-empty title, otherwise the fallback (slug or session id). */
+export function childTitle(title, fallback) {
+    return title !== undefined && title !== "" ? title : fallback;
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAQA,+DAA+D;AAC/D,MAAM,UAAU,aAAa,CAAC,KAAoB;IAChD,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,iBAAiB;YACpB,OAAO;gBACL,IAAI,EAAE,SAAS;gBACf,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS;gBAC/B,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ;gBAC7B,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK;gBACvB,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI;aACtB,CAAC;QACJ,KAAK,cAAc,CAAC;QACpB,KAAK,iBAAiB;YACpB,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QAC/D,KAAK,2BAA2B;YAC9B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QAC3D,KAAK,6BAA6B,CAAC;QACnC,KAAK,0BAA0B,CAAC;QAChC,KAAK,+BAA+B;YAClC,qEAAqE;YACrE,wEAAwE;YACxE,6CAA6C;YAC7C,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QAC/D,KAAK,gBAAgB;YACnB,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,MAAM;gBAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpG,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,MAAM;gBAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YAChG,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QAC3B;YACE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC7B,CAAC;AACH,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,cAAc,CAAC,IAAiB;IAC9C,OAAO,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC;AACrC,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,UAAU,CAAC,KAAyB,EAAE,QAAgB;IACpE,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;AAChE,CAAC"}