@broberg/seti-client 0.1.0

package/README.md

@@ -0,0 +1,55 @@
+# @broberg/seti-client
+
+Typed client + frame-merge engine + Preact `<SetiChat>` component for
+**buddycloud.cc SET/SETI live streaming chat**. Consume it through a host-app
+proxy from [`@broberg/seti-server`](https://www.npmjs.com/package/@broberg/seti-server)
+(same-origin, host auth, no CORS — the consumer token never reaches the browser).
+
+## Drop-in chat surface (Preact)
+
+```tsx
+import { SetiChat } from "@broberg/seti-client/preact";
+
+<SetiChat baseUrl="/api/seti" edge="cb-ubuntu-docker" session="cc" />;
+```
+
+Complete mobile-first surface: status header, accumulated screen, nav-keys bar
+(Esc/↑/↓/←/→/⏎) and a text input with delivery feedback (text preserved on
+failure). Self-contained styles, themeable via CSS vars (`--seti-bg`,
+`--seti-panel`, `--seti-edge`, `--seti-fg`, `--seti-dim`, `--seti-accent`,
+`--seti-warn`, `--seti-bad`, `--seti-mono`, `--seti-radius`). Every interactive
+element has `data-testid="seti-chat-*"`. Peer dependency `preact ^10` (optional —
+the core export is framework-agnostic).
+
+## Headless client
+
+```ts
+import { SetiClient, FrameAccumulator } from "@broberg/seti-client";
+
+const client = new SetiClient({ baseUrl: "/api/seti" });
+
+const roster = await client.listSessions();
+// roster.edges[n].tmuxSessions = the STREAMABLE session names (use as `session`)
+
+const acc = new FrameAccumulator();
+const stream = client.openStream("cb-ubuntu-docker", "cc", {
+  onFrame: (content) => console.log(acc.feed(content)), // { history, footer }
+  onStateChange: (s) => console.log(s), // connecting | open | reconnecting | closed
+});
+
+await client.sendText("cb-ubuntu-docker", "cc", "Run the test suite, report back.");
+await client.sendKey("cb-ubuntu-docker", "cc", "Enter");
+stream.close();
+```
+
+“Start a task” on a headless SET and chatting with an interactive SETI are the
+same call — `sendText` — because both are tmux cc sessions on the edge.
+
+`FrameAccumulator` solves alt-screen scrollback: cc renders on the terminal
+alt-screen (tmux keeps no scrollback), so every frame is a full window snapshot;
+the accumulator overlap-merges successive frames into a growing dialogue history
+plus a live footer.
+
+Server-side/direct use: `new SetiClient({ baseUrl: "https://buddycloud.cc/api/seti/v1", token })`.
+
+MIT © broberg.ai

package/dist/chunk-VWTGZF3D.js

@@ -0,0 +1,177 @@
+// src/client.ts
+var SetiClient = class {
+  base;
+  headers;
+  doFetch;
+  constructor(opts) {
+    this.base = opts.baseUrl.replace(/\/$/, "");
+    this.headers = opts.token ? { Authorization: `Bearer ${opts.token}` } : {};
+    this.doFetch = opts.fetch ?? globalThis.fetch.bind(globalThis);
+  }
+  async listSessions() {
+    const res = await this.doFetch(`${this.base}/sessions`, { headers: this.headers });
+    if (!res.ok) return { edges: [], error: `http_${res.status}` };
+    return await res.json();
+  }
+  async sendText(edge, session, text) {
+    return this.input({ edge, session, text });
+  }
+  async sendKey(edge, session, key) {
+    return this.input({ edge, session, key });
+  }
+  async input(body) {
+    try {
+      const res = await this.doFetch(`${this.base}/input`, {
+        method: "POST",
+        headers: { ...this.headers, "content-type": "application/json" },
+        body: JSON.stringify(body),
+        signal: AbortSignal.timeout(8e3)
+      });
+      const json = await res.json().catch(() => ({}));
+      return { ok: !!json.ok, edgeConnected: !!json.edgeConnected, error: json.error };
+    } catch (err) {
+      return { ok: false, edgeConnected: false, error: err instanceof Error ? err.message : "send_failed" };
+    }
+  }
+  /**
+   * Open the live frame stream for one edge session. Reconnects automatically
+   * until `close()` is called.
+   */
+  openStream(edge, session, handlers) {
+    let closed = false;
+    let controller = null;
+    const run = async () => {
+      let attempt = 0;
+      while (!closed) {
+        handlers.onStateChange?.(attempt === 0 ? "connecting" : "reconnecting");
+        controller = new AbortController();
+        try {
+          const res = await this.doFetch(
+            `${this.base}/stream?edge=${encodeURIComponent(edge)}&session=${encodeURIComponent(session)}`,
+            { headers: { ...this.headers, accept: "text/event-stream" }, signal: controller.signal }
+          );
+          if (!res.ok || !res.body) throw new Error(`http_${res.status}`);
+          handlers.onStateChange?.("open");
+          attempt = 0;
+          await this.consume(res.body, handlers);
+        } catch {
+        }
+        if (closed) break;
+        attempt++;
+        await new Promise((r) => setTimeout(r, Math.min(1e3 * attempt, 5e3)));
+      }
+      handlers.onStateChange?.("closed");
+    };
+    void run();
+    return {
+      close: () => {
+        closed = true;
+        controller?.abort();
+      }
+    };
+  }
+  /** Minimal SSE parser: `event:` + `data:` lines, events split on blank lines. */
+  async consume(body, handlers) {
+    const reader = body.getReader();
+    const decoder = new TextDecoder();
+    let buf = "";
+    for (; ; ) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      buf += decoder.decode(value, { stream: true });
+      let sep;
+      while ((sep = buf.indexOf("\n\n")) !== -1) {
+        const chunk = buf.slice(0, sep);
+        buf = buf.slice(sep + 2);
+        let event = "message";
+        const data = [];
+        for (const line of chunk.split("\n")) {
+          if (line.startsWith("event:")) event = line.slice(6).trim();
+          else if (line.startsWith("data:")) data.push(line.slice(5).trimStart());
+        }
+        if (data.length === 0) continue;
+        let parsed;
+        try {
+          parsed = JSON.parse(data.join("\n"));
+        } catch {
+          continue;
+        }
+        if (event === "frame") {
+          const c = parsed.content;
+          if (typeof c === "string") handlers.onFrame?.(c);
+        } else if (event === "hello") {
+          handlers.onHello?.(parsed);
+        } else if (event === "ping") {
+          handlers.onPing?.(parsed);
+        }
+      }
+    }
+  }
+};
+
+// src/frame-accumulator.ts
+var RULE = /^[─━-]{10,}\s*$/;
+var SPIN = /^[✻✶✳·•*]\s/;
+function splitFooter(lines) {
+  let inp = -1;
+  for (let i = lines.length - 1; i >= 0 && i >= lines.length - 8; i--) {
+    const t = lines[i].replace(/\s+$/, "");
+    if (t.charCodeAt(0) === 10095 || t[0] === ">") {
+      inp = i;
+      break;
+    }
+  }
+  let start;
+  if (inp === -1) start = Math.max(0, lines.length - 3);
+  else start = inp > 0 && RULE.test(lines[inp - 1].trim()) ? inp - 1 : inp;
+  while (start > 0 && SPIN.test(lines[start - 1])) start--;
+  return { body: lines.slice(0, start), footer: lines.slice(start) };
+}
+function mergeOverlap(hist, body) {
+  const max = Math.min(hist.length, body.length);
+  for (let k = max; k > 0; k--) {
+    let ok = true;
+    for (let i = 0; i < k; i++) {
+      if (hist[hist.length - k + i] !== body[i]) {
+        ok = false;
+        break;
+      }
+    }
+    if (ok) return hist.concat(body.slice(k));
+  }
+  return hist.concat(body);
+}
+var FrameAccumulator = class {
+  constructor(maxHistory = 5e3) {
+    this.maxHistory = maxHistory;
+  }
+  maxHistory;
+  history = [];
+  footer = [];
+  /** Feed a full frame snapshot; returns the updated view. */
+  feed(content) {
+    const lines = content.replace(/\s+$/, "").split("\n");
+    const { body, footer } = splitFooter(lines);
+    this.history = mergeOverlap(this.history, body);
+    if (this.history.length > this.maxHistory) {
+      this.history = this.history.slice(-this.maxHistory);
+    }
+    this.footer = footer;
+    return this.view;
+  }
+  get view() {
+    return { history: this.history, footer: this.footer };
+  }
+  /** Full rendered text (history + live footer). */
+  get text() {
+    return this.history.concat(this.footer).join("\n");
+  }
+  reset() {
+    this.history = [];
+    this.footer = [];
+  }
+};
+
+export { FrameAccumulator, SetiClient, mergeOverlap, splitFooter };
+//# sourceMappingURL=chunk-VWTGZF3D.js.map
+//# sourceMappingURL=chunk-VWTGZF3D.js.map

package/dist/chunk-VWTGZF3D.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts","../src/frame-accumulator.ts"],"names":[],"mappings":"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","file":"chunk-VWTGZF3D.js","sourcesContent":["import type {\n  SetiInputResult,\n  SetiKey,\n  SetiRoster,\n  SetiStreamHandle,\n  SetiStreamHandlers,\n} from \"./types\";\n\nexport interface SetiClientOptions {\n  /**\n   * Base URL of the SETI surface. In a browser this is the host app's proxy\n   * mount (same-origin, e.g. \"/api/seti\" via @broberg/seti-server). Server-side\n   * it can be the cloud directly (\"https://buddycloud.cc/api/seti/v1\") together\n   * with `token`.\n   */\n  baseUrl: string;\n  /** Bearer token — only for server-side/direct use. NEVER ship to a browser. */\n  token?: string;\n  /** Override fetch (tests / custom runtimes). */\n  fetch?: typeof fetch;\n}\n\n/**\n * Typed client for the SETI API (roster + SSE stream + input). One code path\n * for browser and server: fetch-based SSE with automatic reconnect (1s → 5s\n * backoff), so bearer headers work everywhere and no EventSource is needed.\n */\nexport class SetiClient {\n  private readonly base: string;\n  private readonly headers: Record<string, string>;\n  private readonly doFetch: typeof fetch;\n\n  constructor(opts: SetiClientOptions) {\n    this.base = opts.baseUrl.replace(/\\/$/, \"\");\n    this.headers = opts.token ? { Authorization: `Bearer ${opts.token}` } : {};\n    this.doFetch = opts.fetch ?? globalThis.fetch.bind(globalThis);\n  }\n\n  async listSessions(): Promise<SetiRoster> {\n    const res = await this.doFetch(`${this.base}/sessions`, { headers: this.headers });\n    if (!res.ok) return { edges: [], error: `http_${res.status}` };\n    return (await res.json()) as SetiRoster;\n  }\n\n  async sendText(edge: string, session: string, text: string): Promise<SetiInputResult> {\n    return this.input({ edge, session, text });\n  }\n\n  async sendKey(edge: string, session: string, key: SetiKey): Promise<SetiInputResult> {\n    return this.input({ edge, session, key });\n  }\n\n  private async input(body: {\n    edge: string;\n    session: string;\n    text?: string;\n    key?: SetiKey;\n  }): Promise<SetiInputResult> {\n    try {\n      const res = await this.doFetch(`${this.base}/input`, {\n        method: \"POST\",\n        headers: { ...this.headers, \"content-type\": \"application/json\" },\n        body: JSON.stringify(body),\n        signal: AbortSignal.timeout(8000),\n      });\n      const json = (await res.json().catch(() => ({}))) as Partial<SetiInputResult>;\n      return { ok: !!json.ok, edgeConnected: !!json.edgeConnected, error: json.error };\n    } catch (err) {\n      return { ok: false, edgeConnected: false, error: err instanceof Error ? err.message : \"send_failed\" };\n    }\n  }\n\n  /**\n   * Open the live frame stream for one edge session. Reconnects automatically\n   * until `close()` is called.\n   */\n  openStream(edge: string, session: string, handlers: SetiStreamHandlers): SetiStreamHandle {\n    let closed = false;\n    let controller: AbortController | null = null;\n\n    const run = async (): Promise<void> => {\n      let attempt = 0;\n      while (!closed) {\n        handlers.onStateChange?.(attempt === 0 ? \"connecting\" : \"reconnecting\");\n        controller = new AbortController();\n        try {\n          const res = await this.doFetch(\n            `${this.base}/stream?edge=${encodeURIComponent(edge)}&session=${encodeURIComponent(session)}`,\n            { headers: { ...this.headers, accept: \"text/event-stream\" }, signal: controller.signal },\n          );\n          if (!res.ok || !res.body) throw new Error(`http_${res.status}`);\n          handlers.onStateChange?.(\"open\");\n          attempt = 0;\n          await this.consume(res.body, handlers);\n        } catch {\n          /* fall through to reconnect */\n        }\n        if (closed) break;\n        attempt++;\n        await new Promise((r) => setTimeout(r, Math.min(1000 * attempt, 5000)));\n      }\n      handlers.onStateChange?.(\"closed\");\n    };\n    void run();\n\n    return {\n      close: () => {\n        closed = true;\n        controller?.abort();\n      },\n    };\n  }\n\n  /** Minimal SSE parser: `event:` + `data:` lines, events split on blank lines. */\n  private async consume(body: ReadableStream<Uint8Array>, handlers: SetiStreamHandlers): Promise<void> {\n    const reader = body.getReader();\n    const decoder = new TextDecoder();\n    let buf = \"\";\n    for (;;) {\n      const { done, value } = await reader.read();\n      if (done) break;\n      buf += decoder.decode(value, { stream: true });\n      let sep: number;\n      while ((sep = buf.indexOf(\"\\n\\n\")) !== -1) {\n        const chunk = buf.slice(0, sep);\n        buf = buf.slice(sep + 2);\n        let event = \"message\";\n        const data: string[] = [];\n        for (const line of chunk.split(\"\\n\")) {\n          if (line.startsWith(\"event:\")) event = line.slice(6).trim();\n          else if (line.startsWith(\"data:\")) data.push(line.slice(5).trimStart());\n        }\n        if (data.length === 0) continue;\n        let parsed: unknown;\n        try {\n          parsed = JSON.parse(data.join(\"\\n\"));\n        } catch {\n          continue;\n        }\n        if (event === \"frame\") {\n          const c = (parsed as { content?: unknown }).content;\n          if (typeof c === \"string\") handlers.onFrame?.(c);\n        } else if (event === \"hello\") {\n          handlers.onHello?.(parsed as { edge: string; session: string; edgeConnected: boolean });\n        } else if (event === \"ping\") {\n          handlers.onPing?.(parsed as { edgeConnected: boolean });\n        }\n      }\n    }\n  }\n}\n","/**\n * FrameAccumulator — the F071 scrollback engine as a tested pure class.\n *\n * cc runs on the terminal alt-screen, so tmux has no scrollback: every frame is\n * a full snapshot of the visible window. The accumulator splits each frame into\n * a volatile footer (cc's input box + statusline + spinner, rendered live) and\n * a body, then overlap-merges successive bodies so the dialogue that scrolls\n * off the top is retained.\n */\nexport interface FrameView {\n  /** Accumulated dialogue lines (grows from the first fed frame). */\n  history: string[];\n  /** The volatile tail of the latest frame (input box / statusline / spinner). */\n  footer: string[];\n}\n\nconst RULE = /^[─━-]{10,}\\s*$/;\nconst SPIN = /^[✻✶✳·•*]\\s/;\n\nexport function splitFooter(lines: string[]): { body: string[]; footer: string[] } {\n  let inp = -1;\n  for (let i = lines.length - 1; i >= 0 && i >= lines.length - 8; i--) {\n    const t = lines[i].replace(/\\s+$/, \"\");\n    if (t.charCodeAt(0) === 0x276f || t[0] === \">\") {\n      inp = i;\n      break;\n    }\n  }\n  let start: number;\n  if (inp === -1) start = Math.max(0, lines.length - 3);\n  else start = inp > 0 && RULE.test(lines[inp - 1].trim()) ? inp - 1 : inp;\n  while (start > 0 && SPIN.test(lines[start - 1])) start--;\n  return { body: lines.slice(0, start), footer: lines.slice(start) };\n}\n\nexport function mergeOverlap(hist: string[], body: string[]): string[] {\n  const max = Math.min(hist.length, body.length);\n  for (let k = max; k > 0; k--) {\n    let ok = true;\n    for (let i = 0; i < k; i++) {\n      if (hist[hist.length - k + i] !== body[i]) {\n        ok = false;\n        break;\n      }\n    }\n    if (ok) return hist.concat(body.slice(k));\n  }\n  return hist.concat(body);\n}\n\nexport class FrameAccumulator {\n  private history: string[] = [];\n  private footer: string[] = [];\n\n  constructor(private readonly maxHistory = 5000) {}\n\n  /** Feed a full frame snapshot; returns the updated view. */\n  feed(content: string): FrameView {\n    const lines = content.replace(/\\s+$/, \"\").split(\"\\n\");\n    const { body, footer } = splitFooter(lines);\n    this.history = mergeOverlap(this.history, body);\n    if (this.history.length > this.maxHistory) {\n      this.history = this.history.slice(-this.maxHistory);\n    }\n    this.footer = footer;\n    return this.view;\n  }\n\n  get view(): FrameView {\n    return { history: this.history, footer: this.footer };\n  }\n\n  /** Full rendered text (history + live footer). */\n  get text(): string {\n    return this.history.concat(this.footer).join(\"\\n\");\n  }\n\n  reset(): void {\n    this.history = [];\n    this.footer = [];\n  }\n}\n"]}

package/dist/client-BIxdDJYz.d.cts

@@ -0,0 +1,89 @@
+/** A cc session registered on an edge (intercom channel snapshot). */
+interface SetiRemoteSession {
+    ccSessionId: string | null;
+    sessionName: string | null;
+    cwd: string;
+}
+/** One edge host in the fleet roster. */
+interface SetiEdge {
+    edgeId: string;
+    connected: boolean;
+    lastSeenMs: number;
+    connectedAtMs: number | null;
+    sessions: SetiRemoteSession[];
+    /**
+     * The tmux session names live on the edge — the STREAMABLE units. Stream and
+     * input target these by name (channel sessionNames can differ, e.g. container
+     * tmux "cc" vs channel "fly-arn-1-cc"). Empty = nothing streamable (M1 iTerm).
+     */
+    tmuxSessions: string[];
+}
+interface SetiRoster {
+    edges: SetiEdge[];
+    error?: string;
+}
+/** tmux key names accepted by input's `key` field (navigates cc's menus). */
+declare const SETI_KEYS: readonly ["Escape", "Up", "Down", "Left", "Right", "Enter", "BSpace", "Tab"];
+type SetiKey = (typeof SETI_KEYS)[number];
+interface SetiInputResult {
+    ok: boolean;
+    edgeConnected: boolean;
+    error?: string;
+}
+type SetiStreamState = "connecting" | "open" | "reconnecting" | "closed";
+interface SetiStreamHandlers {
+    /** First event after (re)connect: { edge, session, edgeConnected }. */
+    onHello?: (info: {
+        edge: string;
+        session: string;
+        edgeConnected: boolean;
+    }) => void;
+    /** A full capture-pane snapshot of the session's visible window. */
+    onFrame?: (content: string) => void;
+    /** Idle keep-alive carrying the latest edge connectivity. */
+    onPing?: (info: {
+        edgeConnected: boolean;
+    }) => void;
+    onStateChange?: (state: SetiStreamState) => void;
+}
+interface SetiStreamHandle {
+    close: () => void;
+}
+
+interface SetiClientOptions {
+    /**
+     * Base URL of the SETI surface. In a browser this is the host app's proxy
+     * mount (same-origin, e.g. "/api/seti" via @broberg/seti-server). Server-side
+     * it can be the cloud directly ("https://buddycloud.cc/api/seti/v1") together
+     * with `token`.
+     */
+    baseUrl: string;
+    /** Bearer token — only for server-side/direct use. NEVER ship to a browser. */
+    token?: string;
+    /** Override fetch (tests / custom runtimes). */
+    fetch?: typeof fetch;
+}
+/**
+ * Typed client for the SETI API (roster + SSE stream + input). One code path
+ * for browser and server: fetch-based SSE with automatic reconnect (1s → 5s
+ * backoff), so bearer headers work everywhere and no EventSource is needed.
+ */
+declare class SetiClient {
+    private readonly base;
+    private readonly headers;
+    private readonly doFetch;
+    constructor(opts: SetiClientOptions);
+    listSessions(): Promise<SetiRoster>;
+    sendText(edge: string, session: string, text: string): Promise<SetiInputResult>;
+    sendKey(edge: string, session: string, key: SetiKey): Promise<SetiInputResult>;
+    private input;
+    /**
+     * Open the live frame stream for one edge session. Reconnects automatically
+     * until `close()` is called.
+     */
+    openStream(edge: string, session: string, handlers: SetiStreamHandlers): SetiStreamHandle;
+    /** Minimal SSE parser: `event:` + `data:` lines, events split on blank lines. */
+    private consume;
+}
+
+export { SETI_KEYS as S, SetiClient as a, type SetiClientOptions as b, type SetiEdge as c, type SetiInputResult as d, type SetiKey as e, type SetiRemoteSession as f, type SetiRoster as g, type SetiStreamHandle as h, type SetiStreamHandlers as i, type SetiStreamState as j };

package/dist/client-BIxdDJYz.d.ts

@@ -0,0 +1,89 @@
+/** A cc session registered on an edge (intercom channel snapshot). */
+interface SetiRemoteSession {
+    ccSessionId: string | null;
+    sessionName: string | null;
+    cwd: string;
+}
+/** One edge host in the fleet roster. */
+interface SetiEdge {
+    edgeId: string;
+    connected: boolean;
+    lastSeenMs: number;
+    connectedAtMs: number | null;
+    sessions: SetiRemoteSession[];
+    /**
+     * The tmux session names live on the edge — the STREAMABLE units. Stream and
+     * input target these by name (channel sessionNames can differ, e.g. container
+     * tmux "cc" vs channel "fly-arn-1-cc"). Empty = nothing streamable (M1 iTerm).
+     */
+    tmuxSessions: string[];
+}
+interface SetiRoster {
+    edges: SetiEdge[];
+    error?: string;
+}
+/** tmux key names accepted by input's `key` field (navigates cc's menus). */
+declare const SETI_KEYS: readonly ["Escape", "Up", "Down", "Left", "Right", "Enter", "BSpace", "Tab"];
+type SetiKey = (typeof SETI_KEYS)[number];
+interface SetiInputResult {
+    ok: boolean;
+    edgeConnected: boolean;
+    error?: string;
+}
+type SetiStreamState = "connecting" | "open" | "reconnecting" | "closed";
+interface SetiStreamHandlers {
+    /** First event after (re)connect: { edge, session, edgeConnected }. */
+    onHello?: (info: {
+        edge: string;
+        session: string;
+        edgeConnected: boolean;
+    }) => void;
+    /** A full capture-pane snapshot of the session's visible window. */
+    onFrame?: (content: string) => void;
+    /** Idle keep-alive carrying the latest edge connectivity. */
+    onPing?: (info: {
+        edgeConnected: boolean;
+    }) => void;
+    onStateChange?: (state: SetiStreamState) => void;
+}
+interface SetiStreamHandle {
+    close: () => void;
+}
+
+interface SetiClientOptions {
+    /**
+     * Base URL of the SETI surface. In a browser this is the host app's proxy
+     * mount (same-origin, e.g. "/api/seti" via @broberg/seti-server). Server-side
+     * it can be the cloud directly ("https://buddycloud.cc/api/seti/v1") together
+     * with `token`.
+     */
+    baseUrl: string;
+    /** Bearer token — only for server-side/direct use. NEVER ship to a browser. */
+    token?: string;
+    /** Override fetch (tests / custom runtimes). */
+    fetch?: typeof fetch;
+}
+/**
+ * Typed client for the SETI API (roster + SSE stream + input). One code path
+ * for browser and server: fetch-based SSE with automatic reconnect (1s → 5s
+ * backoff), so bearer headers work everywhere and no EventSource is needed.
+ */
+declare class SetiClient {
+    private readonly base;
+    private readonly headers;
+    private readonly doFetch;
+    constructor(opts: SetiClientOptions);
+    listSessions(): Promise<SetiRoster>;
+    sendText(edge: string, session: string, text: string): Promise<SetiInputResult>;
+    sendKey(edge: string, session: string, key: SetiKey): Promise<SetiInputResult>;
+    private input;
+    /**
+     * Open the live frame stream for one edge session. Reconnects automatically
+     * until `close()` is called.
+     */
+    openStream(edge: string, session: string, handlers: SetiStreamHandlers): SetiStreamHandle;
+    /** Minimal SSE parser: `event:` + `data:` lines, events split on blank lines. */
+    private consume;
+}
+
+export { SETI_KEYS as S, SetiClient as a, type SetiClientOptions as b, type SetiEdge as c, type SetiInputResult as d, type SetiKey as e, type SetiRemoteSession as f, type SetiRoster as g, type SetiStreamHandle as h, type SetiStreamHandlers as i, type SetiStreamState as j };

package/dist/index.cjs

@@ -0,0 +1,195 @@
+'use strict';
+
+// src/client.ts
+var SetiClient = class {
+  base;
+  headers;
+  doFetch;
+  constructor(opts) {
+    this.base = opts.baseUrl.replace(/\/$/, "");
+    this.headers = opts.token ? { Authorization: `Bearer ${opts.token}` } : {};
+    this.doFetch = opts.fetch ?? globalThis.fetch.bind(globalThis);
+  }
+  async listSessions() {
+    const res = await this.doFetch(`${this.base}/sessions`, { headers: this.headers });
+    if (!res.ok) return { edges: [], error: `http_${res.status}` };
+    return await res.json();
+  }
+  async sendText(edge, session, text) {
+    return this.input({ edge, session, text });
+  }
+  async sendKey(edge, session, key) {
+    return this.input({ edge, session, key });
+  }
+  async input(body) {
+    try {
+      const res = await this.doFetch(`${this.base}/input`, {
+        method: "POST",
+        headers: { ...this.headers, "content-type": "application/json" },
+        body: JSON.stringify(body),
+        signal: AbortSignal.timeout(8e3)
+      });
+      const json = await res.json().catch(() => ({}));
+      return { ok: !!json.ok, edgeConnected: !!json.edgeConnected, error: json.error };
+    } catch (err) {
+      return { ok: false, edgeConnected: false, error: err instanceof Error ? err.message : "send_failed" };
+    }
+  }
+  /**
+   * Open the live frame stream for one edge session. Reconnects automatically
+   * until `close()` is called.
+   */
+  openStream(edge, session, handlers) {
+    let closed = false;
+    let controller = null;
+    const run = async () => {
+      let attempt = 0;
+      while (!closed) {
+        handlers.onStateChange?.(attempt === 0 ? "connecting" : "reconnecting");
+        controller = new AbortController();
+        try {
+          const res = await this.doFetch(
+            `${this.base}/stream?edge=${encodeURIComponent(edge)}&session=${encodeURIComponent(session)}`,
+            { headers: { ...this.headers, accept: "text/event-stream" }, signal: controller.signal }
+          );
+          if (!res.ok || !res.body) throw new Error(`http_${res.status}`);
+          handlers.onStateChange?.("open");
+          attempt = 0;
+          await this.consume(res.body, handlers);
+        } catch {
+        }
+        if (closed) break;
+        attempt++;
+        await new Promise((r) => setTimeout(r, Math.min(1e3 * attempt, 5e3)));
+      }
+      handlers.onStateChange?.("closed");
+    };
+    void run();
+    return {
+      close: () => {
+        closed = true;
+        controller?.abort();
+      }
+    };
+  }
+  /** Minimal SSE parser: `event:` + `data:` lines, events split on blank lines. */
+  async consume(body, handlers) {
+    const reader = body.getReader();
+    const decoder = new TextDecoder();
+    let buf = "";
+    for (; ; ) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      buf += decoder.decode(value, { stream: true });
+      let sep;
+      while ((sep = buf.indexOf("\n\n")) !== -1) {
+        const chunk = buf.slice(0, sep);
+        buf = buf.slice(sep + 2);
+        let event = "message";
+        const data = [];
+        for (const line of chunk.split("\n")) {
+          if (line.startsWith("event:")) event = line.slice(6).trim();
+          else if (line.startsWith("data:")) data.push(line.slice(5).trimStart());
+        }
+        if (data.length === 0) continue;
+        let parsed;
+        try {
+          parsed = JSON.parse(data.join("\n"));
+        } catch {
+          continue;
+        }
+        if (event === "frame") {
+          const c = parsed.content;
+          if (typeof c === "string") handlers.onFrame?.(c);
+        } else if (event === "hello") {
+          handlers.onHello?.(parsed);
+        } else if (event === "ping") {
+          handlers.onPing?.(parsed);
+        }
+      }
+    }
+  }
+};
+
+// src/frame-accumulator.ts
+var RULE = /^[─━-]{10,}\s*$/;
+var SPIN = /^[✻✶✳·•*]\s/;
+function splitFooter(lines) {
+  let inp = -1;
+  for (let i = lines.length - 1; i >= 0 && i >= lines.length - 8; i--) {
+    const t = lines[i].replace(/\s+$/, "");
+    if (t.charCodeAt(0) === 10095 || t[0] === ">") {
+      inp = i;
+      break;
+    }
+  }
+  let start;
+  if (inp === -1) start = Math.max(0, lines.length - 3);
+  else start = inp > 0 && RULE.test(lines[inp - 1].trim()) ? inp - 1 : inp;
+  while (start > 0 && SPIN.test(lines[start - 1])) start--;
+  return { body: lines.slice(0, start), footer: lines.slice(start) };
+}
+function mergeOverlap(hist, body) {
+  const max = Math.min(hist.length, body.length);
+  for (let k = max; k > 0; k--) {
+    let ok = true;
+    for (let i = 0; i < k; i++) {
+      if (hist[hist.length - k + i] !== body[i]) {
+        ok = false;
+        break;
+      }
+    }
+    if (ok) return hist.concat(body.slice(k));
+  }
+  return hist.concat(body);
+}
+var FrameAccumulator = class {
+  constructor(maxHistory = 5e3) {
+    this.maxHistory = maxHistory;
+  }
+  maxHistory;
+  history = [];
+  footer = [];
+  /** Feed a full frame snapshot; returns the updated view. */
+  feed(content) {
+    const lines = content.replace(/\s+$/, "").split("\n");
+    const { body, footer } = splitFooter(lines);
+    this.history = mergeOverlap(this.history, body);
+    if (this.history.length > this.maxHistory) {
+      this.history = this.history.slice(-this.maxHistory);
+    }
+    this.footer = footer;
+    return this.view;
+  }
+  get view() {
+    return { history: this.history, footer: this.footer };
+  }
+  /** Full rendered text (history + live footer). */
+  get text() {
+    return this.history.concat(this.footer).join("\n");
+  }
+  reset() {
+    this.history = [];
+    this.footer = [];
+  }
+};
+
+// src/types.ts
+var SETI_KEYS = [
+  "Escape",
+  "Up",
+  "Down",
+  "Left",
+  "Right",
+  "Enter",
+  "BSpace",
+  "Tab"
+];
+
+exports.FrameAccumulator = FrameAccumulator;
+exports.SETI_KEYS = SETI_KEYS;
+exports.SetiClient = SetiClient;
+exports.mergeOverlap = mergeOverlap;
+exports.splitFooter = splitFooter;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map