zora-agent 0.9.0

package/dist/dashboard/server.js

@@ -0,0 +1,254 @@
+/**
+ * DashboardServer — Local API and static file server for the Zora UI.
+ *
+ * Spec §6.0 "Web Dashboard Spec":
+ *   - Binds to localhost:7070 by default.
+ *   - Serves as the primary ingress for async steering.
+ */
+import express from 'express';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+export class DashboardServer {
+    _app;
+    _options;
+    _server;
+    _sseClients = new Set();
+    constructor(options) {
+        this._options = options;
+        this._app = express();
+        // R22: Explicit body size limits
+        this._app.use(express.json({ limit: '1mb' }));
+        // R21: Rate limiting — 100 requests per 15 minutes per IP
+        this._app.use(this._createRateLimiter());
+        // Serve static frontend files (Vite build output)
+        const staticPath = path.join(__dirname, 'frontend', 'dist');
+        this._app.use(express.static(staticPath));
+        this._setupRoutes();
+    }
+    /**
+     * Simple in-memory rate limiter (no external dependency).
+     * Limits to 100 requests per 15 minutes per IP.
+     * Prunes expired entries periodically to prevent unbounded memory growth.
+     */
+    _createRateLimiter() {
+        const windowMs = 15 * 60 * 1000;
+        const maxRequests = 100;
+        const clients = new Map();
+        let lastCleanup = Date.now();
+        return (req, res, next) => {
+            const ip = req.ip ?? req.socket.remoteAddress ?? 'unknown';
+            const now = Date.now();
+            // Prune expired entries every 5 minutes
+            if (now - lastCleanup > 5 * 60 * 1000) {
+                for (const [key, rec] of clients) {
+                    if (rec.resetAt <= now)
+                        clients.delete(key);
+                }
+                lastCleanup = now;
+            }
+            const record = clients.get(ip);
+            if (!record || now > record.resetAt) {
+                clients.set(ip, { count: 1, resetAt: now + windowMs });
+                next();
+                return;
+            }
+            record.count++;
+            if (record.count > maxRequests) {
+                res.status(429).json({ ok: false, error: 'Too many requests. Try again later.' });
+                return;
+            }
+            next();
+        };
+    }
+    _setupRoutes() {
+        const { steeringManager, authMonitor, sessionManager } = this._options;
+        // --- System APIs ---
+        /** GET /api/health — Provider and auth status */
+        this._app.get('/api/health', async (_req, res) => {
+            try {
+                const authStatus = await authMonitor.checkAll();
+                res.json({
+                    ok: true,
+                    providers: Array.from(authStatus.entries()).map(([name, status]) => ({
+                        name,
+                        ...status
+                    }))
+                });
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                res.status(500).json({ ok: false, error: message });
+            }
+        });
+        /** GET /api/quota — Provider quota, usage, and cost snapshots */
+        this._app.get('/api/quota', async (_req, res) => {
+            const providers = this._options.providers ?? [];
+            try {
+                const authStatus = await authMonitor.checkAll();
+                const snapshots = await Promise.all(providers.map(async (p) => ({
+                    name: p.name,
+                    auth: authStatus.get(p.name) ?? { valid: false, expiresAt: null, canAutoRefresh: false, requiresInteraction: true },
+                    quota: await p.getQuotaStatus(),
+                    usage: p.getUsage(),
+                    costTier: p.costTier,
+                })));
+                res.json({ ok: true, providers: snapshots });
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                res.status(500).json({ ok: false, error: message });
+            }
+        });
+        /** GET /api/jobs — R14: List active and historical jobs via SessionManager */
+        this._app.get('/api/jobs', async (_req, res) => {
+            try {
+                const sessions = await sessionManager.listSessions();
+                res.json({
+                    jobs: sessions.map(s => ({
+                        jobId: s.jobId,
+                        eventCount: s.eventCount,
+                        lastActivity: s.lastActivity?.toISOString() ?? null,
+                        status: s.status,
+                    })),
+                });
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                res.status(500).json({ ok: false, error: message });
+            }
+        });
+        /** GET /api/system — Real process metrics for dashboard System Info panel */
+        this._app.get('/api/system', (_req, res) => {
+            const mem = process.memoryUsage();
+            res.json({
+                uptime: Math.floor(process.uptime()),
+                memory: {
+                    used: Math.round(mem.heapUsed / (1024 * 1024)),
+                    total: Math.round(mem.heapTotal / (1024 * 1024)),
+                },
+            });
+        });
+        // --- Task Submission ---
+        /** POST /api/task — Submit a new task to the orchestrator */
+        this._app.post('/api/task', async (req, res) => {
+            const { prompt } = req.body;
+            if (typeof prompt !== 'string' || !prompt.trim()) {
+                return res.status(400).json({ ok: false, error: 'prompt must be a non-empty string' });
+            }
+            const { submitTask } = this._options;
+            if (!submitTask) {
+                return res.status(503).json({ ok: false, error: 'Task submission not available' });
+            }
+            try {
+                const jobId = await submitTask(prompt.trim());
+                // Note: job_started event is now emitted by the orchestrator via onEvent callback
+                res.json({ ok: true, jobId });
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                res.status(500).json({ ok: false, error: message });
+            }
+        });
+        // --- Steering APIs ---
+        /** POST /api/steer — Inject a steering message */
+        this._app.post('/api/steer', async (req, res) => {
+            const { jobId, message, author, source } = req.body;
+            if (typeof jobId !== 'string' || !jobId.trim() || typeof message !== 'string' || !message.trim()) {
+                return res.status(400).json({ ok: false, error: 'jobId and message must be non-empty strings' });
+            }
+            try {
+                await steeringManager.injectMessage({
+                    type: 'steer',
+                    jobId,
+                    message,
+                    author: author ?? 'web-user',
+                    source: source ?? 'dashboard',
+                    timestamp: new Date()
+                });
+                res.json({ ok: true });
+            }
+            catch (err) {
+                const errorMessage = err instanceof Error ? err.message : String(err);
+                res.status(500).json({ ok: false, error: errorMessage });
+            }
+        });
+        // --- R17: SSE endpoint for real-time job updates ---
+        /** GET /api/events — Server-Sent Events stream for live job status */
+        this._app.get('/api/events', (req, res) => {
+            res.writeHead(200, {
+                'Content-Type': 'text/event-stream',
+                'Cache-Control': 'no-cache',
+                'Connection': 'keep-alive',
+                'X-Accel-Buffering': 'no',
+            });
+            res.write('data: {"type":"connected"}\n\n');
+            this._sseClients.add(res);
+            // Keep-alive comment every 30s to prevent proxy/firewall timeouts
+            const keepAlive = setInterval(() => {
+                res.write(': keepalive\n\n');
+            }, 30_000);
+            req.on('close', () => {
+                clearInterval(keepAlive);
+                this._sseClients.delete(res);
+            });
+        });
+        // Catch-all: serve index.html for SPA routing
+        this._app.get('*', (_req, res) => {
+            res.sendFile(path.join(__dirname, 'frontend', 'dist', 'index.html'));
+        });
+    }
+    /**
+     * Broadcast an event to all connected SSE clients.
+     */
+    broadcastEvent(event) {
+        const payload = `data: ${JSON.stringify(event)}\n\n`;
+        for (const client of this._sseClients) {
+            try {
+                client.write(payload);
+            }
+            catch {
+                // Client disconnected — remove and clean up
+                this._sseClients.delete(client);
+                try {
+                    client.end();
+                }
+                catch { /* already closed */ }
+            }
+        }
+    }
+    /**
+     * Starts the dashboard server on localhost.
+     */
+    async start() {
+        const port = this._options.port ?? 7070;
+        const host = this._options.host ?? '127.0.0.1';
+        return new Promise((resolve) => {
+            this._server = this._app.listen(port, host, () => {
+                console.log(`[Dashboard] Zora Tactical Interface active at http://${host}:${port}`);
+                resolve();
+            });
+        });
+    }
+    /**
+     * Stops the dashboard server.
+     */
+    async stop() {
+        // Close all SSE connections
+        for (const client of this._sseClients) {
+            client.end();
+        }
+        this._sseClients.clear();
+        if (this._server) {
+            await new Promise((resolve, reject) => {
+                this._server.close((err) => {
+                    if (err)
+                        reject(err);
+                    else
+                        resolve();
+                });
+            });
+        }
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/dashboard/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/dashboard/server.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AASzC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAiB/D,MAAM,OAAO,eAAe;IACT,IAAI,CAAsB;IAC1B,QAAQ,CAAmB;IACpC,OAAO,CAAqB;IACnB,WAAW,GAAyB,IAAI,GAAG,EAAE,CAAC;IAE/D,YAAY,OAAyB;QACnC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,OAAO,EAAE,CAAC;QAEtB,iCAAiC;QACjC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAE9C,0DAA0D;QAC1D,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC,CAAC;QAEzC,kDAAkD;QAClD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;QAE1C,IAAI,CAAC,YAAY,EAAE,CAAC;IACtB,CAAC;IAED;;;;OAIG;IACK,kBAAkB;QACxB,MAAM,QAAQ,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QAChC,MAAM,WAAW,GAAG,GAAG,CAAC;QACxB,MAAM,OAAO,GAAG,IAAI,GAAG,EAA8C,CAAC;QACtE,IAAI,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;YACxB,MAAM,EAAE,GAAG,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,aAAa,IAAI,SAAS,CAAC;YAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAEvB,wCAAwC;YACxC,IAAI,GAAG,GAAG,WAAW,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;gBACtC,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,OAAO,EAAE,CAAC;oBACjC,IAAI,GAAG,CAAC,OAAO,IAAI,GAAG;wBAAE,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC9C,CAAC;gBACD,WAAW,GAAG,GAAG,CAAC;YACpB,CAAC;YAED,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAE/B,IAAI,CAAC,MAAM,IAAI,GAAG,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,GAAG,QAAQ,EAAE,CAAC,CAAC;gBACvD,IAAI,EAAE,CAAC;gBACP,OAAO;YACT,CAAC;YAED,MAAM,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,MAAM,CAAC,KAAK,GAAG,WAAW,EAAE,CAAC;gBAC/B,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,qCAAqC,EAAE,CAAC,CAAC;gBAClF,OAAO;YACT,CAAC;YAED,IAAI,EAAE,CAAC;QACT,CAAC,CAAC;IACJ,CAAC;IAEO,YAAY;QAClB,MAAM,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC;QAEvE,sBAAsB;QAEtB,iDAAiD;QACjD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;YAC/C,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE,CAAC;gBAChD,GAAG,CAAC,IAAI,CAAC;oBACP,EAAE,EAAE,IAAI;oBACR,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;wBACnE,IAAI;wBACJ,GAAG,MAAM;qBACV,CAAC,CAAC;iBACJ,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACjE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;YACtD,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,iEAAiE;QACjE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;YAC9C,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,IAAI,EAAE,CAAC;YAChD,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE,CAAC;gBAChD,MAAM,SAAS,GAA4B,MAAM,OAAO,CAAC,GAAG,CAC1D,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;oBAC1B,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,IAAI,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,mBAAmB,EAAE,IAAI,EAAE;oBACnH,KAAK,EAAE,MAAM,CAAC,CAAC,cAAc,EAAE;oBAC/B,KAAK,EAAE,CAAC,CAAC,QAAQ,EAAE;oBACnB,QAAQ,EAAE,CAAC,CAAC,QAAQ;iBACrB,CAAC,CAAC,CACJ,CAAC;gBACF,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC;YAC/C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACjE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;YACtD,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,8EAA8E;QAC9E,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;YAC7C,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,YAAY,EAAE,CAAC;gBACrD,GAAG,CAAC,IAAI,CAAC;oBACP,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;wBACvB,KAAK,EAAE,CAAC,CAAC,KAAK;wBACd,UAAU,EAAE,CAAC,CAAC,UAAU;wBACxB,YAAY,EAAE,CAAC,CAAC,YAAY,EAAE,WAAW,EAAE,IAAI,IAAI;wBACnD,MAAM,EAAE,CAAC,CAAC,MAAM;qBACjB,CAAC,CAAC;iBACJ,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACjE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;YACtD,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,6EAA6E;QAC7E,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;YACzC,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;YAClC,GAAG,CAAC,IAAI,CAAC;gBACP,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;gBACpC,MAAM,EAAE;oBACN,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;oBAC9C,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;iBACjD;aACF,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,0BAA0B;QAE1B,6DAA6D;QAC7D,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;YAC7C,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC;YAE5B,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;gBACjD,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,mCAAmC,EAAE,CAAC,CAAC;YACzF,CAAC;YAED,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC;YACrC,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,+BAA+B,EAAE,CAAC,CAAC;YACrF,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC9C,kFAAkF;gBAClF,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YAChC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACjE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;YACtD,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,wBAAwB;QAExB,kDAAkD;QAClD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;YAC9C,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC;YAEpD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;gBACjG,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,6CAA6C,EAAE,CAAC,CAAC;YACnG,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,eAAe,CAAC,aAAa,CAAC;oBAClC,IAAI,EAAE,OAAO;oBACb,KAAK;oBACL,OAAO;oBACP,MAAM,EAAE,MAAM,IAAI,UAAU;oBAC5B,MAAM,EAAE,MAAM,IAAI,WAAW;oBAC7B,SAAS,EAAE,IAAI,IAAI,EAAE;iBACtB,CAAC,CAAC;gBACH,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;YACzB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,YAAY,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACtE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,sDAAsD;QAEtD,sEAAsE;QACtE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;YACxC,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE;gBACjB,cAAc,EAAE,mBAAmB;gBACnC,eAAe,EAAE,UAAU;gBAC3B,YAAY,EAAE,YAAY;gBAC1B,mBAAmB,EAAE,IAAI;aAC1B,CAAC,CAAC;YAEH,GAAG,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;YAC5C,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAE1B,kEAAkE;YAClE,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE;gBACjC,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;YAC/B,CAAC,EAAE,MAAM,CAAC,CAAC;YAEX,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;gBACnB,aAAa,CAAC,SAAS,CAAC,CAAC;gBACzB,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC/B,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,8CAA8C;QAC9C,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;YAC/B,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;QACvE,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,KAAsC;QACnD,MAAM,OAAO,GAAG,SAAS,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC;QACrD,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACtC,IAAI,CAAC;gBACH,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACxB,CAAC;YAAC,MAAM,CAAC;gBACP,4CAA4C;gBAC5C,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAChC,IAAI,CAAC;oBAAC,MAAM,CAAC,GAAG,EAAE,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,oBAAoB,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC;QACxC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,WAAW,CAAC;QAC/C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE;gBAC/C,OAAO,CAAC,GAAG,CAAC,wDAAwD,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC;gBACpF,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,4BAA4B;QAC5B,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACtC,MAAM,CAAC,GAAG,EAAE,CAAC;QACf,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;QAEzB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBAC1C,IAAI,CAAC,OAAQ,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;oBAC1B,IAAI,GAAG;wBAAE,MAAM,CAAC,GAAG,CAAC,CAAC;;wBAChB,OAAO,EAAE,CAAC;gBACjB,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Zora — Long-running autonomous personal AI agent for macOS
+ *
+ * Entry point. This module initializes the agent daemon.
+ * Implementation in Tier 1, Item 7 (execution loop).
+ */
+export { type ZoraConfig, type ZoraPolicy, type LLMProvider } from './types.js';
+export * from './providers/index.js';
+export * from './config/index.js';
+export * from './security/policy-engine.js';
+export * from './tools/index.js';
+export * from './orchestrator/index.js';
+export * from './utils/fs.js';
+export * from './steering/index.js';
+export * from './routines/index.js';
+export * from './memory/index.js';
+export * from './teams/index.js';
+export * from './dashboard/auth-middleware.js';
+export * from './wasm/wasmtime-spike.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAChF,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0BAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,19 @@
+/**
+ * Zora — Long-running autonomous personal AI agent for macOS
+ *
+ * Entry point. This module initializes the agent daemon.
+ * Implementation in Tier 1, Item 7 (execution loop).
+ */
+export * from './providers/index.js';
+export * from './config/index.js';
+export * from './security/policy-engine.js';
+export * from './tools/index.js';
+export * from './orchestrator/index.js';
+export * from './utils/fs.js';
+export * from './steering/index.js';
+export * from './routines/index.js';
+export * from './memory/index.js';
+export * from './teams/index.js';
+export * from './dashboard/auth-middleware.js';
+export * from './wasm/wasmtime-spike.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0BAA0B,CAAC"}

package/dist/memory/category-organizer.d.ts

@@ -0,0 +1,33 @@
+/**
+ * CategoryOrganizer — Auto-categorization and dual-mode retrieval.
+ *
+ * Spec SS5.4 "Category Auto-Organization":
+ * Assigns categories to memory items, maintains category summaries,
+ * and provides dual-mode retrieval (summaries + top-N items).
+ */
+import type { MemoryItem, CategorySummary, SalienceScore } from './memory-types.js';
+import type { StructuredMemory } from './structured-memory.js';
+import type { SalienceScorer } from './salience-scorer.js';
+export declare class CategoryOrganizer {
+    private readonly _categoriesDir;
+    private readonly _summarizeFn;
+    constructor(categoriesDir: string, summarizeFn: (items: MemoryItem[]) => Promise<string>);
+    init(): Promise<void>;
+    assignCategory(item: MemoryItem): string;
+    getCategorySummary(category: string): Promise<CategorySummary | null>;
+    updateCategorySummary(category: string, items: MemoryItem[]): Promise<void>;
+    listCategories(): Promise<CategorySummary[]>;
+    getItemsByCategory(category: string, structuredMemory: StructuredMemory): Promise<MemoryItem[]>;
+    /**
+     * Dual-mode retrieval: category summaries (fast overview) + top-N items (deep detail).
+     */
+    getDualModeContext(query: string, structuredMemory: StructuredMemory, scorer: SalienceScorer, maxCategories: number, maxItems: number): Promise<{
+        summaries: CategorySummary[];
+        topItems: SalienceScore[];
+    }>;
+    private _categorySlug;
+    private _categoryPath;
+    private _walkDir;
+    private _categorySummaryRelevance;
+}
+//# sourceMappingURL=category-organizer.d.ts.map

package/dist/memory/category-organizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"category-organizer.d.ts","sourceRoot":"","sources":["../../src/memory/category-organizer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACpF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAY3D,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA2C;gBAGtE,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC;IAMjD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM;IAgBlC,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAarE,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAe3E,cAAc,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAM5C,kBAAkB,CACtB,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,gBAAgB,GACjC,OAAO,CAAC,UAAU,EAAE,CAAC;IAIxB;;OAEG;IACG,kBAAkB,CACtB,KAAK,EAAE,MAAM,EACb,gBAAgB,EAAE,gBAAgB,EAClC,MAAM,EAAE,cAAc,EACtB,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;QAAE,SAAS,EAAE,eAAe,EAAE,CAAC;QAAC,QAAQ,EAAE,aAAa,EAAE,CAAA;KAAE,CAAC;IAqBvE,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,aAAa;YAIP,QAAQ;IAoBtB,OAAO,CAAC,yBAAyB;CAWlC"}

package/dist/memory/category-organizer.js

@@ -0,0 +1,137 @@
+/**
+ * CategoryOrganizer — Auto-categorization and dual-mode retrieval.
+ *
+ * Spec SS5.4 "Category Auto-Organization":
+ * Assigns categories to memory items, maintains category summaries,
+ * and provides dual-mode retrieval (summaries + top-N items).
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { writeAtomic } from '../utils/fs.js';
+/** Maps item type to a default category prefix. */
+const TYPE_PREFIX_MAP = {
+    tool: 'coding',
+    skill: 'coding',
+    profile: 'personal',
+    behavior: 'personal',
+    event: 'events',
+    knowledge: 'knowledge',
+};
+export class CategoryOrganizer {
+    _categoriesDir;
+    _summarizeFn;
+    constructor(categoriesDir, summarizeFn) {
+        this._categoriesDir = categoriesDir;
+        this._summarizeFn = summarizeFn;
+    }
+    async init() {
+        await fs.mkdir(this._categoriesDir, { recursive: true, mode: 0o700 });
+    }
+    assignCategory(item) {
+        // If item already has a meaningful category, keep it
+        if (item.category && item.category.includes('/')) {
+            return item.category;
+        }
+        const prefix = TYPE_PREFIX_MAP[item.type] ?? 'general';
+        // Derive a suffix from the first tag, or use 'general'
+        const suffix = item.tags.length > 0
+            ? item.tags[0].toLowerCase().replace(/\s+/g, '-')
+            : 'general';
+        return `${prefix}/${suffix}`;
+    }
+    async getCategorySummary(category) {
+        const filePath = this._categoryPath(category);
+        try {
+            const data = await fs.readFile(filePath, 'utf8');
+            return JSON.parse(data);
+        }
+        catch (err) {
+            if (err.code === 'ENOENT') {
+                return null;
+            }
+            throw err;
+        }
+    }
+    async updateCategorySummary(category, items) {
+        const summary = await this._summarizeFn(items);
+        const categorySummary = {
+            category,
+            summary,
+            item_count: items.length,
+            last_updated: new Date().toISOString(),
+            member_item_ids: items.map(i => i.id),
+        };
+        const filePath = this._categoryPath(category);
+        await fs.mkdir(path.dirname(filePath), { recursive: true, mode: 0o700 });
+        await writeAtomic(filePath, JSON.stringify(categorySummary, null, 2));
+    }
+    async listCategories() {
+        const summaries = [];
+        await this._walkDir(this._categoriesDir, summaries);
+        return summaries;
+    }
+    async getItemsByCategory(category, structuredMemory) {
+        return structuredMemory.listItems({ category });
+    }
+    /**
+     * Dual-mode retrieval: category summaries (fast overview) + top-N items (deep detail).
+     */
+    async getDualModeContext(query, structuredMemory, scorer, maxCategories, maxItems) {
+        // Get category summaries
+        const allSummaries = await this.listCategories();
+        const scoredSummaries = allSummaries
+            .map(s => ({
+            summary: s,
+            score: this._categorySummaryRelevance(query, s),
+        }))
+            .sort((a, b) => b.score - a.score)
+            .slice(0, maxCategories)
+            .map(s => s.summary);
+        // Get top-N individual items ranked by salience
+        const allItems = await structuredMemory.listItems();
+        const topItems = scorer.rankItems(allItems, query, maxItems);
+        return { summaries: scoredSummaries, topItems };
+    }
+    // ── Private helpers ──────────────────────────────────────────────
+    _categorySlug(category) {
+        return category.replace(/\//g, '--');
+    }
+    _categoryPath(category) {
+        return path.join(this._categoriesDir, `${this._categorySlug(category)}.json`);
+    }
+    async _walkDir(dir, results) {
+        let entries;
+        try {
+            entries = await fs.readdir(dir);
+        }
+        catch (err) {
+            if (err.code === 'ENOENT')
+                return;
+            throw err;
+        }
+        for (const entry of entries) {
+            if (!entry.endsWith('.json'))
+                continue;
+            try {
+                const data = await fs.readFile(path.join(dir, entry), 'utf8');
+                results.push(JSON.parse(data));
+            }
+            catch {
+                // Skip corrupt files
+            }
+        }
+    }
+    _categorySummaryRelevance(query, summary) {
+        const queryWords = query.toLowerCase().split(/\W+/).filter(w => w.length > 0);
+        if (queryWords.length === 0)
+            return 0;
+        const text = `${summary.category} ${summary.summary}`.toLowerCase();
+        let matches = 0;
+        for (const w of queryWords) {
+            if (text.includes(w))
+                matches++;
+        }
+        return matches / queryWords.length;
+    }
+}
+//# sourceMappingURL=category-organizer.js.map

package/dist/memory/category-organizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"category-organizer.js","sourceRoot":"","sources":["../../src/memory/category-organizer.ts"],"names":[],"mappings":"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"}

package/dist/memory/extraction-pipeline.d.ts

@@ -0,0 +1,22 @@
+/**
+ * ExtractionPipeline — Schema-guided memory extraction.
+ *
+ * Spec SS5.4 "Proactive Memory Extraction Pipeline":
+ * Extracts structured MemoryItems from conversation messages,
+ * validates against the schema, and deduplicates against existing items.
+ */
+import type { MemoryItem, ExtractionResult } from './memory-types.js';
+export declare class ExtractionPipeline {
+    private readonly _extractFn;
+    constructor(extractFn: (prompt: string) => Promise<string>);
+    extract(messages: string[], existingCategories: string[]): Promise<ExtractionResult>;
+    validateItem(item: unknown): {
+        valid: boolean;
+        errors: string[];
+    };
+    deduplicateItems(newItems: MemoryItem[], existingItems: MemoryItem[]): MemoryItem[];
+    private _buildPrompt;
+    private _wordSet;
+    private _jaccardSimilarity;
+}
+//# sourceMappingURL=extraction-pipeline.d.ts.map

package/dist/memory/extraction-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extraction-pipeline.d.ts","sourceRoot":"","sources":["../../src/memory/extraction-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAA8B,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAOlG,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsC;gBAErD,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC;IAIpD,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,kBAAkB,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA8D1F,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IAuCjE,gBAAgB,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,aAAa,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE;IAYnF,OAAO,CAAC,YAAY;IAqCpB,OAAO,CAAC,QAAQ;IAMhB,OAAO,CAAC,kBAAkB;CAS3B"}