@vellumai/cli 0.12.5 → 0.12.6-dev.202609292116.41f7caa

package/node_modules/@vellumai/environments/src/shell.test.ts

@@ -3,18 +3,30 @@ import { describe, expect, test } from "bun:test";
 import {
   buildShellInvocation,
   buildShellSpawnFlags,
+  CHILD_OOM_SCORE_ADJ,
   pathListDelimiter,
   prependUniquePathEntries,
 } from "./shell.js";
 
 describe("buildShellInvocation", () => {
   test("uses Bash on POSIX hosts", () => {
-    expect(buildShellInvocation("printf hello", "linux")).toEqual({
+    expect(buildShellInvocation("printf hello", "darwin")).toEqual({
       command: "bash",
       args: ["-c", "--", "printf hello"],
     });
   });
 
+  test("raises the shell's OOM-kill priority on Linux", () => {
+    expect(buildShellInvocation("printf hello", "linux")).toEqual({
+      command: "bash",
+      args: [
+        "-c",
+        "--",
+        `echo ${CHILD_OOM_SCORE_ADJ} 2>/dev/null >/proc/self/oom_score_adj; printf hello`,
+      ],
+    });
+  });
+
   test("uses encoded non-interactive PowerShell on Windows", () => {
     const invocation = buildShellInvocation(
       "Write-Output 'hello 世界'",

package/node_modules/@vellumai/environments/src/shell.ts

@@ -24,6 +24,23 @@ if (-not $__vellumCommandSucceeded) {
 }
 exit 0`;
 
+/**
+ * `oom_score_adj` for assistant-owned tool processes. Any positive value
+ * outranks a 0-scored process; 1000 makes a tool the kernel's first choice
+ * whenever the container runs out of memory, so the assistant itself is never
+ * the victim of a runaway command.
+ */
+export const CHILD_OOM_SCORE_ADJ = 1000;
+
+/**
+ * Prefix for a Bash `-c` script that raises the shell's own OOM-kill priority
+ * before the command runs. Every process the command forks inherits it. Bash
+ * performs a builtin's redirection itself, so `/proc/self` is the shell.
+ * Redirections apply left to right, so stderr goes to /dev/null before the
+ * procfs open can fail and complain about it.
+ */
+const LINUX_OOM_SCORE_ADJ_PREFIX = `echo ${CHILD_OOM_SCORE_ADJ} 2>/dev/null >/proc/self/oom_score_adj; `;
+
 export function buildShellInvocation(
   command: string,
   hostPlatform: NodeJS.Platform = process.platform,
@@ -45,7 +62,11 @@ export function buildShellInvocation(
       ],
     };
   }
-  return { command: "bash", args: ["-c", "--", command] };
+  const script =
+    hostPlatform === "linux"
+      ? `${LINUX_OOM_SCORE_ADJ_PREFIX}${command}`
+      : command;
+  return { command: "bash", args: ["-c", "--", script] };
 }
 
 /**

package/node_modules/@vellumai/local-mode/node_modules/@vellumai/environments/src/shell.test.ts

@@ -3,18 +3,30 @@ import { describe, expect, test } from "bun:test";
 import {
   buildShellInvocation,
   buildShellSpawnFlags,
+  CHILD_OOM_SCORE_ADJ,
   pathListDelimiter,
   prependUniquePathEntries,
 } from "./shell.js";
 
 describe("buildShellInvocation", () => {
   test("uses Bash on POSIX hosts", () => {
-    expect(buildShellInvocation("printf hello", "linux")).toEqual({
+    expect(buildShellInvocation("printf hello", "darwin")).toEqual({
       command: "bash",
       args: ["-c", "--", "printf hello"],
     });
   });
 
+  test("raises the shell's OOM-kill priority on Linux", () => {
+    expect(buildShellInvocation("printf hello", "linux")).toEqual({
+      command: "bash",
+      args: [
+        "-c",
+        "--",
+        `echo ${CHILD_OOM_SCORE_ADJ} 2>/dev/null >/proc/self/oom_score_adj; printf hello`,
+      ],
+    });
+  });
+
   test("uses encoded non-interactive PowerShell on Windows", () => {
     const invocation = buildShellInvocation(
       "Write-Output 'hello 世界'",

package/node_modules/@vellumai/local-mode/node_modules/@vellumai/environments/src/shell.ts

@@ -24,6 +24,23 @@ if (-not $__vellumCommandSucceeded) {
 }
 exit 0`;
 
+/**
+ * `oom_score_adj` for assistant-owned tool processes. Any positive value
+ * outranks a 0-scored process; 1000 makes a tool the kernel's first choice
+ * whenever the container runs out of memory, so the assistant itself is never
+ * the victim of a runaway command.
+ */
+export const CHILD_OOM_SCORE_ADJ = 1000;
+
+/**
+ * Prefix for a Bash `-c` script that raises the shell's own OOM-kill priority
+ * before the command runs. Every process the command forks inherits it. Bash
+ * performs a builtin's redirection itself, so `/proc/self` is the shell.
+ * Redirections apply left to right, so stderr goes to /dev/null before the
+ * procfs open can fail and complain about it.
+ */
+const LINUX_OOM_SCORE_ADJ_PREFIX = `echo ${CHILD_OOM_SCORE_ADJ} 2>/dev/null >/proc/self/oom_score_adj; `;
+
 export function buildShellInvocation(
   command: string,
   hostPlatform: NodeJS.Platform = process.platform,
@@ -45,7 +62,11 @@ export function buildShellInvocation(
       ],
     };
   }
-  return { command: "bash", args: ["-c", "--", command] };
+  const script =
+    hostPlatform === "linux"
+      ? `${LINUX_OOM_SCORE_ADJ_PREFIX}${command}`
+      : command;
+  return { command: "bash", args: ["-c", "--", script] };
 }
 
 /**

package/node_modules/@vellumai/local-mode/node_modules/@vellumai/service-contracts/package.json

@@ -28,7 +28,8 @@
     "./guardian-requests": "./src/guardian-requests.ts",
     "./platform-credential": "./src/platform-credential.ts",
     "./plan-credit": "./src/plan-credit.ts",
-    "./integration-categories": "./src/integration-categories.ts"
+    "./integration-categories": "./src/integration-categories.ts",
+    "./mcp-oauth": "./src/mcp-oauth.ts"
   },
   "scripts": {
     "typecheck": "bunx tsc --noEmit",

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

@@ -0,0 +1,53 @@
+import { describe, expect, test } from "bun:test";
+
+import {
+  buildMcpOAuthCallbackUrl,
+  buildMcpOAuthClientMetadata,
+  buildMcpOAuthClientMetadataUrl,
+} from "../mcp-oauth.js";
+
+describe("MCP OAuth client metadata", () => {
+  test("builds the public client document", () => {
+    expect(
+      buildMcpOAuthClientMetadata({
+        clientId:
+          "https://velay.example/assistant-123/oauth/client-metadata.json",
+        redirectUris: [
+          "https://velay.example/assistant-123/webhooks/oauth/callback",
+        ],
+      }),
+    ).toEqual({
+      client_id:
+        "https://velay.example/assistant-123/oauth/client-metadata.json",
+      redirect_uris: [
+        "https://velay.example/assistant-123/webhooks/oauth/callback",
+      ],
+      token_endpoint_auth_method: "none",
+      grant_types: ["authorization_code", "refresh_token"],
+      response_types: ["code"],
+      client_name: "Vellum Assistant",
+      logo_uri: "https://www.vellum.ai/favicon.svg",
+    });
+  });
+
+  test("builds callback and metadata URLs from one normalized base", () => {
+    const baseUrl = "https://velay.example/assistant-123///";
+    expect(buildMcpOAuthCallbackUrl(baseUrl)).toBe(
+      "https://velay.example/assistant-123/webhooks/oauth/callback",
+    );
+    expect(buildMcpOAuthClientMetadataUrl(baseUrl)).toBe(
+      "https://velay.example/assistant-123/oauth/client-metadata.json",
+    );
+  });
+
+  test("canonicalizes equivalent public base URL spellings", () => {
+    const baseUrl = " https://VELAY.EXAMPLE:443/a/../assistant-123/// ";
+
+    expect(buildMcpOAuthCallbackUrl(baseUrl)).toBe(
+      "https://velay.example/assistant-123/webhooks/oauth/callback",
+    );
+    expect(buildMcpOAuthClientMetadataUrl(baseUrl)).toBe(
+      "https://velay.example/assistant-123/oauth/client-metadata.json",
+    );
+  });
+});

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

@@ -30,6 +30,7 @@ export * from "./ingress.js";
 export * from "./no-response.js";
 export * from "./plan-credit.js";
 export * from "./integration-categories.js";
+export * from "./mcp-oauth.js";
 export * from "./platform-credential.js";
 export * from "./remote-web-pairing.js";
 export * from "./twilio-ingress.js";

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

@@ -0,0 +1,60 @@
+import { normalizeHttpPublicBaseUrlWithoutTrailingSlash } from "./ingress.js";
+
+export const MCP_OAUTH_CALLBACK_PATH = "/webhooks/oauth/callback";
+export const MCP_OAUTH_CLIENT_METADATA_PATH = "/oauth/client-metadata.json";
+export const MCP_OAUTH_CLIENT_LOGO_URI = "https://www.vellum.ai/favicon.svg";
+
+export interface McpOAuthClientMetadata {
+  client_id?: string;
+  redirect_uris: string[];
+  token_endpoint_auth_method: "none";
+  grant_types: ["authorization_code", "refresh_token"];
+  response_types: ["code"];
+  client_name: string;
+  logo_uri: string;
+  software_id?: string;
+  software_version?: string;
+}
+
+export interface BuildMcpOAuthClientMetadataOptions {
+  clientId?: string;
+  redirectUris: string[];
+  clientName?: string;
+  softwareId?: string;
+  softwareVersion?: string;
+}
+
+export function buildMcpOAuthClientMetadata(
+  options: BuildMcpOAuthClientMetadataOptions,
+): McpOAuthClientMetadata {
+  return {
+    ...(options.clientId && { client_id: options.clientId }),
+    redirect_uris: options.redirectUris,
+    token_endpoint_auth_method: "none",
+    grant_types: ["authorization_code", "refresh_token"],
+    response_types: ["code"],
+    client_name: options.clientName ?? "Vellum Assistant",
+    logo_uri: MCP_OAUTH_CLIENT_LOGO_URI,
+    ...(options.softwareId && { software_id: options.softwareId }),
+    ...(options.softwareVersion && {
+      software_version: options.softwareVersion,
+    }),
+  };
+}
+
+export function buildMcpOAuthCallbackUrl(publicBaseUrl: string): string {
+  return `${normalizeBaseUrl(publicBaseUrl)}${MCP_OAUTH_CALLBACK_PATH}`;
+}
+
+export function buildMcpOAuthClientMetadataUrl(publicBaseUrl: string): string {
+  return `${normalizeBaseUrl(publicBaseUrl)}${MCP_OAUTH_CLIENT_METADATA_PATH}`;
+}
+
+function normalizeBaseUrl(publicBaseUrl: string): string {
+  const normalized =
+    normalizeHttpPublicBaseUrlWithoutTrailingSlash(publicBaseUrl);
+  if (!normalized) {
+    throw new Error("MCP OAuth public base URL must be an absolute HTTP URL");
+  }
+  return normalized;
+}

package/node_modules/@vellumai/service-contracts/package.json

@@ -28,7 +28,8 @@
     "./guardian-requests": "./src/guardian-requests.ts",
     "./platform-credential": "./src/platform-credential.ts",
     "./plan-credit": "./src/plan-credit.ts",
-    "./integration-categories": "./src/integration-categories.ts"
+    "./integration-categories": "./src/integration-categories.ts",
+    "./mcp-oauth": "./src/mcp-oauth.ts"
   },
   "scripts": {
     "typecheck": "bunx tsc --noEmit",

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

@@ -0,0 +1,53 @@
+import { describe, expect, test } from "bun:test";
+
+import {
+  buildMcpOAuthCallbackUrl,
+  buildMcpOAuthClientMetadata,
+  buildMcpOAuthClientMetadataUrl,
+} from "../mcp-oauth.js";
+
+describe("MCP OAuth client metadata", () => {
+  test("builds the public client document", () => {
+    expect(
+      buildMcpOAuthClientMetadata({
+        clientId:
+          "https://velay.example/assistant-123/oauth/client-metadata.json",
+        redirectUris: [
+          "https://velay.example/assistant-123/webhooks/oauth/callback",
+        ],
+      }),
+    ).toEqual({
+      client_id:
+        "https://velay.example/assistant-123/oauth/client-metadata.json",
+      redirect_uris: [
+        "https://velay.example/assistant-123/webhooks/oauth/callback",
+      ],
+      token_endpoint_auth_method: "none",
+      grant_types: ["authorization_code", "refresh_token"],
+      response_types: ["code"],
+      client_name: "Vellum Assistant",
+      logo_uri: "https://www.vellum.ai/favicon.svg",
+    });
+  });
+
+  test("builds callback and metadata URLs from one normalized base", () => {
+    const baseUrl = "https://velay.example/assistant-123///";
+    expect(buildMcpOAuthCallbackUrl(baseUrl)).toBe(
+      "https://velay.example/assistant-123/webhooks/oauth/callback",
+    );
+    expect(buildMcpOAuthClientMetadataUrl(baseUrl)).toBe(
+      "https://velay.example/assistant-123/oauth/client-metadata.json",
+    );
+  });
+
+  test("canonicalizes equivalent public base URL spellings", () => {
+    const baseUrl = " https://VELAY.EXAMPLE:443/a/../assistant-123/// ";
+
+    expect(buildMcpOAuthCallbackUrl(baseUrl)).toBe(
+      "https://velay.example/assistant-123/webhooks/oauth/callback",
+    );
+    expect(buildMcpOAuthClientMetadataUrl(baseUrl)).toBe(
+      "https://velay.example/assistant-123/oauth/client-metadata.json",
+    );
+  });
+});

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

@@ -30,6 +30,7 @@ export * from "./ingress.js";
 export * from "./no-response.js";
 export * from "./plan-credit.js";
 export * from "./integration-categories.js";
+export * from "./mcp-oauth.js";
 export * from "./platform-credential.js";
 export * from "./remote-web-pairing.js";
 export * from "./twilio-ingress.js";

package/node_modules/@vellumai/service-contracts/src/mcp-oauth.ts

@@ -0,0 +1,60 @@
+import { normalizeHttpPublicBaseUrlWithoutTrailingSlash } from "./ingress.js";
+
+export const MCP_OAUTH_CALLBACK_PATH = "/webhooks/oauth/callback";
+export const MCP_OAUTH_CLIENT_METADATA_PATH = "/oauth/client-metadata.json";
+export const MCP_OAUTH_CLIENT_LOGO_URI = "https://www.vellum.ai/favicon.svg";
+
+export interface McpOAuthClientMetadata {
+  client_id?: string;
+  redirect_uris: string[];
+  token_endpoint_auth_method: "none";
+  grant_types: ["authorization_code", "refresh_token"];
+  response_types: ["code"];
+  client_name: string;
+  logo_uri: string;
+  software_id?: string;
+  software_version?: string;
+}
+
+export interface BuildMcpOAuthClientMetadataOptions {
+  clientId?: string;
+  redirectUris: string[];
+  clientName?: string;
+  softwareId?: string;
+  softwareVersion?: string;
+}
+
+export function buildMcpOAuthClientMetadata(
+  options: BuildMcpOAuthClientMetadataOptions,
+): McpOAuthClientMetadata {
+  return {
+    ...(options.clientId && { client_id: options.clientId }),
+    redirect_uris: options.redirectUris,
+    token_endpoint_auth_method: "none",
+    grant_types: ["authorization_code", "refresh_token"],
+    response_types: ["code"],
+    client_name: options.clientName ?? "Vellum Assistant",
+    logo_uri: MCP_OAUTH_CLIENT_LOGO_URI,
+    ...(options.softwareId && { software_id: options.softwareId }),
+    ...(options.softwareVersion && {
+      software_version: options.softwareVersion,
+    }),
+  };
+}
+
+export function buildMcpOAuthCallbackUrl(publicBaseUrl: string): string {
+  return `${normalizeBaseUrl(publicBaseUrl)}${MCP_OAUTH_CALLBACK_PATH}`;
+}
+
+export function buildMcpOAuthClientMetadataUrl(publicBaseUrl: string): string {
+  return `${normalizeBaseUrl(publicBaseUrl)}${MCP_OAUTH_CLIENT_METADATA_PATH}`;
+}
+
+function normalizeBaseUrl(publicBaseUrl: string): string {
+  const normalized =
+    normalizeHttpPublicBaseUrlWithoutTrailingSlash(publicBaseUrl);
+  if (!normalized) {
+    throw new Error("MCP OAuth public base URL must be an absolute HTTP URL");
+  }
+  return normalized;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/cli",
-  "version": "0.12.5",
+  "version": "0.12.6-dev.202609292116.41f7caa",
   "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/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",
 };
@@ -48,6 +49,7 @@ export const SEARCH_PROVIDER_ENV_VAR_NAMES: Record<string, string> = {
   searxng: "SEARXNG_API_KEY",
   tinyfish: "TINYFISH_API_KEY",
   exa: "EXA_API_KEY",
+  serply: "SERPLY_API_KEY",
 };
 
 /**