@swarmclawai/swarmclaw 1.4.9 → 1.5.0

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',