@swarmclawai/swarmclaw 1.5.53 → 1.5.54

package/README.md

@@ -399,13 +399,17 @@ Operational docs: https://swarmclaw.ai/docs/observability
 
 ## Releases
 
-### v1.5.53 Highlights
+### 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: switching a session's model now sticks in the UI** ([#50](https://github.com/swarmclawai/swarmclaw/pull/50)). 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.
+- **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
 
-Thanks to [@borislavnnikolov](https://github.com/borislavnnikolov) for the contribution.
+- **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
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmclawai/swarmclaw",
-  "version": "1.5.53",
+  "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/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>
+  )
+}

package/src/components/missions/mission-template-install-dialog.tsx

@@ -0,0 +1,278 @@
+'use client'
+
+import { useEffect, useMemo, useState } from 'react'
+import { HintTip } from '@/components/shared/hint-tip'
+import { AdvancedSettingsSection } from '@/components/shared/advanced-settings-section'
+import { inputClass } from '@/components/shared/form-styles'
+import type { MissionTemplate, Session } from '@/types'
+import { toast } from 'sonner'
+
+export interface InstantiateInput {
+  rootSessionId: string
+  overrides: {
+    title: string
+    goal: string
+    successCriteria: string[]
+    budget: {
+      maxUsd: number | null
+      maxTokens: number | null
+      maxWallclockSec: number | null
+      maxTurns: number | null
+    }
+    reportSchedule: { intervalSec: number; format: 'markdown'; enabled: boolean } | null
+  }
+}
+
+interface Props {
+  template: MissionTemplate | null
+  sessions: Session[]
+  onClose: () => void
+  onInstall: (template: MissionTemplate, input: InstantiateInput) => Promise<void>
+}
+
+function formatDuration(sec: number | null | undefined): string {
+  if (sec == null) return '-'
+  if (sec < 60) return `${sec}s`
+  if (sec < 3600) return `${Math.round(sec / 60)}m`
+  if (sec < 86_400) return `${Math.round(sec / 3600)}h`
+  return `${Math.round(sec / 86_400)}d`
+}
+
+function numOrNull(s: string): number | null {
+  const n = Number.parseFloat(s)
+  return Number.isFinite(n) && n > 0 ? n : null
+}
+
+export function MissionTemplateInstallDialog({ template, sessions, onClose, onInstall }: Props) {
+  const [title, setTitle] = useState('')
+  const [goal, setGoal] = useState('')
+  const [criteriaText, setCriteriaText] = useState('')
+  const [rootSessionId, setRootSessionId] = useState('')
+  const [advancedOpen, setAdvancedOpen] = useState(false)
+  const [maxUsd, setMaxUsd] = useState('')
+  const [maxTokens, setMaxTokens] = useState('')
+  const [maxWallclockSec, setMaxWallclockSec] = useState('')
+  const [maxTurns, setMaxTurns] = useState('')
+  const [reportsEnabled, setReportsEnabled] = useState(true)
+  const [reportIntervalMin, setReportIntervalMin] = useState('')
+  const [busy, setBusy] = useState(false)
+
+  useEffect(() => {
+    if (!template) return
+    setTitle(template.defaults.title)
+    setGoal(template.defaults.goal)
+    setCriteriaText(template.defaults.successCriteria.join('\n'))
+    setMaxUsd(template.defaults.budget.maxUsd != null ? String(template.defaults.budget.maxUsd) : '')
+    setMaxTokens(template.defaults.budget.maxTokens != null ? String(template.defaults.budget.maxTokens) : '')
+    setMaxWallclockSec(template.defaults.budget.maxWallclockSec != null ? String(template.defaults.budget.maxWallclockSec) : '')
+    setMaxTurns(template.defaults.budget.maxTurns != null ? String(template.defaults.budget.maxTurns) : '')
+    setReportsEnabled(template.defaults.reportSchedule?.enabled ?? false)
+    setReportIntervalMin(
+      template.defaults.reportSchedule?.intervalSec != null
+        ? String(Math.round(template.defaults.reportSchedule.intervalSec / 60))
+        : '60',
+    )
+    setAdvancedOpen(false)
+  }, [template])
+
+  useEffect(() => {
+    if (!rootSessionId && sessions.length > 0) setRootSessionId(sessions[0].id)
+  }, [sessions, rootSessionId])
+
+  const badges = useMemo(() => {
+    if (!template) return []
+    const out: string[] = []
+    if (template.defaults.budget.maxUsd != null) out.push(`$${template.defaults.budget.maxUsd} cap`)
+    if (template.defaults.budget.maxTurns != null) out.push(`${template.defaults.budget.maxTurns} turns`)
+    if (template.defaults.budget.maxWallclockSec != null) out.push(formatDuration(template.defaults.budget.maxWallclockSec))
+    if (template.defaults.reportSchedule) out.push(`Reports every ${formatDuration(template.defaults.reportSchedule.intervalSec)}`)
+    return out
+  }, [template])
+
+  if (!template) return null
+
+  const submit = async () => {
+    if (!rootSessionId) {
+      toast.error('Pick a session to drive this mission')
+      return
+    }
+    if (!title.trim() || !goal.trim()) {
+      toast.error('Title and goal are required')
+      return
+    }
+    setBusy(true)
+    try {
+      const successCriteria = criteriaText.split('\n').map((s) => s.trim()).filter(Boolean)
+      const intervalMin = numOrNull(reportIntervalMin) ?? 60
+      await onInstall(template, {
+        rootSessionId,
+        overrides: {
+          title: title.trim(),
+          goal: goal.trim(),
+          successCriteria,
+          budget: {
+            maxUsd: numOrNull(maxUsd),
+            maxTokens: numOrNull(maxTokens),
+            maxWallclockSec: numOrNull(maxWallclockSec),
+            maxTurns: numOrNull(maxTurns),
+          },
+          reportSchedule: reportsEnabled
+            ? { intervalSec: Math.round(intervalMin * 60), format: 'markdown', enabled: true }
+            : null,
+        },
+      })
+      onClose()
+    } catch (error) {
+      toast.error(`Install failed: ${error instanceof Error ? error.message : String(error)}`)
+    } finally {
+      setBusy(false)
+    }
+  }
+
+  return (
+    <div className="fixed inset-0 z-50 flex items-center justify-center bg-black/60 p-4" onClick={onClose}>
+      <div
+        className="w-full max-w-xl rounded-[14px] border border-white/[0.08] bg-bg shadow-[0_24px_64px_rgba(0,0,0,0.6)] p-5 max-h-[92vh] overflow-y-auto"
+        onClick={(e) => e.stopPropagation()}
+      >
+        <div className="flex items-start gap-3 mb-4">
+          <span className="text-[28px] leading-none" aria-hidden>{template.icon}</span>
+          <div className="min-w-0 flex-1">
+            <div className="text-[15px] font-700 text-text">{template.name}</div>
+            <div className="text-[12px] text-text-3 leading-[1.5] mt-1">{template.description}</div>
+            {badges.length > 0 && (
+              <div className="mt-2.5 flex flex-wrap gap-1.5">
+                {badges.map((badge) => (
+                  <span
+                    key={badge}
+                    className="text-[10px] font-600 px-1.5 py-0.5 rounded border border-white/[0.08] bg-white/[0.02] text-text-3"
+                  >
+                    {badge}
+                  </span>
+                ))}
+              </div>
+            )}
+          </div>
+        </div>
+
+        {template.setupNote && (
+          <div className="mb-4 text-[11px] text-amber-200/90 bg-amber-500/10 border border-amber-500/20 rounded-[10px] px-3 py-2 leading-[1.5]">
+            <span className="font-700">Setup: </span>
+            {template.setupNote}
+          </div>
+        )}
+
+        <div className="flex flex-col gap-3">
+          <label className="flex flex-col gap-1">
+            <span className="text-[11px] text-text-3">Title</span>
+            <input value={title} onChange={(e) => setTitle(e.target.value)} className={inputClass} />
+          </label>
+
+          <label className="flex flex-col gap-1">
+            <span className="text-[11px] text-text-3 inline-flex items-center gap-1">
+              Goal <HintTip text="The natural-language objective your team will work on." />
+            </span>
+            <textarea
+              value={goal}
+              onChange={(e) => setGoal(e.target.value)}
+              rows={4}
+              className={`${inputClass} resize-none`}
+            />
+          </label>
+
+          <label className="flex flex-col gap-1">
+            <span className="text-[11px] text-text-3 inline-flex items-center gap-1">
+              Root session <HintTip text="The session whose heartbeat drives this mission." />
+            </span>
+            <select value={rootSessionId} onChange={(e) => setRootSessionId(e.target.value)} className={inputClass}>
+              {sessions.length === 0 && <option value="">No sessions available. Create a chat first.</option>}
+              {sessions.map((s) => (
+                <option key={s.id} value={s.id}>
+                  {s.name || s.id}
+                </option>
+              ))}
+            </select>
+          </label>
+        </div>
+
+        <div className="mt-4">
+          <AdvancedSettingsSection
+            open={advancedOpen}
+            onToggle={() => setAdvancedOpen((o) => !o)}
+            summary="Budgets, criteria, reports"
+          >
+            <div className="flex flex-col gap-4">
+              <label className="flex flex-col gap-1">
+                <span className="text-[11px] text-text-3 inline-flex items-center gap-1">
+                  Success criteria <HintTip text="One per line. Used in reports and final verification." />
+                </span>
+                <textarea
+                  value={criteriaText}
+                  onChange={(e) => setCriteriaText(e.target.value)}
+                  rows={4}
+                  className={`${inputClass} resize-none`}
+                />
+              </label>
+
+              <div className="grid grid-cols-2 gap-3">
+                <label className="flex flex-col gap-1">
+                  <span className="text-[11px] text-text-3 inline-flex items-center gap-1">
+                    Max USD <HintTip text="Hard spend cap. Leave blank for no limit." />
+                  </span>
+                  <input value={maxUsd} onChange={(e) => setMaxUsd(e.target.value)} className={inputClass} inputMode="decimal" />
+                </label>
+                <label className="flex flex-col gap-1">
+                  <span className="text-[11px] text-text-3">Max tokens</span>
+                  <input value={maxTokens} onChange={(e) => setMaxTokens(e.target.value)} className={inputClass} inputMode="numeric" />
+                </label>
+                <label className="flex flex-col gap-1">
+                  <span className="text-[11px] text-text-3 inline-flex items-center gap-1">
+                    Max wallclock (sec) <HintTip text="Scheduler aborts after this many seconds of elapsed wallclock." />
+                  </span>
+                  <input value={maxWallclockSec} onChange={(e) => setMaxWallclockSec(e.target.value)} className={inputClass} inputMode="numeric" />
+                </label>
+                <label className="flex flex-col gap-1">
+                  <span className="text-[11px] text-text-3">Max turns</span>
+                  <input value={maxTurns} onChange={(e) => setMaxTurns(e.target.value)} className={inputClass} inputMode="numeric" />
+                </label>
+              </div>
+
+              <div className="rounded-[10px] border border-white/[0.06] bg-white/[0.02] px-3 py-2.5">
+                <div className="text-[11px] font-600 text-text-3 uppercase tracking-wide mb-1.5">Periodic reports</div>
+                <label className="flex items-center gap-2 flex-wrap">
+                  <input type="checkbox" checked={reportsEnabled} onChange={(e) => setReportsEnabled(e.target.checked)} />
+                  <span className="text-[11px] text-text-3">Send a markdown progress report every</span>
+                  <input
+                    disabled={!reportsEnabled}
+                    value={reportIntervalMin}
+                    onChange={(e) => setReportIntervalMin(e.target.value)}
+                    className={`${inputClass} w-16`}
+                    inputMode="numeric"
+                  />
+                  <span className="text-[11px] text-text-3">minutes</span>
+                </label>
+              </div>
+            </div>
+          </AdvancedSettingsSection>
+        </div>
+
+        <div className="mt-5 flex items-center justify-end gap-2">
+          <button
+            onClick={onClose}
+            className="text-[12px] px-3 py-1.5 rounded border border-white/[0.08] hover:bg-white/[0.04]"
+            disabled={busy}
+          >
+            Cancel
+          </button>
+          <button
+            onClick={submit}
+            disabled={busy}
+            className="text-[12px] font-600 px-3 py-1.5 rounded bg-emerald-500/20 text-emerald-300 border border-emerald-500/30 hover:bg-emerald-500/25 disabled:opacity-40"
+          >
+            {busy ? 'Installing…' : 'Install mission'}
+          </button>
+        </div>
+      </div>
+    </div>
+  )
+}

package/src/lib/server/chat-execution/chat-turn-preparation.ts

@@ -208,19 +208,24 @@ function syncSessionFromAgent(sessionId: string): void {
   }
   if (route) {
     const resolved = applyResolvedRoute({ ...session }, route)
-    if (session.provider !== resolved.provider) { session.provider = resolved.provider; changed = true }
-    if (session.model !== resolved.model) { session.model = resolved.model; changed = true }
-    if ((session.credentialId || null) !== (resolved.credentialId || null)) {
-      session.credentialId = resolved.credentialId ?? null
-      changed = true
-    }
-    if (JSON.stringify(session.fallbackCredentialIds || []) !== JSON.stringify(resolved.fallbackCredentialIds || [])) {
-      session.fallbackCredentialIds = [...(resolved.fallbackCredentialIds || [])]
-      changed = true
-    }
-    if ((session.apiEndpoint || null) !== (resolved.apiEndpoint || null)) {
-      session.apiEndpoint = resolved.apiEndpoint ?? null
-      changed = true
+    // Do NOT sync provider/model from the route here — the user may have manually
+    // switched the session model, and we must preserve that choice.
+    // Provider/model are initialized from the route at session-creation time only.
+    // Only sync credentials/endpoint when the session's provider still matches the
+    // route's provider — if the user switched providers, leave their credential alone.
+    if (session.provider === resolved.provider) {
+      if ((session.credentialId || null) !== (resolved.credentialId || null)) {
+        session.credentialId = resolved.credentialId ?? null
+        changed = true
+      }
+      if (JSON.stringify(session.fallbackCredentialIds || []) !== JSON.stringify(resolved.fallbackCredentialIds || [])) {
+        session.fallbackCredentialIds = [...(resolved.fallbackCredentialIds || [])]
+        changed = true
+      }
+      if ((session.apiEndpoint || null) !== (resolved.apiEndpoint || null)) {
+        session.apiEndpoint = resolved.apiEndpoint ?? null
+        changed = true
+      }
     }
     if ((session.gatewayProfileId || null) !== (resolved.gatewayProfileId || null)) {
       session.gatewayProfileId = resolved.gatewayProfileId ?? null
@@ -624,9 +629,15 @@ export async function prepareChatTurn(input: ExecuteChatTurnInput): Promise<Prep
       preferredGatewayTags: session.routePreferredGatewayTags || [],
       preferredGatewayUseCase: session.routePreferredGatewayUseCase || null,
     })
-    if (preferredRoute) {
+    if (preferredRoute && sessionForRun.provider === preferredRoute.provider) {
+      // Apply route for credentials/endpoint/gateway, but preserve the user's
+      // manually-selected model — only sync infra, not the model choice.
+      const savedModel = sessionForRun.model
       sessionForRun = applyResolvedRoute({ ...sessionForRun }, preferredRoute)
+      sessionForRun = { ...sessionForRun, model: savedModel }
     }
+    // If the user has manually switched to a different provider, skip the route
+    // entirely — the session already has the correct provider/model/credential.
   }
   let effectiveMessage = message
 

package/src/lib/server/chats/chat-session-service.ts

@@ -7,6 +7,7 @@ import { buildAgentDisabledMessage, isAgentDisabled } from '@/lib/server/agents/
 import { loadAgent } from '@/lib/server/agents/agent-repository'
 import { clearMainLoopStateForSession } from '@/lib/server/agents/main-agent-loop'
 import { applyResolvedRoute, resolvePrimaryAgentRoute } from '@/lib/server/agents/agent-runtime-config'
+import { loadCredentials } from '@/lib/server/credentials/credential-repository'
 import { cleanupSessionProcesses } from '@/lib/server/runtime/process-manager'
 import { stopActiveSessionProcess } from '@/lib/server/runtime/runtime-state'
 import {
@@ -235,6 +236,13 @@ export function updateChatSession(sessionId: string, updates: Record<string, unk
   if (updates.credentialId !== undefined) session.credentialId = updates.credentialId
   else if (agentIdUpdateProvided && linkedRoute) session.credentialId = linkedRoute.credentialId ?? null
   else if (agentIdUpdateProvided && linkedAgent) session.credentialId = linkedAgent.credentialId ?? null
+  else if (updates.provider !== undefined && updates.provider !== session.provider) {
+    // Provider changed without an explicit credentialId — find a stored credential
+    // for the new provider so API-key-based providers (Groq, OpenAI, …) work.
+    const allCreds = loadCredentials()
+    const providerCred = Object.values(allCreds).find(c => c.provider === updates.provider)
+    session.credentialId = providerCred?.id ?? null
+  }
   if (updates.fallbackCredentialIds !== undefined) session.fallbackCredentialIds = updates.fallbackCredentialIds
   else if (agentIdUpdateProvided && linkedRoute) session.fallbackCredentialIds = [...linkedRoute.fallbackCredentialIds]
   if (updates.gatewayProfileId !== undefined) session.gatewayProfileId = updates.gatewayProfileId
@@ -264,6 +272,9 @@ export function updateChatSession(sessionId: string, updates: Record<string, unk
     session.apiEndpoint = linkedRoute.apiEndpoint ?? null
   } else if (agentIdUpdateProvided && linkedAgent) {
     session.apiEndpoint = normalizeProviderEndpoint(linkedAgent.provider, linkedAgent.apiEndpoint ?? null)
+  } else if (updates.provider !== undefined && updates.provider !== session.provider) {
+    // Provider changed — clear stale endpoint so the new provider uses its own default.
+    session.apiEndpoint = null
   }
   if (updates.heartbeatEnabled !== undefined) session.heartbeatEnabled = updates.heartbeatEnabled
   if (updates.heartbeatIntervalSec !== undefined) session.heartbeatIntervalSec = updates.heartbeatIntervalSec

package/src/lib/server/missions/mission-service.ts

@@ -1,5 +1,5 @@
 import crypto from 'crypto'
-import type { Mission, MissionBudget, MissionReportSchedule, MissionStatus } from '@/types'
+import type { Mission, MissionBudget, MissionReportSchedule, MissionStatus, MissionTemplate } from '@/types'
 import { DEFAULT_MISSION_WARN_FRACTIONS } from '@/types'
 import { hmrSingleton } from '@/lib/shared-utils'
 import { log } from '@/lib/server/logger'
@@ -11,6 +11,7 @@ import {
   patchMission,
   upsertMission,
 } from './mission-repository'
+import { getMissionTemplate } from './mission-templates'
 
 const TAG = 'mission-service'
 
@@ -59,6 +60,7 @@ export interface CreateMissionInput {
   budget?: Partial<MissionBudget>
   reportSchedule?: MissionReportSchedule | null
   reportConnectorIds?: string[]
+  templateId?: string | null
 }
 
 function newMissionId(): string {
@@ -82,6 +84,9 @@ function sanitizeBudget(input: Partial<MissionBudget> = {}): MissionBudget {
 
 export function createMission(input: CreateMissionInput): Mission {
   const now = Date.now()
+  const templateId = typeof input.templateId === 'string' && input.templateId.trim()
+    ? input.templateId.trim().slice(0, 64)
+    : null
   const mission: Mission = {
     id: newMissionId(),
     title: input.title.trim(),
@@ -106,12 +111,53 @@ export function createMission(input: CreateMissionInput): Mission {
     reportConnectorIds: input.reportConnectorIds ?? [],
     createdAt: now,
     updatedAt: now,
+    templateId,
   }
   upsertMission(mission)
   log.info(TAG, `Created mission ${mission.id} (goal: ${mission.goal.slice(0, 80)})`)
   return mission
 }
 
+export interface CreateMissionFromTemplateInput {
+  templateId: string
+  rootSessionId: string
+  overrides?: {
+    title?: string
+    goal?: string
+    successCriteria?: string[]
+    budget?: Partial<MissionBudget>
+    reportSchedule?: MissionReportSchedule | null
+    agentIds?: string[]
+    reportConnectorIds?: string[]
+  }
+}
+
+export interface CreateMissionFromTemplateResult {
+  mission: Mission
+  template: MissionTemplate
+}
+
+export function createMissionFromTemplate(input: CreateMissionFromTemplateInput): CreateMissionFromTemplateResult | null {
+  const template = getMissionTemplate(input.templateId)
+  if (!template) return null
+  const overrides = input.overrides ?? {}
+  const mergedBudget: Partial<MissionBudget> = { ...template.defaults.budget, ...(overrides.budget ?? {}) }
+  const mission = createMission({
+    title: overrides.title?.trim() || template.defaults.title,
+    goal: overrides.goal?.trim() || template.defaults.goal,
+    successCriteria: overrides.successCriteria ?? template.defaults.successCriteria,
+    rootSessionId: input.rootSessionId,
+    agentIds: overrides.agentIds ?? [],
+    budget: mergedBudget,
+    reportSchedule: overrides.reportSchedule === undefined
+      ? template.defaults.reportSchedule
+      : overrides.reportSchedule,
+    reportConnectorIds: overrides.reportConnectorIds ?? [],
+    templateId: template.id,
+  })
+  return { mission, template }
+}
+
 function applyStatusTransition(
   id: string,
   next: MissionStatus,

package/src/lib/server/missions/mission-templates.test.ts

@@ -0,0 +1,208 @@
+import assert from 'node:assert/strict'
+import fs from 'node:fs'
+import os from 'node:os'
+import path from 'node:path'
+import { after, before, describe, it } from 'node:test'
+
+const originalEnv = {
+  DATA_DIR: process.env.DATA_DIR,
+  WORKSPACE_DIR: process.env.WORKSPACE_DIR,
+  SWARMCLAW_BUILD_MODE: process.env.SWARMCLAW_BUILD_MODE,
+}
+
+let tempDir = ''
+let templates: typeof import('./mission-templates')
+let service: typeof import('./mission-service')
+
+before(async () => {
+  tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'swarmclaw-mission-tpl-'))
+  process.env.DATA_DIR = path.join(tempDir, 'data')
+  process.env.WORKSPACE_DIR = path.join(tempDir, 'workspace')
+  process.env.SWARMCLAW_BUILD_MODE = '1'
+  templates = await import('./mission-templates')
+  service = await import('./mission-service')
+})
+
+after(() => {
+  if (originalEnv.DATA_DIR === undefined) delete process.env.DATA_DIR
+  else process.env.DATA_DIR = originalEnv.DATA_DIR
+  if (originalEnv.WORKSPACE_DIR === undefined) delete process.env.WORKSPACE_DIR
+  else process.env.WORKSPACE_DIR = originalEnv.WORKSPACE_DIR
+  if (originalEnv.SWARMCLAW_BUILD_MODE === undefined) delete process.env.SWARMCLAW_BUILD_MODE
+  else process.env.SWARMCLAW_BUILD_MODE = originalEnv.SWARMCLAW_BUILD_MODE
+  fs.rmSync(tempDir, { recursive: true, force: true })
+})
+
+describe('mission-templates: registry', () => {
+  it('ships at least 6 built-in templates', () => {
+    const list = templates.listMissionTemplates()
+    assert.ok(list.length >= 6, `expected 6+ templates, got ${list.length}`)
+  })
+
+  it('has no duplicate template ids', () => {
+    const list = templates.listMissionTemplates()
+    const ids = new Set<string>()
+    for (const t of list) {
+      assert.ok(!ids.has(t.id), `duplicate template id: ${t.id}`)
+      ids.add(t.id)
+    }
+  })
+
+  it('every template has required fields populated', () => {
+    const list = templates.listMissionTemplates()
+    for (const t of list) {
+      assert.ok(t.id, `missing id`)
+      assert.ok(t.name, `${t.id} missing name`)
+      assert.ok(t.description, `${t.id} missing description`)
+      assert.ok(t.icon, `${t.id} missing icon`)
+      assert.ok(t.category, `${t.id} missing category`)
+      assert.ok(Array.isArray(t.tags), `${t.id} tags not array`)
+      assert.ok(t.defaults.title, `${t.id} missing defaults.title`)
+      assert.ok(t.defaults.goal, `${t.id} missing defaults.goal`)
+      assert.ok(Array.isArray(t.defaults.successCriteria), `${t.id} successCriteria not array`)
+      assert.ok(t.defaults.budget, `${t.id} missing budget`)
+      assert.ok(Array.isArray(t.defaults.budget.warnAtFractions), `${t.id} budget.warnAtFractions missing`)
+    }
+  })
+
+  it('getMissionTemplate resolves known ids', () => {
+    const list = templates.listMissionTemplates()
+    const first = list[0]
+    const resolved = templates.getMissionTemplate(first.id)
+    assert.equal(resolved?.id, first.id)
+  })
+
+  it('getMissionTemplate returns null for unknown ids', () => {
+    assert.equal(templates.getMissionTemplate('nope-does-not-exist'), null)
+    assert.equal(templates.getMissionTemplate(''), null)
+    assert.equal(templates.getMissionTemplate(null), null)
+    assert.equal(templates.getMissionTemplate(undefined), null)
+  })
+})
+
+describe('mission-service: createMissionFromTemplate', () => {
+  it('materializes a mission using template defaults', () => {
+    const list = templates.listMissionTemplates()
+    const tpl = list[0]
+    const result = service.createMissionFromTemplate({
+      templateId: tpl.id,
+      rootSessionId: 'sess_test_1',
+    })
+    assert.ok(result, 'expected result')
+    assert.equal(result!.mission.templateId, tpl.id)
+    assert.equal(result!.mission.goal, tpl.defaults.goal)
+    assert.equal(result!.mission.title, tpl.defaults.title)
+    assert.equal(result!.mission.rootSessionId, 'sess_test_1')
+    assert.deepEqual(result!.mission.successCriteria, tpl.defaults.successCriteria)
+    assert.equal(result!.template.id, tpl.id)
+  })
+
+  it('applies overrides without dropping unspecified defaults', () => {
+    const tpl = templates.listMissionTemplates()[0]
+    const result = service.createMissionFromTemplate({
+      templateId: tpl.id,
+      rootSessionId: 'sess_test_2',
+      overrides: {
+        title: 'Custom title',
+        budget: { maxUsd: 99 },
+      },
+    })
+    assert.ok(result)
+    assert.equal(result!.mission.title, 'Custom title')
+    assert.equal(result!.mission.budget.maxUsd, 99)
+    // Token cap from template should persist when not overridden
+    assert.equal(result!.mission.budget.maxTokens, tpl.defaults.budget.maxTokens)
+    // Goal unchanged
+    assert.equal(result!.mission.goal, tpl.defaults.goal)
+  })
+
+  it('returns null for unknown template id', () => {
+    const result = service.createMissionFromTemplate({
+      templateId: 'no-such-template',
+      rootSessionId: 'sess_test_3',
+    })
+    assert.equal(result, null)
+  })
+
+  it('allows overriding reportSchedule to null', () => {
+    const tpl = templates.listMissionTemplates()[0]
+    const result = service.createMissionFromTemplate({
+      templateId: tpl.id,
+      rootSessionId: 'sess_test_4',
+      overrides: { reportSchedule: null },
+    })
+    assert.ok(result)
+    assert.equal(result!.mission.reportSchedule, null)
+  })
+})
+
+describe('mission-service: templateId persistence', () => {
+  it('createMission persists an explicit templateId', () => {
+    const mission = service.createMission({
+      title: 'Direct',
+      goal: 'no template',
+      rootSessionId: 'sess_direct',
+      templateId: 'some-template-id',
+    })
+    assert.equal(mission.templateId, 'some-template-id')
+  })
+
+  it('createMission defaults templateId to null when omitted', () => {
+    const mission = service.createMission({
+      title: 'Direct',
+      goal: 'no template',
+      rootSessionId: 'sess_direct_2',
+    })
+    assert.equal(mission.templateId, null)
+  })
+})
+
+// Normalization test: legacy mission JSON without templateId should get templateId: null after load.
+describe('mission normalization: templateId default', () => {
+  const loadItem = () => null
+
+  it('legacy records normalize to templateId: null', async () => {
+    const { normalizeStoredRecord } = await import('@/lib/server/storage-normalization')
+    const legacy: Record<string, unknown> = {
+      id: 'mi_legacy_1',
+      title: 'Legacy',
+      goal: 'from before templates',
+      successCriteria: [],
+      rootSessionId: 'sess_legacy',
+      agentIds: [],
+      status: 'draft',
+      budget: {},
+      usage: {},
+      milestones: [],
+      reportConnectorIds: [],
+      createdAt: Date.now(),
+      updatedAt: Date.now(),
+    }
+    const { value } = normalizeStoredRecord('agent_missions', legacy, loadItem)
+    const normalized = value as { templateId: unknown }
+    assert.equal(normalized.templateId, null)
+  })
+
+  it('normalization preserves a valid templateId', async () => {
+    const { normalizeStoredRecord } = await import('@/lib/server/storage-normalization')
+    const record: Record<string, unknown> = {
+      id: 'mi_tpl_1',
+      title: 'From template',
+      goal: 'x',
+      successCriteria: [],
+      rootSessionId: 'sess_tpl',
+      agentIds: [],
+      status: 'draft',
+      budget: {},
+      usage: {},
+      milestones: [],
+      reportConnectorIds: [],
+      createdAt: Date.now(),
+      updatedAt: Date.now(),
+      templateId: 'daily-news-digest',
+    }
+    const { value } = normalizeStoredRecord('agent_missions', record, loadItem)
+    const normalized = value as { templateId: unknown }
+    assert.equal(normalized.templateId, 'daily-news-digest')
+  })
+})

package/src/lib/server/missions/mission-templates.ts

@@ -0,0 +1,186 @@
+import type {
+  MissionBudget,
+  MissionReportSchedule,
+  MissionTemplate,
+  MissionTemplateCategory,
+} from '@/types'
+import { DEFAULT_MISSION_WARN_FRACTIONS } from '@/types'
+
+const HOUR = 3600
+const DAY = 86_400
+
+function budget(overrides: Partial<MissionBudget>): MissionBudget {
+  return {
+    maxUsd: null,
+    maxTokens: null,
+    maxToolCalls: null,
+    maxWallclockSec: null,
+    maxTurns: null,
+    warnAtFractions: DEFAULT_MISSION_WARN_FRACTIONS,
+    ...overrides,
+  }
+}
+
+function report(intervalSec: number, format: MissionReportSchedule['format'] = 'markdown'): MissionReportSchedule {
+  return { intervalSec, format, enabled: true, lastReportAt: null }
+}
+
+export const BUILT_IN_MISSION_TEMPLATES: MissionTemplate[] = [
+  {
+    id: 'daily-news-digest',
+    name: 'Daily News Digest',
+    description:
+      'Scan news sources, pick the 5 most relevant stories for your interests, and write a short digest once a day.',
+    icon: '📰',
+    category: 'research',
+    tags: ['daily', 'news', 'summary'],
+    setupNote:
+      'Edit the goal to list your interests and sources before starting (e.g., "AI infrastructure, open-source agents, Bloomberg / Hacker News").',
+    defaults: {
+      title: 'Daily News Digest',
+      goal:
+        'Every day, scan the latest news from my sources of interest, pick the 5 most relevant stories, and write a short markdown digest with title, 2-sentence summary, and link for each.',
+      successCriteria: [
+        'Exactly 5 stories per digest',
+        'Each story has a title, summary, and source link',
+        'Digest is less than 500 words',
+      ],
+      budget: budget({ maxUsd: 1, maxTokens: 40_000, maxTurns: 80, maxWallclockSec: 2 * HOUR }),
+      reportSchedule: report(DAY),
+    },
+  },
+  {
+    id: 'inbox-triage',
+    name: 'Inbox Triage',
+    description:
+      'Classify new emails, draft replies to routine threads, and flag anything that needs your attention.',
+    icon: '📬',
+    category: 'communication',
+    tags: ['email', 'triage', 'automation'],
+    setupNote:
+      'Connect your email connector and confirm send/reply permissions before starting this mission.',
+    defaults: {
+      title: 'Inbox Triage',
+      goal:
+        'Every hour, pull new emails, classify each as routine / needs-reply / urgent, draft replies to routine threads for my approval, and surface urgent items to me immediately.',
+      successCriteria: [
+        'Every new email is classified',
+        'Routine replies are drafted, not sent without approval',
+        'Urgent items are flagged within the same hour they arrive',
+      ],
+      budget: budget({ maxUsd: 3, maxTokens: 120_000, maxTurns: 200, maxWallclockSec: 12 * HOUR }),
+      reportSchedule: report(6 * HOUR),
+    },
+  },
+  {
+    id: 'competitor-watch',
+    name: 'Competitor Watch',
+    description:
+      'Track competitor websites, blogs, and releases; flag anything new and write a weekly summary.',
+    icon: '🔭',
+    category: 'monitoring',
+    tags: ['competitive', 'weekly', 'monitoring'],
+    setupNote:
+      'List the competitors and specific URLs to watch in the goal field before starting.',
+    defaults: {
+      title: 'Competitor Watch',
+      goal:
+        'Check the listed competitors every 6 hours for product releases, pricing changes, blog posts, and notable social activity. Write a short summary of new signals and compile a weekly roll-up.',
+      successCriteria: [
+        'All listed competitors are checked every cycle',
+        'New signals are captured with source links and timestamps',
+        'A weekly roll-up is produced on Monday mornings',
+      ],
+      budget: budget({ maxUsd: 5, maxTokens: 200_000, maxTurns: 300, maxWallclockSec: 7 * DAY }),
+      reportSchedule: report(DAY),
+    },
+  },
+  {
+    id: 'weekly-research-report',
+    name: 'Weekly Research Report',
+    description:
+      'Pick a research topic each Monday, dig into it across the week, and deliver a polished report by Friday.',
+    icon: '🧠',
+    category: 'research',
+    tags: ['weekly', 'research', 'report'],
+    setupNote:
+      'Set the topic in the goal (or let the agent pick from a rotating list).',
+    defaults: {
+      title: 'Weekly Research Report',
+      goal:
+        'Produce a 1000-2000 word research report on the assigned topic. Gather at least 8 sources, compare viewpoints, surface open questions, and deliver a polished markdown document by end of week.',
+      successCriteria: [
+        'Report is between 1000 and 2000 words',
+        'At least 8 distinct sources are cited with links',
+        'Conclusion explicitly lists open questions or areas for follow-up',
+      ],
+      budget: budget({ maxUsd: 4, maxTokens: 250_000, maxTurns: 250, maxWallclockSec: 7 * DAY }),
+      reportSchedule: report(2 * DAY),
+    },
+  },
+  {
+    id: 'social-listener',
+    name: 'Social Listener',
+    description:
+      'Watch configured channels for mentions of your brand, keywords, or topics and surface notable threads.',
+    icon: '👂',
+    category: 'monitoring',
+    tags: ['social', 'listening', 'realtime'],
+    setupNote:
+      'Connect Discord or Slack (or both) and list the keywords to watch for in the goal.',
+    defaults: {
+      title: 'Social Listener',
+      goal:
+        'Watch the connected channels for the configured keywords. When a match appears, capture the message, author, timestamp, and a 1-sentence context note. Summarize daily.',
+      successCriteria: [
+        'Every keyword match is captured with context',
+        'No duplicate alerts for the same message',
+        'A daily recap is produced listing the top 10 mentions',
+      ],
+      budget: budget({ maxUsd: 2, maxTokens: 100_000, maxTurns: 400, maxWallclockSec: 7 * DAY }),
+      reportSchedule: report(DAY),
+    },
+  },
+  {
+    id: 'customer-support-triage',
+    name: 'Customer Support Triage',
+    description:
+      'Classify incoming support tickets, draft first responses, and route complex issues to a human.',
+    icon: '🛟',
+    category: 'support',
+    tags: ['support', 'triage', 'drafts'],
+    setupNote:
+      'Connect your helpdesk or email connector and confirm draft-only permissions before starting.',
+    defaults: {
+      title: 'Customer Support Triage',
+      goal:
+        'For each new support ticket, classify priority and category, draft a first response for human review, and flag tickets that require engineering or account-level escalation.',
+      successCriteria: [
+        'Every ticket receives a draft within one hour',
+        'Priority and category are labeled consistently',
+        'Escalations are clearly flagged with a reason',
+      ],
+      budget: budget({ maxUsd: 3, maxTokens: 150_000, maxTurns: 300, maxWallclockSec: 3 * DAY }),
+      reportSchedule: report(12 * HOUR),
+    },
+  },
+]
+
+const TEMPLATE_INDEX: Map<string, MissionTemplate> = new Map(
+  BUILT_IN_MISSION_TEMPLATES.map((template) => [template.id, template]),
+)
+
+export function listMissionTemplates(): MissionTemplate[] {
+  return BUILT_IN_MISSION_TEMPLATES.slice()
+}
+
+export function getMissionTemplate(id: string | null | undefined): MissionTemplate | null {
+  if (!id || typeof id !== 'string') return null
+  return TEMPLATE_INDEX.get(id.trim()) ?? null
+}
+
+export function listMissionTemplateCategories(): MissionTemplateCategory[] {
+  const seen = new Set<MissionTemplateCategory>()
+  for (const template of BUILT_IN_MISSION_TEMPLATES) seen.add(template.category)
+  return Array.from(seen)
+}

package/src/lib/server/storage-normalization.ts

@@ -458,6 +458,12 @@ function normalizeStoredAgentMissionRecord(value: unknown): unknown {
   if (mission.endedAt === undefined) mission.endedAt = null
   if (mission.endReason === undefined) mission.endReason = null
 
+  if (typeof mission.templateId === 'string' && mission.templateId.trim()) {
+    mission.templateId = mission.templateId.trim().slice(0, 64)
+  } else {
+    mission.templateId = null
+  }
+
   return mission
 }
 

package/src/types/mission.ts

@@ -109,7 +109,34 @@ export interface Mission {
   startedAt?: number | null
   endedAt?: number | null
   endReason?: string | null
+  templateId?: string | null
 }
 
 export const DEFAULT_MISSION_WARN_FRACTIONS = [0.5, 0.8, 0.95]
 export const MISSION_MILESTONE_TAIL_CAP = 200
+
+export type MissionTemplateCategory =
+  | 'research'
+  | 'communication'
+  | 'monitoring'
+  | 'productivity'
+  | 'support'
+
+export interface MissionTemplateDefaults {
+  title: string
+  goal: string
+  successCriteria: string[]
+  budget: MissionBudget
+  reportSchedule: MissionReportSchedule | null
+}
+
+export interface MissionTemplate {
+  id: string
+  name: string
+  description: string
+  icon: string
+  category: MissionTemplateCategory
+  tags: string[]
+  setupNote?: string | null
+  defaults: MissionTemplateDefaults
+}