npm - @stackbilt/aegis-core - Versions diffs - 0.7.0 → 0.8.0 - Mend

@stackbilt/aegis-core 0.7.0 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (15) hide show

package/package.json +13 -3
package/public/assets/index-CQHn03rW.css +1 -0
package/public/assets/index-CTKpNJEr.js +74 -0
package/public/index.html +14 -0
package/src/agent-routing.ts +38 -0
package/src/assets.ts +6 -0
package/src/auth.ts +1 -0
package/src/index.ts +7 -1
package/src/routes/messages.ts +11 -6
package/src/routes/pages.ts +7 -0
package/src/types.ts +2 -0
package/src/ui/index.html +13 -0
package/src/ui/main.tsx +356 -0
package/src/ui/styles.css +391 -0
package/src/version.ts +1 -1

package/public/index.html ADDED Viewed

@@ -0,0 +1,14 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta name="theme-color" content="#101317" />
+    <title>AEGIS</title>
+    <script type="module" crossorigin src="/assets/index-CTKpNJEr.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-CQHn03rW.css">
+  </head>
+  <body>
+    <div id="root"></div>
+  </body>
+</html>

package/src/agent-routing.ts ADDED Viewed

@@ -0,0 +1,38 @@
+import { routeAgentRequest } from 'agents';
+import type { Env } from './types.js';
+export async function routeAegisAgentRequest(
+  request: Request,
+  env: Env,
+): Promise<Response | undefined> {
+  const { pathname } = new URL(request.url);
+  if (!pathname.startsWith('/agents/')) {
+    return undefined;
+  }
+  const token = extractBearer(request.headers.get('Authorization'))
+    ?? getCookie(request.headers.get('Cookie') ?? '', 'aegis_token')
+    ?? new URL(request.url).searchParams.get('token');
+  if (!token || token !== env.AEGIS_TOKEN) {
+    return new Response('Unauthorized', { status: 401 });
+  }
+  try {
+    const response = await routeAgentRequest(request, env);
+    return response ?? new Response('Agent route not found', { status: 404 });
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return new Response(`Agent route failed: ${message}`, { status: 503 });
+  }
+}
+function extractBearer(header: string | null): string | null {
+  if (!header?.startsWith('Bearer ')) return null;
+  return header.slice(7);
+}
+function getCookie(cookieHeader: string, name: string): string | null {
+  const match = cookieHeader.match(new RegExp(`(?:^|;\\s*)${name}=([^;]*)`));
+  return match?.[1] ?? null;
+}

package/src/assets.ts ADDED Viewed

@@ -0,0 +1,6 @@
+export async function serveSpaIndex(request: Request, assets: Fetcher): Promise<Response> {
+  const url = new URL(request.url);
+  url.pathname = '/index.html';
+  url.search = '';
+  return assets.fetch(new Request(url, request));
+}

package/src/auth.ts CHANGED Viewed

@@ -7,6 +7,7 @@ export async function bearerAuth(c: Context<{ Bindings: Env }>, next: Next): Pro
     c.req.path === '/health' ||
     c.req.path === '/pulse' ||
     ((c.req.path === '/' || c.req.path === '/chat' || c.req.path === '/manifest.json' || c.req.path === '/sw.js') && c.req.method === 'GET') ||
+    (c.req.method === 'GET' && (c.req.path.startsWith('/assets/') || c.req.path === '/favicon.svg')) ||
     c.req.path.startsWith('/tech') ||
     c.req.path === '/api/feedback' ||
     c.req.path === '/observe' ||

package/src/index.ts CHANGED Viewed

@@ -9,6 +9,7 @@
 import { Hono } from 'hono';
 import OAuthProvider from '@cloudflare/workers-oauth-provider';
 import { bearerAuth } from './auth.js';
+import { routeAegisAgentRequest } from './agent-routing.js';
 import { runScheduledTasks } from './kernel/scheduled/index.js';
 import type { Env } from './types.js';
 import { handleMcpRequest } from './mcp-server.js';
@@ -84,10 +85,15 @@ const oauthProvider = new OAuthProvider<Env>({
 });
 export default {
-  fetch: oauthProvider.fetch.bind(oauthProvider),
+  async fetch(request: Request, env: Env, ctx: ExecutionContext): Promise<Response> {
+    const agentResponse = await routeAegisAgentRequest(request, env);
+    if (agentResponse) return agentResponse;
+    return oauthProvider.fetch(request, env, ctx);
+  },
   async scheduled(_event: ScheduledEvent, env: Env, ctx: ExecutionContext): Promise<void> {
     ctx.waitUntil(runScheduledTasks(buildEdgeEnv(env)));
   },
 };
 export { ChatSession } from './durable-objects/chat-session.js';
+export { AegisVoiceAdapter } from './adapters/voice/cloudflare-agent.js';

package/src/routes/messages.ts CHANGED Viewed

@@ -3,6 +3,7 @@ import { bodyLimit } from 'hono/body-limit';
 import { createIntent, dispatch, dispatchStream } from '../kernel/dispatch.js';
 import { askGroq } from '../groq.js';
 import type { Env, MessageMetadata } from '../types.js';
+import type { Executor } from '../kernel/types.js';
 import { buildEdgeEnv } from '../edge-env.js';
 // 100 KB — generous for chat text, blocks payload abuse
@@ -47,7 +48,7 @@ async function generateConversationTitle(
 // ─── Send Message (edge-native kernel) ───────────────────────
 messages.post('/api/message', bodyLimit({ maxSize: MESSAGE_BODY_LIMIT }), async (c) => {
-  const body = await c.req.json<{ text: string; conversationId?: string }>();
+  const body = await c.req.json<{ text: string; conversationId?: string; executor?: Executor }>();
   if (!body.text?.trim()) {
     return c.json({ error: 'text is required' }, 400);
   }
@@ -80,7 +81,7 @@ messages.post('/api/message', bodyLimit({ maxSize: MESSAGE_BODY_LIMIT }), async
   ).bind(userMessageId, conversationId, 'user', text).run();
   // Fire-and-forget title generation for new conversations (#21)
-  if (isNewConversation && c.executionCtx) {
+  if (isNewConversation && c.executionCtx && c.env.GROQ_API_KEY) {
     c.executionCtx.waitUntil(
       generateConversationTitle(c.env.DB, conversationId, text, c.env.GROQ_API_KEY, c.env.GROQ_MODEL || 'llama-3.3-70b-versatile', groqBaseUrl(c.env)),
     );
@@ -88,7 +89,9 @@ messages.post('/api/message', bodyLimit({ maxSize: MESSAGE_BODY_LIMIT }), async
   // Dispatch through edge kernel
   const edgeEnv = buildEdgeEnv(c.env, c.executionCtx);
-  const intent = createIntent(conversationId, text);
+  const intent = createIntent(conversationId, text, {
+    forcedExecutor: body.executor,
+  });
   try {
     const result = await dispatch(intent, edgeEnv);
@@ -146,7 +149,7 @@ messages.post('/api/message', bodyLimit({ maxSize: MESSAGE_BODY_LIMIT }), async
 // ─── Streaming Message (SSE) ─────────────────────────────────
 messages.post('/api/message/stream', bodyLimit({ maxSize: MESSAGE_BODY_LIMIT }), async (c) => {
-  const body = await c.req.json<{ text: string; conversationId?: string }>();
+  const body = await c.req.json<{ text: string; conversationId?: string; executor?: Executor }>();
   if (!body.text?.trim()) {
     return c.json({ error: 'text is required' }, 400);
   }
@@ -169,14 +172,16 @@ messages.post('/api/message/stream', bodyLimit({ maxSize: MESSAGE_BODY_LIMIT }),
   await c.env.DB.prepare('INSERT INTO messages (id, conversation_id, role, content) VALUES (?, ?, ?, ?)').bind(userMessageId, conversationId, 'user', text).run();
   // Fire-and-forget title generation for new conversations (#21)
-  if (isNewConvStream && c.executionCtx) {
+  if (isNewConvStream && c.executionCtx && c.env.GROQ_API_KEY) {
     c.executionCtx.waitUntil(
       generateConversationTitle(c.env.DB, conversationId, text, c.env.GROQ_API_KEY, c.env.GROQ_MODEL || 'llama-3.3-70b-versatile', groqBaseUrl(c.env)),
     );
   }
   const edgeEnv = buildEdgeEnv(c.env, c.executionCtx);
-  const intent = createIntent(conversationId, text);
+  const intent = createIntent(conversationId, text, {
+    forcedExecutor: body.executor,
+  });
   const { readable, writable } = new TransformStream<Uint8Array, Uint8Array>();
   const writer = writable.getWriter();

package/src/routes/pages.ts CHANGED Viewed

@@ -3,6 +3,7 @@
 import { Hono } from 'hono';
 import { bodyLimit } from 'hono/body-limit';
 import type { Env } from '../types.js';
+import { serveSpaIndex } from '../assets.js';
 import { chatPage } from '../ui.js';
 import { landingPage } from '../landing.js';
 import { dashboardPage, getDashboardData } from '../dashboard.js';
@@ -15,6 +16,9 @@ const pages = new Hono<{ Bindings: Env }>();
 // ─── Landing ────────────────────────────────────────────────
 pages.get('/', (c) => {
+  if (c.env.ASSETS) {
+    return serveSpaIndex(c.req.raw, c.env.ASSETS);
+  }
   return c.html(chatPage());
 });
@@ -25,6 +29,9 @@ pages.get('/about', (c) => {
 // ─── Chat ───────────────────────────────────────────────────
 pages.get('/chat', (c) => {
+  if (c.env.ASSETS) {
+    return serveSpaIndex(c.req.raw, c.env.ASSETS);
+  }
   return c.html(chatPage());
 });

package/src/types.ts CHANGED Viewed

@@ -4,7 +4,9 @@ export interface Env {
   DB: D1Database;
   AI: Ai;
   AEGIS_TOKEN: string;
+  ASSETS?: Fetcher;
   CHAT_SESSION?: DurableObjectNamespace;
+  AegisVoiceAdapter?: DurableObjectNamespace;
   // OAuth 2.1 (injected by OAuthProvider wrapper at runtime)
   OAUTH_PROVIDER: OAuthHelpers;

package/src/ui/index.html ADDED Viewed

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta name="theme-color" content="#101317" />
+    <title>AEGIS</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/main.tsx"></script>
+  </body>
+</html>

package/src/ui/main.tsx ADDED Viewed

@@ -0,0 +1,356 @@
+import { useEffect, useMemo, useRef, useState } from 'react';
+import { createRoot } from 'react-dom/client';
+import { useVoiceAgent } from '@cloudflare/voice/react';
+import './styles.css';
+type Conversation = {
+  id: string;
+  title: string | null;
+  created_at?: string;
+  updated_at?: string;
+};
+type Message = {
+  id: string;
+  role: 'user' | 'assistant' | string;
+  content: string;
+  metadata?: Record<string, unknown> | null;
+};
+type HealthPayload = {
+  status: string;
+  version: string;
+  mode: string;
+  kernel?: Record<string, number>;
+  tasks_24h?: Array<{ task_name: string; runs: number; ok: number; errors: number }>;
+  docs_sync_status?: { status: string; lastSyncAge: number | null };
+};
+const TOKEN_KEY = 'aegis_token';
+function App() {
+  const [token, setToken] = useState(() => localStorage.getItem(TOKEN_KEY) ?? '');
+  const [tokenDraft, setTokenDraft] = useState(token);
+  const [conversations, setConversations] = useState<Conversation[]>([]);
+  const [conversationId, setConversationId] = useState<string | null>(null);
+  const [messages, setMessages] = useState<Message[]>([]);
+  const [prompt, setPrompt] = useState('');
+  const [status, setStatus] = useState('Ready');
+  const [health, setHealth] = useState<HealthPayload | null>(null);
+  const [voiceText, setVoiceText] = useState('');
+  const messagesRef = useRef<HTMLDivElement | null>(null);
+  const voice = useVoiceAgent({
+    agent: 'AegisVoiceAdapter',
+    name: 'operator',
+    query: token ? { token } : undefined,
+  });
+  const authHeaders = useMemo<Record<string, string>>(
+    () => {
+      const headers: Record<string, string> = {};
+      if (token) headers.Authorization = `Bearer ${token}`;
+      return headers;
+    },
+    [token],
+  );
+  useEffect(() => {
+    document.cookie = token
+      ? `aegis_token=${encodeURIComponent(token)};path=/;max-age=31536000;SameSite=Strict;Secure`
+      : 'aegis_token=;path=/;max-age=0;SameSite=Strict;Secure';
+  }, [token]);
+  useEffect(() => {
+    void refreshHealth();
+    if (token) void refreshConversations();
+  }, [token]);
+  useEffect(() => {
+    messagesRef.current?.scrollTo({ top: messagesRef.current.scrollHeight });
+  }, [messages]);
+  async function refreshHealth() {
+    const res = await fetch('/health?format=json', {
+      headers: { Accept: 'application/json' },
+    });
+    if (res.ok) {
+      setHealth(await res.json());
+    }
+  }
+  async function refreshConversations() {
+    const res = await fetch('/api/conversations', { headers: authHeaders });
+    if (!res.ok) {
+      setStatus(res.status === 401 ? 'Add your AEGIS token' : `Conversations failed: ${res.status}`);
+      return;
+    }
+    const data = await res.json() as { conversations: Conversation[] };
+    setConversations(data.conversations);
+  }
+  async function loadConversation(id: string) {
+    setConversationId(id);
+    const res = await fetch(`/api/conversations/${encodeURIComponent(id)}/messages`, {
+      headers: authHeaders,
+    });
+    if (!res.ok) {
+      setStatus(`History failed: ${res.status}`);
+      return;
+    }
+    const data = await res.json() as { messages: Message[] };
+    setMessages(data.messages);
+  }
+  function saveToken() {
+    const next = tokenDraft.trim();
+    localStorage.setItem(TOKEN_KEY, next);
+    setToken(next);
+    setStatus(next ? 'Token saved' : 'Token cleared');
+  }
+  async function sendMessage(text = prompt.trim()) {
+    if (!text) return;
+    if (!token) {
+      setStatus('Add your AEGIS token');
+      return;
+    }
+    const optimisticUser: Message = { id: crypto.randomUUID(), role: 'user', content: text };
+    const assistantId = crypto.randomUUID();
+    setMessages((current) => [
+      ...current,
+      optimisticUser,
+      { id: assistantId, role: 'assistant', content: '' },
+    ]);
+    setPrompt('');
+    setStatus('Streaming');
+    const res = await fetch('/api/message/stream', {
+      method: 'POST',
+      headers: {
+        ...authHeaders,
+        'Content-Type': 'application/json',
+      },
+      body: JSON.stringify({ text, conversationId, executor: 'workers_ai' }),
+    });
+    if (!res.ok || !res.body) {
+      setStatus(`Message failed: ${res.status}`);
+      return;
+    }
+    let assistantText = '';
+    for await (const frame of readSse(res.body)) {
+      if (frame.type === 'start' && typeof frame.conversationId === 'string') {
+        setConversationId(frame.conversationId);
+      }
+      if (frame.type === 'delta' && typeof frame.text === 'string') {
+        assistantText += frame.text;
+        setMessages((current) => current.map((message) => (
+          message.id === assistantId ? { ...message, content: assistantText } : message
+        )));
+      }
+      if (frame.type === 'error') {
+        setStatus(typeof frame.error === 'string' ? frame.error : 'Stream error');
+      }
+      if (frame.type === 'done') {
+        setStatus('Ready');
+        void refreshConversations();
+      }
+    }
+  }
+  function sendVoiceText() {
+    const text = voiceText.trim();
+    if (!text) return;
+    voice.sendText(text);
+    setVoiceText('');
+  }
+  const activeConversation = conversations.find((conversation) => conversation.id === conversationId);
+  const taskErrors = health?.tasks_24h?.reduce((sum, task) => sum + Number(task.errors ?? 0), 0) ?? 0;
+  return (
+    <main className="shell">
+      <aside className="rail" aria-label="AEGIS navigation">
+        <section className="brand">
+          <div className="brand-mark" aria-hidden="true">A</div>
+          <div>
+            <h1>AEGIS</h1>
+            <p>Edge-native operator console</p>
+          </div>
+        </section>
+        <section className="token-panel" aria-label="Access token">
+          <label htmlFor="token">Access token</label>
+          <div className="token-row">
+            <input
+              id="token"
+              type="password"
+              value={tokenDraft}
+              onChange={(event) => setTokenDraft(event.target.value)}
+              autoComplete="off"
+            />
+            <button type="button" onClick={saveToken} aria-label="Save token">OK</button>
+          </div>
+        </section>
+        <section className="health-panel" aria-label="Health dashboard">
+          <div className="panel-title">
+            <span>Health</span>
+            <button type="button" onClick={refreshHealth} aria-label="Refresh health">R</button>
+          </div>
+          <dl className="health-grid">
+            <div>
+              <dt>Status</dt>
+              <dd>{health?.status ?? 'unknown'}</dd>
+            </div>
+            <div>
+              <dt>Version</dt>
+              <dd>{health?.version ?? '-'}</dd>
+            </div>
+            <div>
+              <dt>Kernel</dt>
+              <dd>{health?.kernel ? Object.values(health.kernel).reduce((a, b) => a + b, 0) : '-'}</dd>
+            </div>
+            <div>
+              <dt>Task errors</dt>
+              <dd>{taskErrors}</dd>
+            </div>
+          </dl>
+        </section>
+        <section className="conversation-panel" aria-label="Conversations">
+          <div className="panel-title">
+            <span>Conversations</span>
+            <button type="button" onClick={refreshConversations} aria-label="Refresh conversations">R</button>
+          </div>
+          <button
+            type="button"
+            className="new-chat"
+            onClick={() => {
+              setConversationId(null);
+              setMessages([]);
+            }}
+          >
+            New session
+          </button>
+          <div className="conversation-list">
+            {conversations.map((conversation) => (
+              <button
+                type="button"
+                key={conversation.id}
+                className={conversation.id === conversationId ? 'conversation active' : 'conversation'}
+                onClick={() => loadConversation(conversation.id)}
+              >
+                <span>{conversation.title || 'Untitled'}</span>
+                <small>{conversation.updated_at ? new Date(conversation.updated_at).toLocaleString() : 'recent'}</small>
+              </button>
+            ))}
+          </div>
+        </section>
+      </aside>
+      <section className="workspace">
+        <header className="topbar">
+          <div>
+            <p className="eyebrow">Self-sufficient deploy</p>
+            <h2>{activeConversation?.title || 'Operator session'}</h2>
+          </div>
+          <div className="runtime-status" aria-live="polite">
+            <span className={token ? 'dot online' : 'dot'} aria-hidden="true" />
+            {status}
+          </div>
+        </header>
+        <section className="message-surface" ref={messagesRef} aria-label="Messages">
+          {messages.length === 0 ? (
+            <div className="empty-state">
+              <p>Ask the agent to inspect memory, explain its health, or plan the next deployment step.</p>
+            </div>
+          ) : messages.map((message) => (
+            <article key={message.id} className={`message ${message.role}`}>
+              <div className="message-role">{message.role}</div>
+              <div className="message-content">{message.content || '...'}</div>
+            </article>
+          ))}
+        </section>
+        <form
+          className="composer"
+          onSubmit={(event) => {
+            event.preventDefault();
+            void sendMessage();
+          }}
+        >
+          <textarea
+            value={prompt}
+            onChange={(event) => setPrompt(event.target.value)}
+            placeholder="Message AEGIS"
+            rows={3}
+          />
+          <button type="submit" aria-label="Send message">Send</button>
+        </form>
+      </section>
+      <aside className="voice-panel" aria-label="Voice call">
+        <div className="panel-title">
+          <span>Voice</span>
+          <span className="voice-state">{voice.status}</span>
+        </div>
+        <div className="meter" aria-label="Audio level">
+          <span style={{ width: `${Math.round(voice.audioLevel * 100)}%` }} />
+        </div>
+        <div className="voice-actions">
+          <button type="button" onClick={() => voice.connected ? voice.endCall() : void voice.startCall()}>
+            {voice.connected ? 'End call' : 'Start call'}
+          </button>
+          <button type="button" onClick={voice.toggleMute} disabled={!voice.connected}>
+            {voice.isMuted ? 'Unmute' : 'Mute'}
+          </button>
+        </div>
+        {voice.error ? <p className="error">{voice.error}</p> : null}
+        <div className="voice-transcript">
+          {voice.transcript.slice(-8).map((entry, index) => (
+            <p key={`${entry.role}-${index}`}>
+              <strong>{entry.role}</strong>
+              <span>{entry.text}</span>
+            </p>
+          ))}
+          {voice.interimTranscript ? <p><strong>interim</strong><span>{voice.interimTranscript}</span></p> : null}
+        </div>
+        <div className="voice-text">
+          <input
+            value={voiceText}
+            onChange={(event) => setVoiceText(event.target.value)}
+            placeholder="Send text to voice agent"
+          />
+          <button type="button" onClick={sendVoiceText} disabled={!voice.connected}>Send</button>
+        </div>
+      </aside>
+    </main>
+  );
+}
+async function* readSse(body: ReadableStream<Uint8Array>): AsyncGenerator<Record<string, unknown>> {
+  const reader = body.getReader();
+  const decoder = new TextDecoder();
+  let buffer = '';
+  while (true) {
+    const { value, done } = await reader.read();
+    if (done) break;
+    buffer += decoder.decode(value, { stream: true });
+    const frames = buffer.split('\n\n');
+    buffer = frames.pop() ?? '';
+    for (const frame of frames) {
+      const dataLine = frame.split('\n').find((line) => line.startsWith('data: '));
+      if (!dataLine) continue;
+      yield JSON.parse(dataLine.slice(6));
+    }
+  }
+}
+createRoot(document.getElementById('root') as HTMLElement).render(<App />);