@swarmclawai/swarmclaw 1.0.0 → 1.0.2

package/bin/worker-cmd.js

@@ -4,9 +4,11 @@
 const { spawn } = require('node:child_process')
 
 const {
+  BROWSER_PROFILES_DIR,
   DATA_DIR,
   PKG_ROOT,
   SWARMCLAW_HOME,
+  WORKSPACE_DIR,
   findStandaloneServer,
 } = require('./server-cmd.js')
 
@@ -23,8 +25,7 @@ Options:
   console.log(help)
 }
 
-function main() {
-  const args = process.argv.slice(3)
+function main(args = process.argv.slice(3)) {
   for (const arg of args) {
     if (arg === '-h' || arg === '--help') {
       printHelp()
@@ -36,7 +37,10 @@ function main() {
     }
   }
 
+  process.env.SWARMCLAW_HOME = SWARMCLAW_HOME
   process.env.DATA_DIR = DATA_DIR
+  process.env.WORKSPACE_DIR = WORKSPACE_DIR
+  process.env.BROWSER_PROFILES_DIR = BROWSER_PROFILES_DIR
   process.env.SWARMCLAW_DAEMON_BACKGROUND_SERVICES = '1'
   process.env.SWARMCLAW_WORKER_ONLY = '1'
 
@@ -44,6 +48,8 @@ function main() {
   console.log(`[swarmclaw] Package root: ${PKG_ROOT}`)
   console.log(`[swarmclaw] Home: ${SWARMCLAW_HOME}`)
   console.log(`[swarmclaw] Data directory: ${DATA_DIR}`)
+  console.log(`[swarmclaw] Workspace directory: ${WORKSPACE_DIR}`)
+  console.log(`[swarmclaw] Browser profiles: ${BROWSER_PROFILES_DIR}`)
 
   const serverJs = findStandaloneServer()
   if (!serverJs) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@swarmclawai/swarmclaw",
-  "version": "1.0.0",
-  "description": "Self-hosted AI agent orchestration dashboard — manage LLM providers, orchestrate agent swarms, schedule tasks, and bridge agents to chat platforms.",
+  "version": "1.0.2",
+  "description": "Self-hosted AI agent orchestration dashboard with OpenClaw integration, multi-provider support, LangGraph workflows, and chat platform connectors.",
   "license": "MIT",
   "publishConfig": {
     "access": "public",
@@ -51,8 +51,8 @@
     "dev": "next dev --turbopack --hostname 0.0.0.0 -p 3456",
     "dev:webpack": "next dev --webpack --hostname 0.0.0.0 -p 3456",
     "dev:clean": "rm -rf .next && next dev --turbopack --hostname 0.0.0.0 -p 3456",
-    "build": "next build",
-    "build:ci": "NEXT_DISABLE_ESLINT=1 next build",
+    "build": "next build --webpack",
+    "build:ci": "NEXT_DISABLE_ESLINT=1 next build --webpack",
     "start": "node .next/standalone/server.js",
     "start:standalone": "node .next/standalone/server.js",
     "smoke:browser": "node ./scripts/browser-route-smoke.mjs",
@@ -69,6 +69,7 @@
     "test:setup": "tsx --test src/app/api/setup/check-provider/route.test.ts src/lib/server/provider-model-discovery.test.ts src/components/auth/setup-wizard/utils.test.ts src/components/auth/setup-wizard/types.test.ts src/hooks/setup-done-detection.test.ts src/lib/setup-defaults.test.ts",
     "test:openclaw": "tsx --test src/lib/openclaw/openclaw-agent-id.test.ts src/lib/openclaw/openclaw-endpoint.test.ts src/lib/server/agents/agent-runtime-config.test.ts src/lib/server/build-llm.test.ts src/lib/server/connectors/connector-routing.test.ts src/lib/server/connectors/openclaw.test.ts src/lib/server/gateway/protocol.test.ts src/lib/server/llm-response-cache.test.ts src/lib/server/mcp-conformance.test.ts src/lib/server/openclaw/agent-resolver.test.ts src/lib/server/openclaw/deploy.test.ts src/lib/server/openclaw/skills-normalize.test.ts src/lib/server/session-tools/openclaw-nodes.test.ts src/lib/server/tasks/task-quality-gate.test.ts src/lib/server/tasks/task-validation.test.ts src/lib/server/tool-capability-policy.test.ts src/lib/providers/openclaw-exports.test.ts src/app/api/openclaw/dashboard-url/route.test.ts",
     "test:mcp:conformance": "node --import tsx ./scripts/mcp-conformance-check.ts",
+    "prepack": "npm run build:ci",
     "postinstall": "node ./scripts/postinstall.mjs"
   },
   "dependencies": {
@@ -76,6 +77,7 @@
     "@langchain/anthropic": "^1.3.18",
     "@langchain/core": "^1.1.31",
     "@modelcontextprotocol/sdk": "^1.27.1",
+    "@tailwindcss/postcss": "^4",
     "@langchain/langgraph": "^1.2.2",
     "@langchain/openai": "^1.2.8",
     "@multiavatar/multiavatar": "^1.0.7",
@@ -116,14 +118,16 @@
     "rehype-highlight": "^7.0.2",
     "remark-gfm": "^4.0.1",
     "remove-markdown": "^0.6.3",
+    "shadcn": "^3.8.5",
     "sonner": "^2.0.7",
+    "tailwindcss": "^4",
     "tailwind-merge": "^3.4.1",
+    "tw-animate-css": "^1.4.0",
     "ws": "^8.19.0",
     "zod": "^4.3.6",
     "zustand": "^5.0.11"
   },
   "devDependencies": {
-    "@tailwindcss/postcss": "^4",
     "@types/better-sqlite3": "^7.6.13",
     "@types/mailparser": "^3.4.6",
     "@types/node": "^20",
@@ -134,10 +138,7 @@
     "@types/ws": "^8.18.1",
     "eslint": "^9",
     "eslint-config-next": "16.1.6",
-    "shadcn": "^3.8.5",
-    "tailwindcss": "^4",
     "tsx": "^4.20.6",
-    "tw-animate-css": "^1.4.0",
     "typescript": "^5"
   },
   "optionalDependencies": {

package/src/app/api/gateways/[id]/health/route.ts

@@ -1,39 +1,9 @@
 import { NextResponse } from 'next/server'
-import { probeOpenClawHealth } from '@/lib/server/openclaw/health'
-import { loadGatewayProfiles, saveGatewayProfiles } from '@/lib/server/storage'
+import { probeOpenClawHealth, persistGatewayHealthResult } from '@/lib/server/openclaw/health'
+import { loadGatewayProfiles } from '@/lib/server/storage'
 import { notFound } from '@/lib/server/collection-helpers'
-import { notify } from '@/lib/server/ws-hub'
-import type { GatewayProfile } from '@/types'
-import type { OpenClawHealthResult } from '@/lib/server/openclaw/health'
 export const dynamic = 'force-dynamic'
 
-export function persistGatewayHealthResult(
-  id: string,
-  result: OpenClawHealthResult,
-  now = Date.now(),
-): GatewayProfile | null {
-  const gateways = loadGatewayProfiles()
-  const gateway = gateways[id]
-  if (!gateway) return null
-
-  gateway.status = result.ok ? 'healthy' : (result.authProvided ? 'degraded' : 'offline')
-  gateway.lastCheckedAt = now
-  gateway.lastError = result.ok ? null : (result.error || result.hint || 'Gateway health check failed.')
-  gateway.lastModelCount = Array.isArray(result.models) ? result.models.length : 0
-  gateway.deployment = {
-    ...(gateway.deployment || {}),
-    lastVerifiedAt: now,
-    lastVerifiedOk: result.ok,
-    lastVerifiedMessage: result.ok
-      ? result.message
-      : (result.error || result.hint || 'Gateway health check failed.'),
-  }
-  gateway.updatedAt = now
-  saveGatewayProfiles(gateways)
-  notify('gateways')
-  return gateway
-}
-
 export async function GET(_req: Request, { params }: { params: Promise<{ id: string }> }) {
   const { id } = await params
   const gateways = loadGatewayProfiles()

package/src/app/api/gateways/health-route.test.ts

@@ -1,7 +1,7 @@
 import assert from 'node:assert/strict'
 import { afterEach, test } from 'node:test'
 
-import { persistGatewayHealthResult } from './[id]/health/route'
+import { persistGatewayHealthResult } from '@/lib/server/openclaw/health'
 import { loadGatewayProfiles, saveGatewayProfiles } from '@/lib/server/storage'
 
 const originalGateways = loadGatewayProfiles()

package/src/app/api/setup/check-provider/helpers.ts

@@ -0,0 +1,28 @@
+export function normalizeOllamaSetupEndpoint(endpoint: string, useCloud: boolean): string {
+  const normalized = endpoint.replace(/\/+$/, '')
+  if (useCloud) return normalized
+  return normalized.replace(/\/v1$/i, '')
+}
+
+export async function parseErrorMessage(res: Response, fallback: string): Promise<string> {
+  const text = await res.text().catch(() => '')
+  if (!text) return fallback
+  try {
+    const parsed = JSON.parse(text)
+    if (typeof parsed?.error?.message === 'string' && parsed.error.message.trim()) return parsed.error.message.trim()
+    if (typeof parsed?.error === 'string' && parsed.error.trim()) return parsed.error.trim()
+    if (typeof parsed?.message === 'string' && parsed.message.trim()) return parsed.message.trim()
+    if (typeof parsed?.detail === 'string' && parsed.detail.trim()) return parsed.detail.trim()
+  } catch {
+    // Non-JSON response body.
+  }
+  return text.slice(0, 300).trim() || fallback
+}
+
+export function normalizeOpenClawUrl(raw: string): { httpUrl: string; wsUrl: string } {
+  let url = (raw || 'http://localhost:18789').replace(/\/+$/, '')
+  if (!/^(https?|wss?):\/\//i.test(url)) url = `http://${url}`
+  const httpUrl = url.replace(/^ws:/i, 'http:').replace(/^wss:/i, 'https:')
+  const wsUrl = httpUrl.replace(/^http:/i, 'ws:').replace(/^https:/i, 'wss:')
+  return { httpUrl, wsUrl }
+}

package/src/app/api/setup/check-provider/route.test.ts

@@ -1,7 +1,7 @@
 import assert from 'node:assert/strict'
 import test from 'node:test'
 
-import { normalizeOllamaSetupEndpoint, normalizeOpenClawUrl, parseErrorMessage } from './route'
+import { normalizeOllamaSetupEndpoint, normalizeOpenClawUrl, parseErrorMessage } from './helpers'
 
 test('normalizeOllamaSetupEndpoint strips local /v1 suffixes but preserves cloud endpoints', () => {
   assert.equal(

package/src/app/api/setup/check-provider/route.ts

@@ -3,6 +3,7 @@ import { loadCredentials, decryptKey } from '@/lib/server/storage'
 import { getDeviceId, wsConnect, rpcOnConnectedGateway } from '@/lib/providers/openclaw'
 import { OPENAI_COMPATIBLE_DEFAULTS } from '@/lib/server/provider-health'
 import { resolveOllamaRuntimeConfig } from '@/lib/server/ollama-runtime'
+import { normalizeOllamaSetupEndpoint, normalizeOpenClawUrl, parseErrorMessage } from './helpers'
 
 type SetupProvider =
   | 'openai'
@@ -29,32 +30,11 @@ function clean(value: unknown): string {
   return typeof value === 'string' ? value.trim() : ''
 }
 
-export function normalizeOllamaSetupEndpoint(endpoint: string, useCloud: boolean): string {
-  const normalized = endpoint.replace(/\/+$/, '')
-  if (useCloud) return normalized
-  return normalized.replace(/\/v1$/i, '')
-}
-
 function parseBody(input: unknown): SetupCheckBody {
   if (!input || typeof input !== 'object' || Array.isArray(input)) return {}
   return input as SetupCheckBody
 }
 
-export async function parseErrorMessage(res: Response, fallback: string): Promise<string> {
-  const text = await res.text().catch(() => '')
-  if (!text) return fallback
-  try {
-    const parsed = JSON.parse(text)
-    if (typeof parsed?.error?.message === 'string' && parsed.error.message.trim()) return parsed.error.message.trim()
-    if (typeof parsed?.error === 'string' && parsed.error.trim()) return parsed.error.trim()
-    if (typeof parsed?.message === 'string' && parsed.message.trim()) return parsed.message.trim()
-    if (typeof parsed?.detail === 'string' && parsed.detail.trim()) return parsed.detail.trim()
-  } catch {
-    // Non-JSON response body.
-  }
-  return text.slice(0, 300).trim() || fallback
-}
-
 async function checkOpenAiCompatible(
   providerName: string,
   apiKey: string,
@@ -234,14 +214,6 @@ async function checkOllama(params: {
   }
 }
 
-export function normalizeOpenClawUrl(raw: string): { httpUrl: string; wsUrl: string } {
-  let url = (raw || 'http://localhost:18789').replace(/\/+$/, '')
-  if (!/^(https?|wss?):\/\//i.test(url)) url = `http://${url}`
-  const httpUrl = url.replace(/^ws:/i, 'http:').replace(/^wss:/i, 'https:')
-  const wsUrl = httpUrl.replace(/^http:/i, 'ws:').replace(/^https:/i, 'wss:')
-  return { httpUrl, wsUrl }
-}
-
 async function checkOpenClaw(apiKey: string, endpointRaw: string): Promise<{ ok: boolean; message: string; normalizedEndpoint: string; deviceId?: string; errorCode?: string; recommendedModel?: string }> {
   const { httpUrl: normalizedEndpoint, wsUrl } = normalizeOpenClawUrl(endpointRaw)
   const token = apiKey || undefined
@@ -258,9 +230,10 @@ async function checkOpenClaw(apiKey: string, endpointRaw: string): Promise<{ ok:
   let recommendedModel: string | undefined
   if (result.ws) {
     try {
-      const payload = await rpcOnConnectedGateway(result.ws, 'models.list', {}, 8_000) as any
-      const models = Array.isArray(payload?.models) ? payload.models : Array.isArray(payload?.data) ? payload.data : Array.isArray(payload) ? payload : []
-      const first = models[0]
+      const payload = await rpcOnConnectedGateway(result.ws, 'models.list', {}, 8_000) as Record<string, unknown> | unknown[] | undefined
+      const p = payload as Record<string, unknown> | undefined
+      const models: unknown[] = Array.isArray(p?.models) ? p.models as unknown[] : Array.isArray(p?.data) ? p.data as unknown[] : Array.isArray(payload) ? payload : []
+      const first = models[0] as Record<string, unknown> | string | undefined
       if (typeof first === 'string') {
         recommendedModel = first
       } else if (typeof first?.id === 'string') {

package/src/app/api/tasks/import/github/helpers.ts

@@ -0,0 +1,100 @@
+import { dedup } from '@/lib/shared-utils'
+
+type GitHubIssueLabel = string | { name?: string | null }
+
+export interface GitHubIssueRecord {
+  id: number | string
+  number: number
+  title: string
+  body?: string | null
+  state?: string | null
+  html_url?: string | null
+  labels?: GitHubIssueLabel[]
+  assignee?: { login?: string | null } | null
+  user?: { login?: string | null } | null
+  pull_request?: unknown
+}
+
+export interface ParsedRepo {
+  owner: string
+  repo: string
+  fullName: string
+}
+
+const BODY_CHAR_LIMIT = 12_000
+
+function normalizeLabelName(label: GitHubIssueLabel): string {
+  if (typeof label === 'string') return label.trim()
+  return String(label?.name || '').trim()
+}
+
+function normalizeTag(value: string): string {
+  return value.trim().replace(/\s+/g, ' ').slice(0, 60)
+}
+
+export function parseGitHubRepoInput(input: string): ParsedRepo | null {
+  const trimmed = input.trim().replace(/\.git$/i, '')
+  if (!trimmed) return null
+
+  if (/^https?:\/\//i.test(trimmed)) {
+    try {
+      const url = new URL(trimmed)
+      if (!/github\.com$/i.test(url.hostname)) return null
+      const parts = url.pathname.split('/').filter(Boolean)
+      if (parts.length < 2) return null
+      const owner = parts[0]
+      const repo = parts[1].replace(/\.git$/i, '')
+      if (!owner || !repo) return null
+      return { owner, repo, fullName: `${owner}/${repo}` }
+    } catch {
+      return null
+    }
+  }
+
+  const compact = trimmed.replace(/^github\.com\//i, '')
+  const parts = compact.split('/').filter(Boolean)
+  if (parts.length < 2) return null
+  const owner = parts[0]
+  const repo = parts[1].replace(/\.git$/i, '')
+  if (!owner || !repo) return null
+  return { owner, repo, fullName: `${owner}/${repo}` }
+}
+
+export function buildGitHubIssueTaskTitle(issue: GitHubIssueRecord, repoFullName: string): string {
+  const title = issue.title?.trim() || `Issue ${issue.number}`
+  return `[${repoFullName}#${issue.number}] ${title}`
+}
+
+export function buildGitHubIssueTaskDescription(issue: GitHubIssueRecord, repoFullName: string): string {
+  const labels = (issue.labels || [])
+    .map(normalizeLabelName)
+    .filter(Boolean)
+  const header = [
+    `Imported from GitHub issue ${repoFullName}#${issue.number}`,
+    issue.html_url ? `URL: ${issue.html_url}` : '',
+    issue.state ? `State: ${issue.state}` : '',
+    labels.length > 0 ? `Labels: ${labels.join(', ')}` : '',
+    issue.assignee?.login ? `Assignee: ${issue.assignee.login}` : '',
+    issue.user?.login ? `Opened by: ${issue.user.login}` : '',
+  ]
+    .filter(Boolean)
+    .join('\n')
+
+  const rawBody = String(issue.body || '').trim()
+  if (!rawBody) return header
+
+  const body = rawBody.length > BODY_CHAR_LIMIT
+    ? `${rawBody.slice(0, BODY_CHAR_LIMIT).trimEnd()}\n\n[Truncated during import]`
+    : rawBody
+
+  return `${header}\n\n${body}`
+}
+
+export function buildGitHubIssueTaskTags(issue: GitHubIssueRecord, repoFullName: string): string[] {
+  const raw = [
+    'github',
+    repoFullName,
+    ...(issue.labels || []).map(normalizeLabelName),
+  ]
+  return dedup(raw.map(normalizeTag).filter(Boolean)).slice(0, 8)
+}

package/src/app/api/tasks/import/github/route.test.ts

@@ -5,7 +5,7 @@ import {
   buildGitHubIssueTaskTags,
   buildGitHubIssueTaskTitle,
   parseGitHubRepoInput,
-} from './route'
+} from './helpers'
 
 test('parseGitHubRepoInput accepts repo slugs and GitHub URLs', () => {
   assert.deepEqual(parseGitHubRepoInput('swarmclawai/swarmclaw'), {

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

@@ -6,10 +6,10 @@ import { formatZodError } from '@/lib/validation/schemas'
 import { loadSettings, loadTasks, logActivity, upsertStoredItems } from '@/lib/server/storage'
 import { notify } from '@/lib/server/ws-hub'
 import type { BoardTask } from '@/types'
-import { dedup } from '@/lib/shared-utils'
+import { parseGitHubRepoInput, buildGitHubIssueTaskTitle, buildGitHubIssueTaskDescription, buildGitHubIssueTaskTags } from './helpers'
+import type { GitHubIssueRecord } from './helpers'
 
 const MAX_IMPORT_LIMIT = 200
-const BODY_CHAR_LIMIT = 12_000
 
 const GitHubIssueImportSchema = z.object({
   repo: z.string().trim().min(1, 'Repository is required'),
@@ -23,25 +23,6 @@ const GitHubIssueImportSchema = z.object({
 
 type GitHubIssueLabel = string | { name?: string | null }
 
-interface GitHubIssueRecord {
-  id: number | string
-  number: number
-  title: string
-  body?: string | null
-  state?: string | null
-  html_url?: string | null
-  labels?: GitHubIssueLabel[]
-  assignee?: { login?: string | null } | null
-  user?: { login?: string | null } | null
-  pull_request?: unknown
-}
-
-interface ParsedRepo {
-  owner: string
-  repo: string
-  fullName: string
-}
-
 function getGitHubToken(explicitToken: string): string {
   return explicitToken.trim()
     || process.env.GITHUB_TOKEN
@@ -55,10 +36,6 @@ function normalizeLabelName(label: GitHubIssueLabel): string {
   return String(label?.name || '').trim()
 }
 
-function normalizeTag(value: string): string {
-  return value.trim().replace(/\s+/g, ' ').slice(0, 60)
-}
-
 function toIssueSummary(issue: GitHubIssueRecord, taskId?: string) {
   return {
     taskId,
@@ -68,73 +45,6 @@ function toIssueSummary(issue: GitHubIssueRecord, taskId?: string) {
   }
 }
 
-export function parseGitHubRepoInput(input: string): ParsedRepo | null {
-  const trimmed = input.trim().replace(/\.git$/i, '')
-  if (!trimmed) return null
-
-  if (/^https?:\/\//i.test(trimmed)) {
-    try {
-      const url = new URL(trimmed)
-      if (!/github\.com$/i.test(url.hostname)) return null
-      const parts = url.pathname.split('/').filter(Boolean)
-      if (parts.length < 2) return null
-      const owner = parts[0]
-      const repo = parts[1].replace(/\.git$/i, '')
-      if (!owner || !repo) return null
-      return { owner, repo, fullName: `${owner}/${repo}` }
-    } catch {
-      return null
-    }
-  }
-
-  const compact = trimmed.replace(/^github\.com\//i, '')
-  const parts = compact.split('/').filter(Boolean)
-  if (parts.length < 2) return null
-  const owner = parts[0]
-  const repo = parts[1].replace(/\.git$/i, '')
-  if (!owner || !repo) return null
-  return { owner, repo, fullName: `${owner}/${repo}` }
-}
-
-export function buildGitHubIssueTaskTitle(issue: GitHubIssueRecord, repoFullName: string): string {
-  const title = issue.title?.trim() || `Issue ${issue.number}`
-  return `[${repoFullName}#${issue.number}] ${title}`
-}
-
-export function buildGitHubIssueTaskDescription(issue: GitHubIssueRecord, repoFullName: string): string {
-  const labels = (issue.labels || [])
-    .map(normalizeLabelName)
-    .filter(Boolean)
-  const header = [
-    `Imported from GitHub issue ${repoFullName}#${issue.number}`,
-    issue.html_url ? `URL: ${issue.html_url}` : '',
-    issue.state ? `State: ${issue.state}` : '',
-    labels.length > 0 ? `Labels: ${labels.join(', ')}` : '',
-    issue.assignee?.login ? `Assignee: ${issue.assignee.login}` : '',
-    issue.user?.login ? `Opened by: ${issue.user.login}` : '',
-  ]
-    .filter(Boolean)
-    .join('\n')
-
-  const rawBody = String(issue.body || '').trim()
-  if (!rawBody) return header
-
-  const body = rawBody.length > BODY_CHAR_LIMIT
-    ? `${rawBody.slice(0, BODY_CHAR_LIMIT).trimEnd()}\n\n[Truncated during import]`
-    : rawBody
-
-  return `${header}\n\n${body}`
-}
-
-export function buildGitHubIssueTaskTags(issue: GitHubIssueRecord, repoFullName: string): string[] {
-  const raw = [
-    'github',
-    repoFullName,
-    ...(issue.labels || []).map(normalizeLabelName),
-  ]
-  return dedup(raw.map(normalizeTag).filter(Boolean)).slice(0, 8)
-}
-
 function findExistingImportedTask(
   tasks: Record<string, BoardTask>,
   repoFullName: string,