@mazees/mark 5.0.0

package/src/renderer/src/utils/chatContentParser.js

@@ -0,0 +1,203 @@
+/**
+ * chatContentParser.js
+ * Helper murni untuk parsing dan transformasi teks pada ChatList
+ * Memisahkan pemrosesan regex & parsing XML dari siklus render React
+ */
+import { stripMarkTags } from '@shared/parsers/mark-tag-parser.js'
+
+/**
+ * Parsing teks pesan user: bersihkan instruksi internal skill dan ambil tag skill
+ */
+export function parseUserContent(content) {
+  let displayUserContent = content
+  let extractedSkillTag = null
+
+  if (typeof content === 'string') {
+    if (content.includes('=== SYSTEM INSTRUCTION: SKILL DIAKTIFKAN ===')) {
+      const parts = content.split('=== SYSTEM INSTRUCTION: SKILL DIAKTIFKAN ===')
+      const promptPart = (parts[0] || '').trim()
+
+      const skillTagMatch = content.match(
+        /---\s*SKILL\s+(?:BAWAAN|EXTERNAL):\s*([a-zA-Z0-9_-]+)\s*---/i
+      )
+      if (skillTagMatch) {
+        extractedSkillTag = skillTagMatch[1].toLowerCase()
+      }
+
+      displayUserContent =
+        promptPart || (extractedSkillTag ? `/${extractedSkillTag}` : 'Jalankan Skill')
+    }
+  } else if (Array.isArray(content)) {
+    displayUserContent = content.map((item) => {
+      if (item && item.type === 'text' && typeof item.text === 'string') {
+        if (item.text.includes('=== SYSTEM INSTRUCTION: SKILL DIAKTIFKAN ===')) {
+          const parts = item.text.split('=== SYSTEM INSTRUCTION: SKILL DIAKTIFKAN ===')
+          const promptPart = (parts[0] || '').trim()
+
+          const skillTagMatch = item.text.match(
+            /---\s*SKILL\s+(?:BAWAAN|EXTERNAL):\s*([a-zA-Z0-9_-]+)\s*---/i
+          )
+          if (skillTagMatch) {
+            extractedSkillTag = skillTagMatch[1].toLowerCase()
+          }
+
+          return {
+            ...item,
+            text: promptPart || (extractedSkillTag ? `/${extractedSkillTag}` : 'Jalankan Skill')
+          }
+        }
+      }
+      return item
+    })
+  }
+
+  if (typeof displayUserContent === 'string') {
+    displayUserContent = displayUserContent.replace(/(?:<mic>|\(Mikrofon\))\s*/gi, '').trim()
+  } else if (Array.isArray(displayUserContent)) {
+    displayUserContent = displayUserContent.map((item) => {
+      if (item && item.type === 'text' && typeof item.text === 'string') {
+        return {
+          ...item,
+          text: item.text.replace(/(?:<mic>|\(Mikrofon\))\s*/gi, '').trim()
+        }
+      }
+      return item
+    })
+  }
+
+  return { displayUserContent, extractedSkillTag }
+}
+
+/**
+ * Parsing konten AI: ekstraksi widget aksi bawaan (<FollowUp>, <ElicitationsGroup>, dll.)
+ * serta pembersihan tag XML internal dengan perlindungan terhadap code block markdown
+ */
+export function parseAiContent(content) {
+  if (typeof content !== 'string') {
+    return {
+      cleanAiContent: content || '',
+      followUpChips: [],
+      elicitationGroup: null
+    }
+  }
+
+  // 1. Code Block Shielding: Pisahkan blok kode agar tag XML di dalam contoh kode tidak ikut terhapus
+  const codeBlocks = []
+  let maskedContent = content.replace(/(```[\s\S]*?```|`[^`\n]+`)/g, (match) => {
+    codeBlocks.push(match)
+    return `__CODE_BLOCK_${codeBlocks.length - 1}__`
+  })
+
+  // Bersihkan tag kontrol (<mark ... />, legacy mood)
+  maskedContent = stripMarkTags(maskedContent)
+
+  let elicitationGroup = null
+
+  // 2. Ekstraksi <ElicitationsGroup message="..."> ... </ElicitationsGroup>
+  const groupRegex = /<ElicitationsGroup\b([^>]*?)>([\s\S]*?)<\/ElicitationsGroup>/i
+  const groupMatch = groupRegex.exec(maskedContent)
+  if (groupMatch) {
+    const groupAttrs = groupMatch[1] || ''
+    const groupBody = groupMatch[2] || ''
+
+    const msgMatch = groupAttrs.match(/message=(?:"([^"]*)"|'([^']*)')/i)
+    const groupMessage = msgMatch ? (msgMatch[1] || msgMatch[2] || '').trim() : null
+
+    const options = []
+    const optRegex = /<([A-Za-z0-9_-]+)\b([^>]*?)(?:\/>|>([\s\S]*?)<\/\1>)/g
+    let optMatch
+    while ((optMatch = optRegex.exec(groupBody)) !== null) {
+      const attrsStr = optMatch[2] || ''
+      const bodyStr = (optMatch[3] || '').trim()
+      const labelMatch = attrsStr.match(/label=(?:"([^"]*)"|'([^']*)')/i)
+      const queryMatch = attrsStr.match(/query=(?:"([^"]*)"|'([^']*)')/i)
+      const label = labelMatch ? labelMatch[1] || labelMatch[2] : bodyStr
+      const query = queryMatch ? queryMatch[1] || queryMatch[2] : null
+
+      if (label && query) {
+        options.push({ label: label.trim(), query: query.trim() })
+      }
+    }
+
+    if (options.length > 0) {
+      elicitationGroup = {
+        message: groupMessage,
+        options
+      }
+    }
+    maskedContent = maskedContent.replace(groupMatch[0], '')
+  }
+
+  // 3. Ekstraksi tag-tag saran mandiri / bebas: <FollowUp>, <Suggestion>, <SuggestedAction>, <Elicitation>
+  const followUpChips = []
+  const chipTagRegex =
+    /<(?:FollowUp|Suggestion|SuggestedAction|Elicitation)\b([^>]*?)(?:\/>|>([\s\S]*?)<\/(?:FollowUp|Suggestion|SuggestedAction|Elicitation)>)/gi
+  let chipMatch
+  while ((chipMatch = chipTagRegex.exec(maskedContent)) !== null) {
+    const fullTag = chipMatch[0]
+    const attrsStr = chipMatch[1] || ''
+    const bodyStr = (chipMatch[2] || '').trim()
+
+    const labelMatch = attrsStr.match(/label=(?:"([^"]*)"|'([^']*)')/i)
+    const queryMatch = attrsStr.match(/query=(?:"([^"]*)"|'([^']*)')/i)
+
+    const label = labelMatch ? labelMatch[1] || labelMatch[2] : bodyStr
+    const query = queryMatch ? queryMatch[1] || queryMatch[2] : null
+
+    if (label && query) {
+      followUpChips.push({ label: label.trim(), query: query.trim() })
+      maskedContent = maskedContent.replace(fullTag, '')
+    }
+  }
+
+  // 4. Bersihkan sisa tag XML internal non-teks lainnya (seperti <cite>, <source>, <grounding_metadata>)
+  maskedContent = maskedContent
+    .replace(
+      /<(?:cite|source|grounding_metadata|image_query|table_action|chart_spec|widget)\b[^>]*?(?:\/>|>[\s\S]*?<\/(?:cite|source|grounding_metadata|image_query|table_action|chart_spec|widget)>)/gi,
+      ''
+    )
+    .replace(/<[A-Za-z0-9_-]+(?:\s+[^>]*?)?>/g, (m) => (m.startsWith('<think') ? m : ''))
+    .replace(/<\/[A-Za-z0-9_-]+>/g, (m) => (m.startsWith('</think') ? m : ''))
+
+  // 5. Kembalikan blok kode yang dilindungi
+  codeBlocks.forEach((block, idx) => {
+    maskedContent = maskedContent.replace(`__CODE_BLOCK_${idx}__`, () => block)
+  })
+
+  const cleanAiContent = maskedContent.replace(/\n{3,}/g, '\n\n').trim()
+
+  return {
+    cleanAiContent,
+    followUpChips,
+    elicitationGroup
+  }
+}
+
+/**
+ * Parsing laporan subagent: ekstraksi artefak dan pembersihan header otomatis
+ */
+export function parseSubagentReport(content) {
+  let cleanReportContent = typeof content === 'string' ? content : JSON.stringify(content)
+  let artifactInfo = null
+
+  const artifactMatch = cleanReportContent.match(/\nArtefak:\s*(.+)$/m)
+  if (artifactMatch) {
+    artifactInfo = artifactMatch[1].trim()
+    cleanReportContent = cleanReportContent.replace(/\nArtefak:\s*(.+)$/m, '').trim()
+  }
+
+  const reportPrefixMatch = cleanReportContent.match(
+    /^\[SUB-AGENT REPORT RECEIVED\]:\s*Sub-agent\s*(@\w+)\s*telah menyelesaikan tugasnya dan melaporkan hasil berikut:\s*/i
+  )
+  if (reportPrefixMatch) {
+    cleanReportContent = cleanReportContent.substring(reportPrefixMatch[0].length).trim()
+    if (cleanReportContent.startsWith('"') && cleanReportContent.endsWith('"')) {
+      cleanReportContent = cleanReportContent.slice(1, -1).trim()
+    }
+  }
+
+  return {
+    cleanReportContent,
+    artifactInfo
+  }
+}

package/src/renderer/src/utils/toolClusters.js

@@ -0,0 +1,201 @@
+import { core_tools_schema } from '../api/tools/core-tools'
+import { webApi } from '../api/web-bridge'
+
+/**
+ * Format string cluster key menjadi judul display yang rapi & ramah dibaca
+ */
+export function formatClusterName(key) {
+  if (!key) return 'TOOLS'
+  return key.replace(/_/g, ' ').replace(/\b\w/g, (char) => char.toUpperCase())
+}
+
+/**
+ * Deterministic hash-based neon/holographic color generator
+ * Memberikan warna cerah/neon acak namun konsisten untuk setiap tool / cluster key.
+ */
+export function getDeterministicColor(str = '') {
+  let hash = 0
+  for (let i = 0; i < str.length; i++) {
+    hash = str.charCodeAt(i) + ((hash << 5) - hash)
+  }
+  // Ambil hue dari 0 - 360, saturasi tinggi 85-100%, lightness 55-65% untuk efek neon futuristik
+  const hue = Math.abs(hash % 360)
+  const sat = 85 + Math.abs((hash >> 3) % 15)
+  const light = 55 + Math.abs((hash >> 6) % 10)
+  return `hsl(${hue}, ${sat}%, ${light}%)`
+}
+
+/**
+ * Membangun registry kluster tools secara dinamis dari groupToolsSchema, core_tools_schema, & dynamicPlugins
+ */
+export function buildCompleteToolClusters(dynamicPlugins = [], groupToolsSchema = null) {
+  const effectiveSchema =
+    groupToolsSchema && Object.keys(groupToolsSchema).length > 0
+      ? groupToolsSchema
+      : webApi._groupToolsCache?.schema || {}
+  const clusters = []
+  const hasDynamicPlugins = Array.isArray(dynamicPlugins) && dynamicPlugins.length > 0
+
+  let currentRadius = 170
+  let isClockwise = true
+
+  // 1. Ambil seluruh tool groups dari groupToolsSchema
+  Object.entries(effectiveSchema).forEach(([groupKey, groupData]) => {
+    // Jika custom_plugins memiliki dynamic plugin terpasang, tangani terpisah di bawah
+    if (groupKey === 'custom_plugins' && hasDynamicPlugins) return
+
+    const clusterName = formatClusterName(groupKey)
+    const clusterColor = getDeterministicColor(groupKey)
+    const speed = (0.0008 - clusters.length * 0.00005) * (isClockwise ? 1 : -1)
+    isClockwise = !isClockwise
+
+    const tools = (groupData.tools || []).map((t) => {
+      const fn = t.function || t
+      return {
+        id: `tool-${fn.name}`,
+        name: fn.name,
+        label: fn.name.replace(/^(browser|os|gdrive|gcalendar|gmail|music|git|tg)-/, ''),
+        description: fn.description,
+        clusterKey: groupKey,
+        color: getDeterministicColor(fn.name),
+        matchTools: [fn.name, fn.name.replace(/-/g, '_'), fn.name.replace(/_/g, '-')]
+      }
+    })
+
+    clusters.push({
+      id: `cluster-${groupKey}`,
+      key: groupKey,
+      name: clusterName,
+      color: clusterColor,
+      radius: currentRadius,
+      speed: speed || 0.0004,
+      size: 6.5,
+      tools
+    })
+
+    currentRadius += 55
+  })
+
+  // 2. Kumpulkan core tools dari core_tools_schema yang belum ada di dalam group tools
+  const existingToolNames = new Set()
+  clusters.forEach((c) => c.tools.forEach((t) => existingToolNames.add(t.name)))
+
+  const subagentTools = []
+  const fileTools = []
+  const memoryTools = []
+  const coreControlTools = []
+
+  core_tools_schema.forEach((t) => {
+    const fn = t.function || t
+    if (existingToolNames.has(fn.name)) return
+
+    const item = {
+      id: `tool-${fn.name}`,
+      name: fn.name,
+      label: fn.name.replace(/^(browser|os|gdrive|gcalendar|gmail|music|git|tg)-/, ''),
+      description: fn.description,
+      color: getDeterministicColor(fn.name),
+      matchTools: [fn.name, fn.name.replace(/-/g, '_'), fn.name.replace(/_/g, '-')]
+    }
+
+    if (
+      fn.name.includes('subagent') ||
+      fn.name.includes('message_agent') ||
+      fn.name.includes('send_message') ||
+      fn.name.includes('report_to_lead')
+    ) {
+      item.clusterKey = 'subagents'
+      subagentTools.push(item)
+    } else if (
+      fn.name.includes('file') ||
+      fn.name.includes('replace') ||
+      fn.name.includes('list-dir') ||
+      fn.name.includes('find-files') ||
+      fn.name.includes('grep')
+    ) {
+      item.clusterKey = 'file_system'
+      fileTools.push(item)
+    } else if (
+      fn.name.includes('memory') ||
+      fn.name.includes('document') ||
+      fn.name.includes('skill')
+    ) {
+      item.clusterKey = 'memory_rag'
+      memoryTools.push(item)
+    } else {
+      item.clusterKey = 'core_system'
+      coreControlTools.push(item)
+    }
+  })
+
+  const additionalCoreGroups = [
+    { key: 'subagents', name: 'Sub-Agents', tools: subagentTools, size: 8 },
+    { key: 'file_system', name: 'File System', tools: fileTools, size: 7 },
+    { key: 'memory_rag', name: 'Memory RAG', tools: memoryTools, size: 6.5 },
+    { key: 'core_system', name: 'Core System', tools: coreControlTools, size: 6.5 }
+  ]
+
+  additionalCoreGroups.forEach((cg) => {
+    if (cg.tools.length > 0) {
+      const speed = (0.0008 - clusters.length * 0.00005) * (isClockwise ? 1 : -1)
+      isClockwise = !isClockwise
+
+      clusters.push({
+        id: `cluster-${cg.key}`,
+        key: cg.key,
+        name: cg.name,
+        color: getDeterministicColor(cg.key),
+        radius: currentRadius,
+        speed: speed || 0.0003,
+        size: cg.size,
+        tools: cg.tools
+      })
+      currentRadius += 55
+    }
+  })
+
+  // 3. Tambahkan Custom Plugins jika ada
+  if (Array.isArray(dynamicPlugins) && dynamicPlugins.length > 0) {
+    const pluginTools = []
+    dynamicPlugins.forEach((p) => {
+      if (p.isEnabled !== false && Array.isArray(p.actions)) {
+        p.actions.forEach((act) => {
+          const actionName = act.name
+          const fullPrefix = `plugin-${p.name}-${actionName}`
+          pluginTools.push({
+            id: `plugin-tool-${p.name}-${actionName}`,
+            name: `${p.name}/${actionName}`,
+            label: actionName,
+            description: act.description || p.description || `Custom plugin ${p.name}`,
+            clusterKey: 'custom_plugins',
+            color: getDeterministicColor(`${p.name}-${actionName}`),
+            matchTools: [
+              actionName,
+              fullPrefix,
+              `plugin-${actionName}`,
+              `plugin_${p.name}_${actionName}`,
+              `plugin_${actionName}`
+            ]
+          })
+        })
+      }
+    })
+
+    if (pluginTools.length > 0) {
+      const speed = (0.0008 - clusters.length * 0.00005) * (isClockwise ? 1 : -1)
+      clusters.push({
+        id: 'cluster-custom_plugins',
+        key: 'custom_plugins',
+        name: 'Custom Plugins',
+        color: getDeterministicColor('custom_plugins'),
+        radius: currentRadius,
+        speed: speed || -0.0002,
+        size: 7,
+        tools: pluginTools
+      })
+      currentRadius += 55
+    }
+  }
+
+  return clusters
+}

package/src/server/config-manager.js

@@ -0,0 +1,57 @@
+import path from 'path'
+import fs from 'fs'
+import os from 'os'
+
+const CONFIG_DIR = path.join(os.homedir(), '.config', 'mark-agent')
+const CONFIG_PATH = path.join(CONFIG_DIR, 'config.json')
+
+export function loadConfig() {
+  try {
+    if (fs.existsSync(CONFIG_PATH)) {
+      const raw = fs.readFileSync(CONFIG_PATH, 'utf-8')
+      return JSON.parse(raw)
+    }
+  } catch (_) {}
+  return {
+    aiProvider: 'gemini-web',
+    geminiWebModel: 'gemini-3.6-flash',
+    model: 'local-model',
+    customModel: 'default-model',
+    temperature: 0.7,
+    wakeWordEnabled: true,
+    wakeWord: 'mark',
+    voiceEnabled: true,
+    voice: 'id-ID-ArdiNeural'
+  }
+}
+
+export function saveConfig(newConfig) {
+  try {
+    if (!fs.existsSync(CONFIG_DIR)) {
+      fs.mkdirSync(CONFIG_DIR, { recursive: true })
+    }
+    fs.writeFileSync(CONFIG_PATH, JSON.stringify(newConfig, null, 2), 'utf-8')
+    return true
+  } catch (_) {
+    return false
+  }
+}
+
+let activeConfig = loadConfig()
+
+export function reloadConfig() {
+  activeConfig = loadConfig()
+  return activeConfig
+}
+
+export function getActiveConfig(forceReload = false) {
+  if (forceReload) {
+    return reloadConfig()
+  }
+  return activeConfig
+}
+
+export function setActiveConfig(newConfig) {
+  activeConfig = newConfig
+  return activeConfig
+}

package/src/server/index.js

@@ -0,0 +1,195 @@
+import http from 'http'
+import path from 'path'
+import fs from 'fs'
+import { fileURLToPath } from 'url'
+import express from 'express'
+import cors from 'cors'
+import { wsHub } from './ws-hub.js'
+import { launchUI } from './launcher.js'
+import { initOramaIndices } from './memory/orama-store.js'
+import { dbStore } from './memory/db-store.js'
+import { loadAllPlugins } from '../main/plugins/plugin-loader.js'
+import { startOsActivityTracking } from './tools/awareness-tracker.js'
+import { startTelegramBot } from '../main/telegram/telegram-service.js'
+import { getActiveConfig } from './config-manager.js'
+import { registerRoutes } from './routes/index.js'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
+
+// Global crash safety: prevent unhandled promise rejections from crashing the server
+process.on('unhandledRejection', (reason) => {
+  console.warn(
+    '[Server Warning] Handled UnhandledRejection:',
+    typeof reason === 'string' ? reason : reason?.message || reason
+  )
+})
+
+process.on('uncaughtException', (err) => {
+  console.error('[Server Error] Handled UncaughtException:', err?.message || err)
+})
+
+// Filter out DaisyUI CSS banner from leaking into stdout
+const _origStdoutWrite = process.stdout.write.bind(process.stdout)
+process.stdout.write = (chunk, encoding, callback) => {
+  const str = typeof chunk === 'string' ? chunk : chunk ? chunk.toString() : ''
+  if (str.includes('daisyUI') || str.includes('daisyui')) {
+    return typeof callback === 'function' ? callback() : true
+  }
+  return _origStdoutWrite(chunk, encoding, callback)
+}
+
+const PORT = process.env.PORT || 3000
+const app = express()
+const server = http.createServer(app)
+
+const allowedOrigins = [/^http:\/\/localhost(:\d+)?$/, /^http:\/\/127\.0\.0\.1(:\d+)?$/]
+
+// --- Middleware ---
+app.use(
+  cors({
+    origin: (origin, callback) => {
+      // Izinkan request tanpa origin (seperti Edge App Mode, native HTTP/CLI, bot)
+      if (!origin) return callback(null, true)
+      const isAllowed = allowedOrigins.some((pattern) => pattern.test(origin))
+      if (isAllowed) {
+        callback(null, true)
+      } else {
+        callback(new Error('Akses diblokir oleh kebijakan CORS MARK'))
+      }
+    },
+    credentials: true
+  })
+)
+app.use(express.json({ limit: '50mb' }))
+app.use(express.urlencoded({ extended: true, limit: '50mb' }))
+
+// Inisialisasi WebSocket Hub, Orama, Plugins & Awareness Tracking
+wsHub.init(server)
+initOramaIndices().catch(() => {})
+loadAllPlugins().catch((e) => console.error('[Plugin Init Error]:', e))
+startOsActivityTracking(10000)
+
+// Daftarkan listener event abort dari WebSocket
+wsHub.on('ai:abort', async () => {
+  try {
+    const { abortAllFetches } = await import('./services/ai-bridge.js')
+    abortAllFetches()
+  } catch (_) {}
+  return { success: true }
+})
+
+// Relaying WebSocket events dari client (misal: subagent:report) ke semua client
+wsHub.on('ws:broadcast', async (payload) => {
+  const { event, data } = payload || {}
+  if (event) {
+    wsHub.broadcast(event, data)
+  }
+  return { success: true }
+})
+
+const activeConfig = getActiveConfig()
+
+// Auto-start Telegram Bot pada booting server jika token tersedia
+try {
+  const configs = dbStore.config.getAll()
+  const dbCfg = configs[0] || {}
+  const unpackedCfg =
+    dbCfg.data && typeof dbCfg.data === 'object' ? { ...dbCfg, ...dbCfg.data } : dbCfg
+  const initialTgToken = unpackedCfg.tgBotToken || activeConfig.tgBotToken
+  if (initialTgToken && initialTgToken.trim()) {
+    console.log('[Telegram] Mengaktifkan bot secara otomatis dari konfigurasi server...')
+    startTelegramBot(initialTgToken.trim()).catch((err) => {
+      console.error('[Telegram] Gagal auto-start bot:', err.message)
+    })
+  }
+} catch (err) {
+  console.warn('[Telegram] Gagal membaca konfigurasi awal bot:', err.message)
+}
+
+// --- Register Modular REST API Routes ---
+registerRoutes(app)
+
+// --- WebUI Serving (Vite Dev Middleware atau Production Build) ---
+const staticDir = path.resolve(__dirname, '../../out/renderer')
+const rootDir = path.resolve(__dirname, '../../')
+const rendererDir = path.resolve(__dirname, '../renderer')
+
+async function setupWebUIServing() {
+  const isDev = process.env.NODE_ENV === 'development' || process.argv.includes('--dev')
+
+  if (!isDev && fs.existsSync(path.join(staticDir, 'index.html'))) {
+    app.use(express.static(staticDir))
+    app.get('*', (req, res, next) => {
+      if (req.path.startsWith('/api') || req.path.startsWith('/stream')) return next()
+      res.sendFile(path.join(staticDir, 'index.html'))
+    })
+  } else {
+    try {
+      const { createServer: createViteServer } = await import('vite')
+      const vite = await createViteServer({
+        root: rendererDir,
+        configFile: path.join(rootDir, 'vite.config.js'),
+        server: { middlewareMode: true, hmr: { port: 24679 } },
+        appType: 'spa'
+      })
+      app.use(vite.middlewares)
+
+      // Sajikan index.html yang ditransformasikan secara live oleh Vite
+      app.use('*', async (req, res, next) => {
+        if (req.path.startsWith('/api') || req.path.startsWith('/stream')) return next()
+        const url = req.originalUrl
+        try {
+          let template = fs.readFileSync(path.resolve(rendererDir, 'index.html'), 'utf-8')
+          template = await vite.transformIndexHtml(url, template)
+          res.status(200).set({ 'Content-Type': 'text/html' }).end(template)
+        } catch (e) {
+          next(e)
+        }
+      })
+    } catch (err) {
+      console.error('[WebUI Setup Error]:', err)
+    }
+  }
+}
+
+// Inisialisasi penyajian WebUI
+await setupWebUIServing()
+
+// --- Start Server dengan Auto-Fallback Port jika terjadi EADDRINUSE ---
+const HOST = process.env.HOST || '127.0.0.1'
+let activePort = Number(PORT)
+
+function startServer(portToTry) {
+  server.listen(portToTry, HOST)
+}
+
+server.on('listening', async () => {
+  const address = server.address()
+  activePort = typeof address === 'object' && address ? address.port : activePort
+  const activeHost = typeof address === 'object' && address?.address ? address.address : HOST
+  app.set('port', activePort)
+  console.log(`\n======================================================`)
+  console.log(`  Menyalakan Server MARK di http://${activeHost}:${activePort}`)
+  console.log(`======================================================\n`)
+
+  if (!process.argv.includes('--no-launch') && !process.argv.includes('--headless')) {
+    await launchUI({ port: activePort, mode: 'app' })
+  }
+})
+
+server.on('error', (err) => {
+  if (err.code === 'EADDRINUSE') {
+    console.warn(
+      `[Port Manager] Port ${activePort} sedang digunakan aplikasi lain. Mencoba port ${activePort + 1}...`
+    )
+    activePort += 1
+    setTimeout(() => startServer(activePort), 200)
+  } else {
+    console.error('[Server Error]', err)
+  }
+})
+
+startServer(activePort)
+
+export { app, server, wsHub, activeConfig, activePort }