@swarmclawai/swarmclaw 1.5.52 → 1.5.54

package/README.md

@@ -399,6 +399,18 @@ Operational docs: https://swarmclaw.ai/docs/observability
 
 ## Releases
 
+### v1.5.54 Highlights
+
+- **Mission templates library**: the `/missions` page now opens with a curated gallery of starter missions. Each template pre-wires a goal, success criteria, USD / token / turn / wallclock budgets, and a report cadence, so non-technical users can install a working autonomous run in one click. Initial lineup: Daily News Digest, Inbox Triage, Competitor Watch, Weekly Research Report, Social Listener, and Customer Support Triage. Setup notes flag any connector or permission prerequisites before installation. Power-user overrides (budget caps, success criteria, report cadence) live behind a collapsed **Advanced Settings** panel so the default install flow stays one click.
+- **New API routes `GET /api/missions/templates` and `POST /api/missions/templates/:id/instantiate`** with matching CLI commands `swarmclaw missions templates` and `swarmclaw missions instantiate`. Installed missions persist a `templateId` so the origin is traceable for future template-update flows; legacy missions normalize to `templateId: null` on load, no data migration required.
+- **Fix: user-selected provider and model now survive the chat execution pipeline** ([#51](https://github.com/swarmclawai/swarmclaw/pull/51), thanks to [@borislavnnikolov](https://github.com/borislavnnikolov)). Switching provider or model via the inspector panel mid-session was being reverted on every turn because the agent's configured route was unconditionally reapplied in three places. `syncSessionFromAgent` now only syncs credentials / endpoint / fallbacks when the session's provider still matches the route provider, `prepareChatTurn` preserves the user's chosen model after applying the route, and `updateChatSession` auto-resolves a stored credential for the new provider (and clears the stale `apiEndpoint`) when provider changes without an explicit `credentialId`. Restores reliable switching between Copilot CLI, Codex CLI, Groq, and OpenAI-compatible providers.
+
+> **Note:** v1.5.53 release notes described the mission templates library, but the feature commit landed after the v1.5.53 tag was cut. v1.5.54 is the release that actually ships it.
+
+### v1.5.53 Highlights
+
+- **Fix: switching a session's model now sticks in the UI** ([#50](https://github.com/swarmclawai/swarmclaw/pull/50), thanks to [@borislavnnikolov](https://github.com/borislavnnikolov)). The **Switch Model** panel in the agent inspector was reading from `agent.provider` / `agent.model` (the agent's defaults) instead of `session.provider` / `session.model`, so after saving a model switch the collapsed pill still showed the agent default, the combobox reset to the default when reopened, and `selectedProvider` reverted on every save. `ModelSwitcherInline` now uses `session.provider || agent.provider` and `session.model || agent.model` as the source of truth, and its `useEffect` syncs to `session.provider` changes so a successful save updates the panel immediately.
+
 ### v1.5.52 Highlights
 
 - **Session X-Ray now surfaces the backend execution log** ([#48](https://github.com/swarmclawai/swarmclaw/pull/48), thanks to [@borislavnnikolov](https://github.com/borislavnnikolov)). The debug panel fetches entries from the SQLite execution log on open and merges them with in-memory message events, sorted by time. Expandable entries show provider, model, stream errors, duration, and token counts — the info that was previously invisible when Ollama or other local-model runs failed silently. A new **Tools** filter tab, an `exec` badge for log-sourced entries, an entry count in the stats bar, and a Refresh button round it out. New API route `GET /api/chats/:id/execution-log` with `limit`, `since`, and `category` query params, registered in the CLI manifest as `swarmclaw chats execution-log`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmclawai/swarmclaw",
-  "version": "1.5.52",
+  "version": "1.5.54",
   "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/api/missions/templates/[id]/instantiate/route.ts

@@ -0,0 +1,64 @@
+import { NextResponse } from 'next/server'
+import { z } from 'zod'
+import { safeParseBody } from '@/lib/server/safe-parse-body'
+import { formatZodError } from '@/lib/validation/schemas'
+import { notFound } from '@/lib/server/collection-helpers'
+import { createMissionFromTemplate } from '@/lib/server/missions/mission-service'
+import { patchSession } from '@/lib/server/sessions/session-repository'
+
+export const dynamic = 'force-dynamic'
+
+const BudgetOverrideSchema = z.object({
+  maxUsd: z.number().positive().nullable().optional(),
+  maxTokens: z.number().positive().int().nullable().optional(),
+  maxToolCalls: z.number().positive().int().nullable().optional(),
+  maxWallclockSec: z.number().positive().int().nullable().optional(),
+  maxTurns: z.number().positive().int().nullable().optional(),
+  warnAtFractions: z.array(z.number().positive().lt(1)).max(10).optional(),
+}).partial()
+
+const ReportScheduleSchema = z.object({
+  intervalSec: z.number().int().min(30),
+  format: z.enum(['markdown', 'slack', 'discord', 'email', 'audio']),
+  enabled: z.boolean().default(true),
+  lastReportAt: z.number().nullable().optional(),
+}).strict()
+
+const InstantiateSchema = z.object({
+  rootSessionId: z.string().min(1, 'rootSessionId is required'),
+  overrides: z.object({
+    title: z.string().min(1).max(200).optional(),
+    goal: z.string().min(1).max(4000).optional(),
+    successCriteria: z.array(z.string().min(1)).max(32).optional(),
+    budget: BudgetOverrideSchema.optional(),
+    reportSchedule: ReportScheduleSchema.nullable().optional(),
+    agentIds: z.array(z.string().min(1)).max(32).optional(),
+    reportConnectorIds: z.array(z.string().min(1)).max(8).optional(),
+  }).optional(),
+}).strict()
+
+export async function POST(req: Request, { params }: { params: Promise<{ id: string }> }) {
+  const { id } = await params
+  const { data: body, error } = await safeParseBody<Record<string, unknown>>(req)
+  if (error) return error
+  const parsed = InstantiateSchema.safeParse(body)
+  if (!parsed.success) return NextResponse.json(formatZodError(parsed.error), { status: 400 })
+
+  const result = createMissionFromTemplate({
+    templateId: id,
+    rootSessionId: parsed.data.rootSessionId,
+    overrides: parsed.data.overrides,
+  })
+  if (!result) return notFound()
+
+  try {
+    patchSession(result.mission.rootSessionId, (current) => {
+      if (!current) return null
+      return { ...current, missionId: result.mission.id }
+    })
+  } catch {
+    // Session may not exist yet; budget hook falls back to service map.
+  }
+
+  return NextResponse.json({ mission: result.mission, template: result.template })
+}

package/src/app/api/missions/templates/route.ts

@@ -0,0 +1,8 @@
+import { NextResponse } from 'next/server'
+import { listMissionTemplates } from '@/lib/server/missions/mission-templates'
+
+export const dynamic = 'force-dynamic'
+
+export async function GET() {
+  return NextResponse.json(listMissionTemplates())
+}

package/src/app/missions/page.tsx

@@ -5,7 +5,12 @@ import { api } from '@/lib/app/api-client'
 import { MainContent } from '@/components/layout/main-content'
 import { HintTip } from '@/components/shared/hint-tip'
 import { inputClass } from '@/components/shared/form-styles'
-import type { Mission, MissionReport, MissionEvent, Session } from '@/types'
+import { MissionTemplateGallery } from '@/components/missions/mission-template-gallery'
+import {
+  MissionTemplateInstallDialog,
+  type InstantiateInput,
+} from '@/components/missions/mission-template-install-dialog'
+import type { Mission, MissionReport, MissionEvent, MissionTemplate, Session } from '@/types'
 import { toast } from 'sonner'
 
 const POLL_MS = 4_000
@@ -489,6 +494,9 @@ export default function MissionsPage() {
   const [createOpen, setCreateOpen] = useState(false)
   const [busy, setBusy] = useState(false)
   const [loaded, setLoaded] = useState(false)
+  const [templates, setTemplates] = useState<MissionTemplate[]>([])
+  const [galleryOpen, setGalleryOpen] = useState(false)
+  const [installTemplate, setInstallTemplate] = useState<MissionTemplate | null>(null)
 
   const selected = useMemo(() => missions.find((m) => m.id === selectedId) ?? null, [missions, selectedId])
 
@@ -534,7 +542,15 @@ export default function MissionsPage() {
     api<Session[]>('GET', '/chats').then((s) => {
       setSessions(Array.isArray(s) ? s : Object.values(s))
     }).catch(() => setSessions([]))
-  }, [createOpen])
+  }, [createOpen, galleryOpen, installTemplate])
+
+  useEffect(() => {
+    let cancelled = false
+    api<MissionTemplate[]>('GET', '/missions/templates')
+      .then((list) => { if (!cancelled) setTemplates(Array.isArray(list) ? list : []) })
+      .catch(() => { if (!cancelled) setTemplates([]) })
+    return () => { cancelled = true }
+  }, [])
 
   const handleAction = useCallback(async (action: string, reason?: string) => {
     if (!selectedId) return
@@ -571,28 +587,60 @@ export default function MissionsPage() {
     toast.success(`Mission "${created.title}" created`)
   }, [refreshList])
 
+  const handleInstallTemplate = useCallback(async (template: MissionTemplate, input: InstantiateInput) => {
+    const result = await api<{ mission: Mission }>(
+      'POST',
+      `/missions/templates/${encodeURIComponent(template.id)}/instantiate`,
+      input,
+    )
+    await refreshList()
+    setSelectedId(result.mission.id)
+    setGalleryOpen(false)
+    toast.success(`Mission "${result.mission.title}" installed`)
+  }, [refreshList])
+
   return (
     <MainContent>
       <div className="flex-1 flex min-h-0">
         <div className="w-[340px] shrink-0 border-r border-white/[0.06] flex flex-col min-h-0">
-          <div className="p-3 border-b border-white/[0.06] flex items-center justify-between">
-            <div>
-              <div className="text-[13px] font-600">Missions</div>
-              <div className="text-[10px] text-text-3">Autonomous goal-driven runs</div>
+          <div className="p-3 border-b border-white/[0.06]">
+            <div className="flex items-center justify-between mb-2">
+              <div>
+                <div className="text-[13px] font-600">Missions</div>
+                <div className="text-[10px] text-text-3">Autonomous goal-driven runs</div>
+              </div>
+              <button
+                onClick={() => setCreateOpen(true)}
+                className="text-[11px] font-600 px-2.5 py-1 rounded border border-emerald-500/30 bg-emerald-500/10 text-emerald-300 hover:bg-emerald-500/15"
+              >
+                + New
+              </button>
             </div>
-            <button
-              onClick={() => setCreateOpen(true)}
-              className="text-[11px] font-600 px-2.5 py-1 rounded border border-emerald-500/30 bg-emerald-500/10 text-emerald-300 hover:bg-emerald-500/15"
-            >
-              + New
-            </button>
+            {templates.length > 0 && (
+              <button
+                onClick={() => setGalleryOpen(true)}
+                className="w-full text-left text-[11px] font-600 px-2.5 py-1.5 rounded border border-white/[0.08] bg-white/[0.02] text-text-3 hover:border-white/[0.16] hover:text-text"
+              >
+                Browse {templates.length} starter templates →
+              </button>
+            )}
           </div>
           <div className="flex-1 overflow-y-auto p-2 flex flex-col gap-1.5">
             {!loaded ? (
               <div className="text-[11px] text-text-3 p-3">Loading...</div>
             ) : missions.length === 0 ? (
-              <div className="text-[11px] text-text-3 p-3">
-                No missions yet. Click <span className="text-emerald-300 font-600">+ New</span> to start an autonomous run.
+              <div className="flex flex-col gap-2 p-3">
+                <div className="text-[11px] text-text-3">
+                  No missions yet. Start from a template or create one from scratch.
+                </div>
+                {templates.length > 0 && (
+                  <button
+                    onClick={() => setGalleryOpen(true)}
+                    className="text-[11px] font-600 px-2.5 py-1 rounded border border-emerald-500/30 bg-emerald-500/10 text-emerald-300 hover:bg-emerald-500/15 self-start"
+                  >
+                    Open template gallery
+                  </button>
+                )}
               </div>
             ) : (
               missions.map((m) => (
@@ -616,6 +664,13 @@ export default function MissionsPage() {
               onAction={handleAction}
               onForceReport={handleForceReport}
             />
+          ) : loaded && missions.length === 0 && templates.length > 0 ? (
+            <div className="p-6">
+              <MissionTemplateGallery
+                templates={templates}
+                onInstall={(t) => setInstallTemplate(t)}
+              />
+            </div>
           ) : (
             <div className="flex items-center justify-center h-full text-text-3 text-[12px]">
               {loaded && missions.length === 0 ? 'Create a mission to get started.' : 'Select a mission'}
@@ -630,6 +685,34 @@ export default function MissionsPage() {
         onClose={() => setCreateOpen(false)}
         onCreate={handleCreate}
       />
+
+      {galleryOpen && (
+        <div
+          className="fixed inset-0 z-40 flex items-center justify-center bg-black/60 p-4"
+          onClick={() => setGalleryOpen(false)}
+        >
+          <div
+            className="w-full max-w-4xl max-h-[90vh] overflow-y-auto rounded-[14px] border border-white/[0.08] bg-bg shadow-[0_24px_64px_rgba(0,0,0,0.6)] p-6"
+            onClick={(e) => e.stopPropagation()}
+          >
+            <div className="flex items-center justify-between mb-4">
+              <div className="text-[15px] font-700 text-text">Mission templates</div>
+              <button onClick={() => setGalleryOpen(false)} className="text-text-3 text-[12px] hover:text-text">Close</button>
+            </div>
+            <MissionTemplateGallery
+              templates={templates}
+              onInstall={(t) => setInstallTemplate(t)}
+            />
+          </div>
+        </div>
+      )}
+
+      <MissionTemplateInstallDialog
+        template={installTemplate}
+        sessions={sessions}
+        onClose={() => setInstallTemplate(null)}
+        onInstall={handleInstallTemplate}
+      />
     </MainContent>
   )
 }

package/src/cli/index.js

@@ -817,6 +817,8 @@ const COMMAND_GROUPS = [
       cmd('reports', 'GET', '/missions/:id/reports', 'List mission reports'),
       cmd('report-now', 'POST', '/missions/:id/reports', 'Force-generate a mission report now'),
       cmd('events', 'GET', '/missions/:id/events', 'List mission events (use --query sinceAt=..., --query untilAt=...)'),
+      cmd('templates', 'GET', '/missions/templates', 'List built-in mission templates'),
+      cmd('instantiate', 'POST', '/missions/templates/:id/instantiate', 'Create a mission from a template', { expectsJsonBody: true }),
     ],
   },
   {

package/src/cli/spec.js

@@ -571,6 +571,8 @@ const COMMAND_GROUPS = {
       reports: { description: 'List mission reports', method: 'GET', path: '/missions/:id/reports', params: ['id'] },
       'report-now': { description: 'Force-generate a mission report now', method: 'POST', path: '/missions/:id/reports', params: ['id'] },
       events: { description: 'List mission events', method: 'GET', path: '/missions/:id/events', params: ['id'] },
+      templates: { description: 'List built-in mission templates', method: 'GET', path: '/missions/templates' },
+      instantiate: { description: 'Create a mission from a template', method: 'POST', path: '/missions/templates/:id/instantiate', params: ['id'], body: true },
     },
   },
 }

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

@@ -73,22 +73,24 @@ function ModelSwitcherInline({ session, agent }: { session: Session; agent: Agen
   const refreshSession = useAppStore((s) => s.refreshSession)
   const streaming = useChatStore((s) => s.streaming)
   const [expanded, setExpanded] = useState(false)
-  const [selectedProvider, setSelectedProvider] = useState(agent.provider)
+  const [selectedProvider, setSelectedProvider] = useState(session.provider || agent.provider)
   const [saving, setSaving] = useState(false)
 
   useEffect(() => {
     void loadProviders()
     void loadProviderConfigs()
   }, [loadProviderConfigs, loadProviders])
-  useEffect(() => { setSelectedProvider(agent.provider) }, [agent.provider])
+  // Sync selectedProvider when the session's provider changes (e.g. after a successful save)
+  useEffect(() => { setSelectedProvider(session.provider || agent.provider) }, [session.provider, agent.provider])
 
   const agentSelectableProviders = useMemo(
     () => buildAgentSelectableProviders(providers, providerConfigs),
     [providerConfigs, providers],
   )
   const currentProviderInfo = agentSelectableProviders.find((p) => p.id === selectedProvider)
-  const activeAgentProvider = agentSelectableProviders.find((p) => p.id === agent.provider)
-  const providerLabel = PROVIDER_LABELS[agent.provider] || activeAgentProvider?.name || agent.provider.replace(/-/g, ' ')
+  const activeSessionProvider = agentSelectableProviders.find((p) => p.id === (session.provider || agent.provider))
+  const effectiveProvider = session.provider || agent.provider
+  const providerLabel = PROVIDER_LABELS[effectiveProvider] || activeSessionProvider?.name || effectiveProvider.replace(/-/g, ' ')
 
   const handleModelChange = async (model: string) => {
     if (saving) return
@@ -117,7 +119,7 @@ function ModelSwitcherInline({ session, agent }: { session: Session; agent: Agen
           {providerLabel}
         </span>
         <span className="inline-flex max-w-[180px] items-center rounded-[8px] border border-white/[0.06] bg-white/[0.03] px-2 py-1 text-[10px] font-mono text-text-3/70 truncate group-hover:border-white/[0.1] group-hover:text-text-2 transition-colors">
-          {agent.model || 'Default model'}
+          {session.model || agent.model || 'Default model'}
         </span>
         <svg width="8" height="8" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2.5" strokeLinecap="round" className="text-text-3/30 group-hover:text-text-3/60 transition-colors ml-auto shrink-0">
           <polyline points="6 9 12 15 18 9" />
@@ -157,7 +159,7 @@ function ModelSwitcherInline({ session, agent }: { session: Session; agent: Agen
       {currentProviderInfo && (
         <ModelCombobox
           providerId={currentProviderInfo.id}
-          value={agent.model || currentProviderInfo.models[0] || ''}
+          value={session.model || agent.model || currentProviderInfo.models[0] || ''}
           onChange={(m) => void handleModelChange(m)}
           models={currentProviderInfo.models}
           defaultModels={currentProviderInfo.defaultModels}

package/src/components/missions/mission-template-gallery.tsx

@@ -0,0 +1,113 @@
+'use client'
+
+import { useMemo, useState } from 'react'
+import type { MissionTemplate, MissionTemplateCategory } from '@/types'
+
+const CATEGORY_LABELS: Record<MissionTemplateCategory, string> = {
+  research: 'Research',
+  communication: 'Communication',
+  monitoring: 'Monitoring',
+  productivity: 'Productivity',
+  support: 'Support',
+}
+
+interface Props {
+  templates: MissionTemplate[]
+  onInstall: (template: MissionTemplate) => void
+}
+
+export function MissionTemplateGallery({ templates, onInstall }: Props) {
+  const [category, setCategory] = useState<'all' | MissionTemplateCategory>('all')
+
+  const categories = useMemo(() => {
+    const seen = new Set<MissionTemplateCategory>()
+    for (const template of templates) seen.add(template.category)
+    return Array.from(seen)
+  }, [templates])
+
+  const filtered = useMemo(() => {
+    if (category === 'all') return templates
+    return templates.filter((t) => t.category === category)
+  }, [templates, category])
+
+  return (
+    <div className="flex flex-col gap-4">
+      <div>
+        <h2 className="text-[15px] font-700 text-text">Start from a template</h2>
+        <p className="text-[12px] text-text-3 mt-1">
+          Pre-wired goals, budgets, and report schedules. Tweak anything before you install.
+        </p>
+      </div>
+
+      <div className="flex flex-wrap gap-1.5">
+        <FilterChip active={category === 'all'} onClick={() => setCategory('all')} label="All" />
+        {categories.map((c) => (
+          <FilterChip
+            key={c}
+            active={category === c}
+            onClick={() => setCategory(c)}
+            label={CATEGORY_LABELS[c]}
+          />
+        ))}
+      </div>
+
+      <div className="grid gap-3 sm:grid-cols-2 lg:grid-cols-3">
+        {filtered.map((template) => (
+          <TemplateCard key={template.id} template={template} onInstall={() => onInstall(template)} />
+        ))}
+      </div>
+    </div>
+  )
+}
+
+function FilterChip({ active, onClick, label }: { active: boolean; onClick: () => void; label: string }) {
+  return (
+    <button
+      type="button"
+      onClick={onClick}
+      className={`text-[11px] font-600 px-2.5 py-1 rounded-full border transition-colors ${
+        active
+          ? 'border-emerald-500/40 bg-emerald-500/15 text-emerald-200'
+          : 'border-white/[0.08] bg-white/[0.02] text-text-3 hover:border-white/[0.16] hover:text-text'
+      }`}
+    >
+      {label}
+    </button>
+  )
+}
+
+function TemplateCard({ template, onInstall }: { template: MissionTemplate; onInstall: () => void }) {
+  return (
+    <button
+      type="button"
+      onClick={onInstall}
+      className="text-left group flex flex-col gap-3 rounded-[14px] border border-white/[0.06] bg-white/[0.02] px-4 py-4 transition-all hover:border-white/[0.16] hover:bg-white/[0.04]"
+    >
+      <div className="flex items-start gap-3">
+        <span className="text-[22px] leading-none" aria-hidden>{template.icon}</span>
+        <div className="flex-1 min-w-0">
+          <div className="text-[13px] font-700 text-text">{template.name}</div>
+          <div className="text-[10px] uppercase tracking-wide text-text-3/70 mt-0.5">
+            {CATEGORY_LABELS[template.category]}
+          </div>
+        </div>
+      </div>
+      <div className="text-[12px] text-text-3 leading-[1.55] line-clamp-3">{template.description}</div>
+      <div className="flex items-center justify-between mt-auto">
+        <div className="flex flex-wrap gap-1">
+          {template.tags.slice(0, 3).map((tag) => (
+            <span
+              key={tag}
+              className="text-[10px] text-text-3/70 px-1.5 py-0.5 rounded border border-white/[0.06] bg-white/[0.02]"
+            >
+              {tag}
+            </span>
+          ))}
+        </div>
+        <span className="text-[11px] font-600 text-emerald-300 group-hover:text-emerald-200">
+          Install →
+        </span>
+      </div>
+    </button>
+  )
+}