refactor: rename agent mode to runner mode

Rename "agent" terminology to "runner" throughout the codebase to better reflect its purpose. Backward compatibility is maintained by mapping the `sling agent` CLI command to `sling runner` and falling back to the `SLING_AGENT_ID` environment variable if `SLING_RUNNER_ID` is not set.

Author: flarco

cmd/sling/sling_cli.go

@@ -579,9 +579,16 @@ func cliInit(done chan struct{}) int {
 		flaggy.AttachSubcommand(cli.Sc, 1)
 	}
 
-	// patch 'sling mcp' into 'sling serve mcp' for backwards compatibility
-	if len(os.Args) >= 2 && os.Args[1] == "mcp" {
+	// patch subcommands for backwards compatibility
+	switch {
+	// 'sling mcp' into 'sling serve mcp'
+	case len(os.Args) >= 2 && os.Args[1] == "mcp":
 		os.Args = append([]string{os.Args[0], "serve"}, os.Args[1:]...)
+	// 'sling agent' into 'sling runner'
+	case len(os.Args) == 2 && os.Args[1] == "agent":
+		os.Args = []string{os.Args[0], "runner"}
+	case len(os.Args) > 2 && os.Args[1] == "agent":
+		os.Args = append([]string{os.Args[0], "runner"}, os.Args[2:]...)
 	}
 
 	flaggy.ShowHelpOnUnexpectedDisable()

core/dbio/api/auth.go

@@ -460,9 +460,9 @@ func (a *AuthenticatorOAuth2) Authenticate(ctx context.Context, state *APIStateA
 		g.Warn("Stored refresh token invalid, falling back to authentication")
 	}
 
-	// if agent mode and not client_credentials, use frontend to auth.
+	// if agent/runner mode and not client_credentials, use frontend to auth.
 	// client_credentials doesn't need browser
-	if env.IsAgentMode && a.Flow != OAuthFlowClientCredentials {
+	if env.IsRunnerMode && a.Flow != OAuthFlowClientCredentials {
 		if storedTok != nil {
 			return g.Error("Stored refresh token is invalid. Need to re-authenticate. Please use the 'Connections' panel in the Platform UI.")
 		}

core/env/env.go

@@ -39,8 +39,8 @@ var (
 	Executable     = ""
 	IsThreadChild  = cast.ToBool(os.Getenv("SLING_THREAD_CHILD"))
 	ExecID         = g.Getenv("SLING_EXEC_ID", NewExecID())
-	AgentID        = os.Getenv("SLING_AGENT_ID")
-	IsAgentMode    = AgentID != ""
+	RunnerID       = g.Getenv("SLING_RUNNER_ID", os.Getenv("SLING_AGENT_ID"))
+	IsRunnerMode   = RunnerID != ""
 
 	// File logging
 	debugLogFile *os.File

core/version.go

@@ -22,7 +22,7 @@ var TelProps = g.M(
 func init() {
 	// dev build version is in format => 1.2.2.dev/2024-08-20
 	parts := strings.Split(Version, "/")
-	if len(parts) != 2 || os.Getenv("SLING_AGENT_ID") != "" || os.Getenv("SLING_AGENT_KEY") != "" {
+	if len(parts) != 2 || os.Getenv("SLING_AGENT_ID") != "" || os.Getenv("SLING_AGENT_KEY") != "" || os.Getenv("SLING_RUNNER_ID") != "" || os.Getenv("SLING_RUNNER_KEY") != "" {
 		return
 	}