Merge branch 'main' into main

Author: somatothing

.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:

cmd/server/main-server.go

@@ -384,7 +384,6 @@ func shutdownActivityUpdate() {
 
 func createMainWshClient() {
 	rpc := wshserver.GetMainRpcClient()
-	wshfs.RpcClient = rpc
 	wshutil.DefaultRouter.RegisterTrustedLeaf(rpc, wshutil.DefaultRoute)
 	wps.Broker.SetClient(wshutil.DefaultRouter)
 	localInitialEnv := envutil.PruneInitialEnv(envutil.SliceToMap(os.Environ()))
@@ -393,6 +392,8 @@ func createMainWshClient() {
 	localConnWsh := wshutil.MakeWshRpc(wshrpc.RpcContext{Conn: wshrpc.LocalConnName}, remoteImpl, "conn:local")
 	go wshremote.RunSysInfoLoop(localConnWsh, wshrpc.LocalConnName)
 	wshutil.DefaultRouter.RegisterTrustedLeaf(localConnWsh, wshutil.MakeConnectionRouteId(wshrpc.LocalConnName))
+	wshfs.RpcClient = localConnWsh
+	wshfs.RpcClientRouteId = wshutil.MakeConnectionRouteId(wshrpc.LocalConnName)
 }
 
 func grabAndRemoveEnvVars() error {

cmd/wsh/cmd/wshcmd-connserver.go

@@ -183,7 +183,7 @@ func runListener(listener net.Listener, router *wshutil.WshRouter) {
 	}
 }
 
-func setupConnServerRpcClientWithRouter(router *wshutil.WshRouter, sockName string) (*wshutil.WshRpc, error) {
+func setupConnServerRpcClientWithRouter(router *wshutil.WshRouter, sockName string) (*wshutil.WshRpc, string, error) {
 	routeId := wshutil.MakeConnectionRouteId(connServerConnName)
 	rpcCtx := wshrpc.RpcContext{
 		RouteId: routeId,
@@ -196,7 +196,7 @@ func setupConnServerRpcClientWithRouter(router *wshutil.WshRouter, sockName stri
 
 	connServerClient := wshutil.MakeWshRpc(rpcCtx, wshremote.MakeRemoteRpcServerImpl(os.Stdout, router, bareClient, false, connServerInitialEnv, sockName), routeId)
 	router.RegisterTrustedLeaf(connServerClient, routeId)
-	return connServerClient, nil
+	return connServerClient, routeId, nil
 }
 
 func serverRunRouter() error {
@@ -236,11 +236,12 @@ func serverRunRouter() error {
 	sockName := getRemoteDomainSocketName()
 
 	// setup the connserver rpc client first
-	client, err := setupConnServerRpcClientWithRouter(router, sockName)
+	client, bareRouteId, err := setupConnServerRpcClientWithRouter(router, sockName)
 	if err != nil {
 		return fmt.Errorf("error setting up connserver rpc client: %v", err)
 	}
 	wshfs.RpcClient = client
+	wshfs.RpcClientRouteId = bareRouteId
 
 	log.Printf("trying to get JWT public key")
 
@@ -360,11 +361,12 @@ func serverRunRouterDomainSocket(jwtToken string) error {
 	log.Printf("got JWT public key")
 
 	// now setup the connserver rpc client
-	client, err := setupConnServerRpcClientWithRouter(router, sockName)
+	client, bareRouteId, err := setupConnServerRpcClientWithRouter(router, sockName)
 	if err != nil {
 		return fmt.Errorf("error setting up connserver rpc client: %v", err)
 	}
 	wshfs.RpcClient = client
+	wshfs.RpcClientRouteId = bareRouteId
 
 	// set up the local domain socket listener for local wsh commands
 	unixListener, err := MakeRemoteUnixListener()
@@ -402,6 +404,7 @@ func serverRunNormal(jwtToken string) error {
 		return err
 	}
 	wshfs.RpcClient = RpcClient
+	wshfs.RpcClientRouteId = RpcClientRouteId
 	WriteStdout("running wsh connserver (%s)\n", RpcContext.Conn)
 	go func() {
 		defer func() {

cmd/wsh/cmd/wshcmd-file-util.go

@@ -1,4 +1,4 @@
-// Copyright 2025, Command Line Inc.
+// Copyright 2026, Command Line Inc.
 // SPDX-License-Identifier: Apache-2.0
 
 package cmd
@@ -12,10 +12,10 @@ import (
 	"strings"
 
 	"github.com/wavetermdev/waveterm/pkg/remote/connparse"
-	"github.com/wavetermdev/waveterm/pkg/remote/fileshare/fsutil"
 	"github.com/wavetermdev/waveterm/pkg/util/fileutil"
 	"github.com/wavetermdev/waveterm/pkg/wshrpc"
 	"github.com/wavetermdev/waveterm/pkg/wshrpc/wshclient"
+	"github.com/wavetermdev/waveterm/pkg/wshutil"
 )
 
 func convertNotFoundErr(err error) error {
@@ -91,8 +91,38 @@ func streamWriteToFile(fileData wshrpc.FileData, reader io.Reader) error {
 }
 
 func streamReadFromFile(ctx context.Context, fileData wshrpc.FileData, writer io.Writer) error {
-	ch := wshclient.FileReadStreamCommand(RpcClient, fileData, &wshrpc.RpcOpts{Timeout: fileTimeout})
-	return fsutil.ReadFileStreamToWriter(ctx, ch, writer)
+	broker := RpcClient.StreamBroker
+	if broker == nil {
+		return fmt.Errorf("stream broker not available")
+	}
+	if fileData.Info == nil {
+		return fmt.Errorf("file info is required")
+	}
+	readerRouteId := RpcClientRouteId
+	if readerRouteId == "" {
+		return fmt.Errorf("no route id available")
+	}
+	conn, err := connparse.ParseURI(fileData.Info.Path)
+	if err != nil {
+		return fmt.Errorf("parsing file path: %w", err)
+	}
+	writerRouteId := wshutil.MakeConnectionRouteId(conn.Host)
+	reader, streamMeta := broker.CreateStreamReader(readerRouteId, writerRouteId, 256*1024)
+	defer reader.Close()
+	go func() {
+		<-ctx.Done()
+		reader.Close()
+	}()
+	data := wshrpc.CommandFileStreamData{
+		Info:       fileData.Info,
+		StreamMeta: *streamMeta,
+	}
+	_, err = wshclient.FileStreamCommand(RpcClient, data, nil)
+	if err != nil {
+		return fmt.Errorf("starting file stream: %w", err)
+	}
+	_, err = io.Copy(writer, reader)
+	return err
 }
 
 func fixRelativePaths(path string) (string, error) {

cmd/wsh/cmd/wshcmd-file.go

@@ -172,11 +172,6 @@ func fileCatRun(cmd *cobra.Command, args []string) error {
 		return err
 	}
 
-	_, err = checkFileSize(path, MaxFileSize)
-	if err != nil {
-		return err
-	}
-
 	fileData := wshrpc.FileData{
 		Info: &wshrpc.FileInfo{
 			Path: path}}

cmd/wsh/cmd/wshcmd-root.go

@@ -31,6 +31,7 @@ var WrappedStdout io.Writer = &WrappedWriter{dest: os.Stdout}
 var WrappedStderr io.Writer = &WrappedWriter{dest: os.Stderr}
 var RpcClient *wshutil.WshRpc
 var RpcContext wshrpc.RpcContext
+var RpcClientRouteId string
 var UsingTermWshMode bool
 var blockArg string
 var WshExitCode int
@@ -140,7 +141,12 @@ func setupRpcClientWithToken(swapTokenStr string) (wshrpc.CommandAuthenticateRtn
 	if err != nil {
 		return rtn, fmt.Errorf("error setting up domain socket rpc client: %w", err)
 	}
-	return wshclient.AuthenticateTokenCommand(RpcClient, wshrpc.CommandAuthenticateTokenData{Token: token.Token}, &wshrpc.RpcOpts{Route: wshutil.ControlRoute})
+	rtn, err = wshclient.AuthenticateTokenCommand(RpcClient, wshrpc.CommandAuthenticateTokenData{Token: token.Token}, &wshrpc.RpcOpts{Route: wshutil.ControlRoute})
+	if err != nil {
+		return rtn, err
+	}
+	RpcClientRouteId = rtn.RouteId
+	return rtn, nil
 }
 
 // returns the wrapped stdin and a new rpc client (that wraps the stdin input and stdout output)
@@ -158,10 +164,11 @@ func setupRpcClient(serverImpl wshutil.ServerImpl, jwtToken string) error {
 	if err != nil {
 		return fmt.Errorf("error setting up domain socket rpc client: %v", err)
 	}
-	_, err = wshclient.AuthenticateCommand(RpcClient, jwtToken, &wshrpc.RpcOpts{Route: wshutil.ControlRoute})
+	authRtn, err := wshclient.AuthenticateCommand(RpcClient, jwtToken, &wshrpc.RpcOpts{Route: wshutil.ControlRoute})
 	if err != nil {
 		return fmt.Errorf("error authenticating: %v", err)
 	}
+	RpcClientRouteId = authRtn.RouteId
 	blockId := os.Getenv("WAVETERM_BLOCKID")
 	if blockId != "" {
 		peerInfo := fmt.Sprintf("domain:block:%s", blockId)

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

@@ -149,6 +149,7 @@ const BlockFull = memo(({ nodeModel, viewModel }: FullBlockProps) => {
     const focusElemRef = useRef<HTMLInputElement>(null);
     const blockRef = useRef<HTMLDivElement>(null);
     const contentRef = useRef<HTMLDivElement>(null);
+    const pendingFocusRafRef = useRef<number | null>(null);
     const [blockClicked, setBlockClicked] = useState(false);
     const blockView = useAtomValue(waveEnv.getBlockMetaKeyAtom(nodeModel.blockId, "view")) ?? "";
     const isFocused = useAtomValue(nodeModel.isFocused);
@@ -161,6 +162,14 @@ const BlockFull = memo(({ nodeModel, viewModel }: FullBlockProps) => {
     const innerRect = useDebouncedNodeInnerRect(nodeModel);
     const noPadding = useAtomValueSafe(viewModel.noPadding);
 
+    useEffect(() => {
+        return () => {
+            if (pendingFocusRafRef.current != null) {
+                cancelAnimationFrame(pendingFocusRafRef.current);
+            }
+        };
+    }, []);
+
     useLayoutEffect(() => {
         setBlockClicked(isFocused);
     }, [isFocused]);
@@ -226,11 +235,21 @@ const BlockFull = memo(({ nodeModel, viewModel }: FullBlockProps) => {
     );
 
     const setFocusTarget = useCallback(() => {
+        if (pendingFocusRafRef.current != null) {
+            cancelAnimationFrame(pendingFocusRafRef.current);
+            pendingFocusRafRef.current = null;
+        }
         const ok = viewModel?.giveFocus?.();
         if (ok) {
             return;
         }
         focusElemRef.current?.focus({ preventScroll: true });
+        pendingFocusRafRef.current = requestAnimationFrame(() => {
+            pendingFocusRafRef.current = null;
+            if (blockRef.current?.contains(document.activeElement)) {
+                viewModel?.giveFocus?.();
+            }
+        });
     }, [viewModel]);
 
     const focusFromPointerEnter = useCallback(

frontend/app/block/block.tsx

@@ -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 (