clawport-ui 0.1.0

package/lib/transcribe.ts

@@ -0,0 +1,111 @@
+/**
+ * Transcribe audio via the server-side Whisper API.
+ * Returns the transcript text, or null if transcription failed.
+ */
+export async function transcribeViaApi(audioBlob: Blob): Promise<string | null> {
+  try {
+    const form = new FormData()
+    form.append('audio', audioBlob, 'voice.webm')
+    const res = await fetch('/api/transcribe', { method: 'POST', body: form })
+    if (!res.ok) return null
+    const data = await res.json()
+    return data.text || null
+  } catch {
+    return null
+  }
+}
+
+/**
+ * Transcribe audio using the browser's Web Speech API (SpeechRecognition).
+ * This is a fallback that works without any server — uses the browser's
+ * built-in speech recognition engine.
+ *
+ * Note: This re-plays the audio through an Audio element and listens via
+ * SpeechRecognition. It requires the browser to support both APIs.
+ * Returns null if the browser doesn't support SpeechRecognition.
+ */
+export async function transcribeViaBrowser(audioBlob: Blob): Promise<string | null> {
+  const SpeechRecognition = (
+    (globalThis as Record<string, unknown>).SpeechRecognition ||
+    (globalThis as Record<string, unknown>).webkitSpeechRecognition
+  ) as (new () => SpeechRecognitionInstance) | undefined
+
+  if (!SpeechRecognition) return null
+
+  return new Promise<string | null>((resolve) => {
+    const recognition = new SpeechRecognition()
+    recognition.continuous = false
+    recognition.interimResults = false
+    recognition.lang = 'en-US'
+
+    let resolved = false
+
+    recognition.onresult = (event: SpeechRecognitionEvent) => {
+      if (resolved) return
+      resolved = true
+      const transcript = event.results[0]?.[0]?.transcript || ''
+      resolve(transcript || null)
+    }
+
+    recognition.onerror = () => {
+      if (!resolved) { resolved = true; resolve(null) }
+    }
+
+    recognition.onnomatch = () => {
+      if (!resolved) { resolved = true; resolve(null) }
+    }
+
+    recognition.onend = () => {
+      if (!resolved) { resolved = true; resolve(null) }
+    }
+
+    // Play the audio so the mic picks it up — but SpeechRecognition
+    // uses the system mic, not internal audio. Instead, we start recognition
+    // alongside playback and hope the user's environment allows it.
+    // In practice this is best-effort.
+    const url = URL.createObjectURL(audioBlob)
+    const audio = new Audio(url)
+
+    recognition.start()
+    audio.play().catch(() => {})
+
+    // Timeout after 10 seconds
+    setTimeout(() => {
+      if (!resolved) {
+        resolved = true
+        recognition.stop()
+        resolve(null)
+      }
+      URL.revokeObjectURL(url)
+    }, 10000)
+  })
+}
+
+/**
+ * Transcribe audio with automatic fallback:
+ * 1. Try server-side Whisper API
+ * 2. Return result or null
+ */
+export async function transcribe(audioBlob: Blob): Promise<{ text: string | null; source: 'whisper' | 'failed' }> {
+  const whisperResult = await transcribeViaApi(audioBlob)
+  if (whisperResult) return { text: whisperResult, source: 'whisper' }
+
+  return { text: null, source: 'failed' }
+}
+
+// Types for the Web Speech API (not in all TS libs)
+interface SpeechRecognitionEvent {
+  results: { [index: number]: { [index: number]: { transcript: string } } }
+}
+
+interface SpeechRecognitionInstance {
+  continuous: boolean
+  interimResults: boolean
+  lang: string
+  onresult: ((event: SpeechRecognitionEvent) => void) | null
+  onerror: (() => void) | null
+  onnomatch: (() => void) | null
+  onend: (() => void) | null
+  start: () => void
+  stop: () => void
+}

package/lib/types.ts

@@ -0,0 +1,66 @@
+// Shared types for ClawPort
+
+export interface Agent {
+  id: string               // slug, e.g. "vera"
+  name: string             // display name, e.g. "VERA"
+  title: string            // role title, e.g. "Chief Strategy Officer"
+  reportsTo: string | null // parent agent id (null for root orchestrator)
+  directReports: string[]  // child agent ids
+  soulPath: string | null  // absolute path to SOUL.md
+  soul: string | null      // full SOUL.md content
+  voiceId: string | null   // ElevenLabs voice ID
+  color: string            // hex color for node
+  emoji: string            // emoji identifier
+  tools: string[]          // list of tools this agent has access to
+  crons: CronJob[]         // associated cron jobs
+  memoryPath: string | null
+  description: string      // one-liner description
+}
+
+export interface CronDelivery {
+  mode: string
+  channel: string
+  to: string | null
+}
+
+export interface CronRun {
+  ts: number
+  jobId: string
+  status: 'ok' | 'error'
+  summary: string | null
+  error: string | null
+  durationMs: number
+  deliveryStatus: string | null
+}
+
+export interface CronJob {
+  id: string
+  name: string
+  schedule: string              // raw cron expression
+  scheduleDescription: string   // human-readable (e.g., "Daily at 8 AM")
+  timezone: string | null       // extracted from schedule object if present
+  status: 'ok' | 'error' | 'idle'
+  lastRun: string | null
+  nextRun: string | null
+  lastError: string | null
+  agentId: string | null        // which agent this belongs to (matched by name)
+  description: string | null
+  enabled: boolean
+  delivery: CronDelivery | null
+  lastDurationMs: number | null
+  consecutiveErrors: number
+  lastDeliveryStatus: string | null
+}
+
+export interface ChatMessage {
+  role: 'user' | 'assistant'
+  content: string
+  timestamp: number
+}
+
+export interface MemoryFile {
+  label: string
+  path: string
+  content: string
+  lastModified: string
+}

package/lib/utils.ts

@@ -0,0 +1,6 @@
+import { clsx, type ClassValue } from "clsx"
+import { twMerge } from "tailwind-merge"
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs))
+}

package/lib/validation.test.ts

@@ -0,0 +1,132 @@
+import { describe, it, expect } from 'vitest'
+import { validateMessages, validateChatMessages } from './validation'
+
+// --- validateMessages ---
+
+describe('validateMessages', () => {
+  it('accepts plain text messages', () => {
+    const result = validateMessages([
+      { role: 'user', content: 'hello' },
+      { role: 'assistant', content: 'hi there' },
+    ])
+    expect(result).toHaveLength(2)
+    expect(result[0].content).toBe('hello')
+  })
+
+  it('accepts multimodal content array with text parts', () => {
+    const result = validateMessages([
+      { role: 'user', content: [{ type: 'text', text: 'describe this' }] },
+    ])
+    expect(result).toHaveLength(1)
+    expect(Array.isArray(result[0].content)).toBe(true)
+  })
+
+  it('accepts image_url content parts', () => {
+    const result = validateMessages([
+      {
+        role: 'user',
+        content: [
+          { type: 'text', text: 'what is this?' },
+          { type: 'image_url', image_url: { url: 'data:image/png;base64,abc123' } },
+        ],
+      },
+    ])
+    expect(result).toHaveLength(1)
+    const parts = result[0].content as Array<{ type: string }>
+    expect(parts).toHaveLength(2)
+    expect(parts[1].type).toBe('image_url')
+  })
+
+  it('accepts system role messages', () => {
+    const result = validateMessages([
+      { role: 'system', content: 'You are helpful.' },
+    ])
+    expect(result[0].role).toBe('system')
+  })
+
+  it('throws on non-array input', () => {
+    expect(() => validateMessages('not an array')).toThrow('must be an array')
+  })
+
+  it('throws on invalid role', () => {
+    expect(() => validateMessages([{ role: 'admin', content: 'hi' }])).toThrow('role')
+  })
+
+  it('throws on missing content', () => {
+    expect(() => validateMessages([{ role: 'user' }])).toThrow('content')
+  })
+
+  it('throws on number content', () => {
+    expect(() => validateMessages([{ role: 'user', content: 42 }])).toThrow('content')
+  })
+
+  it('throws on empty content array', () => {
+    expect(() => validateMessages([{ role: 'user', content: [] }])).toThrow('content')
+  })
+
+  it('throws on malformed content part (missing type)', () => {
+    expect(() => validateMessages([
+      { role: 'user', content: [{ text: 'no type field' }] },
+    ])).toThrow('content')
+  })
+
+  it('throws on invalid content part type', () => {
+    expect(() => validateMessages([
+      { role: 'user', content: [{ type: 'video', url: 'x' }] },
+    ])).toThrow('content')
+  })
+
+  it('throws on image_url part without url string', () => {
+    expect(() => validateMessages([
+      { role: 'user', content: [{ type: 'image_url', image_url: {} }] },
+    ])).toThrow('content')
+  })
+
+  it('throws on text part without text string', () => {
+    expect(() => validateMessages([
+      { role: 'user', content: [{ type: 'text', text: 123 }] },
+    ])).toThrow('content')
+  })
+
+  it('throws on non-object message', () => {
+    expect(() => validateMessages([null])).toThrow('must be an object')
+    expect(() => validateMessages(['string'])).toThrow('must be an object')
+  })
+})
+
+// --- validateChatMessages (legacy wrapper) ---
+
+describe('validateChatMessages', () => {
+  it('returns ok:true with validated messages', () => {
+    const result = validateChatMessages({
+      messages: [{ role: 'user', content: 'test' }],
+    })
+    expect(result.ok).toBe(true)
+    if (result.ok) {
+      expect(result.messages).toHaveLength(1)
+    }
+  })
+
+  it('returns ok:false for non-object body', () => {
+    const result = validateChatMessages(null)
+    expect(result.ok).toBe(false)
+  })
+
+  it('returns ok:false for invalid messages', () => {
+    const result = validateChatMessages({ messages: 'not an array' })
+    expect(result.ok).toBe(false)
+  })
+
+  it('accepts multimodal messages through legacy wrapper', () => {
+    const result = validateChatMessages({
+      messages: [{
+        role: 'user',
+        content: [
+          { type: 'text', text: 'check this' },
+          { type: 'image_url', image_url: { url: 'data:image/png;base64,x' } },
+        ],
+      }],
+    })
+    expect(result.ok).toBe(true)
+  })
+})

package/lib/validation.ts

@@ -0,0 +1,80 @@
+// Validation for chat API messages — supports both plain text and multimodal (vision) content
+
+export type TextContentPart = { type: 'text'; text: string }
+export type ImageContentPart = { type: 'image_url'; image_url: { url: string } }
+export type ContentPart = TextContentPart | ImageContentPart
+
+export type MessageContent = string | ContentPart[]
+
+export interface ApiMessage {
+  role: 'user' | 'assistant' | 'system'
+  content: MessageContent
+}
+
+function isValidContentPart(part: unknown): part is ContentPart {
+  if (typeof part !== 'object' || part === null) return false
+  const p = part as Record<string, unknown>
+
+  if (p.type === 'text') {
+    return typeof p.text === 'string'
+  }
+
+  if (p.type === 'image_url') {
+    const imgUrl = p.image_url
+    if (typeof imgUrl !== 'object' || imgUrl === null) return false
+    return typeof (imgUrl as Record<string, unknown>).url === 'string'
+  }
+
+  return false
+}
+
+function isValidContent(content: unknown): content is MessageContent {
+  if (typeof content === 'string') return true
+
+  if (Array.isArray(content)) {
+    return content.length > 0 && content.every(isValidContentPart)
+  }
+
+  return false
+}
+
+export function validateMessages(messages: unknown): ApiMessage[] {
+  if (!Array.isArray(messages)) {
+    throw new Error('messages must be an array')
+  }
+
+  return messages.map((msg, i) => {
+    if (typeof msg !== 'object' || msg === null) {
+      throw new Error(`messages[${i}] must be an object`)
+    }
+
+    const m = msg as Record<string, unknown>
+
+    if (typeof m.role !== 'string' || !['user', 'assistant', 'system'].includes(m.role)) {
+      throw new Error(`messages[${i}].role must be "user", "assistant", or "system"`)
+    }
+
+    if (!isValidContent(m.content)) {
+      throw new Error(`messages[${i}].content must be a string or array of content parts`)
+    }
+
+    return { role: m.role as ApiMessage['role'], content: m.content as MessageContent }
+  })
+}
+
+// Legacy export for backward compatibility with existing test
+export type ValidatedChatMessage = ApiMessage
+export type ValidationResult = { ok: true; messages: ApiMessage[] } | { ok: false; error: string }
+
+export function validateChatMessages(body: unknown): ValidationResult {
+  if (body === null || typeof body !== 'object') {
+    return { ok: false, error: 'Request body must be a JSON object.' }
+  }
+  const { messages } = body as Record<string, unknown>
+  try {
+    const validated = validateMessages(messages)
+    return { ok: true, messages: validated }
+  } catch (err) {
+    return { ok: false, error: err instanceof Error ? err.message : 'Invalid messages' }
+  }
+}

package/next.config.ts

@@ -0,0 +1,7 @@
+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {
+  /* config options here */
+};
+
+export default nextConfig;

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "clawport-ui",
+  "version": "0.1.0",
+  "description": "Open-source dashboard for managing, monitoring, and chatting with your OpenClaw AI agents.",
+  "homepage": "https://clawport.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/openclaw/clawport.git"
+  },
+  "bugs": {
+    "url": "https://github.com/openclaw/clawport/issues"
+  },
+  "keywords": [
+    "openclaw",
+    "ai-agents",
+    "dashboard",
+    "clawport",
+    "agent-management",
+    "next.js"
+  ],
+  "license": "MIT",
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "test": "vitest run",
+    "setup": "node scripts/setup.mjs"
+  },
+  "dependencies": {
+    "@xyflow/react": "^12.10.1",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "lucide-react": "^0.575.0",
+    "next": "16.1.6",
+    "openai": "^6.25.0",
+    "radix-ui": "^1.4.3",
+    "react": "19.2.3",
+    "react-dom": "19.2.3",
+    "tailwind-merge": "^3.5.0"
+  },
+  "devDependencies": {
+    "@tailwindcss/postcss": "^4",
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.2",
+    "@types/node": "^20",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "@vitejs/plugin-react": "^5.1.4",
+    "jsdom": "^28.1.0",
+    "shadcn": "^3.8.5",
+    "tailwindcss": "^4",
+    "tw-animate-css": "^1.4.0",
+    "typescript": "^5",
+    "vitest": "^4.0.18"
+  }
+}

package/postcss.config.mjs

@@ -0,0 +1,7 @@
+const config = {
+  plugins: {
+    "@tailwindcss/postcss": {},
+  },
+};
+
+export default config;

package/public/file.svg

@@ -0,0 +1 @@
+<svg fill="none" viewBox="0 0 16 16" xmlns="http://www.w3.org/2000/svg"><path d="M14.5 13.5V5.41a1 1 0 0 0-.3-.7L9.8.29A1 1 0 0 0 9.08 0H1.5v13.5A2.5 2.5 0 0 0 4 16h8a2.5 2.5 0 0 0 2.5-2.5m-1.5 0v-7H8v-5H3v12a1 1 0 0 0 1 1h8a1 1 0 0 0 1-1M9.5 5V2.12L12.38 5zM5.13 5h-.62v1.25h2.12V5zm-.62 3h7.12v1.25H4.5zm.62 3h-.62v1.25h7.12V11z" clip-rule="evenodd" fill="#666" fill-rule="evenodd"/></svg>

package/public/globe.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><g clip-path="url(#a)"><path fill-rule="evenodd" clip-rule="evenodd" d="M10.27 14.1a6.5 6.5 0 0 0 3.67-3.45q-1.24.21-2.7.34-.31 1.83-.97 3.1M8 16A8 8 0 1 0 8 0a8 8 0 0 0 0 16m.48-1.52a7 7 0 0 1-.96 0H7.5a4 4 0 0 1-.84-1.32q-.38-.89-.63-2.08a40 40 0 0 0 3.92 0q-.25 1.2-.63 2.08a4 4 0 0 1-.84 1.31zm2.94-4.76q1.66-.15 2.95-.43a7 7 0 0 0 0-2.58q-1.3-.27-2.95-.43a18 18 0 0 1 0 3.44m-1.27-3.54a17 17 0 0 1 0 3.64 39 39 0 0 1-4.3 0 17 17 0 0 1 0-3.64 39 39 0 0 1 4.3 0m1.1-1.17q1.45.13 2.69.34a6.5 6.5 0 0 0-3.67-3.44q.65 1.26.98 3.1M8.48 1.5l.01.02q.41.37.84 1.31.38.89.63 2.08a40 40 0 0 0-3.92 0q.25-1.2.63-2.08a4 4 0 0 1 .85-1.32 7 7 0 0 1 .96 0m-2.75.4a6.5 6.5 0 0 0-3.67 3.44 29 29 0 0 1 2.7-.34q.31-1.83.97-3.1M4.58 6.28q-1.66.16-2.95.43a7 7 0 0 0 0 2.58q1.3.27 2.95.43a18 18 0 0 1 0-3.44m.17 4.71q-1.45-.12-2.69-.34a6.5 6.5 0 0 0 3.67 3.44q-.65-1.27-.98-3.1" fill="#666"/></g><defs><clipPath id="a"><path fill="#fff" d="M0 0h16v16H0z"/></clipPath></defs></svg>

package/public/next.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 394 80"><path fill="#000" d="M262 0h68.5v12.7h-27.2v66.6h-13.6V12.7H262V0ZM149 0v12.7H94v20.4h44.3v12.6H94v21h55v12.6H80.5V0h68.7zm34.3 0h-17.8l63.8 79.4h17.9l-32-39.7 32-39.6h-17.9l-23 28.6-23-28.6zm18.3 56.7-9-11-27.1 33.7h17.8l18.3-22.7z"/><path fill="#000" d="M81 79.3 17 0H0v79.3h13.6V17l50.2 62.3H81Zm252.6-.4c-1 0-1.8-.4-2.5-1s-1.1-1.6-1.1-2.6.3-1.8 1-2.5 1.6-1 2.6-1 1.8.3 2.5 1a3.4 3.4 0 0 1 .6 4.3 3.7 3.7 0 0 1-3 1.8zm23.2-33.5h6v23.3c0 2.1-.4 4-1.3 5.5a9.1 9.1 0 0 1-3.8 3.5c-1.6.8-3.5 1.3-5.7 1.3-2 0-3.7-.4-5.3-1s-2.8-1.8-3.7-3.2c-.9-1.3-1.4-3-1.4-5h6c.1.8.3 1.6.7 2.2s1 1.2 1.6 1.5c.7.4 1.5.5 2.4.5 1 0 1.8-.2 2.4-.6a4 4 0 0 0 1.6-1.8c.3-.8.5-1.8.5-3V45.5zm30.9 9.1a4.4 4.4 0 0 0-2-3.3 7.5 7.5 0 0 0-4.3-1.1c-1.3 0-2.4.2-3.3.5-.9.4-1.6 1-2 1.6a3.5 3.5 0 0 0-.3 4c.3.5.7.9 1.3 1.2l1.8 1 2 .5 3.2.8c1.3.3 2.5.7 3.7 1.2a13 13 0 0 1 3.2 1.8 8.1 8.1 0 0 1 3 6.5c0 2-.5 3.7-1.5 5.1a10 10 0 0 1-4.4 3.5c-1.8.8-4.1 1.2-6.8 1.2-2.6 0-4.9-.4-6.8-1.2-2-.8-3.4-2-4.5-3.5a10 10 0 0 1-1.7-5.6h6a5 5 0 0 0 3.5 4.6c1 .4 2.2.6 3.4.6 1.3 0 2.5-.2 3.5-.6 1-.4 1.8-1 2.4-1.7a4 4 0 0 0 .8-2.4c0-.9-.2-1.6-.7-2.2a11 11 0 0 0-2.1-1.4l-3.2-1-3.8-1c-2.8-.7-5-1.7-6.6-3.2a7.2 7.2 0 0 1-2.4-5.7 8 8 0 0 1 1.7-5 10 10 0 0 1 4.3-3.5c2-.8 4-1.2 6.4-1.2 2.3 0 4.4.4 6.2 1.2 1.8.8 3.2 2 4.3 3.4 1 1.4 1.5 3 1.5 5h-5.8z"/></svg>

package/public/vercel.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1155 1000"><path d="m577.3 0 577.4 1000H0z" fill="#fff"/></svg>

package/public/window.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path fill-rule="evenodd" clip-rule="evenodd" d="M1.5 2.5h13v10a1 1 0 0 1-1 1h-11a1 1 0 0 1-1-1zM0 1h16v11.5a2.5 2.5 0 0 1-2.5 2.5h-11A2.5 2.5 0 0 1 0 12.5zm3.75 4.5a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5M7 4.75a.75.75 0 1 1-1.5 0 .75.75 0 0 1 1.5 0m1.75.75a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5" fill="#666"/></svg>