feat(cli): rename hidden daemon entrypoint to "serve"

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: toubatbrian

autocomplete/fish_autocomplete

@@ -186,21 +186,21 @@ complete -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcomma
 complete -x -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from console; and not __fish_seen_subcommand_from help h' -a 'help' -d 'Shows a list of commands or help for one command'
 complete -x -c lk -n '__fish_seen_subcommand_from agent a; and not __fish_seen_subcommand_from init create dockerfile config deploy status update restart rollback logs tail delete destroy versions list secrets update-secrets private-link start dev console daemon simulate help h' -a 'daemon' -d 'Drive a single local agent session in text mode (start/say/stop)'
 complete -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon' -f -l help -s h -d 'show help'
-complete -x -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon; and not __fish_seen_subcommand_from start say stop run help h' -a 'start' -d 'Start a detached agent session daemon'
+complete -x -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon; and not __fish_seen_subcommand_from start say stop serve help h' -a 'start' -d 'Start a detached agent session daemon'
 complete -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon; and __fish_seen_subcommand_from start' -f -l port -r -d 'Fixed loopback port shared by the agent and control connections'
 complete -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon; and __fish_seen_subcommand_from start' -f -l help -s h -d 'show help'
 complete -x -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon; and __fish_seen_subcommand_from start; and not __fish_seen_subcommand_from help h' -a 'help' -d 'Shows a list of commands or help for one command'
-complete -x -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon; and not __fish_seen_subcommand_from start say stop run help h' -a 'say' -d 'Send a text turn to the running session and print the reply'
+complete -x -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon; and not __fish_seen_subcommand_from start say stop serve help h' -a 'say' -d 'Send a text turn to the running session and print the reply'
 complete -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon; and __fish_seen_subcommand_from say' -f -l port -r -d 'Fixed loopback port shared by the agent and control connections'
 complete -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon; and __fish_seen_subcommand_from say' -f -l help -s h -d 'show help'
 complete -x -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon; and __fish_seen_subcommand_from say; and not __fish_seen_subcommand_from help h' -a 'help' -d 'Shows a list of commands or help for one command'
-complete -x -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon; and not __fish_seen_subcommand_from start say stop run help h' -a 'stop' -d 'Stop the running session and its agent'
+complete -x -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon; and not __fish_seen_subcommand_from start say stop serve help h' -a 'stop' -d 'Stop the running session and its agent'
 complete -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon; and __fish_seen_subcommand_from stop' -f -l port -r -d 'Fixed loopback port shared by the agent and control connections'
 complete -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon; and __fish_seen_subcommand_from stop' -f -l help -s h -d 'show help'
 complete -x -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon; and __fish_seen_subcommand_from stop; and not __fish_seen_subcommand_from help h' -a 'help' -d 'Shows a list of commands or help for one command'
-complete -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon; and __fish_seen_subcommand_from run' -f -l help -s h -d 'show help'
-complete -x -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon; and __fish_seen_subcommand_from run; and not __fish_seen_subcommand_from help h' -a 'help' -d 'Shows a list of commands or help for one command'
-complete -x -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon; and not __fish_seen_subcommand_from start say stop run help h' -a 'help' -d 'Shows a list of commands or help for one command'
+complete -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon; and __fish_seen_subcommand_from serve' -f -l help -s h -d 'show help'
+complete -x -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon; and __fish_seen_subcommand_from serve; and not __fish_seen_subcommand_from help h' -a 'help' -d 'Shows a list of commands or help for one command'
+complete -x -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon; and not __fish_seen_subcommand_from start say stop serve help h' -a 'help' -d 'Shows a list of commands or help for one command'
 complete -x -c lk -n '__fish_seen_subcommand_from agent a; and not __fish_seen_subcommand_from init create dockerfile config deploy status update restart rollback logs tail delete destroy versions list secrets update-secrets private-link start dev console daemon simulate help h' -a 'simulate' -d 'Run agent simulations against LiveKit Cloud'
 complete -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from simulate' -f -l num-simulations -s n -r -d 'Number of scenarios to generate'
 complete -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from simulate' -f -l concurrency -r -d 'Max simulations running in parallel (default: server-side limit)'

cmd/lk/session.go

@@ -45,7 +45,7 @@ const (
 	envSessionReadyFile = "LK_SESSION_READY_FILE" // path the daemon writes its status to
 
 	// sessionDaemonSubcommand is the hidden entrypoint `start` re-execs into.
-	sessionDaemonSubcommand = "run"
+	sessionDaemonSubcommand = "serve"
 )
 
 var sessionPortFlag = &cli.IntFlag{
@@ -93,7 +93,7 @@ var agentDaemonCommand = &cli.Command{
 			Hidden: true,
 			Action: func(ctx context.Context, cmd *cli.Command) error {
 				if os.Getenv(envSessionReadyFile) == "" {
-					return fmt.Errorf("`lk agent daemon run` is an internal entrypoint; run `lk agent daemon start <entrypoint>` instead")
+					return fmt.Errorf("`lk agent daemon serve` is an internal entrypoint; run `lk agent daemon start <entrypoint>` instead")
 				}
 				runSessionDaemon()
 				return nil

cmd/lk/session_daemon.go

@@ -31,7 +31,7 @@ import (
 	agent "github.com/livekit/protocol/livekit/agent"
 )
 
-// runSessionDaemon is the entry point for the hidden `lk agent daemon run`
+// runSessionDaemon is the entry point for the hidden `lk agent daemon serve`
 // subcommand that `lk agent daemon start` re-execs. It runs the detached
 // daemon to completion (until the agent exits or `stop` is received).
 func runSessionDaemon() {