@agentdeck/bridge 0.1.0 → 0.2.1

package/dist/apme/http.js

@@ -0,0 +1,210 @@
+/**
+ * APME HTTP routes — mounted by the daemon's raw createServer handler.
+ *
+ * Routes:
+ *   GET  /apme/runs?limit=&agent=&model=   — recent runs with their evals
+ *   GET  /apme/run/:id                     — single run detail (steps + evals)
+ *   GET  /apme/scorecard                   — model scorecard (v_model_scorecard)
+ *   POST /apme/vibe                        — { runId, verdict, note? }
+ *   GET  /apme/rubric/current              — current rubric row
+ *   POST /apme/recommend                   — { taskKind?, budgetUsd?, ... }
+ *
+ * Returns `true` if the request matched an APME route and was handled;
+ * `false` otherwise so the caller can continue its fallback routing.
+ */
+import { loadApmeConfig } from './settings.js';
+import { apmeDashboardHtml } from './dashboard-html.js';
+import { EVAL_SCHEMA_VERSION } from '@agentdeck/shared';
+export async function handleApmeRequest(req, res, apme) {
+    const url = new URL(req.url ?? '/', `http://${req.headers.host ?? 'localhost'}`);
+    if (!url.pathname.startsWith('/apme'))
+        return false;
+    if (!apme) {
+        sendJson(res, 503, { error: 'APME not initialized (better-sqlite3 missing)' });
+        return true;
+    }
+    const method = req.method ?? 'GET';
+    const path = url.pathname;
+    try {
+        // ── Dashboard HTML ─────────────────────────────────────────────────────
+        if (method === 'GET' && (path === '/apme' || path === '/apme/')) {
+            res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8', 'Cache-Control': 'no-store' });
+            res.end(apmeDashboardHtml());
+            return true;
+        }
+        // ── Runs ────────────────────────────────────────────────────────────────
+        if (method === 'GET' && path === '/apme/runs') {
+            const limit = clampInt(url.searchParams.get('limit'), 1, 500, 50);
+            const agentType = url.searchParams.get('agent') ?? undefined;
+            const modelId = url.searchParams.get('model') ?? undefined;
+            const runs = apme.store.listRuns({ limit, agentType, modelId });
+            const withEvals = runs.map((r) => {
+                const evals = apme.store.listEvalsForRun(r.id);
+                const vibe = apme.store.latestVibeForRun(r.id);
+                return {
+                    ...r,
+                    evals: evals.map((e) => ({
+                        layer: e.layer,
+                        metric: e.metric,
+                        score: e.score,
+                        rubricVer: e.rubricVer ?? null,
+                        judgeModel: e.judgeModel ?? null,
+                        createdAt: e.createdAt,
+                    })),
+                    overallScore: aggregateOverall(evals),
+                    vibe: vibe ? { verdict: vibe.verdict } : null,
+                };
+            });
+            sendJson(res, 200, { schema: EVAL_SCHEMA_VERSION, runs: withEvals });
+            return true;
+        }
+        if (method === 'GET' && path.startsWith('/apme/run/')) {
+            const id = path.slice('/apme/run/'.length);
+            const run = apme.store.getRun(id);
+            if (!run) {
+                sendJson(res, 404, { error: 'run not found' });
+                return true;
+            }
+            const evals = apme.store.listEvalsForRun(id);
+            const steps = apme.store.listSteps(id);
+            const rawTurns = apme.store.listTurns(id);
+            const vibe = apme.store.latestVibeForRun(id);
+            // Include per-turn evals for mid-session scoring
+            const turns = rawTurns.map(t => ({
+                ...t,
+                turnEvals: apme.store.listEvalsForTurn(t.id),
+            }));
+            sendJson(res, 200, {
+                schema: EVAL_SCHEMA_VERSION,
+                run,
+                evals,
+                steps,
+                turns,
+                vibe,
+                overallScore: aggregateOverall(evals),
+            });
+            return true;
+        }
+        // ── Scorecard ───────────────────────────────────────────────────────────
+        if (method === 'GET' && path === '/apme/scorecard') {
+            sendJson(res, 200, { schema: EVAL_SCHEMA_VERSION, scorecards: apme.store.scorecard() });
+            return true;
+        }
+        if (method === 'GET' && path === '/apme/categories') {
+            sendJson(res, 200, { schema: EVAL_SCHEMA_VERSION, categories: apme.store.categoryScorecard() });
+            return true;
+        }
+        // ── Rubric ──────────────────────────────────────────────────────────────
+        if (method === 'GET' && path === '/apme/rubric/current') {
+            const rubric = apme.store.getCurrentRubric('general');
+            if (!rubric) {
+                sendJson(res, 404, { error: 'no rubric seeded' });
+                return true;
+            }
+            sendJson(res, 200, { schema: EVAL_SCHEMA_VERSION, rubric });
+            return true;
+        }
+        // ── Vibe feedback ───────────────────────────────────────────────────────
+        if (method === 'POST' && path === '/apme/vibe') {
+            const body = await readJsonBody(req);
+            if (!body || typeof body.runId !== 'string' || typeof body.verdict !== 'string') {
+                sendJson(res, 400, { error: 'expected { runId, verdict, note? }' });
+                return true;
+            }
+            if (!['approve', 'reject', 'neutral'].includes(body.verdict)) {
+                sendJson(res, 400, { error: 'verdict must be approve|reject|neutral' });
+                return true;
+            }
+            const run = apme.store.getRun(body.runId);
+            if (!run) {
+                sendJson(res, 404, { error: 'run not found' });
+                return true;
+            }
+            apme.store.insertVibe({
+                runId: body.runId,
+                verdict: body.verdict,
+                note: typeof body.note === 'string' ? body.note : null,
+                ts: Date.now(),
+            });
+            sendJson(res, 200, { ok: true });
+            return true;
+        }
+        // ── Recommendation ──────────────────────────────────────────────────────
+        if (method === 'POST' && path === '/apme/recommend') {
+            const body = await readJsonBody(req);
+            const input = body && typeof body === 'object' ? body : {};
+            const cfg = loadApmeConfig();
+            const candidates = apme.recommender.recommend({
+                taskKind: typeof input.taskKind === 'string' ? input.taskKind : undefined,
+                budgetUsd: typeof input.budgetUsd === 'number' ? input.budgetUsd : undefined,
+                latencyBudgetMs: typeof input.latencyBudgetMs === 'number' ? input.latencyBudgetMs : undefined,
+                preferLocal: typeof input.preferLocal === 'boolean' ? input.preferLocal : undefined,
+                availableModels: cfg.availableModels.length > 0 ? cfg.availableModels : undefined,
+            });
+            sendJson(res, 200, { candidates });
+            return true;
+        }
+        // ── Rubric tune trigger (manual) ────────────────────────────────────────
+        if (method === 'POST' && path === '/apme/tune') {
+            const outcome = await apme.tuner.tune();
+            sendJson(res, 200, outcome);
+            return true;
+        }
+        // Unknown /apme/* path
+        sendJson(res, 404, { error: 'unknown apme endpoint' });
+        return true;
+    }
+    catch (err) {
+        sendJson(res, 500, { error: String(err) });
+        return true;
+    }
+}
+// ─── helpers ───────────────────────────────────────────────────────────────────
+function sendJson(res, status, body) {
+    res.writeHead(status, {
+        'Content-Type': 'application/json',
+        'Cache-Control': 'no-store',
+        'Access-Control-Allow-Origin': '*',
+    });
+    res.end(JSON.stringify(body));
+}
+async function readJsonBody(req) {
+    return new Promise((resolve) => {
+        const chunks = [];
+        let total = 0;
+        req.on('data', (c) => {
+            chunks.push(c);
+            total += c.length;
+            if (total > 1_000_000)
+                req.destroy(); // 1 MB cap
+        });
+        req.on('end', () => {
+            try {
+                const text = Buffer.concat(chunks).toString('utf-8');
+                resolve(text ? JSON.parse(text) : null);
+            }
+            catch {
+                resolve(null);
+            }
+        });
+        req.on('error', () => resolve(null));
+    });
+}
+function clampInt(s, min, max, dflt) {
+    if (!s)
+        return dflt;
+    const n = parseInt(s, 10);
+    if (!isFinite(n))
+        return dflt;
+    return Math.max(min, Math.min(max, n));
+}
+export function aggregateOverall(evals) {
+    const overall = evals.find((e) => e.layer === 'llm_judge' && e.metric === 'overall');
+    if (overall)
+        return overall.score;
+    const det = evals.filter((e) => e.layer === 'deterministic');
+    if (det.length === 0)
+        return null;
+    return det.reduce((sum, e) => sum + e.score, 0) / det.length;
+}
+//# sourceMappingURL=http.js.map

package/dist/apme/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/apme/http.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,GAAoB,EACpB,GAAmB,EACnB,IAAuB;IAEvB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,EAAE,UAAU,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,WAAW,EAAE,CAAC,CAAC;IACjF,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAEpD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,+CAA+C,EAAE,CAAC,CAAC;QAC/E,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,KAAK,CAAC;IACnC,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC;IAE1B,IAAI,CAAC;QACH,0EAA0E;QAC1E,IAAI,MAAM,KAAK,KAAK,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,QAAQ,CAAC,EAAE,CAAC;YAChE,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,0BAA0B,EAAE,eAAe,EAAE,UAAU,EAAE,CAAC,CAAC;YAChG,GAAG,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC,CAAC;YAC7B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,2EAA2E;QAC3E,IAAI,MAAM,KAAK,KAAK,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC;YAC9C,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;YAClE,MAAM,SAAS,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,SAAS,CAAC;YAC7D,MAAM,OAAO,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,SAAS,CAAC;YAC3D,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;YAChE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC/C,OAAO;oBACL,GAAG,CAAC;oBACJ,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;wBACvB,KAAK,EAAE,CAAC,CAAC,KAAK;wBACd,MAAM,EAAE,CAAC,CAAC,MAAM;wBAChB,KAAK,EAAE,CAAC,CAAC,KAAK;wBACd,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,IAAI;wBAC9B,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,IAAI;wBAChC,SAAS,EAAE,CAAC,CAAC,SAAS;qBACvB,CAAC,CAAC;oBACH,YAAY,EAAE,gBAAgB,CAAC,KAAK,CAAC;oBACrC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI;iBAC9C,CAAC;YACJ,CAAC,CAAC,CAAC;YACH,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,mBAAmB,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;YACrE,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,MAAM,KAAK,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YACtD,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAClC,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC,CAAC;gBAC/C,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;YAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;YAC7C,iDAAiD;YACjD,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC/B,GAAG,CAAC;gBACJ,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAY,CAAC;aACvD,CAAC,CAAC,CAAC;YACJ,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE;gBACjB,MAAM,EAAE,mBAAmB;gBAC3B,GAAG;gBACH,KAAK;gBACL,KAAK;gBACL,KAAK;gBACL,IAAI;gBACJ,YAAY,EAAE,gBAAgB,CAAC,KAAK,CAAC;aACtC,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;QAED,2EAA2E;QAC3E,IAAI,MAAM,KAAK,KAAK,IAAI,IAAI,KAAK,iBAAiB,EAAE,CAAC;YACnD,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,mBAAmB,EAAE,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;YACxF,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,MAAM,KAAK,KAAK,IAAI,IAAI,KAAK,kBAAkB,EAAE,CAAC;YACpD,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,mBAAmB,EAAE,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;YAChG,OAAO,IAAI,CAAC;QACd,CAAC;QAED,2EAA2E;QAC3E,IAAI,MAAM,KAAK,KAAK,IAAI,IAAI,KAAK,sBAAsB,EAAE,CAAC;YACxD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;YACtD,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC,CAAC;gBAClD,OAAO,IAAI,CAAC;YACd,CAAC;YACD,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,EAAE,CAAC,CAAC;YAC5D,OAAO,IAAI,CAAC;QACd,CAAC;QAED,2EAA2E;QAC3E,IAAI,MAAM,KAAK,MAAM,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC;YAC/C,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,GAAG,CAAC,CAAC;YACrC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAChF,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,oCAAoC,EAAE,CAAC,CAAC;gBACpE,OAAO,IAAI,CAAC;YACd,CAAC;YACD,IAAI,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC7D,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,wCAAwC,EAAE,CAAC,CAAC;gBACxE,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1C,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC,CAAC;gBAC/C,OAAO,IAAI,CAAC;YACd,CAAC;YACD,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;gBACpB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,OAAO,EAAE,IAAI,CAAC,OAA2C;gBACzD,IAAI,EAAE,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;gBACtD,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;aACf,CAAC,CAAC;YACH,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;YACjC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,2EAA2E;QAC3E,IAAI,MAAM,KAAK,MAAM,IAAI,IAAI,KAAK,iBAAiB,EAAE,CAAC;YACpD,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,GAAG,CAAC,CAAC;YACrC,MAAM,KAAK,GAAG,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3D,MAAM,GAAG,GAAG,cAAc,EAAE,CAAC;YAC7B,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC;gBAC5C,QAAQ,EAAE,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;gBACzE,SAAS,EAAE,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;gBAC5E,eAAe,EAAE,OAAO,KAAK,CAAC,eAAe,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS;gBAC9F,WAAW,EAAE,OAAO,KAAK,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;gBACnF,eAAe,EAAE,GAAG,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS;aAClF,CAAC,CAAC;YACH,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;YACnC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,2EAA2E;QAC3E,IAAI,MAAM,KAAK,MAAM,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC;YAC/C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YACxC,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;YAC5B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,uBAAuB;QACvB,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC3C,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,kFAAkF;AAElF,SAAS,QAAQ,CAAC,GAAmB,EAAE,MAAc,EAAE,IAAa;IAClE,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE;QACpB,cAAc,EAAE,kBAAkB;QAClC,eAAe,EAAE,UAAU;QAC3B,6BAA6B,EAAE,GAAG;KACnC,CAAC,CAAC;IACH,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;AAChC,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,GAAoB;IAC9C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE;YAC3B,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACf,KAAK,IAAI,CAAC,CAAC,MAAM,CAAC;YAClB,IAAI,KAAK,GAAG,SAAS;gBAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,WAAW;QACnD,CAAC,CAAC,CAAC;QACH,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;YACjB,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBACrD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC1C,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,CAAC,IAAI,CAAC,CAAC;YAChB,CAAC;QACH,CAAC,CAAC,CAAC;QACH,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,QAAQ,CAAC,CAAgB,EAAE,GAAW,EAAE,GAAW,EAAE,IAAY;IACxE,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC1B,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9B,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAyD;IACxF,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,WAAW,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;IACrF,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC,KAAK,CAAC;IAClC,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,eAAe,CAAC,CAAC;IAC7D,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAClC,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC;AAC/D,CAAC"}

package/dist/apme/hw-sampler.d.ts

@@ -0,0 +1,30 @@
+/**
+ * APME Hardware Sampler.
+ *
+ * Samples the machine's approximate resource state so the recommender can
+ * factor in "is the Mac Studio free enough to run a local MLX judge right
+ * now?" when ranking candidates.
+ *
+ * macOS-only for v1 — uses `sysctl`, `vm_stat`, and `sw_vers`. Anything that
+ * needs elevated privileges (powermetrics, IOReport) is deliberately avoided.
+ * On other platforms we return a minimal snapshot and callers fall back to
+ * neutral behavior.
+ */
+export interface HwSnapshot {
+    platform: NodeJS.Platform;
+    /** Total physical RAM in bytes, if available. */
+    memTotal?: number;
+    /** Resident RAM in use (active+wired+compressed) in bytes, if available. */
+    memUsed?: number;
+    /** Normalized CPU load (0..1) — 1-minute average divided by logical CPU count. */
+    cpuLoad?: number;
+    /** Logical CPU count. */
+    cpuCount?: number;
+    /** Hardware model, e.g. "Mac14,14" (Mac Studio M2 Max). */
+    model?: string;
+    timestamp: number;
+}
+export declare class ApmeHwSampler {
+    snapshot(): Promise<HwSnapshot>;
+}
+//# sourceMappingURL=hw-sampler.d.ts.map

package/dist/apme/hw-sampler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hw-sampler.d.ts","sourceRoot":"","sources":["../../src/apme/hw-sampler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC1B,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAuED,qBAAa,aAAa;IAClB,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC;CAiBtC"}

package/dist/apme/hw-sampler.js

@@ -0,0 +1,106 @@
+/**
+ * APME Hardware Sampler.
+ *
+ * Samples the machine's approximate resource state so the recommender can
+ * factor in "is the Mac Studio free enough to run a local MLX judge right
+ * now?" when ranking candidates.
+ *
+ * macOS-only for v1 — uses `sysctl`, `vm_stat`, and `sw_vers`. Anything that
+ * needs elevated privileges (powermetrics, IOReport) is deliberately avoided.
+ * On other platforms we return a minimal snapshot and callers fall back to
+ * neutral behavior.
+ */
+import { execFileSync } from 'child_process';
+import { debug } from '../logger.js';
+function safeSysctl(key) {
+    try {
+        return execFileSync('sysctl', ['-n', key], {
+            encoding: 'utf-8', timeout: 1000, stdio: ['ignore', 'pipe', 'ignore'],
+        }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+function readMacMemory() {
+    const total = safeSysctl('hw.memsize');
+    let memTotal;
+    if (total) {
+        const n = Number(total);
+        if (isFinite(n) && n > 0)
+            memTotal = n;
+    }
+    let memUsed;
+    try {
+        const out = execFileSync('vm_stat', [], {
+            encoding: 'utf-8', timeout: 1000, stdio: ['ignore', 'pipe', 'ignore'],
+        });
+        // vm_stat prints "page size of N bytes" on the first line, then
+        // "Pages active:   N." style lines.
+        const pageSizeMatch = out.match(/page size of (\d+) bytes/);
+        const pageSize = pageSizeMatch ? parseInt(pageSizeMatch[1], 10) : 4096;
+        const pickPages = (label) => {
+            const re = new RegExp(`${label}:\\s+(\\d+)\\.?`);
+            const m = out.match(re);
+            return m ? parseInt(m[1], 10) : 0;
+        };
+        const active = pickPages('Pages active');
+        const wired = pickPages('Pages wired down');
+        const compressed = pickPages('Pages occupied by compressor');
+        memUsed = (active + wired + compressed) * pageSize;
+    }
+    catch {
+        /* ignore */
+    }
+    return { total: memTotal, used: memUsed };
+}
+function readMacCpu() {
+    const count = safeSysctl('hw.logicalcpu');
+    let cpuCount;
+    if (count) {
+        const n = Number(count);
+        if (isFinite(n) && n > 0)
+            cpuCount = n;
+    }
+    let cpuLoad;
+    try {
+        // `uptime` prints "... load averages: 1.23 1.45 1.67"
+        const out = execFileSync('uptime', [], {
+            encoding: 'utf-8', timeout: 1000, stdio: ['ignore', 'pipe', 'ignore'],
+        });
+        const m = out.match(/load averages?:\s+([0-9.]+)/);
+        if (m && cpuCount) {
+            const load1 = parseFloat(m[1]);
+            if (isFinite(load1) && load1 >= 0) {
+                cpuLoad = Math.min(1, load1 / cpuCount);
+            }
+        }
+    }
+    catch {
+        /* ignore */
+    }
+    return { load: cpuLoad, count: cpuCount };
+}
+export class ApmeHwSampler {
+    async snapshot() {
+        const snap = { platform: process.platform, timestamp: Date.now() };
+        if (process.platform !== 'darwin')
+            return snap;
+        try {
+            const mem = readMacMemory();
+            const cpu = readMacCpu();
+            snap.memTotal = mem.total;
+            snap.memUsed = mem.used;
+            snap.cpuLoad = cpu.load;
+            snap.cpuCount = cpu.count;
+            const model = safeSysctl('hw.model');
+            if (model)
+                snap.model = model;
+        }
+        catch (err) {
+            debug('APME', `hw-sampler failed: ${String(err)}`);
+        }
+        return snap;
+    }
+}
+//# sourceMappingURL=hw-sampler.js.map

package/dist/apme/hw-sampler.js.map

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

package/dist/apme/index.d.ts

@@ -0,0 +1,43 @@
+/**
+ * APME module — public surface for the bridge/daemon.
+ *
+ * Usage:
+ *   const apme = await initApme();  // may return null if disabled
+ *   apme?.collector.openRun({...});
+ *   apme?.collector.ingestHook(sessionId, 'PreToolUse', data);
+ *   apme?.collector.closeRun(sessionId, exitCode);
+ *
+ * The module is intentionally boot-safe: if better-sqlite3 can't load, all
+ * methods still exist but are no-ops, and `initApme()` returns null.
+ */
+import { ApmeStore } from './store.js';
+import { ApmeCollector } from './collector.js';
+import { ApmeRunner } from './runner.js';
+import { ApmeTuner } from './tuner.js';
+import { ApmeHwSampler } from './hw-sampler.js';
+import { ApmeRecommender } from './recommend.js';
+export interface ApmeModule {
+    store: ApmeStore;
+    collector: ApmeCollector;
+    runner: ApmeRunner;
+    tuner: ApmeTuner;
+    hwSampler: ApmeHwSampler;
+    recommender: ApmeRecommender;
+}
+/** Initialize the APME subsystem. Returns null if the SQLite store can't open. */
+export declare function initApme(dbPath?: string): Promise<ApmeModule | null>;
+export declare function getApme(): ApmeModule | null;
+export { loadApmeConfig, shouldJudge, DEFAULT_APME_CONFIG } from './settings.js';
+export type { ApmeConfig, ApmeJudgeConfig, ApmeJudgeBackend } from './settings.js';
+export { ApmeStore } from './store.js';
+export { ApmeCollector } from './collector.js';
+export { ApmeRunner } from './runner.js';
+export { ApmeTuner } from './tuner.js';
+export { ApmeHwSampler } from './hw-sampler.js';
+export { ApmeRecommender } from './recommend.js';
+export { classifyRun, classifyRunSmart, classifyWithLlm, classify, computeSignals, TASK_CATEGORIES } from './classifier.js';
+export { evaluateOutcome, detectOutcome, computeEfficiency, computeComposite } from './outcome.js';
+export type { Outcome, OutcomeResult, EfficiencyMetrics, CompositeBreakdown } from './outcome.js';
+export type { TaskSignals, TaskCategory } from './classifier.js';
+export type * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/apme/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/apme/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,SAAS,CAAC;IACjB,SAAS,EAAE,aAAa,CAAC;IACzB,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,SAAS,CAAC;IACjB,SAAS,EAAE,aAAa,CAAC;IACzB,WAAW,EAAE,eAAe,CAAC;CAC9B;AAID,kFAAkF;AAClF,wBAAsB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAsC1E;AAED,wBAAgB,OAAO,IAAI,UAAU,GAAG,IAAI,CAE3C;AAED,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACjF,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACnF,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,eAAe,EAAE,QAAQ,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC5H,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACnG,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClG,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACjE,mBAAmB,YAAY,CAAC"}

package/dist/apme/index.js

@@ -0,0 +1,75 @@
+/**
+ * APME module — public surface for the bridge/daemon.
+ *
+ * Usage:
+ *   const apme = await initApme();  // may return null if disabled
+ *   apme?.collector.openRun({...});
+ *   apme?.collector.ingestHook(sessionId, 'PreToolUse', data);
+ *   apme?.collector.closeRun(sessionId, exitCode);
+ *
+ * The module is intentionally boot-safe: if better-sqlite3 can't load, all
+ * methods still exist but are no-ops, and `initApme()` returns null.
+ */
+import { writeFileSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import { debug } from '../logger.js';
+import { ApmeStore } from './store.js';
+import { apmeDashboardHtml } from './dashboard-html.js';
+import { ApmeCollector } from './collector.js';
+import { ApmeRunner } from './runner.js';
+import { ApmeTuner } from './tuner.js';
+import { ApmeHwSampler } from './hw-sampler.js';
+import { ApmeRecommender } from './recommend.js';
+let singleton = null;
+/** Initialize the APME subsystem. Returns null if the SQLite store can't open. */
+export async function initApme(dbPath) {
+    if (singleton)
+        return singleton;
+    const store = new ApmeStore(dbPath);
+    const ok = await store.init();
+    if (!ok) {
+        debug('APME', 'initApme skipped (store disabled)');
+        return null;
+    }
+    const hwSampler = new ApmeHwSampler();
+    const collector = new ApmeCollector(store, hwSampler);
+    const runner = new ApmeRunner(store);
+    const tuner = new ApmeTuner(store);
+    const recommender = new ApmeRecommender(store);
+    singleton = { store, collector, runner, tuner, hwSampler, recommender };
+    // Wire task-level judge: whenever the collector closes a task (TodoWrite
+    // all-completed / /clear / session_end), enqueue a task_rollup judge call.
+    // Kept here — not in the collector constructor — so the collector has no
+    // hard dependency on the runner.
+    collector.onTaskClosed = ({ taskId, runId, boundarySignal, taskCategory }) => {
+        runner.enqueueTask({
+            runId,
+            taskId,
+            category: taskCategory ?? undefined,
+            boundarySignal,
+        });
+    };
+    // Write dashboard HTML for Swift daemon to pick up.
+    try {
+        const dataDir = process.env.AGENTDECK_DATA_DIR || join(homedir(), '.agentdeck');
+        writeFileSync(join(dataDir, 'apme-dashboard.html'), apmeDashboardHtml(), 'utf-8');
+    }
+    catch { /* best-effort */ }
+    // Auto-enqueue eval on run close: collectors call `closeRun()` and we
+    // forward the returned runId here when wired into the bridge.
+    return singleton;
+}
+export function getApme() {
+    return singleton;
+}
+export { loadApmeConfig, shouldJudge, DEFAULT_APME_CONFIG } from './settings.js';
+export { ApmeStore } from './store.js';
+export { ApmeCollector } from './collector.js';
+export { ApmeRunner } from './runner.js';
+export { ApmeTuner } from './tuner.js';
+export { ApmeHwSampler } from './hw-sampler.js';
+export { ApmeRecommender } from './recommend.js';
+export { classifyRun, classifyRunSmart, classifyWithLlm, classify, computeSignals, TASK_CATEGORIES } from './classifier.js';
+export { evaluateOutcome, detectOutcome, computeEfficiency, computeComposite } from './outcome.js';
+//# sourceMappingURL=index.js.map

package/dist/apme/index.js.map

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

package/dist/apme/outcome.d.ts

@@ -0,0 +1,48 @@
+/**
+ * APME Outcome Detector + Efficiency Calculator + Composite Scorer.
+ *
+ * Determines what the user DID with the agent's output (committed, abandoned,
+ * iterated, A/B tested) rather than relying on noisy explicit feedback.
+ * Computes efficiency metrics from run metadata. Calculates a weighted
+ * composite score from outcome + judge + efficiency + vibe.
+ */
+import type { ApmeStore } from './store.js';
+import type { ApmeRunRow } from './types.js';
+export type Outcome = 'committed' | 'abandoned' | 'iterated' | 'ab_winner' | 'ab_loser' | 'interrupted' | 'exploratory' | 'pending';
+export type Confidence = 'high' | 'medium' | 'low';
+export interface OutcomeResult {
+    outcome: Outcome;
+    confidence: Confidence;
+    reason: string;
+}
+export interface EfficiencyMetrics {
+    tokensPerChange: number | null;
+    costPerChange: number | null;
+    timeToCompleteSec: number | null;
+    toolEfficiency: number | null;
+    diffLines: number | null;
+}
+export interface CompositeBreakdown {
+    outcomeScore: number;
+    outcomeWeight: number;
+    judgeScore: number | null;
+    judgeWeight: number;
+    efficiencyScore: number | null;
+    efficiencyWeight: number;
+    vibeScore: number | null;
+    vibeWeight: number;
+    composite: number;
+}
+export declare function detectOutcome(store: ApmeStore, run: ApmeRunRow): OutcomeResult;
+export declare function computeEfficiency(run: ApmeRunRow): EfficiencyMetrics;
+export declare function computeComposite(store: ApmeStore, run: ApmeRunRow, outcomeResult: OutcomeResult, efficiency: EfficiencyMetrics): CompositeBreakdown;
+/** Run outcome detection + efficiency + composite scoring on a single run. */
+export declare function evaluateOutcome(store: ApmeStore, runId: string): {
+    outcome: OutcomeResult;
+    efficiency: EfficiencyMetrics;
+    composite: CompositeBreakdown;
+} | null;
+/** Lightweight composite re-computation — called after judge evals are inserted
+ *  so the judge contribution is reflected without re-detecting outcome/efficiency. */
+export declare function recomputeComposite(store: ApmeStore, runId: string): void;
+//# sourceMappingURL=outcome.d.ts.map

package/dist/apme/outcome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outcome.d.ts","sourceRoot":"","sources":["../../src/apme/outcome.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAI7C,MAAM,MAAM,OAAO,GACf,WAAW,GACX,WAAW,GACX,UAAU,GACV,WAAW,GACX,UAAU,GACV,aAAa,GACb,aAAa,GACb,SAAS,CAAC;AAEd,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEnD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB;AAID,MAAM,WAAW,iBAAiB;IAChC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAID,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAkBD,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,GAAG,aAAa,CAiF9E;AAID,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,UAAU,GAAG,iBAAiB,CAqBpE;AAuBD,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,UAAU,EACf,aAAa,EAAE,aAAa,EAC5B,UAAU,EAAE,iBAAiB,GAC5B,kBAAkB,CAsDpB;AAID,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG;IAChE,OAAO,EAAE,aAAa,CAAC;IACvB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,SAAS,EAAE,kBAAkB,CAAC;CAC/B,GAAG,IAAI,CAkBP;AAED;sFACsF;AACtF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAYxE"}