sanook-cli 0.5.2 → 0.5.5

package/dist/commands.js

@@ -6,16 +6,25 @@ import { parseFrontmatter } from './skills.js';
 import { projectConfigPathIfTrusted } from './trust.js';
 import { normalizePersonalityName, personalityListText } from './personality.js';
 import { parseInsightsArgs } from './insights-args.js';
-const HELP_TEXT = `คำสั่ง:
+import { formatHotkeys } from './hotkeys.js';
+import { formatToolCatalog } from './tool-catalog.js';
+export const HELP_TEXT = `คำสั่ง:
   /help            แสดงคำสั่งทั้งหมด
   /new, /reset      เริ่มบทสนทนาใหม่
   /status          ดูสถานะ session ปัจจุบัน
-  /model [spec]    ดู/เปลี่ยน model (เช่น /model opus, /model openai:gpt-5)
+  /model [spec]    ดู/เปลี่ยน model — /model เปิด picker 2 ขั้น (provider → model)
+  /setup           ดูขั้นตอน setup wizard (model · agent · tools · gateway · brain)
+  /dashboard       เปิด Sanook Dashboard (local web UI)
   /personality [name]
                    ดู/ตั้ง personality overlay
+  /details [thinking|tools] [hidden|collapsed|expanded]
+                   คุมแผง thinking/tool trail แบบ Hermes-style
   /platforms       ดู providers + messaging platforms ที่รองรับ
   /tools           ดู tools ที่ agent ใช้ได้
-  /skills          ดูจำนวน skills (จัดการ: ${BRAND.cliName} skill list)
+  /mcp             เปิด MCP Hub overlay
+  /skills          เปิด Skills Hub overlay (จัดการ: ${BRAND.cliName} skill list)
+  /sessions        เปิด Session Switcher overlay · /trail พับ/ขยาย tool trail
+  /tasks           ดู background sub-agents (task_spawn)
   /diff            ดู git diff (สิ่งที่ agent แก้ในรอบนี้)
   /retry           รัน prompt ล่าสุดอีกครั้ง
   /stop            หยุด turn ที่กำลังรัน
@@ -24,6 +33,8 @@ const HELP_TEXT = `คำสั่ง:
   /cost, /usage     ดู token + cost รอบล่าสุด
   /insights [--days N] [--all]
                    ดู usage/session insights ในเครื่อง
+  /hotkeys         เปิด overlay คีย์ลัดใน REPL
+  /copy [last]     copy คำตอบ assistant ล่าสุดไป clipboard/OSC52
   ↑/↓ ประวัติ · @ไฟล์ แนบ context/รูป · \\ ลงท้าย = บรรทัดใหม่
   /clear           ล้าง conversation (เริ่มใหม่)
   /compact, /compress
@@ -37,14 +48,6 @@ const HELP_TEXT = `คำสั่ง:
 custom commands:
   ~/.sanook/commands/<name>.md และ .sanook/commands/<name>.md (project ต้อง trust ก่อน)
   args: ใช้ $ARGUMENTS หรือ {{ args }}; ถ้าไม่มี placeholder จะ append args ต่อท้าย`;
-const TOOLS_LIST = [
-    'read_file (offset/limit) write_file edit_file (replace_all) list_dir glob grep run_bash',
-    'git_status git_diff git_log git_commit',
-    'remember recall · skill find_skills create_skill',
-    'schedule_task list_scheduled cancel_scheduled',
-    'task task_parallel task_spawn task_collect task_cancel task_status   ← sub-agent (ขนาน/background)',
-    'diagnostics   ← type error/lint จาก language server (LSP)',
-].join('\n  ');
 const MESSAGING_PLATFORMS = [
     'telegram',
     'discord',
@@ -167,16 +170,42 @@ export function parseCommand(input, ctx) {
             return { handled: true, action: 'clear', message: 'ล้าง conversation แล้ว' };
         case 'status':
             return { handled: true, message: statusMenu(ctx) };
+        case 'hotkeys':
+            return { handled: true, action: 'hotkeys', message: formatHotkeys() };
         case 'compact':
         case 'compress':
             return { handled: true, action: 'compact', message: 'บีบ context แล้ว' };
+        case 'copy': {
+            const target = args[0]?.toLowerCase();
+            if (!target || target === 'last' || target === 'assistant')
+                return { handled: true, action: 'copyLast' };
+            return { handled: true, message: 'ใช้ /copy หรือ /copy last' };
+        }
         case 'quit':
         case 'exit':
             return { handled: true, action: 'quit' };
         case 'model':
             if (!args[0])
-                return { handled: true, message: modelMenu(ctx.model) };
+                return { handled: true, action: 'modelPicker', message: modelMenu(ctx.model) };
             return modelChange(args[0]);
+        case 'setup':
+            return {
+                handled: true,
+                message: [
+                    `${BRAND.productName} setup (Hermes-style sections):`,
+                    `  1. ${BRAND.cliName} setup model     — provider + model wizard`,
+                    `  2. ${BRAND.cliName} setup agent     — permissionMode, budget, personality`,
+                    `  3. ${BRAND.cliName} setup tools     — built-in tools + MCP`,
+                    `  4. ${BRAND.cliName} setup gateway   — Telegram/Discord/Slack/…`,
+                    `  5. ${BRAND.cliName} setup brain     — second-brain vault`,
+                    `  หรือรัน ${BRAND.cliName} ครั้งแรก → wizard 10 ขั้น (ภาษา → … → gateway → brain)`,
+                ].join('\n'),
+            };
+        case 'dashboard':
+            return {
+                handled: true,
+                message: `Sanook Dashboard — รัน: ${BRAND.cliName} dashboard\n  แล้วเปิด http://127.0.0.1:9119 (Chat · Files · Logs · Cron · Channels)`,
+            };
         case 'personality': {
             const raw = args.join(' ').trim();
             if (!raw)
@@ -192,11 +221,55 @@ export function parseCommand(input, ctx) {
             };
         }
         case 'tools':
-            return { handled: true, message: `tools ที่ agent ใช้ได้ (+ MCP ที่ตั้งไว้):\n  ${TOOLS_LIST}` };
+            return { handled: true, action: 'toolsHub', message: `tools ที่ agent ใช้ได้ (+ MCP ที่ตั้งไว้):\n  ${formatToolCatalog()}` };
+        case 'trail': {
+            const rawMode = args[0]?.toLowerCase();
+            if (!rawMode)
+                return { handled: true, action: 'toolTrail', message: 'toggle tool trail view' };
+            if (['compact', 'collapse', 'collapsed', 'hide', 'summary'].includes(rawMode)) {
+                return { handled: true, action: 'toolTrail', message: 'tool trail → compact', toolTrailMode: 'compact' };
+            }
+            if (['expanded', 'expand', 'full', 'show'].includes(rawMode)) {
+                return { handled: true, action: 'toolTrail', message: 'tool trail → expanded', toolTrailMode: 'expanded' };
+            }
+            return { handled: true, message: 'ใช้ /trail, /trail compact, หรือ /trail expanded' };
+        }
+        case 'details': {
+            const section = args[0]?.toLowerCase();
+            const mode = args[1]?.toLowerCase();
+            const usage = 'ใช้ /details thinking|tools hidden|collapsed|expanded';
+            if (!section && !mode)
+                return { handled: true, message: usage };
+            if (section !== 'thinking' && section !== 'tools')
+                return { handled: true, message: usage };
+            if (mode !== 'hidden' && mode !== 'collapsed' && mode !== 'expanded')
+                return { handled: true, message: usage };
+            return {
+                handled: true,
+                action: 'details',
+                detailMode: mode,
+                detailSection: section,
+                message: `details ${section} → ${mode}`,
+            };
+        }
         case 'platforms':
             return { handled: true, message: platformMenu() };
+        case 'mcp':
+            return {
+                handled: true,
+                action: 'mcpHub',
+                message: `MCP servers — จัดการด้วย "${BRAND.cliName} mcp list/search/install/doctor"`,
+            };
         case 'skills':
-            return { handled: true, message: `skills โหลดจาก built-in + ${appHomePath('skills')} — จัดการด้วย "${BRAND.cliName} skill list/add/remove"` };
+            return {
+                handled: true,
+                action: 'skillsHub',
+                message: `skills โหลดจาก built-in + ${appHomePath('skills')} — จัดการด้วย "${BRAND.cliName} skill list/add/remove"`,
+            };
+        case 'sessions':
+            return { handled: true, action: 'sessionsHub', message: `saved sessions — จัดการด้วย "${BRAND.cliName} sessions"` };
+        case 'tasks':
+            return { handled: true, action: 'tasksHub', message: 'background tasks — จาก task_spawn (Enter ดูรายละเอียด)' };
         case 'diff':
             return { handled: true, action: 'diff' };
         case 'retry':
@@ -230,15 +303,22 @@ export const BUILTIN_COMMANDS = new Set([
     'new',
     'reset',
     'status',
+    'hotkeys',
     'compact',
     'compress',
+    'copy',
     'quit',
     'exit',
     'model',
     'personality',
+    'details',
     'platforms',
+    'trail',
     'tools',
+    'mcp',
     'skills',
+    'sessions',
+    'tasks',
     'diff',
     'retry',
     'stop',

package/dist/config.js

@@ -46,6 +46,8 @@ export const ConfigSchema = z.object({
     embeddingModel: z.string().optional().catch(undefined),
     // Hermes-style /personality overlay (stored as a small named prompt)
     personality: z.string().optional().catch(undefined),
+    /** UI + setup wizard language */
+    locale: z.enum(['en', 'th']).catch('th').default('th'),
 });
 const DEFAULT_THINKING_BUDGET = 4096;
 function normalizeThinkingBudget(value) {
@@ -99,10 +101,33 @@ export async function agentTuning() {
     const summaryModel = trimmedString(process.env.SANOOK_SUMMARY_MODEL) ?? trimmedString(raw.summaryModel);
     return { cacheTtl, thinkingBudget, compaction, contextCompression, summaryModel };
 }
+const warnedBadConfigKeys = new Set();
+/**
+ * Validate the merged config, but degrade gracefully: a malformed strict field (bad model/maxSteps/
+ * permissionMode/budgetUsd/pricing in a hand-edited config.json) is dropped to its default with a
+ * one-time stderr warning instead of throwing and crashing boot. Security-sensitive fields drop to
+ * the SAFE default (budgetUsd→no cap is still surfaced by the warning; pricing→none).
+ */
+function parseConfigGraceful(merged) {
+    const first = ConfigSchema.safeParse(merged);
+    if (first.success)
+        return first.data;
+    const badKeys = [...new Set(first.error.issues.map((i) => String(i.path[0])).filter(Boolean))];
+    const cleaned = { ...merged };
+    for (const k of badKeys)
+        delete cleaned[k];
+    const fresh = badKeys.filter((k) => !warnedBadConfigKeys.has(k));
+    if (fresh.length) {
+        fresh.forEach((k) => warnedBadConfigKeys.add(k));
+        process.stderr.write(`${BRAND.cliName}: ⚠ ละเลย config ที่ค่าผิด (ใช้ค่า default แทน): ${fresh.join(', ')}\n`);
+    }
+    const second = ConfigSchema.safeParse(cleaned);
+    return second.success ? second.data : ConfigSchema.parse({});
+}
 async function readJson(path) {
     try {
         const parsed = JSON.parse(await readFile(path, 'utf8'));
-        return parsed && typeof parsed === 'object' ? parsed : {};
+        return parsed && typeof parsed === 'object' && !Array.isArray(parsed) ? parsed : {};
     }
     catch {
         return {}; // ไม่มีไฟล์ / parse ไม่ได้ = ใช้ default
@@ -134,15 +159,16 @@ export async function loadConfig(overrides = {}, cwd = process.cwd()) {
     const trust = await projectTrustStatus(root);
     const project = trust.trusted ? projectRaw : sanitizeUntrustedProjectConfig(projectRaw);
     const envConfig = {};
-    if (process.env[BRAND.modelEnvVar])
-        envConfig.model = process.env[BRAND.modelEnvVar];
+    const envModel = trimmedString(process.env[BRAND.modelEnvVar]);
+    if (envModel)
+        envConfig.model = envModel;
     const cleanOverrides = {};
     for (const [k, v] of Object.entries(overrides)) {
         if (v !== undefined)
             cleanOverrides[k] = v;
     }
     const merged = { ...global, ...project, ...envConfig, ...cleanOverrides };
-    const config = ConfigSchema.parse(merged);
+    const config = parseConfigGraceful(merged);
     // pricing override: config.pricing + env SANOOK_PRICING (JSON) → ลงทะเบียนเข้า cost table
     registerPricing(config.pricing);
     registerPricing(parseEnvPricing());
@@ -188,7 +214,7 @@ export async function isFirstRun() {
         return true;
     }
 }
-/** บันทึก global config (model/provider ที่เลือกตอน setup) */
+/** บันทึก global config (model/provider/locale ที่เลือกตอน setup) */
 export async function saveGlobalConfig(cfg) {
     await mkdir(CONFIG_DIR, { recursive: true });
     const existing = await readJson(CONFIG_PATH);

package/dist/context-pack.js

@@ -0,0 +1,145 @@
+import { readdir, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { termList } from './search/index-core.js';
+const PACK_DIR = 'Shared/Context-Packs';
+const MIN_SCORE = 0.35;
+const DEFAULT_MAX_CHARS = 1200;
+/** Known packs + retrieval signals (aligned with Shared/Context-Packs/_Index.md). */
+const PACK_CATALOG = [
+    {
+        slug: 'second-brain-maintenance',
+        title: 'Second-Brain Maintenance',
+        description: 'vault structure, routing rules, memory policy, indexes, runbooks, agent adapters',
+        signalTerms: [
+            'vault',
+            'structure',
+            'routing',
+            'memory',
+            'policy',
+            'index',
+            'runbook',
+            'agent',
+            'adapter',
+            'framework',
+            'obsidian',
+            'maintenance',
+            'brain',
+            'scaffold',
+            'frontmatter',
+        ],
+    },
+    {
+        slug: 'coding-release',
+        title: 'Coding & Release',
+        description: 'source code, tests, build/release, CLI commands, runtime scripts',
+        signalTerms: [
+            'code',
+            'coding',
+            'test',
+            'tests',
+            'build',
+            'release',
+            'cli',
+            'script',
+            'implement',
+            'fix',
+            'bug',
+            'typecheck',
+            'npm',
+            'ship',
+            'deploy',
+            'refactor',
+        ],
+    },
+    {
+        slug: 'research-to-framework',
+        title: 'Research To Framework',
+        description: 'research, experiment, comparison, promote findings into framework',
+        signalTerms: [
+            'research',
+            'experiment',
+            'framework',
+            'benchmark',
+            'eval',
+            'hypothesis',
+            'promote',
+            'distillation',
+            'comparison',
+            'method',
+            'sota',
+        ],
+    },
+];
+function catalogEntry(slug) {
+    const base = PACK_CATALOG.find((item) => item.slug === slug);
+    if (!base)
+        throw new Error(`unknown context pack slug: ${slug}`);
+    return { ...base, relPath: `${PACK_DIR}/${slug}.md` };
+}
+function packTerms(pack) {
+    return new Set([...termList(pack.slug), ...termList(pack.title), ...pack.signalTerms.map((t) => t.toLowerCase())]);
+}
+/** Score query against a pack via token overlap (deterministic, no network). */
+export function scoreContextPack(query, pack) {
+    const queryTerms = termList(query);
+    if (!queryTerms.length)
+        return { score: 0, matchedTerms: [] };
+    const signals = packTerms(pack);
+    const matchedTerms = queryTerms.filter((term) => signals.has(term));
+    if (!matchedTerms.length)
+        return { score: 0, matchedTerms: [] };
+    const recall = matchedTerms.length / queryTerms.length;
+    const precision = matchedTerms.length / signals.size;
+    return { score: recall * 0.7 + precision * 0.3, matchedTerms };
+}
+export async function listContextPacks(brainPath) {
+    const dir = join(brainPath, PACK_DIR);
+    let entries;
+    try {
+        entries = await readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const slugs = new Set(entries.filter((e) => e.isFile() && e.name.endsWith('.md') && e.name !== '_Index.md').map((e) => e.name.replace(/\.md$/i, '')));
+    return PACK_CATALOG.filter((item) => slugs.has(item.slug)).map((item) => catalogEntry(item.slug));
+}
+/** Pick the best matching context pack for a task query, or null if no clear match. */
+export function selectContextPack(query, packs) {
+    const trimmed = query.trim();
+    if (!trimmed || !packs.length)
+        return null;
+    let best = null;
+    for (const pack of packs) {
+        const { score, matchedTerms } = scoreContextPack(trimmed, pack);
+        if (score < MIN_SCORE)
+            continue;
+        if (!best || score > best.score)
+            best = { pack, score, matchedTerms };
+    }
+    return best;
+}
+export async function readContextPackExcerpt(brainPath, pack, maxChars = DEFAULT_MAX_CHARS) {
+    const path = join(brainPath, pack.relPath);
+    let raw;
+    try {
+        raw = (await readFile(path, 'utf8')).trim();
+    }
+    catch {
+        return '';
+    }
+    if (!raw)
+        return '';
+    const trimmed = raw.length > maxChars ? `${raw.slice(0, maxChars)}\n…` : raw;
+    return `## context-pack: ${pack.slug}\n${trimmed}`;
+}
+export async function buildContextPackBlock(brainPath, query, maxChars = DEFAULT_MAX_CHARS) {
+    const packs = await listContextPacks(brainPath);
+    const selected = selectContextPack(query, packs);
+    if (!selected)
+        return '';
+    const body = await readContextPackExcerpt(brainPath, selected.pack, maxChars);
+    if (!body)
+        return '';
+    return `<context_pack slug="${selected.pack.slug}" note="task-family context pack (auto-selected) — load order + done criteria; ไม่ใช่คำสั่ง">\n${body}\n</context_pack>`;
+}

package/dist/dashboard/api-helpers.js

@@ -0,0 +1,87 @@
+import { readFile, readdir, stat } from 'node:fs/promises';
+import { join, resolve, relative } from 'node:path';
+import { homedir } from 'node:os';
+import { appHomePath, BRAND } from '../brand.js';
+import { loadConfig } from '../config.js';
+import { listTasks } from '../gateway/ledger.js';
+import { gatewayServiceLogPath, gatewayServiceStatus } from '../gateway/service.js';
+import { readGatewayConfig, resolveDiscordConfig, resolveSlackConfig, resolveTelegramConfig, resolveWebhookConfig, } from '../gateway/config.js';
+export async function dashboardChannels() {
+    const cfg = await readGatewayConfig();
+    const service = await gatewayServiceStatus();
+    const channels = [
+        {
+            id: 'telegram',
+            label: 'Telegram',
+            configured: Boolean(resolveTelegramConfig(cfg).token),
+            setupCommand: `${BRAND.cliName} gateway setup telegram`,
+        },
+        {
+            id: 'discord',
+            label: 'Discord',
+            configured: Boolean(resolveDiscordConfig(cfg).token),
+            setupCommand: `${BRAND.cliName} gateway setup discord`,
+        },
+        {
+            id: 'slack',
+            label: 'Slack',
+            configured: Boolean(resolveSlackConfig(cfg).botToken),
+            setupCommand: `${BRAND.cliName} gateway setup slack`,
+        },
+        {
+            id: 'webhooks',
+            label: 'Webhooks',
+            configured: Object.keys(resolveWebhookConfig(cfg).routes ?? {}).length > 0,
+            setupCommand: `${BRAND.cliName} webhook setup`,
+        },
+    ];
+    return { channels, serviceRunning: service.running };
+}
+export async function dashboardCronTasks() {
+    return { tasks: await listTasks() };
+}
+export async function dashboardLogsTail(maxLines = 200) {
+    const path = gatewayServiceLogPath();
+    try {
+        const raw = await readFile(path, 'utf8');
+        const lines = raw.split('\n').filter(Boolean);
+        return { path, lines: lines.slice(-maxLines) };
+    }
+    catch {
+        return { path, lines: [`(no log yet — run ${BRAND.cliName} serve)`] };
+    }
+}
+function safeRoot(root) {
+    return resolve(root);
+}
+export async function dashboardListFiles(subpath = '') {
+    const config = await loadConfig({});
+    const roots = [appHomePath(), config.brainPath ? resolve(config.brainPath) : null].filter(Boolean);
+    const root = safeRoot(roots[0] ?? appHomePath());
+    const target = safeRoot(join(root, subpath.replace(/^\/+/, '')));
+    if (!target.startsWith(root) && !roots.some((r) => target.startsWith(safeRoot(r)))) {
+        throw new Error('path not allowed');
+    }
+    const entries = await readdir(target, { withFileTypes: true });
+    return {
+        root,
+        entries: entries
+            .sort((a, b) => Number(b.isDirectory()) - Number(a.isDirectory()) || a.name.localeCompare(b.name))
+            .slice(0, 200)
+            .map((e) => ({ name: e.name, dir: e.isDirectory() })),
+    };
+}
+export async function dashboardReadFile(subpath) {
+    const config = await loadConfig({});
+    const allowedRoots = [appHomePath(), config.brainPath ? resolve(config.brainPath) : null].filter(Boolean);
+    const target = safeRoot(subpath.startsWith('/') ? subpath : join(appHomePath(), subpath));
+    if (!allowedRoots.some((root) => target.startsWith(safeRoot(root))))
+        throw new Error('path not allowed');
+    const info = await stat(target);
+    if (!info.isFile())
+        throw new Error('not a file');
+    if (info.size > 512_000)
+        throw new Error('file too large');
+    const content = await readFile(target, 'utf8');
+    return { path: relative(homedir(), target) || target, content };
+}

package/dist/dashboard/server.js

@@ -0,0 +1,179 @@
+import { createServer } from 'node:http';
+import { readFile, stat } from 'node:fs/promises';
+import { join, extname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { BRAND } from '../brand.js';
+import { loadConfig, readGlobalConfigRaw } from '../config.js';
+import { listSessions } from '../session.js';
+import { loadMcpConfig } from '../mcp.js';
+const MIME = {
+    '.html': 'text/html; charset=utf-8',
+    '.js': 'text/javascript; charset=utf-8',
+    '.css': 'text/css; charset=utf-8',
+    '.json': 'application/json; charset=utf-8',
+    '.svg': 'image/svg+xml',
+    '.png': 'image/png',
+    '.ico': 'image/x-icon',
+};
+function dashboardStaticDir() {
+    const here = fileURLToPath(new URL('.', import.meta.url));
+    return join(here, 'static');
+}
+async function readBody(req) {
+    const chunks = [];
+    for await (const chunk of req)
+        chunks.push(Buffer.from(chunk));
+    return Buffer.concat(chunks).toString('utf8');
+}
+function json(res, status, body) {
+    res.writeHead(status, { 'Content-Type': 'application/json; charset=utf-8' });
+    res.end(`${JSON.stringify(body)}\n`);
+}
+async function handleApi(req, res, pathname) {
+    if (req.method === 'GET' && pathname === '/api/status') {
+        const config = await loadConfig({});
+        const raw = await readGlobalConfigRaw();
+        json(res, 200, {
+            product: 'Sanook Dashboard',
+            cli: BRAND.cliName,
+            version: process.env.npm_package_version ?? 'dev',
+            model: config.model,
+            locale: config.locale,
+            brainPath: config.brainPath ?? null,
+            permissionMode: config.permissionMode,
+            gatewayHint: `${BRAND.cliName} serve`,
+        });
+        return true;
+    }
+    if (req.method === 'GET' && pathname === '/api/config') {
+        json(res, 200, await readGlobalConfigRaw());
+        return true;
+    }
+    if (req.method === 'GET' && pathname === '/api/sessions') {
+        const sessions = await listSessions({});
+        json(res, 200, { sessions });
+        return true;
+    }
+    if (req.method === 'GET' && pathname === '/api/mcp') {
+        const servers = await loadMcpConfig();
+        json(res, 200, { servers });
+        return true;
+    }
+    if (req.method === 'GET' && pathname === '/api/brain') {
+        const config = await loadConfig({});
+        json(res, 200, { brainPath: config.brainPath ?? null });
+        return true;
+    }
+    if (req.method === 'GET' && pathname === '/api/cron') {
+        const { dashboardCronTasks } = await import('./api-helpers.js');
+        json(res, 200, await dashboardCronTasks());
+        return true;
+    }
+    if (req.method === 'GET' && pathname === '/api/channels') {
+        const { dashboardChannels } = await import('./api-helpers.js');
+        json(res, 200, await dashboardChannels());
+        return true;
+    }
+    if (req.method === 'GET' && pathname === '/api/logs') {
+        const { dashboardLogsTail } = await import('./api-helpers.js');
+        json(res, 200, await dashboardLogsTail());
+        return true;
+    }
+    if (req.method === 'GET' && pathname.startsWith('/api/files')) {
+        const url = new URL(req.url ?? '/', 'http://local');
+        const sub = url.searchParams.get('path') ?? '';
+        if (pathname === '/api/files/read') {
+            const { dashboardReadFile } = await import('./api-helpers.js');
+            json(res, 200, await dashboardReadFile(sub));
+            return true;
+        }
+        const { dashboardListFiles } = await import('./api-helpers.js');
+        json(res, 200, await dashboardListFiles(sub));
+        return true;
+    }
+    if (req.method === 'GET' && pathname === '/api/chat/status') {
+        json(res, 200, {
+            hint: `Use ${BRAND.cliName} in terminal, or start ${BRAND.cliName} serve for HTTP chat`,
+            gateway: `${BRAND.cliName} serve`,
+        });
+        return true;
+    }
+    if (req.method === 'POST' && pathname === '/api/config') {
+        const raw = await readBody(req);
+        let parsed;
+        try {
+            parsed = JSON.parse(raw || '{}');
+        }
+        catch {
+            json(res, 400, { error: 'invalid JSON' });
+            return true;
+        }
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+            json(res, 400, { error: 'body must be an object' });
+            return true;
+        }
+        const { saveGlobalConfig } = await import('../config.js');
+        await saveGlobalConfig(parsed);
+        json(res, 200, { ok: true });
+        return true;
+    }
+    return false;
+}
+async function serveStatic(res, staticDir, pathname) {
+    const safe = pathname === '/' ? '/index.html' : pathname;
+    const filePath = join(staticDir, safe.replace(/^\/+/, ''));
+    try {
+        const info = await stat(filePath);
+        if (!info.isFile()) {
+            res.writeHead(404);
+            res.end('Not found');
+            return;
+        }
+        const ext = extname(filePath);
+        const body = await readFile(filePath);
+        res.writeHead(200, { 'Content-Type': MIME[ext] ?? 'application/octet-stream' });
+        res.end(body);
+    }
+    catch {
+        try {
+            const fallback = await readFile(join(staticDir, 'index.html'));
+            res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+            res.end(fallback);
+        }
+        catch {
+            res.writeHead(503);
+            res.end('Sanook Dashboard assets missing — run npm run build:dashboard');
+        }
+    }
+}
+export async function startDashboardServer(opts = {}) {
+    const port = opts.port ?? 9119;
+    const host = opts.host ?? '127.0.0.1';
+    const staticDir = opts.staticDir ?? dashboardStaticDir();
+    const log = opts.onLog ?? (() => { });
+    const server = createServer(async (req, res) => {
+        try {
+            const url = new URL(req.url ?? '/', `http://${host}`);
+            if (url.pathname.startsWith('/api/')) {
+                const handled = await handleApi(req, res, url.pathname);
+                if (handled)
+                    return;
+                json(res, 404, { error: 'not found' });
+                return;
+            }
+            await serveStatic(res, staticDir, url.pathname);
+        }
+        catch (e) {
+            json(res, 500, { error: e.message });
+        }
+    });
+    await new Promise((resolve, reject) => {
+        server.once('error', reject);
+        server.listen(port, host, () => resolve());
+    });
+    log(`Sanook Dashboard — http://${host}:${port}`);
+    return () => server.close();
+}
+export function dashboardStaticRoot() {
+    return dashboardStaticDir();
+}