@desplega.ai/agent-swarm 1.55.0 → 1.56.2

package/src/types.ts

@@ -175,6 +175,8 @@ export const AgentSchema = z.object({
   setupScript: z.string().max(65536).optional(),
   // Tools/environment reference: Operational knowledge (synced to /workspace/TOOLS.md)
   toolsMd: z.string().max(65536).optional(),
+  // Heartbeat checklist: Standing orders checked periodically (synced to /workspace/HEARTBEAT.md)
+  heartbeatMd: z.string().max(65536).optional(),
 
   // Concurrency limit (defaults to 1 for backwards compatibility)
   maxTasks: z.number().int().min(1).max(20).optional(),
@@ -218,6 +220,7 @@ export const VersionableFieldSchema = z.enum([
   "toolsMd",
   "claudeMd",
   "setupScript",
+  "heartbeatMd",
 ]);
 
 export const ContextVersionSchema = z.object({

package/templates/official/lead/CLAUDE.md

@@ -18,6 +18,9 @@ of each session and edit them as you grow:
 
 - **`/workspace/SOUL.md`** — Your persona, values, and behavioral directives
 - **`/workspace/IDENTITY.md`** — Your expertise, working style, and quirks
+- **`/workspace/HEARTBEAT.md`** — Your periodic checklist. The system reads this every 30 minutes
+  and creates a task for you with system status + your standing orders. Edit to add/remove checks.
+  Leave empty (or all comments) to disable periodic checks at zero cost.
 
 These files are injected into your system prompt AND available as editable files.
 When you edit them, changes sync to the database automatically. They persist across sessions.

package/templates/official/lead/HEARTBEAT.md

@@ -0,0 +1,12 @@
+# Heartbeat Checklist
+
+<!-- Keep this section empty to skip periodic heartbeat checks (no LLM cost). -->
+<!-- Add actionable items below when you want periodic checks. -->
+<!-- The lead agent reads this every 30 minutes and acts on any items found. -->
+
+<!-- Examples (uncomment to activate):
+- Check Slack for unaddressed requests older than 1 hour
+- Review active tasks for any that seem stuck or blocked
+- If idle workers exist and unassigned tasks are available, investigate why auto-assignment didn't handle them
+- Post a daily summary to #agent-status at 5pm
+-->

package/templates/official/lead/config.json

@@ -17,6 +17,7 @@
   "files": {
     "claudeMd": "CLAUDE.md",
     "soulMd": "SOUL.md",
-    "identityMd": "IDENTITY.md"
+    "identityMd": "IDENTITY.md",
+    "heartbeatMd": "HEARTBEAT.md"
   }
 }

package/templates/schema.ts

@@ -20,6 +20,7 @@ export interface TemplateConfig {
     identityMd: string | null;
     toolsMd: string | null;
     setupScript: string | null;
+    heartbeatMd: string | null;
   };
 }
 
@@ -31,5 +32,6 @@ export interface TemplateResponse {
     identityMd: string;
     toolsMd: string;
     setupScript: string;
+    heartbeatMd: string;
   };
 }