@swarmclawai/swarmclaw 1.4.8 → 1.5.0

package/README.md

@@ -215,6 +215,16 @@ SwarmClaw agents can join [SwarmFeed](https://swarmfeed.ai) — a social network
 
 Read the docs at [swarmclaw.ai/docs/swarmfeed](https://swarmclaw.ai/docs/swarmfeed) and visit [swarmfeed.ai](https://swarmfeed.ai) for the platform itself.
 
+### v1.5.0 Highlights
+
+- **First-run activation refresh**: setup now includes a dedicated start-path step, broad starter shapes instead of niche presets, and draft agents generated directly from the chosen setup shape.
+- **Guided post-setup launchpad**: finishing setup now routes through action-oriented next steps such as opening the first agent chat, launching a structured session, connecting platforms, or reviewing usage.
+- **State-aware home and protocols**: fresh workspaces now open on a launchpad instead of a sparse ops dashboard, and the Protocols page now surfaces the visual builder and template gallery directly.
+
+### v1.4.9 Highlights
+
+- **Standalone build reliability**: `public/`, `.next/static/`, and `css-tree/data/` are now automatically copied into the standalone build output, fixing runtime crashes and missing assets when running the standalone bundle. (Community contribution by [@borislavnnikolov](https://github.com/borislavnnikolov) — PR #34)
+
 ### v1.4.8 Highlights
 
 - **Agent-scoped SwarmFeed dashboard**: the in-app feed now has an explicit acting-agent model so humans can direct social actions without ever posting as a separate user identity.
@@ -351,7 +361,7 @@ Then open `http://localhost:3456`.
 - **Delegation**: built-in delegation to Claude Code, Codex CLI, OpenCode CLI, Gemini CLI, and native SwarmClaw subagents.
 - **Autonomy**: heartbeat loops, schedules, background jobs, task execution, supervisor recovery, and agent wakeups.
 - **Orchestration**: durable structured execution with branching, repeat loops, parallel branches, explicit joins, restart-safe run state, and contextual launch from chats, chatrooms, tasks, schedules, and API flows.
-- **Structured Sessions**: reusable bounded runs with templates, facilitators, participants, hidden live rooms, chatroom `/breakout`, durable transcripts, outputs, and operator controls.
+- **Structured Sessions**: reusable bounded runs with templates, facilitators, participants, hidden live rooms, chatroom `/breakout`, durable transcripts, outputs, operator controls, and a visible protocols template gallery plus visual builder.
 - **Memory**: hybrid recall, graph traversal, journaling, durable documents, project-scoped context, automatic reflection memory, communication preferences, profile and boundary memory, significant events, and open follow-up loops.
 - **Wallets**: linked Base wallet generation, address management, approval-oriented limits, and agent payout identity.
 - **Connectors**: Discord, Slack, Telegram, WhatsApp, Teams, Matrix, OpenClaw, SwarmDock, SwarmFeed, and more.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmclawai/swarmclaw",
-  "version": "1.4.8",
+  "version": "1.5.0",
   "description": "Self-hosted AI runtime for OpenClaw, delegation, autonomy, runtime skills, crypto wallets, and chat platform connectors.",
   "license": "MIT",
   "publishConfig": {

package/scripts/run-next-build.mjs

@@ -56,6 +56,44 @@ function hasRequiredNextMetadataFiles(dir) {
   return REQUIRED_NEXT_METADATA_FILES.every((fileName) => fs.existsSync(path.join(dir, fileName)))
 }
 
+export function repairStandalonePublicAndStatic(cwd = process.cwd()) {
+  const standaloneDir = path.join(cwd, '.next', 'standalone')
+  if (!fs.existsSync(standaloneDir)) return false
+
+  let repaired = false
+
+  // Next.js standalone does not copy public/ or .next/static/ automatically.
+  const publicSrc = path.join(cwd, 'public')
+  const publicDst = path.join(standaloneDir, 'public')
+  if (fs.existsSync(publicSrc) && !fs.existsSync(publicDst)) {
+    fs.cpSync(publicSrc, publicDst, { recursive: true, force: true })
+    repaired = true
+  }
+
+  const staticSrc = path.join(cwd, '.next', 'static')
+  const staticDst = path.join(standaloneDir, '.next', 'static')
+  if (fs.existsSync(staticSrc) && !fs.existsSync(staticDst)) {
+    fs.cpSync(staticSrc, staticDst, { recursive: true, force: true })
+    repaired = true
+  }
+
+  return repaired
+}
+
+export function repairStandaloneCssTreeData(cwd = process.cwd()) {
+  const standaloneDir = path.join(cwd, '.next', 'standalone')
+  if (!fs.existsSync(standaloneDir)) return false
+
+  const dataDst = path.join(standaloneDir, 'node_modules', 'css-tree', 'data')
+  if (fs.existsSync(dataDst)) return false
+
+  const dataSrc = path.join(cwd, 'node_modules', 'css-tree', 'data')
+  if (!fs.existsSync(dataSrc)) return false
+
+  fs.cpSync(dataSrc, dataDst, { recursive: true, force: true })
+  return true
+}
+
 export function repairStandaloneNextMetadata(cwd = process.cwd()) {
   const standaloneDir = path.join(cwd, '.next', 'standalone')
   if (!fs.existsSync(standaloneDir)) return false
@@ -106,6 +144,12 @@ function main() {
     if (result.status === 0 && repairStandaloneNextMetadata(process.cwd())) {
       console.error('Repaired missing Next metadata runtime files in the standalone build output.')
     }
+    if (result.status === 0 && repairStandalonePublicAndStatic(process.cwd())) {
+      console.error('Copied public/ and .next/static/ into standalone build output.')
+    }
+    if (result.status === 0 && repairStandaloneCssTreeData(process.cwd())) {
+      console.error('Copied css-tree/data/ into standalone build output.')
+    }
     process.exit(result.status)
   }
   if (result.signal) {

package/src/app/home/page.tsx

@@ -1,16 +1,20 @@
 'use client'
 
 import { useEffect, useMemo, useState } from 'react'
+import { useRouter } from 'next/navigation'
 import { AreaChart, Area, ResponsiveContainer, Tooltip } from 'recharts'
 import { useAppStore } from '@/stores/use-app-store'
 import { useChatStore } from '@/stores/use-chat-store'
 import { AgentAvatar } from '@/components/agents/agent-avatar'
+import { HomeLaunchpad } from '@/components/home/home-launchpad'
 import { useMountedRef } from '@/hooks/use-mounted-ref'
 import { useNow } from '@/hooks/use-now'
 import { api } from '@/lib/app/api-client'
 import { useNavigate } from '@/lib/app/navigation'
+import { safeStorageGet, safeStorageRemove } from '@/lib/app/safe-storage'
 import { isLocalhostBrowser, isVisibleSessionForViewer } from '@/lib/observability/local-observability'
 import { getSessionLastMessage } from '@/lib/chat/session-summary'
+import { DEFAULT_BUILDER_ROUTE, deriveHomeMode, HOME_LAUNCHPAD_AFTER_SETUP_KEY } from '@/lib/home-launchpad'
 import { getNotificationActivityAt, getNotificationOccurrenceCount } from '@/lib/notifications/notification-utils'
 import { timeAgo, timeUntil } from '@/lib/time-format'
 import type { Agent, Session, BoardTask, AppNotification, ActivityEntry } from '@/types'
@@ -79,6 +83,7 @@ const PLATFORM_LABELS: Record<string, string> = {
 }
 
 export default function HomePage() {
+  const router = useRouter()
   const now = useNow()
   const agents = useAppStore((s) => s.agents)
   const sessions = useAppStore((s) => s.sessions)
@@ -103,14 +108,22 @@ export default function HomePage() {
   const [costTrend, setCostTrend] = useState<{ cost: number; bucket: string }[]>([])
   const [localhostBrowser, setLocalhostBrowser] = useState(false)
   const [pageReady, setPageReady] = useState(false)
+  const [launchpadFlag, setLaunchpadFlag] = useState(false)
   const mountedRef = useMountedRef()
 
   useEffect(() => {
     setLocalhostBrowser(isLocalhostBrowser())
   }, [])
 
+  useEffect(() => {
+    const hasFlag = safeStorageGet(HOME_LAUNCHPAD_AFTER_SETUP_KEY) === '1'
+    setLaunchpadFlag(hasFlag)
+    if (hasFlag) safeStorageRemove(HOME_LAUNCHPAD_AFTER_SETUP_KEY)
+  }, [])
+
   const allAgents = Object.values(agents).filter((a) => !a.trashedAt)
   const pinnedAgents = allAgents.filter((a) => a.pinned)
+  const firstAgent = allAgents[0] || null
 
   const recentChats = useMemo(
     () =>
@@ -123,10 +136,14 @@ export default function HomePage() {
 
   // Quick stats
   const agentCount = allAgents.length
+  const sessionCount = Object.keys(sessions).length
   const allTasks = Object.values(tasks)
+  const totalTaskCount = allTasks.length
   const activeTaskCount = allTasks.filter((t) => t.status === 'running' || t.status === 'queued').length
   const allConnectors = Object.values(connectors)
   const activeConnectorCount = allConnectors.filter((c) => c.status === 'running').length
+  const connectorCount = allConnectors.length
+  const scheduleCount = Object.keys(schedules).length
 
   // Agents with running tasks
   const runningAgentIds = useMemo(() => {
@@ -223,6 +240,51 @@ export default function HomePage() {
     )
   }
 
+  const homeMode = deriveHomeMode({
+    hasLaunchpadFlag: launchpadFlag,
+    agentCount,
+    sessionCount,
+    taskCount: totalTaskCount,
+    scheduleCount,
+    connectorCount,
+    todayCost,
+  })
+
+  const openFirstAgent = () => {
+    if (firstAgent) {
+      navigateTo('agents', firstAgent.id)
+      return
+    }
+    navigateTo('agents')
+  }
+
+  const openBuilder = () => {
+    router.push(DEFAULT_BUILDER_ROUTE)
+  }
+
+  if (homeMode === 'launchpad') {
+    return (
+      <MainContent>
+        <div className="flex-1 overflow-y-auto">
+          <HomeLaunchpad
+            firstAgent={firstAgent}
+            agentCount={agentCount}
+            sessionCount={sessionCount}
+            taskCount={totalTaskCount}
+            scheduleCount={scheduleCount}
+            connectorCount={connectorCount}
+            todayCost={todayCost}
+            onOpenFirstAgent={openFirstAgent}
+            onOpenProtocols={() => navigateTo('protocols')}
+            onOpenBuilder={openBuilder}
+            onOpenConnectors={() => navigateTo('connectors')}
+            onOpenUsage={() => navigateTo('usage')}
+          />
+        </div>
+      </MainContent>
+    )
+  }
+
   return (
     <MainContent>
       <div className="flex-1 overflow-y-auto">

package/src/app/protocols/page.tsx

@@ -16,7 +16,9 @@ import {
 import { useTasksQuery } from '@/features/tasks/queries'
 import { MainContent } from '@/components/layout/main-content'
 import { StructuredSessionLauncher } from '@/components/protocols/structured-session-launcher'
+import { TemplateGallery } from '@/components/protocols/builder/template-gallery'
 import { GroundingPanel } from '@/components/knowledge/grounding-panel'
+import { DEFAULT_BUILDER_ROUTE } from '@/lib/home-launchpad'
 import { timeAgo } from '@/lib/time-format'
 import type {
   BoardTask,
@@ -390,6 +392,13 @@ export default function ProtocolsPage() {
                     >
                       New template
                     </button>
+                    <button
+                      type="button"
+                      onClick={() => router.push(DEFAULT_BUILDER_ROUTE)}
+                      className="rounded-[10px] border border-white/[0.08] bg-white/[0.04] px-3 py-2 text-[12px] font-700 text-text-2 transition-all hover:bg-white/[0.08] cursor-pointer"
+                    >
+                      Open visual builder
+                    </button>
                   </div>
                 </div>
 
@@ -417,6 +426,28 @@ export default function ProtocolsPage() {
                   </div>
                 </div>
 
+                <div className="mt-4 rounded-[16px] border border-white/[0.06] bg-white/[0.03] p-4">
+                  <div className="flex flex-col gap-4 md:flex-row md:items-start md:justify-between">
+                    <div className="max-w-[720px]">
+                      <div className="text-[11px] font-700 uppercase tracking-[0.12em] text-text-3/55">Visual Workflow Templates</div>
+                      <div className="mt-2 text-[15px] font-700 text-text">Pick a built-in protocol and open it in the builder.</div>
+                      <div className="mt-2 text-[13px] leading-relaxed text-text-3/72">
+                        Use the gallery for the fastest path into structured workflows. Custom templates stay here too, so teams can refine reusable runs without dropping straight into JSON first.
+                      </div>
+                    </div>
+                    <button
+                      type="button"
+                      onClick={() => router.push(DEFAULT_BUILDER_ROUTE)}
+                      className="rounded-[10px] bg-accent-bright px-3 py-2 text-[12px] font-700 text-black transition-all hover:opacity-90 cursor-pointer"
+                    >
+                      Open builder
+                    </button>
+                  </div>
+                  <div className="mt-4">
+                    <TemplateGallery templates={templates} />
+                  </div>
+                </div>
+
                 <details className="mt-4 rounded-[16px] border border-white/[0.06] bg-white/[0.03] p-4">
                   <summary className="cursor-pointer list-none text-[11px] font-700 uppercase tracking-[0.12em] text-text-3/55">
                     Advanced Manual Run Builder

package/src/app/setup/page.tsx

@@ -2,16 +2,18 @@
 
 import { useRouter } from 'next/navigation'
 import { safeStorageSet } from '@/lib/app/safe-storage'
+import { HOME_LAUNCHPAD_AFTER_SETUP_KEY } from '@/lib/home-launchpad'
 import { SetupWizard } from '@/components/auth/setup-wizard'
 
 export default function SetupPage() {
   const router = useRouter()
   return (
     <SetupWizard
-      onComplete={() => {
+      onComplete={(destination) => {
         safeStorageSet('sc_setup_done', '1')
+        safeStorageSet(HOME_LAUNCHPAD_AFTER_SETUP_KEY, '1')
         window.dispatchEvent(new Event('sc:setup-complete'))
-        router.replace('/home')
+        router.replace(destination || '/home')
       }}
     />
   )

package/src/components/auth/setup-wizard/index.tsx

@@ -7,11 +7,11 @@ import { dedup, errorMessage } from '@/lib/shared-utils'
 import type { ProviderId, GatewayProfile } from '@/types'
 import {
   SETUP_PROVIDERS,
-  SWARMCLAW_ASSISTANT_PROMPT,
   getDefaultModelForProvider,
+  type OnboardingPath,
   type SetupProvider,
 } from '@/lib/setup-defaults'
-import { getDefaultAgentToolIds } from '@/lib/agent-default-tools'
+import { DEFAULT_BUILDER_ROUTE } from '@/lib/home-launchpad'
 import type {
   SetupStep,
   SetupWizardProps,
@@ -21,9 +21,10 @@ import type {
   ProviderCheckResponse,
 } from './types'
 import { STEP_ORDER } from './types'
-import { requiresSetupProviderVerification, stepIndex } from './utils'
+import { buildStarterDrafts, defaultKitForPath, getStarterKitsForPath, requiresSetupProviderVerification, stepIndex } from './utils'
 import { SparkleIcon } from './shared'
 import { StepProgress } from './step-progress'
+import { StepPath } from './step-path'
 import { StepProviders } from './step-providers'
 import { StepConnect } from './step-connect'
 import { StepAgents } from './step-agents'
@@ -34,6 +35,9 @@ export function SetupWizard({ onComplete }: SetupWizardProps) {
   const setUser = useAppStore((s) => s.setUser)
   const loadSettings = useAppStore((s) => s.loadSettings)
   const [step, setStep] = useState<SetupStep>('profile')
+  const [onboardingPath, setOnboardingPath] = useState<OnboardingPath>('quick')
+  const [starterKitId, setStarterKitId] = useState<string>(defaultKitForPath('quick'))
+  const [intentText, setIntentText] = useState('')
 
   const [activeProvider, setActiveProvider] = useState<SetupProvider | null>(null)
   const [editingProviderId, setEditingProviderId] = useState<string | null>(null)
@@ -41,6 +45,7 @@ export function SetupWizard({ onComplete }: SetupWizardProps) {
 
   const [configuredProviders, setConfiguredProviders] = useState<ConfiguredProvider[]>([])
   const [draftAgents, setDraftAgents] = useState<StarterDraftAgent[]>([])
+  const [createdAgents, setCreatedAgents] = useState<CreatedAgentSummary[]>([])
   const [saving, setSaving] = useState(false)
   const [error, setError] = useState('')
 
@@ -56,13 +61,23 @@ export function SetupWizard({ onComplete }: SetupWizardProps) {
   const configuredProviderIds = new Set(configuredProviders.map((cp) => cp.setupProvider))
   const canContinueFromProviders = configuredProviders.length > 0
 
+  const ensureStarterDrafts = (providers: ConfiguredProvider[], previousDrafts: StarterDraftAgent[] = draftAgents) => {
+    if (previousDrafts.length > 0) return previousDrafts
+    return buildStarterDrafts({
+      starterKitId,
+      intentText,
+      configuredProviders: providers,
+      previousDrafts,
+    })
+  }
+
   const skip = async () => {
     try {
       await api('PUT', '/settings', { setupCompleted: true })
     } catch {
       // Continue anyway.
     }
-    onComplete()
+    onComplete('/home')
   }
 
   const handleProfileContinue = async (userName: string, avatarSeed: string) => {
@@ -71,6 +86,20 @@ export function SetupWizard({ onComplete }: SetupWizardProps) {
     } catch { /* still set locally */ }
     setUser(userName)
     loadSettings()
+    setStep('path')
+  }
+
+  const handlePathChange = (path: OnboardingPath) => {
+    setOnboardingPath(path)
+    const visibleKits = getStarterKitsForPath(path)
+    const currentVisible = visibleKits.some((kit) => kit.id === starterKitId)
+    if (!currentVisible) {
+      setStarterKitId(defaultKitForPath(path))
+    }
+  }
+
+  const handlePathContinue = () => {
+    setError('')
     setStep('providers')
   }
 
@@ -117,33 +146,8 @@ export function SetupWizard({ onComplete }: SetupWizardProps) {
 
     // If this is the first provider and there are no agents yet, create a default agent
     if (!editingProviderId && draftAgents.length === 0) {
-      const cp = configured
-      setDraftAgents([{
-        id: `auto:${Math.random().toString(36).slice(2, 10)}`,
-        templateId: 'auto',
-        name: 'Assistant',
-        description: 'A helpful assistant.',
-        systemPrompt: SWARMCLAW_ASSISTANT_PROMPT,
-        soul: '',
-        providerConfigId: cp.id,
-        setupProvider: cp.setupProvider,
-        provider: cp.provider,
-        model: cp.defaultModel,
-        credentialId: cp.credentialId,
-        apiEndpoint: cp.endpoint,
-        gatewayProfileId: cp.gatewayProfileId,
-        tools: getDefaultAgentToolIds(),
-        capabilities: [],
-        delegationEnabled: false,
-        delegationTargetMode: 'all',
-        delegationTargetAgentIds: [],
-        autoDraftSkillSuggestions: true,
-        orchestratorEnabled: false,
-        orchestratorMission: '',
-        avatarSeed: Math.random().toString(36).slice(2, 10),
-        avatarUrl: null,
-        enabled: true,
-      }])
+      const starterDrafts = ensureStarterDrafts(nextConfigured, [])
+      setDraftAgents(starterDrafts)
     } else {
       // Update existing agents that reference the edited provider
       if (editingProviderId) {
@@ -175,41 +179,13 @@ export function SetupWizard({ onComplete }: SetupWizardProps) {
   }
 
   const goToAgentReview = () => {
+    if (draftAgents.length === 0) {
+      setDraftAgents(ensureStarterDrafts(configuredProviders, []))
+    }
     setError('')
     setStep('agents')
   }
 
-  const addBlankAgent = () => {
-    const defaultProvider = configuredProviders[0] || null
-    const newAgent: StarterDraftAgent = {
-      id: `custom:${Math.random().toString(36).slice(2, 10)}`,
-      templateId: 'custom',
-      name: `Agent ${draftAgents.length + 1}`,
-      description: '',
-      systemPrompt: '',
-      soul: '',
-      providerConfigId: defaultProvider?.id || null,
-      setupProvider: defaultProvider?.setupProvider || null,
-      provider: defaultProvider?.provider || null,
-      model: defaultProvider?.defaultModel || '',
-      credentialId: defaultProvider?.credentialId || null,
-      apiEndpoint: defaultProvider?.endpoint || null,
-      gatewayProfileId: defaultProvider?.gatewayProfileId || null,
-      tools: getDefaultAgentToolIds(),
-      capabilities: [],
-      delegationEnabled: false,
-      delegationTargetMode: 'all',
-      delegationTargetAgentIds: [],
-      autoDraftSkillSuggestions: true,
-      orchestratorEnabled: false,
-      orchestratorMission: '',
-      avatarSeed: Math.random().toString(36).slice(2, 10),
-      avatarUrl: null,
-      enabled: true,
-    }
-    setDraftAgents((current) => [...current, newAgent])
-  }
-
   const removeAgent = (id: string) => {
     setDraftAgents((current) => current.filter((draft) => draft.id !== id))
   }
@@ -393,6 +369,7 @@ export function SetupWizard({ onComplete }: SetupWizardProps) {
         await appState.setCurrentAgent(created[0].id)
       }
 
+      setCreatedAgents(created)
       setStep('next')
     } catch (err: unknown) {
       setError(errorMessage(err))
@@ -405,24 +382,20 @@ export function SetupWizard({ onComplete }: SetupWizardProps) {
     const enabledDrafts = draftAgents.filter((draft) => draft.enabled)
     if (enabledDrafts.length === 0) {
       // No agents — go straight to "next" step
+      setCreatedAgents([])
       setStep('next')
       return
     }
     await createAgentsAndFinish()
   }
 
-  const finishSetup = async () => {
+  const finishSetup = async (destination = '/home') => {
     try {
       await api('PUT', '/settings', { setupCompleted: true })
     } catch {
       // Continue anyway
     }
-    onComplete()
-  }
-
-  const handleNextAddAgent = () => {
-    addBlankAgent()
-    setStep('agents')
+    onComplete(destination)
   }
 
   return (
@@ -447,12 +420,27 @@ export function SetupWizard({ onComplete }: SetupWizardProps) {
         />
       )}
 
+      {step === 'path' && (
+        <StepPath
+          onboardingPath={onboardingPath}
+          starterKitId={starterKitId}
+          intentText={intentText}
+          onPathChange={handlePathChange}
+          onStarterKitChange={setStarterKitId}
+          onIntentTextChange={setIntentText}
+          onContinue={handlePathContinue}
+          onBack={() => setStep('profile')}
+          onSkip={skip}
+        />
+      )}
+
       {step === 'providers' && (
         <StepProviders
           configuredProviders={configuredProviders}
           configuredProviderIds={configuredProviderIds}
           error={error}
           canContinue={canContinueFromProviders}
+          onBack={() => setStep('path')}
           onSelectProvider={selectProvider}
           onRemoveProvider={removeProvider}
           onContinue={goToAgentReview}
@@ -467,8 +455,8 @@ export function SetupWizard({ onComplete }: SetupWizardProps) {
           initialLabel={activeProviderLabel}
           editingProvider={editingProvider}
           configuredProviders={configuredProviders}
-          starterKitId={null}
-          intentText=""
+          starterKitId={starterKitId}
+          intentText={intentText}
           onSaveProvider={handleSaveProvider}
           onBack={handleBackFromConnect}
           onSkip={skip}
@@ -492,9 +480,13 @@ export function SetupWizard({ onComplete }: SetupWizardProps) {
 
       {step === 'next' && (
         <StepNext
-          onAddProvider={() => setStep('providers')}
-          onAddAgent={handleNextAddAgent}
-          onContinueToDashboard={finishSetup}
+          createdAgents={createdAgents}
+          onContinueToDashboard={() => finishSetup('/home')}
+          onOpenFirstAgent={() => finishSetup(createdAgents[0]?.id ? `/agents/${encodeURIComponent(createdAgents[0].id)}` : '/agents')}
+          onOpenProtocols={() => finishSetup('/protocols')}
+          onOpenBuilder={() => finishSetup(DEFAULT_BUILDER_ROUTE)}
+          onOpenConnectors={() => finishSetup('/connectors')}
+          onOpenUsage={() => finishSetup('/usage')}
         />
       )}