@mp-lb/termkit 0.0.1

package/README.md

@@ -0,0 +1,107 @@
+# @mp-lb/termkit
+
+Easily orchestrate terminal sessions in React. Render a `<Terminal />`, and manage
+all your live sessions — including their attention bells — with a small set of
+global hooks.
+
+## Mental model
+
+- A **session** is a long-lived shell (a PTY) living in the **daemon**
+  (`@mp-lb/termkit-server`), addressed by a stable id you choose.
+- A `<Terminal session={id} />` is just a **view** onto a session. Mounting it
+  attaches (reconnecting to the existing shell if there is one, via a replayed
+  screen snapshot); unmounting detaches but leaves the shell running.
+- The `<TermkitProvider>` holds the **global registry** of sessions and polls the
+  daemon for the live list. So there is **no one-to-one** requirement between the
+  terminals on screen and the sessions that are alive — you can have background
+  sessions with no terminal, and you can see/manage them from anywhere.
+
+## Two ways to use a session
+
+- **Local:** drop `<Terminal session="abc" />` somewhere. Rendering it creates or
+  reattaches session `abc`. Its lifecycle reads as component-local — but the
+  session itself outlives the component.
+- **Global:** use the hooks (`useSessions`, `useRingingSessions`,
+  `useTermkitActions`, …) anywhere under the provider to list every session, watch
+  which ones are **belling** for attention, and act on them — whether or not a
+  terminal is mounted for them.
+
+## Setup
+
+```tsx
+import { TermkitProvider } from "@mp-lb/termkit"
+
+const config = {
+  // Where the byte stream lives. `params` is forwarded to the daemon as session
+  // metadata and drives its resolveCwd.
+  connectionUrl: ({ sessionId, params }) =>
+    `ws://${location.host}/_terminal?` +
+    new URLSearchParams({ session: sessionId, ...params }),
+  // The control plane: list / kill / clear-bell. Wire to your backend.
+  transport: {
+    list: () => trpc.terminal.list.query(),
+    kill: (sessionId) => trpc.terminal.kill.mutate({ sessionId }),
+    seen: (sessionId) => trpc.terminal.seen.mutate({ sessionId }),
+  },
+}
+
+<TermkitProvider config={config}>
+  <App />
+</TermkitProvider>
+```
+
+## Rendering a terminal
+
+```tsx
+import { Terminal } from "@mp-lb/termkit"
+
+<Terminal session="global" autoFocus />
+<Terminal session={tab.id} params={{ slug: "myproject" }} />
+```
+
+Props: `session` (required, stable id), `params`, `autoFocus`, `dismissOnView`
+(default `true` — clear this session's bell when you view it), `pendingCommand`
+(auto-typed once after the prompt settles), `onExitFocus` (called on
+Ctrl+Shift+Enter, after termkit blurs the terminal), `className`, `style`.
+
+## Bells & session hooks
+
+```tsx
+const sessions = useSessions()             // LiveSession[] — the global list
+const ringing = useRingingSessions()       // Set<string> of ids belling for attention
+const isRinging = useIsRinging(id)          // one session
+const status = useSessionStatus(id)         // connecting | ready | disconnected | dead
+const { focus, kill, dismissBell, dismissAllBells, setPendingCommand } =
+  useTermkitActions()
+```
+
+Bells clear automatically when you view a session (`dismissOnView`), or explicitly
+via `dismissBell(id)` / `dismissAllBells()`.
+
+## Theming
+
+The terminal background resolves from `terminalOptions.background`, then the CSS
+custom property `--termkit-bg`, then `--background`, then a dark fallback — so it
+blends into the host theme.
+
+## Migrating dash onto termkit
+
+termkit is a superset of what `dash` does today; the mapping is mechanical:
+
+| dash | termkit |
+| --- | --- |
+| `<Terminal slot=… slug=… instanceId=… />` | `<Terminal session=… params={{ slug, instanceId }} />` |
+| `useTerminalStore` (zustand) | the provider store + `useTermkitActions` |
+| `live-sessions.ts` poller + `useLiveSessions` | built into `<TermkitProvider>` + `useSessions` |
+| `useRingingSessionIds` | `useRingingSessions` |
+| `markTerminalSeen` on focus/view | `dismissOnView` (default on) + `dismissBell` |
+| `LiveSession.slug` / `.instanceId` | `LiveSession.meta.slug` / `.meta.instanceId` |
+| exit-chord → focus `[data-session-tab]` | `onExitFocus` callback |
+| `useKnownSessionIds` / `useSessionSummaries` | **stay in dash** — built on `useSessions()` (project/slug grouping is dash domain) |
+| daemon (`server/terminal-daemon.ts`) | `createTerminalDaemon({ resolveCwd })` from `@mp-lb/termkit-server` |
+| tRPC `terminal` router | `createTerminalRouter(client)` from `@mp-lb/termkit-trpc`, or keep dash's |
+
+The dash-specific seams — the `~/Code` working-directory resolution and the
+project/instance groupings — are deliberately **not** baked in: the daemon takes a
+`resolveCwd` callback, and per-project rollups stay in dash, layered over the
+generic `useSessions()` list.

package/dist/Terminal.d.ts

@@ -0,0 +1,13 @@
+import "@xterm/xterm/css/xterm.css";
+export interface TerminalProps {
+    session: string;
+    params?: Record<string, string>;
+    autoFocus?: boolean;
+    dismissOnView?: boolean;
+    pendingCommand?: string;
+    onExitFocus?: () => void;
+    className?: string;
+    style?: React.CSSProperties;
+}
+export declare function Terminal({ session, params, autoFocus, dismissOnView, pendingCommand, onExitFocus, className, style, }: TerminalProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=Terminal.d.ts.map

package/dist/Terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Terminal.d.ts","sourceRoot":"","sources":["../src/Terminal.tsx"],"names":[],"mappings":"AAGA,OAAO,4BAA4B,CAAA;AASnC,MAAM,WAAW,aAAa;IAK5B,OAAO,EAAE,MAAM,CAAA;IAIf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAE/B,SAAS,CAAC,EAAE,OAAO,CAAA;IAKnB,aAAa,CAAC,EAAE,OAAO,CAAA;IAGvB,cAAc,CAAC,EAAE,MAAM,CAAA;IAIvB,WAAW,CAAC,EAAE,MAAM,IAAI,CAAA;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAA;CAC5B;AAYD,wBAAgB,QAAQ,CAAC,EACvB,OAAO,EACP,MAAM,EACN,SAAiB,EACjB,aAAoB,EACpB,cAAc,EACd,WAAW,EACX,SAAS,EACT,KAAK,GACN,EAAE,aAAa,2CAoQf"}

package/dist/Terminal.js

@@ -0,0 +1,289 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useRef } from "react";
+import { Terminal as XTerm } from "@xterm/xterm";
+import { FitAddon } from "@xterm/addon-fit";
+import "@xterm/xterm/css/xterm.css";
+import { CLOSE_SESSION_GONE, HEARTBEAT_INTERVAL_MS, HEARTBEAT_PONG_GRACE_MS, } from "@mp-lb/termkit-core";
+import { useTermkitContext } from "./context.js";
+function resolveBackground(explicit) {
+    if (explicit)
+        return explicit;
+    const root = getComputedStyle(document.documentElement);
+    return (root.getPropertyValue("--termkit-bg").trim() ||
+        root.getPropertyValue("--background").trim() ||
+        "#0a0a0a");
+}
+export function Terminal({ session, params, autoFocus = false, dismissOnView = true, pendingCommand, onExitFocus, className, style, }) {
+    const { store, config } = useTermkitContext();
+    const containerRef = useRef(null);
+    useEffect(() => {
+        const sessionId = session;
+        const { attach, detach, focus, blur, setStatus, setPendingCommand, consumePendingCommand } = store.getState();
+        attach(sessionId);
+        if (pendingCommand !== undefined)
+            setPendingCommand(sessionId, pendingCommand);
+        // Clear the bell when viewing the session, if dismissOnView is on. No-op
+        // otherwise. Safe on a brand-new session: the daemon no-ops seen on an unknown id.
+        const markSeen = () => {
+            if (dismissOnView)
+                config.transport.seen(sessionId).catch(() => { });
+        };
+        // Capture the node once so the cleanup closure references the same element even
+        // if the ref is repointed before teardown runs.
+        const container = containerRef.current;
+        const opts = config.terminalOptions ?? {};
+        const term = new XTerm({
+            fontFamily: opts.fontFamily ?? '"IBM Plex Mono", monospace',
+            fontSize: opts.fontSize ?? 13,
+            cursorBlink: opts.cursorBlink ?? true,
+            theme: { background: resolveBackground(opts.background) },
+        });
+        const fitAddon = new FitAddon();
+        term.loadAddon(fitAddon);
+        term.open(container);
+        fitAddon.fit();
+        // If a bell lands while you're actively looking at this session — its terminal
+        // is visible and the window has focus — it's already "seen", so clear it now
+        // instead of making you switch away and back. Bells that arrive while you're
+        // elsewhere are left to stand. term.dispose() tears this down.
+        term.onBell(() => {
+            if (document.hasFocus())
+                markSeen();
+        });
+        if (autoFocus) {
+            focus(sessionId);
+            term.focus();
+        }
+        else if (term.textarea) {
+            term.textarea.tabIndex = -1;
+        }
+        // Subscribe to store focus changes so external callers (focus/blur actions) work.
+        const unsubFocus = store.subscribe((state, prev) => {
+            const isFocused = state.focusedSlot === sessionId;
+            if (isFocused === (prev.focusedSlot === sessionId))
+                return;
+            if (isFocused) {
+                if (term.textarea)
+                    term.textarea.tabIndex = 0;
+                term.focus();
+            }
+            else {
+                term.blur();
+                if (term.textarea)
+                    term.textarea.tabIndex = -1;
+            }
+        });
+        // Wire textarea focus back to the store. Focusing a session also marks its
+        // bell seen — viewing the session is how you clear the badge.
+        const onFocus = () => {
+            focus(sessionId);
+            markSeen();
+        };
+        const onBlur = () => blur(sessionId);
+        term.textarea?.addEventListener("focus", onFocus);
+        term.textarea?.addEventListener("blur", onBlur);
+        // Ctrl+Shift+Enter exits terminal focus. Handled here (capture on the container,
+        // before xterm sees it) because global capture listeners don't reliably fire for
+        // Enter when xterm has focus. We blur and hand control back to the host.
+        const onExitChord = (e) => {
+            if (e.key === "Enter" && e.shiftKey && e.ctrlKey) {
+                e.preventDefault();
+                e.stopPropagation();
+                blur(sessionId);
+                onExitFocus?.();
+            }
+        };
+        container.addEventListener("keydown", onExitChord, true);
+        const url = config.connectionUrl({ sessionId, params: params ?? {} });
+        // The PTY lives in the daemon, a process that outlives dev-server restarts. So a
+        // dropped socket is transient, not the end of the session — reconnect, and on
+        // attach the daemon replays a snapshot of the current screen. `socket` is
+        // reassigned across reconnects; term.onData / resize read it through the closure.
+        let socket = null;
+        let reconnectTimer = null;
+        let disposed = false;
+        let attachedBefore = false;
+        // App-level heartbeat. A half-open socket (laptop sleep/wake, Wi-Fi change, a
+        // proxy hiccup) stays readyState===OPEN on both ends, so the terminal freezes
+        // with no 'close' to trigger a reconnect: keystrokes vanish into a dead socket
+        // and no output comes back. We round-trip a ping→pong over the full path; if no
+        // pong lands within the grace window we force-close, which runs onclose and
+        // reconnects to a fresh snapshot. (The daemon runs its own ping/terminate too;
+        // this catches the browser↔proxy hop a server-side ping can't observe.)
+        let heartbeatTimer = null;
+        let pongTimer = null;
+        const stopHeartbeat = () => {
+            if (heartbeatTimer !== null) {
+                clearInterval(heartbeatTimer);
+                heartbeatTimer = null;
+            }
+            if (pongTimer !== null) {
+                clearTimeout(pongTimer);
+                pongTimer = null;
+            }
+        };
+        const startHeartbeat = () => {
+            stopHeartbeat();
+            heartbeatTimer = setInterval(() => {
+                if (socket?.readyState !== WebSocket.OPEN)
+                    return;
+                socket.send(JSON.stringify({ type: "ping" }));
+                if (pongTimer === null) {
+                    pongTimer = setTimeout(() => {
+                        pongTimer = null;
+                        // Still OPEN but unresponsive → half-open. Close to trigger reconnect.
+                        try {
+                            socket?.close();
+                        }
+                        catch { /* already closing */ }
+                    }, HEARTBEAT_PONG_GRACE_MS);
+                }
+            }, HEARTBEAT_INTERVAL_MS);
+        };
+        const onPong = () => {
+            if (pongTimer !== null) {
+                clearTimeout(pongTimer);
+                pongTimer = null;
+            }
+        };
+        // Auto-type queue. We can't type the moment the socket attaches: the shell is
+        // still starting, so bytes get echoed in cooked mode and then redrawn when the
+        // line editor initialises — the command appears twice. Instead we wait for the
+        // prompt to finish painting, detected as output going quiet. `quiet` fires once
+        // the PTY has been silent for QUIET_MS after we first saw output; `cap` is a
+        // hard fallback so a prompt that never goes quiet (a clock/spinner in PS1)
+        // doesn't strand the command forever.
+        let pendingCmd = null;
+        let quietTimer = null;
+        let capTimer = null;
+        const QUIET_MS = 150;
+        const CAP_MS = 3000;
+        const send = (msg) => {
+            if (socket?.readyState === WebSocket.OPEN)
+                socket.send(JSON.stringify(msg));
+        };
+        const clearAutoType = () => {
+            if (quietTimer !== null) {
+                clearTimeout(quietTimer);
+                quietTimer = null;
+            }
+            if (capTimer !== null) {
+                clearTimeout(capTimer);
+                capTimer = null;
+            }
+        };
+        const flushPendingCmd = () => {
+            if (pendingCmd === null)
+                return;
+            const cmd = pendingCmd;
+            pendingCmd = null;
+            clearAutoType();
+            send({ type: "input", data: cmd + "\r" });
+        };
+        // Called on every chunk of PTY output while a command is queued: the shell is
+        // actively painting, so (re)start the quiet countdown — once it elapses with no
+        // further output, the prompt is settled and it's safe to type.
+        const noteOutput = () => {
+            if (pendingCmd === null)
+                return;
+            if (quietTimer !== null)
+                clearTimeout(quietTimer);
+            quietTimer = setTimeout(flushPendingCmd, QUIET_MS);
+        };
+        const sendResize = () => send({ type: "resize", cols: term.cols, rows: term.rows });
+        const connect = () => {
+            if (disposed)
+                return;
+            const ws = new WebSocket(url);
+            // Control frames (currently just PONG) arrive as binary; PTY output is text.
+            ws.binaryType = "arraybuffer";
+            socket = ws;
+            ws.onopen = () => {
+                startHeartbeat();
+                // On a reconnect the daemon sends a fresh full-screen snapshot; clear first
+                // so it repaints cleanly rather than stacking on stale content. (First
+                // attach: the terminal is already empty, so nothing to clear.)
+                const firstAttach = !attachedBefore;
+                if (attachedBefore)
+                    term.reset();
+                attachedBefore = true;
+                setStatus(sessionId, "ready");
+                sendResize();
+                // Run the queued command once, on the very first attach. Wait for the prompt
+                // to finish painting (see noteOutput/flushPendingCmd) so it lands on the real
+                // prompt instead of racing shell startup. The cap timer is a backstop.
+                if (firstAttach) {
+                    const cmd = consumePendingCommand(sessionId);
+                    if (cmd) {
+                        pendingCmd = cmd;
+                        capTimer = setTimeout(flushPendingCmd, CAP_MS);
+                    }
+                }
+                markSeen();
+            };
+            ws.onmessage = (e) => {
+                // Binary = control frame (pong), never PTY output. Keeps the data path
+                // untouched: text frames are still written straight to the terminal.
+                if (typeof e.data !== "string") {
+                    if (e.data instanceof ArrayBuffer) {
+                        try {
+                            const msg = JSON.parse(new TextDecoder().decode(e.data));
+                            if (msg.type === "pong")
+                                onPong();
+                        }
+                        catch { /* unknown control frame — ignore */ }
+                    }
+                    return;
+                }
+                term.write(e.data);
+                noteOutput();
+            };
+            ws.onclose = (e) => {
+                stopHeartbeat();
+                // 4001 = the daemon deliberately ended this session. That's terminal, not a
+                // transient drop, so don't reconnect — doing so would spawn a fresh shell
+                // for a session the user meant to be gone.
+                if (e.code === CLOSE_SESSION_GONE) {
+                    disposed = true;
+                    setStatus(sessionId, "dead");
+                    return;
+                }
+                setStatus(sessionId, "disconnected");
+                if (!disposed && reconnectTimer === null)
+                    reconnectTimer = setTimeout(() => {
+                        reconnectTimer = null;
+                        connect();
+                    }, 800);
+            };
+        };
+        connect();
+        term.onData((data) => send({ type: "input", data }));
+        const observer = new ResizeObserver(() => {
+            fitAddon.fit();
+            sendResize();
+        });
+        observer.observe(container);
+        return () => {
+            disposed = true;
+            if (reconnectTimer !== null)
+                clearTimeout(reconnectTimer);
+            stopHeartbeat();
+            clearAutoType();
+            blur(sessionId);
+            detach(sessionId);
+            unsubFocus();
+            observer.disconnect();
+            // Drop the close handler before closing so unmount doesn't trigger a reconnect.
+            if (socket) {
+                socket.onclose = null;
+                socket.close();
+            }
+            container.removeEventListener("keydown", onExitChord, true);
+            term.textarea?.removeEventListener("focus", onFocus);
+            term.textarea?.removeEventListener("blur", onBlur);
+            term.dispose();
+        };
+    }, [session]); // eslint-disable-line react-hooks/exhaustive-deps
+    return (_jsx("div", { ref: containerRef, className: className, style: { width: "100%", height: "100%", ...style } }));
+}
+//# sourceMappingURL=Terminal.js.map

package/dist/Terminal.js.map

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

package/dist/context.d.ts

@@ -0,0 +1,15 @@
+import { type ReactNode } from "react";
+import { type TermkitStore } from "./store.js";
+import type { TermkitConfig } from "./types.js";
+interface TermkitContextValue {
+    store: TermkitStore;
+    config: TermkitConfig;
+}
+export interface TermkitProviderProps {
+    config: TermkitConfig;
+    children: ReactNode;
+}
+export declare function TermkitProvider({ config, children }: TermkitProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function useTermkitContext(): TermkitContextValue;
+export {};
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAgD,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AACpF,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,YAAY,CAAA;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C,UAAU,mBAAmB;IAC3B,KAAK,EAAE,YAAY,CAAA;IACnB,MAAM,EAAE,aAAa,CAAA;CACtB;AAID,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,aAAa,CAAA;IACrB,QAAQ,EAAE,SAAS,CAAA;CACpB;AAOD,wBAAgB,eAAe,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,oBAAoB,2CAiCzE;AAED,wBAAgB,iBAAiB,IAAI,mBAAmB,CAIvD"}

package/dist/context.js

@@ -0,0 +1,50 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useEffect, useRef } from "react";
+import { createTermkitStore } from "./store.js";
+const TermkitContext = createContext(null);
+// Holds the global session registry and config for everything below it. Mount it
+// once near your app root. The registry lives here (not in each <Terminal>), which
+// is what makes sessions outlive the terminals that render them: a <Terminal> is
+// just a view onto a session, and the provider's poller keeps the live list fresh
+// whether or not any terminal is currently mounted for it.
+export function TermkitProvider({ config, children }) {
+    // Create the store once. Config is captured at first render; treat it as stable
+    // (define it outside render or memoize it host-side, like any context value).
+    const valueRef = useRef(null);
+    if (valueRef.current === null) {
+        valueRef.current = { store: createTermkitStore(config.transport), config };
+    }
+    const { store } = valueRef.current;
+    // The single poller: one fetch loop publishes the live snapshot every consumer
+    // reads. Cheap on the daemon (an in-memory map read), so a couple of seconds
+    // keeps bells and counts responsive without being chatty.
+    const intervalMs = config.pollIntervalMs ?? 2000;
+    useEffect(() => {
+        let cancelled = false;
+        async function tick() {
+            try {
+                const sessions = await config.transport.list();
+                if (!cancelled)
+                    store.getState().setLive(sessions);
+            }
+            catch {
+                /* transient — keep the last snapshot until the next tick */
+            }
+        }
+        tick();
+        const id = setInterval(tick, intervalMs);
+        return () => {
+            cancelled = true;
+            clearInterval(id);
+        };
+        // config.transport is captured once with the store; re-poll only if cadence changes.
+    }, [intervalMs, store, config.transport]);
+    return _jsx(TermkitContext.Provider, { value: valueRef.current, children: children });
+}
+export function useTermkitContext() {
+    const ctx = useContext(TermkitContext);
+    if (!ctx)
+        throw new Error("useTermkit must be used within a <TermkitProvider>");
+    return ctx;
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAkB,MAAM,OAAO,CAAA;AACpF,OAAO,EAAE,kBAAkB,EAAqB,MAAM,YAAY,CAAA;AAQlE,MAAM,cAAc,GAAG,aAAa,CAA6B,IAAI,CAAC,CAAA;AAOtE,iFAAiF;AACjF,mFAAmF;AACnF,iFAAiF;AACjF,kFAAkF;AAClF,2DAA2D;AAC3D,MAAM,UAAU,eAAe,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAwB;IACxE,gFAAgF;IAChF,8EAA8E;IAC9E,MAAM,QAAQ,GAAG,MAAM,CAA6B,IAAI,CAAC,CAAA;IACzD,IAAI,QAAQ,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QAC9B,QAAQ,CAAC,OAAO,GAAG,EAAE,KAAK,EAAE,kBAAkB,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IAC5E,CAAC;IACD,MAAM,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAA;IAElC,+EAA+E;IAC/E,6EAA6E;IAC7E,0DAA0D;IAC1D,MAAM,UAAU,GAAG,MAAM,CAAC,cAAc,IAAI,IAAI,CAAA;IAChD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,SAAS,GAAG,KAAK,CAAA;QACrB,KAAK,UAAU,IAAI;YACjB,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,CAAA;gBAC9C,IAAI,CAAC,SAAS;oBAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;YACpD,CAAC;YAAC,MAAM,CAAC;gBACP,4DAA4D;YAC9D,CAAC;QACH,CAAC;QACD,IAAI,EAAE,CAAA;QACN,MAAM,EAAE,GAAG,WAAW,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;QACxC,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAA;YAChB,aAAa,CAAC,EAAE,CAAC,CAAA;QACnB,CAAC,CAAA;QACD,qFAAqF;IACvF,CAAC,EAAE,CAAC,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAA;IAEzC,OAAO,KAAC,cAAc,CAAC,QAAQ,IAAC,KAAK,EAAE,QAAQ,CAAC,OAAO,YAAG,QAAQ,GAA2B,CAAA;AAC/F,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,MAAM,GAAG,GAAG,UAAU,CAAC,cAAc,CAAC,CAAA;IACtC,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAA;IAC/E,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/hooks.d.ts

@@ -0,0 +1,18 @@
+import type { LiveSession } from "@mp-lb/termkit-core";
+import type { SessionStatus } from "./types.js";
+export declare function useSessions(): LiveSession[];
+export declare function useSession(sessionId: string): LiveSession | undefined;
+export declare function useRingingSessions(): Set<string>;
+export declare function useIsRinging(sessionId: string): boolean;
+export declare function useSessionStatus(sessionId: string): SessionStatus | undefined;
+export declare function useDanglingSessions(known: Set<string>): LiveSession[];
+export interface TermkitActions {
+    focus: (sessionId: string) => void;
+    blur: (sessionId: string) => void;
+    kill: (sessionId: string) => void;
+    dismissBell: (sessionId: string) => void;
+    dismissAllBells: () => void;
+    setPendingCommand: (sessionId: string, command: string) => void;
+}
+export declare function useTermkitActions(): TermkitActions;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAEtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAK/C,wBAAgB,WAAW,IAAI,WAAW,EAAE,CAG3C;AAGD,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAGrE;AAID,wBAAgB,kBAAkB,IAAI,GAAG,CAAC,MAAM,CAAC,CAMhD;AAID,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEvD;AAID,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAG7E;AAMD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,WAAW,EAAE,CAGrE;AAED,MAAM,WAAW,cAAc;IAE7B,KAAK,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAA;IAEjC,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAA;IAEjC,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAA;IAExC,eAAe,EAAE,MAAM,IAAI,CAAA;IAE3B,iBAAiB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CAChE;AAID,wBAAgB,iBAAiB,IAAI,cAAc,CAelD"}

package/dist/hooks.js

@@ -0,0 +1,61 @@
+import { useMemo } from "react";
+import { useStore } from "zustand";
+import { useTermkitContext } from "./context.js";
+// The live snapshot of every session the daemon is running — the "global" view,
+// kept fresh by the provider's poller. Independent of which <Terminal>s are
+// mounted: a backgrounded agent session shows up here with no terminal on screen.
+export function useSessions() {
+    const { store } = useTermkitContext();
+    return useStore(store, (s) => s.live);
+}
+// One live session by id, or undefined if it isn't running.
+export function useSession(sessionId) {
+    const sessions = useSessions();
+    return useMemo(() => sessions.find((s) => s.sessionId === sessionId), [sessions, sessionId]);
+}
+// The set of session ids currently ringing for attention — the bells. Render a
+// badge for any tab whose id is in here.
+export function useRingingSessions() {
+    const sessions = useSessions();
+    return useMemo(() => new Set(sessions.filter((s) => s.attention).map((s) => s.sessionId)), [sessions]);
+}
+// Whether a specific session is ringing. Convenience over useRingingSessions for a
+// single tab.
+export function useIsRinging(sessionId) {
+    return useSession(sessionId)?.attention ?? false;
+}
+// A mounted <Terminal>'s client-side connection status (connecting / ready /
+// disconnected / dead). Undefined if no terminal is attached for this session.
+export function useSessionStatus(sessionId) {
+    const { store } = useTermkitContext();
+    return useStore(store, (s) => s.slots[sessionId]?.status);
+}
+// Live PTYs with no matching id in `known` — orphaned shells. Pass the set of ids
+// your UI knows about (its tabs); anything live but unknown is a dangler you can
+// surface for cleanup. The known-id bookkeeping is host domain, so it lives there;
+// termkit just does the diff.
+export function useDanglingSessions(known) {
+    const sessions = useSessions();
+    return useMemo(() => sessions.filter((s) => !known.has(s.sessionId)), [sessions, known]);
+}
+// Imperative session controls. Stable across renders (the store identity is
+// stable), so safe to use without memoising.
+export function useTermkitActions() {
+    const { store } = useTermkitContext();
+    return useMemo(() => {
+        const s = () => store.getState();
+        return {
+            focus: (id) => s().focus(id),
+            blur: (id) => s().blur(id),
+            kill: (id) => s().kill(id),
+            dismissBell: (id) => s().dismissBell(id),
+            dismissAllBells: () => {
+                for (const sess of s().live)
+                    if (sess.attention)
+                        s().dismissBell(sess.sessionId);
+            },
+            setPendingCommand: (id, command) => s().setPendingCommand(id, command),
+        };
+    }, [store]);
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { TermkitProvider } from "./context.js";
+export type { TermkitProviderProps } from "./context.js";
+export { Terminal } from "./Terminal.js";
+export type { TerminalProps } from "./Terminal.js";
+export { useSessions, useSession, useRingingSessions, useIsRinging, useSessionStatus, useDanglingSessions, useTermkitActions, } from "./hooks.js";
+export type { TermkitActions } from "./hooks.js";
+export type { TermkitConfig, TermkitTransport, TermkitTerminalOptions, SessionStatus, LiveSession, } from "./types.js";
+export { generateSessionName, SESSION_NAMES } from "@mp-lb/termkit-core";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC9C,YAAY,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAElD,OAAO,EACL,WAAW,EACX,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,YAAY,CAAA;AACnB,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,sBAAsB,EACtB,aAAa,EACb,WAAW,GACZ,MAAM,YAAY,CAAA;AAGnB,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/index.js

@@ -0,0 +1,13 @@
+// @mp-lb/termkit — easily orchestrate terminal sessions in React.
+//
+// Mount a <TermkitProvider> once near your app root with a connection URL and a
+// transport, then render <Terminal session="..."/> anywhere. The provider holds a
+// global session registry, so sessions outlive the terminals that render them —
+// read the live list, watch for bells, and manage sessions with the hooks below,
+// whether or not a terminal for them is currently on screen.
+export { TermkitProvider } from "./context.js";
+export { Terminal } from "./Terminal.js";
+export { useSessions, useSession, useRingingSessions, useIsRinging, useSessionStatus, useDanglingSessions, useTermkitActions, } from "./hooks.js";
+// Re-export the session-name helper so hosts can label new sessions consistently.
+export { generateSessionName, SESSION_NAMES } from "@mp-lb/termkit-core";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,EAAE;AACF,gFAAgF;AAChF,kFAAkF;AAClF,gFAAgF;AAChF,iFAAiF;AACjF,6DAA6D;AAE7D,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAE9C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAGxC,OAAO,EACL,WAAW,EACX,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,YAAY,CAAA;AAWnB,kFAAkF;AAClF,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/store.d.ts

@@ -0,0 +1,27 @@
+import { type StoreApi } from "zustand/vanilla";
+import type { LiveSession } from "@mp-lb/termkit-core";
+import type { SessionStatus, TermkitTransport } from "./types.js";
+interface TerminalSlot {
+    sessionId: string;
+    status: SessionStatus;
+}
+export interface TermkitState {
+    slots: Record<string, TerminalSlot>;
+    focusedSlot: string | null;
+    pendingCommands: Record<string, string>;
+    live: LiveSession[];
+    attach: (sessionId: string) => void;
+    detach: (sessionId: string) => void;
+    setStatus: (sessionId: string, status: SessionStatus) => void;
+    focus: (sessionId: string) => void;
+    blur: (sessionId: string) => void;
+    setPendingCommand: (sessionId: string, command: string) => void;
+    consumePendingCommand: (sessionId: string) => string | null;
+    kill: (sessionId: string) => void;
+    dismissBell: (sessionId: string) => void;
+    setLive: (live: LiveSession[]) => void;
+}
+export type TermkitStore = StoreApi<TermkitState>;
+export declare function createTermkitStore(transport: TermkitTransport): TermkitStore;
+export {};
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAOjE,UAAU,YAAY;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,aAAa,CAAA;CACtB;AAED,MAAM,WAAW,YAAY;IAE3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IAEnC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAI1B,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAIvC,IAAI,EAAE,WAAW,EAAE,CAAA;IAGnB,MAAM,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAA;IACnC,MAAM,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAA;IACnC,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,KAAK,IAAI,CAAA;IAG7D,KAAK,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAA;IAGjC,iBAAiB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAC/D,qBAAqB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAA;IAG3D,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAA;IACjC,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAA;IAGxC,OAAO,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,IAAI,CAAA;CACvC;AAED,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAA;AAEjD,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,gBAAgB,GAAG,YAAY,CAwF5E"}

package/dist/store.js

@@ -0,0 +1,85 @@
+import { createStore } from "zustand/vanilla";
+export function createTermkitStore(transport) {
+    return createStore((set, get) => ({
+        slots: {},
+        focusedSlot: null,
+        pendingCommands: {},
+        live: [],
+        attach(sessionId) {
+            const existing = get().slots[sessionId];
+            if (existing && existing.status !== "dead")
+                return;
+            set((s) => ({
+                slots: { ...s.slots, [sessionId]: { sessionId, status: "connecting" } },
+            }));
+        },
+        detach(sessionId) {
+            set((s) => {
+                if (!(sessionId in s.slots))
+                    return s;
+                const slots = { ...s.slots };
+                delete slots[sessionId];
+                return { slots, focusedSlot: s.focusedSlot === sessionId ? null : s.focusedSlot };
+            });
+        },
+        setStatus(sessionId, status) {
+            set((s) => {
+                const slot = s.slots[sessionId];
+                if (!slot)
+                    return s;
+                return { slots: { ...s.slots, [sessionId]: { ...slot, status } } };
+            });
+        },
+        focus(sessionId) {
+            set({ focusedSlot: sessionId });
+        },
+        blur(sessionId) {
+            set((s) => ({ focusedSlot: s.focusedSlot === sessionId ? null : s.focusedSlot }));
+        },
+        setPendingCommand(sessionId, command) {
+            set((s) => ({ pendingCommands: { ...s.pendingCommands, [sessionId]: command } }));
+        },
+        consumePendingCommand(sessionId) {
+            const command = get().pendingCommands[sessionId];
+            if (command === undefined)
+                return null;
+            set((s) => {
+                const pendingCommands = { ...s.pendingCommands };
+                delete pendingCommands[sessionId];
+                return { pendingCommands };
+            });
+            return command;
+        },
+        kill(sessionId) {
+            // The daemon session id IS the slot, so we can always reap the PTY — no
+            // lookup that could miss and leave a shell running.
+            transport.kill(sessionId).catch(() => { });
+            set((s) => {
+                const slots = { ...s.slots };
+                delete slots[sessionId];
+                const pendingCommands = { ...s.pendingCommands };
+                delete pendingCommands[sessionId];
+                // Drop it from the live snapshot too so the UI updates before the next
+                // poll tick, rather than showing a session that's already gone.
+                return {
+                    slots,
+                    pendingCommands,
+                    live: s.live.filter((l) => l.sessionId !== sessionId),
+                    focusedSlot: s.focusedSlot === sessionId ? null : s.focusedSlot,
+                };
+            });
+        },
+        dismissBell(sessionId) {
+            transport.seen(sessionId).catch(() => { });
+            // Optimistically clear attention so the badge goes away immediately; the
+            // next poll confirms it.
+            set((s) => ({
+                live: s.live.map((l) => (l.sessionId === sessionId ? { ...l, attention: false } : l)),
+            }));
+        },
+        setLive(live) {
+            set({ live });
+        },
+    }));
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,24 @@
+import type { LiveSession } from "@mp-lb/termkit-core";
+export type SessionStatus = "connecting" | "ready" | "disconnected" | "dead";
+export interface TermkitTransport {
+    list: () => Promise<LiveSession[]>;
+    kill: (sessionId: string) => Promise<unknown>;
+    seen: (sessionId: string) => Promise<unknown>;
+}
+export interface TermkitTerminalOptions {
+    fontFamily?: string;
+    fontSize?: number;
+    cursorBlink?: boolean;
+    background?: string;
+}
+export interface TermkitConfig {
+    connectionUrl: (args: {
+        sessionId: string;
+        params: Record<string, string>;
+    }) => string;
+    transport: TermkitTransport;
+    pollIntervalMs?: number;
+    terminalOptions?: TermkitTerminalOptions;
+}
+export type { LiveSession };
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAKtD,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,OAAO,GAAG,cAAc,GAAG,MAAM,CAAA;AAO5E,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC,CAAA;IAClC,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC7C,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAC9C;AAGD,MAAM,WAAW,sBAAsB;IACrC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,OAAO,CAAA;IAGrB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAKD,MAAM,WAAW,aAAa;IAO5B,aAAa,EAAE,CAAC,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,KAAK,MAAM,CAAA;IACtF,SAAS,EAAE,gBAAgB,CAAA;IAE3B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,eAAe,CAAC,EAAE,sBAAsB,CAAA;CACzC;AAED,YAAY,EAAE,WAAW,EAAE,CAAA"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@mp-lb/termkit",
+  "version": "0.0.1",
+  "private": false,
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "package.json",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@xterm/addon-fit": "^0.11.0",
+    "@xterm/xterm": "^6.0.0",
+    "zustand": "^5.0.14",
+    "@mp-lb/termkit-core": "0.0.1"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19",
+    "react": "^19.2.6"
+  },
+  "scripts": {
+    "build": "tsc --project tsconfig.json",
+    "dev": "tsc --project tsconfig.json --watch --preserveWatchOutput",
+    "typecheck": "tsc --project tsconfig.json --noEmit",
+    "test": "vitest run"
+  }
+}