@vellumai/cli 0.12.6 → 0.12.7-staging.1

package/node_modules/@vellumai/local-mode/node_modules/@vellumai/service-contracts/src/__tests__/channels.test.ts

@@ -24,6 +24,7 @@ describe("isChannelId", () => {
     // so these must remain canonical for that assertion to mean anything.
     expect(isChannelId("platform")).toBe(true);
     expect(isChannelId("vellum")).toBe(true);
+    expect(isChannelId("vellum-shared")).toBe(true);
   });
 
   test("includes discord", () => {
@@ -58,6 +59,7 @@ describe("botProviderForChannel and channelForBotProvider", () => {
   test("answer nothing for a channel without a bot, a person's grant, or an unknown key", () => {
     expect(botProviderForChannel("phone")).toBeUndefined();
     expect(botProviderForChannel("vellum")).toBeUndefined();
+    expect(botProviderForChannel("vellum-shared")).toBeUndefined();
     expect(botProviderForChannel("not-a-channel")).toBeUndefined();
     // `slack` is the person's integration standing beside the bot's key.
     expect(channelForBotProvider("slack")).toBeUndefined();

package/node_modules/@vellumai/local-mode/node_modules/@vellumai/service-contracts/src/channels.ts

@@ -4,8 +4,9 @@
  *
  * A "channel" is an external messaging surface an actor can reach the
  * assistant through (Slack, Telegram, WhatsApp, phone, …) plus a couple of
- * internal ids (`vellum` for native app conversations, `platform` for the
- * internal control plane). This is the single source of truth for that set:
+ * internal ids (`vellum` for native app conversations, `vellum-shared` for
+ * conversations a guardian shares with a contact, `platform` for the internal
+ * control plane). This is the single source of truth for that set:
  *
  * One id, `plugin`, does not name a surface: it names *every* surface a plugin
  * brings. A plugin channel's real identity is the plugin, which is workspace
@@ -41,6 +42,9 @@ export const CHANNEL_IDS = [
   "a2a",
   "discord",
   "plugin",
+  // Internal id for conversations a guardian shares with a contact. It has no
+  // transport: the contact's own client holds the connection.
+  "vellum-shared",
 ] as const;
 
 export type ChannelId = (typeof CHANNEL_IDS)[number];
@@ -78,8 +82,8 @@ export function isChannelId(value: unknown): value is ChannelId {
  * here would be a second copy of a different fact.
  *
  * Channels absent from this map reach the assistant without a bot credential
- * of their own: `phone` through the voice provider, `vellum` and `platform`
- * internally.
+ * of their own: `phone` through the voice provider, `vellum`, `vellum-shared`
+ * and `platform` internally.
  */
 export const CHANNEL_BOT_PROVIDER = {
   slack: "slack_channel",

package/node_modules/@vellumai/service-contracts/src/__tests__/channels.test.ts

@@ -24,6 +24,7 @@ describe("isChannelId", () => {
     // so these must remain canonical for that assertion to mean anything.
     expect(isChannelId("platform")).toBe(true);
     expect(isChannelId("vellum")).toBe(true);
+    expect(isChannelId("vellum-shared")).toBe(true);
   });
 
   test("includes discord", () => {
@@ -58,6 +59,7 @@ describe("botProviderForChannel and channelForBotProvider", () => {
   test("answer nothing for a channel without a bot, a person's grant, or an unknown key", () => {
     expect(botProviderForChannel("phone")).toBeUndefined();
     expect(botProviderForChannel("vellum")).toBeUndefined();
+    expect(botProviderForChannel("vellum-shared")).toBeUndefined();
     expect(botProviderForChannel("not-a-channel")).toBeUndefined();
     // `slack` is the person's integration standing beside the bot's key.
     expect(channelForBotProvider("slack")).toBeUndefined();

package/node_modules/@vellumai/service-contracts/src/channels.ts

@@ -4,8 +4,9 @@
  *
  * A "channel" is an external messaging surface an actor can reach the
  * assistant through (Slack, Telegram, WhatsApp, phone, …) plus a couple of
- * internal ids (`vellum` for native app conversations, `platform` for the
- * internal control plane). This is the single source of truth for that set:
+ * internal ids (`vellum` for native app conversations, `vellum-shared` for
+ * conversations a guardian shares with a contact, `platform` for the internal
+ * control plane). This is the single source of truth for that set:
  *
  * One id, `plugin`, does not name a surface: it names *every* surface a plugin
  * brings. A plugin channel's real identity is the plugin, which is workspace
@@ -41,6 +42,9 @@ export const CHANNEL_IDS = [
   "a2a",
   "discord",
   "plugin",
+  // Internal id for conversations a guardian shares with a contact. It has no
+  // transport: the contact's own client holds the connection.
+  "vellum-shared",
 ] as const;
 
 export type ChannelId = (typeof CHANNEL_IDS)[number];
@@ -78,8 +82,8 @@ export function isChannelId(value: unknown): value is ChannelId {
  * here would be a second copy of a different fact.
  *
  * Channels absent from this map reach the assistant without a bot credential
- * of their own: `phone` through the voice provider, `vellum` and `platform`
- * internally.
+ * of their own: `phone` through the voice provider, `vellum`, `vellum-shared`
+ * and `platform` internally.
  */
 export const CHANNEL_BOT_PROVIDER = {
   slack: "slack_channel",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/cli",
-  "version": "0.12.6",
+  "version": "0.12.7-staging.1",
   "description": "CLI tools for vellum-assistant",
   "type": "module",
   "exports": {

package/src/__tests__/default-main-screen-formatting.test.ts

@@ -0,0 +1,166 @@
+import { describe, expect, test } from "bun:test";
+import {
+  calculateHeaderHeight,
+  estimateItemHeight,
+  formatConfirmationPreview,
+  formatHeaderEyebrow,
+  formatHeaderTitle,
+  formatTimestamp,
+  formatToolCallPreview,
+  stripAnsi,
+  truncateValue,
+  type RuntimeMessage,
+} from "../lib/default-main-screen-formatting.js";
+
+function message(overrides: Partial<RuntimeMessage> = {}): RuntimeMessage {
+  return {
+    id: "message-1",
+    role: "user",
+    content: "Hello",
+    timestamp: "2026-09-29T16:00:00.000Z",
+    ...overrides,
+  };
+}
+
+describe("formatTimestamp", () => {
+  test("formats a timestamp with hour and minute fields", () => {
+    const timestamp = "2026-09-29T16:05:00.000Z";
+
+    expect(formatTimestamp(timestamp)).toBe(
+      new Date(timestamp).toLocaleTimeString([], {
+        hour: "2-digit",
+        minute: "2-digit",
+      }),
+    );
+  });
+});
+
+describe("tool-call previews", () => {
+  test("formats known tool inputs", () => {
+    expect(
+      formatToolCallPreview({
+        name: "file_read",
+        input: { path: "/workspace/report.txt" },
+      }),
+    ).toBe("read /workspace/report.txt");
+    expect(
+      formatToolCallPreview({
+        name: "browser_click",
+        input: { element_id: "submit-button" },
+      }),
+    ).toBe("click submit-button");
+    expect(
+      formatConfirmationPreview("browser_press_key", { key: "Enter" }),
+    ).toBe('press "Enter"');
+  });
+
+  test("truncates long preview fields at their existing limits", () => {
+    expect(
+      formatToolCallPreview({
+        name: "bash",
+        input: { command: "x".repeat(90) },
+      }),
+    ).toBe("x".repeat(80));
+    expect(
+      formatToolCallPreview({
+        name: "browser_type",
+        input: { selector: "y".repeat(70) },
+      }),
+    ).toBe(`type into ${"y".repeat(60)}`);
+  });
+
+  test("serializes unknown tool inputs", () => {
+    expect(
+      formatToolCallPreview({ name: "custom_tool", input: { value: 7 } }),
+    ).toBe('{"value":7}');
+    expect(formatConfirmationPreview("custom_tool", { value: 7 })).toBe(
+      'custom_tool: {"value":7}',
+    );
+  });
+});
+
+describe("truncateValue", () => {
+  test("returns values that fit without changing them", () => {
+    expect(truncateValue("short", 8)).toBe("short");
+    expect(truncateValue({ ok: true }, 20)).toBe('{"ok":true}');
+  });
+
+  test("adds an ellipsis within the requested maximum length", () => {
+    expect(truncateValue("abcdefghij", 8)).toBe("abcde...");
+    expect(truncateValue({ value: "abcdefghij" }, 12)).toBe('{"value":...');
+  });
+});
+
+describe("header formatting", () => {
+  test("uses the default title and eyebrow", () => {
+    expect(formatHeaderEyebrow()).toBe("  Assistant");
+    expect(formatHeaderTitle()).toBe("  Meet your Assistant!");
+  });
+
+  test("normalizes title whitespace", () => {
+    expect(formatHeaderTitle("  Example\n  Assistant  ")).toBe(
+      "  Example Assistant",
+    );
+  });
+
+  test("truncates titles to the left panel width", () => {
+    const title = formatHeaderTitle("A".repeat(40));
+
+    expect(title).toBe(`  ${"A".repeat(31)}...`);
+    expect(title).toHaveLength(36);
+  });
+
+  test("strips ANSI color and style sequences from header art", () => {
+    expect(stripAnsi("\x1b[31mred\x1b[0m plain")).toBe("red plain");
+  });
+});
+
+describe("estimateItemHeight", () => {
+  test("accounts for message prefixes, wrapping, and spacing", () => {
+    expect(estimateItemHeight(message({ content: "abcdefghij" }), 10)).toBe(4);
+    expect(estimateItemHeight(message({ content: "a\nb" }), 80)).toBe(3);
+  });
+
+  test("accounts for tool-call chrome, parameters, and results", () => {
+    expect(
+      estimateItemHeight(
+        message({
+          role: "assistant",
+          toolCalls: [
+            {
+              name: "file_read",
+              input: { path: "/workspace/a", max_chars: 100 },
+              result: "done",
+            },
+          ],
+        }),
+        80,
+      ),
+    ).toBe(7);
+  });
+
+  test("estimates non-message feed items", () => {
+    expect(estimateItemHeight({ type: "help" }, 80)).toBe(5);
+    expect(estimateItemHeight({ type: "status", text: "123456\n12" }, 5)).toBe(
+      3,
+    );
+    expect(estimateItemHeight({ type: "spinner", text: "Working" }, 80)).toBe(
+      1,
+    );
+  });
+});
+
+describe("calculateHeaderHeight", () => {
+  test("uses one row in compact terminals", () => {
+    expect(calculateHeaderHeight("vellum", 59)).toBe(1);
+  });
+
+  test("uses the larger of the art and right-panel layouts", () => {
+    expect(calculateHeaderHeight("vellum", 60)).toBe(16);
+    expect(calculateHeaderHeight("openclaw", 80)).toBe(19);
+  });
+
+  test("defaults to the standard terminal width", () => {
+    expect(calculateHeaderHeight("vellum")).toBe(16);
+  });
+});

package/src/components/DefaultMainScreen.tsx

@@ -21,6 +21,35 @@ import { trustedRefreshUrl } from "../lib/runtime-url";
 import { appendHistory, loadHistory } from "../lib/input-history";
 import { tuiLog } from "../lib/tui-log";
 import { segmentsToPlainText } from "../lib/segments-to-plain-text";
+import {
+  calculateHeaderHeight,
+  COMPACT_THRESHOLD,
+  DEFAULT_TERMINAL_COLUMNS,
+  estimateItemHeight,
+  formatConfirmationPreview,
+  formatHeaderEyebrow,
+  formatHeaderTitle,
+  formatTimestamp,
+  isRuntimeMessage,
+  formatToolCallPreview,
+  stripAnsi,
+  truncateValue,
+  HELP_COMMANDS,
+  LEFT_PANEL_WIDTH,
+  RIGHT_PANEL_LINE_COUNT,
+  TIPS,
+  type ErrorLine,
+  type FeedItem,
+  type HelpLine,
+  type RuntimeMessage,
+  type StatusLine,
+  type ToolCallInfo,
+} from "../lib/default-main-screen-formatting.js";
+export {
+  formatTimestamp,
+  type RuntimeMessage,
+  type ToolCallInfo,
+} from "../lib/default-main-screen-formatting.js";
 import { statusEmoji, withStatusEmoji } from "../lib/status-emoji";
 import {
   getTerminalCapabilities,
@@ -50,25 +79,6 @@ export const SLASH_COMMANDS = [
   "/quit",
 ];
 
-const HELP_COMMANDS = [
-  {
-    command: "/btw <question>",
-    description: "Ask a side question while the assistant is working",
-  },
-  {
-    command: "/quit, /exit, /q",
-    description: "Disconnect and exit",
-  },
-  {
-    command: "/clear",
-    description: "Clear the screen",
-  },
-  {
-    command: "/help, ?",
-    description: "Show this help",
-  },
-] as const;
-
 const SEND_TIMEOUT_MS = 5000;
 /** Fresh deadline for a request retried after a mid-session token refresh —
  *  the original caller signal may have already timed out during the refresh. */
@@ -76,37 +86,13 @@ const RETRY_TIMEOUT_MS = 30_000;
 
 // ── Layout constants ──────────────────────────────────────
 const MAX_TOTAL_WIDTH = 72;
-const DEFAULT_TERMINAL_COLUMNS = 80;
 const DEFAULT_TERMINAL_ROWS = 24;
-const LEFT_PANEL_WIDTH = 36;
-
-const COMPACT_THRESHOLD = 60;
 const HEADER_PREFIX_UNICODE = "── Vellum ";
 const HEADER_PREFIX_ASCII = "-- Vellum ";
 
 // Left panel structure: HEADER lines + art + FOOTER lines
-const LEFT_HEADER_LINES = 4; // spacer + eyebrow + title + spacer
-const LEFT_FOOTER_LINES = 3; // spacer + runtimeUrl + dirName
-
-// Right panel structure
-const TIPS = [
-  "Send a message to start chatting",
-  "Use /help to see available commands",
-];
-const RIGHT_PANEL_INFO_SECTIONS = 3; // Assistant ID, Species, Status — each with heading + value
-const RIGHT_PANEL_SPACERS = 2; // top spacer + spacer between tips and info
-const RIGHT_PANEL_TIPS_HEADING = 1;
-const RIGHT_PANEL_LINE_COUNT =
-  RIGHT_PANEL_SPACERS +
-  RIGHT_PANEL_TIPS_HEADING +
-  TIPS.length +
-  RIGHT_PANEL_INFO_SECTIONS * 2;
-
 // Header chrome (borders around panel content)
 const HEADER_TOP_BORDER_LINES = 1; // "── Vellum ───..." line
-const HEADER_BOTTOM_BORDER_LINES = 2; // bottom rule + blank line
-const HEADER_CHROME_LINES =
-  HEADER_TOP_BORDER_LINES + HEADER_BOTTOM_BORDER_LINES;
 
 // Selection / Secret windows
 const DIALOG_WINDOW_WIDTH = 60;
@@ -123,11 +109,6 @@ const SECRET_INPUT_HEIGHT = 5; // title bar + content row + bottom border + tool
 const SPINNER_HEIGHT = 1;
 const MIN_FEED_ROWS = 3;
 
-// Feed item height estimation
-const TOOL_CALL_CHROME_LINES = 2; // header (┌) + footer (└)
-const MESSAGE_SPACING = 1;
-const HELP_DISPLAY_HEIGHT = HELP_COMMANDS.length + 1;
-
 interface ListMessagesResponse {
   messages: RuntimeMessage[];
   nextCursor?: string;
@@ -497,38 +478,6 @@ async function* streamEvents(
   }
 }
 
-function formatConfirmationPreview(
-  toolName: string,
-  input: Record<string, unknown>,
-): string {
-  switch (toolName) {
-    case "bash":
-      return String(input.command ?? "");
-    case "file_read":
-      return `read ${input.path ?? ""}`;
-    case "file_write":
-      return `write ${input.path ?? ""}`;
-    case "file_edit":
-      return `edit ${input.path ?? ""}`;
-    case "web_fetch":
-      return String(input.url ?? "").slice(0, 80);
-    case "browser_navigate":
-      return `navigate ${String(input.url ?? "").slice(0, 80)}`;
-    case "browser_close":
-      return input.close_all_pages
-        ? "close all browser pages"
-        : "close browser page";
-    case "browser_click":
-      return `click ${input.element_id ?? input.selector ?? ""}`;
-    case "browser_type":
-      return `type into ${input.element_id ?? input.selector ?? ""}`;
-    case "browser_press_key":
-      return `press "${input.key ?? ""}"`;
-    default:
-      return `${toolName}: ${JSON.stringify(input).slice(0, 80)}`;
-  }
-}
-
 async function handleConfirmationPrompt(
   baseUrl: string,
   assistantId: string,
@@ -567,93 +516,6 @@ export const TYPING_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "
 /** ASCII-safe spinner frames for the connection screen. */
 const CONNECTION_SPINNER_FRAMES = ["|", "/", "-", "\\"];
 
-export interface ToolCallInfo {
-  name: string;
-  input: Record<string, unknown>;
-  result?: string;
-  isError?: boolean;
-  toolUseId?: string;
-}
-
-export interface RuntimeMessage {
-  id: string;
-  role: "user" | "assistant";
-  content: string;
-  /**
-   * Ordered text segments from the daemon's history payload, split at
-   * tool_use/surface boundaries. The flat `content` body is derived from
-   * these (see `segmentsToPlainText`); the daemon no longer sends a
-   * redundant flattened `content` field on the wire.
-   */
-  textSegments?: string[];
-  timestamp: string;
-  toolCalls?: ToolCallInfo[];
-  label?: string;
-}
-
-export function formatTimestamp(ts: string): string {
-  try {
-    const date = new Date(ts);
-    return date.toLocaleTimeString([], { hour: "2-digit", minute: "2-digit" });
-  } catch {
-    return "";
-  }
-}
-
-function formatToolCallPreview(tc: ToolCallInfo): string {
-  switch (tc.name) {
-    case "bash":
-      return String(tc.input.command ?? "").slice(0, 80);
-    case "file_read":
-      return `read ${tc.input.path ?? ""}`;
-    case "file_write":
-      return `write ${tc.input.path ?? ""}`;
-    case "file_edit":
-      return `edit ${tc.input.path ?? ""}`;
-    case "web_search":
-      return String(tc.input.query ?? "").slice(0, 80);
-    case "web_fetch":
-      return String(tc.input.url ?? "").slice(0, 80);
-    case "browser_navigate":
-      return `navigate ${String(tc.input.url ?? "").slice(0, 80)}`;
-    case "browser_click":
-      return `click ${String(tc.input.element_id ?? tc.input.selector ?? "").slice(0, 60)}`;
-    case "browser_type":
-      return `type into ${String(tc.input.element_id ?? tc.input.selector ?? "").slice(0, 60)}`;
-    default:
-      return JSON.stringify(tc.input).slice(0, 80);
-  }
-}
-
-function truncateValue(value: unknown, maxLen: number): string {
-  if (typeof value === "string") {
-    if (value.length > maxLen) {
-      return value.slice(0, maxLen - 3) + "...";
-    }
-    return value;
-  }
-  const serialized = JSON.stringify(value);
-  if (serialized.length > maxLen) {
-    return serialized.slice(0, maxLen - 3) + "...";
-  }
-  return serialized;
-}
-
-function formatHeaderTitle(assistantName?: string): string {
-  const rawTitle = assistantName?.trim() || "Meet your Assistant!";
-  const title = rawTitle.replace(/\s+/g, " ");
-  const maxTitleLength = LEFT_PANEL_WIDTH - 2;
-  const displayTitle =
-    title.length > maxTitleLength
-      ? title.slice(0, maxTitleLength - 3) + "..."
-      : title;
-  return `  ${displayTitle}`;
-}
-
-function formatHeaderEyebrow(): string {
-  return "  Assistant";
-}
-
 interface ToolCallDisplayProps {
   tc: ToolCallInfo;
 }
@@ -822,10 +684,6 @@ export function renderErrorMainScreen(error: unknown): number {
   return 3;
 }
 
-function stripAnsi(str: string): string {
-  return str.replace(/\x1b\[[0-9;]*m/g, "");
-}
-
 interface DefaultMainScreenProps {
   runtimeUrl: string;
   assistantId: string;
@@ -1018,96 +876,6 @@ export interface SelectionRequest {
   resolve: (index: number) => void;
 }
 
-interface StatusLine {
-  type: "status";
-  text: string;
-  color?: string;
-}
-
-interface SpinnerLine {
-  type: "spinner";
-  text: string;
-}
-
-interface HelpLine {
-  type: "help";
-}
-
-interface ErrorLine {
-  type: "error";
-  text: string;
-}
-
-type FeedItem =
-  | RuntimeMessage
-  | StatusLine
-  | SpinnerLine
-  | HelpLine
-  | ErrorLine;
-
-function isRuntimeMessage(item: FeedItem): item is RuntimeMessage {
-  return "role" in item;
-}
-
-function estimateItemHeight(item: FeedItem, terminalColumns: number): number {
-  if (isRuntimeMessage(item)) {
-    const cols = Math.max(1, terminalColumns);
-    // Account for "HH:MM AM Label: " prefix on the first line
-    const defaultLabel = item.role === "user" ? "You:" : "Assistant:";
-    const label = item.label ?? defaultLabel;
-    const prefixLen = 10 + label.length + 1; // timestamp + space + label + space
-    let lines = 0;
-    const contentLines = item.content.split("\n");
-    for (let idx = 0; idx < contentLines.length; idx++) {
-      const lineLen =
-        idx === 0
-          ? contentLines[idx].length + prefixLen
-          : contentLines[idx].length;
-      lines += Math.max(1, Math.ceil(lineLen / cols));
-    }
-    if (item.role === "assistant" && item.toolCalls) {
-      for (const tc of item.toolCalls) {
-        const paramCount =
-          typeof tc.input === "object" && tc.input
-            ? Object.keys(tc.input).length
-            : 0;
-        lines +=
-          TOOL_CALL_CHROME_LINES +
-          paramCount +
-          (tc.result !== undefined ? 1 : 0);
-      }
-    }
-    return lines + MESSAGE_SPACING;
-  }
-  if (item.type === "help") {
-    return HELP_DISPLAY_HEIGHT;
-  }
-  if (item.type === "status" || item.type === "error") {
-    const cols = Math.max(1, terminalColumns);
-    let lines = 0;
-    for (const line of item.text.split("\n")) {
-      lines += Math.max(1, Math.ceil(line.length / cols));
-    }
-    return lines;
-  }
-  return 1;
-}
-
-const COMPACT_HEADER_HEIGHT = 1;
-
-function calculateHeaderHeight(
-  species: Species,
-  terminalColumns?: number,
-): number {
-  if ((terminalColumns ?? DEFAULT_TERMINAL_COLUMNS) < COMPACT_THRESHOLD) {
-    return COMPACT_HEADER_HEIGHT;
-  }
-  const artLength = SPECIES_CONFIG[species].art.length;
-  const leftLineCount = LEFT_HEADER_LINES + artLength + LEFT_FOOTER_LINES;
-  const maxLines = Math.max(leftLineCount, RIGHT_PANEL_LINE_COUNT);
-  return maxLines + HEADER_CHROME_LINES;
-}
-
 const SCROLL_STEP = 5;
 
 export function render(
@@ -1118,10 +886,7 @@ export function render(
 ): number {
   const terminalColumns = process.stdout.columns || DEFAULT_TERMINAL_COLUMNS;
   const isCompact = terminalColumns < COMPACT_THRESHOLD;
-  const art = SPECIES_CONFIG[species].art;
-
-  const leftLineCount = LEFT_HEADER_LINES + art.length + LEFT_FOOTER_LINES;
-  const maxLines = Math.max(leftLineCount, RIGHT_PANEL_LINE_COUNT);
+  const headerHeight = calculateHeaderHeight(species, terminalColumns);
 
   const { unmount } = inkRender(
     <DefaultMainScreen
@@ -1135,7 +900,7 @@ export function render(
   unmount();
 
   if (isCompact) {
-    return COMPACT_HEADER_HEIGHT;
+    return headerHeight;
   }
 
   const statusCanvasLine = RIGHT_PANEL_LINE_COUNT + HEADER_TOP_BORDER_LINES;
@@ -1151,7 +916,7 @@ export function render(
     })
     .catch(() => {});
 
-  return maxLines + HEADER_CHROME_LINES;
+  return headerHeight;
 }
 
 interface SelectionWindowProps {

package/src/lib/default-main-screen-formatting.ts

@@ -0,0 +1,264 @@
+import { SPECIES_CONFIG, type Species } from "./constants.js";
+
+export const LEFT_PANEL_WIDTH = 36;
+export const DEFAULT_TERMINAL_COLUMNS = 80;
+export const COMPACT_THRESHOLD = 60;
+
+const LEFT_HEADER_LINES = 4;
+const LEFT_FOOTER_LINES = 3;
+const HEADER_TOP_BORDER_LINES = 1;
+const HEADER_BOTTOM_BORDER_LINES = 2;
+const HEADER_CHROME_LINES =
+  HEADER_TOP_BORDER_LINES + HEADER_BOTTOM_BORDER_LINES;
+const COMPACT_HEADER_HEIGHT = 1;
+
+const RIGHT_PANEL_INFO_SECTIONS = 3;
+const RIGHT_PANEL_SPACERS = 2;
+const RIGHT_PANEL_TIPS_HEADING = 1;
+
+const TOOL_CALL_CHROME_LINES = 2;
+const MESSAGE_SPACING = 1;
+
+export const HELP_COMMANDS = [
+  {
+    command: "/btw <question>",
+    description: "Ask a side question while the assistant is working",
+  },
+  {
+    command: "/quit, /exit, /q",
+    description: "Disconnect and exit",
+  },
+  {
+    command: "/clear",
+    description: "Clear the screen",
+  },
+  {
+    command: "/help, ?",
+    description: "Show this help",
+  },
+] as const;
+
+export const TIPS = [
+  "Send a message to start chatting",
+  "Use /help to see available commands",
+] as const;
+
+export const RIGHT_PANEL_LINE_COUNT =
+  RIGHT_PANEL_SPACERS +
+  RIGHT_PANEL_TIPS_HEADING +
+  TIPS.length +
+  RIGHT_PANEL_INFO_SECTIONS * 2;
+const HELP_DISPLAY_HEIGHT = HELP_COMMANDS.length + 1;
+
+export interface ToolCallInfo {
+  name: string;
+  input: Record<string, unknown>;
+  result?: string;
+  isError?: boolean;
+  toolUseId?: string;
+}
+
+export interface RuntimeMessage {
+  id: string;
+  role: "user" | "assistant";
+  content: string;
+  /**
+   * Ordered text segments from the daemon's history payload, split at
+   * tool_use/surface boundaries. The flat `content` body is derived from
+   * these (see `segmentsToPlainText`); the daemon no longer sends a
+   * redundant flattened `content` field on the wire.
+   */
+  textSegments?: string[];
+  timestamp: string;
+  toolCalls?: ToolCallInfo[];
+  label?: string;
+}
+
+export interface StatusLine {
+  type: "status";
+  text: string;
+  color?: string;
+}
+
+export interface SpinnerLine {
+  type: "spinner";
+  text: string;
+}
+
+export interface HelpLine {
+  type: "help";
+}
+
+export interface ErrorLine {
+  type: "error";
+  text: string;
+}
+
+export type FeedItem =
+  | RuntimeMessage
+  | StatusLine
+  | SpinnerLine
+  | HelpLine
+  | ErrorLine;
+
+export function formatTimestamp(timestamp: string): string {
+  try {
+    const date = new Date(timestamp);
+    return date.toLocaleTimeString([], { hour: "2-digit", minute: "2-digit" });
+  } catch {
+    return "";
+  }
+}
+
+export function formatConfirmationPreview(
+  toolName: string,
+  input: Record<string, unknown>,
+): string {
+  switch (toolName) {
+    case "bash":
+      return String(input.command ?? "");
+    case "file_read":
+      return `read ${input.path ?? ""}`;
+    case "file_write":
+      return `write ${input.path ?? ""}`;
+    case "file_edit":
+      return `edit ${input.path ?? ""}`;
+    case "web_fetch":
+      return String(input.url ?? "").slice(0, 80);
+    case "browser_navigate":
+      return `navigate ${String(input.url ?? "").slice(0, 80)}`;
+    case "browser_close":
+      return input.close_all_pages
+        ? "close all browser pages"
+        : "close browser page";
+    case "browser_click":
+      return `click ${input.element_id ?? input.selector ?? ""}`;
+    case "browser_type":
+      return `type into ${input.element_id ?? input.selector ?? ""}`;
+    case "browser_press_key":
+      return `press "${input.key ?? ""}"`;
+    default:
+      return `${toolName}: ${JSON.stringify(input).slice(0, 80)}`;
+  }
+}
+
+export function formatToolCallPreview(toolCall: ToolCallInfo): string {
+  switch (toolCall.name) {
+    case "bash":
+      return String(toolCall.input.command ?? "").slice(0, 80);
+    case "file_read":
+      return `read ${toolCall.input.path ?? ""}`;
+    case "file_write":
+      return `write ${toolCall.input.path ?? ""}`;
+    case "file_edit":
+      return `edit ${toolCall.input.path ?? ""}`;
+    case "web_search":
+      return String(toolCall.input.query ?? "").slice(0, 80);
+    case "web_fetch":
+      return String(toolCall.input.url ?? "").slice(0, 80);
+    case "browser_navigate":
+      return `navigate ${String(toolCall.input.url ?? "").slice(0, 80)}`;
+    case "browser_click":
+      return `click ${String(toolCall.input.element_id ?? toolCall.input.selector ?? "").slice(0, 60)}`;
+    case "browser_type":
+      return `type into ${String(toolCall.input.element_id ?? toolCall.input.selector ?? "").slice(0, 60)}`;
+    default:
+      return JSON.stringify(toolCall.input).slice(0, 80);
+  }
+}
+
+export function truncateValue(value: unknown, maxLength: number): string {
+  if (typeof value === "string") {
+    if (value.length > maxLength) {
+      return value.slice(0, maxLength - 3) + "...";
+    }
+    return value;
+  }
+  const serialized = JSON.stringify(value);
+  if (serialized.length > maxLength) {
+    return serialized.slice(0, maxLength - 3) + "...";
+  }
+  return serialized;
+}
+
+export function formatHeaderTitle(assistantName?: string): string {
+  const rawTitle = assistantName?.trim() || "Meet your Assistant!";
+  const title = rawTitle.replace(/\s+/g, " ");
+  const maxTitleLength = LEFT_PANEL_WIDTH - 2;
+  const displayTitle =
+    title.length > maxTitleLength
+      ? title.slice(0, maxTitleLength - 3) + "..."
+      : title;
+  return `  ${displayTitle}`;
+}
+
+export function formatHeaderEyebrow(): string {
+  return "  Assistant";
+}
+
+export function stripAnsi(value: string): string {
+  return value.replace(/\x1b\[[0-9;]*m/g, "");
+}
+
+export function isRuntimeMessage(item: FeedItem): item is RuntimeMessage {
+  return "role" in item;
+}
+
+export function estimateItemHeight(
+  item: FeedItem,
+  terminalColumns: number,
+): number {
+  if (isRuntimeMessage(item)) {
+    const columns = Math.max(1, terminalColumns);
+    const defaultLabel = item.role === "user" ? "You:" : "Assistant:";
+    const label = item.label ?? defaultLabel;
+    const prefixLength = 10 + label.length + 1;
+    let lines = 0;
+    const contentLines = item.content.split("\n");
+    for (let index = 0; index < contentLines.length; index++) {
+      const lineLength =
+        index === 0
+          ? contentLines[index].length + prefixLength
+          : contentLines[index].length;
+      lines += Math.max(1, Math.ceil(lineLength / columns));
+    }
+    if (item.role === "assistant" && item.toolCalls) {
+      for (const toolCall of item.toolCalls) {
+        const parameterCount =
+          typeof toolCall.input === "object" && toolCall.input
+            ? Object.keys(toolCall.input).length
+            : 0;
+        lines +=
+          TOOL_CALL_CHROME_LINES +
+          parameterCount +
+          (toolCall.result !== undefined ? 1 : 0);
+      }
+    }
+    return lines + MESSAGE_SPACING;
+  }
+  if (item.type === "help") {
+    return HELP_DISPLAY_HEIGHT;
+  }
+  if (item.type === "status" || item.type === "error") {
+    const columns = Math.max(1, terminalColumns);
+    let lines = 0;
+    for (const line of item.text.split("\n")) {
+      lines += Math.max(1, Math.ceil(line.length / columns));
+    }
+    return lines;
+  }
+  return 1;
+}
+
+export function calculateHeaderHeight(
+  species: Species,
+  terminalColumns = DEFAULT_TERMINAL_COLUMNS,
+): number {
+  if (terminalColumns < COMPACT_THRESHOLD) {
+    return COMPACT_HEADER_HEIGHT;
+  }
+  const artLength = SPECIES_CONFIG[species].art.length;
+  const leftLineCount = LEFT_HEADER_LINES + artLength + LEFT_FOOTER_LINES;
+  const maxLines = Math.max(leftLineCount, RIGHT_PANEL_LINE_COUNT);
+  return maxLines + HEADER_CHROME_LINES;
+}

package/src/lib/nginx-ingress.ts

@@ -128,6 +128,8 @@ const DENYLIST_LOCATIONS = `    location = /auth/token { return 404; }
     location = /v1/remote-web/pairing-requests/deny/ { return 404; }
     location = /v1/remote-web/pairing-verification { return 404; }
     location = /v1/remote-web/pairing-verification/ { return 404; }
+    location = /v1/shared/invites/redeem { return 404; }
+    location = /v1/shared/invites/redeem/ { return 404; }
     location ^~ /assistant/__local/ { return 404; }
     location ^~ /assistant/__gateway/ { return 404; }
     location ^~ /assistant/__gateway-paired/ { return 404; }`;
@@ -180,7 +182,7 @@ function remoteWebIngressConfig(
  * fingerprint matches, so this must change whenever the generated index or
  * nginx template does.
  */
-export const EDGE_TEMPLATE_VERSION = 7;
+export const EDGE_TEMPLATE_VERSION = 8;
 
 /**
  * Stable fingerprint of the SPA config injected into the served index and

package/src/lib/provider-secrets.ts

@@ -76,6 +76,7 @@ const PROVIDER_LABELS: Record<LlmProviderId, string> = {
   litellm: "LiteLLM",
   opencode: "OpenCode",
   baseten: "Baseten",
+  ionet: "IO Intelligence",
   poolside: "Poolside",
   typesafe: "TypeSafe",
 };
@@ -96,6 +97,7 @@ export const HATCH_PROVIDER_CHOICES: readonly LlmProviderId[] = [
   "minimax",
   "atlascloud",
   "baseten",
+  "ionet",
   "poolside",
 ];
 
@@ -229,6 +231,14 @@ export function inferProviderFromModel(model: string): string | undefined {
     // AI Gateway does not carry these IDs.
     return "openrouter";
   }
+  if (
+    model === "meta-llama/Llama-3.3-70B-Instruct" ||
+    model === "openai/gpt-oss-20b"
+  ) {
+    // IO Intelligence (io.net) exclusives; the remaining meta-llama/ IDs
+    // belong to OpenRouter.
+    return "ionet";
+  }
   if (model.startsWith("openai/") || model.startsWith("xai/")) {
     return "vercel-ai-gateway";
   }

package/src/shared/provider-env-vars.ts

@@ -33,6 +33,7 @@ export const LLM_PROVIDER_ENV_VAR_NAMES: Record<string, string> = {
   litellm: "LITELLM_API_KEY",
   opencode: "OPENCODE_API_KEY",
   baseten: "BASETEN_API_KEY",
+  ionet: "IONET_API_KEY",
   poolside: "POOLSIDE_API_KEY",
   typesafe: "TYPESAFE_API_KEY",
 };