From d59c8d53c67c3429e8c9991f5fc6b48a2c76f315 Mon Sep 17 00:00:00 2001
From: Arjun <6592213+arkml@users.noreply.github.com>
Date: Wed, 4 Feb 2026 16:34:22 +0530
Subject: [PATCH] add agent description

---
 .../skills/background-agents/skill.ts         | 19 +++++++++++++++++--
 apps/x/packages/shared/src/agent-schedule.ts  |  1 +
 2 files changed, 18 insertions(+), 2 deletions(-)

diff --git a/apps/x/packages/core/src/application/assistant/skills/background-agents/skill.ts b/apps/x/packages/core/src/application/assistant/skills/background-agents/skill.ts
index 23c1823f..ae89cd8b 100644
--- a/apps/x/packages/core/src/application/assistant/skills/background-agents/skill.ts
+++ b/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"
     }
   }
 }
diff --git a/apps/x/packages/shared/src/agent-schedule.ts b/apps/x/packages/shared/src/agent-schedule.ts
index 6abc821d..62184083 100644
--- a/apps/x/packages/shared/src/agent-schedule.ts
+++ b/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({