sanook-cli 0.5.1 → 0.5.5

package/dist/i18n/en.js

@@ -0,0 +1,98 @@
+export const en = {
+    setup: {
+        title: 'Set up Sanook AI CLI (first run)',
+        stepLanguage: '1. Choose language',
+        stepWelcome: '2. Welcome',
+        stepProvider: '3. Choose AI provider',
+        stepCodex: '4. Connect OpenAI Codex',
+        stepKey: '4. Paste API key',
+        stepModel: '5. Choose default model',
+        stepAgent: '6. Agent settings',
+        stepTools: '7. Tools & MCP',
+        stepGateway: '8. Messaging gateway',
+        stepBrain: '9. Second brain workspace',
+        stepComplete: '10. Ready',
+        languageHint: 'You can change this later with sanook config set locale en|th',
+        languageEn: 'English',
+        languageTh: 'Thai (ภาษาไทย)',
+        welcomeBody: 'Sanook is a terminal AI agent with MCP, gateway, and an optional Obsidian second brain.\nThis wizard walks you through provider, model, and vault setup step by step.',
+        welcomeContinue: 'Continue setup',
+        providerHint: '↑↓ select · Enter confirm · ★ Codex = ChatGPT plan (no API key)',
+        providerMenuHint: 'cloud = API key · ★ Codex = ChatGPT plan · local = free on device',
+        codexTitle: 'Connect OpenAI Codex (ChatGPT plan quota — no API key)',
+        codexChecking: 'Checking codex CLI + login state…',
+        codexNeedInstall: 'Codex CLI not installed yet',
+        codexNeedLogin: 'Codex CLI installed but ChatGPT not signed in',
+        codexLoggedInNeedCli: 'Signed in — install codex CLI to run the agent',
+        codexReady: 'ChatGPT signed in — continuing…',
+        codexDeviceTitle: 'Sign in with device code (Hermes-style)',
+        codexDeviceOpen: '1. Open in browser:',
+        codexDeviceEnter: '2. Enter this code:',
+        codexDeviceWaiting: '3. Waiting for sign-in…',
+        codexDeviceRetry: 'Try device code again',
+        codexDeviceBack: '← Back to other login options',
+        codexOptionDevice: 'Login with device code (recommended)',
+        codexOptionCliLogin: 'Use codex login in another terminal',
+        codexOptionRecheck: 'Re-check (after install/login)',
+        codexOptionBack: '← Choose another provider',
+        codexInstallCmd: 'npm i -g @openai/codex',
+        keyEscHint: '(Esc = back)',
+        keyOpenAiCodexHint: 'Have ChatGPT Plus/Pro? Press Esc and pick OpenAI Codex (ChatGPT plan) — no API key needed.',
+        keyFormatHint: 'Key format',
+        keyStorageHint: 'Direct console API key only — no OAuth tokens · stored at ~/.sanook/auth.json mode 0600',
+        keyEmptyError: 'Paste an API key first (Enter on empty is blocked) · Esc = back to providers',
+        modelLoading: 'Fetching models from',
+        modelPick: 'Pick a default model',
+        brainQuestion: 'Create a second-brain workspace (Obsidian) for durable AI memory?',
+        brainYes: 'Yes — a few questions (name + path)',
+        brainNo: 'Skip for now (run sanook brain init later)',
+        completeTitle: 'Setup complete',
+        completeBody: 'Your CLI is ready. Open the dashboard for config and sessions, or start chatting in the terminal.',
+        completeDashboard: 'Open Sanook Dashboard',
+        completeRepl: 'Start terminal REPL',
+        continueLabel: 'Continue',
+        backLabel: 'Back',
+        recheckLabel: 'Re-check',
+        agentTitle: 'How should Sanook handle write/bash tools?',
+        agentAsk: 'Ask before risky actions (recommended)',
+        agentAuto: 'Act first (auto mode — faster, less safe)',
+        agentHint: 'Change anytime: sanook config set permissionMode ask|auto',
+        toolsTitle: 'Built-in tools + MCP',
+        toolsBody: 'Sanook ships git, bash, MCP, web search hooks, and skills. MCP servers live in ~/.sanook/mcp.json.',
+        toolsMcpHint: 'Browse MCP: /mcp in REPL · sanook mcp search <query>',
+        toolsWebSkip: 'Continue (configure web search later)',
+        toolsWebLater: 'Note: run sanook web setup tavily for web search',
+        gatewayTitle: 'Connect messaging platforms (optional)',
+        gatewayBody: 'Run sanook serve for 24/7 gateway. Pick a platform to configure next, or skip.',
+        gatewaySkip: 'Skip gateway for now',
+        gatewayTelegram: 'Telegram — sanook gateway setup telegram',
+        gatewayDiscord: 'Discord — sanook gateway setup discord',
+        gatewaySlack: 'Slack — sanook gateway setup slack',
+        gatewayDashboard: 'Configure in Sanook Dashboard → Channels',
+    },
+    dashboard: {
+        productName: 'Sanook Dashboard',
+        tagline: 'Configure models, sessions, MCP, gateway, and your second brain',
+        nav: {
+            home: 'Home',
+            chat: 'Chat',
+            models: 'Models',
+            sessions: 'Sessions',
+            files: 'Files',
+            logs: 'Logs',
+            cron: 'Cron',
+            channels: 'Channels',
+            config: 'Config',
+            mcp: 'MCP',
+            brain: 'Brain',
+        },
+        home: {
+            title: 'System status',
+            cliVersion: 'CLI version',
+            model: 'Default model',
+            brainPath: 'Second brain',
+            gateway: 'Gateway',
+            openRepl: 'Run sanook in your terminal to chat',
+        },
+    },
+};

package/dist/i18n/index.js

@@ -0,0 +1,19 @@
+import { en } from './en.js';
+import { th } from './th.js';
+const CATALOGS = { en, th };
+export const SUPPORTED_LOCALES = ['en', 'th'];
+export function normalizeLocale(raw) {
+    const v = typeof raw === 'string' ? raw.trim().toLowerCase() : '';
+    if (v === 'en' || v.startsWith('en-'))
+        return 'en';
+    if (v === 'th' || v.startsWith('th-'))
+        return 'th';
+    return 'th';
+}
+export function getLocaleCatalog(locale) {
+    return CATALOGS[locale] ?? CATALOGS.th;
+}
+export function detectDefaultLocale() {
+    const lang = process.env.LANG ?? process.env.LC_ALL ?? process.env.LC_MESSAGES ?? '';
+    return lang.toLowerCase().includes('th') ? 'th' : 'en';
+}

package/dist/i18n/th.js

@@ -0,0 +1,98 @@
+export const th = {
+    setup: {
+        title: 'ตั้งค่า Sanook AI CLI (ครั้งแรก)',
+        stepLanguage: '1. เลือกภาษา',
+        stepWelcome: '2. ยินดีต้อนรับ',
+        stepProvider: '3. เลือก AI provider',
+        stepCodex: '4. เชื่อม OpenAI Codex',
+        stepKey: '4. วาง API key',
+        stepModel: '5. เลือก model เริ่มต้น',
+        stepAgent: '6. ตั้งค่า agent',
+        stepTools: '7. Tools & MCP',
+        stepGateway: '8. Messaging gateway',
+        stepBrain: '9. second brain workspace',
+        stepComplete: '10. พร้อมใช้งาน',
+        languageHint: 'เปลี่ยนภาษาทีหลังได้: sanook config set locale en|th',
+        languageEn: 'English (ภาษาอังกฤษ)',
+        languageTh: 'ภาษาไทย',
+        welcomeBody: 'Sanook คือ AI agent บน terminal พร้อม MCP, gateway และ second brain (Obsidian) แบบเลือกได้\nwizard นี้จะพาตั้งค่า provider → model → vault ทีละขั้น',
+        welcomeContinue: 'เริ่มตั้งค่า',
+        providerHint: '↑↓ เลือก · Enter ยืนยัน · ★ Codex = ChatGPT plan (ไม่ต้อง API key)',
+        providerMenuHint: 'cloud = ใส่ API key · ★ Codex = ChatGPT plan · local = ฟรีบนเครื่อง',
+        codexTitle: 'เชื่อม OpenAI Codex (ใช้โควต้า ChatGPT plan — ไม่ต้องมี API key)',
+        codexChecking: 'กำลังเช็ก codex CLI + สถานะ login…',
+        codexNeedInstall: 'ยังไม่ได้ติดตั้ง codex CLI',
+        codexNeedLogin: 'ติดตั้ง codex CLI แล้ว แต่ยังไม่ได้ login ChatGPT',
+        codexLoggedInNeedCli: 'login แล้ว — ติดตั้ง codex CLI ก่อนรัน agent',
+        codexReady: 'login ChatGPT แล้ว — กำลังไปต่อ…',
+        codexDeviceTitle: 'Login ด้วย device code (แบบ Hermes)',
+        codexDeviceOpen: '1. เปิดใน browser:',
+        codexDeviceEnter: '2. ใส่รหัสนี้:',
+        codexDeviceWaiting: '3. รอ sign-in…',
+        codexDeviceRetry: 'ลอง device code ใหม่',
+        codexDeviceBack: '← กลับไปเลือกวิธี login อื่น',
+        codexOptionDevice: 'Login ด้วย device code (แนะนำ)',
+        codexOptionCliLogin: 'ใช้ codex login ใน terminal อีกหน้าต่าง',
+        codexOptionRecheck: 'เช็กใหม่ (หลังติดตั้ง/login)',
+        codexOptionBack: '← กลับไปเลือก provider อื่น',
+        codexInstallCmd: 'npm i -g @openai/codex',
+        keyEscHint: '(Esc = กลับ)',
+        keyOpenAiCodexHint: 'มี ChatGPT Plus/Pro? กด Esc แล้วเลือก OpenAI Codex (ChatGPT plan) — ไม่ต้อง API key',
+        keyFormatHint: 'รูปแบบ key',
+        keyStorageHint: 'API key ตรงจาก console — ห้าม OAuth/subscription token · เก็บที่ ~/.sanook/auth.json สิทธิ์ 0600',
+        keyEmptyError: 'วาง API key ก่อนค่ะ · Esc = กลับไปเลือก provider',
+        modelLoading: 'กำลังดึงรายชื่อ model จาก',
+        modelPick: 'เลือก model เริ่มต้น',
+        brainQuestion: 'สร้าง second-brain workspace (Obsidian) สำหรับความจำ AI ข้าม session?',
+        brainYes: 'สร้างเลย — ตอบไม่กี่ข้อ (ชื่อ + ที่เก็บ)',
+        brainNo: 'ข้ามไปก่อน (สั่ง sanook brain init ทีหลังได้)',
+        completeTitle: 'ตั้งค่าเสร็จแล้ว',
+        completeBody: 'CLI พร้อมใช้แล้ว เปิด Dashboard จัดการ config/sessions หรือเริ่มแชทใน terminal',
+        completeDashboard: 'เปิด Sanook Dashboard',
+        completeRepl: 'เริ่ม REPL ใน terminal',
+        continueLabel: 'ต่อไป',
+        backLabel: 'กลับ',
+        recheckLabel: 'เช็กใหม่',
+        agentTitle: 'Sanook ควรจัดการ write/bash tools อย่างไร?',
+        agentAsk: 'ถามก่อนทำ action เสี่ยง (แนะนำ)',
+        agentAuto: 'ทำเลย (auto mode — เร็วกว่า แต่เสี่ยงกว่า)',
+        agentHint: 'เปลี่ยนทีหลังได้: sanook config set permissionMode ask|auto',
+        toolsTitle: 'Tools ในตัว + MCP',
+        toolsBody: 'Sanook มี git, bash, MCP, web search, skills · MCP อยู่ที่ ~/.sanook/mcp.json',
+        toolsMcpHint: 'ดู MCP: /mcp ใน REPL · sanook mcp search <query>',
+        toolsWebSkip: 'ต่อไป (ตั้ง web search ทีหลัง)',
+        toolsWebLater: 'หมายเหตุ: รัน sanook web setup tavily สำหรับ web search',
+        gatewayTitle: 'เชื่อม messaging platforms (ไม่บังคับ)',
+        gatewayBody: 'รัน sanook serve สำหรับ gateway 24/7 · เลือก platform หรือข้าม',
+        gatewaySkip: 'ข้าม gateway ไปก่อน',
+        gatewayTelegram: 'Telegram — sanook gateway setup telegram',
+        gatewayDiscord: 'Discord — sanook gateway setup discord',
+        gatewaySlack: 'Slack — sanook gateway setup slack',
+        gatewayDashboard: 'ตั้งใน Sanook Dashboard → Channels',
+    },
+    dashboard: {
+        productName: 'Sanook Dashboard',
+        tagline: 'จัดการ model, session, MCP, gateway และ second brain',
+        nav: {
+            home: 'หน้าแรก',
+            chat: 'Chat',
+            models: 'Models',
+            sessions: 'Sessions',
+            files: 'Files',
+            logs: 'Logs',
+            cron: 'Cron',
+            channels: 'Channels',
+            config: 'Config',
+            mcp: 'MCP',
+            brain: 'Brain',
+        },
+        home: {
+            title: 'สถานะระบบ',
+            cliVersion: 'เวอร์ชัน CLI',
+            model: 'Model หลัก',
+            brainPath: 'Second brain',
+            gateway: 'Gateway',
+            openRepl: 'รัน sanook ใน terminal เพื่อแชท',
+        },
+    },
+};

package/dist/i18n/types.js

@@ -0,0 +1 @@
+export {};

package/dist/insights-args.js

@@ -0,0 +1,55 @@
+import { inlineValue, takeValue } from './cli-option-values.js';
+function parsePositiveInteger(raw) {
+    if (!raw || !/^[1-9]\d*$/.test(raw))
+        return null;
+    const days = Number(raw);
+    return Number.isSafeInteger(days) ? days : null;
+}
+export function parseInsightsDays(args) {
+    const parts = typeof args === 'string' ? args.trim().split(/\s+/).filter(Boolean) : [...args];
+    if (!parts.length)
+        return 30;
+    let raw;
+    if (parts[0] === '--days' || parts[0] === '-d') {
+        if (parts.length !== 2)
+            return null;
+        raw = parts[1];
+    }
+    else if (parts[0].startsWith('--days=') || parts[0].startsWith('-d=')) {
+        if (parts.length !== 1)
+            return null;
+        raw = parts[0].slice(parts[0].indexOf('=') + 1);
+    }
+    else {
+        if (parts.length !== 1)
+            return null;
+        raw = parts[0];
+    }
+    return parsePositiveInteger(raw);
+}
+export function parseInsightsArgs(args) {
+    const parts = typeof args === 'string' ? args.trim().split(/\s+/).filter(Boolean) : [...args];
+    let days = 30;
+    let all = false;
+    let sawDays = false;
+    for (let i = 0; i < parts.length; i++) {
+        const arg = parts[i];
+        if (arg === '--all' || arg === '-a') {
+            all = true;
+            continue;
+        }
+        const inlineDays = inlineValue('--days', arg) ?? inlineValue('-d', arg);
+        const next = arg === '--days' || arg === '-d' ? takeValue(parts, i) : undefined;
+        const raw = next ? next.value : inlineDays ?? arg;
+        if (sawDays)
+            return null;
+        const parsed = parsePositiveInteger(raw);
+        if (parsed === null)
+            return null;
+        days = parsed;
+        sawDays = true;
+        if (next)
+            i = next.nextIndex;
+    }
+    return { days, all };
+}

package/dist/insights.js

@@ -0,0 +1,86 @@
+import { estimateTokens } from './compaction.js';
+import { BRAND } from './brand.js';
+import { listSessions } from './session.js';
+import { listGatewaySessions } from './gateway/session.js';
+import { parseInsightsDays } from './insights-args.js';
+function sinceDate(days) {
+    const since = new Date();
+    since.setDate(since.getDate() - days);
+    return since;
+}
+function withinDays(updated, days) {
+    const t = Date.parse(updated);
+    return Number.isFinite(t) && t >= sinceDate(days).getTime();
+}
+function countRoles(messages) {
+    let user = 0;
+    let assistant = 0;
+    for (const msg of messages) {
+        if (msg.role === 'user')
+            user++;
+        if (msg.role === 'assistant')
+            assistant++;
+    }
+    return { user, assistant };
+}
+function addModelCount(map, model) {
+    const label = publicModelLabel(model);
+    map.set(label, (map.get(label) ?? 0) + 1);
+}
+function topModels(map) {
+    const rows = [...map.entries()].sort((a, b) => b[1] - a[1]);
+    return rows.length ? rows.map(([model, count]) => `${model} (${count})`).join(', ') : '(none)';
+}
+function publicModelLabel(model) {
+    const lower = model.toLowerCase();
+    const removed = [
+        'deep' + 'seek',
+        'g' + 'lm',
+        'mini' + 'max',
+        'zhi' + 'pu',
+        'q' + 'wen',
+        'moon' + 'shot',
+        'ki' + 'mi',
+        'dou' + 'bao',
+    ];
+    return removed.some((name) => lower.includes(name)) ? 'removed-provider' : model;
+}
+function isInsightSession(session) {
+    return typeof session.updated === 'string' && typeof session.model === 'string' && Array.isArray(session.messages);
+}
+export async function renderInsights(options = {}) {
+    const days = options.days ?? 30;
+    const cwd = options.cwd === undefined ? process.cwd() : options.cwd;
+    const includeGateway = options.includeGateway ?? true;
+    const sessions = (await listSessions({ cwd })).filter(isInsightSession).filter((s) => withinDays(s.updated, days));
+    const gatewaySessions = includeGateway
+        ? (await listGatewaySessions()).filter(isInsightSession).filter((s) => withinDays(s.updated, days))
+        : [];
+    const models = new Map();
+    let messages = 0;
+    let userMessages = 0;
+    let assistantMessages = 0;
+    let approxTokens = 0;
+    const countSession = (session) => {
+        addModelCount(models, session.model);
+        messages += session.messages.length;
+        const roles = countRoles(session.messages);
+        userMessages += roles.user;
+        assistantMessages += roles.assistant;
+        approxTokens += estimateTokens(session.messages);
+    };
+    for (const s of sessions)
+        countSession(s);
+    for (const s of gatewaySessions)
+        countSession(s);
+    return [
+        `${BRAND.productName} insights (${days}d)`,
+        `scope: ${cwd ? 'current project' : 'all projects'}${includeGateway ? ' + gateway' : ''}`,
+        `sessions: ${sessions.length}`,
+        `gateway sessions: ${gatewaySessions.length}`,
+        `messages: ${messages} (${userMessages} user, ${assistantMessages} assistant)`,
+        `approx tokens in saved history: ~${approxTokens}`,
+        `models: ${topModels(models)}`,
+    ].join('\n');
+}
+export { parseInsightsDays };

package/dist/knowledge.js

@@ -2,8 +2,8 @@ import { loadStore, activeFacts } from './memory-store.js';
 import { loadSkills } from './skills.js';
 import { loadIndex } from './search/store.js';
 import { foldFacts, foldSessions, foldSkills, loadRecentSessions } from './search/indexer.js';
-import { rankSearch } from './search/engine.js';
-import { termList } from './search/index-core.js';
+import { rankSearch, search } from './search/engine.js';
+import { termList, SEARCH_SOURCES } from './search/index-core.js';
 // recall = ค้น knowledge ที่สะสม (auto-memory + vault + skills + session เก่า) แบบ BM25
 // เดิมเป็น substring term-count (ไม่มี ranking/IDF) → อัปเกรดเป็น real BM25 inverted index
 // (src/search/) ที่ rank ข้าม corpus เดียวกัน + ตัด snippet ให้
@@ -20,7 +20,7 @@ export function scoreText(text, terms) {
     return terms.reduce((s, t) => s + (l.includes(t) ? 1 : 0), 0);
 }
 /** label สั้นต่อ hit (memory ไม่มี title → ใช้ snippet; vault มี path ต่อท้าย) */
-function formatHit(h) {
+export function formatHit(h) {
     const title = h.title.trim();
     const snippet = h.snippet.trim();
     const head = title ? [title, snippet].filter(Boolean).join(' — ') : snippet;
@@ -31,37 +31,63 @@ function formatHit(h) {
  * ค้น knowledge ข้าม memory + vault + skills + sessions ด้วย BM25 (ranked + snippet).
  * คืน plain-text สำหรับ agent อ่าน (สัญญาเดิม) — ใช้โดย recall tool.
  */
-export async function recall(query, limit = 8) {
-    if (termList(query).length === 0) {
-        return 'query สั้นเกินไป — ใส่คำค้นยาวขึ้น';
-    }
+/**
+ * Ranked hits over memory + vault + skills + sessions (BM25, deterministic, no network).
+ * Loads the persisted index then folds LIVE corpora so a just-remembered fact is found
+ * immediately without a reindex. Shared by the recall tool and per-turn auto-retrieval.
+ */
+export async function recallHits(query, limit = 8, sources) {
     const now = Date.now();
+    const want = sources ? new Set(sources) : undefined; // undefined = all sources
     const { index } = await loadIndex(); // persisted (vault chunks); empty ok
-    // fold live corpora สด — memory/session/skill ล่าสุด (ไม่แตะไฟล์ persisted)
-    try {
-        foldFacts(index, activeFacts(await loadStore(now)), now);
-    }
-    catch {
-        /* ยังไม่มี memory */
-    }
-    try {
-        foldSessions(index, await loadRecentSessions());
+    // fold live corpora สด — memory/session/skill ล่าสุด (ไม่แตะไฟล์ persisted). Skip a corpus when
+    // it's filtered out (saves folding 100+ skills when callers only want project sources).
+    if (!want || want.has('memory')) {
+        try {
+            foldFacts(index, activeFacts(await loadStore(now)), now);
+        }
+        catch {
+            /* ยังไม่มี memory */
+        }
     }
-    catch {
-        /* ยังไม่มี session */
+    if (!want || want.has('session')) {
+        try {
+            foldSessions(index, await loadRecentSessions());
+        }
+        catch {
+            /* ยังไม่มี session */
+        }
     }
-    try {
-        foldSkills(index, (await loadSkills()).map((s) => ({
-            id: `skill:${s.name}`,
-            name: s.name,
-            text: `${s.description} ${s.whenToUse ?? ''}`.trim(),
-        })));
+    if (!want || want.has('skill')) {
+        try {
+            foldSkills(index, (await loadSkills()).map((s) => ({
+                id: `skill:${s.name}`,
+                name: s.name,
+                text: `${s.description} ${s.whenToUse ?? ''}`.trim(),
+            })));
+        }
+        catch {
+            /* ยังไม่มี skill */
+        }
     }
-    catch {
-        /* ยังไม่มี skill */
+    return rankSearch(index, query, { mode: 'fts', limit, sources }).hits;
+}
+/**
+ * Hybrid (semantic + BM25) recall over the persisted index + embeddings — the "lever" identified by
+ * experiment H5 for paraphrase/synonym queries. Degrades to BM25 automatically when no embedder /
+ * vectors are configured (never throws). Covers INDEXED content (run `sanook index`); just-remembered
+ * facts still surface via the default BM25 recallHits path. Opt-in per-turn (network/latency cost).
+ */
+export async function semanticRecallHits(query, limit = 8, sources) {
+    const res = await search(query, { mode: 'hybrid', limit, sources: sources ?? [...SEARCH_SOURCES] });
+    return res.hits;
+}
+export async function recall(query, limit = 8) {
+    if (termList(query).length === 0) {
+        return 'query สั้นเกินไป — ใส่คำค้นยาวขึ้น';
     }
-    const res = rankSearch(index, query, { mode: 'fts', limit });
-    if (!res.hits.length)
+    const hits = await recallHits(query, limit);
+    if (!hits.length)
         return `ไม่เจอความรู้เกี่ยวกับ "${query}" ใน memory/vault/skills/sessions`;
-    return res.hits.map(formatHit).join('\n');
+    return hits.map(formatHit).join('\n');
 }