@swarmclawai/swarmclaw 1.0.0 → 1.0.3

package/scripts/postinstall.mjs

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 
+import fs from 'node:fs'
 import path from 'node:path'
 import { fileURLToPath } from 'node:url'
-import { writeFileSync } from 'node:fs'
 import { spawnSync } from 'node:child_process'
 const INSTALL_METADATA_FILE = '.swarmclaw-install.json'
 const scriptDir = path.dirname(fileURLToPath(import.meta.url))
@@ -48,7 +48,7 @@ function formatFailure(result) {
 }
 
 try {
-  writeFileSync(
+  fs.writeFileSync(
     new URL(`../${INSTALL_METADATA_FILE}`, import.meta.url),
     JSON.stringify({
       packageManager: installedWith,
@@ -72,18 +72,22 @@ if (result.error || (result.status ?? 0) !== 0) {
 }
 
 if (!process.env.CI) {
-  const sandboxImage = spawnSync(process.execPath, [ensureSandboxBrowserScript, '--quiet'], {
-    cwd: packageRoot,
-    encoding: 'utf8',
-    stdio: 'pipe',
-  })
-  if (sandboxImage.error || (sandboxImage.status ?? 0) !== 0) {
-    logWarn(`sandbox browser image setup failed: ${formatFailure(sandboxImage)}`)
-    logWarn('Retry manually with: node ./scripts/ensure-sandbox-browser-image.mjs')
-  }
+  if (!fs.existsSync(ensureSandboxBrowserScript)) {
+    logNote('Sandbox browser image helper is not present in this install context. Skipping setup.')
+  } else {
+    const sandboxImage = spawnSync(process.execPath, [ensureSandboxBrowserScript, '--quiet'], {
+      cwd: packageRoot,
+      encoding: 'utf8',
+      stdio: 'pipe',
+    })
+    if (sandboxImage.error || (sandboxImage.status ?? 0) !== 0) {
+      logWarn(`sandbox browser image setup failed: ${formatFailure(sandboxImage)}`)
+      logWarn('Retry manually with: node ./scripts/ensure-sandbox-browser-image.mjs')
+    }
 
-  if (!commandExists('docker')) {
-    logNote('Docker was not found. Container sandboxes will fall back to host execution until Docker is installed.')
+    if (!commandExists('docker')) {
+      logNote('Docker was not found. Container sandboxes will fall back to host execution until Docker is installed.')
+    }
   }
 }
 

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,