@swarmclawai/swarmclaw 1.7.0 → 1.7.1

package/README.md

@@ -399,24 +399,30 @@ Operational docs: https://swarmclaw.ai/docs/observability
 
 ## Releases
 
-### v1.7.0 Highlights
+### v1.7.1 Highlights
+
+Republish of v1.7.0 from the correct commit. The v1.7.0 tarball on npm was inadvertently published from a pre-rebase tree that did not include the v1.6.1 codex continuity fixes (PR #62) or the v1.6.2 plan doc. v1.7.1 ships the same coding-agent-roster expansion on top of the correct v1.6.1+ history.
 
-Extended CLI provider roster, first-run polish, and a batch of v1.6 follow-ups including [#61](https://github.com/swarmclawai/swarmclaw/pull/61) by [@latentwill](https://github.com/latentwill). Thanks latentwill!
+Use v1.7.1 instead of v1.7.0; v1.7.0 has been deprecated on npm.
 
-**Coding-agent reach**
+### v1.7.0 Highlights
 
-- **31 new CLI providers.** Aider, Amp, Augment, AdaL, IBM Bob, Cline, CodeBuddy, Command Code, Continue, Cortex Code, Crush, Deep Agents, Firebender, iFlow, Junie, Kilo Code, Kimi, Kode, MCPJam, Mistral Vibe, Mux, Neovate, OpenHands, Pochi, Qoder, Replit Agent, Roo Code, TRAE CN, Warp Agent, Windsurf, and Zencoder are now first-class provider IDs in `ProviderType`, matching the SwarmSkills roster.
+Extended CLI provider roster — every coding agent recognized by SwarmSkills now has a corresponding CLI provider in SwarmClaw, routed through a generic streamer when no bespoke parser exists.
+
+- **31 new CLI providers.** Aider, Amp, Augment, AdaL, IBM Bob, Cline, CodeBuddy, Command Code, Continue, Cortex Code, Crush, Deep Agents, Firebender, iFlow, Junie, Kilo Code, Kimi, Kode, MCPJam, Mistral Vibe, Mux, Neovate, OpenHands, Pochi, Qoder, Replit Agent, Roo Code, TRAE CN, Warp Agent, Windsurf, and Zencoder are now first-class provider IDs in `ProviderType`.
 - **Generic CLI streamer.** New `streamGenericCliChat` (`src/lib/providers/generic-cli.ts`) spawns the configured binary with the prompt as final argv and emits stdout lines as SSE deltas. Used by the new providers when no bespoke parser is available; existing bespoke parsers (Claude, Codex, Cursor, Gemini, Copilot, Droid, Qwen, OpenCode, Goose) are untouched.
 - **Capability metadata.** `CLI_PROVIDER_CAPABILITIES` (`src/lib/providers/cli-utils.ts`) carries a one-line description for each new provider so the UI and `isCliProvider()` recognize them.
+- **Tests.** New `generic-cli.test.ts` exercises the streamer against `echo` and asserts the missing-binary error path; `cli-utils.test.ts` extends the CLI provider recognition coverage.
+
+### v1.6.1 Highlights
 
-**First-run and operator polish**
+Follow-up release for v1.6 with workflow starts, safer metadata handling, A2A discovery polish, and [#61](https://github.com/swarmclawai/swarmclaw/pull/61) by [@latentwill](https://github.com/latentwill). Thanks latentwill!
 
-- **First useful action after install.** Setup completion and the home launchpad share the same assistant, workflow, and mission paths.
-- **Provider setup is easier to scan.** The setup wizard groups providers into fast local/no-key starts, recommended API providers, and advanced catalog/custom options, with the readiness check visible before provider details.
 - **Mission and protocol templates for real work.** New starter paths cover codebase review sprints, research bureau scans, content studio cycles, release readiness panels, synthesis panels, and builder review loops.
-- **A2A discovery is easier to integrate.** The canonical `/.well-known/agent-card.json` endpoint works alongside the legacy API route and hides disabled or trashed agents from public discovery.
+- **Home launchpad paths.** First-run users can choose a self-hosted assistant, visual workflow, or autonomous mission path, with quality actions still one click away.
+- **A2A discovery is easier to integrate.** The canonical `/.well-known/agent-card.json` endpoint now works alongside the legacy API route and hides disabled or trashed agents from public discovery.
 - **Internal metadata stripping is safer.** Side-channel JSON is removed with balanced-object parsing and zod validation so nested payloads are scrubbed without deleting ordinary user JSON.
-- **Browser smoke gate restored.** `npm run test:e2e` runs a Playwright smoke against health, A2A discovery, `/home` launch paths, and `/quality`, either against a live URL or a temporary local dev server.
+- **Browser smoke gate restored.** `npm run test:e2e` now runs a Playwright smoke against health, A2A discovery, `/home`, and `/quality`, either against a live URL or a temporary local dev server.
 - **OpenCode CLI hang fixed.** OpenCode CLI delegation no longer keeps an inherited stdin pipe open, preventing hangs in non-interactive runs.
 
 ### v1.6.0 Highlights

package/bin/swarmclaw.js

@@ -3,6 +3,8 @@
 /* eslint-disable @typescript-eslint/no-require-imports */
 
 const path = require('node:path')
+const fs = require('node:fs')
+const os = require('node:os')
 const { spawnSync } = require('node:child_process')
 
 // Legacy TS CLI groups/actions that provide richer, command-specific options.
@@ -142,6 +144,79 @@ Show the installed SwarmClaw package version.
 `.trim() + '\n')
 }
 
+function readUserServiceSwarmclawHome() {
+  const homeDir = process.env.HOME || os.homedir()
+  const servicePath = path.join(homeDir, '.config', 'systemd', 'user', 'swarmclaw.service')
+  try {
+    const text = fs.readFileSync(servicePath, 'utf8')
+    const lines = text.split(/\r?\n/)
+    for (const line of lines) {
+      const trimmed = line.trim()
+      if (!trimmed.startsWith('Environment=')) continue
+      let value = trimmed.slice('Environment='.length).trim()
+      if (value.startsWith('"') && value.endsWith('"')) {
+        value = value.slice(1, -1)
+      }
+      if (!value.startsWith('SWARMCLAW_HOME=')) continue
+      const homeValue = value.slice('SWARMCLAW_HOME='.length).trim()
+      if (homeValue) return homeValue
+    }
+  } catch {
+    return null
+  }
+  return null
+}
+
+function getUserServicePath() {
+  const homeDir = process.env.HOME || os.homedir()
+  return path.join(homeDir, '.config', 'systemd', 'user', 'swarmclaw.service')
+}
+
+function hasUserSystemdService() {
+  return fs.existsSync(getUserServicePath())
+}
+
+function runSystemctlUser(args) {
+  return spawnSync('systemctl', ['--user', ...args], { stdio: 'inherit', env: process.env })
+}
+
+function hasServerLifecycleFlags(argv) {
+  return argv.some((arg) => (
+    arg === '--build'
+    || arg === '-d'
+    || arg === '--detach'
+    || arg === '--port'
+    || arg === '--ws-port'
+    || arg === '--host'
+  ))
+}
+
+function handleServiceLifecycle(top, argv) {
+  // If the user passed host/port/build flags, fall back to local server-cmd behavior.
+  const hasServerFlags = hasServerLifecycleFlags(argv)
+  if (hasServerFlags || !hasUserSystemdService()) return false
+
+  const unit = 'swarmclaw.service'
+  if (top === 'run' || top === 'start') {
+    const started = runSystemctlUser(['start', unit])
+    if (typeof started.status === 'number') process.exitCode = started.status
+    return true
+  }
+  if (top === 'stop') {
+    const stopped = runSystemctlUser(['stop', unit])
+    if (typeof stopped.status === 'number') process.exitCode = stopped.status
+    return true
+  }
+
+  return false
+}
+
+function applyServiceHomeDefault() {
+  if (typeof process.env.SWARMCLAW_HOME === 'string' && process.env.SWARMCLAW_HOME.trim()) return
+  const serviceHome = readUserServiceSwarmclawHome()
+  if (serviceHome) process.env.SWARMCLAW_HOME = serviceHome
+}
+
 async function runMappedCli(argv) {
   const cliPath = path.join(__dirname, '..', 'src', 'cli', 'index.js')
   const cliModule = await import(cliPath)
@@ -196,6 +271,8 @@ async function runHelp(argv) {
 }
 
 async function main() {
+  applyServiceHomeDefault()
+
   const argv = process.argv.slice(2)
   const top = argv[0]
 
@@ -233,10 +310,20 @@ async function main() {
     }
   }
   if (top === 'run' || top === 'start') {
+    if (handleServiceLifecycle(top, argv.slice(1))) return
     await require('./server-cmd.js').main(argv.slice(1))
     return
   }
   if (top === 'status' || top === 'stop') {
+    if (top === 'status' && hasUserSystemdService() && !hasServerLifecycleFlags(argv.slice(1))) {
+      const serviceStatus = runSystemctlUser(['status', 'swarmclaw.service', '--no-pager'])
+      const apiStatusCode = await runMappedCli(['system-status', 'get'])
+      const serviceCode = typeof serviceStatus.status === 'number' ? serviceStatus.status : 1
+      const apiCode = typeof apiStatusCode === 'number' ? apiStatusCode : 1
+      process.exitCode = serviceCode !== 0 ? serviceCode : apiCode
+      return
+    }
+    if (handleServiceLifecycle(top, argv.slice(1))) return
     await require('./server-cmd.js').main([top, ...argv.slice(1)])
     return
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmclawai/swarmclaw",
-  "version": "1.7.0",
+  "version": "1.7.1",
   "description": "Build and run autonomous AI agents with OpenClaw, Hermes, multiple model providers, orchestration, delegation, memory, skills, schedules, and chat connectors.",
   "main": "electron-dist/main.js",
   "license": "MIT",

package/src/app/home/page.tsx

@@ -14,13 +14,7 @@ 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 {
-  deriveHomeMode,
-  HOME_LAUNCHPAD_AFTER_SETUP_KEY,
-  resolveLaunchPathHref,
-  type LaunchPathAction,
-  type LaunchPathId,
-} from '@/lib/home-launchpad'
+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'
@@ -260,8 +254,16 @@ export default function HomePage() {
     todayCost,
   })
 
-  const handleLaunchPathAction = (id: LaunchPathId, action: LaunchPathAction) => {
-    router.push(resolveLaunchPathHref(id, action, firstAgent?.id))
+  const openFirstAgent = () => {
+    if (firstAgent) {
+      navigateTo('agents', firstAgent.id)
+      return
+    }
+    navigateTo('agents')
+  }
+
+  const openBuilder = () => {
+    router.push(DEFAULT_BUILDER_ROUTE)
   }
 
   if (homeMode === 'launchpad') {
@@ -276,8 +278,15 @@ export default function HomePage() {
             scheduleCount={scheduleCount}
             connectorCount={connectorCount}
             todayCost={todayCost}
-            onLaunchPathAction={handleLaunchPathAction}
+            onOpenFirstAgent={openFirstAgent}
+            onOpenProtocols={() => navigateTo('protocols')}
+            onOpenBuilder={openBuilder}
+            onOpenConnectors={() => navigateTo('connectors')}
             onOpenUsage={() => navigateTo('usage')}
+            onRunEvalSuite={() => navigateTo('quality')}
+            onReviewApprovals={() => navigateTo('quality')}
+            onInspectFailedRuns={() => navigateTo('quality')}
+            onStartReleaseQaMission={() => navigateTo('missions')}
           />
         </div>
       </MainContent>

package/src/cli/index.js

@@ -1001,8 +1001,14 @@ function resolveAccessKey(opts, env, cwd) {
   const envKey = env.SWARMCLAW_API_KEY || env.SC_ACCESS_KEY || env.SWARMCLAW_ACCESS_KEY || ''
   if (envKey) return String(envKey).trim()
 
-  const keyFile = path.join(cwd, 'platform-api-key.txt')
-  if (fs.existsSync(keyFile)) {
+  const keyLocations = [
+    path.join(cwd, 'platform-api-key.txt'),
+  ]
+  const homeDir = String(env.SWARMCLAW_HOME || '').trim()
+  if (homeDir) keyLocations.push(path.join(homeDir, 'platform-api-key.txt'))
+
+  for (const keyFile of keyLocations) {
+    if (!fs.existsSync(keyFile)) continue
     const content = fs.readFileSync(keyFile, 'utf8').trim()
     if (content) return content
   }

package/src/cli/index.ts

@@ -45,9 +45,18 @@ function resolveDefaultAccessKey(cwd: string = process.cwd()): string {
   ).trim()
   if (envKey) return envKey
 
-  const keyFile = path.join(cwd, 'platform-api-key.txt')
-  if (!fs.existsSync(keyFile)) return ''
-  return fs.readFileSync(keyFile, 'utf8').trim()
+  const keyLocations = [
+    path.join(cwd, 'platform-api-key.txt'),
+  ]
+  const serviceHome = (process.env.SWARMCLAW_HOME || '').trim()
+  if (serviceHome) keyLocations.push(path.join(serviceHome, 'platform-api-key.txt'))
+
+  for (const keyFile of keyLocations) {
+    if (!fs.existsSync(keyFile)) continue
+    const value = fs.readFileSync(keyFile, 'utf8').trim()
+    if (value) return value
+  }
+  return ''
 }
 
 const DEFAULT_ACCESS_KEY = resolveDefaultAccessKey()

package/src/components/agents/inspector-panel.tsx

@@ -4,9 +4,9 @@ import { DEFAULT_HEARTBEAT_INTERVAL_SEC } from '@/lib/runtime/heartbeat-defaults
 import { useCallback, useEffect, useMemo, useRef, useState, type ReactNode } from 'react'
 import type { Agent, MemoryEntry, Session } from '@/types'
 import { useAppStore } from '@/stores/use-app-store'
+import { selectActiveSessionId } from '@/stores/slices/session-slice'
 import { useChatStore } from '@/stores/use-chat-store'
 import { api } from '@/lib/app/api-client'
-import { sortSessionsNewestFirst } from '@/lib/chat/new-session'
 import { AgentAvatar } from './agent-avatar'
 import { AgentFilesEditor } from './agent-files-editor'
 import { OpenClawSkillsPanel } from './openclaw-skills-panel'
@@ -901,6 +901,7 @@ function QuickActionsSection({ agent, session }: { agent: Agent; session: Sessio
 
 function SessionsSection({ agent }: { agent: Agent }) {
   const sessions = useAppStore((s) => s.sessions)
+  const activeSessionId = useAppStore(selectActiveSessionId)
   const connectors = useAppStore((s) => s.connectors)
   const agents = useAppStore((s) => s.agents)
   const setCurrentAgent = useAppStore((s) => s.setCurrentAgent)
@@ -908,7 +909,19 @@ function SessionsSection({ agent }: { agent: Agent }) {
   const setInspectorOpen = useAppStore((s) => s.setInspectorOpen)
 
   const agentSessions = useMemo(() => {
-    return sortSessionsNewestFirst(Object.values(sessions).filter((s) => s.agentId === agent.id))
+    const getLastMessageTime = (session: Session): number => {
+      const summaryTime = session.lastMessageSummary?.time
+      if (typeof summaryTime === 'number' && Number.isFinite(summaryTime)) return summaryTime
+      if (Array.isArray(session.messages) && session.messages.length > 0) {
+        const last = session.messages[session.messages.length - 1]
+        if (typeof last?.time === 'number' && Number.isFinite(last.time)) return last.time
+      }
+      return session.lastActiveAt || session.createdAt || 0
+    }
+
+    return Object.values(sessions)
+      .filter((s) => s.agentId === agent.id)
+      .sort((left, right) => getLastMessageTime(right) - getLastMessageTime(left))
   }, [sessions, agent.id])
 
   if (agentSessions.length === 0) return null
@@ -918,6 +931,7 @@ function SessionsSection({ agent }: { agent: Agent }) {
       <SectionLabel>Sessions ({agentSessions.length})</SectionLabel>
       <div className="flex flex-col gap-1.5">
         {agentSessions.map((s) => {
+          const isSelected = s.id === activeSessionId
           const connector = getSessionConnector(s, connectors)
           const delegatedByAgentId = (s as unknown as Record<string, unknown>).delegatedByAgentId as string | undefined
           const delegatedBy = delegatedByAgentId ? agents[delegatedByAgentId] : null
@@ -934,7 +948,10 @@ function SessionsSection({ agent }: { agent: Agent }) {
                   }
                 }).catch(() => {})
               }}
-              className="flex items-center gap-2 w-full py-1.5 px-2 rounded-[8px] bg-transparent border-none cursor-pointer hover:bg-white/[0.04] transition-colors text-left"
+              className={`flex items-center gap-2 w-full py-1.5 px-2 rounded-[8px] border-none cursor-pointer transition-colors text-left
+                ${isSelected
+                  ? 'bg-accent-soft/70 ring-1 ring-accent-bright/25'
+                  : 'bg-transparent hover:bg-white/[0.04]'}`}
             >
               {connector ? (
                 <ConnectorPlatformIcon platform={connector.platform} size={14} />
@@ -944,6 +961,11 @@ function SessionsSection({ agent }: { agent: Agent }) {
                 </svg>
               )}
               <span className="text-[12px] text-text-2 truncate flex-1">{s.name}</span>
+              {isSelected && (
+                <span className="text-[9px] font-700 uppercase tracking-[0.08em] text-accent-bright bg-accent-bright/15 px-1.5 py-0.5 rounded-[6px] shrink-0">
+                  Selected
+                </span>
+              )}
               {delegatedBy && (
                 <span className="text-[9px] text-amber-300/60 font-600 shrink-0">from {delegatedBy.name}</span>
               )}

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

@@ -11,7 +11,7 @@ import {
   type OnboardingPath,
   type SetupProvider,
 } from '@/lib/setup-defaults'
-import { resolveLaunchPathHref } from '@/lib/home-launchpad'
+import { DEFAULT_BUILDER_ROUTE } from '@/lib/home-launchpad'
 import type {
   SetupStep,
   SetupWizardProps,
@@ -482,7 +482,11 @@ export function SetupWizard({ onComplete }: SetupWizardProps) {
         <StepNext
           createdAgents={createdAgents}
           onContinueToDashboard={() => finishSetup('/home')}
-          onLaunchPathAction={(id, action) => finishSetup(resolveLaunchPathHref(id, action, createdAgents[0]?.id))}
+          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')}
         />
       )}
 

package/src/components/auth/setup-wizard/step-next.tsx

@@ -1,48 +1,19 @@
 'use client'
 
-import { getLaunchPathCards, type LaunchPathAction, type LaunchPathCardCopy, type LaunchPathId } from '@/lib/home-launchpad'
+import { LaunchActionCard } from '@/components/shared/launch-action-card'
 import type { StepNextProps } from './types'
 import { StepShell } from './shared'
 
-function PathCard({
-  card,
-  onAction,
-}: {
-  card: LaunchPathCardCopy
-  onAction: (id: LaunchPathId, action: LaunchPathAction) => void
-}) {
-  return (
-    <div className="flex min-h-[220px] flex-col rounded-[18px] border border-white/[0.07] bg-white/[0.03] p-5 text-left">
-      <div className="text-[11px] font-700 uppercase tracking-[0.12em] text-text-3/55">{card.kicker}</div>
-      <div className="mt-3 text-[18px] font-display font-700 tracking-normal text-text">{card.title}</div>
-      <p className="mt-2 flex-1 text-[13px] leading-relaxed text-text-3/72">{card.description}</p>
-      <div className="mt-5 flex flex-wrap gap-2">
-        <button
-          type="button"
-          onClick={() => onAction(card.id, 'primary')}
-          className="rounded-[10px] bg-accent-bright px-3.5 py-2 text-[12px] font-display font-700 text-black transition-opacity hover:opacity-90"
-        >
-          {card.primaryLabel}
-        </button>
-        <button
-          type="button"
-          onClick={() => onAction(card.id, 'secondary')}
-          className="rounded-[10px] border border-white/[0.08] bg-white/[0.04] px-3.5 py-2 text-[12px] font-display font-700 text-text-2 transition-colors hover:bg-white/[0.08]"
-        >
-          {card.secondaryLabel}
-        </button>
-      </div>
-    </div>
-  )
-}
-
 export function StepNext({
   createdAgents,
   onContinueToDashboard,
-  onLaunchPathAction,
+  onOpenFirstAgent,
+  onOpenProtocols,
+  onOpenBuilder,
+  onOpenConnectors,
+  onOpenUsage,
 }: StepNextProps) {
   const firstAgent = createdAgents[0] || null
-  const launchPathCards = getLaunchPathCards({ firstAgentName: firstAgent?.name })
 
   return (
     <StepShell wide>
@@ -58,10 +29,46 @@ export function StepNext({
           : 'You finished setup without starter agents, so the launch options below focus on wiring up the rest of the workspace.'}
       </p>
 
-      <div className="grid gap-3 xl:grid-cols-3 mb-8">
-        {launchPathCards.map((card) => (
-          <PathCard key={card.id} card={card} onAction={onLaunchPathAction} />
-        ))}
+      <div className="grid gap-3 md:grid-cols-2 xl:grid-cols-3 mb-8">
+        <LaunchActionCard
+          title={firstAgent ? 'Open First Agent Chat' : 'Open Agents'}
+          description={firstAgent
+            ? `Jump straight into ${firstAgent.name} and start working from the workspace you just created.`
+            : 'Open the agents workspace so you can create or tune the first agent manually.'}
+          actionLabel={firstAgent ? 'Open Chat' : 'Open Agents'}
+          onClick={onOpenFirstAgent}
+          tone="primary"
+        />
+        <LaunchActionCard
+          title="Start Structured Session"
+          description="Open bounded collaboration runs for reviews, planning rounds, decision-making, or focused multi-agent work."
+          actionLabel="Open Protocols"
+          onClick={onOpenProtocols}
+        />
+        <LaunchActionCard
+          title="Open Workflow Builder"
+          description="Jump into the visual protocol builder if you want a reusable orchestration graph instead of a one-off run."
+          actionLabel="Open Builder"
+          onClick={onOpenBuilder}
+        />
+        <LaunchActionCard
+          title="Connect a Platform"
+          description="Bridge agents into Discord, Slack, Telegram, WhatsApp, or other runtime connectors."
+          actionLabel="Open Connectors"
+          onClick={onOpenConnectors}
+        />
+        <LaunchActionCard
+          title="Review Usage"
+          description="Inspect cost, provider health, and agent activity so the workspace stays observable from day one."
+          actionLabel="Open Usage"
+          onClick={onOpenUsage}
+        />
+        <LaunchActionCard
+          title="Go to Dashboard"
+          description="Land on the main home view. Fresh workspaces open in guided launch mode before switching to the normal ops dashboard."
+          actionLabel="Open Home"
+          onClick={onContinueToDashboard}
+        />
       </div>
 
       <button