feat(backend): add satellite_url field to team satellites endpoint

Add satellite_url to GET /api/teams/:teamId/satellites response to expose
publicly accessible satellite URLs for both global and team-specific satellites.

Author: Lasim

services/backend/api-spec.json

@@ -13528,6 +13528,10 @@
                                 ],
                                 "description": "Team ID (null for global satellites)"
                               },
+                              "satellite_url": {
+                                "type": "string",
+                                "description": "Publicly accessible satellite URL"
+                              },
                               "last_heartbeat": {
                                 "type": [
                                   "null",
@@ -13542,7 +13546,8 @@
                               "satellite_type",
                               "status",
                               "capabilities",
-                              "team_id"
+                              "team_id",
+                              "satellite_url"
                             ]
                           },
                           "description": "Array of available satellites (global and team-specific)"
@@ -34546,6 +34551,10 @@
                     ],
                     "description": "Satellite capabilities"
                   },
+                  "satellite_url": {
+                    "type": "string",
+                    "description": "Publicly accessible satellite URL (optional - auto-detected if not provided)"
+                  },
                   "system_info": {
                     "type": "object",
                     "properties": {
@@ -35319,6 +35328,10 @@
                   "version": {
                     "type": "string",
                     "description": "Satellite software version"
+                  },
+                  "satellite_url": {
+                    "type": "string",
+                    "description": "Publicly accessible satellite URL (optional - only sent on first heartbeat after startup)"
                   }
                 },
                 "required": [

services/backend/api-spec.yaml

@@ -9443,6 +9443,9 @@ paths:
                                 - "null"
                                 - string
                               description: Team ID (null for global satellites)
+                            satellite_url:
+                              type: string
+                              description: Publicly accessible satellite URL
                             last_heartbeat:
                               type:
                                 - "null"
@@ -9455,6 +9458,7 @@ paths:
                             - status
                             - capabilities
                             - team_id
+                            - satellite_url
                         description: Array of available satellites (global and team-specific)
                       total_count:
                         type: number
@@ -24459,6 +24463,10 @@ paths:
                     - http
                     - sse
                   description: Satellite capabilities
+                satellite_url:
+                  type: string
+                  description: Publicly accessible satellite URL (optional - auto-detected if not
+                    provided)
                 system_info:
                   type: object
                   properties:
@@ -24996,6 +25004,10 @@ paths:
                 version:
                   type: string
                   description: Satellite software version
+                satellite_url:
+                  type: string
+                  description: Publicly accessible satellite URL (optional - only sent on first
+                    heartbeat after startup)
               required:
                 - status
                 - system_metrics

services/backend/src/routes/teams/satellites.ts

@@ -48,12 +48,16 @@ const SATELLITE_SCHEMA = {
       type: ['string', 'null'],
       description: 'Team ID (null for global satellites)'
     },
+    satellite_url: {
+      type: 'string',
+      description: 'Publicly accessible satellite URL'
+    },
     last_heartbeat: {
       type: ['string', 'null'],
       description: 'ISO 8601 timestamp of last communication'
     }
   },
-  required: ['id', 'name', 'satellite_type', 'status', 'capabilities', 'team_id']
+  required: ['id', 'name', 'satellite_type', 'status', 'capabilities', 'team_id', 'satellite_url']
 } as const;
 
 const SATELLITES_SUCCESS_RESPONSE_SCHEMA = {
@@ -111,6 +115,7 @@ interface Satellite {
   status: 'active';
   capabilities: string[];
   team_id: string | null;
+  satellite_url: string;
   last_heartbeat: string | null;
 }
 
@@ -136,6 +141,7 @@ interface SatelliteRecord {
   status: 'active' | 'inactive' | 'maintenance' | 'error';
   capabilities: string;
   team_id: string | null;
+  satellite_url: string;
   last_heartbeat: Date | null;
 }
 
@@ -201,6 +207,7 @@ export default async function getTeamSatellitesRoute(server: FastifyInstance) {
           status: satellites.status,
           capabilities: satellites.capabilities,
           team_id: satellites.team_id,
+          satellite_url: satellites.satellite_url,
           last_heartbeat: satellites.last_heartbeat
         })
         .from(satellites)
@@ -244,6 +251,7 @@ export default async function getTeamSatellitesRoute(server: FastifyInstance) {
           status: 'active' as const,
           capabilities: capabilitiesArray,
           team_id: sat.team_id,
+          satellite_url: sat.satellite_url,
           last_heartbeat: sat.last_heartbeat ? sat.last_heartbeat.toISOString() : null
         };
       });