add agent description

apps/x/packages/core/src/application/assistant/skills/background-agents/skill.ts

@@ -98,6 +98,18 @@ You can specify a ` + "`startingMessage`" + ` that gets sent to the agent when i
 }
 ` + "```" + `
 
+### Description
+
+You can add a ` + "`description`" + ` field to describe what the agent does. This is displayed in the UI.
+
+` + "```json" + `
+{
+  "schedule": { "type": "cron", "expression": "0 8 * * *" },
+  "enabled": true,
+  "description": "Summarizes emails and calendar events every morning"
+}
+` + "```" + `
+
 ### Complete Schedule Example
 
 ` + "```json" + `
@@ -109,6 +121,7 @@ You can specify a ` + "`startingMessage`" + ` that gets sent to the agent when i
         "expression": "0 8 * * *"
       },
       "enabled": true,
+      "description": "Daily email and calendar summary",
       "startingMessage": "Summarize my emails and calendar for today"
     },
     "morning_briefing": {
@@ -118,14 +131,16 @@ You can specify a ` + "`startingMessage`" + ` that gets sent to the agent when i
         "startTime": "07:00",
         "endTime": "09:00"
       },
-      "enabled": true
+      "enabled": true,
+      "description": "Morning news and updates briefing"
     },
     "one_time_setup": {
       "schedule": {
         "type": "once",
         "runAt": "2024-12-01T12:00:00"
       },
-      "enabled": true
+      "enabled": true,
+      "description": "One-time data migration task"
     }
   }
 }

apps/x/packages/shared/src/agent-schedule.ts

@@ -36,6 +36,7 @@ export const AgentScheduleEntry = z.object({
     schedule: ScheduleDefinition,
     enabled: z.boolean().optional().default(true),
     startingMessage: z.string().optional(), // Message sent to agent when run starts (defaults to "go")
+    description: z.string().optional(), // Brief description of what the agent does (for UI display)
 });
 
 export const AgentScheduleConfig = z.object({