Merge pull request #2503 from thiva-k/add-agent-entity

Introduce agent entity and APIs

Author: KaveeshaPiumini

api/agent.yaml

@@ -979,6 +979,7 @@ components:
             - user
             - group
             - app
+            - agent
         display:
           type: string
           readOnly: true

api/group.yaml

@@ -876,6 +876,7 @@ components:
           - user
           - group
           - app
+          - agent
       description: |
         Filter assignments by assignee type. When omitted, assignments of all types are returned.
     includeQueryParam:
@@ -898,14 +899,15 @@ components:
         id:
           type: string
           format: uuid
-          description: "ID of the user, app, or group being assigned"
+          description: "ID of the user, app, agent, or group being assigned"
         type:
           type: string
           enum:
             - user
             - group
             - app
-          description: "Type of entity being assigned (user, app, or group)"
+            - agent
+          description: "Type of entity being assigned (user, app, agent, or group)"
         display:
           type: string
           readOnly: true
@@ -918,14 +920,15 @@ components:
         id:
           type: string
           format: uuid
-          description: "ID of the user, app, or group being assigned"
+          description: "ID of the user, app, agent, or group being assigned"
         type:
           type: string
           enum:
             - user
             - group
             - app
-          description: "Type of entity being assigned (user, app, or group)"
+            - agent
+          description: "Type of entity being assigned (user, app, agent, or group)"
 
     ResourcePermissions:
       type: object

api/role.yaml

@@ -22,6 +22,7 @@ package main
 import (
 	"net/http"
 
+	"github.com/asgardeo/thunder/internal/agent"
 	"github.com/asgardeo/thunder/internal/application"
 	"github.com/asgardeo/thunder/internal/attributecache"
 	"github.com/asgardeo/thunder/internal/authn"
@@ -287,6 +288,10 @@ func registerServices(mux *http.ServeMux) jwt.JWTServiceInterface {
 	}
 	exporters = append(exporters, applicationExporter)
 
+	if _, err := agent.Initialize(mux, entityService, inboundClientService, ouService); err != nil {
+		logger.Fatal("Failed to initialize AgentService", log.Error(err))
+	}
+
 	// Initialize design resolve service for theme and layout resolution
 	designResolveService := resolve.Initialize(mux, themeMgtService, layoutMgtService, applicationService)
 

backend/cmd/server/servicemanager.go

@@ -0,0 +1,32 @@
+/*
+ * Copyright (c) 2026, WSO2 LLC. (https://www.wso2.com).
+ *
+ * WSO2 LLC. licenses this file to you 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 agent
+
+const (
+	agentBasePath = "/agents"
+)
+
+// Field keys stored in the entity SystemAttributes JSON blob.
+const (
+	fieldName         = "name"
+	fieldDescription  = "description"
+	fieldOwner        = "owner"
+	fieldClientID     = "clientId"
+	fieldClientSecret = "clientSecret"
+)