sanook-cli 0.5.1 → 0.5.5

package/dist/commands.js

@@ -1,37 +1,71 @@
 import { readdir, readFile } from 'node:fs/promises';
 import { join } from 'node:path';
-import { PROVIDERS, parseSpec } from './providers/registry.js';
+import { canonicalSpec, consoleUrl, hasUsableEnvKey, PROVIDERS, parseSpec } from './providers/registry.js';
 import { appHomePath, BRAND } from './brand.js';
 import { parseFrontmatter } from './skills.js';
 import { projectConfigPathIfTrusted } from './trust.js';
-const HELP_TEXT = `คำสั่ง:
+import { normalizePersonalityName, personalityListText } from './personality.js';
+import { parseInsightsArgs } from './insights-args.js';
+import { formatHotkeys } from './hotkeys.js';
+import { formatToolCatalog } from './tool-catalog.js';
+export const HELP_TEXT = `คำสั่ง:
   /help            แสดงคำสั่งทั้งหมด
-  /model [spec]    ดู/เปลี่ยน model (เช่น /model opus, /model openai:gpt-5)
+  /new, /reset      เริ่มบทสนทนาใหม่
+  /status          ดูสถานะ session ปัจจุบัน
+  /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 ที่กำลังรัน
   /undo            stash การแก้ไฟล์ล่าสุด (กู้คืนด้วย git stash pop)
   /rewind          ย้อนกลับ 1 turn (คืนไฟล์ git + ตัดบทสนทนา, recoverable)
-  /cost            ดู token + cost รอบล่าสุด
+  /cost, /usage     ดู token + cost รอบล่าสุด
+  /insights [--days N] [--all]
+                   ดู usage/session insights ในเครื่อง
+  /hotkeys         เปิด overlay คีย์ลัดใน REPL
+  /copy [last]     copy คำตอบ assistant ล่าสุดไป clipboard/OSC52
   ↑/↓ ประวัติ · @ไฟล์ แนบ context/รูป · \\ ลงท้าย = บรรทัดใหม่
   /clear           ล้าง conversation (เริ่มใหม่)
-  /compact         บีบ context (truncate · หรือ summarize ถ้าตั้ง compaction)
+  /compact, /compress
+                   บีบ context (truncate · หรือ summarize ถ้าตั้ง compaction)
   /quit            ออก
 
 นอก REPL (พิมพ์ใน shell):
-  ${BRAND.cliName} search "<q>" · index · brain init · serve · mcp serve · config set <k> <v>
+  ${BRAND.cliName} search "<q>" · index · brain init · brain context · brain eval · brain review · brain final · serve · mcp serve · config set <k> <v>
   ดูทั้งหมด: ${BRAND.cliName} --help
 
 custom commands:
-  ~/.sanook/commands/<name>.md และ .sanook/commands/<name>.md (project ต้อง trust ก่อน)`;
-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  ');
+  ~/.sanook/commands/<name>.md และ .sanook/commands/<name>.md (project ต้อง trust ก่อน)
+  args: ใช้ $ARGUMENTS หรือ {{ args }}; ถ้าไม่มี placeholder จะ append args ต่อท้าย`;
+const MESSAGING_PLATFORMS = [
+    'telegram',
+    'discord',
+    'slack',
+    'mattermost',
+    'homeassistant',
+    'email',
+    'line',
+    'sms',
+    'ntfy',
+    'signal',
+    'whatsapp',
+    'matrix',
+    'googlechat',
+    'bluebubbles',
+    'teams',
+    'webhooks',
+];
 export function parseSlashInvocation(input) {
     const trimmed = input.trim();
     if (!trimmed.startsWith('/'))
@@ -39,7 +73,10 @@ export function parseSlashInvocation(input) {
     const match = /^\/(\S+)(?:\s+([\s\S]*))?$/.exec(trimmed);
     if (!match)
         return null;
-    return { name: match[1].toLowerCase(), args: match[2] ?? '' };
+    const name = match[1].toLowerCase();
+    if (name !== '?' && !isValidCommandName(name))
+        return null;
+    return { name, args: match[2] ?? '' };
 }
 /** /model (ไม่มี arg) — โชว์ model ปัจจุบัน + ตัวเลือกของ provider นั้น (alias จาก registry) */
 function modelMenu(current) {
@@ -60,37 +97,198 @@ function modelMenu(current) {
         .filter(Boolean)
         .join('\n');
 }
+function missingKeyHint(provider) {
+    const cfg = PROVIDERS[provider];
+    if (!cfg?.requiresKey || hasUsableEnvKey(provider))
+        return undefined;
+    const url = consoleUrl(provider);
+    const lines = [
+        `⚠ ยังไม่มี API key ของ ${cfg.label} (${cfg.envVar}) — model นี้จะยังรันไม่ได้จนกว่าจะตั้ง key`,
+        url ? `  • เอา key ที่: ${url}` : undefined,
+        `  • ตั้ง: export ${cfg.envVar}="..." หรือรัน ${BRAND.cliName} เพื่อเข้า setup wizard`,
+    ].filter(Boolean);
+    if (provider === 'openai') {
+        lines.push('  • ถ้าต้องการใช้ ChatGPT plan ไม่ใช้ API key: /model codex แล้วรัน codex login');
+    }
+    return lines.join('\n');
+}
+function platformMenu() {
+    return [
+        `providers: ${Object.keys(PROVIDERS).join(' · ')}`,
+        `messaging: ${MESSAGING_PLATFORMS.join(' · ')}`,
+        `setup: ${BRAND.cliName} setup หรือ ${BRAND.cliName} gateway setup <platform>`,
+    ].join('\n');
+}
+function statusMenu(ctx) {
+    const { provider } = parseSpec(ctx.model);
+    const cfg = PROVIDERS[provider];
+    return [
+        `session: REPL`,
+        `model: ${ctx.model}`,
+        `provider: ${cfg?.label ?? provider}`,
+        `usage: ${ctx.costSummary ?? '(ยังไม่มี usage รอบนี้)'}`,
+        `platforms: พิมพ์ /platforms`,
+        `system status: ${BRAND.cliName} status`,
+    ].join('\n');
+}
+function modelChange(spec) {
+    const canonical = canonicalSpec(spec);
+    const { provider, model } = parseSpec(canonical);
+    if (!PROVIDERS[provider]) {
+        return {
+            handled: true,
+            message: `provider ไม่รองรับ: "${provider}" — รองรับ: ${Object.keys(PROVIDERS).join(' · ')}`,
+        };
+    }
+    if (!model) {
+        return {
+            handled: true,
+            message: `model spec ไม่ครบ: "${spec}" — ใช้ /model <alias> หรือ /model <provider:model>`,
+        };
+    }
+    const hint = missingKeyHint(provider);
+    return {
+        handled: true,
+        modelChange: canonical,
+        message: [`เปลี่ยน model → ${canonical}`, hint].filter(Boolean).join('\n'),
+    };
+}
 /** parse input — ถ้าขึ้นต้น / = slash command, ไม่งั้น handled=false (ส่งเข้า agent) */
 export function parseCommand(input, ctx) {
     const trimmed = input.trim();
     if (!trimmed.startsWith('/'))
         return { handled: false };
-    const [cmd, ...args] = trimmed.slice(1).split(/\s+/);
+    const [rawCmd, ...args] = trimmed.slice(1).split(/\s+/);
+    const cmd = rawCmd.toLowerCase();
     switch (cmd) {
         case 'help':
         case '?':
             return { handled: true, action: 'help', message: HELP_TEXT };
         case 'clear':
+        case 'new':
+        case 'reset':
             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, modelChange: args[0], message: `เปลี่ยน model → ${args[0]}` };
+                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)
+                return { handled: true, message: personalityListText() };
+            const name = normalizePersonalityName(raw);
+            if (!name)
+                return { handled: true, message: `ไม่รู้จัก personality: ${raw}\n\n${personalityListText()}` };
+            return {
+                handled: true,
+                action: 'personality',
+                personalityChange: name === 'none' ? '' : name,
+                message: name === 'none' ? 'ปิด personality overlay แล้ว' : `ตั้ง personality → ${name}`,
+            };
+        }
         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':
+            return { handled: true, action: 'retry' };
+        case 'stop':
+            return { handled: true, action: 'stop', message: 'ไม่มี turn ที่กำลังทำงาน' };
         case 'undo':
             return { handled: true, action: 'undo' };
+        case 'rewind':
+            return { handled: true, action: 'rewind' };
         case 'cost':
+        case 'usage':
             return { handled: true, message: ctx.costSummary ?? '(ยังไม่มี usage รอบนี้)' };
+        case 'insights': {
+            const parsed = parseInsightsArgs(args);
+            if (parsed === null)
+                return { handled: true, message: 'ใช้: /insights [--days N] [--all] (N ต้องเป็นจำนวนวันบวก)' };
+            return { handled: true, action: 'insights', insightsDays: parsed.days, insightsAll: parsed.all };
+        }
         default:
             return { handled: true, message: `ไม่รู้จักคำสั่ง /${cmd} — พิมพ์ /help` };
     }
@@ -99,11 +297,51 @@ export function parseCommand(input, ctx) {
 // ไฟล์ markdown (frontmatter optional) = prompt template ที่ส่งเข้า agent. $ARGUMENTS = ส่วนหลังชื่อคำสั่ง
 // (เลียน Claude Code .claude/commands) — global ~/.sanook/commands + project .sanook/commands (project ทับ)
 export const BUILTIN_COMMANDS = new Set([
-    'help', '?', 'clear', 'compact', 'quit', 'exit', 'model', 'tools', 'skills', 'diff', 'undo', 'rewind', 'cost',
+    'help',
+    '?',
+    'clear',
+    'new',
+    'reset',
+    'status',
+    'hotkeys',
+    'compact',
+    'compress',
+    'copy',
+    'quit',
+    'exit',
+    'model',
+    'personality',
+    'details',
+    'platforms',
+    'trail',
+    'tools',
+    'mcp',
+    'skills',
+    'sessions',
+    'tasks',
+    'diff',
+    'retry',
+    'stop',
+    'undo',
+    'rewind',
+    'cost',
+    'usage',
+    'insights',
 ]);
 function isValidCommandName(name) {
     return /^[a-z0-9][a-z0-9-]{0,40}$/.test(name);
 }
+function compareCommandFiles(a, b) {
+    const an = a.toLowerCase();
+    const bn = b.toLowerCase();
+    if (an !== bn)
+        return an.localeCompare(bn);
+    if (a === an && b !== bn)
+        return 1;
+    if (a !== an && b === bn)
+        return -1;
+    return a.localeCompare(b);
+}
 /** scan custom commands จาก global + project (project override). ข้าม built-in ชื่อซ้ำ */
 export async function loadCustomCommands(cwd = process.cwd()) {
     const out = new Map();
@@ -119,10 +357,11 @@ export async function loadCustomCommands(cwd = process.cwd()) {
         catch {
             continue; // ไม่มีโฟลเดอร์ = ข้าม
         }
-        for (const f of files) {
-            if (!f.endsWith('.md'))
+        for (const f of files.sort(compareCommandFiles)) {
+            const normalizedFile = f.toLowerCase();
+            if (!normalizedFile.endsWith('.md'))
                 continue;
-            const name = f.slice(0, -3).toLowerCase();
+            const name = normalizedFile.slice(0, -3);
             if (!isValidCommandName(name) || BUILTIN_COMMANDS.has(name))
                 continue;
             try {
@@ -140,7 +379,7 @@ export async function loadCustomCommands(cwd = process.cwd()) {
 export function expandCustomCommand(cmd, args) {
     const a = args.trim();
     if (/\$ARGUMENTS|\{\{\s*args\s*\}\}/.test(cmd.body)) {
-        return cmd.body.replace(/\$ARGUMENTS|\{\{\s*args\s*\}\}/g, a);
+        return cmd.body.replace(/\$ARGUMENTS|\{\{\s*args\s*\}\}/g, () => a);
     }
     return a ? `${cmd.body}\n\n${a}` : cmd.body;
 }

package/dist/compaction.js

@@ -1,6 +1,42 @@
+import { selectiveCompressText } from './context-compression.js';
 const TRUNC_HEAD = 400;
 const TRUNC_TAIL = 600;
 const CHARS_PER_TOKEN = 4; // ประมาณคร่าวๆ (จริง ~3.5-4 ต่อ token)
+const SELECTIVE_TOOL_TARGET_CHARS = 6_000;
+const SELECTIVE_TOOL_MIN_CHARS = 8_000;
+function textFromMessageContent(content) {
+    if (typeof content === 'string')
+        return content;
+    if (!Array.isArray(content))
+        return '';
+    return content
+        .map((part) => {
+        if (typeof part === 'object' && part && 'type' in part && part.type === 'text' && 'text' in part && typeof part.text === 'string')
+            return part.text;
+        return '';
+    })
+        .filter(Boolean)
+        .join('\n');
+}
+function latestUserText(messages) {
+    for (let i = messages.length - 1; i >= 0; i--) {
+        if (messages[i].role !== 'user')
+            continue;
+        const text = textFromMessageContent(messages[i].content).trim();
+        if (text)
+            return text;
+    }
+    return undefined;
+}
+function adaptiveStaleTarget(baseTarget, rank, count) {
+    if (count <= 1)
+        return baseTarget;
+    const recency = rank / Math.max(1, count - 1); // 0 = oldest, 1 = newest stale
+    return Math.max(1_500, Math.floor(baseTarget * (0.35 + 0.65 * recency)));
+}
+function adaptiveMinChars(targetChars, baseMinChars) {
+    return Math.min(baseMinChars, Math.max(targetChars + 1_000, Math.floor(targetChars * 1.45)));
+}
 /** ตัดข้อความยาว เก็บหัว (intent) + ท้าย (error/result) */
 export function truncateText(s) {
     if (s.length <= TRUNC_HEAD + TRUNC_TAIL + 40)
@@ -16,23 +52,72 @@ export function truncateText(s) {
  */
 export function pruneToolResults(messages, keepTail = 4) {
     const cut = Math.max(0, messages.length - keepTail);
-    return messages.map((m, i) => {
+    let changed = false;
+    const out = messages.map((m, i) => {
         if (i >= cut)
             return m;
         if (m.role !== 'tool' || !Array.isArray(m.content))
             return m;
-        return {
-            ...m,
-            content: m.content.map((part) => {
-                if (part.type === 'tool-result' &&
-                    part.output?.type === 'text' &&
-                    typeof part.output.value === 'string') {
-                    return { ...part, output: { ...part.output, value: truncateText(part.output.value) } };
+        const content = m.content.map((part) => {
+            if (part.type === 'tool-result' &&
+                part.output?.type === 'text' &&
+                typeof part.output.value === 'string') {
+                const compressed = selectiveCompressText(part.output.value, {
+                    targetChars: SELECTIVE_TOOL_TARGET_CHARS,
+                    minChars: SELECTIVE_TOOL_MIN_CHARS,
+                });
+                if (compressed.changed) {
+                    changed = true;
+                    return { ...part, output: { ...part.output, value: compressed.text } };
+                }
+                const truncated = truncateText(part.output.value);
+                if (truncated !== part.output.value) {
+                    changed = true;
+                    return { ...part, output: { ...part.output, value: truncated } };
+                }
+            }
+            return part;
+        });
+        return content === m.content ? m : { ...m, content };
+    });
+    return changed ? out : messages;
+}
+/**
+ * Per-step token optimizer (zero LLM cost).
+ * Compresses stale, very large tool results before each model request while keeping the latest tail full.
+ */
+export function selectivelyCompressStaleToolResults(messages, keepTail = 6, targetChars = SELECTIVE_TOOL_TARGET_CHARS, minChars = SELECTIVE_TOOL_MIN_CHARS, query = latestUserText(messages)) {
+    const cut = Math.max(0, messages.length - keepTail);
+    const staleToolIndexes = messages
+        .map((m, i) => ({ m, i }))
+        .filter(({ m, i }) => i < cut && m.role === 'tool' && Array.isArray(m.content))
+        .map(({ i }) => i);
+    const rankByIndex = new Map(staleToolIndexes.map((index, rank) => [index, rank]));
+    let changed = false;
+    const out = messages.map((m, i) => {
+        if (i >= cut)
+            return m;
+        if (m.role !== 'tool' || !Array.isArray(m.content))
+            return m;
+        let messageChanged = false;
+        const adaptiveTarget = adaptiveStaleTarget(targetChars, rankByIndex.get(i) ?? 0, staleToolIndexes.length);
+        const adaptiveMin = adaptiveMinChars(adaptiveTarget, minChars);
+        const content = m.content.map((part) => {
+            if (part.type === 'tool-result' &&
+                part.output?.type === 'text' &&
+                typeof part.output.value === 'string') {
+                const compressed = selectiveCompressText(part.output.value, { targetChars: adaptiveTarget, minChars: adaptiveMin, query });
+                if (compressed.changed) {
+                    changed = true;
+                    messageChanged = true;
+                    return { ...part, output: { ...part.output, value: compressed.text } };
                 }
-                return part;
-            }),
-        };
+            }
+            return part;
+        });
+        return messageChanged ? { ...m, content } : m;
     });
+    return changed ? out : messages;
 }
 /** ประมาณ token ของ conversation (chars/4) — ไม่เป๊ะแต่พอใช้ตัดสิน compact */
 export function estimateTokens(messages) {