@swarmclawai/swarmclaw 0.3.1 → 0.4.5

package/src/app/api/skills/[id]/route.ts

@@ -1,40 +1,42 @@
 import { NextResponse } from 'next/server'
 import { loadSkills, saveSkills, deleteSkill } from '@/lib/server/storage'
 import { normalizeSkillPayload } from '@/lib/server/skills-normalize'
+import { mutateItem, deleteItem, notFound, type CollectionOps } from '@/lib/server/collection-helpers'
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const ops: CollectionOps<any> = { load: loadSkills, save: saveSkills, deleteFn: deleteSkill }
 
 export async function GET(_req: Request, { params }: { params: Promise<{ id: string }> }) {
   const { id } = await params
   const skills = loadSkills()
-  if (!skills[id]) return new NextResponse(null, { status: 404 })
+  if (!skills[id]) return notFound()
   return NextResponse.json(skills[id])
 }
 
 export async function PUT(req: Request, { params }: { params: Promise<{ id: string }> }) {
   const { id } = await params
   const body = await req.json()
-  const skills = loadSkills()
-  if (!skills[id]) return new NextResponse(null, { status: 404 })
-  const normalized = normalizeSkillPayload({ ...skills[id], ...body })
-  skills[id] = {
-    ...skills[id],
-    ...body,
-    name: normalized.name,
-    filename: normalized.filename,
-    description: normalized.description,
-    content: normalized.content,
-    sourceUrl: normalized.sourceUrl,
-    sourceFormat: normalized.sourceFormat,
-    id,
-    updatedAt: Date.now(),
-  }
-  saveSkills(skills)
-  return NextResponse.json(skills[id])
+  const result = mutateItem(ops, id, (skill) => {
+    const normalized = normalizeSkillPayload({ ...skill, ...body })
+    return {
+      ...skill,
+      ...body,
+      name: normalized.name,
+      filename: normalized.filename,
+      description: normalized.description,
+      content: normalized.content,
+      sourceUrl: normalized.sourceUrl,
+      sourceFormat: normalized.sourceFormat,
+      id,
+      updatedAt: Date.now(),
+    }
+  })
+  if (!result) return notFound()
+  return NextResponse.json(result)
 }
 
 export async function DELETE(_req: Request, { params }: { params: Promise<{ id: string }> }) {
   const { id } = await params
-  const skills = loadSkills()
-  if (!skills[id]) return new NextResponse(null, { status: 404 })
-  deleteSkill(id)
+  if (!deleteItem(ops, id)) return notFound()
   return NextResponse.json({ deleted: id })
 }

package/src/app/api/skills/import/route.ts

@@ -1,4 +1,4 @@
-import crypto from 'crypto'
+import { genId } from '@/lib/id'
 import { NextResponse } from 'next/server'
 import { loadSkills, saveSkills } from '@/lib/server/storage'
 import { normalizeSkillPayload } from '@/lib/server/skills-normalize'
@@ -47,7 +47,7 @@ export async function POST(req: Request) {
     })
 
     const skills = loadSkills()
-    const id = crypto.randomBytes(4).toString('hex')
+    const id = genId()
     skills[id] = {
       id,
       name: normalized.name,

package/src/app/api/skills/route.ts

@@ -1,16 +1,18 @@
 import { NextResponse } from 'next/server'
-import crypto from 'crypto'
+import { genId } from '@/lib/id'
 import { loadSkills, saveSkills } from '@/lib/server/storage'
 import { normalizeSkillPayload } from '@/lib/server/skills-normalize'
+export const dynamic = 'force-dynamic'
 
-export async function GET() {
+
+export async function GET(_req: Request) {
   return NextResponse.json(loadSkills())
 }
 
 export async function POST(req: Request) {
   const body = await req.json()
   const skills = loadSkills()
-  const id = crypto.randomBytes(4).toString('hex')
+  const id = genId()
   const normalized = normalizeSkillPayload(body)
   skills[id] = {
     id,

package/src/app/api/tasks/[id]/approve/route.ts

@@ -0,0 +1,74 @@
+import { NextResponse } from 'next/server'
+import { loadTasks, saveTasks, loadAgents } from '@/lib/server/storage'
+import { notFound } from '@/lib/server/collection-helpers'
+import { notify } from '@/lib/server/ws-hub'
+import { getCheckpointSaver } from '@/lib/server/langgraph-checkpoint'
+
+export async function POST(req: Request, { params }: { params: Promise<{ id: string }> }) {
+  const { id } = await params
+  const body = await req.json()
+  const approved = body.approved === true
+
+  const tasks = loadTasks()
+  const task = tasks[id]
+  if (!task) return notFound()
+  if (!task.pendingApproval) {
+    return NextResponse.json({ error: 'No pending approval on this task' }, { status: 400 })
+  }
+
+  const { threadId } = task.pendingApproval
+
+  if (!approved) {
+    // Reject: clear approval, delete checkpoint, fail the task
+    task.pendingApproval = null
+    task.status = 'failed'
+    task.error = 'Tool execution rejected by user'
+    task.updatedAt = Date.now()
+    saveTasks(tasks)
+    await getCheckpointSaver().deleteThread(threadId)
+    notify('tasks')
+    return NextResponse.json({ status: 'rejected' })
+  }
+
+  // Approve: clear pendingApproval, resume the graph
+  const agents = loadAgents()
+  const agent = agents[task.agentId]
+  if (!agent) {
+    return NextResponse.json({ error: 'Agent not found' }, { status: 400 })
+  }
+
+  task.pendingApproval = null
+  task.updatedAt = Date.now()
+  saveTasks(tasks)
+  notify('tasks')
+
+  // Resume in the background
+  const sessionId = task.sessionId || ''
+  setImmediate(async () => {
+    try {
+      const { resumeLangGraphOrchestrator } = await import('@/lib/server/orchestrator-lg')
+      const result = await resumeLangGraphOrchestrator(agent, sessionId, threadId)
+      const t2 = loadTasks()
+      if (t2[id] && !t2[id].pendingApproval) {
+        // Only mark completed if not paused again
+        if (t2[id].status === 'running') {
+          t2[id].result = result
+        }
+        t2[id].updatedAt = Date.now()
+        saveTasks(t2)
+        notify('tasks')
+      }
+    } catch (err: any) {
+      console.error(`[approve] Resume failed for task ${id}:`, err.message)
+      const t2 = loadTasks()
+      if (t2[id]) {
+        t2[id].error = err.message || String(err)
+        t2[id].updatedAt = Date.now()
+        saveTasks(t2)
+        notify('tasks')
+      }
+    }
+  })
+
+  return NextResponse.json({ status: 'approved', resuming: true })
+}

package/src/app/api/tasks/[id]/route.ts

@@ -1,10 +1,12 @@
-import crypto from 'crypto'
+import { genId } from '@/lib/id'
 import { NextResponse } from 'next/server'
 import { loadTasks, saveTasks } from '@/lib/server/storage'
+import { notFound } from '@/lib/server/collection-helpers'
 import { disableSessionHeartbeat, enqueueTask, validateCompletedTasksQueue } from '@/lib/server/queue'
 import { ensureTaskCompletionReport } from '@/lib/server/task-reports'
 import { formatValidationFailure, validateTaskCompletion } from '@/lib/server/task-validation'
 import { pushMainLoopEventToMainSessions } from '@/lib/server/main-agent-loop'
+import { notify } from '@/lib/server/ws-hub'
 
 export async function GET(_req: Request, { params }: { params: Promise<{ id: string }> }) {
   // Keep completed queue integrity even if daemon is not running.
@@ -12,7 +14,7 @@ export async function GET(_req: Request, { params }: { params: Promise<{ id: str
 
   const { id } = await params
   const tasks = loadTasks()
-  if (!tasks[id]) return new NextResponse(null, { status: 404 })
+  if (!tasks[id]) return notFound()
   return NextResponse.json(tasks[id])
 }
 
@@ -20,7 +22,7 @@ export async function PUT(req: Request, { params }: { params: Promise<{ id: stri
   const { id } = await params
   const body = await req.json()
   const tasks = loadTasks()
-  if (!tasks[id]) return new NextResponse(null, { status: 404 })
+  if (!tasks[id]) return notFound()
 
   const prevStatus = tasks[id].status
 
@@ -54,7 +56,7 @@ export async function PUT(req: Request, { params }: { params: Promise<{ id: stri
       tasks[id].error = formatValidationFailure(validation.reasons).slice(0, 500)
       if (!tasks[id].comments) tasks[id].comments = []
       tasks[id].comments.push({
-        id: crypto.randomBytes(4).toString('hex'),
+        id: genId(),
         author: 'System',
         text: `Completion validation failed.\n\n${validation.reasons.map((r) => `- ${r}`).join('\n')}`,
         createdAt: Date.now(),
@@ -80,13 +82,14 @@ export async function PUT(req: Request, { params }: { params: Promise<{ id: stri
     enqueueTask(id)
   }
 
+  notify('tasks')
   return NextResponse.json(tasks[id])
 }
 
 export async function DELETE(_req: Request, { params }: { params: Promise<{ id: string }> }) {
   const { id } = await params
   const tasks = loadTasks()
-  if (!tasks[id]) return new NextResponse(null, { status: 404 })
+  if (!tasks[id]) return notFound()
 
   // Soft delete: move to archived status instead of hard delete
   tasks[id].status = 'archived'
@@ -98,5 +101,6 @@ export async function DELETE(_req: Request, { params }: { params: Promise<{ id:
     text: `Task archived: "${tasks[id].title}" (${id}).`,
   })
 
+  notify('tasks')
   return NextResponse.json(tasks[id])
 }

package/src/app/api/tasks/route.ts

@@ -1,10 +1,11 @@
 import { NextResponse } from 'next/server'
-import crypto from 'crypto'
+import { genId } from '@/lib/id'
 import { loadTasks, saveTasks, loadSettings } from '@/lib/server/storage'
 import { enqueueTask, validateCompletedTasksQueue } from '@/lib/server/queue'
 import { ensureTaskCompletionReport } from '@/lib/server/task-reports'
 import { formatValidationFailure, validateTaskCompletion } from '@/lib/server/task-validation'
 import { pushMainLoopEventToMainSessions } from '@/lib/server/main-agent-loop'
+import { notify } from '@/lib/server/ws-hub'
 
 export async function GET(req: Request) {
   // Keep completed queue integrity even if daemon is not running.
@@ -47,12 +48,13 @@ export async function DELETE(req: Request) {
       removed++
     }
   }
+  notify('tasks')
   return NextResponse.json({ removed, remaining: Object.keys(tasks).length - removed })
 }
 
 export async function POST(req: Request) {
   const body = await req.json()
-  const id = crypto.randomBytes(4).toString('hex')
+  const id = genId()
   const now = Date.now()
   const tasks = loadTasks()
   const settings = loadSettings()
@@ -111,5 +113,6 @@ export async function POST(req: Request) {
   if (tasks[id].status === 'queued') {
     enqueueTask(id)
   }
+  notify('tasks')
   return NextResponse.json(tasks[id])
 }

package/src/app/api/tts/stream/route.ts

@@ -0,0 +1,48 @@
+import { loadSettings } from '@/lib/server/storage'
+
+export async function POST(req: Request) {
+  const settings = loadSettings()
+  const ELEVENLABS_KEY = settings.elevenLabsApiKey || process.env.ELEVENLABS_API_KEY
+  const ELEVENLABS_VOICE = settings.elevenLabsVoiceId || process.env.ELEVENLABS_VOICE || 'JBFqnCBsd6RMkjVDRZzb'
+
+  if (!ELEVENLABS_KEY) {
+    return new Response('No ElevenLabs API key. Set one in Settings > Voice.', { status: 500 })
+  }
+
+  const { text } = await req.json()
+  if (!text?.trim()) {
+    return new Response('No text provided', { status: 400 })
+  }
+
+  const apiRes = await fetch(
+    `https://api.elevenlabs.io/v1/text-to-speech/${ELEVENLABS_VOICE}/stream`,
+    {
+      method: 'POST',
+      headers: {
+        'xi-api-key': ELEVENLABS_KEY,
+        'Content-Type': 'application/json',
+        'Accept': 'audio/mpeg',
+      },
+      body: JSON.stringify({
+        text: text.slice(0, 2000),
+        model_id: 'eleven_multilingual_v2',
+        voice_settings: { stability: 0.5, similarity_boost: 0.75 },
+        output_format: 'mp3_22050_32',
+      }),
+    },
+  )
+
+  if (!apiRes.ok) {
+    const err = await apiRes.text()
+    return new Response(err, { status: apiRes.status })
+  }
+
+  // Pipe the streaming response directly
+  return new Response(apiRes.body, {
+    headers: {
+      'Content-Type': 'audio/mpeg',
+      'Transfer-Encoding': 'chunked',
+      'Cache-Control': 'no-cache',
+    },
+  })
+}

package/src/app/api/upload/route.ts

@@ -1,13 +1,13 @@
 import { NextResponse } from 'next/server'
 import fs from 'fs'
 import path from 'path'
-import crypto from 'crypto'
+import { genId } from '@/lib/id'
 import { UPLOAD_DIR } from '@/lib/server/storage'
 
 export async function POST(req: Request) {
   const filename = req.headers.get('x-filename') || 'image.png'
   const buf = Buffer.from(await req.arrayBuffer())
-  const name = crypto.randomBytes(4).toString('hex') + '-' + filename.replace(/[^a-zA-Z0-9._-]/g, '_')
+  const name = genId() + '-' + filename.replace(/[^a-zA-Z0-9._-]/g, '_')
   const filePath = path.join(UPLOAD_DIR, name)
 
   if (!fs.existsSync(UPLOAD_DIR)) fs.mkdirSync(UPLOAD_DIR, { recursive: true })

package/src/app/api/uploads/[filename]/route.ts

@@ -1,4 +1,5 @@
 import { NextResponse } from 'next/server'
+import { notFound } from '@/lib/server/collection-helpers'
 import fs from 'fs'
 import path from 'path'
 import { UPLOAD_DIR } from '@/lib/server/storage'
@@ -43,16 +44,18 @@ export async function GET(_req: Request, { params }: { params: Promise<{ filenam
   const filePath = path.join(UPLOAD_DIR, safeName)
 
   if (!fs.existsSync(filePath)) {
-    return new NextResponse(null, { status: 404 })
+    return notFound()
   }
 
   const ext = path.extname(safeName).toLowerCase()
   const contentType = MIME_TYPES[ext] || 'application/octet-stream'
   const data = fs.readFileSync(filePath)
 
+  const inline = contentType.startsWith('image/') || contentType.startsWith('video/') || contentType.startsWith('text/') || contentType === 'application/pdf'
   return new NextResponse(data, {
     headers: {
       'Content-Type': contentType,
+      'Content-Disposition': inline ? 'inline' : `attachment; filename="${path.basename(safeName)}"`,
       'Cache-Control': 'public, max-age=86400',
     },
   })

package/src/app/api/usage/route.ts

@@ -1,7 +1,9 @@
 import { NextResponse } from 'next/server'
 import { loadUsage } from '@/lib/server/storage'
+export const dynamic = 'force-dynamic'
 
-export async function GET() {
+
+export async function GET(_req: Request) {
   const usage = loadUsage()
   // Compute summary
   let totalTokens = 0

package/src/app/api/version/route.ts

@@ -1,5 +1,7 @@
 import { NextResponse } from 'next/server'
 import { execSync } from 'child_process'
+export const dynamic = 'force-dynamic'
+
 
 let cachedRemote: {
   sha: string
@@ -31,7 +33,7 @@ function getHeadStableTag(): string | null {
   return tags.find((tag) => RELEASE_TAG_RE.test(tag)) || null
 }
 
-export async function GET() {
+export async function GET(_req: Request) {
   try {
     const localSha = run('git rev-parse --short HEAD')
     const localTag = getHeadStableTag()

package/src/app/api/webhooks/[id]/route.ts

@@ -1,7 +1,12 @@
-import crypto from 'crypto'
+import { genId } from '@/lib/id'
 import { NextResponse } from 'next/server'
 import { loadAgents, loadSessions, loadWebhooks, saveSessions, saveWebhooks, appendWebhookLog } from '@/lib/server/storage'
+import { WORKSPACE_DIR } from '@/lib/server/data-dir'
 import { enqueueSessionRun } from '@/lib/server/session-run-manager'
+import { mutateItem, deleteItem, notFound, type CollectionOps } from '@/lib/server/collection-helpers'
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const ops: CollectionOps<any> = { load: loadWebhooks, save: saveWebhooks }
 
 function normalizeEvents(value: unknown): string[] {
   if (!Array.isArray(value)) return []
@@ -21,36 +26,30 @@ export async function GET(_req: Request, { params }: { params: Promise<{ id: str
   const { id } = await params
   const webhooks = loadWebhooks()
   const webhook = webhooks[id]
-  if (!webhook) return NextResponse.json({ error: 'Webhook not found' }, { status: 404 })
+  if (!webhook) return notFound('Webhook not found')
   return NextResponse.json(webhook)
 }
 
 export async function PUT(req: Request, { params }: { params: Promise<{ id: string }> }) {
   const { id } = await params
   const body = await req.json().catch(() => ({}))
-  const webhooks = loadWebhooks()
-  const webhook = webhooks[id]
-  if (!webhook) return NextResponse.json({ error: 'Webhook not found' }, { status: 404 })
-
-  if (body.name !== undefined) webhook.name = body.name
-  if (body.source !== undefined) webhook.source = body.source
-  if (body.events !== undefined) webhook.events = normalizeEvents(body.events)
-  if (body.agentId !== undefined) webhook.agentId = body.agentId
-  if (body.secret !== undefined) webhook.secret = body.secret
-  if (body.isEnabled !== undefined) webhook.isEnabled = !!body.isEnabled
-  webhook.updatedAt = Date.now()
-
-  webhooks[id] = webhook
-  saveWebhooks(webhooks)
-  return NextResponse.json(webhook)
+  const result = mutateItem(ops, id, (webhook) => {
+    if (body.name !== undefined) webhook.name = body.name
+    if (body.source !== undefined) webhook.source = body.source
+    if (body.events !== undefined) webhook.events = normalizeEvents(body.events)
+    if (body.agentId !== undefined) webhook.agentId = body.agentId
+    if (body.secret !== undefined) webhook.secret = body.secret
+    if (body.isEnabled !== undefined) webhook.isEnabled = !!body.isEnabled
+    webhook.updatedAt = Date.now()
+    return webhook
+  })
+  if (!result) return notFound('Webhook not found')
+  return NextResponse.json(result)
 }
 
 export async function DELETE(_req: Request, { params }: { params: Promise<{ id: string }> }) {
   const { id } = await params
-  const webhooks = loadWebhooks()
-  if (!webhooks[id]) return NextResponse.json({ error: 'Webhook not found' }, { status: 404 })
-  delete webhooks[id]
-  saveWebhooks(webhooks)
+  if (!deleteItem(ops, id)) return notFound('Webhook not found')
   return NextResponse.json({ ok: true })
 }
 
@@ -58,10 +57,10 @@ export async function POST(req: Request, { params }: { params: Promise<{ id: str
   const { id } = await params
   const webhooks = loadWebhooks()
   const webhook = webhooks[id]
-  if (!webhook) return NextResponse.json({ error: 'Webhook not found' }, { status: 404 })
+  if (!webhook) return notFound('Webhook not found')
   if (webhook.isEnabled === false) {
-    appendWebhookLog(crypto.randomBytes(8).toString('hex'), {
-      id: crypto.randomBytes(8).toString('hex'), webhookId: id, event: 'unknown',
+    appendWebhookLog(genId(8), {
+      id: genId(8), webhookId: id, event: 'unknown',
       payload: '', status: 'error', error: 'Webhook is disabled', timestamp: Date.now(),
     })
     return NextResponse.json({ error: 'Webhook is disabled' }, { status: 409 })
@@ -72,8 +71,8 @@ export async function POST(req: Request, { params }: { params: Promise<{ id: str
     const url = new URL(req.url)
     const provided = req.headers.get('x-webhook-secret') || url.searchParams.get('secret') || ''
     if (provided !== secret) {
-      appendWebhookLog(crypto.randomBytes(8).toString('hex'), {
-        id: crypto.randomBytes(8).toString('hex'), webhookId: id, event: 'unknown',
+      appendWebhookLog(genId(8), {
+        id: genId(8), webhookId: id, event: 'unknown',
         payload: '', status: 'error', error: 'Invalid webhook secret', timestamp: Date.now(),
       })
       return NextResponse.json({ error: 'Invalid webhook secret' }, { status: 401 })
@@ -121,8 +120,8 @@ export async function POST(req: Request, { params }: { params: Promise<{ id: str
   const agents = loadAgents()
   const agent = webhook.agentId ? agents[webhook.agentId] : null
   if (!agent) {
-    appendWebhookLog(crypto.randomBytes(8).toString('hex'), {
-      id: crypto.randomBytes(8).toString('hex'), webhookId: id, event: incomingEvent,
+    appendWebhookLog(genId(8), {
+      id: genId(8), webhookId: id, event: incomingEvent,
       payload: (rawBody || '').slice(0, 2000), status: 'error', error: 'Webhook agent is not configured or missing', timestamp: Date.now(),
     })
     return NextResponse.json({ error: 'Webhook agent is not configured or missing' }, { status: 400 })
@@ -132,12 +131,12 @@ export async function POST(req: Request, { params }: { params: Promise<{ id: str
   const sessionName = `webhook:${id}`
   let session = Object.values(sessions).find((s: any) => s.name === sessionName && s.agentId === agent.id) as any
   if (!session) {
-    const sessionId = crypto.randomBytes(4).toString('hex')
+    const sessionId = genId()
     const now = Date.now()
     session = {
       id: sessionId,
       name: sessionName,
-      cwd: process.cwd(),
+      cwd: WORKSPACE_DIR,
       user: 'system',
       provider: agent.provider || 'claude-cli',
       model: agent.model || '',
@@ -188,8 +187,8 @@ export async function POST(req: Request, { params }: { params: Promise<{ id: str
     mode: 'followup',
   })
 
-  appendWebhookLog(crypto.randomBytes(8).toString('hex'), {
-    id: crypto.randomBytes(8).toString('hex'), webhookId: id, event: incomingEvent,
+  appendWebhookLog(genId(8), {
+    id: genId(8), webhookId: id, event: incomingEvent,
     payload: (rawBody || '').slice(0, 2000), status: 'success',
     sessionId: session.id, runId: run.runId, timestamp: Date.now(),
   })

package/src/app/api/webhooks/route.ts

@@ -1,6 +1,8 @@
-import crypto from 'crypto'
+import { genId } from '@/lib/id'
 import { NextResponse } from 'next/server'
 import { loadWebhooks, saveWebhooks } from '@/lib/server/storage'
+export const dynamic = 'force-dynamic'
+
 
 function normalizeEvents(value: unknown): string[] {
   if (!Array.isArray(value)) return []
@@ -10,14 +12,14 @@ function normalizeEvents(value: unknown): string[] {
     .filter(Boolean)
 }
 
-export async function GET() {
+export async function GET(_req: Request) {
   return NextResponse.json(loadWebhooks())
 }
 
 export async function POST(req: Request) {
   const body = await req.json().catch(() => ({}))
   const webhooks = loadWebhooks()
-  const id = crypto.randomBytes(4).toString('hex')
+  const id = genId()
   const now = Date.now()
 
   webhooks[id] = {

package/src/app/icon.svg

@@ -0,0 +1,58 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1024 1024" role="img" aria-labelledby="title desc">
+  <title id="title">SwarmClaw Lobster Avatar</title>
+  <desc id="desc">SwarmClaw org avatar using an OpenClaw-inspired lobster mark with swarm accents.</desc>
+
+  <defs>
+    <linearGradient id="bg" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0%" stop-color="#050B18"/>
+      <stop offset="100%" stop-color="#111827"/>
+    </linearGradient>
+    <radialGradient id="glow" cx="50%" cy="38%" r="62%">
+      <stop offset="0%" stop-color="#22d3ee" stop-opacity="0.22"/>
+      <stop offset="100%" stop-color="#22d3ee" stop-opacity="0"/>
+    </radialGradient>
+    <linearGradient id="lobster-gradient" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#ff6a5f"/>
+      <stop offset="100%" stop-color="#a41318"/>
+    </linearGradient>
+    <filter id="soft-shadow" x="-20%" y="-20%" width="140%" height="140%">
+      <feDropShadow dx="0" dy="16" stdDeviation="18" flood-color="#020617" flood-opacity="0.55"/>
+    </filter>
+  </defs>
+
+  <rect x="40" y="40" width="944" height="944" rx="216" fill="url(#bg)"/>
+  <rect x="40" y="40" width="944" height="944" rx="216" fill="url(#glow)"/>
+  <rect x="56" y="56" width="912" height="912" rx="200" fill="none" stroke="#334155" stroke-width="6"/>
+
+  <!-- swarm accents -->
+  <g stroke="#22d3ee" stroke-opacity="0.8" stroke-width="10" fill="none" stroke-linecap="round">
+    <path d="M182 286 C232 236, 314 224, 378 252"/>
+    <path d="M842 286 C792 236, 710 224, 646 252"/>
+    <path d="M202 760 C270 814, 350 826, 420 806"/>
+    <path d="M822 760 C754 814, 674 826, 604 806"/>
+  </g>
+  <g fill="#67e8f9">
+    <circle cx="172" cy="282" r="14"/>
+    <circle cx="852" cy="282" r="14"/>
+    <circle cx="198" cy="760" r="12"/>
+    <circle cx="826" cy="760" r="12"/>
+  </g>
+
+  <!-- OpenClaw-inspired lobster mark -->
+  <g transform="translate(152 156) scale(6)" filter="url(#soft-shadow)">
+    <!-- Body -->
+    <path d="M60 10 C30 10 15 35 15 55 C15 75 30 95 45 100 L45 110 L55 110 L55 100 C55 100 60 102 65 100 L65 110 L75 110 L75 100 C90 95 105 75 105 55 C105 35 90 10 60 10Z" fill="url(#lobster-gradient)"/>
+    <!-- Left Claw -->
+    <path d="M20 45 C5 40 0 50 5 60 C10 70 20 65 25 55 C28 48 25 45 20 45Z" fill="url(#lobster-gradient)"/>
+    <!-- Right Claw -->
+    <path d="M100 45 C115 40 120 50 115 60 C110 70 100 65 95 55 C92 48 95 45 100 45Z" fill="url(#lobster-gradient)"/>
+    <!-- Antenna -->
+    <path d="M45 15 Q35 5 30 8" stroke="#ff8b84" stroke-width="3" stroke-linecap="round"/>
+    <path d="M75 15 Q85 5 90 8" stroke="#ff8b84" stroke-width="3" stroke-linecap="round"/>
+    <!-- Eyes -->
+    <circle cx="45" cy="35" r="6" fill="#030712"/>
+    <circle cx="75" cy="35" r="6" fill="#030712"/>
+    <circle cx="46" cy="34" r="2.5" fill="#22d3ee"/>
+    <circle cx="76" cy="34" r="2.5" fill="#22d3ee"/>
+  </g>
+</svg>