opencode-mux 0.1.0

package/dist/version.d.ts

@@ -0,0 +1 @@
+export declare const VERSION = "0.1.0";

package/dist/version.js

@@ -0,0 +1,2 @@
+export const VERSION = "0.1.0";
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/dist/watch.d.ts

@@ -0,0 +1,34 @@
+import type { OpenCodeClient, OpenCodeEvent } from "@opencode/client";
+import type { Layout } from "./config.js";
+import type { PaneTracker } from "./tracker.js";
+import type { BorderStyles, Tmux } from "./tmux.js";
+export interface WatchDeps {
+    client: OpenCodeClient;
+    tmux: Tmux;
+    tracker: PaneTracker;
+    log: (line: string) => void;
+    targetPane?: string;
+    layout: Layout;
+    mainPaneSize?: number;
+    /**
+     * Resolves the active theme's border styles. Applied at start and re-applied
+     * on tick whenever the resolved styles change; null clears the styles.
+     */
+    themeStyles?: {
+        current(): BorderStyles | null;
+    };
+    parentID: string | null;
+    paneArgv?: (sessionID: string) => string[];
+    tickEveryMs: number;
+    now?: () => number;
+}
+export interface Watcher {
+    adopt(): Promise<void>;
+    dispatch(event: OpenCodeEvent): Promise<void>;
+    tick(now: number): Promise<void>;
+    start(signal: AbortSignal): Promise<void>;
+}
+/** Pane command: attach the child session in the new pane via the minimal mini UI (no tab bar, no agent switcher). */
+export declare function defaultPaneArgv(sessionID: string): string[];
+/** Wires server events → tracker state machine → tmux actions. */
+export declare function createWatcher(deps: WatchDeps): Watcher;

package/dist/watch.js

@@ -0,0 +1,166 @@
+import { childTitle, classifyEvent } from "./session.js";
+import { childSessions, events } from "./server.js";
+import { currentPane } from "./tmux.js";
+/** Pane command: attach the child session in the new pane via the minimal mini UI (no tab bar, no agent switcher). */
+export function defaultPaneArgv(sessionID) {
+    return ["opencode", "mini", "-s", sessionID];
+}
+/** Wires server events → tracker state machine → tmux actions. */
+export function createWatcher(deps) {
+    const targetPane = deps.targetPane ?? currentPane(process.env);
+    if (targetPane === null) {
+        throw new Error("opencode-mux: watcher requires TMUX_PANE (run inside tmux)");
+    }
+    const paneArgv = deps.paneArgv ?? defaultPaneArgv;
+    const now = deps.now ?? Date.now;
+    const log = deps.log;
+    const openPane = async (sessionID, title) => {
+        const argv = paneArgv(sessionID);
+        const result = await deps.tmux.splitPane({ targetPane, layout: deps.layout, mainPaneSize: deps.mainPaneSize, argv });
+        if (!result.ok || result.paneId === null) {
+            log(`action failed: split-window ${argv.join(" ")} — ${result.error ?? "unknown error"}`);
+            return null;
+        }
+        log(`opened pane ${result.paneId} for session ${sessionID} (${title})`);
+        return result.paneId;
+    };
+    /** Reserve and split a new pane for the session, then record the open phase. */
+    const openTracked = async (sessionID, title) => {
+        if (!deps.tracker.reserve(sessionID))
+            return;
+        const paneId = await openPane(sessionID, title);
+        if (paneId === null) {
+            deps.tracker.remove(sessionID);
+            return;
+        }
+        deps.tracker.open(sessionID, paneId, now());
+    };
+    const applyAction = async (action) => {
+        if (action.kind !== "close")
+            return;
+        const result = await deps.tmux.killPane(action.paneId);
+        if (!result.ok) {
+            log(`action failed: kill-pane ${action.paneId} — ${result.error ?? "unknown error"}`);
+        }
+    };
+    const applyTick = async (nowMs) => {
+        for (const action of deps.tracker.tick(nowMs)) {
+            await applyAction(action);
+        }
+    };
+    /** JSON of the styles last applied to the window (null when none/cleared). */
+    let appliedThemeSig = null;
+    /**
+     * Applies the resolved theme's border styles, or clears them when the theme
+     * became null. No tmux calls when the provider is absent or unchanged;
+     * failures are logged at most once per change and never fail the watcher.
+     */
+    const syncTheme = async () => {
+        if (deps.themeStyles === undefined)
+            return;
+        let styles;
+        let sig;
+        try {
+            styles = deps.themeStyles.current();
+            sig = JSON.stringify(styles);
+        }
+        catch (error) {
+            log(`styling failed: ${String(error)}`);
+            appliedThemeSig = "error";
+            return;
+        }
+        if (sig === appliedThemeSig)
+            return;
+        appliedThemeSig = sig;
+        if (styles === null) {
+            const result = await deps.tmux.clearBorderStyles(targetPane);
+            if (!result.ok)
+                log(`styling failed: clear — ${result.error ?? "unknown error"}`);
+            return;
+        }
+        const result = await deps.tmux.applyBorderStyles(targetPane, styles);
+        if (!result.ok)
+            log(`styling failed: ${result.error ?? "unknown error"}`);
+    };
+    const watcher = {
+        async adopt() {
+            try {
+                const active = await deps.client.session.active();
+                const children = await childSessions(deps.client, deps.parentID);
+                for (const info of children) {
+                    // Only currently-executing children need a pane. Finished children
+                    // from previous runs are skipped outright: opening one just to close
+                    // it again flashed panes at startup (their panes were already closed
+                    // when they completed).
+                    if (!(info.id in active))
+                        continue;
+                    await openTracked(info.id, childTitle(info.title, info.id));
+                }
+                await applyTick(now());
+            }
+            catch (error) {
+                log(`adopt failed: ${String(error)}`);
+            }
+        },
+        async dispatch(event) {
+            const cls = classifyEvent(event);
+            if (cls.kind === "created") {
+                if (cls.parentID === undefined)
+                    return;
+                if (deps.parentID !== null && cls.parentID !== deps.parentID)
+                    return;
+                await openTracked(cls.sessionID, childTitle(cls.title, cls.slug));
+                return;
+            }
+            if (cls.kind === "terminal") {
+                deps.tracker.markTerminal(cls.sessionID, now());
+                return;
+            }
+            if (cls.kind === "busy") {
+                deps.tracker.markBusy(cls.sessionID);
+            }
+        },
+        async tick(nowMs) {
+            await applyTick(nowMs);
+            await syncTheme();
+        },
+        async start(signal) {
+            if (deps.themeStyles !== undefined) {
+                // Apply the initial value once, before the polling loop starts.
+                try {
+                    const initial = deps.themeStyles.current();
+                    appliedThemeSig = JSON.stringify(initial);
+                    if (initial !== null) {
+                        const result = await deps.tmux.applyBorderStyles(targetPane, initial);
+                        if (!result.ok)
+                            log(`styling failed: ${result.error ?? "unknown error"}`);
+                    }
+                }
+                catch (error) {
+                    log(`styling failed: ${String(error)}`);
+                    appliedThemeSig = "error";
+                }
+            }
+            const timer = setInterval(() => void watcher.tick(now()), deps.tickEveryMs);
+            timer.unref();
+            signal.addEventListener("abort", () => clearInterval(timer), { once: true });
+            try {
+                await watcher.adopt();
+                const stream = await events(deps.client, signal);
+                for await (const event of stream) {
+                    await watcher.dispatch(event);
+                    await watcher.tick(now());
+                }
+            }
+            catch (error) {
+                if (!signal.aborted)
+                    log(`watcher error: ${String(error)}`);
+            }
+            finally {
+                clearInterval(timer);
+            }
+        },
+    };
+    return watcher;
+}
+//# sourceMappingURL=watch.js.map

package/dist/watch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.js","sourceRoot":"","sources":["../src/watch.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGpD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AA4BxC,sHAAsH;AACtH,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;AAC/C,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,aAAa,CAAC,IAAe;IAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC/D,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAChF,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,eAAe,CAAC;IAClD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IACjC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;IAErB,MAAM,QAAQ,GAAG,KAAK,EAAE,SAAiB,EAAE,KAAa,EAA0B,EAAE;QAClF,MAAM,IAAI,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;QACjC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;QACrH,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YACzC,GAAG,CAAC,+BAA+B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,KAAK,IAAI,eAAe,EAAE,CAAC,CAAC;YAC1F,OAAO,IAAI,CAAC;QACd,CAAC;QACD,GAAG,CAAC,eAAe,MAAM,CAAC,MAAM,gBAAgB,SAAS,KAAK,KAAK,GAAG,CAAC,CAAC;QACxE,OAAO,MAAM,CAAC,MAAM,CAAC;IACvB,CAAC,CAAC;IAEF,gFAAgF;IAChF,MAAM,WAAW,GAAG,KAAK,EAAE,SAAiB,EAAE,KAAa,EAAiB,EAAE;QAC5E,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC;YAAE,OAAO;QAC7C,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAChD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACpB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC/B,OAAO;QACT,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IAC9C,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,KAAK,EAAE,MAAqB,EAAiB,EAAE;QACjE,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO;YAAE,OAAO;QACpC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACvD,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,GAAG,CAAC,4BAA4B,MAAM,CAAC,MAAM,MAAM,MAAM,CAAC,KAAK,IAAI,eAAe,EAAE,CAAC,CAAC;QACxF,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,KAAK,EAAE,KAAa,EAAiB,EAAE;QACvD,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9C,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CAAC;IAEF,8EAA8E;IAC9E,IAAI,eAAe,GAAkB,IAAI,CAAC;IAE1C;;;;OAIG;IACH,MAAM,SAAS,GAAG,KAAK,IAAmB,EAAE;QAC1C,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS;YAAE,OAAO;QAC3C,IAAI,MAA2B,CAAC;QAChC,IAAI,GAAW,CAAC;QAChB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;YACpC,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,GAAG,CAAC,mBAAmB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACxC,eAAe,GAAG,OAAO,CAAC;YAC1B,OAAO;QACT,CAAC;QACD,IAAI,GAAG,KAAK,eAAe;YAAE,OAAO;QACpC,eAAe,GAAG,GAAG,CAAC;QACtB,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACpB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;YAC7D,IAAI,CAAC,MAAM,CAAC,EAAE;gBAAE,GAAG,CAAC,2BAA2B,MAAM,CAAC,KAAK,IAAI,eAAe,EAAE,CAAC,CAAC;YAClF,OAAO;QACT,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACrE,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,GAAG,CAAC,mBAAmB,MAAM,CAAC,KAAK,IAAI,eAAe,EAAE,CAAC,CAAC;IAC5E,CAAC,CAAC;IAEF,MAAM,OAAO,GAAY;QACvB,KAAK,CAAC,KAAK;YACT,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;gBAClD,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACjE,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;oBAC5B,mEAAmE;oBACnE,qEAAqE;oBACrE,qEAAqE;oBACrE,wBAAwB;oBACxB,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,MAAM,CAAC;wBAAE,SAAS;oBACnC,MAAM,WAAW,CAAC,IAAI,CAAC,EAAE,EAAE,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC9D,CAAC;gBACD,MAAM,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC;YACzB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,GAAG,CAAC,iBAAiB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;QAED,KAAK,CAAC,QAAQ,CAAC,KAAK;YAClB,MAAM,GAAG,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;YACjC,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC3B,IAAI,GAAG,CAAC,QAAQ,KAAK,SAAS;oBAAE,OAAO;gBACvC,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,IAAI,GAAG,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ;oBAAE,OAAO;gBACrE,MAAM,WAAW,CAAC,GAAG,CAAC,SAAS,EAAE,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;gBAClE,OAAO;YACT,CAAC;YACD,IAAI,GAAG,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBAC5B,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;gBAChD,OAAO;YACT,CAAC;YACD,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBACxB,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,KAAK;YACd,MAAM,SAAS,CAAC,KAAK,CAAC,CAAC;YACvB,MAAM,SAAS,EAAE,CAAC;QACpB,CAAC;QAED,KAAK,CAAC,KAAK,CAAC,MAAM;YAChB,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;gBACnC,gEAAgE;gBAChE,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;oBAC3C,eAAe,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;oBAC1C,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;wBACrB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;wBACtE,IAAI,CAAC,MAAM,CAAC,EAAE;4BAAE,GAAG,CAAC,mBAAmB,MAAM,CAAC,KAAK,IAAI,eAAe,EAAE,CAAC,CAAC;oBAC5E,CAAC;gBACH,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,GAAG,CAAC,mBAAmB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;oBACxC,eAAe,GAAG,OAAO,CAAC;gBAC5B,CAAC;YACH,CAAC;YACD,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;YAC5E,KAAK,CAAC,KAAK,EAAE,CAAC;YACd,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7E,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;gBACtB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBACjD,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;oBACjC,MAAM,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;oBAC9B,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;gBAC5B,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,MAAM,CAAC,OAAO;oBAAE,GAAG,CAAC,kBAAkB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC9D,CAAC;oBAAS,CAAC;gBACT,aAAa,CAAC,KAAK,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;KACF,CAAC;IACF,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "opencode-mux",
+  "version": "0.1.0",
+  "description": "Drop-in opencode wrapper that opens tmux panes for subagent sessions automatically",
+  "type": "module",
+  "bin": { "opencode-mux": "./dist/bin.js" },
+  "files": ["dist"],
+  "engines": { "node": ">=20" },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "check": "tsc --noEmit",
+    "test": "vitest run",
+    "smoke": "tsx scripts/e2e-smoke.ts",
+    "prepublishOnly": "npm run check && npm test && npm run build"
+  },
+  "dependencies": {
+    "@opencode/client": "^2.0.6",
+    "@opencode/client-legacy": "npm:@opencode/client@2.0.5"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0",
+    "vitest": "^4.1.11"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/DemonGPT/opencode-mux"
+  },
+  "publishConfig": { "access": "public" },
+  "keywords": ["opencode", "tmux", "subagent", "multiplexer", "wrapper", "tui"]
+}