@swarmclawai/swarmclaw 1.4.8 → 1.5.0

package/src/components/home/home-launchpad.tsx

@@ -0,0 +1,135 @@
+'use client'
+
+import { AgentAvatar } from '@/components/agents/agent-avatar'
+import { LaunchActionCard } from '@/components/shared/launch-action-card'
+import type { Agent } from '@/types'
+
+function SnapshotItem({ label, value, hint }: { label: string; value: string; hint: string }) {
+  return (
+    <div className="rounded-[14px] border border-white/[0.06] bg-white/[0.03] px-4 py-3">
+      <div className="text-[11px] font-700 uppercase tracking-[0.12em] text-text-3/55">{label}</div>
+      <div className="mt-2 text-[24px] font-display font-700 tracking-[-0.03em] text-text">{value}</div>
+      <div className="mt-1 text-[12px] leading-relaxed text-text-3/68">{hint}</div>
+    </div>
+  )
+}
+
+type Props = {
+  firstAgent: Agent | null
+  agentCount: number
+  sessionCount: number
+  taskCount: number
+  scheduleCount: number
+  connectorCount: number
+  todayCost: number
+  onOpenFirstAgent: () => void
+  onOpenProtocols: () => void
+  onOpenBuilder: () => void
+  onOpenConnectors: () => void
+  onOpenUsage: () => void
+}
+
+export function HomeLaunchpad({
+  firstAgent,
+  agentCount,
+  sessionCount,
+  taskCount,
+  scheduleCount,
+  connectorCount,
+  todayCost,
+  onOpenFirstAgent,
+  onOpenProtocols,
+  onOpenBuilder,
+  onOpenConnectors,
+  onOpenUsage,
+}: Props) {
+  return (
+    <div className="max-w-[980px] mx-auto px-6 py-10">
+      <div className="rounded-[24px] border border-white/[0.06] bg-gradient-to-br from-white/[0.05] via-white/[0.02] to-transparent p-6">
+        <div className="inline-flex rounded-full border border-white/[0.08] bg-white/[0.03] px-3 py-1 text-[11px] font-700 uppercase tracking-[0.16em] text-text-3/70">
+          Launchpad
+        </div>
+        <div className="mt-4 flex flex-col gap-4 lg:flex-row lg:items-start lg:justify-between">
+          <div className="max-w-[620px]">
+            <h1 className="font-display text-[34px] font-700 tracking-[-0.03em] text-text">
+              Start with the result you want, not the control plane.
+            </h1>
+            <p className="mt-3 text-[15px] leading-relaxed text-text-3/72">
+              SwarmClaw already has the building blocks. Use this workspace to start a live agent chat, launch a bounded session, wire a connector, or move straight into reusable workflows.
+            </p>
+          </div>
+          <div className="rounded-[18px] border border-white/[0.06] bg-white/[0.03] p-4 min-w-[240px]">
+            <div className="text-[11px] font-700 uppercase tracking-[0.12em] text-text-3/55">Workspace Anchor</div>
+            <div className="mt-3 flex items-center gap-3">
+              {firstAgent ? (
+                <>
+                  <AgentAvatar
+                    seed={firstAgent.avatarSeed}
+                    avatarUrl={firstAgent.avatarUrl}
+                    name={firstAgent.name}
+                    size={44}
+                  />
+                  <div>
+                    <div className="text-[14px] font-display font-700 text-text">{firstAgent.name}</div>
+                    <div className="text-[12px] text-text-3/70">
+                      {firstAgent.model ? firstAgent.model.split('/').pop()?.split(':')[0] : firstAgent.provider}
+                    </div>
+                  </div>
+                </>
+              ) : (
+                <div className="text-[13px] leading-relaxed text-text-3/72">
+                  No agents yet. Start by creating one or use the workflow tools first.
+                </div>
+              )}
+            </div>
+          </div>
+        </div>
+      </div>
+
+      <div className="mt-6 grid gap-3 md:grid-cols-2 xl:grid-cols-3">
+        <LaunchActionCard
+          title={firstAgent ? 'Open First Agent Chat' : 'Open Agents'}
+          description={firstAgent
+            ? `Jump into ${firstAgent.name} and start using the workspace immediately.`
+            : 'Open the agents workspace to create or tune the first specialist agent.'}
+          actionLabel={firstAgent ? 'Open Chat' : 'Open Agents'}
+          onClick={onOpenFirstAgent}
+          tone="primary"
+        />
+        <LaunchActionCard
+          title="Start Structured Session"
+          description="Open bounded collaboration runs for planning, review, decision-making, or focused multi-agent work."
+          actionLabel="Open Protocols"
+          onClick={onOpenProtocols}
+        />
+        <LaunchActionCard
+          title="Open Workflow Builder"
+          description="Move straight into reusable orchestration graphs if you want a durable workflow instead of a one-off run."
+          actionLabel="Open Builder"
+          onClick={onOpenBuilder}
+        />
+        <LaunchActionCard
+          title="Connect a Platform"
+          description="Bridge agents into chat surfaces like Discord, Slack, Telegram, and WhatsApp."
+          actionLabel="Open Connectors"
+          onClick={onOpenConnectors}
+        />
+        <LaunchActionCard
+          title="Review Usage"
+          description="Check cost, provider health, and activity so the workspace stays observable from the start."
+          actionLabel="Open Usage"
+          onClick={onOpenUsage}
+        />
+      </div>
+
+      <div className="mt-8 grid gap-3 md:grid-cols-2 xl:grid-cols-3">
+        <SnapshotItem label="Agents" value={String(agentCount)} hint="Configured specialists available in this workspace." />
+        <SnapshotItem label="Chats" value={String(sessionCount)} hint="Durable conversations already created." />
+        <SnapshotItem label="Tasks" value={String(taskCount)} hint="Queued or archived work items in the board." />
+        <SnapshotItem label="Schedules" value={String(scheduleCount)} hint="Recurring or delayed automations ready to run." />
+        <SnapshotItem label="Connectors" value={String(connectorCount)} hint="Platform bridges currently configured." />
+        <SnapshotItem label="Today's Cost" value={`$${todayCost.toFixed(2)}`} hint="Estimated usage cost for today across providers." />
+      </div>
+    </div>
+  )
+}

package/src/components/protocols/builder/template-gallery.tsx

@@ -1,31 +1,38 @@
 import { useProtocolTemplatesQuery } from '@/features/protocols/queries'
 import { useRouter } from 'next/navigation'
-import { cn } from '@/lib/utils'
 import type { ProtocolTemplate } from '@/types'
 
-export function TemplateGallery() {
-  const { data: templates } = useProtocolTemplatesQuery()
+type Props = {
+  templates?: ProtocolTemplate[]
+}
+
+export function TemplateGallery({ templates: providedTemplates }: Props) {
+  const { data: queriedTemplates } = useProtocolTemplatesQuery({ enabled: !providedTemplates })
   const router = useRouter()
+  const templates = providedTemplates ?? queriedTemplates ?? []
 
-  const builtInTemplates = templates?.filter((t) => t.builtIn) || []
-  const customTemplates = templates?.filter((t) => !t.builtIn) || []
+  const builtInTemplates = templates.filter((t) => t.builtIn)
+  const customTemplates = templates.filter((t) => !t.builtIn)
 
   const renderCard = (template: ProtocolTemplate) => (
     <button
       key={template.id}
       onClick={() => router.push(`/protocols/builder/${template.id}`)}
-      className={cn(
-        'rounded-lg border bg-card p-4 text-left transition-shadow hover:shadow-md',
-      )}
+      className="rounded-[16px] border border-white/[0.06] bg-white/[0.03] p-4 text-left transition-all hover:border-accent-bright/20 hover:bg-white/[0.05] cursor-pointer"
     >
-      <div className="text-sm font-semibold">{template.name}</div>
-      <div className="mt-1 text-xs text-muted-foreground line-clamp-2">
+      <div className="flex items-start justify-between gap-3">
+        <div className="text-[14px] font-display font-700 text-text">{template.name}</div>
+        <span className="rounded-full border border-white/[0.08] bg-white/[0.04] px-2 py-1 text-[10px] font-700 uppercase tracking-[0.12em] text-text-3/70">
+          {template.builtIn ? 'Built-in' : 'Custom'}
+        </span>
+      </div>
+      <div className="mt-2 text-[12px] leading-relaxed text-text-3/72 line-clamp-3">
         {template.description}
       </div>
       {template.tags && template.tags.length > 0 && (
-        <div className="mt-2 flex gap-1">
+        <div className="mt-3 flex flex-wrap gap-1.5">
           {template.tags.slice(0, 2).map((tag) => (
-            <span key={tag} className="rounded bg-muted px-1.5 py-0.5 text-[10px]">
+            <span key={tag} className="rounded-full border border-white/[0.08] bg-white/[0.03] px-2 py-1 text-[10px] text-text-2">
               {tag}
             </span>
           ))}
@@ -38,14 +45,14 @@ export function TemplateGallery() {
     <div className="space-y-4">
       {builtInTemplates.length > 0 && (
         <div>
-          <h4 className="mb-2 text-xs font-semibold uppercase text-muted-foreground">Built-in</h4>
-          <div className="grid grid-cols-2 gap-3">{builtInTemplates.map(renderCard)}</div>
+          <h4 className="mb-2 text-[11px] font-700 uppercase tracking-[0.12em] text-text-3/55">Built-in</h4>
+          <div className="grid gap-3 md:grid-cols-2">{builtInTemplates.map(renderCard)}</div>
         </div>
       )}
       {customTemplates.length > 0 && (
         <div>
-          <h4 className="mb-2 text-xs font-semibold uppercase text-muted-foreground">Custom</h4>
-          <div className="grid grid-cols-2 gap-3">{customTemplates.map(renderCard)}</div>
+          <h4 className="mb-2 text-[11px] font-700 uppercase tracking-[0.12em] text-text-3/55">Custom</h4>
+          <div className="grid gap-3 md:grid-cols-2">{customTemplates.map(renderCard)}</div>
         </div>
       )}
     </div>

package/src/components/shared/launch-action-card.tsx

@@ -0,0 +1,27 @@
+type LaunchActionCardProps = {
+  title: string
+  description: string
+  actionLabel: string
+  onClick: () => void
+  tone?: 'primary' | 'default'
+}
+
+export function LaunchActionCard({ title, description, actionLabel, onClick, tone = 'default' }: LaunchActionCardProps) {
+  return (
+    <div className="rounded-[18px] border border-white/[0.06] bg-white/[0.03] p-4">
+      <div className="text-[15px] font-display font-700 text-text">{title}</div>
+      <p className="mt-2 text-[13px] leading-relaxed text-text-3/72">{description}</p>
+      <button
+        type="button"
+        onClick={onClick}
+        className={`mt-4 rounded-[12px] px-4 py-2.5 text-[13px] font-display font-700 transition-all cursor-pointer ${
+          tone === 'primary'
+            ? 'bg-accent-bright text-black hover:opacity-90'
+            : 'border border-white/[0.08] bg-white/[0.04] text-text-2 hover:bg-white/[0.08]'
+        }`}
+      >
+        {actionLabel}
+      </button>
+    </div>
+  )
+}

package/src/features/swarmfeed/feed-page.tsx

@@ -1,6 +1,6 @@
 'use client'
 
-import { useDeferredValue, useEffect, useState } from 'react'
+import { useDeferredValue, useState } from 'react'
 import { Bell, Hash, Search, Sparkles, TrendingUp, Users } from 'lucide-react'
 import { toast } from 'sonner'
 import { AgentAvatar } from '@/components/agents/agent-avatar'
@@ -77,30 +77,23 @@ export function FeedPage() {
   const [profileAgentId, setProfileAgentId] = useState<string | null>(null)
 
   const deferredSearchQuery = useDeferredValue(searchQuery.trim())
-  const selectedAgent = selectedAgentId ? agents[selectedAgentId] : null
+  const resolvedSelectedAgentId = selectedAgentId && feedAgents.some((agent) => agent.id === selectedAgentId)
+    ? selectedAgentId
+    : (feedAgents[0]?.id || '')
+  const selectedAgent = resolvedSelectedAgentId ? agents[resolvedSelectedAgentId] : null
   const isSearching = deferredSearchQuery.length >= 2
   const currentFeedType = isFeedTab(activeTab) ? activeTab : 'for_you'
   const requiresActor = activeTab === 'following' || activeTab === 'bookmarks' || activeTab === 'notifications'
 
-  useEffect(() => {
-    if (feedAgents.length === 0) {
-      setSelectedAgentId('')
-      return
-    }
-    if (!selectedAgentId || !feedAgents.some((agent) => agent.id === selectedAgentId)) {
-      setSelectedAgentId(feedAgents[0].id)
-    }
-  }, [feedAgents, selectedAgentId])
-
   const channelsQuery = useSwarmFeedChannelsQuery()
   const feedQuery = useSwarmFeedFeedQuery({
     type: currentFeedType,
-    agentId: activeTab === 'following' ? selectedAgentId : undefined,
-    enabled: !isSearching && isFeedTab(activeTab) && (activeTab !== 'following' || !!selectedAgentId),
+    agentId: activeTab === 'following' ? resolvedSelectedAgentId : undefined,
+    enabled: !isSearching && isFeedTab(activeTab) && (activeTab !== 'following' || !!resolvedSelectedAgentId),
   })
-  const bookmarksQuery = useSwarmFeedBookmarksQuery(selectedAgentId, !isSearching && activeTab === 'bookmarks')
-  const notificationsQuery = useSwarmFeedNotificationsQuery(selectedAgentId, !isSearching && activeTab === 'notifications')
-  const suggestedQuery = useSwarmFeedSuggestedQuery(selectedAgentId || undefined, true)
+  const bookmarksQuery = useSwarmFeedBookmarksQuery(resolvedSelectedAgentId, !isSearching && activeTab === 'bookmarks')
+  const notificationsQuery = useSwarmFeedNotificationsQuery(resolvedSelectedAgentId, !isSearching && activeTab === 'notifications')
+  const suggestedQuery = useSwarmFeedSuggestedQuery(resolvedSelectedAgentId || undefined, true)
   const searchResultsQuery = useSwarmFeedSearchQuery({
     query: deferredSearchQuery,
     type: searchType,
@@ -114,13 +107,13 @@ export function FeedPage() {
   )
 
   async function handlePostAction(action: PostCardAction, post: SwarmFeedPost) {
-    if (!selectedAgentId) {
+    if (!resolvedSelectedAgentId) {
       throw new Error('Select an acting agent before interacting with SwarmFeed.')
     }
     try {
       await actionMutation.mutateAsync({
         action,
-        agentId: selectedAgentId,
+        agentId: resolvedSelectedAgentId,
         postId: post.id,
       })
     } catch (err: unknown) {
@@ -131,14 +124,14 @@ export function FeedPage() {
   }
 
   async function handleFollow(targetAgentId: string) {
-    if (!selectedAgentId) {
+    if (!resolvedSelectedAgentId) {
       toast.error('Select an acting agent before following other agents.')
       return
     }
     try {
       await actionMutation.mutateAsync({
         action: 'follow',
-        agentId: selectedAgentId,
+        agentId: resolvedSelectedAgentId,
         targetAgentId,
       })
       toast.success('Agent followed')
@@ -164,7 +157,7 @@ export function FeedPage() {
             key={post.id}
             post={post}
             channelLabel={post.channelId ? channelLabels[post.channelId] : null}
-            canInteract={!!selectedAgentId}
+            canInteract={!!resolvedSelectedAgentId}
             onAction={handlePostAction}
             onProfileOpen={setProfileAgentId}
             onThreadOpen={(postId, mode = 'reply') => setThreadState({ postId, mode })}
@@ -274,7 +267,7 @@ export function FeedPage() {
       )
     }
 
-    if (requiresActor && !selectedAgentId) {
+    if (requiresActor && !resolvedSelectedAgentId) {
       return (
         <EmptyState
           title="Choose an acting agent"
@@ -365,7 +358,7 @@ export function FeedPage() {
           <div className="grid gap-6 lg:grid-cols-[minmax(0,1.7fr)_360px]">
             <aside className="order-1 space-y-5 lg:order-2">
               <ComposePost
-                selectedAgentId={selectedAgentId}
+                selectedAgentId={resolvedSelectedAgentId}
                 onSelectAgent={setSelectedAgentId}
               />
 
@@ -425,7 +418,7 @@ export function FeedPage() {
                       <SuggestedAgentRow
                         key={agent.id}
                         agent={agent}
-                        canFollow={!!selectedAgentId}
+                        canFollow={!!resolvedSelectedAgentId}
                         busy={actionMutation.isPending}
                         onFollow={handleFollow}
                         onOpenProfile={setProfileAgentId}
@@ -487,7 +480,7 @@ export function FeedPage() {
       <PostThreadSheet
         open={!!threadState}
         postId={threadState?.postId || null}
-        actingAgentId={selectedAgentId || undefined}
+        actingAgentId={resolvedSelectedAgentId || undefined}
         channelLabels={channelLabels}
         initialMode={threadState?.mode || 'reply'}
         onClose={() => setThreadState(null)}
@@ -497,7 +490,7 @@ export function FeedPage() {
       <SwarmFeedProfileSheet
         open={!!profileAgentId}
         agentId={profileAgentId}
-        viewerAgentId={selectedAgentId || undefined}
+        viewerAgentId={resolvedSelectedAgentId || undefined}
         channelLabels={channelLabels}
         onClose={() => setProfileAgentId(null)}
         onOpenThread={(postId, mode = 'reply') => setThreadState({ postId, mode })}

package/src/features/swarmfeed/post-thread-sheet.tsx

@@ -1,6 +1,6 @@
 'use client'
 
-import { useEffect, useState } from 'react'
+import { useState } from 'react'
 import { toast } from 'sonner'
 import { Sheet, SheetContent, SheetDescription, SheetHeader, SheetTitle } from '@/components/ui/sheet'
 import { PostCard } from './post-card'
@@ -26,40 +26,6 @@ export function PostThreadSheet({
   onProfileOpen,
 }: Props) {
   const threadQuery = useSwarmFeedThreadQuery(postId || '', open && !!postId)
-  const postMutation = useSwarmFeedPostMutation()
-  const actionMutation = useSwarmFeedActionMutation()
-  const [mode, setMode] = useState<'reply' | 'quote'>(initialMode)
-  const [content, setContent] = useState('')
-
-  useEffect(() => {
-    if (!open) return
-    setMode(initialMode)
-    setContent('')
-  }, [initialMode, open, postId])
-
-  async function submit() {
-    if (!actingAgentId || !postId || !content.trim()) return
-    try {
-      if (mode === 'reply') {
-        await postMutation.mutateAsync({
-          agentId: actingAgentId,
-          input: { content: content.trim(), parentId: postId },
-        })
-      } else {
-        await actionMutation.mutateAsync({
-          action: 'quote_repost',
-          agentId: actingAgentId,
-          postId,
-          content: content.trim(),
-        })
-      }
-      toast.success(mode === 'reply' ? 'Reply posted' : 'Quote repost published')
-      setContent('')
-    } catch (err: unknown) {
-      toast.error(err instanceof Error ? err.message : 'Failed to publish response')
-    }
-  }
-
   const post = threadQuery.data?.post
   const replies = threadQuery.data?.replies || []
 
@@ -113,43 +79,92 @@ export function PostThreadSheet({
           </div>
 
           <div className="border-t border-white/[0.06] pt-4">
-            <div className="mb-3 flex gap-2">
-              {(['reply', 'quote'] as const).map((option) => (
-                <button
-                  key={option}
-                  type="button"
-                  onClick={() => setMode(option)}
-                  className={`cursor-pointer rounded-[999px] border px-3 py-1.5 text-[12px] font-700 uppercase tracking-[0.08em] transition-all ${
-                    mode === option
-                      ? 'border-accent-bright/50 bg-accent-bright/10 text-accent-bright'
-                      : 'border-white/[0.08] bg-transparent text-text-3 hover:text-text'
-                  }`}
-                >
-                  {option === 'reply' ? 'Reply' : 'Quote'}
-                </button>
-              ))}
-            </div>
-            <textarea
-              value={content}
-              onChange={(event) => setContent(event.target.value)}
-              placeholder={mode === 'reply' ? 'Write a concise reply…' : 'Add your commentary before reposting…'}
-              className="min-h-[110px] w-full resize-y rounded-[14px] border border-white/[0.08] bg-surface/70 px-4 py-3 text-[14px] text-text outline-none focus-glow"
-              maxLength={2000}
+            <ThreadComposer
+              key={`${postId || 'none'}:${initialMode}:${open ? 'open' : 'closed'}`}
+              actingAgentId={actingAgentId}
+              postId={postId}
+              initialMode={initialMode}
             />
-            <div className="mt-3 flex items-center justify-between">
-              <span className="text-[11px] text-text-3/55">{content.length}/2000</span>
-              <button
-                type="button"
-                onClick={() => { void submit() }}
-                disabled={!actingAgentId || !content.trim() || postMutation.isPending || actionMutation.isPending}
-                className="cursor-pointer rounded-[12px] bg-accent-bright px-4 py-2.5 text-[13px] font-700 text-white transition-all hover:bg-accent-bright/90 disabled:cursor-not-allowed disabled:opacity-40"
-              >
-                {mode === 'reply' ? 'Reply' : 'Quote repost'}
-              </button>
-            </div>
           </div>
         </div>
       </SheetContent>
     </Sheet>
   )
 }
+
+function ThreadComposer({
+  actingAgentId,
+  postId,
+  initialMode,
+}: {
+  actingAgentId?: string
+  postId: string | null
+  initialMode: 'reply' | 'quote'
+}) {
+  const postMutation = useSwarmFeedPostMutation()
+  const actionMutation = useSwarmFeedActionMutation()
+  const [mode, setMode] = useState<'reply' | 'quote'>(initialMode)
+  const [content, setContent] = useState('')
+
+  async function submit() {
+    if (!actingAgentId || !postId || !content.trim()) return
+    try {
+      if (mode === 'reply') {
+        await postMutation.mutateAsync({
+          agentId: actingAgentId,
+          input: { content: content.trim(), parentId: postId },
+        })
+      } else {
+        await actionMutation.mutateAsync({
+          action: 'quote_repost',
+          agentId: actingAgentId,
+          postId,
+          content: content.trim(),
+        })
+      }
+      toast.success(mode === 'reply' ? 'Reply posted' : 'Quote repost published')
+      setContent('')
+    } catch (err: unknown) {
+      toast.error(err instanceof Error ? err.message : 'Failed to publish response')
+    }
+  }
+
+  return (
+    <>
+      <div className="mb-3 flex gap-2">
+        {(['reply', 'quote'] as const).map((option) => (
+          <button
+            key={option}
+            type="button"
+            onClick={() => setMode(option)}
+            className={`cursor-pointer rounded-[999px] border px-3 py-1.5 text-[12px] font-700 uppercase tracking-[0.08em] transition-all ${
+              mode === option
+                ? 'border-accent-bright/50 bg-accent-bright/10 text-accent-bright'
+                : 'border-white/[0.08] bg-transparent text-text-3 hover:text-text'
+            }`}
+          >
+            {option === 'reply' ? 'Reply' : 'Quote'}
+          </button>
+        ))}
+      </div>
+      <textarea
+        value={content}
+        onChange={(event) => setContent(event.target.value)}
+        placeholder={mode === 'reply' ? 'Write a concise reply…' : 'Add your commentary before reposting…'}
+        className="min-h-[110px] w-full resize-y rounded-[14px] border border-white/[0.08] bg-surface/70 px-4 py-3 text-[14px] text-text outline-none focus-glow"
+        maxLength={2000}
+      />
+      <div className="mt-3 flex items-center justify-between">
+        <span className="text-[11px] text-text-3/55">{content.length}/2000</span>
+        <button
+          type="button"
+          onClick={() => { void submit() }}
+          disabled={!actingAgentId || !content.trim() || postMutation.isPending || actionMutation.isPending}
+          className="cursor-pointer rounded-[12px] bg-accent-bright px-4 py-2.5 text-[13px] font-700 text-white transition-all hover:bg-accent-bright/90 disabled:cursor-not-allowed disabled:opacity-40"
+        >
+          {mode === 'reply' ? 'Reply' : 'Quote repost'}
+        </button>
+      </div>
+    </>
+  )
+}

package/src/lib/home-launchpad.test.ts

@@ -0,0 +1,49 @@
+import assert from 'node:assert/strict'
+import { test } from 'node:test'
+import { deriveHomeMode, isSparseWorkspace } from './home-launchpad'
+
+test('isSparseWorkspace detects a fresh workspace', () => {
+  assert.equal(isSparseWorkspace({
+    agentCount: 1,
+    sessionCount: 0,
+    taskCount: 0,
+    scheduleCount: 0,
+    connectorCount: 0,
+    todayCost: 0,
+  }), true)
+})
+
+test('isSparseWorkspace returns false once work exists', () => {
+  assert.equal(isSparseWorkspace({
+    agentCount: 2,
+    sessionCount: 1,
+    taskCount: 0,
+    scheduleCount: 0,
+    connectorCount: 0,
+    todayCost: 0,
+  }), false)
+})
+
+test('deriveHomeMode prioritizes the post-setup launchpad flag', () => {
+  assert.equal(deriveHomeMode({
+    hasLaunchpadFlag: true,
+    agentCount: 5,
+    sessionCount: 8,
+    taskCount: 3,
+    scheduleCount: 2,
+    connectorCount: 1,
+    todayCost: 12.4,
+  }), 'launchpad')
+})
+
+test('deriveHomeMode falls back to ops for active workspaces', () => {
+  assert.equal(deriveHomeMode({
+    hasLaunchpadFlag: false,
+    agentCount: 3,
+    sessionCount: 1,
+    taskCount: 0,
+    scheduleCount: 0,
+    connectorCount: 0,
+    todayCost: 0,
+  }), 'ops')
+})

package/src/lib/home-launchpad.ts

@@ -0,0 +1,30 @@
+export const HOME_LAUNCHPAD_AFTER_SETUP_KEY = 'sc_launchpad_after_setup_v1'
+export const DEFAULT_BUILDER_ROUTE = '/protocols/builder/facilitated_discussion'
+
+export type HomeMode = 'launchpad' | 'ops'
+
+export interface HomeModeInput {
+  hasLaunchpadFlag: boolean
+  agentCount: number
+  sessionCount: number
+  taskCount: number
+  scheduleCount: number
+  connectorCount: number
+  todayCost: number
+}
+
+export function isSparseWorkspace(input: Omit<HomeModeInput, 'hasLaunchpadFlag'>): boolean {
+  return (
+    input.agentCount <= 2
+    && input.sessionCount === 0
+    && input.taskCount === 0
+    && input.scheduleCount === 0
+    && input.connectorCount === 0
+    && input.todayCost === 0
+  )
+}
+
+export function deriveHomeMode(input: HomeModeInput): HomeMode {
+  if (input.hasLaunchpadFlag) return 'launchpad'
+  return isSparseWorkspace(input) ? 'launchpad' : 'ops'
+}

package/src/lib/setup-defaults.ts

@@ -359,6 +359,13 @@ export const ONBOARDING_PATHS: OnboardingPathOption[] = [
     detail: 'Best when you already know which provider you want and want to get moving quickly.',
     badge: 'Fastest',
   },
+  {
+    id: 'intent',
+    title: 'Goal-Driven Setup',
+    description: 'Choose a starter team around what you want to accomplish.',
+    detail: 'Best when you know the outcome you want but want SwarmClaw to start from a stronger template.',
+    badge: 'Guided',
+  },
   {
     id: 'manual',
     title: 'Custom Setup',
@@ -462,7 +469,7 @@ export const STARTER_KITS: StarterKit[] = [
     name: 'Research Copilot',
     description: 'A focused setup for investigation and synthesis.',
     detail: 'Useful for market scans, comparisons, technical investigation, and source-backed summaries.',
-    recommendedFor: ['intent', 'manual'],
+    recommendedFor: ['quick', 'intent', 'manual'],
     agents: [
       {
         id: 'researcher',
@@ -479,7 +486,7 @@ export const STARTER_KITS: StarterKit[] = [
     name: 'Builder Studio',
     description: 'Start with a builder and a reviewer.',
     detail: 'Good for coding, prototyping, product work, and technical iteration.',
-    recommendedFor: ['intent', 'manual'],
+    recommendedFor: ['quick', 'intent', 'manual'],
     agents: [
       {
         id: 'builder',
@@ -528,10 +535,10 @@ export const STARTER_KITS: StarterKit[] = [
   },
   {
     id: 'operator_swarm',
-    name: 'Operator Swarm',
-    description: 'A coordination-heavy setup for multi-agent work.',
-    detail: 'Closest to the current SwarmClaw operator workflow, with a delegating operator plus an execution agent.',
-    recommendedFor: ['manual'],
+    name: 'Delegate Team',
+    description: 'A coordinator plus an execution agent for multi-agent work.',
+    detail: 'Use this when you want one agent to plan and delegate while another handles focused execution.',
+    recommendedFor: ['intent', 'manual'],
     agents: [
       {
         id: 'operator',