🐛 fix(ui): remove remaining background agent references from autonomous hub

Fixes API error on autonomous page load — stale references to deleted
background-agent types in templates, preview cards, AI chat creator,
and app.test.ts mock were causing type errors and 404 API calls.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: ersinkoc

packages/gateway/src/app.test.ts

@@ -85,7 +85,6 @@ vi.mock('./routes/index.js', async (importOriginal) => {
     cliToolsRoutes: createMockRoutes(),
     cliChatRoutes: createMockRoutes(),
     securityRoutes: createMockRoutes(),
-    backgroundAgentsRoutes: createMockRoutes(),
     subagentRoutes: createMockRoutes(),
     bridgeRoutes: createMockRoutes(),
     orchestraRoutes: createMockRoutes(),

packages/ui/src/pages/autonomous/components/AIChatCreator.tsx

@@ -81,22 +81,13 @@ function extractAgentConfig(content: string): ProposedAgentConfig | null {
       return null;
     }
 
-    // Validate kind
-    const kind = parsed.kind === 'background' ? 'background' : 'soul';
+    // All agents are soul agents now (background agents deprecated in favor of Claw)
+    const kind = 'soul' as const;
 
     // Validate autonomy level (1-4)
     let autonomyLevel = typeof parsed.autonomyLevel === 'number' ? parsed.autonomyLevel : 2;
     autonomyLevel = Math.max(1, Math.min(4, autonomyLevel));
 
-    // Validate background agent fields
-    let bgMode: 'continuous' | 'interval' | 'event' | undefined;
-    let bgIntervalMs: number | undefined;
-    if (kind === 'background') {
-      const validModes = ['continuous', 'interval', 'event'];
-      bgMode = validModes.includes(parsed.bgMode) ? parsed.bgMode : 'interval';
-      bgIntervalMs = typeof parsed.bgIntervalMs === 'number' ? parsed.bgIntervalMs : 300000; // 5 min default
-    }
-
     // Validate provider/model (use defaults if missing)
     const provider = parsed.provider || 'openai';
     const model = parsed.model || 'gpt-4o';
@@ -114,8 +105,6 @@ function extractAgentConfig(content: string): ProposedAgentConfig | null {
       heartbeatEnabled: kind === 'soul' ? parsed.heartbeatEnabled !== false : false,
       autonomyLevel,
       estimatedCost: parsed.estimatedCost || '~$0.50/day',
-      bgMode,
-      bgIntervalMs,
       provider,
       model,
     };
@@ -193,25 +182,21 @@ When you have enough information, output a COMPLETE JSON configuration block in
 ## Field Requirements
 
 ### Required Fields (MUST include):
-- **kind**: "soul" for scheduled agents, "background" for workers
+- **kind**: "soul" (always use "soul")
 - **name**: Short, memorable, unique name (2-4 words max)
 - **emoji**: Single relevant emoji representing the agent
 - **role**: Professional role title (e.g., "Research Analyst", "Security Monitor")
 - **personality**: 1-2 sentences describing communication style, tone, approach
 - **mission**: 2-3 sentences describing what the agent does, when, and how
 - **tools**: Array of tool names (use "core." prefix for built-in tools)
 - **skills**: Array of skill IDs from the INSTALLED SKILLS list below (use exact IDs)
-- **heartbeatInterval**: Valid cron expression for soul agents (omit for background/event agents)
+- **heartbeatInterval**: Valid cron expression for soul agents
 - **heartbeatEnabled**: boolean (true for soul agents with schedules)
 - **autonomyLevel**: 1-4 (1=ask permission, 2=notify, 3=log only, 4=full autonomy)
 - **estimatedCost**: Daily cost estimate (e.g., "~$0.50/day", "~$2-5/day")
 - **provider**: AI provider ID (use "${defaults.provider}")
 - **model**: AI model ID (use "${defaults.model}")
 
-### Background Agent Fields (when kind="background"):
-- **bgMode**: "continuous" | "interval" | "event"
-- **bgIntervalMs**: number (milliseconds between runs, for interval mode)
-
 ### Tool Selection Guidelines:
 Commonly useful tools:
 - "core.search_web" - for web research
@@ -501,12 +486,6 @@ export function AIChatCreator({ onCreated, onClose }: Props) {
     if (!config.mission?.trim()) errors.push('Mission is required');
     if (!config.role?.trim()) errors.push('Role is required');
     if (!config.personality?.trim()) errors.push('Personality is required');
-    if (config.kind === 'background') {
-      const validModes = ['continuous', 'interval', 'event'];
-      if (!validModes.includes(config.bgMode || '')) {
-        errors.push('Background agent mode must be: continuous, interval, or event');
-      }
-    }
     return errors;
   };
 

packages/ui/src/pages/autonomous/components/AgentPreviewCard.tsx

@@ -7,7 +7,7 @@ import { Bot, Repeat, Cpu, Puzzle } from '../../../components/icons';
 import { cronToHuman } from '../helpers';
 
 export interface ProposedAgentConfig {
-  kind: 'soul' | 'background';
+  kind: 'soul';
   name: string;
   emoji: string;
   role: string;
@@ -19,8 +19,6 @@ export interface ProposedAgentConfig {
   heartbeatEnabled?: boolean;
   autonomyLevel?: number;
   estimatedCost?: string;
-  bgMode?: 'continuous' | 'interval' | 'event';
-  bgIntervalMs?: number;
   provider?: string;
   model?: string;
 }
@@ -33,16 +31,9 @@ interface Props {
 }
 
 export function AgentPreviewCard({ config, onConfirm, confirmLabel, isCreating }: Props) {
-  const schedule =
-    config.kind === 'soul' && config.heartbeatInterval
-      ? cronToHuman(config.heartbeatInterval)
-      : config.kind === 'background' && config.bgMode === 'interval' && config.bgIntervalMs
-        ? `Every ${Math.round(config.bgIntervalMs / 60_000)} min`
-        : config.kind === 'background' && config.bgMode === 'event'
-          ? 'On demand'
-          : config.kind === 'background' && config.bgMode === 'continuous'
-            ? 'Continuous'
-            : null;
+  const schedule = config.heartbeatInterval
+    ? cronToHuman(config.heartbeatInterval)
+    : null;
 
   return (
     <div className="border border-primary/30 bg-primary/5 rounded-xl p-4 space-y-3">
@@ -55,13 +46,9 @@ export function AgentPreviewCard({ config, onConfirm, confirmLabel, isCreating }
               {config.name}
             </h4>
             <span
-              className={`text-xs px-2 py-0.5 rounded-full shrink-0 ${
-                config.kind === 'soul'
-                  ? 'bg-primary/10 text-primary'
-                  : 'bg-text-muted/10 text-text-muted dark:text-dark-text-muted'
-              }`}
+              className="text-xs px-2 py-0.5 rounded-full shrink-0 bg-primary/10 text-primary"
             >
-              {config.kind === 'soul' ? 'Soul Agent' : 'Background'}
+              Soul Agent
             </span>
           </div>
           <p className="text-xs text-text-muted dark:text-dark-text-muted">{config.role}</p>

packages/ui/src/pages/autonomous/components/HelpPanel.tsx

@@ -65,12 +65,12 @@ export function HelpPanel({ onClose }: Props) {
               <div className="flex items-center gap-2 mb-2">
                 <Zap className="w-4 h-4 text-text-muted dark:text-dark-text-muted" />
                 <h4 className="font-medium text-text-primary dark:text-dark-text-primary">
-                  Background Agents
+                  Claw Agents
                 </h4>
               </div>
               <p className="text-xs text-text-muted dark:text-dark-text-muted">
-                Lightweight workers that run continuously, on intervals, or on demand. Great for
-                monitoring, data processing, or event-driven tasks.
+                Autonomous agents with workspace, directives, and audit trail. Run continuously,
+                on intervals, event-driven, or single-shot. Use Fleet for multi-worker coordination.
               </p>
             </div>
           </section>

packages/ui/src/pages/autonomous/components/TemplateCatalog.tsx

@@ -111,14 +111,8 @@ export function TemplateCatalog({ onSelect, crewTemplates, onDeployCrew }: Props
                       <h4 className="font-medium text-sm text-text-primary dark:text-dark-text-primary truncate">
                         {template.name}
                       </h4>
-                      <span
-                        className={`text-xs px-1.5 py-0.5 rounded-full ${
-                          template.kind === 'soul'
-                            ? 'bg-primary/10 text-primary'
-                            : 'bg-text-muted/10 text-text-muted dark:text-dark-text-muted'
-                        }`}
-                      >
-                        {template.kind === 'soul' ? 'Soul' : 'Background'}
+                      <span className="text-xs px-1.5 py-0.5 rounded-full bg-primary/10 text-primary">
+                        Soul
                       </span>
                     </div>
                   </div>
@@ -134,11 +128,7 @@ export function TemplateCatalog({ onSelect, crewTemplates, onDeployCrew }: Props
                   <span>
                     {template.heartbeatInterval
                       ? cronToHuman(template.heartbeatInterval)
-                      : template.bgMode === 'event'
-                        ? 'On demand'
-                        : template.bgMode === 'interval' && template.bgIntervalMs
-                          ? `Every ${Math.round(template.bgIntervalMs / 60_000)}m`
-                          : 'Continuous'}
+                      : 'On demand'}
                   </span>
                   <span>{template.estimatedCost}</span>
                 </div>

packages/ui/src/pages/autonomous/data/agent-templates.ts

@@ -30,9 +30,7 @@ export interface AgentTemplate {
   heartbeatInterval: string;
   autonomyLevel: number;
   estimatedCost: string;
-  kind: 'soul' | 'background';
-  bgMode?: 'continuous' | 'interval' | 'event';
-  bgIntervalMs?: number;
+  kind: 'soul';
   tags: string[];
   /** Default provider for this agent */
   provider?: string;
@@ -210,8 +208,7 @@ export const AGENT_TEMPLATES: AgentTemplate[] = [
     heartbeatInterval: '',
     autonomyLevel: 2,
     estimatedCost: '$0.10-$0.50/use',
-    kind: 'background',
-    bgMode: 'event',
+    kind: 'soul',
     tags: ['research', 'papers', 'academic'],
   },
   {
@@ -285,8 +282,7 @@ export const AGENT_TEMPLATES: AgentTemplate[] = [
     heartbeatInterval: '',
     autonomyLevel: 1,
     estimatedCost: '$0.10-$0.30/use',
-    kind: 'background',
-    bgMode: 'event',
+    kind: 'soul',
     tags: ['blog', 'writing', 'content'],
   },
   {
@@ -336,8 +332,7 @@ export const AGENT_TEMPLATES: AgentTemplate[] = [
     heartbeatInterval: '',
     autonomyLevel: 2,
     estimatedCost: '$0.10-$0.50/review',
-    kind: 'background',
-    bgMode: 'event',
+    kind: 'soul',
     tags: ['code-review', 'github', 'quality'],
   },
   {
@@ -385,8 +380,7 @@ export const AGENT_TEMPLATES: AgentTemplate[] = [
     heartbeatInterval: '',
     autonomyLevel: 2,
     estimatedCost: '$0.05-$0.20/bug',
-    kind: 'background',
-    bgMode: 'event',
+    kind: 'soul',
     tags: ['bugs', 'triage', 'quality'],
   },
 
@@ -412,8 +406,7 @@ export const AGENT_TEMPLATES: AgentTemplate[] = [
     heartbeatInterval: '',
     autonomyLevel: 1,
     estimatedCost: '$0.10-$0.30/meeting',
-    kind: 'background',
-    bgMode: 'event',
+    kind: 'soul',
     tags: ['meetings', 'notes', 'action-items'],
   },
   {
@@ -463,9 +456,7 @@ export const AGENT_TEMPLATES: AgentTemplate[] = [
     heartbeatInterval: '',
     autonomyLevel: 3,
     estimatedCost: '$1-$5/day',
-    kind: 'background',
-    bgMode: 'interval',
-    bgIntervalMs: 900_000,
+    kind: 'soul',
     tags: ['uptime', 'monitoring', 'alerts'],
   },
   {
@@ -554,22 +545,3 @@ export function templateToSoulPayload(template: AgentTemplate, defaults: { provi
   };
 }
 
-export function templateToBgPayload(template: AgentTemplate, defaults: { provider: string; model: string }): Record<string, unknown> {
-  return {
-    name: template.name,
-    mission: template.mission,
-    mode: template.bgMode || 'interval',
-    allowed_tools: template.tools || [],
-    interval_ms: template.bgIntervalMs || 300_000,
-    auto_start: false,
-    limits: {
-      maxTurnsPerCycle: 10,
-      maxToolCallsPerCycle: 50,
-      maxCyclesPerHour: 60,
-      cycleTimeoutMs: 120_000,
-    },
-    provider: template.provider || defaults.provider,
-    model: template.model || defaults.model,
-    skills: template.skills || [],
-  };
-}