@graview/tools 0.1.0

package/dist/local.d.ts.map

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

package/dist/local.js

@@ -0,0 +1,365 @@
+import { DECISION_BRIDGE_PATH } from "@graview/core";
+import { graphResponder, llmResponder } from "./conversation.js";
+import { completionDecide } from "./decide.js";
+import { jevDecide } from "./providers/jev.js";
+export const DEFAULT_INTELLIGENCE = { source: "graph" };
+/**
+ * FOUR RUNGS, TWO AXES. Each rung says which capabilities it serves; a
+ * surface asks for a capability, never for a rung; and what the chosen
+ * rung cannot serve falls DOWN to the graph, which is keyless and always
+ * there. Pretending the ladder has one axis is how a switch starts lying:
+ * a decision provider is the best rung for a decision and no rung at all
+ * for prose.
+ */
+export const RUNGS = {
+    graph: { label: "Graph only", serves: ["decide", "propose"] },
+    local: { label: "Onboard AI", serves: ["prose", "decide", "propose"] },
+    decision: { label: "Jev", serves: ["decide"] },
+    remote: { label: "LLM", serves: ["prose", "decide", "propose"] },
+};
+/**
+ * Which rung answers a capability under this config: the chosen one when
+ * it serves the capability, the graph otherwise — with `fell` saying so,
+ * which is what a seat's honesty sentence is made of.
+ */
+export function rungFor(config, capability) {
+    if (RUNGS[config.source].serves.includes(capability))
+        return { rung: config.source, fell: false };
+    return { rung: "graph", fell: true };
+}
+/** The sentence a seat says on a rung that cannot talk. Part of the answer, not chrome. */
+export function rungHonesty(config, capability) {
+    const { fell } = rungFor(config, capability);
+    if (!fell)
+        return undefined;
+    const rung = RUNGS[config.source].label;
+    return capability === "prose"
+        ? `(${rung} decides rather than talks — the graph is answering here.)`
+        : `(${rung} cannot ${capability} — the graph is answering here.)`;
+}
+const STORED = "graview:intelligence";
+/** The saved rung, or the keyless default — never a throw. */
+export function loadIntelligenceConfig() {
+    try {
+        const raw = globalThis.localStorage?.getItem(STORED);
+        if (!raw)
+            return DEFAULT_INTELLIGENCE;
+        const parsed = JSON.parse(raw);
+        if (parsed.source in RUNGS)
+            return parsed;
+        return DEFAULT_INTELLIGENCE;
+    }
+    catch {
+        return DEFAULT_INTELLIGENCE;
+    }
+}
+export function saveIntelligenceConfig(config) {
+    try {
+        globalThis.localStorage?.setItem(STORED, JSON.stringify(config));
+    }
+    catch {
+        // A rung that cannot be remembered still applies for this visit.
+    }
+}
+/* ------------------------------------------------------------- adapters */
+const XAI_BASE = "https://api.x.ai/v1";
+const XAI_DEFAULT_MODEL = "grok-4-fast";
+/**
+ * Any OpenAI-compatible /chat/completions endpoint as one Completion.
+ * The call goes STRAIGHT from the browser to the provider — the key is
+ * sent nowhere else, and there is no relay to trust.
+ */
+export function openAiCompatibleCompletion(options) {
+    const call = options.fetch ?? globalThis.fetch;
+    return async (prompt) => {
+        const response = await call(`${options.baseUrl.replace(/\/$/, "")}/chat/completions`, {
+            method: "POST",
+            headers: {
+                "content-type": "application/json",
+                authorization: `Bearer ${options.apiKey}`,
+            },
+            body: JSON.stringify({
+                model: options.model,
+                messages: [{ role: "user", content: prompt }],
+            }),
+            // A hung provider must not hang the conversation: the floor answers.
+            ...(typeof AbortSignal !== "undefined" && "timeout" in AbortSignal
+                ? { signal: AbortSignal.timeout(45_000) }
+                : {}),
+        });
+        if (!response.ok) {
+            throw new Error(`${options.model} answered ${response.status}: ${(await response.text()).slice(0, 160)}`);
+        }
+        const parsed = (await response.json());
+        const content = parsed.choices?.[0]?.message?.content;
+        if (typeof content !== "string")
+            throw new Error(`${options.model} answered with no content`);
+        return content;
+    };
+}
+/** xAI's Grok, as a preset of the same shape. */
+export function xaiCompletion(options) {
+    return openAiCompatibleCompletion({
+        baseUrl: XAI_BASE,
+        apiKey: options.apiKey,
+        model: options.model ?? XAI_DEFAULT_MODEL,
+        ...(options.fetch ? { fetch: options.fetch } : {}),
+    });
+}
+const WEBLLM_DEFAULT_MODEL = "Llama-3.2-3B-Instruct-q4f16_1-MLC";
+/**
+ * A model in the browser, warmed lazily and NEVER on the critical path.
+ *
+ * The weights are on the order of a couple of gigabytes, fetched once and
+ * cached by the browser; until they are warm the chat answers from the
+ * graph. WebLLM arrives by dynamic import at the moment someone turns the
+ * rung on — it is not a build dependency, because most installs never
+ * will. Chrome's built-in Prompt API is used first where it exists: no
+ * download at all.
+ */
+/*
+ * ONE ENGINE PER MODEL, module-wide. Rebuilding the responder (a settings
+ * save, a re-render) must not drop a two-gigabyte engine and warm a new
+ * one — and a bring-up that failed stays failed rather than re-downloading
+ * on every turn; a page reload is the retry.
+ */
+const ENGINES = new Map();
+export function localCompletion(options = {}) {
+    const cacheKey = options.load ? null : (options.model ?? WEBLLM_DEFAULT_MODEL);
+    const held = cacheKey
+        ? (ENGINES.get(cacheKey) ?? ENGINES.set(cacheKey, { engine: null, failed: null }).get(cacheKey))
+        : { engine: null, failed: null };
+    let engine = held.engine;
+    let warming = false;
+    const say = (status) => options.onStatus?.(status);
+    const bringUp = async () => {
+        if (options.load)
+            return options.load();
+        // Chrome's built-in model first: zero download, no WebGPU contention.
+        const prompt = globalThis
+            .LanguageModel;
+        if (prompt) {
+            const session = await prompt.create();
+            return {
+                chat: {
+                    completions: {
+                        create: async ({ messages }) => ({
+                            choices: [
+                                { message: { content: await session.prompt(messages[messages.length - 1]?.content ?? "") } },
+                            ],
+                        }),
+                    },
+                },
+            };
+        }
+        /*
+         * CAPABILITY GATING, STATED. WebLLM needs WebGPU; without it the
+         * engine would download megabytes of loader only to fail obscurely.
+         * Failing here, first, is what lets the chat header say WHY the rung
+         * is unavailable in this browser rather than shrugging — and the
+         * graph floor answers either way.
+         */
+        if (!globalThis.navigator?.gpu) {
+            throw new Error("this browser has no WebGPU, which the local model needs");
+        }
+        const url = "https://esm.run/@mlc-ai/web-llm";
+        const webllm = (await import(/* @vite-ignore */ url));
+        return webllm.CreateMLCEngine(options.model ?? WEBLLM_DEFAULT_MODEL, {
+            initProgressCallback: (report) => say({ state: "warming", progress: report.progress, detail: report.text }),
+        });
+    };
+    const warm = () => {
+        engine = held.engine ?? engine;
+        if (engine || warming)
+            return;
+        if (held.failed !== null) {
+            say({ state: "failed", detail: held.failed });
+            return;
+        }
+        warming = true;
+        say({ state: "warming" });
+        void bringUp()
+            .then((ready) => {
+            engine = ready;
+            held.engine = ready;
+            say({ state: "ready" });
+        })
+            .catch((error) => {
+            held.failed = error instanceof Error ? error.message : String(error);
+            say({ state: "failed", detail: held.failed });
+        })
+            .finally(() => {
+            warming = false;
+        });
+    };
+    const complete = async (prompt) => {
+        engine = held.engine ?? engine;
+        if (!engine)
+            throw new Error("The local model is not warm yet");
+        const answer = await engine.chat.completions.create({
+            messages: [{ role: "user", content: prompt }],
+        });
+        const content = answer.choices?.[0]?.message?.content;
+        if (typeof content !== "string")
+            throw new Error("The local model answered with no content");
+        return content;
+    };
+    return { complete, ready: () => (held.engine ?? engine) !== null, warm };
+}
+/* ------------------------------------------------------ the whole ladder */
+/**
+ * THE MODEL BEHIND A RUNG, when the person has chosen one.
+ *
+ * A conversation is not the only thing a model is good for: drawing a
+ * kind's figure is one prompt and one answer, judged by the checker's own
+ * function. Both reach the same configured provider through this, so there
+ * is one place a key is read and one place a rung is honoured — and a
+ * keyless config answers `undefined` rather than a completion that throws,
+ * so a caller can say what it will do INSTEAD of drawing.
+ */
+export function completionFor(config, hooks = {}) {
+    if (config.source === "remote" && config.remote?.apiKey) {
+        const model = config.remote.model ?? (config.remote.preset === "custom" ? "a model" : XAI_DEFAULT_MODEL);
+        return config.remote.preset === "custom" && config.remote.baseUrl
+            ? openAiCompatibleCompletion({ baseUrl: config.remote.baseUrl, apiKey: config.remote.apiKey, model })
+            : xaiCompletion({ apiKey: config.remote.apiKey, ...(config.remote.model ? { model: config.remote.model } : {}) });
+    }
+    if (config.source === "local") {
+        const local = localCompletion({
+            ...(config.local?.model ? { model: config.local.model } : {}),
+            ...(hooks.onStatus ? { onStatus: hooks.onStatus } : {}),
+        });
+        /*
+         * A cold engine is warmed rather than refused: the first ask pays for
+         * the bring-up, and `complete` throws while it is cold — which the
+         * callers already treat as "say what happened instead", never as a
+         * silent failure.
+         */
+        if (!local.ready())
+            local.warm();
+        return local.complete;
+    }
+    return undefined;
+}
+/**
+ * One Responder from one config. The graph is always the floor: a remote
+ * failure or a cold local model answers from the graph WITH A NOTE rather
+ * than failing the conversation — a chat that errors where it could have
+ * answered is worse than either rung alone.
+ */
+export function configuredResponder(config, hooks = {}) {
+    const floor = hooks.floor ?? graphResponder();
+    const built = config.source;
+    const switched = (reply) => {
+        const now = hooks.current?.();
+        if (!now || now.source === built)
+            return reply;
+        return note(reply, `(answered on the ${RUNGS[built].label} rung — you switched to ${RUNGS[now.source].label} meanwhile.)`);
+    };
+    const honest = (responder) => async (store, text, context) => switched(await responder(store, text, context));
+    /*
+     * GROUNDED FACTS OUTRANK ANY MODEL. Whatever rung is chosen, a question
+     * the graph can answer from its own structure — a standing, a named
+     * thing, a who or a when — is answered by the graph: a small local model
+     * asked "who can play left back" will fluently invent a goalkeeper, and
+     * no rung is allowed to replace a fact with a guess about the same fact.
+     *
+     * A READING OF A CHANGE IS NOT A FACT, and treating it as one was the
+     * ladder shutting the model out of the only thing it is better at.
+     * Speaking a change loosely — "add details to Meal, the name of the food
+     * and the number of people it can feed" — is two fields in one sentence,
+     * and a pattern-matcher can only ever see one of them. So the floor's
+     * reading goes UP to the model as a starting point: keep it, correct it,
+     * or split it. What the model may not do is come back with less: an
+     * answer with no proposals never replaces a reading that had them.
+     */
+    const groundedFirst = (modelled, name) => async (store, text, context) => {
+        const known = await floor(store, text, context);
+        if (known.grounded)
+            return note(known, "(from the graph)");
+        try {
+            const answered = await modelled(store, text, {
+                ...context,
+                ...(known.proposals.length > 0 ? { reading: known.proposals } : {}),
+            });
+            if (answered.proposals.length === 0 && known.proposals.length > 0) {
+                return note(known, "(from the graph)");
+            }
+            return answered;
+        }
+        catch (error) {
+            return note(known, `(${name} did not answer — ${error instanceof Error ? error.message : String(error)}. The graph answered instead.)`);
+        }
+    };
+    if (config.source === "remote" && config.remote?.apiKey) {
+        const model = config.remote.model ?? (config.remote.preset === "custom" ? "a model" : XAI_DEFAULT_MODEL);
+        const complete = completionFor(config);
+        if (complete)
+            return honest(groundedFirst(llmResponder({ complete }), model));
+    }
+    /*
+     * THE RUNG THAT SAYS WHAT IT CANNOT DO. A decision provider has no prose,
+     * so the conversation is the graph's — and the seat SAYS so, in the
+     * answer itself, so every surface the seat speaks from carries the
+     * sentence unchanged: the chat panel now, a figure's bubble later. The
+     * same honesty the seat shows when it is refused an act.
+     */
+    if (config.source === "decision") {
+        const why = rungHonesty(config, "prose");
+        return honest(async (store, text, context) => note(await floor(store, text, context), why));
+    }
+    if (config.source === "local") {
+        const local = localCompletion({
+            ...(config.local?.model ? { model: config.local.model } : {}),
+            ...(hooks.onStatus ? { onStatus: hooks.onStatus } : {}),
+        });
+        const modelled = groundedFirst(llmResponder({ complete: local.complete }), "the local model");
+        return honest(async (store, text, context) => {
+            if (!local.ready()) {
+                local.warm();
+                const answered = await floor(store, text, context);
+                return answered.grounded
+                    ? note(answered, "(from the graph)")
+                    : note(answered, "(the local model is warming — the graph answered meanwhile)");
+            }
+            return modelled(store, text, context);
+        });
+    }
+    return honest(floor);
+}
+/**
+ * THE DECISION BEHIND A RUNG, for a surface that asks for one — a field
+ * that wants filling, a matrix that wants judging. On the decision rung
+ * it is the provider exactly, by the person's key or through the dev
+ * server's door; on a model rung it is the model with the parse-and-refuse
+ * layer behind it; on the graph rung it is nothing here, because the
+ * graph decides by its own rules and needs the store to do it
+ * (`graphDecide`). A surface holding `undefined` falls down to that.
+ */
+export function decideFor(config, hooks = {}) {
+    if (config.source === "decision") {
+        const decision = config.decision ?? {};
+        return decision.apiKey
+            ? jevDecide({ apiKey: decision.apiKey, ...(decision.model ? { model: decision.model } : {}) })
+            : jevDecide({ baseUrl: decision.bridge ?? DECISION_BRIDGE_PATH, ...(decision.model ? { model: decision.model } : {}) });
+    }
+    const complete = completionFor(config, hooks);
+    return complete ? completionDecide(complete) : undefined;
+}
+function note(reply, added) {
+    return { ...reply, say: `${reply.say} ${added}` };
+}
+/** A word for the header: where answers are coming from right now. */
+export function describeIntelligence(config) {
+    if (config.source === "remote" && config.remote?.apiKey) {
+        return config.remote.preset === "custom"
+            ? (config.remote.model ?? "custom model")
+            : (config.remote.model ?? XAI_DEFAULT_MODEL);
+    }
+    if (config.source === "local")
+        return "on-device";
+    if (config.source === "decision")
+        return `${config.decision?.model ?? "jev"} — decides; the graph talks`;
+    return "graph-native";
+}
+//# sourceMappingURL=local.js.map

package/dist/local.js.map

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

package/dist/loop.d.ts

@@ -0,0 +1,84 @@
+import { type AnySchema, type Principal, type Store, type Violation } from "@graview/core";
+import type { ToolCall } from "./agent/tools.js";
+import type { ChatReply } from "./conversation.js";
+import { type PlanOptions, type PlannedCall } from "./plan.js";
+import { type Answer, type Decide } from "./providers/jev.js";
+import { type DerivedQuestion, type OfferedQuestion } from "./questions.js";
+/**
+ * A LOOP: ACT, RE-JUDGE, ACT AGAIN, AND KNOW WHEN TO STOP.
+ *
+ * `store.violations()` already says what is wrong and every rule names its
+ * repairs. A loop takes one violation, asks which repair to take — a
+ * Choice over a CLOSED set, so an invented repair is impossible — applies
+ * it as the declared act, re-judges, and goes again. Every turn is
+ * attributed to the loop's own seat and lands under one batch, so a loop
+ * that went wrong comes back out through the same control as anything
+ * else: one undo.
+ *
+ * It stops for a reason it can SAY. Nothing left; not sure enough of the
+ * repair; a state it has been in before (the loop is going in a circle);
+ * the budget spent; the provider failed; the policy refused. The sentence
+ * is part of the result and of the seat's reply, and it is announced on
+ * the same path a tool call is, so the rail carries it too.
+ */
+export interface LoopDeclaration {
+    readonly name: string;
+    /** Which rules to keep; every rule otherwise. */
+    readonly rules?: readonly string[];
+    /** What this loop may spend. Twenty turns unless said otherwise. */
+    readonly budget?: {
+        readonly turns?: number;
+        readonly questions?: number;
+        readonly usd?: number;
+    };
+}
+export type StopWhy = "nothing-left" | "unsure" | "seen-before" | "budget" | "failed" | "refused" | "no-repair";
+export interface Stopped {
+    readonly why: StopWhy;
+    /** The sentence the seat says. */
+    readonly said: string;
+    /** For `unsure`: the question the loop hands to a person, at its node. */
+    readonly question?: OfferedQuestion;
+}
+export interface LoopTurn {
+    readonly turn: number;
+    readonly violation: Violation;
+    /** The repair question asked, when there was more than one repair to choose from. */
+    readonly asked?: DerivedQuestion;
+    readonly answer?: Answer;
+    readonly confidence: number;
+    readonly call: PlannedCall;
+    /** Violations before and after this turn — what the turn did to the standing. */
+    readonly before: number;
+    readonly after: number;
+}
+export interface LoopOptions<S extends AnySchema> extends PlanOptions<S> {
+    readonly decide: Decide;
+    readonly author?: Principal;
+    readonly onCall?: (call: ToolCall) => void;
+    readonly batch?: string;
+    /** Below this confidence the loop stops and asks. 0.5 otherwise. */
+    readonly floor?: number;
+    readonly splitWithin?: number;
+    /** For rules whose evaluation wants a context. */
+    readonly context?: Readonly<Record<string, unknown>>;
+}
+export interface LoopResult {
+    readonly name: string;
+    readonly author: Principal;
+    readonly batch: string;
+    readonly turns: readonly LoopTurn[];
+    readonly stopped: Stopped;
+    readonly usage: {
+        readonly questions: number;
+        readonly calls: number;
+        readonly inputTokens: number;
+        readonly usd: number;
+    };
+    /** Violations still standing when it stopped. */
+    readonly remaining: number;
+}
+export declare function runLoop<S extends AnySchema>(store: Store<S>, loop: LoopDeclaration, options: LoopOptions<S>): Promise<LoopResult>;
+/** A loop, spoken by the seat: the stop sentence, and the question if it stopped to ask. */
+export declare function replyFromLoop(result: LoopResult): ChatReply;
+//# sourceMappingURL=loop.d.ts.map

package/dist/loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../src/loop.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,KAAK,KAAK,EAAE,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AACpG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAuB,KAAK,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AACpF,OAAO,EAAc,KAAK,MAAM,EAAE,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAyB,KAAK,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGnG;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,oEAAoE;IACpE,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACnG;AAED,MAAM,MAAM,OAAO,GAAG,cAAc,GAAG,QAAQ,GAAG,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;AAEhH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,kCAAkC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,CAAC,EAAE,eAAe,CAAC;CACrC;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,qFAAqF;IACrF,QAAQ,CAAC,KAAK,CAAC,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,iFAAiF;IACjF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,SAAS,CAAE,SAAQ,WAAW,CAAC,CAAC,CAAC;IACtE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,oEAAoE;IACpE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,kDAAkD;IAClD,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACtD;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3H,iDAAiD;IACjD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAUD,wBAAsB,OAAO,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CA8JvI;AAED,4FAA4F;AAC5F,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,CAM3D"}