feat: add --meta support to wsh tab create

Allows callers to pre-populate tab metadata at creation time via
--meta key=value (repeatable), addressing the meta payload capability
requested in #3285. The new field is optional and additive; existing
call sites continue to work unchanged.

Author: doyled-it

cmd/wsh/cmd/wshcmd-tab.go

@@ -6,6 +6,7 @@ package cmd
 import (
 	"fmt"
 	"os"
+	"strings"
 
 	"github.com/spf13/cobra"
 	"github.com/wavetermdev/waveterm/pkg/wshrpc"
@@ -48,6 +49,7 @@ var (
 	tabCreateFlagWorkspaceId string
 	tabCreateFlagName        string
 	tabCreateFlagNoActivate  bool
+	tabCreateFlagMeta        []string
 	tabRenameFlagTabId       string
 )
 
@@ -60,6 +62,7 @@ func init() {
 	tabCreateCmd.Flags().StringVarP(&tabCreateFlagWorkspaceId, "workspace", "w", "", "workspace id (defaults to the caller's workspace)")
 	tabCreateCmd.Flags().StringVarP(&tabCreateFlagName, "name", "n", "", "tab name (defaults to next auto-generated name)")
 	tabCreateCmd.Flags().BoolVar(&tabCreateFlagNoActivate, "no-activate", false, "do not switch focus to the newly created tab")
+	tabCreateCmd.Flags().StringArrayVar(&tabCreateFlagMeta, "meta", nil, "metadata key=value pairs (repeatable)")
 
 	tabRenameCmd.Flags().StringVarP(&tabRenameFlagTabId, "tab", "t", "", "tab id to rename (defaults to WAVETERM_TABID)")
 }
@@ -69,10 +72,22 @@ func tabCreateRun(cmd *cobra.Command, args []string) (rtnErr error) {
 		sendActivity("tab:create", rtnErr == nil)
 	}()
 
+	var metaMap map[string]string
+	if len(tabCreateFlagMeta) > 0 {
+		metaMap = make(map[string]string, len(tabCreateFlagMeta))
+		for _, kv := range tabCreateFlagMeta {
+			idx := strings.IndexByte(kv, '=')
+			if idx <= 0 {
+				return fmt.Errorf("--meta value %q must be in key=value format with a non-empty key", kv)
+			}
+			metaMap[kv[:idx]] = kv[idx+1:]
+		}
+	}
 	data := wshrpc.CommandCreateTabData{
 		WorkspaceId: tabCreateFlagWorkspaceId,
 		TabName:     tabCreateFlagName,
 		ActivateTab: !tabCreateFlagNoActivate,
+		Meta:        metaMap,
 	}
 	tabId, err := wshclient.CreateTabCommand(RpcClient, data, &wshrpc.RpcOpts{Timeout: 5000})
 	if err != nil {

docs/docs/wsh-reference.mdx

@@ -1132,7 +1132,7 @@ Manage tabs from the command line. Provides `create`, `rename`, and `focus` subc
 Create a new tab in a workspace.
 
 ```sh
-wsh tab create [-w <workspaceid>] [-n <name>] [--no-activate]
+wsh tab create [-w <workspaceid>] [-n <name>] [--no-activate] [--meta key=value ...]
 ```
 
 When `--workspace` is omitted, the tab is created in the workspace of the calling block. The new tab id is printed to stdout, making it easy to capture from scripts.
@@ -1142,6 +1142,7 @@ Flags:
 - `-w, --workspace <id>` - target workspace id (defaults to the caller's workspace)
 - `-n, --name <name>` - tab name (defaults to the next auto-generated name, e.g. `T3`)
 - `--no-activate` - create the tab without switching focus to it
+- `--meta key=value` - set a metadata key on the new tab; may be repeated for multiple keys
 
 Examples:
 
@@ -1154,6 +1155,9 @@ tabid=$(wsh tab create --name "build-output")
 
 # Create a background tab in a specific workspace
 wsh tab create -w 9b1d... -n "logs" --no-activate
+
+# Create a tab with custom metadata
+wsh tab create --name "agent" --meta env=prod --meta owner=ci
 ```
 
 ---

frontend/types/gotypes.d.ts

@@ -320,6 +320,7 @@ declare global {
         workspaceid?: string;
         tabname?: string;
         activatetab?: boolean;
+        meta?: {[key: string]: string};
     };
 
     // wshrpc.CommandDebugTermData

pkg/wshrpc/wshrpc_tab_test.go

@@ -67,6 +67,7 @@ func TestCommandCreateTabDataJSONTags(t *testing.T) {
 		"WorkspaceId": "workspaceid,omitempty",
 		"TabName":     "tabname,omitempty",
 		"ActivateTab": "activatetab,omitempty",
+		"Meta":        "meta,omitempty",
 	}
 	for fieldName, want := range expected {
 		field, ok := rtype.FieldByName(fieldName)
@@ -79,3 +80,19 @@ func TestCommandCreateTabDataJSONTags(t *testing.T) {
 		}
 	}
 }
+
+func TestCommandCreateTabDataMetaField(t *testing.T) {
+	rtype := reflect.TypeOf(CommandCreateTabData{})
+	field, ok := rtype.FieldByName("Meta")
+	if !ok {
+		t.Fatalf("Meta field not found on CommandCreateTabData")
+	}
+	expected := reflect.TypeOf(map[string]string{})
+	if field.Type != expected {
+		t.Fatalf("Meta field type = %v, want %v", field.Type, expected)
+	}
+	got := field.Tag.Get("json")
+	if got != "meta,omitempty" {
+		t.Fatalf("Meta json tag = %q, want %q", got, "meta,omitempty")
+	}
+}

pkg/wshrpc/wshrpctypes.go

@@ -301,9 +301,10 @@ type CommandCreateSubBlockData struct {
 }
 
 type CommandCreateTabData struct {
-	WorkspaceId string `json:"workspaceid,omitempty"`
-	TabName     string `json:"tabname,omitempty"`
-	ActivateTab bool   `json:"activatetab,omitempty"`
+	WorkspaceId string            `json:"workspaceid,omitempty"`
+	TabName     string            `json:"tabname,omitempty"`
+	ActivateTab bool              `json:"activatetab,omitempty"`
+	Meta        map[string]string `json:"meta,omitempty"`
 }
 
 type CommandControllerResyncData struct {

pkg/wshrpc/wshserver/wshserver.go

@@ -215,6 +215,16 @@ func (ws *WshServer) CreateTabCommand(ctx context.Context, data wshrpc.CommandCr
 	if err != nil {
 		return "", fmt.Errorf("error creating tab: %w", err)
 	}
+	if len(data.Meta) > 0 {
+		tabORef := waveobj.ORef{OType: waveobj.OType_Tab, OID: tabId}
+		metaAny := make(waveobj.MetaMapType, len(data.Meta))
+		for k, v := range data.Meta {
+			metaAny[k] = v
+		}
+		if metaErr := wstore.UpdateObjectMeta(ctx, tabORef, metaAny, false); metaErr != nil {
+			return "", fmt.Errorf("error setting tab meta: %w", metaErr)
+		}
+	}
 	updates := waveobj.ContextGetUpdatesRtn(ctx)
 	go func() {
 		defer func() {