@stackbilt/aegis-core 0.6.5 → 0.8.0

package/cli/aegis.mjs

@@ -0,0 +1,356 @@
+#!/usr/bin/env node
+// AEGIS CLI: zero-dependency terminal chat over /chat/ws.
+// Requires Node >= 21 for the built-in WebSocket client.
+
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import readline from 'node:readline';
+import { stdin, stdout } from 'node:process';
+import { fileURLToPath } from 'node:url';
+
+const pkg = JSON.parse(readFileSync(join(dirname(fileURLToPath(import.meta.url)), '..', 'package.json'), 'utf8'));
+const args = process.argv.slice(2);
+const has = (flag) => args.includes(flag);
+const argVal = (flag) => {
+  const i = args.indexOf(flag);
+  return i >= 0 ? args[i + 1] : undefined;
+};
+
+const HELP = `AEGIS CLI
+
+Usage:
+  aegis [--host <host>] [--token <token>] [--exec <executor>] [--conversation <uuid>] [--verbose] [--quick]
+
+Options:
+  --host <host>            AEGIS worker host or URL. Defaults to AEGIS_HOST or aegis.stackbilt.dev.
+  --token <token>          Bearer token. Defaults to AEGIS_TOKEN.
+  --exec <executor>        Force an executor for this session. Use auto to let the kernel route.
+  --conversation <uuid>    Resume an existing conversation.
+  --verbose                Show executor/classification/cost metadata after each response.
+  --quick                  Skip the startup executor picker.
+  --version                Print version and exit.
+  --help                   Print this help and exit.
+
+REPL commands:
+  /new  /exec [name]  /verbose  /clear  /help  /quit
+`;
+
+if (has('--help') || has('-h')) {
+  console.log(HELP.trimEnd());
+  process.exit(0);
+}
+if (has('--version') || has('-v')) {
+  console.log(pkg.version);
+  process.exit(0);
+}
+if (typeof WebSocket === 'undefined') {
+  console.error('AEGIS CLI requires Node >= 21 for built-in WebSocket support.');
+  process.exit(1);
+}
+
+let conversationId = argVal('--conversation') || null;
+let executor = normalizeExecutor(argVal('--exec'));
+let verbose = has('--verbose');
+const quick = has('--quick') || Boolean(argVal('--exec'));
+const token = argVal('--token') || process.env.AEGIS_TOKEN;
+const host = normalizeHost(argVal('--host') || process.env.AEGIS_HOST || 'aegis.stackbilt.dev');
+
+if (!token) {
+  console.error('Missing AEGIS_TOKEN. Set AEGIS_TOKEN or pass --token <token>.');
+  process.exit(1);
+}
+
+const c = {
+  reset: '\x1b[0m',
+  dim: '\x1b[2m',
+  bold: '\x1b[1m',
+  cyan: '\x1b[36m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  red: '\x1b[31m',
+};
+const paint = (color, s) => `${color}${s}${c.reset}`;
+
+const EXECUTORS = [
+  { value: null, label: 'auto', hint: 'kernel routes automatically' },
+  { value: 'workers_ai', label: 'workers_ai', hint: 'Cloudflare Workers AI' },
+  { value: 'gpt_oss', label: 'gpt_oss', hint: 'tool-capable standard path' },
+  { value: 'groq', label: 'groq', hint: 'fast simple responses' },
+  { value: 'claude', label: 'claude', hint: 'reliability-critical work' },
+  { value: 'claude_opus', label: 'claude_opus', hint: 'frontier tier' },
+  { value: 'composite', label: 'composite', hint: 'multi-model synthesis' },
+];
+
+const EXECUTOR_VALUES = new Set(EXECUTORS.map((e) => e.value).filter(Boolean));
+
+function normalizeExecutor(value) {
+  if (!value || value === 'auto') return null;
+  return value;
+}
+
+function normalizeHost(value) {
+  return value.replace(/^https?:\/\//, '').replace(/^wss?:\/\//, '').replace(/\/+$/, '');
+}
+
+function printBanner() {
+  console.log('');
+  console.log(paint(c.cyan, 'AEGIS'));
+  console.log(paint(c.dim, 'persistent agent terminal'));
+  console.log('');
+}
+
+function select(title, options, initial = 0) {
+  return new Promise((resolve) => {
+    let idx = initial;
+    readline.emitKeypressEvents(stdin);
+    const wasRaw = Boolean(stdin.isRaw);
+    if (stdin.isTTY) stdin.setRawMode(true);
+
+    const draw = (first = false) => {
+      if (!first) stdout.write(`\x1b[${options.length + 1}A`);
+      stdout.write(`${c.bold}?${c.reset} ${title}\x1b[K\n`);
+      options.forEach((o, i) => {
+        const on = i === idx;
+        const pointer = on ? paint(c.cyan, '>') : ' ';
+        const label = on ? paint(c.cyan, o.label) : o.label;
+        const hint = o.hint ? paint(c.dim, `  - ${o.hint}`) : '';
+        stdout.write(`${pointer} ${label}${hint}\x1b[K\n`);
+      });
+    };
+
+    const done = (value) => {
+      stdin.removeListener('keypress', onKey);
+      if (stdin.isTTY) stdin.setRawMode(wasRaw);
+      resolve(value);
+    };
+
+    const onKey = (_str, key) => {
+      if (!key) return;
+      if (key.name === 'up' || key.name === 'k') {
+        idx = (idx - 1 + options.length) % options.length;
+        draw();
+      } else if (key.name === 'down' || key.name === 'j') {
+        idx = (idx + 1) % options.length;
+        draw();
+      } else if (key.name === 'return') {
+        done(options[idx].value);
+      } else if (key.name === 'escape') {
+        done(options[initial].value);
+      } else if (key.ctrl && key.name === 'c') {
+        stdout.write('\n');
+        process.exit(0);
+      }
+    };
+
+    draw(true);
+    stdin.on('keypress', onKey);
+  });
+}
+
+function makeSpinner(label) {
+  const frames = ['-', '\\', '|', '/'];
+  let i = 0;
+  let timer = null;
+  return {
+    start() {
+      if (timer) return;
+      timer = setInterval(() => {
+        stdout.write(`\r${paint(c.cyan, frames[i = (i + 1) % frames.length])} ${paint(c.dim, label)}\x1b[K`);
+      }, 90);
+    },
+    stop() {
+      if (timer) clearInterval(timer);
+      timer = null;
+      stdout.write('\r\x1b[K');
+    },
+  };
+}
+
+const fmtCost = (n) => (typeof n === 'number' ? `$${n.toFixed(5)}` : `$${n ?? 0}`);
+const think = makeSpinner('thinking');
+let rl = null;
+let conn = null;
+
+function connect() {
+  const q = new URLSearchParams({ token });
+  if (conversationId) q.set('conversationId', conversationId);
+  const ws = new WebSocket(`wss://${host}/chat/ws?${q.toString()}`, 'aegis-chat');
+  let streaming = false;
+  let pending = false;
+  let firstDelta = false;
+
+  ws.addEventListener('open', () => {
+    think.stop();
+    console.log(`${paint(c.green, 'connected')} ${paint(c.dim, host)}`);
+    console.log(`${paint(c.dim, 'executor')} ${executor || 'auto'}`);
+    console.log(`${paint(c.dim, 'conversation')} ${conversationId ?? 'new on first message'}`);
+    console.log(paint(c.dim, '/new  /exec [name]  /verbose  /clear  /help  /quit'));
+    startRepl();
+  });
+
+  ws.addEventListener('message', (ev) => {
+    let frame;
+    try {
+      frame = JSON.parse(typeof ev.data === 'string' ? ev.data : ev.data.toString());
+    } catch {
+      return;
+    }
+
+    switch (frame.type) {
+      case 'history':
+        if (Array.isArray(frame.messages) && frame.messages.length) {
+          console.log(paint(c.dim, `${frame.messages.length} prior messages loaded`));
+        }
+        break;
+      case 'start':
+        if (frame.conversationId) conversationId = frame.conversationId;
+        streaming = true;
+        firstDelta = false;
+        break;
+      case 'delta':
+        if (!frame.text) break;
+        if (!firstDelta) {
+          think.stop();
+          stdout.write(`${paint(c.cyan, 'aegis')} `);
+          firstDelta = true;
+        }
+        stdout.write(frame.text);
+        break;
+      case 'done':
+        if (!firstDelta) think.stop();
+        streaming = false;
+        pending = false;
+        stdout.write('\n');
+        if (verbose && frame.metadata) {
+          const md = frame.metadata;
+          console.log(paint(c.dim, `${md.executor} / ${md.classification} / ${fmtCost(md.cost)} / ${md.latencyMs ?? '?'}ms${md.grounded !== undefined ? ` / grounded=${md.grounded}` : ''}`));
+          if (md.unverifiedClaims?.length) console.log(paint(c.yellow, `${md.unverifiedClaims.length} unverified claim(s)`));
+        }
+        rl?.prompt();
+        break;
+      case 'error':
+        think.stop();
+        streaming = false;
+        pending = false;
+        console.log(`\n${paint(c.red, 'error:')} ${frame.error}`);
+        rl?.prompt();
+        break;
+    }
+  });
+
+  ws.addEventListener('error', () => {
+    think.stop();
+    console.log(paint(c.red, 'websocket error'));
+  });
+  ws.addEventListener('close', (ev) => {
+    think.stop();
+    console.log(paint(c.dim, `disconnected${ev.reason ? ` (${ev.reason})` : ''}`));
+    process.exit(ev.code === 1000 ? 0 : 1);
+  });
+
+  return {
+    send(text) {
+      if (pending || streaming) {
+        console.log(paint(c.dim, 'still responding'));
+        return;
+      }
+      pending = true;
+      think.start();
+      ws.send(JSON.stringify({
+        type: 'message',
+        text,
+        conversationId,
+        eventId: crypto.randomUUID(),
+        ...(executor ? { executor } : {}),
+      }));
+    },
+    close() {
+      ws.close(1000, 'bye');
+    },
+  };
+}
+
+function startRepl() {
+  rl = readline.createInterface({ input: stdin, output: stdout, prompt: `${paint(c.green, '>')} ` });
+  rl.prompt();
+
+  rl.on('line', async (line) => {
+    const text = line.trim();
+    if (!text) {
+      rl.prompt();
+      return;
+    }
+
+    if (text.startsWith('/')) {
+      const [cmd, arg] = text.slice(1).split(/\s+/);
+      switch (cmd) {
+        case 'new':
+          conversationId = null;
+          console.log(paint(c.dim, 'new conversation on next message'));
+          break;
+        case 'exec':
+          if (arg) {
+            const next = normalizeExecutor(arg);
+            if (next && !EXECUTOR_VALUES.has(next)) {
+              console.log(paint(c.dim, `unknown executor: ${arg}`));
+            } else {
+              executor = next;
+              console.log(paint(c.dim, `executor -> ${executor || 'auto'}`));
+            }
+            break;
+          }
+          if (!stdin.isTTY) {
+            console.log(paint(c.dim, `usage: /exec <${EXECUTORS.map((e) => e.label).join('|')}>`));
+            break;
+          }
+          rl.removeAllListeners('line');
+          rl.close();
+          executor = await select('executor', EXECUTORS, Math.max(0, EXECUTORS.findIndex((e) => e.value === executor)));
+          console.log(paint(c.dim, `executor -> ${executor || 'auto'}`));
+          startRepl();
+          return;
+        case 'verbose':
+          verbose = !verbose;
+          console.log(paint(c.dim, `verbose ${verbose ? 'on' : 'off'}`));
+          break;
+        case 'clear':
+          stdout.write('\x1b[2J\x1b[H');
+          break;
+        case 'help':
+          console.log(paint(c.dim, '/new  /exec [name]  /verbose  /clear  /help  /quit'));
+          break;
+        case 'quit':
+        case 'q':
+        case 'exit':
+          conn.close();
+          return;
+        default:
+          console.log(paint(c.dim, `unknown command /${cmd}`));
+      }
+      rl.prompt();
+      return;
+    }
+
+    conn.send(text);
+  });
+
+  rl.on('SIGINT', () => conn.close());
+}
+
+async function main() {
+  if (executor && !EXECUTOR_VALUES.has(executor)) {
+    console.error(`Unknown executor: ${executor}`);
+    process.exit(1);
+  }
+  printBanner();
+  if (!executor && !quick && stdin.isTTY) {
+    executor = await select('Launch executor', EXECUTORS, 0);
+  }
+  think.start();
+  conn = connect();
+}
+
+main().catch((err) => {
+  console.error(`aegis: ${err.message}`);
+  process.exit(1);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackbilt/aegis-core",
-  "version": "0.6.5",
+  "version": "0.8.0",
   "description": "Persistent AI agent framework for Cloudflare Workers. Multi-tier memory, autonomous goals, dreaming cycles, MCP native.",
   "license": "Apache-2.0",
   "publishConfig": {
@@ -14,6 +14,9 @@
   "type": "module",
   "main": "src/exports.ts",
   "types": "src/exports.ts",
+  "bin": {
+    "aegis": "./cli/aegis.mjs"
+  },
   "exports": {
     ".": "./src/exports.ts",
     "./core": "./src/core.ts",
@@ -24,6 +27,7 @@
     "./kernel/dispatch": "./src/kernel/dispatch.ts",
     "./kernel/router": "./src/kernel/router.ts",
     "./kernel/types": "./src/kernel/types.ts",
+    "./kernel/disambiguation": "./src/kernel/disambiguation.ts",
     "./kernel/memory": "./src/kernel/memory/index.ts",
     "./kernel/memory-adapter": "./src/kernel/memory-adapter.ts",
     "./kernel/resilience": "./src/kernel/resilience.ts",
@@ -50,6 +54,7 @@
     "./routes/health": "./src/routes/health.ts",
     "./routes/sessions": "./src/routes/sessions.ts",
     "./routes/messages": "./src/routes/messages.ts",
+    "./routes/chat-ws": "./src/routes/chat-ws.ts",
     "./routes/conversations": "./src/routes/conversations.ts",
     "./routes/feedback": "./src/routes/feedback.ts",
     "./routes/observability": "./src/routes/observability.ts",
@@ -57,6 +62,8 @@
     "./routes/pages": "./src/routes/pages.ts",
     "./routes/dynamic-tools": "./src/routes/dynamic-tools.ts",
     "./adapters/voice": "./src/adapters/voice/cloudflare-agent.ts",
+    "./durable-objects/chat-session": "./src/durable-objects/chat-session.ts",
+    "./durable-objects/chat-session-auth": "./src/durable-objects/chat-session-auth.ts",
     "./schema-enums": "./src/schema-enums.ts",
     "./contracts/goal": "./src/contracts/goal.contract.ts",
     "./contracts/agenda-item": "./src/contracts/agenda-item.contract.ts",
@@ -73,8 +80,9 @@
     "./kernel/patterns": "./src/kernel/patterns.ts"
   },
   "scripts": {
-    "dev": "wrangler dev",
-    "deploy": "wrangler deploy",
+    "dev": "npm run build:ui && wrangler dev",
+    "deploy": "npm run build:ui && wrangler deploy",
+    "build:ui": "vite build --config vite.ui.config.ts",
     "d1:create": "wrangler d1 create aegis-web",
     "d1:migrate": "wrangler d1 execute aegis-web --file=schema.sql",
     "d1:migrate:local": "wrangler d1 execute aegis-web --file=schema.sql --local",
@@ -89,17 +97,27 @@
     "@stackbilt/llm-providers": "^1.6.4",
     "agents": "^0.12.3",
     "hono": "^4.12.12",
+    "partysocket": "^1.1.19",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
     "zod": "^4.4.3"
   },
   "devDependencies": {
     "@cloudflare/workers-types": "^4.20241218.0",
+    "@types/react": "^19.2.16",
+    "@types/react-dom": "^19.2.3",
     "typescript": "^5.7.3",
     "vite": "^8.0.5",
     "vitest": "^4.0.18",
     "wrangler": "^4.76.0"
   },
   "files": [
+    "cli/**/*.mjs",
     "src/**/*.ts",
+    "src/**/*.tsx",
+    "src/ui/**/*.css",
+    "src/ui/**/*.html",
+    "public/**/*",
     "schema.sql"
   ],
   "keywords": [

package/public/assets/index-CQHn03rW.css

@@ -0,0 +1 @@
+:root{--lightningcss-light: ;--lightningcss-dark:initial;color-scheme:dark;color:#edf0ef;background:#101317;font-family:IBM Plex Sans,Aptos,Segoe UI,sans-serif;line-height:1.45}*{box-sizing:border-box}body{background-color:#101317;background-image:linear-gradient(90deg,#f6bd6014 1px,#0000 1px),linear-gradient(#76b38414 1px,#0000 1px),none;background-position:0 0,0 0,0 0;background-repeat:repeat,repeat,repeat;background-size:48px 48px;background-attachment:scroll,scroll,scroll;background-origin:padding-box,padding-box,padding-box;background-clip:border-box,border-box,border-box;min-width:320px;min-height:100vh;margin:0}button,input,textarea{font:inherit}button{color:#11130f;cursor:pointer;background:#e7b75f;border:1px solid #3a4440;border-radius:6px;font-weight:700}button:disabled{cursor:not-allowed;opacity:.45}input,textarea{color:#f2f4f1;background:#151a1d;border:1px solid #39413f;border-radius:6px;width:100%}input:focus,textarea:focus,button:focus-visible{outline-offset:2px;outline:2px solid #76b384}.shell{grid-template-columns:minmax(240px,320px) minmax(0,1fr) minmax(260px,340px);min-height:100vh;display:grid}.rail,.voice-panel{background:#0d1113f0;border-color:#28302d;flex-direction:column;gap:18px;padding:18px;display:flex}.rail{border-right:1px solid #28302d}.voice-panel{border-left:1px solid #28302d}.brand{align-items:center;gap:12px;min-height:64px;display:flex}.brand-mark{color:#76b384;border:1px solid #76b384;border-radius:6px;place-items:center;width:44px;height:44px;font-family:IBM Plex Mono,Cascadia Mono,monospace;font-size:1.4rem;font-weight:800;display:grid}.brand h1,.topbar h2{letter-spacing:0;margin:0}.brand p,.eyebrow,.runtime-status,.conversation small,.voice-state,label,dt{color:#9aa39d;font-size:.82rem}.token-panel,.health-panel,.conversation-panel{flex-direction:column;gap:10px;display:flex}.token-row,.panel-title,.voice-actions,.voice-text{align-items:center;gap:8px;display:flex}.token-row button,.panel-title button{width:42px;height:38px}.token-row input,.voice-text input{height:38px;padding:0 10px}.panel-title{text-transform:uppercase;letter-spacing:0;justify-content:space-between;min-height:38px;font-weight:800}.health-grid{grid-template-columns:repeat(2,minmax(0,1fr));gap:8px;margin:0;display:grid}.health-grid div{background:#151a1d;border:1px solid #2f3835;border-radius:6px;padding:10px}.health-grid dd{margin:4px 0 0;font-family:IBM Plex Mono,Cascadia Mono,monospace;font-weight:800}.new-chat{min-height:38px}.conversation-list{flex-direction:column;gap:6px;max-height:40vh;display:flex;overflow:auto}.conversation{text-align:left;color:#eef0ef;background:#151a1d;gap:4px;min-height:58px;padding:10px;display:grid}.conversation.active{border-color:#76b384}.workspace{grid-template-rows:auto minmax(0,1fr) auto;min-width:0;display:grid}.topbar{background:#101317c7;border-bottom:1px solid #28302d;justify-content:space-between;align-items:center;gap:24px;min-height:84px;padding:18px 22px;display:flex}.eyebrow{text-transform:uppercase;margin:0 0 4px;font-weight:800}.runtime-status{white-space:nowrap;align-items:center;gap:8px;display:flex}.dot{background:#8e403b;border-radius:50%;width:10px;height:10px}.dot.online{background:#76b384}.message-surface{flex-direction:column;gap:12px;padding:22px;display:flex;overflow:auto}.empty-state{color:#b8beb9;text-align:center;place-items:center;min-height:100%;display:grid}.message{background:#151a1deb;border:1px solid #2d3633;border-radius:6px;grid-template-columns:92px minmax(0,1fr);gap:12px;max-width:980px;padding:12px;display:grid}.message.user{border-color:#6f5d38}.message-role{color:#e7b75f;text-transform:uppercase;font-family:IBM Plex Mono,Cascadia Mono,monospace;font-size:.78rem;font-weight:800}.message-content{white-space:pre-wrap;overflow-wrap:anywhere}.composer{background:#0d1113f0;border-top:1px solid #28302d;grid-template-columns:minmax(0,1fr) 96px;gap:10px;padding:18px 22px;display:grid}.composer textarea{resize:vertical;min-height:72px;padding:10px}.composer button{min-height:72px}.meter{background:#151a1d;border:1px solid #39413f;border-radius:999px;height:12px;overflow:hidden}.meter span{background:#76b384;height:100%;display:block}.voice-actions button{flex:1;min-height:40px}.voice-transcript{gap:8px;min-height:180px;max-height:42vh;display:grid;overflow:auto}.voice-transcript p{background:#151a1d;border:1px solid #2f3835;border-radius:6px;gap:4px;margin:0;padding:10px;display:grid}.voice-transcript strong{color:#e7b75f;text-transform:uppercase;font-size:.76rem}.error{color:#f0a39d;margin:0}.voice-text button{width:70px;min-height:38px}@media (width<=1100px){.shell{grid-template-columns:minmax(220px,280px) minmax(0,1fr)}.voice-panel{border-top:1px solid #28302d;border-left:none;grid-column:1/-1}}@media (width<=760px){.shell{grid-template-columns:1fr}.rail,.voice-panel{border-inline:none}.topbar,.composer,.message{grid-template-columns:1fr}}