xitto-kernel 0.1.0 → 0.3.0

package/src/app/server.js

@@ -0,0 +1,102 @@
+// Server app（PoC）— 把 kernel 包成 HTTP 服務（零依賴 node:http）。
+// 證明 kernel 能脫離 CLI 跑成服務：bearer token 認證、per-session 隔離工作目錄、沙箱、結構化日誌、
+// JSON 或 SSE 串流。這是「另一個 app 消費同一組 kernel 事件」—— 不動 kernel 核心。
+import { createServer } from 'node:http';
+import { mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { createKernel } from '../kernel/index.js';
+import { loadModel } from './providers.js';
+import { createCodingPack } from '../packs/coding/index.js';
+import { createDataQueryPack } from '../packs/data-query/index.js';
+import { createNotesPack } from '../packs/notes/index.js';
+import { createGeneralPack } from '../packs/general/index.js';
+import { createDeepResearchPack } from '../packs/deep-research/index.js';
+import { createDevopsPack } from '../packs/devops/index.js';
+
+const PACKS = {
+  coding: createCodingPack, 'data-query': createDataQueryPack, notes: createNotesPack,
+  general: createGeneralPack, 'deep-research': createDeepResearchPack, devops: createDevopsPack,
+};
+
+const lastText = (history) => ([...(history || [])].reverse().find((m) => m.role === 'assistant')?.content || []).filter((c) => c.type === 'text').map((c) => c.text).join('');
+const newId = () => 's' + Date.now().toString(36) + Math.random().toString(36).slice(2, 6);
+
+/**
+ * @param {Object} o
+ * @param {object} o.model
+ * @param {Function} o.getApiKey
+ * @param {string} [o.token]        bearer token（未設＝不驗證，僅 PoC）
+ * @param {string} [o.baseDir]      每個 session 的隔離工作目錄根
+ * @param {boolean} [o.sandbox]     是否沙箱（預設 true：服務端跑 agent 應隔離）
+ * @returns {import('node:http').Server}
+ */
+export function createServerApp({ model, getApiKey, token, baseDir = '.xitto-server', sandbox = true } = {}) {
+  const sessions = new Map(); // sessionId -> { pack, history }
+  mkdirSync(baseDir, { recursive: true });
+
+  const json = (res, code, obj) => { res.writeHead(code, { 'content-type': 'application/json; charset=utf-8' }); res.end(JSON.stringify(obj)); };
+  const authed = (req) => !token || (req.headers.authorization === `Bearer ${token}`);
+  const log = (o) => console.log(JSON.stringify({ ts: new Date().toISOString(), ...o }));
+  const readBody = (req) => new Promise((resolve) => { let b = ''; req.on('data', (c) => { b += c; if (b.length > 1e6) req.destroy(); }); req.on('end', () => { try { resolve(JSON.parse(b || '{}')); } catch { resolve({}); } }); });
+
+  return createServer(async (req, res) => {
+    const url = new URL(req.url, 'http://localhost');
+    if (req.method === 'GET' && url.pathname === '/health') return json(res, 200, { ok: true, packs: Object.keys(PACKS), model: model.id });
+    if (!authed(req)) return json(res, 401, { error: 'unauthorized（帶 Authorization: Bearer <token>）' });
+
+    if (req.method === 'POST' && (url.pathname === '/v1/run' || url.pathname === '/v1/stream')) {
+      const body = await readBody(req);
+      const make = PACKS[body.pack || 'general'];
+      if (!make) return json(res, 400, { error: `未知 pack「${body.pack}」，可用：${Object.keys(PACKS).join(', ')}` });
+      const sessionId = body.sessionId || newId();
+      const sess = sessions.get(sessionId) || { pack: body.pack || 'general', history: [] };
+      const workdir = join(baseDir, sessionId); mkdirSync(workdir, { recursive: true });
+      const kernel = createKernel(make({ cwd: workdir }), { cwd: workdir, model, getApiKey, sandbox: { enabled: sandbox }, getSandbox: () => sandbox, confirm: async () => 'yes' });
+
+      const usage = { input: 0, output: 0 };
+      const streaming = url.pathname === '/v1/stream';
+      if (streaming) res.writeHead(200, { 'content-type': 'text/event-stream; charset=utf-8', 'cache-control': 'no-cache', connection: 'keep-alive' });
+      const sse = (o) => res.write(`data: ${JSON.stringify(o)}\n\n`);
+      const onEvent = (ev) => {
+        if (ev.type === 'message_end' && ev.message?.usage) { usage.input += ev.message.usage.input || 0; usage.output += ev.message.usage.output || 0; }
+        if (!streaming) return;
+        if (ev.type === 'tool_execution_start') sse({ type: 'tool', name: ev.toolName, args: ev.args });
+        else if (ev.type === 'message_update' && ev.assistantMessageEvent?.type === 'text_delta') sse({ type: 'text', delta: ev.assistantMessageEvent.delta });
+      };
+
+      const t0 = Date.now();
+      try {
+        const r = (body.mode === 'goal')
+          ? await kernel.runGoal(body.goal || body.input || '', { history: sess.history, onEvent })
+          : await kernel.runTurn(body.input || '', { history: sess.history, onEvent });
+        sess.history = r.messages || r.history || []; sessions.set(sessionId, sess);
+        const text = r.text ?? lastText(sess.history);
+        log({ pack: sess.pack, session: sessionId, mode: body.mode || 'turn', tokens: usage.input + usage.output, rounds: r.rounds, ms: Date.now() - t0 });
+        const payload = { sessionId, text, usage, rounds: r.rounds, done: r.done };
+        if (streaming) { sse({ type: 'done', ...payload }); res.end(); }
+        else json(res, 200, payload);
+      } catch (e) {
+        log({ pack: sess.pack, session: sessionId, error: e.message });
+        if (streaming) { sse({ type: 'error', error: e.message }); res.end(); } else json(res, 500, { error: e.message });
+      }
+      return;
+    }
+    json(res, 404, { error: 'not found' });
+  });
+}
+
+export function startServer() {
+  const port = Number(process.env.PORT || 8787);
+  const token = process.env.XITTO_SERVER_TOKEN || 'dev-token';
+  const sandbox = process.env.XITTO_SERVER_SANDBOX !== 'off';
+  const { model, getApiKey } = loadModel(process.env.XITTO_MODEL);
+  const server = createServerApp({ model, getApiKey, token, sandbox });
+  server.listen(port, () => {
+    console.log(`xitto-kernel server · http://localhost:${port} · model ${model.id} · 沙箱 ${sandbox ? '開' : '關'}`);
+    console.log(`token: ${token === 'dev-token' ? 'dev-token（請設 XITTO_SERVER_TOKEN）' : '(已設定)'}`);
+  });
+  return server;
+}
+
+if (process.argv[1] && process.argv[1] === fileURLToPath(import.meta.url)) startServer();

package/src/app/templates/package.json.tmpl

@@ -7,6 +7,6 @@
     "start": "node index.js"
   },
   "dependencies": {
-    "xitto-kernel": "file:__KERNEL_PATH__"
+    "xitto-kernel": "__KERNEL_DEP__"
   }
 }

package/src/app/tui-run.js

@@ -0,0 +1,198 @@
+// Ink TUI driver — 把 kernel 接上 tui.js 的 store/handlers/App（對標 Claude Code 的全 TUI 體驗）。
+// 常駐狀態列、串流即時重繪、Esc 中斷、權限 Select、@檔案/!bash/#記憶/斜線指令。
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { isAbsolute, join } from 'node:path';
+import { homedir } from 'node:os';
+import { execSync } from 'node:child_process';
+import { createKernel } from '../kernel/index.js';
+import { createStore, mountTui, gutter } from './tui.js';
+import { md } from './md-render.js';
+
+const summarize = (args) => { const s = JSON.stringify(args ?? {}); return s.length > 60 ? s.slice(0, 57) + '…' : s; };
+const Y = (s) => `\x1b[33m${s}\x1b[39m`; const G = (s) => `\x1b[90m${s}\x1b[39m`; const R = (s) => `\x1b[31m${s}\x1b[39m`; const C = (s) => `\x1b[36m${s}\x1b[39m`;
+
+const SLASH = { '/help': '說明', '/goal': '目標循環', '/sandbox': '沙箱', '/auto': '自動核准', '/plan': '計劃模式', '/undo': '撤銷', '/tools': '工具', '/memory': '記憶', '/sessions': '對話', '/resume': '續接', '/cost': '成本', '/clear': '清除', '/exit': '離開' };
+
+export function runTui({ pack, model, getApiKey, sandbox = false, resume = null }) {
+  const cwd = process.cwd();
+  const store = createStore();
+  let history = [];
+  let sessionId;
+  let currentAgent = null;
+  let planMode = false;
+  let sandboxOn = !!sandbox;
+  let autoApprove = false;
+  let pendingSelect = null;
+  const sessionTok = { in: 0, out: 0 };
+
+  const askConfirm = (name, args, danger) => {
+    if (autoApprove && !danger) return Promise.resolve('yes');
+    return new Promise((resolve) => {
+      const opts = danger ? ['允許一次', '拒絕'] : ['允許', '此工具全部允許', '拒絕'];
+      const map = danger ? ['yes', 'no'] : ['yes', 'always', 'no'];
+      pendingSelect = { resolve, map };
+      store.askSelect((danger ? R(`⛔ 危險：${danger}\n`) : '') + Y(`允許 ${name}`) + G(`(${summarize(args)})`), opts);
+    });
+  };
+
+  const kernel = createKernel(pack, {
+    model, getApiKey,
+    sandbox: { enabled: sandboxOn }, getSandbox: () => sandboxOn,
+    getPlanMode: () => planMode, confirm: askConfirm,
+  });
+  sessionId = kernel.session.newId();
+  if (resume) {
+    const data = resume === true ? (kernel.session.latest() && kernel.session.load(kernel.session.latest().id)) : kernel.session.load(resume);
+    if (data?.messages?.length) { history = data.messages; sessionId = data.id; }
+  }
+  const persist = () => { try { kernel.session.save(sessionId, history); } catch { /* 略 */ } };
+
+  // ── kernel 事件 → store ──
+  const toolBlock = (name, result, isError) => {
+    const text = (result?.content || []).map((c) => c.text || '').join(' ').replace(/\s+/g, ' ').trim();
+    return Y(`⏺ ${name}`) + '\n' + (isError ? R('  ⎿ ✗ ' + text.slice(0, 200)) : G('  ⎿ ✓ ' + text.slice(0, 120)));
+  };
+  const onEvent = (ev) => {
+    switch (ev.type) {
+      case 'message_update': {
+        const a = ev.assistantMessageEvent;
+        if (a?.type === 'text_delta' && a.delta) store.appendLive(a.delta);
+        else if (a?.type === 'thinking_delta' && a.delta) store.appendThinking(a.delta);
+        break;
+      }
+      case 'message_end': {
+        const u = ev.message?.usage;
+        if (u) { sessionTok.in += u.input || 0; sessionTok.out += u.output || 0; const used = (u.input || 0) + (u.cacheRead || 0) + (u.cacheWrite || 0); if (used) store.set({ ctx: { used, total: model.contextWindow || 0 } }); }
+        break;
+      }
+      case 'tool_execution_start':
+        store.finalizeLive();
+        if (ev.toolName === 'todo_write' && Array.isArray(ev.args?.todos)) {
+          store.pushBlock(C('☑ 待辦') + '\n' + ev.args.todos.map((t) => '  ' + (t.status === 'completed' ? '\x1b[32m☑\x1b[39m ' + G(t.content) : t.status === 'in_progress' ? Y('◐ ') + t.content : G('☐ ' + t.content))).join('\n'));
+        } else {
+          store.setTool({ name: ev.toolName, summary: summarize(ev.args) });
+        }
+        break;
+      case 'tool_execution_end':
+        store.setTool(null);
+        if (ev.toolName !== 'todo_write') store.pushBlock(toolBlock(ev.toolName, ev.result, ev.isError));
+        break;
+      case 'verify_start': store.finalizeLive(); store.pushBlock(G('  🔎 自動驗收…')); break;
+      case 'verify_end': store.pushBlock(ev.ok ? G('  ✓ 驗收通過') : Y('  ✗ 驗收失敗，修正中…')); break;
+      case 'compact': store.pushBlock(G(`  ⊙ 已壓縮上下文：${ev.tokensBefore}→${ev.tokensAfter} tokens`)); break;
+      case 'hook_fail': store.pushBlock(Y(`  ✗ hook 失敗 ${ev.command}`)); break;
+      case 'agent_end': store.finalizeLive(); break;
+    }
+  };
+
+  // ── @檔案展開 ──
+  const expandMentions = (text) => text.replace(/(^|\s)@(\S+)/g, (m, sp, p) => {
+    const fp = isAbsolute(p) ? p : join(cwd, p);
+    if (existsSync(fp)) { try { return `${sp}${p}\n\n<file path="${p}">\n${readFileSync(fp, 'utf8').slice(0, 8000)}\n</file>`; } catch { return m; } }
+    return m;
+  });
+
+  const refreshGit = () => {
+    try { const b = execSync('git rev-parse --abbrev-ref HEAD', { cwd, encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim(); const dirty = execSync('git status --short', { cwd, encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim(); store.set({ gitLabel: b ? `⎇ ${b}${dirty ? ' ✱' : ''}` : '' }); } catch { store.set({ gitLabel: '' }); }
+  };
+  const setStatus = () => { store.set({ modelLabel: model.id, cwdLabel: cwd.replace(homedir(), '~'), sandboxLabel: sandboxOn ? '🔒 sandbox' : '', permLabel: autoApprove ? '⚡ auto' : '' }); store.setPlan(planMode); refreshGit(); };
+
+  const cmdHistory = [];
+  let ink;
+  const doExit = () => { persist(); try { ink?.unmount(); } catch { /* 略 */ } process.exit(0); };
+
+  // ── 斜線指令 ──
+  const slash = (input) => {
+    const [cmd, arg] = input.split(/\s+/);
+    switch (cmd) {
+      case '/exit': case '/quit': doExit(); return true;
+      case '/help': store.pushBlock(G(Object.entries(SLASH).map(([k, v]) => `  ${k}  ${v}`).join('\n') + '\n  @檔案 引用 · !命令 直接跑 · #文字 存記憶')); return true;
+      case '/sandbox': sandboxOn = arg ? arg === 'on' : !sandboxOn; setStatus(); store.pushBlock(sandboxOn ? Y('🔒 沙箱開') : G('沙箱關')); return true;
+      case '/auto': autoApprove = arg ? arg === 'on' : !autoApprove; setStatus(); store.pushBlock(autoApprove ? Y('⚡ 自動核准開') : G('自動核准關')); return true;
+      case '/plan': planMode = arg ? arg === 'on' : !planMode; setStatus(); store.pushBlock(planMode ? C('📋 計劃模式開') : G('計劃模式關')); return true;
+      case '/undo': { const r = kernel.undo(); store.pushBlock(r.undone ? G(`↩ 已撤銷 ${r.path}`) : Y(r.reason)); return true; }
+      case '/tools': store.pushBlock(G(kernel.registry.names().join('  '))); return true;
+      case '/memory': { const m = kernel.memory.list(); store.pushBlock(m.length ? G(m.map((x) => '  • ' + x).join('\n')) : G('（尚無記憶）')); return true; }
+      case '/cost': store.pushBlock(G(`本 session 累計：${sessionTok.in + sessionTok.out} tokens（in ${sessionTok.in} / out ${sessionTok.out}）`)); return true;
+      case '/sessions': { const ss = kernel.session.list(); store.pushBlock(ss.length ? G(ss.map((s) => `  ${s.id}  [${s.count} 則]`).join('\n')) : G('（尚無對話）')); return true; }
+      case '/resume': { const t = arg || kernel.session.latest()?.id; const d = t ? kernel.session.load(t) : null; if (d?.messages?.length) { history = d.messages; sessionId = d.id; store.pushBlock(G(`（已續接 ${d.id}，${d.messages.length} 則）`)); } else store.pushBlock(Y('找不到可續接的 session')); return true; }
+      case '/clear': history = []; sessionId = kernel.session.newId(); store.pushBlock(G('（已清除歷史，開新 session）')); return true;
+      default: store.pushBlock(R(`未知指令 ${cmd}（/help）`)); return true;
+    }
+  };
+
+  // ── 送出 ──
+  async function onSubmit(raw) {
+    const input = (raw || '').trim();
+    if (!input) return;
+    if (store.get().mode === 'busy') { try { currentAgent?.steer({ role: 'user', content: input }); store.pushBlock(G('  ↪ 已插入引導')); } catch { /* 略 */ } return; }
+    cmdHistory.push(input);
+    store.pushBlock('\n' + input.split('\n').map((l) => `\x1b[34m▌ \x1b[1m${l}\x1b[22m\x1b[39m`).join('\n'));
+
+    if (input.startsWith('/goal ') || input === '/goal') { return runGoal(input.slice(5).trim()); }
+    if (input.startsWith('/')) { slash(input); return; }
+    if (input.startsWith('!')) { const r = (() => { try { return execSync(input.slice(1), { cwd, encoding: 'utf8', timeout: 60000, stdio: ['ignore', 'pipe', 'pipe'] }); } catch (e) { return (e.stdout || '') + (e.stderr || '') || e.message; } })(); store.pushBlock(G('$ ' + input.slice(1)) + '\n' + (r.trim() || '(no output)')); return; }
+    if (input.startsWith('#')) { const r = kernel.memory.save(input.slice(1).trim()); store.pushBlock(r.saved ? G('✎ 已記住：' + r.saved) : G('（記憶已存在或空）')); return; }
+
+    store.setMode('busy'); store.set({ busyAt: Date.now() });
+    try {
+      const text = expandMentions(planMode ? `[計劃模式：只規劃、列步驟與會改動的檔案，不要實際寫檔或執行命令]\n\n${input}` : input);
+      const r = await kernel.runTurn(text, { history, onEvent, onAgent: (a) => { currentAgent = a; } });
+      store.finalizeLive(); history = r.messages; persist();
+    } catch (e) { store.finalizeLive(); store.pushBlock(R('錯誤：' + e.message)); }
+    finally { currentAgent = null; store.setTool(null); store.set({ busyAt: null }); store.setMode('idle'); refreshGit(); }
+  }
+
+  async function runGoal(goal) {
+    if (!goal) { store.pushBlock(G('用法 /goal <目標>')); return; }
+    store.pushBlock(C('🎯 目標：') + goal);
+    store.setMode('busy'); store.set({ busyAt: Date.now() });
+    try {
+      const r = await kernel.runGoal(goal, {
+        history,
+        onRound: ({ round, maxRounds }) => { store.finalizeLive(); store.pushBlock(Y(`🔁 第 ${round}/${maxRounds} 輪`)); },
+        onCheck: ({ done, remaining }) => { store.finalizeLive(); store.pushBlock(done ? G('  ✓ 驗收：已達成') : G('  ↻ ' + remaining)); },
+        onEvent, onAgent: (a) => { currentAgent = a; },
+      });
+      store.finalizeLive(); history = r.history; persist();
+      store.pushBlock(r.done ? G(`✅ 目標達成（${r.rounds} 輪）`) : Y(`⚠ 未達成（${r.rounds} 輪）`));
+    } catch (e) { store.finalizeLive(); store.pushBlock(R('錯誤：' + e.message)); }
+    finally { currentAgent = null; store.setTool(null); store.set({ busyAt: null }); store.setMode('idle'); refreshGit(); }
+  }
+
+  // ── 補全（斜線 + @檔案）──
+  const complete = (text) => {
+    const sm = text.match(/^\/(\S*)$/);
+    if (sm) { const items = Object.keys(SLASH).filter((c) => c.startsWith('/' + sm[1])).map((c) => ({ value: c, desc: SLASH[c] })); return items.length ? { start: 0, items } : null; }
+    const am = text.match(/(?:^|\s)@(\S*)$/);
+    if (am) {
+      const frag = am[1]; const at = text.length - frag.length - 1; const slashI = frag.lastIndexOf('/');
+      const dir = slashI >= 0 ? frag.slice(0, slashI + 1) : ''; const base = slashI >= 0 ? frag.slice(slashI + 1) : frag;
+      let entries; try { entries = readdirSync(join(cwd, dir), { withFileTypes: true }); } catch { return null; }
+      const items = entries.filter((e) => e.name.startsWith(base) && !e.name.startsWith('.')).slice(0, 8).map((e) => '@' + dir + e.name + (e.isDirectory() ? '/' : ''));
+      return items.length ? { start: at, items } : null;
+    }
+    return null;
+  };
+
+  const abort = () => { try { currentAgent?.abort(); } catch { /* 略 */ } if (pendingSelect) { const p = pendingSelect; pendingSelect = null; store.clearSelect(); p.resolve('no'); } store.finalizeLive(); store.setTool(null); store.set({ busyAt: null }); store.setMode('idle'); };
+  let lastCtrlC = 0;
+  const handlers = {
+    onSubmit,
+    onCtrlC: () => { if (store.get().mode === 'busy') { abort(); store.pushBlock(Y('⏹ 已中斷')); return; } const now = Date.now(); if (now - lastCtrlC < 2000) doExit(); else { lastCtrlC = now; store.pushBlock(G('再按一次 Ctrl+C 離開')); } },
+    onEscape: () => { if (store.get().mode === 'busy') { abort(); store.pushBlock(Y('⏹ 已中斷')); } },
+    getHistory: () => cmdHistory,
+    complete,
+    onSelectChoice: (idx) => { const p = pendingSelect; pendingSelect = null; store.clearSelect(); if (p) p.resolve(p.map[idx] ?? 'no'); },
+    onSelectCancel: () => { const p = pendingSelect; pendingSelect = null; store.clearSelect(); if (p) p.resolve('no'); },
+    onSelectAbort: () => { abort(); },
+  };
+
+  // 橫幅 + 狀態列
+  store.pushBlock('\n' + C('✻ ') + '\x1b[1mxitto-kernel\x1b[22m' + G(`  ·  ${pack.name} pack  ·  ${model.id}`) + '\n' + G('  Esc 中斷 · /help · @檔案 · !命令 · #記憶 · Tab 補全'));
+  setStatus();
+  store.setMode('idle'); store.setPlaceholder('輸入訊息…');
+  process.stdout.write('\x1b[2J\x1b[3J\x1b[H');
+  ink = mountTui({ store, handlers });
+  return ink;
+}