feat: support web console opener, deprecate sandbox creation (#821)

* feat: support web console opener, deprecate sandbox creation

* chore(lk): add opener flag for lk room join

* chore(lk): set agent name on env in bootstrap

Author: rektdeckard

cmd/lk/agent.go

@@ -142,14 +142,16 @@ var (
 						}, {
 							sandboxFlag,
 							&cli.BoolFlag{
-								Name:  "no-sandbox",
-								Usage: "If set, will not create a sandbox for the project. ",
-								Value: false,
+								Name:   "no-sandbox",
+								Usage:  "If set, will not create a sandbox for the project. ",
+								Value:  true,
+								Hidden: true,
 							},
 						}},
 					}},
 					Flags: []cli.Flag{
 						regionFlag,
+						installFlag,
 					},
 					ArgsUsage:                 "[AGENT-NAME]",
 					DisableSliceFlagSeparator: true,
@@ -432,6 +434,11 @@ func initAgent(ctx context.Context, cmd *cli.Command) error {
 
 	logger.Debugw("Initializing agent project", "working-dir", workingDir)
 
+	appName = cmd.Args().First()
+	if appName == "" {
+		appName = project.Name
+	}
+
 	// Create sandbox only when not disabled by flag and we don't already have one
 	if !cmd.Bool("no-sandbox") && sandboxID == "" {
 		if err := util.Await("Creating sandbox app...", ctx, func(ctx context.Context) error {
@@ -440,11 +447,6 @@ func initAgent(ctx context.Context, cmd *cli.Command) error {
 				return err
 			}
 
-			appName = cmd.Args().First()
-			if appName == "" {
-				appName = project.Name
-			}
-
 			// TODO: (@rektdeckard) figure out why AccessKeyProvider does not immediately
 			// have access to newly-created API keys, then remove this sleep
 			time.Sleep(4 * time.Second)
@@ -457,8 +459,7 @@ func initAgent(ctx context.Context, cmd *cli.Command) error {
 				serverURL,
 			)
 
-			// We set agent name and sandbox ID in env for use in template tasks
-			os.Setenv("LIVEKIT_AGENT_NAME", appName)
+			// We set sandbox ID in env for use in template tasks
 			os.Setenv("LIVEKIT_SANDBOX_ID", sandboxID)
 
 			return err

cmd/lk/app.go

@@ -61,6 +61,7 @@ var (
 						templateFlag,
 						templateURLFlag,
 						sandboxFlag,
+						installFlag,
 					},
 				},
 				{
@@ -328,7 +329,6 @@ func setupTemplate(ctx context.Context, cmd *cli.Command) error {
 			}).
 			WithTheme(util.Theme))
 	}
-
 	if len(preinstallPrompts) > 0 {
 		group := huh.NewGroup(preinstallPrompts...)
 		if err := huh.NewForm(group).
@@ -338,6 +338,10 @@ func setupTemplate(ctx context.Context, cmd *cli.Command) error {
 		}
 	}
 
+	// Set environment variables for template instantiation
+	os.Setenv("LIVEKIT_AGENT_NAME", appName)
+	os.Setenv("LIVEKIT_PROJECT_ID", project.ProjectId)
+
 	fmt.Println("Cloning template...")
 	if err := cloneTemplate(ctx, cmd, templateURL, appName); err != nil {
 		return err
@@ -374,10 +378,20 @@ func setupTemplate(ctx context.Context, cmd *cli.Command) error {
 
 	bootstrap.WriteDotEnv(appName, envOutputFile, env)
 
+	if !cmd.IsSet("install") && !SkipPrompts(cmd) {
+		if err := huh.NewConfirm().
+			Title("Install dependencies?").
+			Value(&install).
+			Inline(true).
+			WithTheme(util.Theme).
+			Run(); err != nil {
+			return err
+		}
+	}
 	if install {
 		fmt.Println("Installing template...")
 		if err := doInstall(ctx, bootstrap.TaskInstall, appName, verbose); err != nil {
-			return err
+			fmt.Fprintf(os.Stderr, "Warning: installation failed: %v\n", err)
 		}
 	}
 	if err := doPostCreate(ctx, cmd, appName, verbose); err != nil {

cmd/lk/room.go

@@ -1071,6 +1071,13 @@ func joinRoom(ctx context.Context, cmd *cli.Command) error {
 				})
 			token, _ := at.ToJWT()
 			_ = util.OpenInMeet(project.URL, token)
+		case string(util.OpenTargetConsole):
+			_ = util.OpenInConsole(dashboardURL, project.ProjectId, &util.ConsoleURLParams{
+				Identity:  participantIdentity,
+				RoomName:  roomName,
+				Hidden:    true,
+				AutoStart: true,
+			})
 		}
 	}
 

cmd/lk/token.go

@@ -72,7 +72,6 @@ var (
 						optional(roomFlag),
 						optional(identityFlag),
 						openFlag,
-
 						&cli.BoolFlag{
 							Name:  "create",
 							Usage: usageCreate,
@@ -158,7 +157,6 @@ var (
 			Action: createToken,
 			Flags: []cli.Flag{
 				optional(roomFlag),
-
 				&cli.BoolFlag{
 					Name:  "create",
 					Usage: usageCreate,
@@ -416,9 +414,10 @@ func createToken(ctx context.Context, c *cli.Command) error {
 		at.SetInferenceGrant(&auth.InferenceGrant{Perform: true})
 	}
 
+	agent := c.String("agent")
+	jobMetadata := c.String("job-metadata")
 	if grant.RoomJoin {
-		if agent := c.String("agent"); agent != "" {
-			jobMetadata := c.String("job-metadata")
+		if agent != "" {
 			at.SetRoomConfig(&livekit.RoomConfiguration{
 				Agents: []*livekit.RoomAgentDispatch{
 					{
@@ -472,7 +471,22 @@ func createToken(ctx context.Context, c *cli.Command) error {
 	if c.IsSet("open") {
 		switch c.String("open") {
 		case string(util.OpenTargetMeet):
-			_ = util.OpenInMeet(project.URL, token)
+			if err := util.OpenInMeet(project.URL, token); err != nil {
+				return err
+			}
+		case string(util.OpenTargetConsole):
+			if err := util.OpenInConsole(dashboardURL, project.ProjectId, &util.ConsoleURLParams{
+				AgentName:   agent,
+				JobMetadata: jobMetadata,
+				Identity:    participant,
+				RoomName:    room,
+				Metadata:    metadata,
+				Attributes:  participantAttributes,
+				Hidden:      false,
+				AutoStart:   true,
+			}); err != nil {
+				return err
+			}
 		}
 	}
 

cmd/lk/utils.go

@@ -85,6 +85,11 @@ var (
 		Name:        "sandbox",
 		Usage:       "`NAME` of the sandbox, see your cloud dashboard",
 		Destination: &sandboxID,
+		Hidden:      true,
+	}
+	installFlag = &cli.BoolFlag{
+		Name:  "install",
+		Usage: "Run installation after creating the application",
 	}
 
 	openFlag    = util.OpenFlag