@volter/supercode-terminal 0.2.30

package/stream.d.ts

@@ -0,0 +1,3 @@
+import { TerminalViewer, type TerminalConnector } from './ui.js';
+export type { TerminalConnector, TerminalStreamHandlers } from './ui.js';
+export const TerminalStreamViewer: (props: Parameters<typeof TerminalViewer>[0] & { connect: TerminalConnector }) => ReturnType<typeof TerminalViewer>;

package/stream.mjs

@@ -0,0 +1,446 @@
+// src/ui.jsx
+import { useEffect, useMemo, useRef, useState } from "preact/hooks";
+import { Fragment, jsx, jsxs } from "preact/jsx-runtime";
+var DEFAULT_LABELS = Object.freeze({
+  back: "Back to terminals",
+  control: "Control",
+  empty: "No terminal sessions are running.",
+  open: "Open",
+  refresh: "Refresh",
+  // what a session with no observed cwd or command is
+  session: "tmux session",
+  stop: "Stop",
+  subtitle: "Local tmux sessions",
+  title: "Terminals",
+  view: "View"
+});
+var WORKSPACE_LABELS = Object.freeze({
+  ...DEFAULT_LABELS,
+  attach: "Open session",
+  back: "Back to chats",
+  closeTab: "Detach terminal",
+  newTerminal: "New terminal",
+  noTabs: "Open a local session or start a new coding agent.",
+  open: "Open locally",
+  sessions: "Sessions",
+  fitViewport: "Fit terminal to window",
+  scaleViewport: "Keep terminal grid scaled",
+  stop: "Stop session",
+  terminal: "Terminal"
+});
+var TERMINAL_THEME_SLOTS = ["foreground", "cursor", "black", "red", "green", "yellow", "blue", "magenta", "cyan", "white", "brightBlack", "brightRed", "brightGreen", "brightYellow", "brightBlue", "brightMagenta", "brightCyan", "brightWhite"];
+function terminalTheme(element) {
+  const probe = element.ownerDocument.createElement("span");
+  probe.hidden = true;
+  element.append(probe);
+  const theme = { background: "rgba(0, 0, 0, 0)" };
+  for (const slot of TERMINAL_THEME_SLOTS) {
+    const name = `--sctui-terminal-${slot.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`)}`;
+    probe.style.color = `var(${name}, var(${name}-default))`;
+    theme[slot] = getComputedStyle(probe).color;
+  }
+  probe.remove();
+  return theme;
+}
+function TerminalStreamViewer({ active = true, attachment, connect, convertEol = false, onReady, onActivity, onBell, onOpenLink, onRetry, onStatus, onTitle }) {
+  const root = useRef(null);
+  const runtime = useRef(null);
+  const searchInput = useRef(null);
+  const pasteDialog = useRef(null);
+  const bellTimer = useRef(null);
+  const activeRef = useRef(active);
+  const callbacks = useRef({});
+  const [status, setStatus] = useState("Loading terminal\u2026");
+  const [bellVisible, setBellVisible] = useState(false);
+  const [findOpen, setFindOpen] = useState(false);
+  const [findQuery, setFindQuery] = useState("");
+  const [findFound, setFindFound] = useState(null);
+  const [helpOpen, setHelpOpen] = useState(false);
+  const [historyOpen, setHistoryOpen] = useState(false);
+  const [pasteHistory, setPasteHistory] = useState([]);
+  const [pendingPaste, setPendingPaste] = useState(null);
+  activeRef.current = active;
+  callbacks.current = { onActivity, onBell, onOpenLink, onRetry, onStatus, onTitle };
+  const publishStatus = (next) => {
+    setStatus(next);
+    callbacks.current.onStatus?.(next);
+  };
+  const focusTerminal = () => runtime.current?.terminal.focus();
+  const closeFind = () => {
+    runtime.current?.search.clearDecorations();
+    setFindOpen(false);
+    queueMicrotask(focusTerminal);
+  };
+  const find = (direction = "next", query = findQuery) => {
+    if (!query || !runtime.current) return;
+    const found = runtime.current.search[direction === "previous" ? "findPrevious" : "findNext"](query, {
+      incremental: direction === "next"
+    });
+    setFindFound(found);
+  };
+  const openFind = () => {
+    setHelpOpen(false);
+    setHistoryOpen(false);
+    setFindOpen(true);
+    queueMicrotask(() => searchInput.current?.focus());
+  };
+  const sendPaste = (value, remember = true) => {
+    runtime.current?.terminal.paste(value);
+    if (!remember || value.length > 5e4) return;
+    setPasteHistory((current) => [value, ...current.filter((item) => item !== value)].slice(0, 20));
+  };
+  const proposePaste = (value) => {
+    setHistoryOpen(false);
+    if (value.length > 1e3 || /[\r\n]/.test(value)) setPendingPaste(value);
+    else sendPaste(value);
+  };
+  const saveContents = () => {
+    const terminal = runtime.current?.terminal;
+    if (!terminal) return;
+    const buffer = terminal.buffer.normal;
+    const lines = [];
+    for (let index = 0; index < buffer.length; index += 1) {
+      lines.push(buffer.getLine(index)?.translateToString(true) ?? "");
+    }
+    const blob = new Blob([`${lines.join("\n")}
+`], { type: "text/plain;charset=utf-8" });
+    const url = URL.createObjectURL(blob);
+    const link = document.createElement("a");
+    const name = (attachment.sessionId ?? "session").replaceAll(/[^a-z0-9_-]/gi, "-").slice(0, 80);
+    link.download = `terminal-${name}.txt`;
+    link.href = url;
+    link.click();
+    queueMicrotask(() => URL.revokeObjectURL(url));
+  };
+  useEffect(() => {
+    if (!root.current) return;
+    let disposed = false;
+    let disposeRuntime = () => void 0;
+    void Promise.all([
+      import("@xterm/addon-fit"),
+      import("@xterm/addon-search"),
+      import("@xterm/addon-web-links"),
+      import("@xterm/xterm")
+    ]).then(([{ FitAddon }, { SearchAddon }, { WebLinksAddon }, { Terminal }]) => {
+      if (disposed || !root.current) return;
+      const terminal = new Terminal({
+        allowTransparency: true,
+        convertEol,
+        cursorBlink: attachment.mode === "control",
+        disableStdin: attachment.mode !== "control",
+        fontFamily: "ui-monospace, SFMono-Regular, Menlo, Consolas, monospace",
+        fontSize: 12,
+        scrollback: 5e3,
+        theme: terminalTheme(root.current)
+      });
+      const fit = new FitAddon();
+      const search = new SearchAddon();
+      terminal.loadAddon(fit);
+      terminal.loadAddon(search);
+      terminal.loadAddon(new WebLinksAddon((_event, uri) => {
+        if (callbacks.current.onOpenLink) callbacks.current.onOpenLink(uri);
+        else globalThis.open(uri, "_blank", "noopener,noreferrer");
+      }));
+      terminal.open(root.current);
+      fit.fit();
+      runtime.current = { search, terminal };
+      const title = terminal.onTitleChange((value) => {
+        const normalized = value.replaceAll(/[\u0000-\u001f\u007f]/g, " ").trim().slice(0, 160);
+        if (normalized) callbacks.current.onTitle?.(normalized);
+      });
+      const bell = terminal.onBell(() => {
+        clearTimeout(bellTimer.current);
+        setBellVisible(true);
+        bellTimer.current = setTimeout(() => setBellVisible(false), 350);
+        callbacks.current.onBell?.();
+      });
+      let connected = false;
+      const handlers = {
+        onOpen() {
+          connected = true;
+          publishStatus(attachment.mode === "control" ? "Live \xB7 interactive" : "Live \xB7 read-only");
+        },
+        onOutput(data) {
+          if (disposed) return;
+          terminal.write(data);
+          if (!activeRef.current) callbacks.current.onActivity?.();
+        },
+        onResize(cols, rows) {
+          if (!disposed) terminal.resize(cols, rows);
+        },
+        onError(message) {
+          if (!disposed) {
+            publishStatus(message);
+            terminal.writeln(`\r
+${message}`);
+          }
+        },
+        onExit() {
+          connected = false;
+          if (!disposed) publishStatus("Terminal exited");
+        },
+        onClose() {
+          connected = false;
+          if (!disposed) setStatus((current) => {
+            const next = current === "Terminal exited" ? current : "Terminal disconnected";
+            callbacks.current.onStatus?.(next);
+            return next;
+          });
+        }
+      };
+      const size = { cols: terminal.cols, rows: terminal.rows };
+      let connection;
+      try {
+        connection = connect(attachment, handlers, size);
+      } catch (error) {
+        bell.dispose();
+        title.dispose();
+        terminal.dispose();
+        runtime.current = null;
+        throw error;
+      }
+      let resizeFrame = 0;
+      let sentSize = size;
+      const refit = () => {
+        if (disposed || !connected || attachment.mode !== "control") return;
+        fit.fit();
+        if (terminal.cols === sentSize.cols && terminal.rows === sentSize.rows) return;
+        sentSize = { cols: terminal.cols, rows: terminal.rows };
+        connection.resize(terminal.cols, terminal.rows);
+      };
+      const resizeObserver = attachment.mode === "control" && globalThis.ResizeObserver ? new ResizeObserver(() => {
+        cancelAnimationFrame(resizeFrame);
+        resizeFrame = requestAnimationFrame(refit);
+      }) : null;
+      resizeObserver?.observe(root.current);
+      const input = attachment.mode === "control" ? terminal.onData((data) => connection.write(data)) : null;
+      onReady?.({ focus() {
+        refit();
+        terminal.focus();
+      } });
+      const focus = () => {
+        if (activeRef.current && attachment.mode === "control") terminal.focus();
+      };
+      root.current.addEventListener("pointerdown", focus);
+      const paste = (event) => {
+        if (attachment.mode !== "control") return;
+        const value = event.clipboardData?.getData("text/plain");
+        if (!value) return;
+        event.preventDefault();
+        proposePaste(value);
+      };
+      root.current.addEventListener("paste", paste, true);
+      if (active) requestAnimationFrame(focus);
+      disposeRuntime = () => {
+        root.current?.removeEventListener("pointerdown", focus);
+        root.current?.removeEventListener("paste", paste, true);
+        input?.dispose();
+        resizeObserver?.disconnect();
+        cancelAnimationFrame(resizeFrame);
+        bell.dispose();
+        title.dispose();
+        connection.close();
+        terminal.dispose();
+        runtime.current = null;
+        clearTimeout(bellTimer.current);
+      };
+    }).catch((error) => {
+      if (!disposed) publishStatus(error instanceof Error ? error.message : "Could not load the terminal viewer");
+    });
+    return () => {
+      disposed = true;
+      disposeRuntime();
+    };
+  }, [attachment.id, attachment.mode, connect, convertEol]);
+  useEffect(() => {
+    if (!active || attachment.mode !== "control") return;
+    const focus = () => root.current?.querySelector(".xterm-helper-textarea")?.focus({ preventScroll: true });
+    focus();
+    requestAnimationFrame(focus);
+  }, [active, attachment.mode]);
+  useEffect(() => {
+    if (!pendingPaste) return;
+    queueMicrotask(() => pasteDialog.current?.querySelector("button")?.focus({ preventScroll: true }));
+  }, [pendingPaste]);
+  const retryable = status === "Terminal disconnected" || status === "Terminal connection failed";
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      class: "sctui-viewer",
+      "data-bell": String(bellVisible),
+      onKeyDownCapture: (event) => {
+        if (pendingPaste) {
+          if (event.key === "Escape") {
+            event.preventDefault();
+            setPendingPaste(null);
+            queueMicrotask(focusTerminal);
+          } else if (event.key === "Tab") {
+            const buttons = [...pasteDialog.current?.querySelectorAll("button") ?? []];
+            const first = buttons.at(0);
+            const last = buttons.at(-1);
+            if (event.shiftKey && document.activeElement === first) {
+              event.preventDefault();
+              last?.focus();
+            } else if (!event.shiftKey && document.activeElement === last) {
+              event.preventDefault();
+              first?.focus();
+            }
+          }
+          return;
+        }
+        if (event.key === "Escape" && findOpen) {
+          event.preventDefault();
+          closeFind();
+        } else if (event.key === "Escape" && (helpOpen || historyOpen)) {
+          event.preventDefault();
+          setHelpOpen(false);
+          setHistoryOpen(false);
+          queueMicrotask(focusTerminal);
+        } else if (event.altKey && event.shiftKey && !event.ctrlKey && !event.metaKey && event.code === "KeyF") {
+          event.preventDefault();
+          openFind();
+        }
+      },
+      children: [
+        /* @__PURE__ */ jsxs("div", { class: "sctui-viewerbar", children: [
+          /* @__PURE__ */ jsxs("div", { class: "sctui-status", "data-live": String(status.startsWith("Live")), role: "status", children: [
+            /* @__PURE__ */ jsx("span", { "aria-hidden": "true" }),
+            status,
+            retryable && onRetry ? /* @__PURE__ */ jsx("button", { type: "button", onClick: onRetry, children: "Reconnect" }) : null
+          ] }),
+          /* @__PURE__ */ jsxs("div", { class: "sctui-tools", "aria-label": "Terminal tools", children: [
+            /* @__PURE__ */ jsx("button", { type: "button", "aria-keyshortcuts": "Alt+Shift+F", "aria-label": "Find in terminal", title: `Find (${terminalShortcutLabel("F")})`, onClick: openFind, children: /* @__PURE__ */ jsx(SearchGlyph, {}) }),
+            /* @__PURE__ */ jsx("button", { type: "button", "aria-label": "Paste history", "aria-expanded": historyOpen, disabled: !pasteHistory.length, title: "Paste history (memory only)", onClick: () => {
+              setHelpOpen(false);
+              setHistoryOpen((open) => !open);
+            }, children: /* @__PURE__ */ jsx(HistoryGlyph, {}) }),
+            /* @__PURE__ */ jsx("button", { type: "button", "aria-label": "Save terminal contents", title: "Save terminal contents", onClick: saveContents, children: /* @__PURE__ */ jsx(DownloadGlyph, {}) }),
+            /* @__PURE__ */ jsx("button", { type: "button", "aria-label": "Terminal shortcut help", "aria-expanded": helpOpen, title: "Keyboard shortcuts", onClick: () => {
+              setHistoryOpen(false);
+              setHelpOpen((open) => !open);
+            }, children: /* @__PURE__ */ jsx(HelpGlyph, {}) })
+          ] })
+        ] }),
+        findOpen ? /* @__PURE__ */ jsxs("form", { class: "sctui-find", onSubmit: (event) => {
+          event.preventDefault();
+          find(event.shiftKey ? "previous" : "next");
+        }, children: [
+          /* @__PURE__ */ jsx(SearchGlyph, {}),
+          /* @__PURE__ */ jsx("input", { ref: searchInput, value: findQuery, "aria-label": "Find", placeholder: "Find", onInput: (event) => {
+            const query = event.currentTarget.value;
+            setFindQuery(query);
+            if (query) find("next", query);
+            else {
+              runtime.current?.search.clearDecorations();
+              setFindFound(null);
+            }
+          } }),
+          /* @__PURE__ */ jsx("small", { children: findFound === null ? "" : findFound ? "Match" : "No results" }),
+          /* @__PURE__ */ jsx("button", { type: "button", "aria-label": "Previous match", onClick: () => find("previous"), children: /* @__PURE__ */ jsx(UpGlyph, {}) }),
+          /* @__PURE__ */ jsx("button", { type: "button", "aria-label": "Next match", onClick: () => find("next"), children: /* @__PURE__ */ jsx(DownGlyph, {}) }),
+          /* @__PURE__ */ jsx("button", { type: "button", "aria-label": "Close find", onClick: closeFind, children: /* @__PURE__ */ jsx(CloseGlyph, {}) })
+        ] }) : null,
+        historyOpen ? /* @__PURE__ */ jsxs("div", { class: "sctui-popover sctui-paste-history", role: "menu", "aria-label": "Paste history", children: [
+          /* @__PURE__ */ jsxs("strong", { children: [
+            "Paste history ",
+            /* @__PURE__ */ jsxs("span", { children: [
+              /* @__PURE__ */ jsx("small", { children: "memory only" }),
+              /* @__PURE__ */ jsx("button", { type: "button", onClick: () => {
+                setPasteHistory([]);
+                setHistoryOpen(false);
+              }, children: "Clear" })
+            ] })
+          ] }),
+          pasteHistory.map((value, index) => /* @__PURE__ */ jsxs("button", { type: "button", role: "menuitem", onClick: () => proposePaste(value), children: [
+            /* @__PURE__ */ jsx("span", { children: value.replaceAll(/\s+/g, " ").slice(0, 90) }),
+            /* @__PURE__ */ jsxs("small", { children: [
+              value.length,
+              " chars"
+            ] })
+          ] }, `${index}:${value.length}`))
+        ] }) : null,
+        helpOpen ? /* @__PURE__ */ jsxs("div", { class: "sctui-popover sctui-shortcuts", role: "dialog", "aria-label": "Terminal keyboard shortcuts", children: [
+          /* @__PURE__ */ jsx("strong", { children: "Terminal shortcuts" }),
+          /* @__PURE__ */ jsxs("dl", { children: [
+            /* @__PURE__ */ jsxs("div", { children: [
+              /* @__PURE__ */ jsx("dt", { children: "New or attach" }),
+              /* @__PURE__ */ jsx("dd", { children: terminalShortcutLabel("T") })
+            ] }),
+            /* @__PURE__ */ jsxs("div", { children: [
+              /* @__PURE__ */ jsx("dt", { children: "Find" }),
+              /* @__PURE__ */ jsx("dd", { children: terminalShortcutLabel("F") })
+            ] }),
+            /* @__PURE__ */ jsxs("div", { children: [
+              /* @__PURE__ */ jsx("dt", { children: "Detach tab" }),
+              /* @__PURE__ */ jsx("dd", { children: terminalShortcutLabel("D") })
+            ] }),
+            /* @__PURE__ */ jsxs("div", { children: [
+              /* @__PURE__ */ jsx("dt", { children: "Previous / next tab" }),
+              /* @__PURE__ */ jsx("dd", { children: terminalShortcutLabel("[ / ]") })
+            ] }),
+            /* @__PURE__ */ jsxs("div", { children: [
+              /* @__PURE__ */ jsx("dt", { children: "Select tab" }),
+              /* @__PURE__ */ jsx("dd", { children: terminalShortcutLabel("1\u20139") })
+            ] })
+          ] }),
+          /* @__PURE__ */ jsx("small", { children: "Command and Control shortcuts stay with the browser and terminal." })
+        ] }) : null,
+        pendingPaste ? /* @__PURE__ */ jsxs("div", { class: "sctui-paste-confirm", ref: pasteDialog, role: "alertdialog", "aria-modal": "true", "aria-label": "Confirm terminal paste", children: [
+          /* @__PURE__ */ jsx("strong", { children: "Paste into this terminal?" }),
+          /* @__PURE__ */ jsxs("span", { children: [
+            pendingPaste.split(/\r?\n/).length,
+            " lines \xB7 ",
+            pendingPaste.length.toLocaleString(),
+            " characters"
+          ] }),
+          /* @__PURE__ */ jsx("pre", { children: pendingPaste.replaceAll(/\s+/g, " ").slice(0, 180) }),
+          /* @__PURE__ */ jsxs("div", { children: [
+            /* @__PURE__ */ jsx("button", { type: "button", onClick: () => {
+              setPendingPaste(null);
+              queueMicrotask(focusTerminal);
+            }, children: "Cancel" }),
+            /* @__PURE__ */ jsx("button", { type: "button", onClick: () => {
+              sendPaste(pendingPaste);
+              setPendingPaste(null);
+              queueMicrotask(focusTerminal);
+            }, children: "Paste" })
+          ] })
+        ] }) : null,
+        /* @__PURE__ */ jsx("div", { class: "sctui-screen", "data-active": String(active), ref: root })
+      ]
+    }
+  );
+}
+function CloseGlyph() {
+  return /* @__PURE__ */ jsx("svg", { "aria-hidden": "true", viewBox: "0 0 16 16", children: /* @__PURE__ */ jsx("path", { d: "m4.5 4.5 7 7m0-7-7 7" }) });
+}
+function SearchGlyph() {
+  return /* @__PURE__ */ jsxs("svg", { "aria-hidden": "true", viewBox: "0 0 16 16", children: [
+    /* @__PURE__ */ jsx("circle", { cx: "7", cy: "7", r: "3.5" }),
+    /* @__PURE__ */ jsx("path", { d: "m9.7 9.7 3 3" })
+  ] });
+}
+function HistoryGlyph() {
+  return /* @__PURE__ */ jsx("svg", { "aria-hidden": "true", viewBox: "0 0 16 16", children: /* @__PURE__ */ jsx("path", { d: "M3.2 5.3A5 5 0 1 1 3 10M3.2 5.3V2.7m0 2.6h2.6M8 4.8V8l2 1.3" }) });
+}
+function DownloadGlyph() {
+  return /* @__PURE__ */ jsx("svg", { "aria-hidden": "true", viewBox: "0 0 16 16", children: /* @__PURE__ */ jsx("path", { d: "M8 2.5v7m-2.5-2L8 10l2.5-2.5M3 12.5h10" }) });
+}
+function HelpGlyph() {
+  return /* @__PURE__ */ jsxs("svg", { "aria-hidden": "true", viewBox: "0 0 16 16", children: [
+    /* @__PURE__ */ jsx("circle", { cx: "8", cy: "8", r: "5.5" }),
+    /* @__PURE__ */ jsx("path", { d: "M6.7 6.2A1.5 1.5 0 0 1 8.2 5c1 0 1.7.6 1.7 1.5 0 1.4-1.8 1.4-1.8 2.6M8.1 11.4h.01" })
+  ] });
+}
+function UpGlyph() {
+  return /* @__PURE__ */ jsx("svg", { "aria-hidden": "true", viewBox: "0 0 16 16", children: /* @__PURE__ */ jsx("path", { d: "m4 10 4-4 4 4" }) });
+}
+function DownGlyph() {
+  return /* @__PURE__ */ jsx("svg", { "aria-hidden": "true", viewBox: "0 0 16 16", children: /* @__PURE__ */ jsx("path", { d: "m4 6 4 4 4-4" }) });
+}
+function terminalShortcutLabel(key) {
+  return /Mac|iPhone|iPad|iPod/i.test(globalThis.navigator?.platform ?? "") ? `\u2325\u21E7${key}` : `Alt+Shift+${key}`;
+}
+export {
+  TerminalStreamViewer
+};

package/styles.css

@@ -0,0 +1,160 @@
+/* Generated from src/styles.css by scripts/build-styles.mjs. Edit that file. */
+.sctui-panel {
+  --sctui-terminal-background: var(--volter-surface-media, light-dark(#0f1a1f, #070d10));
+  --sctui-bg-default: var(--volter-surface-page, light-dark(#f7f6f1, #0f1a1f));
+  --sctui-bg-raised-default: var(--volter-surface-raised, light-dark(#fbfaf7, #16252c));
+  --sctui-fill-default: var(--volter-surface-subtle, light-dark(#f2f1eb, #1d2d34));
+  --sctui-fill-strong-default: var(--volter-surface-inset, light-dark(#e7e6df, #22343c));
+  --sctui-fg-default: var(--volter-text-primary, light-dark(#16252c, #f3f2ec));
+  --sctui-muted-default: var(--volter-text-muted, light-dark(#5d6970, #a9b0ad));
+  --sctui-border-default: var(--volter-border-default, light-dark(#d9dad3, #2c3d45));
+  --sctui-border-strong-default: var(--volter-border-strong, light-dark(#c4c5bc, #3d5059));
+  --sctui-danger-default: var(--volter-status-danger-base, light-dark(#d24a1f, #f07650));
+  color-scheme: var(--scui-color-scheme, light dark);
+  position: absolute;
+  inset: 0;
+  z-index: var(--sctui-z-index, 12);
+  display: flex;
+  flex-direction: column;
+  box-sizing: border-box;
+  color: var(--sctui-fg, var(--scui-fg, var(--sctui-fg-default)));
+  background: var(--sctui-bg, var(--scui-bg, var(--sctui-bg-default)));
+  font-family: var(--sctui-font, var(--scui-font, var(--volter-font-ui, "Geist", "Segoe UI", system-ui, sans-serif)));
+}
+.sctui-panel > header { display:grid; flex:none; box-sizing:border-box; grid-template-columns:28px minmax(0,1fr) auto; align-items:center; gap:6px; height:36px; min-height:36px; padding:3px 8px; border-bottom:1px solid var(--sctui-border,var(--scui-border,var(--sctui-border-default))); background:var(--sctui-bg-raised,var(--scui-bg-raised,var(--sctui-bg-raised-default))) }
+.sctui-panel header span { display:flex; min-width:0; align-items:baseline; gap:6px }
+.sctui-panel header strong { font-size:13px; line-height:1.2 }
+.sctui-panel header small { overflow:hidden; color:var(--sctui-muted,var(--scui-muted,var(--sctui-muted-default))); font-size:10px; text-overflow:ellipsis; white-space:nowrap }
+.sctui-panel button { min-height:28px; padding:4px 8px; border:1px solid var(--sctui-border,var(--scui-border,var(--sctui-border-default))); border-radius:7px; color:inherit; background:var(--sctui-fill,var(--scui-fill,var(--sctui-fill-default))); font:inherit; font-size:11px; font-weight:600; line-height:1.2; cursor:pointer }
+.sctui-panel button:hover:not(:disabled) { border-color:var(--sctui-border-strong,var(--scui-border-strong,var(--sctui-border-strong-default))); background:var(--sctui-fill-strong,var(--scui-fill-strong,var(--sctui-fill-strong-default))) }
+.sctui-panel button:disabled { opacity:.5; cursor:default }
+.sctui-panel header > button:first-child { padding:0; border-color:transparent; background:transparent; font-size:16px }
+.sctui-panel[data-attached="true"] header > button:last-child { min-width:28px; padding:0; border-color:transparent; background:transparent; font-size:17px }
+.sctui-create { display:grid; grid-template-columns:repeat(auto-fit,minmax(120px,1fr)); gap:7px; padding:10px; border-bottom:1px solid var(--sctui-border,var(--scui-border,var(--sctui-border-default))) }
+.sctui-create button { min-height:34px }
+.sctui-list { min-height:0; overflow:auto }
+.sctui-list article { display:grid; grid-template-columns:minmax(0,1fr) repeat(4,auto); align-items:center; gap:5px; padding:9px 10px; border-bottom:1px solid var(--sctui-border,var(--scui-border,var(--sctui-border-default))) }
+.sctui-list article > span { display:flex; min-width:0; flex-direction:column; gap:3px }
+.sctui-list article strong { overflow:hidden; font-size:12px; text-overflow:ellipsis; white-space:nowrap }
+.sctui-path { display:flex; min-width:0; overflow:hidden; color:var(--sctui-muted,var(--scui-muted,var(--sctui-muted-default))); font-size:10px; font-style:normal; white-space:nowrap }
+.sctui-path > span { flex:0 1 auto; overflow:hidden; text-overflow:ellipsis }
+.sctui-path > i { flex:none; font-style:normal }
+.sctui-path > b { flex:none; max-width:58%; overflow:hidden; direction:rtl; font-weight:400; text-align:left; text-overflow:ellipsis; unicode-bidi:plaintext }
+.sctui-list .sctui-danger { color:var(--sctui-danger,var(--scui-danger,var(--sctui-danger-default))); background:transparent }
+.sctui-error,.sctui-empty { margin:10px; padding:9px; border:1px solid var(--sctui-border,var(--scui-border,var(--sctui-border-default))); border-radius:8px; color:var(--sctui-muted,var(--scui-muted,var(--sctui-muted-default))); background:var(--sctui-bg-raised,var(--scui-bg-raised,var(--sctui-bg-raised-default))); font-size:11px; line-height:1.4 }
+.sctui-error { color:var(--sctui-danger,var(--scui-danger,var(--sctui-danger-default))) }
+.sctui-live { display:flex; min-height:0; flex:1; flex-direction:column; padding:5px 7px 7px; gap:4px; background:var(--sctui-terminal-background) }
+.sctui-viewer {
+  /* The terminal is a dark media surface in either page scheme, so its inks
+     (ANSI palette, foreground, chrome) resolve in the dark scheme. xterm reads
+     the resolved colours from these tokens when it mounts (src/ui.jsx). */
+  --sctui-terminal-foreground-default:var(--volter-terminal-white, light-dark(#808b8f, #f3f2ec)); --sctui-terminal-cursor-default:var(--volter-terminal-white, light-dark(#808b8f, #f3f2ec));
+  --sctui-terminal-black-default:var(--volter-terminal-black, light-dark(#16252c, #2c3d45)); --sctui-terminal-red-default:var(--volter-terminal-red, light-dark(#d24a1f, #f07650));
+  --sctui-terminal-green-default:var(--volter-terminal-green, light-dark(#3f7a55, #6fbf8e)); --sctui-terminal-yellow-default:var(--volter-terminal-yellow, light-dark(#c7641a, #ec9a52));
+  --sctui-terminal-blue-default:var(--volter-terminal-blue, light-dark(#3b5f8a, #7ea6d8)); --sctui-terminal-magenta-default:var(--volter-terminal-magenta, light-dark(#6a5a92, #aa98d8));
+  --sctui-terminal-cyan-default:var(--volter-terminal-cyan, light-dark(#2f7a74, #6cc1b8)); --sctui-terminal-white-default:var(--volter-terminal-white, light-dark(#808b8f, #f3f2ec));
+  --sctui-terminal-bright-black-default:var(--volter-terminal-bright-black, light-dark(#5d6970, #a9b0ad)); --sctui-terminal-bright-red-default:var(--volter-terminal-bright-red, light-dark(#ff6a1f, #ff8a5c));
+  --sctui-terminal-bright-green-default:var(--volter-terminal-bright-green, light-dark(#6a9a3a, #9bcf62)); --sctui-terminal-bright-yellow-default:var(--volter-terminal-bright-yellow, light-dark(#c98a12, #f3c26b));
+  --sctui-terminal-bright-blue-default:var(--volter-terminal-bright-blue, light-dark(#4f78a8, #9ec0ea)); --sctui-terminal-bright-magenta-default:var(--volter-terminal-bright-magenta, light-dark(#8a78c0, #c4b7e6));
+  --sctui-terminal-bright-cyan-default:var(--volter-terminal-bright-cyan, light-dark(#3f948d, #8ad6cd)); --sctui-terminal-bright-white-default:var(--volter-terminal-bright-white, light-dark(#b8bab5, #ffffff));
+  color-scheme:dark;
+  position:relative; display:flex; min-width:0; min-height:0; flex:1; flex-direction:column; background:transparent }
+.sctui-viewer[data-bell="true"] .sctui-screen { box-shadow:inset 0 0 0 1px color-mix(in srgb, var(--volter-status-danger-base, light-dark(#d24a1f, #f07650)) 72%, transparent) }
+.sctui-viewerbar { display:flex; min-width:0; min-height:18px; flex:none; align-items:center }
+.sctui-status { flex:none; color:var(--volter-text-muted, light-dark(#5d6970, #a9b0ad)); font:500 10px/1.2 var(--volter-font-data, "Geist Mono", ui-monospace, "SF Mono", Menlo, Consolas, monospace) }
+.sctui-screen { min-height:0; flex:1; overflow:auto }
+.sctui-screen .xterm { height:100% }
+.sctui-screen .xterm .xterm-viewport { overflow-y:auto; background:transparent }
+
+.sctui-workspace {
+  --sctui-terminal-background:var(--volter-surface-media, light-dark(#0f1a1f, #070d10));
+  --sctui-bg-default:var(--volter-surface-page, light-dark(#f7f6f1, #0f1a1f)); --sctui-bg-raised-default:var(--volter-surface-raised, light-dark(#fbfaf7, #16252c)); --sctui-fill-default:var(--volter-surface-subtle, light-dark(#f2f1eb, #1d2d34));
+  --sctui-fill-strong-default:var(--volter-surface-inset, light-dark(#e7e6df, #22343c)); --sctui-fg-default:var(--volter-text-primary, light-dark(#16252c, #f3f2ec)); --sctui-muted-default:var(--volter-text-muted, light-dark(#5d6970, #a9b0ad));
+  --sctui-border-default:var(--volter-border-default, light-dark(#d9dad3, #2c3d45)); --sctui-border-strong-default:var(--volter-border-strong, light-dark(#c4c5bc, #3d5059)); --sctui-danger-default:var(--volter-status-danger-base, light-dark(#d24a1f, #f07650));
+  color-scheme:var(--scui-color-scheme, light dark);
+  position:absolute; inset:0; z-index:var(--sctui-z-index,12); display:flex; min-width:0; min-height:0;
+  flex-direction:column; overflow:hidden; color:var(--sctui-fg,var(--scui-fg,var(--sctui-fg-default)));
+  background:var(--sctui-terminal-background); font-family:var(--sctui-font,var(--scui-font,var(--volter-font-ui, "Geist", "Segoe UI", system-ui, sans-serif)));
+}
+.sctui-tabbar { display:flex; z-index:2; min-width:0; height:32px; min-height:32px; align-items:stretch;
+  border-bottom:1px solid var(--sctui-border,var(--scui-border,var(--sctui-border-default)));
+  color:var(--sctui-fg,var(--scui-fg,var(--sctui-fg-default)));
+  background:var(--sctui-bg-raised,var(--scui-bg-raised,var(--sctui-bg-raised-default))) }
+.sctui-tabbar button { box-sizing:border-box; border:0; color:inherit; background:transparent;
+  font:600 11px/1 var(--sctui-font,var(--scui-font,var(--volter-font-ui, "Geist", "Segoe UI", system-ui, sans-serif))); cursor:pointer }
+.sctui-tabbar button:hover { background:var(--sctui-fill,var(--scui-fill,var(--sctui-fill-default))) }
+.sctui-back { display:grid; width:32px; flex:none; padding:0; place-items:center }
+.sctui-tabs { display:flex; min-width:0; flex:1; overflow-x:auto; scrollbar-width:none }
+.sctui-tabs::-webkit-scrollbar { display:none }
+.sctui-tab { position:relative; display:flex; min-width:100px; max-width:190px; flex:0 1 160px; border-right:1px solid var(--sctui-border,var(--scui-border,var(--sctui-border-default))) }
+.sctui-tab[data-active="true"] { background:var(--sctui-bg,var(--scui-bg,var(--sctui-bg-default))) }
+.sctui-tab[data-active="true"]::after { position:absolute; right:0; bottom:-1px; left:0; height:1px; content:""; background:var(--sctui-terminal-background) }
+.sctui-tab > button:first-child { display:flex; min-width:0; flex:1; align-items:center; gap:6px; padding:0 4px 0 9px }
+.sctui-tab > button:first-child span { min-width:0; overflow:hidden; text-overflow:ellipsis; white-space:nowrap }
+.sctui-tab > button:last-child { display:grid; width:25px; flex:none; padding:0; place-items:center; opacity:0 }
+.sctui-tab:hover > button:last-child,.sctui-tab[data-active="true"] > button:last-child,.sctui-tab > button:last-child:focus-visible { opacity:.7 }
+.sctui-tab svg,.sctui-session-menu svg,.sctui-terminal-empty svg,.sctui-back svg { width:14px; height:14px; flex:none; fill:none; stroke:currentColor; stroke-linecap:round; stroke-linejoin:round; stroke-width:1.5 }
+.sctui-tab i { width:6px; height:6px; flex:none; border-radius:50%; background:var(--volter-text-faint, light-dark(#a3aaa9, #6c7a80)) }
+.sctui-tab i[data-live="true"] { background:var(--volter-status-live-base, light-dark(#5f9a2e, #9bcf62)) }
+.sctui-tab i[data-attention="activity"] { background:var(--volter-status-attention-base, light-dark(#c7641a, #ec9a52)); box-shadow:0 0 0 2px color-mix(in srgb, var(--volter-status-attention-base, light-dark(#c7641a, #ec9a52)) 17%, transparent) }
+.sctui-tab i[data-attention="bell"] { background:var(--volter-status-danger-base, light-dark(#d24a1f, #f07650)); box-shadow:0 0 0 2px color-mix(in srgb, var(--volter-status-danger-base, light-dark(#d24a1f, #f07650)) 20%, transparent) }
+.sctui-session-menu { position:relative; flex:none }
+.sctui-session-trigger { display:grid; width:32px; height:31px; place-items:center }
+.sctui-session-menu > div { position:absolute; z-index:5; top:34px; right:0; display:flex; width:280px; max-height:340px;
+  flex-direction:column; overflow:auto; padding:6px; border:1px solid var(--sctui-border,var(--scui-border,var(--sctui-border-default)));
+  border-radius:9px; background:var(--sctui-bg,var(--scui-bg,var(--sctui-bg-default))); box-shadow:var(--volter-shadow-floating, 0 12px 32px rgba(21, 23, 22, 0.14), 0 2px 8px rgba(21, 23, 22, 0.08)) }
+.sctui-session-menu > div > strong,.sctui-menu-heading { padding:7px 8px 5px; color:var(--sctui-muted,var(--scui-muted,var(--sctui-muted-default))); font-size:10px; text-transform:uppercase; letter-spacing:.04em }
+.sctui-session-menu > div > button { display:flex; min-height:38px; flex:none; align-items:center; gap:8px; padding:6px 8px; border-radius:6px; text-align:left }
+.sctui-session-menu > div > button > span:not(.sctui-action-icon) { display:flex; min-width:0; flex:1; flex-direction:column; gap:2px; overflow:hidden }
+.sctui-session-menu > div > button b { overflow:hidden; text-overflow:ellipsis; white-space:nowrap }
+.sctui-session-menu > div > button small { flex:none; color:var(--sctui-muted,var(--scui-muted,var(--sctui-muted-default))); font-size:9px }
+.sctui-menu-heading { display:flex; align-items:center; justify-content:space-between }
+.sctui-menu-heading button { padding:3px 5px; color:var(--sctui-muted,var(--scui-muted,var(--sctui-muted-default))); font-size:9px }
+.sctui-action-icon { display:grid; width:16px; height:16px; flex:none; place-items:center }
+.sctui-action-icon img,.sctui-action-icon svg { display:block; width:15px; height:15px; object-fit:contain }
+.sctui-toolbar-action { flex:none; padding:0 9px }
+.sctui-toolbar-action.sctui-danger { color:var(--sctui-danger,var(--scui-danger,var(--sctui-danger-default))) }
+.sctui-viewport-action { display:grid; width:32px; flex:none; padding:0; place-items:center }
+.sctui-viewport-action svg { width:14px; height:14px; fill:none; stroke:currentColor; stroke-linecap:round; stroke-linejoin:round; stroke-width:1.35 }
+.sctui-terminals { color-scheme:dark; position:relative; min-width:0; min-height:0; flex:1; background:transparent }
+.sctui-terminal { position:absolute; inset:0; display:none; min-width:0; min-height:0; flex-direction:column; padding:4px 7px 7px; background:transparent }
+.sctui-terminal[data-active="true"] { display:flex }
+.sctui-terminal > .sctui-screen,.sctui-terminal > .sctui-viewer { min-height:0; flex:1; overflow:hidden }
+.sctui-status { display:flex; min-height:16px; flex:none; align-items:center; gap:5px; color:var(--volter-text-muted, light-dark(#5d6970, #a9b0ad)) }
+.sctui-status > span { width:6px; height:6px; flex:none; border-radius:50%; background:var(--volter-text-faint, light-dark(#a3aaa9, #6c7a80)) }
+.sctui-status[data-live="true"] > span { background:var(--volter-status-live-base, light-dark(#5f9a2e, #9bcf62)) }
+.sctui-status button { margin-left:auto; padding:2px 6px; border:0; border-radius:4px; color:var(--volter-text-primary, light-dark(#16252c, #f3f2ec)); background:var(--volter-surface-inset, light-dark(#e7e6df, #22343c)); font:600 9px/1.2 inherit; cursor:pointer }
+.sctui-tools { display:flex; margin-left:auto; flex:none; align-items:center; gap:1px }
+.sctui-tools > button,.sctui-find > button { display:grid; width:20px; height:18px; padding:0; border:0; border-radius:4px; color:var(--volter-text-muted, light-dark(#5d6970, #a9b0ad)); background:transparent; cursor:pointer; place-items:center }
+.sctui-tools > button:hover:not(:disabled),.sctui-find > button:hover { color:var(--volter-text-primary, light-dark(#16252c, #f3f2ec)); background:var(--volter-surface-inset, light-dark(#e7e6df, #22343c)) }
+.sctui-tools > button:disabled { opacity:.3; cursor:default }
+.sctui-tools svg,.sctui-find svg { width:12px; height:12px; fill:none; stroke:currentColor; stroke-linecap:round; stroke-linejoin:round; stroke-width:1.4 }
+.sctui-find { position:absolute; z-index:5; top:21px; right:5px; display:flex; height:28px; align-items:center; gap:2px; padding:2px 3px 2px 7px; border:1px solid var(--volter-border-strong, light-dark(#c4c5bc, #3d5059)); border-radius:6px; color:var(--volter-text-muted, light-dark(#5d6970, #a9b0ad)); background:var(--volter-surface-raised, light-dark(#fbfaf7, #16252c)); box-shadow:var(--volter-shadow-floating, 0 12px 32px rgba(21, 23, 22, 0.14), 0 2px 8px rgba(21, 23, 22, 0.08)) }
+.sctui-find > input { width:180px; padding:3px 4px; border:0; outline:0; color:var(--volter-text-primary, light-dark(#16252c, #f3f2ec)); background:transparent; font:500 11px/1.2 var(--volter-font-data, "Geist Mono", ui-monospace, "SF Mono", Menlo, Consolas, monospace) }
+.sctui-find > small { min-width:42px; color:var(--volter-text-tertiary, light-dark(#66727a, #8b979b)); font:500 9px/1 var(--volter-font-data, "Geist Mono", ui-monospace, "SF Mono", Menlo, Consolas, monospace); text-align:right }
+.sctui-popover { position:absolute; z-index:6; top:21px; right:4px; box-sizing:border-box; width:250px; max-height:250px; overflow:auto; padding:7px; border:1px solid var(--volter-border-strong, light-dark(#c4c5bc, #3d5059)); border-radius:7px; color:var(--volter-text-primary, light-dark(#16252c, #f3f2ec)); background:var(--volter-surface-raised, light-dark(#fbfaf7, #16252c)); box-shadow:var(--volter-shadow-floating, 0 12px 32px rgba(21, 23, 22, 0.14), 0 2px 8px rgba(21, 23, 22, 0.08)); font-size:10px }
+.sctui-popover > strong { display:flex; align-items:baseline; justify-content:space-between; padding:2px 3px 6px; font-size:11px }
+.sctui-popover > strong span { display:flex; align-items:center; gap:5px }
+.sctui-popover > strong small,.sctui-popover > small { color:var(--volter-text-tertiary, light-dark(#66727a, #8b979b)); font-size:9px; font-weight:500 }
+.sctui-popover > strong button { padding:1px 3px; border:0; border-radius:3px; color:var(--volter-text-muted, light-dark(#5d6970, #a9b0ad)); background:transparent; font:600 8px/1.2 inherit; cursor:pointer }
+.sctui-popover > strong button:hover { background:var(--volter-surface-inset, light-dark(#e7e6df, #22343c)) }
+.sctui-paste-history > button { display:flex; width:100%; min-height:30px; align-items:center; gap:8px; padding:5px 6px; border:0; border-radius:4px; color:inherit; background:transparent; font:inherit; text-align:left; cursor:pointer }
+.sctui-paste-history > button:hover { background:var(--volter-surface-inset, light-dark(#e7e6df, #22343c)) }
+.sctui-paste-history > button span { min-width:0; flex:1; overflow:hidden; text-overflow:ellipsis; white-space:nowrap }
+.sctui-paste-history > button small { flex:none; color:var(--volter-text-tertiary, light-dark(#66727a, #8b979b)); font-size:8px }
+.sctui-shortcuts dl { display:grid; gap:0; margin:0 0 7px }
+.sctui-shortcuts dl div { display:flex; justify-content:space-between; gap:10px; padding:5px 3px; border-top:1px solid var(--volter-border-default, light-dark(#d9dad3, #2c3d45)) }
+.sctui-shortcuts dt,.sctui-shortcuts dd { margin:0 }
+.sctui-shortcuts dd { color:var(--volter-text-muted, light-dark(#5d6970, #a9b0ad)); font:500 9px/1.2 var(--volter-font-data, "Geist Mono", ui-monospace, "SF Mono", Menlo, Consolas, monospace) }
+.sctui-paste-confirm { position:absolute; z-index:7; top:50%; left:50%; display:flex; width:min(330px,calc(100% - 30px)); box-sizing:border-box; flex-direction:column; gap:7px; padding:12px; border:1px solid var(--volter-border-strong, light-dark(#c4c5bc, #3d5059)); border-radius:8px; color:var(--volter-text-primary, light-dark(#16252c, #f3f2ec)); background:var(--volter-surface-raised, light-dark(#fbfaf7, #16252c)); box-shadow:var(--volter-shadow-dialog, 0 2px 6px rgba(27, 30, 28, 0.06), 0 12px 32px rgba(27, 30, 28, 0.1)); font-size:11px; transform:translate(-50%,-50%) }
+.sctui-paste-confirm > span { color:var(--volter-text-muted, light-dark(#5d6970, #a9b0ad)); font-size:10px }
+.sctui-paste-confirm pre { overflow:hidden; margin:0; padding:7px; border-radius:5px; color:var(--volter-code-text, light-dark(#16252c, #f3f2ec)); background:var(--volter-surface-sunken, light-dark(#efeee8, #0b141a)); font:10px/1.35 var(--volter-font-data, "Geist Mono", ui-monospace, "SF Mono", Menlo, Consolas, monospace); text-overflow:ellipsis; white-space:nowrap }
+.sctui-paste-confirm > div { display:flex; justify-content:flex-end; gap:6px }
+.sctui-paste-confirm button { min-width:60px; padding:5px 8px; border:1px solid var(--volter-border-strong, light-dark(#c4c5bc, #3d5059)); border-radius:5px; color:var(--volter-text-primary, light-dark(#16252c, #f3f2ec)); background:var(--volter-surface-subtle, light-dark(#f2f1eb, #1d2d34)); font:600 10px/1.2 inherit; cursor:pointer }
+.sctui-paste-confirm button:last-child { border-color:var(--volter-action-default, light-dark(#16252c, #e4f09c)); color:var(--volter-text-on-strong, light-dark(#ffffff, #16252c)); background:var(--volter-action-default, light-dark(#16252c, #e4f09c)) }
+.sctui-terminal-empty { display:grid; height:100%; box-sizing:border-box; place-content:center; justify-items:center; gap:10px; padding:28px; color:var(--volter-text-muted, light-dark(#5d6970, #a9b0ad)); text-align:center }
+.sctui-terminal-empty > svg { width:28px; height:28px }
+.sctui-terminal-empty strong { max-width:280px; font-size:12px; font-weight:500; line-height:1.4 }
+.sctui-terminal-empty button { padding:7px 12px; border:1px solid var(--volter-border-strong, light-dark(#c4c5bc, #3d5059)); border-radius:6px; color:var(--volter-text-primary, light-dark(#16252c, #f3f2ec)); background:var(--volter-surface-subtle, light-dark(#f2f1eb, #1d2d34)); font:600 11px/1 inherit; cursor:pointer }
+.sctui-workspace > .sctui-error { position:absolute; z-index:4; top:38px; right:8px; max-width:320px; margin:0; background:var(--sctui-bg,var(--scui-bg,var(--sctui-bg-default))) }
+

package/substrate/attach.d.ts

@@ -0,0 +1,29 @@
+import { Buffer } from "node:buffer";
+export declare const detachPrefixByte = 2;
+export declare const detachKeyByte = 100;
+export type DetachFilter = {
+    feed: (chunk: Buffer | string) => void;
+};
+export declare function createDetachFilter(opts: {
+    key?: number;
+    onDetach: () => void;
+    onInput: (data: string) => void;
+    prefix?: number;
+}): DetachFilter;
+export type AttachResult = {
+    exitCode?: number;
+    reason: "detached" | "exited";
+};
+export type AttachStreams = {
+    stdin?: NodeJS.ReadStream;
+    stdout?: NodeJS.WritableStream & {
+        columns?: number;
+        rows?: number;
+    };
+};
+export declare function attachTerminal(opts: {
+    authToken?: () => string | undefined;
+    baseUrl: string;
+    streams?: AttachStreams;
+    terminalId: string;
+}): Promise<AttachResult>;