@tanstack-ai-browser/afm 0.0.0-stage → 0.2.2

package/dist/electron.js

@@ -0,0 +1,136 @@
+const PACKAGE = "@tanstack-ai-browser/afm";
+const CALL = "afm:call";
+const EVENT = "afm:event";
+const appPages = (url) => {
+    try {
+        const { protocol, hostname } = new URL(url);
+        if (protocol !== "http:" && protocol !== "https:")
+            return true;
+        return hostname === "localhost" || hostname === "127.0.0.1" || hostname === "[::1]";
+    }
+    catch {
+        return false;
+    }
+};
+const unpacked = (file) => file.replace(/app\.asar(?=[\\/])/, "app.asar.unpacked");
+let served = false;
+/**
+ * Runs Apple's on-device model for the app's pages, where `afmText()` finds it.
+ * Call it once in the main process, before opening windows. On a Mac before
+ * macOS 26, or elsewhere, the pages hear the model is unavailable.
+ */
+export function serveAfm(options = {}) {
+    const appGuardrails = options.guardrails;
+    if (served)
+        return;
+    served = true;
+    const node = globalThis.process;
+    const { createRequire } = node.getBuiltinModule("node:module");
+    const path = node.getBuiltinModule("node:path");
+    // Electron answers `require("electron")` from anywhere in the main process.
+    const electron = createRequire(node.execPath)("electron");
+    const { app } = electron;
+    const allow = options.allow ?? appPages;
+    let directory = options.directory;
+    if (!directory) {
+        try {
+            const fromApp = createRequire(path.join(app.getAppPath(), "package.json"));
+            directory = path.join(path.dirname(fromApp.resolve(`${PACKAGE}/package.json`)), "electron");
+        }
+        catch (error) {
+            console.error(`Apple's on-device model is unavailable: ${PACKAGE} isn't in the app's node_modules (pass serveAfm's directory)`, error);
+        }
+    }
+    let addon;
+    if (directory && node.platform === "darwin") {
+        try {
+            addon = createRequire(node.execPath)(unpacked(path.join(directory, "afm.node")));
+        }
+        catch (error) {
+            console.error("Apple's on-device model is unavailable: its addon didn't load", error);
+        }
+    }
+    // The native sessions, by native id: `${frame id}/${the page's id}`.
+    const owners = new Map();
+    const frameIdOf = (frame) => `${frame.processId}:${frame.frameToken}`;
+    const endSessions = (ended) => {
+        for (const [id, owner] of owners) {
+            if (!ended(owner))
+                continue;
+            owners.delete(id);
+            addon?.call("deleteSession", JSON.stringify({ sessionId: id }));
+        }
+    };
+    // A page's sessions end with its document: a navigation, or its contents closing.
+    const watched = new WeakSet();
+    const watch = (contents) => {
+        if (watched.has(contents))
+            return;
+        watched.add(contents);
+        const contentsId = contents.id;
+        contents.on("did-start-navigation", ({ isSameDocument, frame }) => {
+            if (isSameDocument || !frame)
+                return;
+            const frameId = frameIdOf(frame);
+            endSessions((owner) => owner.frameId === frameId);
+        });
+        contents.once("destroyed", () => endSessions((owner) => owner.contentsId === contentsId));
+    };
+    electron.ipcMain.handle(CALL, (event, method, args) => {
+        const frame = event.senderFrame;
+        if (!frame || !allow(frame.url))
+            throw new Error("This page may not use Apple's on-device model");
+        if (!addon) {
+            if (method === "availability")
+                return { available: false, reason: "unsupportedOS" };
+            throw new Error("Apple's on-device model needs macOS 26 on a Mac with Apple silicon");
+        }
+        const options = { ...(typeof args === "object" && args !== null ? args : {}) };
+        // The app's guardrails, where the page names none.
+        if ((method === "createSession" || method === "availability") && options.guardrails === undefined && appGuardrails) {
+            options.guardrails = appGuardrails;
+        }
+        // The frame's own session: another frame's can't be reached.
+        if (typeof options.sessionId === "string") {
+            const frameId = frameIdOf(frame);
+            const id = `${frameId}/${options.sessionId}`;
+            if (method === "createSession") {
+                owners.set(id, { frame, frameId, contentsId: event.sender.id, sessionId: options.sessionId });
+                watch(event.sender);
+            }
+            else if (method === "deleteSession") {
+                owners.delete(id);
+            }
+            options.sessionId = id;
+        }
+        const reply = JSON.parse(addon.call(method, JSON.stringify(options)));
+        if (reply.error)
+            throw new Error(reply.error);
+        return reply.result ?? null;
+    });
+    // Each event to its session's frame only, with the page's id, while its page is allowed.
+    addon?.setListener((json) => {
+        const event = JSON.parse(json);
+        const owner = typeof event.sessionId === "string" ? owners.get(event.sessionId) : undefined;
+        if (!owner || owner.frame.isDestroyed() || owner.frame.detached || !allow(owner.frame.url))
+            return;
+        owner.frame.send(EVENT, { ...event, sessionId: owner.sessionId });
+    });
+    // The preload, in every session's pages: window.afm.
+    if (!directory)
+        return;
+    const preload = path.join(directory, "preload.cjs");
+    const preloaded = new WeakSet();
+    const addPreload = (session) => {
+        if (preloaded.has(session))
+            return;
+        preloaded.add(session);
+        session.registerPreloadScript({ type: "frame", id: "tanstack-ai-browser-afm", filePath: preload });
+    };
+    // Now if the app is ready, so a window opened next has it.
+    if (app.isReady())
+        addPreload(electron.session.defaultSession);
+    else
+        void app.whenReady().then(() => addPreload(electron.session.defaultSession));
+    app.on("session-created", addPreload);
+}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * TanStack AI adapter for Apple's on-device Foundation Model, through the
+ * Foundation Models framework, with its native tool calling: a Capacitor
+ * plugin for iOS (`Afm`), Electron's main process on macOS (`serveAfm()`), or
+ * any host implementing `AfmNative`. The model catalog (model-meta.ts) is
+ * exported here too.
+ */
+export { AfmTextAdapter, afmText } from "./adapter.js";
+export type { Availability, AfmConfig, AfmTextModelOptions } from "./adapter.js";
+export { Afm } from "./native.js";
+export { serveAfm } from "./electron.js";
+export type { ServeAfmOptions } from "./electron.js";
+export type { AfmGuardrails, AfmNative, NativeAvailability, NativeEvent, NativeGenerationSchema, NativeMessage, NativeProperty, NativeSchema, NativeTool, NativeUsage, UnavailableReason } from "./native.js";
+export { toNativeSchema } from "./schema.js";
+export { AFM_CHAT_MODELS, AFM_MODEL_META } from "./model-meta.js";
+export type { AfmChatModel, AfmModelMeta } from "./model-meta.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;;;;;;GAMG;AACH,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtD,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAChF,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAA;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AACpD,YAAY,EACV,aAAa,EACb,SAAS,EACT,kBAAkB,EAClB,WAAW,EACX,sBAAsB,EACtB,aAAa,EACb,cAAc,EACd,YAAY,EACZ,UAAU,EACV,WAAW,EACX,iBAAiB,EAClB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AACjE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/index.js

@@ -0,0 +1,12 @@
+/**
+ * TanStack AI adapter for Apple's on-device Foundation Model, through the
+ * Foundation Models framework, with its native tool calling: a Capacitor
+ * plugin for iOS (`Afm`), Electron's main process on macOS (`serveAfm()`), or
+ * any host implementing `AfmNative`. The model catalog (model-meta.ts) is
+ * exported here too.
+ */
+export { AfmTextAdapter, afmText } from "./adapter.js";
+export { Afm } from "./native.js";
+export { serveAfm } from "./electron.js";
+export { toNativeSchema } from "./schema.js";
+export { AFM_CHAT_MODELS, AFM_MODEL_META } from "./model-meta.js";

package/dist/json-value.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The JSON value in a model's text answer: the whole trimmed text, or, when the
+ * model wrapped it in a Markdown code fence, everything inside the fence. Any
+ * value: an object, an array, a string, a number, a boolean or null. Never by
+ * brace positions, which would cut an array down to one of its objects, or a
+ * string that contains braces out of its quotes.
+ */
+export declare function parseJsonValue(text: string): unknown;
+//# sourceMappingURL=json-value.d.ts.map

package/dist/json-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-value.d.ts","sourceRoot":"","sources":["../src/json-value.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CASpD"}

package/dist/json-value.js

@@ -0,0 +1,19 @@
+/**
+ * The JSON value in a model's text answer: the whole trimmed text, or, when the
+ * model wrapped it in a Markdown code fence, everything inside the fence. Any
+ * value: an object, an array, a string, a number, a boolean or null. Never by
+ * brace positions, which would cut an array down to one of its objects, or a
+ * string that contains braces out of its quotes.
+ */
+export function parseJsonValue(text) {
+    const trimmed = text.trim();
+    try {
+        return JSON.parse(trimmed);
+    }
+    catch (error) {
+        const fenced = /^```[\w-]*[^\S\n]*\n([\s\S]*?)\n?```$/.exec(trimmed);
+        if (fenced)
+            return JSON.parse(fenced[1].trim());
+        throw error;
+    }
+}

package/dist/messages.d.ts

@@ -0,0 +1,12 @@
+/**
+ * TanStack AI's messages as a native session's conversation (`NativeMessage`):
+ * text, the assistant's tool calls, and the tools' results. The framework
+ * reads text only here, so other parts are left out.
+ */
+import type { ModelMessage } from "@tanstack/ai";
+import type { NativeMessage } from "./native.js";
+/** A message's text: its string, or its text parts joined. */
+export declare function contentText(content: ModelMessage["content"]): string;
+/** The messages as a session's conversation, each tool result named by its call's tool. */
+export declare function toNativeMessages(messages: ReadonlyArray<ModelMessage>): Array<NativeMessage>;
+//# sourceMappingURL=messages.d.ts.map

package/dist/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAEhD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEhD,8DAA8D;AAC9D,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC,GAAG,MAAM,CAOpE;AAED,2FAA2F;AAC3F,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,aAAa,CAAC,YAAY,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC,CAgB5F"}

package/dist/messages.js

@@ -0,0 +1,29 @@
+/** A message's text: its string, or its text parts joined. */
+export function contentText(content) {
+    if (typeof content === "string")
+        return content;
+    if (!Array.isArray(content))
+        return "";
+    return content
+        .map((part) => (part.type === "text" ? part.content : ""))
+        .filter(Boolean)
+        .join("\n");
+}
+/** The messages as a session's conversation, each tool result named by its call's tool. */
+export function toNativeMessages(messages) {
+    const toolNames = new Map();
+    return messages.map((m) => {
+        if (m.role === "tool") {
+            const id = m.toolCallId ?? "";
+            return { role: "tool", toolCallId: id, name: m.name ?? toolNames.get(id) ?? "", text: contentText(m.content) };
+        }
+        if (m.role === "assistant") {
+            const toolCalls = (m.toolCalls ?? []).map((call) => {
+                toolNames.set(call.id, call.function.name);
+                return { id: call.id, name: call.function.name, arguments: call.function.arguments || "{}" };
+            });
+            return { role: "assistant", text: contentText(m.content), ...(toolCalls.length > 0 && { toolCalls }) };
+        }
+        return { role: "user", text: contentText(m.content) };
+    });
+}

package/dist/model-meta.d.ts

@@ -0,0 +1,23 @@
+/**
+ * The model the framework runs: Apple's system language model
+ * (`SystemLanguageModel.default`), the on-device model of Apple Intelligence.
+ * It calls tools natively, and holds structured answers to a schema. It doesn't
+ * reason, so `chat()` offers no `reasoning` option for it.
+ */
+/** What a Foundation Models model supports. */
+export type AfmModelMeta = {
+    /** The model's name here. */
+    name: string;
+    supports: {
+        input: ReadonlyArray<"text">;
+        output: ReadonlyArray<"text">;
+        capabilities: ReadonlyArray<"tools" | "structured-output">;
+    };
+};
+/** The models the framework runs: Apple's system language model. */
+export declare const AFM_CHAT_MODELS: readonly ["system"];
+/** A model the framework runs. */
+export type AfmChatModel = (typeof AFM_CHAT_MODELS)[number];
+/** Each model's metadata, by name. */
+export declare const AFM_MODEL_META: Readonly<Record<AfmChatModel, AfmModelMeta>>;
+//# sourceMappingURL=model-meta.d.ts.map

package/dist/model-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-meta.d.ts","sourceRoot":"","sources":["../src/model-meta.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,+CAA+C;AAC/C,MAAM,MAAM,YAAY,GAAG;IACzB,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE;QACR,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;QAC5B,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;QAC7B,YAAY,EAAE,aAAa,CAAC,OAAO,GAAG,mBAAmB,CAAC,CAAA;KAC3D,CAAA;CACF,CAAA;AAWD,oEAAoE;AACpE,eAAO,MAAM,eAAe,qBAA+B,CAAA;AAE3D,kCAAkC;AAClC,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAA;AAE3D,sCAAsC;AACtC,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,YAAY,CAAC,CAEvE,CAAA"}

package/dist/model-meta.js

@@ -0,0 +1,20 @@
+/**
+ * The model the framework runs: Apple's system language model
+ * (`SystemLanguageModel.default`), the on-device model of Apple Intelligence.
+ * It calls tools natively, and holds structured answers to a schema. It doesn't
+ * reason, so `chat()` offers no `reasoning` option for it.
+ */
+const SYSTEM_MODEL = {
+    name: "system",
+    supports: {
+        input: ["text"],
+        output: ["text"],
+        capabilities: ["tools", "structured-output"]
+    }
+};
+/** The models the framework runs: Apple's system language model. */
+export const AFM_CHAT_MODELS = [SYSTEM_MODEL.name];
+/** Each model's metadata, by name. */
+export const AFM_MODEL_META = {
+    [SYSTEM_MODEL.name]: SYSTEM_MODEL
+};

package/dist/native.d.ts

@@ -0,0 +1,175 @@
+/**
+ * The native side of the adapter: Apple's Foundation Models framework, reached
+ * through the Capacitor plugin on iOS (ios/Sources), or the Electron main
+ * process (`serveAfm()`, whose preload puts it at `window.afm`). Any host can
+ * stand in for them by implementing `AfmNative`.
+ */
+import type { PluginListenerHandle } from "@capacitor/core";
+/** Why the model can't run: Apple's reasons, or an OS before 26. */
+export type UnavailableReason = "deviceNotEligible" | "appleIntelligenceNotEnabled" | "modelNotReady" | "unsupportedOS" | "unavailable";
+export type NativeAvailability = {
+    available: boolean;
+    reason?: UnavailableReason;
+    /** Tokens a session holds (iOS/macOS 26.4 and later). */
+    contextSize?: number;
+};
+/**
+ * A schema as the framework takes it: JSON Schema read into an ordered form
+ * (`schema.ts`), properties in the order given, and named definitions for
+ * `reference`s.
+ */
+export type NativeSchema = {
+    kind: "object";
+    name: string;
+    description?: string;
+    properties: Array<NativeProperty>;
+} | {
+    kind: "array";
+    items: NativeSchema;
+    minimumElements?: number;
+    maximumElements?: number;
+} | {
+    kind: "string";
+    choices?: Array<string>;
+    constant?: string;
+} | {
+    kind: "integer" | "number";
+    minimum?: number;
+    maximum?: number;
+} | {
+    kind: "boolean";
+} | {
+    kind: "null";
+} | {
+    kind: "anyOf";
+    name: string;
+    description?: string;
+    choices: Array<NativeSchema>;
+} | {
+    kind: "reference";
+    name: string;
+};
+export type NativeProperty = {
+    name: string;
+    description?: string;
+    optional: boolean;
+    schema: NativeSchema;
+};
+/** A root schema and the definitions its references name. */
+export type NativeGenerationSchema = {
+    root: NativeSchema;
+    definitions: Array<NativeSchema>;
+};
+export type NativeTool = {
+    name: string;
+    description: string;
+    parameters: NativeGenerationSchema;
+};
+/** A message of the conversation a session starts from. */
+export type NativeMessage = {
+    role: "user";
+    text: string;
+} | {
+    role: "assistant";
+    text: string;
+    toolCalls?: Array<{
+        id: string;
+        name: string;
+        arguments: string;
+    }>;
+} | {
+    role: "tool";
+    toolCallId: string;
+    name: string;
+    text: string;
+};
+/**
+ * A response's tokens, over every pass of the model (a tool call's too).
+ * `cachedTokens` is there only where the framework counts it right: for a
+ * session without tools.
+ */
+export type NativeUsage = {
+    inputTokens: number;
+    cachedTokens?: number;
+    outputTokens: number;
+};
+/** What a session sends while it responds, for the `turn` of the `respond` call. */
+export type NativeEvent = {
+    sessionId: string;
+    turn: number;
+} & ({
+    type: "delta";
+    text: string;
+} | {
+    type: "toolCalls";
+    calls: Array<{
+        id: string;
+        name: string;
+        arguments: string;
+    }>;
+}
+/** `asText`: a schema's answer written as text (permissive guardrails' fallback), not held to the schema. */
+ | {
+    type: "done";
+    text: string;
+    usage?: NativeUsage;
+    asText?: boolean;
+} | {
+    type: "error";
+    code: string;
+    message: string;
+});
+/**
+ * Apple's guardrails for the model: "default", or "permissiveContentTransformations",
+ * which lets through text the default ones can block out of context (a card game's
+ * "Searing Blood" or "Play with Fire").
+ */
+export type AfmGuardrails = "default" | "permissiveContentTransformations";
+export interface AfmNative {
+    availability(options?: {
+        guardrails?: AfmGuardrails;
+    }): Promise<NativeAvailability>;
+    createSession(options: {
+        sessionId: string;
+        instructions?: string;
+        tools: Array<NativeTool>;
+        messages: Array<NativeMessage>;
+        guardrails?: AfmGuardrails;
+    }): Promise<void>;
+    prewarm(options: {
+        sessionId: string;
+    }): Promise<void>;
+    /** Prompts a session; the response comes as events. A `schema` holds the answer to it (JSON in `done`). */
+    respond(options: {
+        sessionId: string;
+        turn: number;
+        prompt: string;
+        options?: {
+            temperature?: number;
+            maximumResponseTokens?: number;
+            /** Whether the model may call the session's tools, must, or mustn't (iOS/macOS 27). Left out, the framework decides. */
+            toolCallingMode?: "allowed" | "required" | "disallowed";
+        };
+        schema?: NativeGenerationSchema;
+    }): Promise<void>;
+    /** A tool's result: the session's waiting call returns it, and the response goes on. */
+    submitToolResult(options: {
+        sessionId: string;
+        callId: string;
+        output: string;
+    }): Promise<void>;
+    /** Stops a session's response. */
+    cancel(options: {
+        sessionId: string;
+    }): Promise<void>;
+    deleteSession(options: {
+        sessionId: string;
+    }): Promise<void>;
+    addListener(eventName: "event", listener: (event: NativeEvent) => void): Promise<PluginListenerHandle>;
+}
+/**
+ * The Capacitor plugin (iOS), loading Capacitor on its first call. Elsewhere
+ * its calls reject: Capacitor has no web version of it.
+ */
+export declare const Afm: AfmNative;
+//# sourceMappingURL=native.d.ts.map

package/dist/native.d.ts.map

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

package/dist/native.js

@@ -0,0 +1,21 @@
+let loading;
+/**
+ * The plugin, loading Capacitor on first use: pages elsewhere never load it.
+ * It's wrapped: a Capacitor plugin answers every property, `then` too, so a
+ * promise of the plugin itself would wait on it forever.
+ */
+const capacitor = () => (loading ??= import("@capacitor/core").then(({ registerPlugin }) => ({ plugin: registerPlugin("Afm") })));
+/**
+ * The Capacitor plugin (iOS), loading Capacitor on its first call. Elsewhere
+ * its calls reject: Capacitor has no web version of it.
+ */
+export const Afm = {
+    availability: async (options) => (await capacitor()).plugin.availability(options),
+    createSession: async (options) => (await capacitor()).plugin.createSession(options),
+    prewarm: async (options) => (await capacitor()).plugin.prewarm(options),
+    respond: async (options) => (await capacitor()).plugin.respond(options),
+    submitToolResult: async (options) => (await capacitor()).plugin.submitToolResult(options),
+    cancel: async (options) => (await capacitor()).plugin.cancel(options),
+    deleteSession: async (options) => (await capacitor()).plugin.deleteSession(options),
+    addListener: async (name, listener) => (await capacitor()).plugin.addListener(name, listener)
+};

package/dist/schema.d.ts

@@ -0,0 +1,17 @@
+/**
+ * JSON Schema (what `chat()` gives adapters for tools and structured output)
+ * read into the framework's own schema (`NativeSchema`), which the model's
+ * output is held to: a tool's arguments always fit its parameters.
+ *
+ * Properties keep their order, which the model writes them in. Each object is
+ * named by its path, so two objects never share a name. A property that may be
+ * null is optional. `$ref`s to `$defs` (or `definitions`) become references to
+ * named definitions; one to a plain value is written in place.
+ */
+import type { NativeGenerationSchema } from "./native.js";
+/**
+ * The framework's schema for a JSON Schema, named `name` (a tool's name, or
+ * the structured answer's).
+ */
+export declare function toNativeSchema(schema: unknown, name: string): NativeGenerationSchema;
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,sBAAsB,EAAgB,MAAM,aAAa,CAAA;AA2BvE;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,sBAAsB,CA+GpF"}