nodedex 0.1.0

package/dist/routes/__tests__/models-catalog.test.js

@@ -0,0 +1,130 @@
+// GET /api/models — the slimming mapper for the web-UI model picker.
+// Fixtures are the REAL OpenRouter /api/v1/models shape (verified live 2026-06-16).
+// Run: node --import=tsx/esm --test src/routes/__tests__/models-catalog.test.ts
+import { test, describe, beforeEach, afterEach } from "node:test";
+import assert from "node:assert/strict";
+import { slimOpenRouterModel, buildPassRouting, safeParseModelCaps } from "../admin.js";
+describe("slimOpenRouterModel", () => {
+    test("output ceiling comes from top_provider.max_completion_tokens, NOT context_length", () => {
+        // Real gpt-4o entry shape.
+        const m = slimOpenRouterModel({
+            id: "openai/gpt-4o",
+            name: "OpenAI: GPT-4o",
+            context_length: 128000,
+            top_provider: { context_length: 128000, max_completion_tokens: 16384, is_moderated: false },
+            pricing: { prompt: "0.0000025", completion: "0.00001" },
+            supported_parameters: ["tools", "response_format", "structured_outputs"],
+            architecture: { modality: "text+image+file->text" },
+        });
+        assert.equal(m.max_completion_tokens, 16384, "output cap = top_provider.max_completion_tokens");
+        assert.equal(m.context_length, 128000, "context window kept as its own (larger) number");
+        assert.notEqual(m.max_completion_tokens, m.context_length, "cap must NOT be the context window");
+        assert.equal(m.supports_structured, true);
+        assert.equal(m.supports_tools, true);
+        assert.deepEqual(m.pricing, { prompt: "0.0000025", completion: "0.00001" });
+        assert.equal(m.modality, "text+image+file->text");
+    });
+    test("big-cap model (gemini-2.5-flash 65535) maps through", () => {
+        const m = slimOpenRouterModel({
+            id: "google/gemini-2.5-flash", name: "Google: Gemini 2.5 Flash",
+            context_length: 1048576,
+            top_provider: { context_length: 1048576, max_completion_tokens: 65535 },
+            pricing: { prompt: "0.0000003", completion: "0.0000025" },
+            supported_parameters: ["structured_outputs", "tools"],
+        });
+        assert.equal(m.max_completion_tokens, 65535);
+        assert.equal(m.context_length, 1048576);
+    });
+    test("null max_completion_tokens when top_provider omits it (caller falls back to default cap)", () => {
+        const m = slimOpenRouterModel({ id: "x/y", name: "Y", context_length: 8000, top_provider: {} });
+        assert.equal(m.max_completion_tokens, null, "null → modelOutputCeiling() default applies downstream");
+        assert.equal(m.context_length, 8000);
+    });
+    test("supports_structured is false when supported_parameters lacks the keys", () => {
+        const m = slimOpenRouterModel({ id: "a/b", supported_parameters: ["temperature", "top_p"] });
+        assert.equal(m.supports_structured, false);
+        assert.equal(m.supports_tools, false);
+    });
+    test("missing/garbage fields degrade to safe defaults (no throw)", () => {
+        const m = slimOpenRouterModel({});
+        assert.equal(m.id, "");
+        assert.equal(m.max_completion_tokens, null);
+        assert.equal(m.context_length, null);
+        assert.equal(m.pricing, null);
+        assert.equal(m.supports_structured, false);
+        assert.equal(m.modality, null);
+    });
+});
+describe("safeParseModelCaps", () => {
+    test("valid JSON object → parsed", () => {
+        assert.deepEqual(safeParseModelCaps('{"openai/gpt-4o":16384}'), { "openai/gpt-4o": 16384 });
+    });
+    test("undefined / malformed / array → {}", () => {
+        assert.deepEqual(safeParseModelCaps(undefined), {});
+        assert.deepEqual(safeParseModelCaps("not json"), {});
+        assert.deepEqual(safeParseModelCaps("[1,2,3]"), {}, "an array is not a model→cap map");
+    });
+});
+describe("buildPassRouting — per-pass model routing + smartness hint", () => {
+    const KEYS = [
+        "AI_MODEL", "NODEDEX_PRIMARY_MODEL", "NODEDEX_REASONING_MODEL", "NODEDEX_STRUCTURAL_MODEL",
+        "NODEDEX_COMPREHEND_MODEL", "NODEDEX_JUDGE_MODEL", "NODEDEX_PASS2B_MODEL",
+        "NODEDEX_PASS3_MODEL", "NODEDEX_PASS4_MODEL", "NODEDEX_PASS5_MODEL",
+    ];
+    let saved;
+    beforeEach(() => { saved = {}; for (const k of KEYS) {
+        saved[k] = process.env[k];
+        delete process.env[k];
+    } });
+    afterEach(() => { for (const k of KEYS) {
+        if (saved[k] === undefined)
+            delete process.env[k];
+        else
+            process.env[k] = saved[k];
+    } });
+    const stage = (r, name) => r.stages.find((s) => s.stage === name);
+    test("no overrides → every stage resolves to the default model", () => {
+        process.env.AI_MODEL = "google/gemini-2.5-flash";
+        const r = buildPassRouting();
+        assert.equal(r.default_model, "google/gemini-2.5-flash");
+        for (const s of r.stages)
+            assert.equal(s.effective, "google/gemini-2.5-flash", `${s.stage} → default`);
+    });
+    test("per-stage override wins over tier and default", () => {
+        process.env.AI_MODEL = "default-model";
+        process.env.NODEDEX_REASONING_MODEL = "smart-model";
+        process.env.NODEDEX_PASS3_MODEL = "build-special";
+        const r = buildPassRouting();
+        assert.equal(stage(r, "build").effective, "build-special", "override wins");
+        assert.equal(stage(r, "build").override, "build-special");
+    });
+    test("REASONING tier applies to smart stages (selector/build/connect), not to comprehend", () => {
+        process.env.AI_MODEL = "default-model";
+        process.env.NODEDEX_REASONING_MODEL = "smart-model";
+        const r = buildPassRouting();
+        assert.equal(stage(r, "selector").effective, "smart-model", "judge → reasoning tier");
+        assert.equal(stage(r, "build").effective, "smart-model", "pass3 → reasoning tier");
+        assert.equal(stage(r, "connect").effective, "smart-model", "pass4 → reasoning tier");
+        assert.equal(stage(r, "comprehend").effective, "default-model", "comprehend has no tier — falls to default");
+    });
+    test("STRUCTURAL tier applies to the mechanical fill stage", () => {
+        process.env.AI_MODEL = "default-model";
+        process.env.NODEDEX_STRUCTURAL_MODEL = "cheap-model";
+        assert.equal(stage(buildPassRouting(), "fill").effective, "cheap-model");
+    });
+    test("comprehend reads its OWN env knob (the workhorse)", () => {
+        process.env.AI_MODEL = "default-model";
+        process.env.NODEDEX_COMPREHEND_MODEL = "comprehend-special";
+        const s = stage(buildPassRouting(), "comprehend");
+        assert.equal(s.effective, "comprehend-special");
+        assert.equal(s.tier, "smart");
+    });
+    test("tier hint matches the stage tier", () => {
+        process.env.AI_MODEL = "m";
+        const r = buildPassRouting();
+        assert.equal(stage(r, "comprehend").hint, "wants a strong model");
+        assert.equal(stage(r, "fill").hint, "a cheap model is fine");
+        assert.equal(stage(r, "chain").hint, "moderate");
+    });
+});
+//# sourceMappingURL=models-catalog.test.js.map

package/dist/routes/__tests__/models-catalog.test.js.map

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

package/dist/routes/__tests__/reflect-pause-drain.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=reflect-pause-drain.test.d.ts.map

package/dist/routes/__tests__/reflect-pause-drain.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflect-pause-drain.test.d.ts","sourceRoot":"","sources":["../../../src/routes/__tests__/reflect-pause-drain.test.ts"],"names":[],"mappings":""}

package/dist/routes/__tests__/reflect-pause-drain.test.js

@@ -0,0 +1,38 @@
+import { describe, it, beforeEach, afterEach } from "node:test";
+import assert from "node:assert/strict";
+import { reflectQueue, processReflectQueue, setReflectPaused } from "../state.js";
+// Regression lock for the 2026-06-01 surprise-spend bug: pause must HALT the
+// drain, not just gate new enqueues. Before the fix, processReflectQueue kept
+// draining a recovered queue while paused → credit burned on restart.
+describe("reflect drain respects pause", () => {
+    beforeEach(() => { reflectQueue.length = 0; setReflectPaused(false); });
+    afterEach(() => { reflectQueue.length = 0; setReflectPaused(false); });
+    it("does not touch the DB (does not drain) while paused, and leaves jobs queued", async () => {
+        // A db that throws on ANY access — proves the drain loop returns before
+        // reaching any job processing while paused.
+        const throwingDb = new Proxy({}, {
+            get() { throw new Error("db must not be touched while reflect is paused"); },
+        });
+        reflectQueue.push({
+            agentResponse: "x".repeat(60),
+            agentThinking: "",
+            userMessage: "",
+            loadedBlockIds: [],
+            agentId: "test-agent",
+            dbId: "job-1",
+        });
+        setReflectPaused(true);
+        await processReflectQueue(throwingDb, undefined); // must not throw
+        assert.equal(reflectQueue.length, 1, "job remains queued while paused (not shifted/processed)");
+    });
+    it("processes the queue when NOT paused (guard doesn't block normal drain)", async () => {
+        // Empty queue + not paused → loop runs and exits cleanly without touching db.
+        let dbTouched = false;
+        const watchDb = new Proxy({}, { get() { dbTouched = true; return () => undefined; } });
+        setReflectPaused(false);
+        await processReflectQueue(watchDb, undefined); // empty queue → no work, no db access
+        assert.equal(reflectQueue.length, 0);
+        assert.equal(dbTouched, false, "empty queue means no db access regardless");
+    });
+});
+//# sourceMappingURL=reflect-pause-drain.test.js.map

package/dist/routes/__tests__/reflect-pause-drain.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflect-pause-drain.test.js","sourceRoot":"","sources":["../../../src/routes/__tests__/reflect-pause-drain.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAChE,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAElF,6EAA6E;AAC7E,8EAA8E;AAC9E,sEAAsE;AACtE,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;IAC5C,UAAU,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxE,SAAS,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEvE,EAAE,CAAC,6EAA6E,EAAE,KAAK,IAAI,EAAE;QAC3F,wEAAwE;QACxE,4CAA4C;QAC5C,MAAM,UAAU,GAAQ,IAAI,KAAK,CAAC,EAAE,EAAE;YACpC,GAAG,KAAK,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC,CAAC,CAAC;SAC7E,CAAC,CAAC;QACH,YAAY,CAAC,IAAI,CAAC;YAChB,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,aAAa,EAAE,EAAE;YACjB,WAAW,EAAE,EAAE;YACf,cAAc,EAAE,EAAE;YAClB,OAAO,EAAE,YAAY;YACrB,IAAI,EAAE,OAAO;SACP,CAAC,CAAC;QAEV,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACvB,MAAM,mBAAmB,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,iBAAiB;QAEnE,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,EAAE,yDAAyD,CAAC,CAAC;IAClG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wEAAwE,EAAE,KAAK,IAAI,EAAE;QACtF,8EAA8E;QAC9E,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,MAAM,OAAO,GAAQ,IAAI,KAAK,CAAC,EAAE,EAAE,EAAE,GAAG,KAAK,SAAS,GAAG,IAAI,CAAC,CAAC,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC5F,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACxB,MAAM,mBAAmB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,sCAAsC;QACrF,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACrC,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,EAAE,2CAA2C,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/routes/__tests__/spend-pause-drain.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=spend-pause-drain.test.d.ts.map

package/dist/routes/__tests__/spend-pause-drain.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spend-pause-drain.test.d.ts","sourceRoot":"","sources":["../../../src/routes/__tests__/spend-pause-drain.test.ts"],"names":[],"mappings":""}

package/dist/routes/__tests__/spend-pause-drain.test.js

@@ -0,0 +1,38 @@
+import { describe, it, beforeEach, afterEach } from "node:test";
+import assert from "node:assert/strict";
+import { reflectQueue, processReflectQueue, setReflectPaused, setSpendPaused } from "../state.js";
+// Credit-exhaustion handling (2026-06-21): a SPEND pause halts the drain (stop spending)
+// while CAPTURE keeps queuing — distinct from reflectPaused (which stops capture too). This
+// locks the drain-halt half: processReflectQueue must return WITHOUT touching the DB while
+// spendPaused, leaving every job queued for a top-up. (The capture-keeps-queuing half lives
+// in the /trigger handler, which is gated on reflectPaused ONLY — not spendPaused.)
+describe("reflect drain respects the SPEND pause (credit-out)", () => {
+    beforeEach(() => { reflectQueue.length = 0; setReflectPaused(false); setSpendPaused(false); });
+    afterEach(() => { reflectQueue.length = 0; setReflectPaused(false); setSpendPaused(false); });
+    it("does not drain (no DB access) while spend-paused, and leaves jobs queued for top-up", async () => {
+        const throwingDb = new Proxy({}, {
+            get() { throw new Error("db must not be touched while spending is paused"); },
+        });
+        reflectQueue.push({
+            agentResponse: "x".repeat(60),
+            agentThinking: "",
+            userMessage: "",
+            loadedBlockIds: [],
+            agentId: "test-agent",
+            dbId: "job-1",
+        });
+        setSpendPaused(true);
+        await processReflectQueue(throwingDb, undefined); // must not throw, must not drain
+        assert.equal(reflectQueue.length, 1, "job remains queued while spend-paused (preserved for top-up)");
+    });
+    it("drains normally once the spend pause clears (auto-resume path)", async () => {
+        // Empty queue + both pauses off → loop runs and exits cleanly without touching db.
+        let dbTouched = false;
+        const watchDb = new Proxy({}, { get() { dbTouched = true; return () => undefined; } });
+        setSpendPaused(false);
+        await processReflectQueue(watchDb, undefined);
+        assert.equal(reflectQueue.length, 0);
+        assert.equal(dbTouched, false, "empty queue means no db access regardless");
+    });
+});
+//# sourceMappingURL=spend-pause-drain.test.js.map

package/dist/routes/__tests__/spend-pause-drain.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spend-pause-drain.test.js","sourceRoot":"","sources":["../../../src/routes/__tests__/spend-pause-drain.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAChE,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElG,yFAAyF;AACzF,4FAA4F;AAC5F,2FAA2F;AAC3F,4FAA4F;AAC5F,oFAAoF;AACpF,QAAQ,CAAC,qDAAqD,EAAE,GAAG,EAAE;IACnE,UAAU,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/F,SAAS,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAE9F,EAAE,CAAC,qFAAqF,EAAE,KAAK,IAAI,EAAE;QACnG,MAAM,UAAU,GAAQ,IAAI,KAAK,CAAC,EAAE,EAAE;YACpC,GAAG,KAAK,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC,CAAC,CAAC;SAC9E,CAAC,CAAC;QACH,YAAY,CAAC,IAAI,CAAC;YAChB,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,aAAa,EAAE,EAAE;YACjB,WAAW,EAAE,EAAE;YACf,cAAc,EAAE,EAAE;YAClB,OAAO,EAAE,YAAY;YACrB,IAAI,EAAE,OAAO;SACP,CAAC,CAAC;QAEV,cAAc,CAAC,IAAI,CAAC,CAAC;QACrB,MAAM,mBAAmB,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,iCAAiC;QAEnF,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,EAAE,8DAA8D,CAAC,CAAC;IACvG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,KAAK,IAAI,EAAE;QAC9E,mFAAmF;QACnF,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,MAAM,OAAO,GAAQ,IAAI,KAAK,CAAC,EAAE,EAAE,EAAE,GAAG,KAAK,SAAS,GAAG,IAAI,CAAC,CAAC,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC5F,cAAc,CAAC,KAAK,CAAC,CAAC;QACtB,MAAM,mBAAmB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAC9C,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACrC,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,EAAE,2CAA2C,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/routes/admin.d.ts

@@ -0,0 +1,49 @@
+import { Router } from "express";
+import { WorkspaceDB } from "../store/database.js";
+import { EmbeddingEngine } from "../engine/embeddings.js";
+import type { SchedulerJobStatus } from "../server.js";
+/** Slim an OpenRouter `/api/v1/models` entry to what the web-UI picker needs. Pure /
+ *  testable. `max_completion_tokens` (under `top_provider`) is the OUTPUT ceiling that
+ *  feeds NODEDEX_MODEL_CAPS; `context_length` is the whole input+output window (NOT the
+ *  output cap — do not use it for caps). `supported_parameters` tells whether the model
+ *  can do structured output, so the UI can warn/filter rather than discover it at the
+ *  first pass failure. Shape verified live 2026-06-16 against the real endpoint. */
+/** Parse NODEDEX_MODEL_CAPS (a JSON `{model: maxOutputTokens}` string) defensively. */
+export declare function safeParseModelCaps(raw?: string): Record<string, number>;
+type StageTier = "smart" | "mechanical" | "light";
+export interface PassRoutingStage {
+    stage: string;
+    env: string;
+    tier: StageTier;
+    role: string;
+    override: string;
+    effective: string;
+    hint: string;
+}
+/** The v2 engine stages, each with its model-override env knob, TIER (the "needs a
+ *  smarter model" hint the web UI shows), role, and resolved model. Resolution mirrors
+ *  the real call sites: comprehend → NODEDEX_COMPREHEND_MODEL (no tier); selector/build/
+ *  connect → REASONING tier; fill → STRUCTURAL tier; chain → default. effective =
+ *  override || tier model || default model. Pure / testable (reads env only). */
+export declare function buildPassRouting(): {
+    default_model: string;
+    reasoning_tier: string;
+    structural_tier: string;
+    stages: PassRoutingStage[];
+};
+export declare function slimOpenRouterModel(m: any): {
+    id: string;
+    name: string;
+    context_length: number | null;
+    max_completion_tokens: number | null;
+    pricing: {
+        prompt: string;
+        completion: string;
+    } | null;
+    supports_structured: boolean;
+    supports_tools: boolean;
+    modality: string | null;
+};
+export declare function createAdminRouter(db: WorkspaceDB, schedulerHealth?: Record<string, SchedulerJobStatus>, embeddings?: EmbeddingEngine): Router;
+export {};
+//# sourceMappingURL=admin.d.ts.map

package/dist/routes/admin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.d.ts","sourceRoot":"","sources":["../../src/routes/admin.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAsB,MAAM,yBAAyB,CAAC;AAE9E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAiDvD;;;;;oFAKoF;AACpF,uFAAuF;AACvF,wBAAgB,kBAAkB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAGvE;AAED,KAAK,SAAS,GAAG,OAAO,GAAG,YAAY,GAAG,OAAO,CAAC;AAClD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAC1D,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;CACnD;AAED;;;;iFAIiF;AACjF,wBAAgB,gBAAgB,IAAI;IAClC,aAAa,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC;CACpG,CAqBA;AAED,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,GAAG,GAAG;IAC3C,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACxD,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACvD,mBAAmB,EAAE,OAAO,CAAC;IAAC,cAAc,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAChF,CAeA;AAED,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,WAAW,EACf,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,EACpD,UAAU,CAAC,EAAE,eAAe,GAC3B,MAAM,CAyUR"}