From fe5cc55e4ef4d7f4c7c23e1d260937edaff1d308 Mon Sep 17 00:00:00 2001
From: Shreyas Jaganmohan <shreyas.jaganmohan@livekit.io>
Date: Tue, 27 Jan 2026 19:12:02 -0500
Subject: [PATCH 1/3] route agent operations via project routing

---
 cmd/lk/agent.go             |  7 ++++
 cmd/lk/cloud_api_project.go | 67 +++++++++++++++++++++++++++++++++++++
 2 files changed, 74 insertions(+)
 create mode 100644 cmd/lk/cloud_api_project.go

diff --git a/cmd/lk/agent.go b/cmd/lk/agent.go
index 550fb0bd..41a680ca 100644
--- a/cmd/lk/agent.go
+++ b/cmd/lk/agent.go
@@ -389,6 +389,13 @@ func createAgentClientWithOpts(ctx context.Context, cmd *cli.Command, opts ...lo
 		}
 	}
 
+	routing, err := fetchProjectRouting(ctx)
+	if err != nil {
+		logger.Warnw("project routing lookup failed", err)
+	} else if routing != nil && routing.Type == "managed" && routing.AgentsURL != "" {
+		os.Setenv("LK_AGENTS_URL", routing.AgentsURL)
+	}
+
 	agentsClient, err = cloudagents.New(cloudagents.WithProject(project.URL, project.APIKey, project.APISecret))
 	if err != nil {
 		return ctx, err
diff --git a/cmd/lk/cloud_api_project.go b/cmd/lk/cloud_api_project.go
new file mode 100644
index 00000000..09f78679
--- /dev/null
+++ b/cmd/lk/cloud_api_project.go
@@ -0,0 +1,67 @@
+// Copyright 2025 LiveKit, Inc.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package main
+
+import (
+	"context"
+	"encoding/json"
+	"fmt"
+	"net/http"
+	"strings"
+
+	"github.com/livekit/protocol/auth"
+)
+
+type projectRoutingResponse struct {
+	ProjectId string `json:"project_id"`
+	Type      string `json:"type"`
+	AgentsURL string `json:"agents_url"`
+}
+
+func fetchProjectRouting(ctx context.Context) (*projectRoutingResponse, error) {
+	if project == nil {
+		return nil, fmt.Errorf("project is required to fetch routing")
+	}
+
+	token, err := auth.NewAccessToken(project.APIKey, project.APISecret).ToJWT()
+	if err != nil {
+		return nil, err
+	}
+
+	req, err := http.NewRequestWithContext(ctx, http.MethodGet, serverURL+"/cli/project-routing", nil)
+	if err != nil {
+		return nil, err
+	}
+	req.Header.Set("Authorization", "Bearer "+token)
+
+	resp, err := http.DefaultClient.Do(req)
+	if err != nil {
+		return nil, err
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode != http.StatusOK {
+		return nil, fmt.Errorf("project routing request failed: %s", resp.Status)
+	}
+
+	var payload projectRoutingResponse
+	if err := json.NewDecoder(resp.Body).Decode(&payload); err != nil {
+		return nil, err
+	}
+
+	payload.AgentsURL = strings.TrimSpace(payload.AgentsURL)
+	payload.Type = strings.ToLower(strings.TrimSpace(payload.Type))
+	return &payload, nil
+}

From fc7a704d1fe256b39262418765a9f17c870e7149 Mon Sep 17 00:00:00 2001
From: Shreyas Jaganmohan <shreyas.jaganmohan@livekit.io>
Date: Wed, 28 Jan 2026 13:19:14 -0500
Subject: [PATCH 2/3] log project routing requests

---
 cmd/lk/cloud_api_project.go | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/cmd/lk/cloud_api_project.go b/cmd/lk/cloud_api_project.go
index 09f78679..978c4933 100644
--- a/cmd/lk/cloud_api_project.go
+++ b/cmd/lk/cloud_api_project.go
@@ -40,6 +40,8 @@ func fetchProjectRouting(ctx context.Context) (*projectRoutingResponse, error) {
 		return nil, err
 	}
 
+	logger.Infow("requesting project routing", "server_url", serverURL, "project_id", project.ProjectId)
+
 	req, err := http.NewRequestWithContext(ctx, http.MethodGet, serverURL+"/cli/project-routing", nil)
 	if err != nil {
 		return nil, err
@@ -63,5 +65,6 @@ func fetchProjectRouting(ctx context.Context) (*projectRoutingResponse, error) {
 
 	payload.AgentsURL = strings.TrimSpace(payload.AgentsURL)
 	payload.Type = strings.ToLower(strings.TrimSpace(payload.Type))
+	logger.Infow("project routing response", "project_id", payload.ProjectId, "type", payload.Type, "agents_url", payload.AgentsURL)
 	return &payload, nil
 }

From b37dbe0f6056393aef26d1c52f7a06a9c6b9a8c9 Mon Sep 17 00:00:00 2001
From: Shreyas Jaganmohan <shreyas.jaganmohan@livekit.io>
Date: Wed, 28 Jan 2026 13:24:06 -0500
Subject: [PATCH 3/3] fix logger import

---
 cmd/lk/cloud_api_project.go | 1 +
 1 file changed, 1 insertion(+)

diff --git a/cmd/lk/cloud_api_project.go b/cmd/lk/cloud_api_project.go
index 978c4933..eb50c491 100644
--- a/cmd/lk/cloud_api_project.go
+++ b/cmd/lk/cloud_api_project.go
@@ -22,6 +22,7 @@ import (
 	"strings"
 
 	"github.com/livekit/protocol/auth"
+	"github.com/livekit/protocol/logger"
 )
 
 type projectRoutingResponse struct {