Merge remote-tracking branch 'origin/main' into processviewer-widget

Author: sawka

.github/workflows/deploy-docsite.yml

@@ -55,7 +55,7 @@ jobs:
             - name: Upload Build Artifact
               # Only upload the build artifact when pushed to the main branch
               if: github.event_name == 'push' && github.ref == 'refs/heads/main'
-              uses: actions/upload-pages-artifact@v3
+              uses: actions/upload-pages-artifact@v4
               with:
                   path: docs/build
     deploy:

docs/docs/releasenotes.mdx

@@ -6,6 +6,31 @@ sidebar_position: 200
 
 # Release Notes
 
+### v0.14.4 — Mar 26, 2026
+
+Wave v0.14.4 introduces vertical tabs, upgrades to xterm.js v6, and includes a collection of bug fixes and internal improvements.
+
+**Vertical Tab Bar:**
+
+- **New Vertical Tab Bar Option** - Tabs can now be displayed vertically along the side of the window, giving you more horizontal space and easier access to tabs when you have many open. Toggle between horizontal and vertical tab layouts in settings.
+
+**Terminal Improvements:**
+
+- **xterm.js v6.0.0 Upgrade** - Upgraded to the latest xterm.js v6, bringing improved terminal compatibility and rendering. This should resolve various terminal rendering quirks observed with tools like Claude Code.
+
+**Other Changes:**
+
+- **`backgrounds.json`** - Renamed `presets/bg.json` to `backgrounds.json` and moved background config to new `tab:background` key (auto-migrated on startup)
+- **Config Errors Moved** - Config errors removed from the tab bar and moved to Settings / WaveConfig view for less clutter
+- **Warn on Unsaved Changes** - WaveConfig view now warns before discarding unsaved changes
+- **Stream Performance** - Migrated file streaming to new modern interface with flow control, fixing a large time-to-first-byte streaming bug
+- **macOS First Click** - Improved first-click handling on macOS (cancel the click but properly set block/WaveAI focus)
+- Deprecated legacy AI widget has been removed
+- [bugfix] Fixed focus bug for newly created blocks
+- [bugfix] Fixed an issue around starting a new durable session by splitting an old one
+- Electron upgraded to v41
+- Package updates and dependency upgrades
+
 ### v0.14.2 — Mar 12, 2026
 
 Wave v0.14.2 adds block/tab badges, directory preview improvements, and assorted bug fixes.

frontend/app/asset/claude-color.svg

@@ -1,7 +1,7 @@
 // Copyright 2026, Command Line Inc.
 // SPDX-License-Identifier: Apache-2.0
 
-export const CurrentOnboardingVersion = "v0.14.3";
+export const CurrentOnboardingVersion = "v0.14.4";
 
 export function OnboardingGradientBg() {
     return (

frontend/app/onboarding/onboarding-common.tsx

@@ -25,6 +25,7 @@ import { UpgradeOnboardingModal_v0_13_1_Content } from "./onboarding-upgrade-v01
 import { UpgradeOnboardingModal_v0_14_0_Content } from "./onboarding-upgrade-v0140";
 import { UpgradeOnboardingModal_v0_14_1_Content } from "./onboarding-upgrade-v0141";
 import { UpgradeOnboardingModal_v0_14_2_Content } from "./onboarding-upgrade-v0142";
+import { UpgradeOnboardingModal_v0_14_4_Content } from "./onboarding-upgrade-v0144";
 
 interface VersionConfig {
     version: string;
@@ -139,6 +140,12 @@ export const UpgradeOnboardingVersions: VersionConfig[] = [
         version: "v0.14.3",
         content: () => <UpgradeOnboardingModal_v0_14_2_Content />,
         prevText: "Prev (v0.14.1)",
+        nextText: "Next (v0.14.4)",
+    },
+    {
+        version: "v0.14.4",
+        content: () => <UpgradeOnboardingModal_v0_14_4_Content />,
+        prevText: "Prev (v0.14.3)",
     },
 ];
 

frontend/app/onboarding/onboarding-upgrade-patch.tsx

@@ -0,0 +1,84 @@
+// Copyright 2026, Command Line Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+const UpgradeOnboardingModal_v0_14_4_Content = () => {
+    return (
+        <div className="flex flex-col items-start gap-6 w-full mb-4 unselectable">
+            <div className="text-secondary leading-relaxed">
+                <p className="mb-0">
+                    Wave v0.14.4 introduces vertical tabs, upgrades to xterm.js v6, and includes bug fixes and UI
+                    improvements.
+                </p>
+            </div>
+
+            <div className="flex w-full items-start gap-4">
+                <div className="flex-shrink-0">
+                    <i className="text-[24px] text-accent fa-solid fa-table-columns"></i>
+                </div>
+                <div className="flex flex-col items-start gap-2 flex-1">
+                    <div className="text-foreground text-base font-semibold leading-[18px]">Vertical Tab Bar</div>
+                    <div className="text-secondary leading-5">
+                        <ul className="list-disc list-outside space-y-1 pl-5">
+                            <li>
+                                <strong>New Vertical Tab Bar Option</strong> - Tabs can now be displayed vertically
+                                along the side of the window for more horizontal space. Toggle between horizontal and
+                                vertical layouts in settings.
+                            </li>
+                        </ul>
+                    </div>
+                </div>
+            </div>
+
+            <div className="flex w-full items-start gap-4">
+                <div className="flex-shrink-0">
+                    <i className="text-[24px] text-accent fa-solid fa-terminal"></i>
+                </div>
+                <div className="flex flex-col items-start gap-2 flex-1">
+                    <div className="text-foreground text-base font-semibold leading-[18px]">Terminal Improvements</div>
+                    <div className="text-secondary leading-5">
+                        <ul className="list-disc list-outside space-y-1 pl-5">
+                            <li>
+                                <strong>xterm.js v6.0.0 Upgrade</strong> - Improved terminal compatibility and
+                                rendering, resolving quirks with tools like Claude Code
+                            </li>
+                        </ul>
+                    </div>
+                </div>
+            </div>
+
+            <div className="flex w-full items-start gap-4">
+                <div className="flex-shrink-0">
+                    <i className="text-[24px] text-accent fa-solid fa-wrench"></i>
+                </div>
+                <div className="flex flex-col items-start gap-2 flex-1">
+                    <div className="text-foreground text-base font-semibold leading-[18px]">Other Changes</div>
+                    <div className="text-secondary leading-5">
+                        <ul className="list-disc list-outside space-y-1 pl-5">
+                            <li>
+                                <strong>macOS First Click</strong> - First click now focuses the clicked widget
+                            </li>
+                            <li>
+                                <strong>
+                                    <code>backgrounds.json</code>
+                                </strong>{" "}
+                                - Renamed <code>presets/bg.json</code> to <code>backgrounds.json</code>
+                            </li>
+                            <li>
+                                <strong>Config Errors Moved</strong> - Config errors to the WaveConfig view for less
+                                clutter
+                            </li>
+                            <li>WaveConfig now warns on Unsaved Changes</li>
+                            <li>Preview streaming fixes for images/videos</li>
+                            <li>Deprecated legacy AI widget has been removed</li>
+                            <li>[bugfix] Fixed focus bug for newly created blocks</li>
+                        </ul>
+                    </div>
+                </div>
+            </div>
+        </div>
+    );
+};
+
+UpgradeOnboardingModal_v0_14_4_Content.displayName = "UpgradeOnboardingModal_v0_14_4_Content";
+
+export { UpgradeOnboardingModal_v0_14_4_Content };

frontend/app/onboarding/onboarding-upgrade-v0144.tsx

@@ -0,0 +1,23 @@
+import { describe, expect, it } from "vitest";
+
+import { isClaudeCodeCommand } from "./osc-handlers";
+
+describe("isClaudeCodeCommand", () => {
+    it("matches direct Claude Code invocations", () => {
+        expect(isClaudeCodeCommand("claude")).toBe(true);
+        expect(isClaudeCodeCommand("claude --dangerously-skip-permissions")).toBe(true);
+    });
+
+    it("matches Claude Code invocations wrapped with env assignments", () => {
+        expect(isClaudeCodeCommand('ANTHROPIC_API_KEY="test" claude')).toBe(true);
+        expect(isClaudeCodeCommand("env FOO=bar claude --print")).toBe(true);
+    });
+
+    it("ignores other commands", () => {
+        expect(isClaudeCodeCommand("claudes")).toBe(false);
+        expect(isClaudeCodeCommand("echo claude")).toBe(false);
+        expect(isClaudeCodeCommand("ls ~/claude")).toBe(false);
+        expect(isClaudeCodeCommand("cat /logs/claude")).toBe(false);
+        expect(isClaudeCodeCommand("")).toBe(false);
+    });
+});

frontend/app/view/term/osc-handlers.test.ts

@@ -25,6 +25,8 @@ const Osc52MaxRawLength = 128 * 1024; // includes selector + base64 + whitespace
 // See aiprompts/wave-osc-16162.md for full documentation
 export type ShellIntegrationStatus = "ready" | "running-command";
 
+const ClaudeCodeRegex = /^claude\b/;
+
 type Osc16162Command =
     | { command: "A"; data: Record<string, never> }
     | { command: "C"; data: { cmd64?: string } }
@@ -43,41 +45,56 @@ type Osc16162Command =
     | { command: "I"; data: { inputempty?: boolean } }
     | { command: "R"; data: Record<string, never> };
 
+function normalizeCmd(decodedCmd: string): string {
+    let normalizedCmd = decodedCmd.trim();
+    normalizedCmd = normalizedCmd.replace(/^env\s+/, "");
+    normalizedCmd = normalizedCmd.replace(/^(?:\w+=(?:"[^"]*"|'[^']*'|\S+)\s+)*/, "");
+    return normalizedCmd;
+}
+
 function checkCommandForTelemetry(decodedCmd: string) {
     if (!decodedCmd) {
         return;
     }
 
-    if (decodedCmd.startsWith("ssh ")) {
+    const normalizedCmd = normalizeCmd(decodedCmd);
+
+    if (normalizedCmd.startsWith("ssh ")) {
         recordTEvent("conn:connect", { "conn:conntype": "ssh-manual" });
         return;
     }
 
     const editorsRegex = /^(vim|vi|nano|nvim)\b/;
-    if (editorsRegex.test(decodedCmd)) {
+    if (editorsRegex.test(normalizedCmd)) {
         recordTEvent("action:term", { "action:type": "cli-edit" });
         return;
     }
 
     const tailFollowRegex = /(^|\|\s*)tail\s+-[fF]\b/;
-    if (tailFollowRegex.test(decodedCmd)) {
+    if (tailFollowRegex.test(normalizedCmd)) {
         recordTEvent("action:term", { "action:type": "cli-tailf" });
         return;
     }
 
-    const claudeRegex = /^claude\b/;
-    if (claudeRegex.test(decodedCmd)) {
+    if (ClaudeCodeRegex.test(normalizedCmd)) {
         recordTEvent("action:term", { "action:type": "claude" });
         return;
     }
 
     const opencodeRegex = /^opencode\b/;
-    if (opencodeRegex.test(decodedCmd)) {
+    if (opencodeRegex.test(normalizedCmd)) {
         recordTEvent("action:term", { "action:type": "opencode" });
         return;
     }
 }
 
+export function isClaudeCodeCommand(decodedCmd: string): boolean {
+    if (!decodedCmd) {
+        return false;
+    }
+    return ClaudeCodeRegex.test(normalizeCmd(decodedCmd));
+}
+
 function handleShellIntegrationCommandStart(
     termWrap: TermWrap,
     blockId: string,
@@ -101,16 +118,20 @@ function handleShellIntegrationCommandStart(
                 const decodedCmd = base64ToString(cmd.data.cmd64);
                 rtInfo["shell:lastcmd"] = decodedCmd;
                 globalStore.set(termWrap.lastCommandAtom, decodedCmd);
+                const isCC = isClaudeCodeCommand(decodedCmd);
+                globalStore.set(termWrap.claudeCodeActiveAtom, isCC);
                 checkCommandForTelemetry(decodedCmd);
             } catch (e) {
                 console.error("Error decoding cmd64:", e);
                 rtInfo["shell:lastcmd"] = null;
                 globalStore.set(termWrap.lastCommandAtom, null);
+                globalStore.set(termWrap.claudeCodeActiveAtom, false);
             }
         }
     } else {
         rtInfo["shell:lastcmd"] = null;
         globalStore.set(termWrap.lastCommandAtom, null);
+        globalStore.set(termWrap.claudeCodeActiveAtom, false);
     }
     rtInfo["shell:lastcmdexitcode"] = null;
 }
@@ -287,6 +308,7 @@ export function handleOsc16162Command(data: string, blockId: string, loaded: boo
         case "A": {
             rtInfo["shell:state"] = "ready";
             globalStore.set(termWrap.shellIntegrationStatusAtom, "ready");
+            globalStore.set(termWrap.claudeCodeActiveAtom, false);
             const marker = terminal.registerMarker(0);
             if (marker) {
                 termWrap.promptMarkers.push(marker);
@@ -324,6 +346,7 @@ export function handleOsc16162Command(data: string, blockId: string, loaded: boo
             }
             break;
         case "D":
+            globalStore.set(termWrap.claudeCodeActiveAtom, false);
             if (cmd.data.exitcode != null) {
                 rtInfo["shell:lastcmdexitcode"] = cmd.data.exitcode;
             } else {
@@ -337,6 +360,7 @@ export function handleOsc16162Command(data: string, blockId: string, loaded: boo
             break;
         case "R":
             globalStore.set(termWrap.shellIntegrationStatusAtom, null);
+            globalStore.set(termWrap.claudeCodeActiveAtom, false);
             if (terminal.buffer.active.type === "alternate") {
                 terminal.write("\x1b[?1049l");
             }

frontend/app/view/term/osc-handlers.ts

@@ -10,7 +10,7 @@ import { waveEventSubscribeSingle } from "@/app/store/wps";
 import { RpcApi } from "@/app/store/wshclientapi";
 import { makeFeBlockRouteId } from "@/app/store/wshrouter";
 import { DefaultRouter, TabRpcClient } from "@/app/store/wshrpcutil";
-import { TerminalView } from "@/app/view/term/term";
+import { TermClaudeIcon, TerminalView } from "@/app/view/term/term";
 import { TermWshClient } from "@/app/view/term/term-wsh";
 import { VDomModel } from "@/app/view/vdom/vdom-model";
 import { WorkspaceLayoutModel } from "@/app/workspace/workspace-layout-model";
@@ -404,10 +404,12 @@ export class TermViewModel implements ViewModel {
             return null;
         }
         const shellIntegrationStatus = get(this.termRef.current.shellIntegrationStatusAtom);
+        const claudeCodeActive = get(this.termRef.current.claudeCodeActiveAtom);
+        const icon = claudeCodeActive ? React.createElement(TermClaudeIcon) : "sparkles";
         if (shellIntegrationStatus == null) {
             return {
                 elemtype: "iconbutton",
-                icon: "sparkles",
+                icon,
                 className: "text-muted",
                 title: "No shell integration — Wave AI unable to run commands.",
                 noAction: true,
@@ -416,14 +418,16 @@ export class TermViewModel implements ViewModel {
         if (shellIntegrationStatus === "ready") {
             return {
                 elemtype: "iconbutton",
-                icon: "sparkles",
+                icon,
                 className: "text-accent",
                 title: "Shell ready — Wave AI can run commands in this terminal.",
                 noAction: true,
             };
         }
         if (shellIntegrationStatus === "running-command") {
-            let title = "Shell busy — Wave AI unable to run commands while another command is running.";
+            let title = claudeCodeActive
+                ? "Claude Code Detected"
+                : "Shell busy — Wave AI unable to run commands while another command is running.";
 
             if (this.termRef.current) {
                 const inAltBuffer = this.termRef.current.terminal?.buffer?.active?.type === "alternate";
@@ -436,7 +440,7 @@ export class TermViewModel implements ViewModel {
 
             return {
                 elemtype: "iconbutton",
-                icon: "sparkles",
+                icon,
                 className: "text-warning",
                 title: title,
                 noAction: true,