@aiping.cn/model_router 1.2.0

package/README.md

@@ -0,0 +1,169 @@
+# @aiping.cn/model_router
+
+> Smart routing between your local Ollama model and AIPing cloud (Kimi-2.5).  
+> One plugin, one virtual model — zero workflow changes.
+
+[![npm version](https://img.shields.io/npm/v/@aiping.cn/model_router)](https://www.npmjs.com/package/@aiping.cn/model_router)
+
+---
+
+## What it does
+
+When you use the `aiping:claw` model in OpenClaw, this plugin automatically decides whether to send your request to:
+
+| Destination | When | Why |
+|---|---|---|
+| **Local model** (Ollama, e.g. `qwen2.5:4b`) | Short, simple queries | Low latency, zero cost |
+| **AIPing cloud** (Kimi-2.5) | Complex, long, or multi-turn | High capability |
+
+Routing is based on a **5-dimension rule scorer** that runs in < 1ms — no ML inference, no extra processes.
+
+---
+
+## Quick Start
+
+### 1. Install
+
+```bash
+openclaw plugins install @aiping.cn/model_router
+```
+
+The setup wizard will guide you through configuration automatically.
+
+### 2. Get your AIPing API key
+
+Visit [https://aiping.cn/user/user-center](https://aiping.cn/user/user-center) to obtain your API key.
+
+### 3. Make sure Ollama is running locally
+
+```bash
+# Start Ollama
+ollama serve
+
+# Pull your preferred local model
+ollama pull qwen2.5:4b
+```
+
+### 4. Use it
+
+Select **`aiping:claw`** as your model in OpenClaw. The plugin handles the rest.
+
+---
+
+## Manual Configuration
+
+```bash
+# Set your AIPing API key
+openclaw plugins config @aiping.cn/model_router set aipingApiKey "sk-your-key-here"
+
+# Change local proxy URL (default: http://localhost:11434)
+openclaw plugins config @aiping.cn/model_router set localProxyUrl "http://localhost:11434"
+
+# Change local model (default: qwen2.5:4b)
+openclaw plugins config @aiping.cn/model_router set localModel "qwen2.5:4b"
+
+# Run setup wizard again
+openclaw run aiping:setup
+```
+
+---
+
+## How Routing Works
+
+Each request is scored across 5 dimensions:
+
+| Dimension | Max Points | Trigger |
+|---|---|---|
+| Token count | 30 | > 2000 estimated tokens |
+| Code complexity | 20 | Code block with > 30 lines |
+| Reasoning depth | 15 | Keywords: analyze, compare, 分析, 对比... |
+| Multi-turn context | 20 | > 6 messages in history |
+| Override directive | — | `@local` or `@cloud` in message |
+
+**Score ≥ threshold (default: 50) → Cloud (Kimi-2.5)**  
+**Score < threshold → Local (Ollama)**
+
+### Override Routing
+
+Add `@local` or `@cloud` to any message to force a specific destination:
+
+```
+Summarise this paragraph @local
+```
+
+```
+Write a comprehensive analysis of this architecture @cloud
+```
+
+---
+
+## Configuration Reference
+
+| Key | Default | Description |
+|---|---|---|
+| `aipingApiKey` | *(required)* | AIPing API key from [aiping.cn](https://aiping.cn/user/user-center) |
+| `localProxyUrl` | `http://localhost:11434` | Ollama or local proxy base URL |
+| `localProxyKey` | *(empty)* | Optional auth key for local proxy |
+| `localModel` | `qwen2.5:4b` | Local model name in Ollama |
+| `cloudModel` | `kimi-2.5` | Cloud model on AIPing |
+| `routingThreshold` | `50` | Score threshold (0–100) |
+| `fallbackToCloud` | `true` | Auto-fallback to cloud if local fails |
+| `localTimeoutMs` | `30000` | Local request timeout in ms |
+| `debugRouting` | `false` | Print routing decisions to console |
+
+---
+
+## Architecture
+
+```
+OpenClaw Gateway
+  └── aiping:claw (virtual model)
+        └── ModelRouter Plugin
+              ├── RuleScorer (5 dimensions, < 1ms)
+              │     ├── TokenCountScorer
+              │     ├── CodeComplexityScorer
+              │     ├── ReasoningDepthScorer
+              │     ├── MultiTurnContextScorer
+              │     └── OverrideScorer (@local / @cloud)
+              ├── LocalAdapter  → Ollama /v1/chat/completions
+              └── CloudAdapter  → https://aiping.cn/api/v1/chat/completions
+```
+
+The `RuleScorer` interface is extensible — add new scoring dimensions by implementing:
+
+```typescript
+interface RuleScorer {
+  readonly name: string;
+  readonly maxScore: number;
+  score(request: ChatRequest): DimensionScore;
+}
+```
+
+---
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Run tests
+npm test
+
+# Watch mode
+npm run dev
+```
+
+---
+
+## Links
+
+- [AIPing API](https://aiping.cn/api/v1)
+- [AIPing User Center (API Key)](https://aiping.cn/user/user-center)
+- [OpenClaw Plugin Docs](https://open-claw.bot/docs/plugins/api)
+- [Changelog](docs/CHANGELOG.md)
+- [Architecture Plan](docs/plan-v1.md)
+

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @aiping.cn/model_router — OpenClaw Plugin Entry Point
+ *
+ * Registers the "aiping:claw" virtual model with the OpenClaw Gateway
+ * and routes incoming requests to either a local Ollama model or the
+ * AIPing cloud API based on a lightweight 5-dimension rule scorer.
+ *
+ * 默认策略：约 90% 请求走本地模型，只有复杂任务走云端。
+ */
+import type { ChatRequest, ChatResponse } from './types.js';
+export default function register(api: OpenClawPluginAPI): void;
+interface OpenClawPluginAPI {
+    getConfig(): Record<string, unknown>;
+    setConfig(config: Record<string, unknown>): Promise<void>;
+    onConfigChange(callback: (config: Record<string, unknown>) => void): void;
+    registerCommand(cmd: {
+        name: string;
+        description: string;
+        run(): Promise<void>;
+    }): void;
+    registerModelRoute(route: {
+        model: string;
+        description: string;
+        chat(request: ChatRequest): Promise<ChatResponse>;
+        chatStream(request: ChatRequest): AsyncGenerator<string>;
+    }): void;
+    /** Optional: set the Gateway's default model (available in OpenClaw Gateway ≥ 1.x) */
+    setDefaultModel?(model: string): Promise<void>;
+}
+export {};
+//# 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;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAgB,MAAM,YAAY,CAAC;AAW1E,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,GAAG,EAAE,iBAAiB,GAAG,IAAI,CA+D7D;AA8GD,UAAU,iBAAiB;IACzB,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,cAAc,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC;IAC1E,eAAe,CAAC,GAAG,EAAE;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;KACtB,GAAG,IAAI,CAAC;IACT,kBAAkB,CAAC,KAAK,EAAE;QACxB,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;QAClD,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;KAC1D,GAAG,IAAI,CAAC;IACT,sFAAsF;IACtF,eAAe,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD"}

package/dist/index.js

@@ -0,0 +1,149 @@
+"use strict";
+/**
+ * @aiping.cn/model_router — OpenClaw Plugin Entry Point
+ *
+ * Registers the "aiping:claw" virtual model with the OpenClaw Gateway
+ * and routes incoming requests to either a local Ollama model or the
+ * AIPing cloud API based on a lightweight 5-dimension rule scorer.
+ *
+ * 默认策略：约 90% 请求走本地模型，只有复杂任务走云端。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = register;
+const types_js_1 = require("./types.js");
+const router_js_1 = require("./router/router.js");
+const local_js_1 = require("./providers/local.js");
+const cloud_js_1 = require("./providers/cloud.js");
+const wizard_js_1 = require("./setup/wizard.js");
+// ──────────────────────────────────────────────────────────────────────────────
+// OpenClaw plugin API surface (api object injected by the Gateway at load time)
+// ──────────────────────────────────────────────────────────────────────────────
+function register(api) {
+    let config = buildConfig(api.getConfig());
+    // Re-build config whenever it changes (live reload support)
+    api.onConfigChange((newConfig) => {
+        config = buildConfig(newConfig);
+    });
+    // ── 注册 CLI 命令：重新运行配置向导 ─────────────────────────────────────
+    api.registerCommand({
+        name: 'aiping:setup',
+        description: '运行 AIPing Model Router 中文配置向导',
+        async run() {
+            const updated = await (0, wizard_js_1.runSetupWizard)(config);
+            await api.setConfig(updated);
+            config = updated;
+        },
+    });
+    // ── 首次安装：自动触发中文配置向导 ─────────────────────────────────────
+    // 如果 aipingApiKey 还没配置，说明是首次安装，自动启动向导。
+    if (!config.aipingApiKey) {
+        (0, wizard_js_1.runSetupWizard)(config)
+            .then(async (updated) => {
+            await api.setConfig(updated);
+            config = updated;
+        })
+            .catch((wizardErr) => {
+            console.warn('[aiping:router] 配置向导退出，稍后可运行 `openclaw run aiping:setup` 重新配置。', wizardErr.message);
+        });
+    }
+    // ── 注册虚拟模型 aiping:claw ─────────────────────────────────────────────
+    api.registerModelRoute({
+        model: 'aiping:claw',
+        description: 'AIPing 智能路由 — 自动在本地模型和云端 Kimi-2.5 之间切换（约 90% 走本地）',
+        async chat(request) {
+            return handleChat(request, config);
+        },
+        async *chatStream(request) {
+            yield* handleChatStream(request, config);
+        },
+    });
+    // ── 注册为默认模型 ────────────────────────────────────────────────────────
+    // 尝试通过 Gateway API 设置默认模型（若 API 可用）
+    if (typeof api.setDefaultModel === 'function') {
+        api.setDefaultModel('aiping:claw').catch(() => {
+            // 静默失败：向导内已提供手动设置方式
+        });
+    }
+    console.log('[aiping:router] ✅ 已注册虚拟模型 "aiping:claw"' +
+        ` | 阈值=${config.routingThreshold} | 本地=${config.localModel}` +
+        (config.debugRouting ? ' | 路由调试开启' : ''));
+}
+// ──────────────────────────────────────────────────────────────────────────────
+// Core request handlers
+// ──────────────────────────────────────────────────────────────────────────────
+async function handleChat(request, config) {
+    const router = new router_js_1.Router(config);
+    const local = new local_js_1.LocalAdapter(config);
+    const cloud = new cloud_js_1.CloudAdapter(config);
+    const decision = router.decide(request);
+    if (decision.target === 'local') {
+        try {
+            return await local.chat(request);
+        }
+        catch (err) {
+            if (config.fallbackToCloud) {
+                console.warn(`[aiping:router] Local failed (${err.message}), falling back to cloud`);
+                return cloud.chat(request);
+            }
+            throw err;
+        }
+    }
+    // Cloud path: no fallback needed (cloud errors surface directly)
+    try {
+        return await cloud.chat(request);
+    }
+    catch (err) {
+        // If cloud fails and fallback is enabled, try local as last resort
+        if (config.fallbackToCloud && !(err instanceof local_js_1.LocalAdapterError)) {
+            console.warn(`[aiping:router] Cloud failed (${err.message}), trying local as fallback`);
+            return local.chat(request);
+        }
+        throw err;
+    }
+}
+async function* handleChatStream(request, config) {
+    const router = new router_js_1.Router(config);
+    const local = new local_js_1.LocalAdapter(config);
+    const cloud = new cloud_js_1.CloudAdapter(config);
+    const decision = router.decide(request);
+    if (decision.target === 'local') {
+        try {
+            yield* local.chatStream(request);
+            return;
+        }
+        catch (err) {
+            if (config.fallbackToCloud) {
+                console.warn(`[aiping:router] Local stream failed (${err.message}), falling back to cloud`);
+                yield* cloud.chatStream(request);
+                return;
+            }
+            throw err;
+        }
+    }
+    yield* cloud.chatStream(request);
+}
+// ──────────────────────────────────────────────────────────────────────────────
+// Helpers
+// ──────────────────────────────────────────────────────────────────────────────
+function buildConfig(raw) {
+    return {
+        aipingApiKey: raw['aipingApiKey'] ?? '',
+        localProxyUrl: raw['localProxyUrl'] ?? types_js_1.DEFAULT_CONFIG.localProxyUrl,
+        localProxyKey: raw['localProxyKey'] ?? '',
+        localModel: raw['localModel'] ?? types_js_1.DEFAULT_CONFIG.localModel,
+        cloudModel: raw['cloudModel'] ?? types_js_1.DEFAULT_CONFIG.cloudModel,
+        routingThreshold: typeof raw['routingThreshold'] === 'number'
+            ? raw['routingThreshold']
+            : types_js_1.DEFAULT_CONFIG.routingThreshold,
+        fallbackToCloud: typeof raw['fallbackToCloud'] === 'boolean'
+            ? raw['fallbackToCloud']
+            : types_js_1.DEFAULT_CONFIG.fallbackToCloud,
+        localTimeoutMs: typeof raw['localTimeoutMs'] === 'number'
+            ? raw['localTimeoutMs']
+            : types_js_1.DEFAULT_CONFIG.localTimeoutMs,
+        debugRouting: typeof raw['debugRouting'] === 'boolean'
+            ? raw['debugRouting']
+            : types_js_1.DEFAULT_CONFIG.debugRouting,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/providers/cloud.d.ts

@@ -0,0 +1,23 @@
+import type { ChatRequest, ChatResponse, PluginConfig } from '../types.js';
+/**
+ * CloudAdapter forwards requests to the AIPing API (Kimi-2.5 by default).
+ * The AIPing API is OpenAI-compatible.
+ */
+export declare class CloudAdapter {
+    private readonly config;
+    constructor(config: PluginConfig);
+    private buildHeaders;
+    chat(request: ChatRequest): Promise<ChatResponse>;
+    chatStream(request: ChatRequest): AsyncGenerator<string>;
+    ping(): Promise<{
+        ok: boolean;
+        latencyMs: number;
+        model: string;
+        error?: string;
+    }>;
+}
+export declare class CloudAdapterError extends Error {
+    readonly statusCode: number;
+    constructor(message: string, statusCode: number);
+}
+//# sourceMappingURL=cloud.d.ts.map

package/dist/providers/cloud.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud.d.ts","sourceRoot":"","sources":["../../src/providers/cloud.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3E;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;gBAE1B,MAAM,EAAE,YAAY;IAIhC,OAAO,CAAC,YAAY;IAOd,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAgChD,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,CAAC,MAAM,CAAC;IAoCzD,IAAI,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CA8CzF;AAED,qBAAa,iBAAkB,SAAQ,KAAK;aAGxB,UAAU,EAAE,MAAM;gBADlC,OAAO,EAAE,MAAM,EACC,UAAU,EAAE,MAAM;CAKrC"}

package/dist/providers/cloud.js

@@ -0,0 +1,128 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CloudAdapterError = exports.CloudAdapter = void 0;
+const AIPING_BASE_URL = 'https://aiping.cn/api/v1';
+/**
+ * CloudAdapter forwards requests to the AIPing API (Kimi-2.5 by default).
+ * The AIPing API is OpenAI-compatible.
+ */
+class CloudAdapter {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    buildHeaders() {
+        return {
+            'Content-Type': 'application/json',
+            Authorization: `Bearer ${this.config.aipingApiKey}`,
+        };
+    }
+    async chat(request) {
+        const body = JSON.stringify({
+            ...request,
+            model: this.config.cloudModel,
+            stream: false,
+        });
+        const res = await fetch(`${AIPING_BASE_URL}/chat/completions`, {
+            method: 'POST',
+            headers: this.buildHeaders(),
+            body,
+        });
+        if (!res.ok) {
+            const text = await res.text().catch(() => '');
+            if (res.status === 401) {
+                throw new CloudAdapterError('Invalid AIPing API key. Get your key at https://aiping.cn/user/user-center', 401);
+            }
+            if (res.status === 429) {
+                throw new CloudAdapterError('AIPing rate limit exceeded. Please retry later.', 429);
+            }
+            throw new CloudAdapterError(`AIPing API returned ${res.status}: ${text}`, res.status);
+        }
+        const data = (await res.json());
+        // Normalise model field to the virtual model name
+        return { ...data, model: request.model };
+    }
+    async *chatStream(request) {
+        const body = JSON.stringify({
+            ...request,
+            model: this.config.cloudModel,
+            stream: true,
+        });
+        const res = await fetch(`${AIPING_BASE_URL}/chat/completions`, {
+            method: 'POST',
+            headers: this.buildHeaders(),
+            body,
+        });
+        if (!res.ok) {
+            const text = await res.text().catch(() => '');
+            if (res.status === 401) {
+                throw new CloudAdapterError('Invalid AIPing API key. Get your key at https://aiping.cn/user/user-center', 401);
+            }
+            throw new CloudAdapterError(`AIPing API returned ${res.status}: ${text}`, res.status);
+        }
+        if (!res.body)
+            throw new CloudAdapterError('Empty response body from AIPing', 500);
+        const reader = res.body.getReader();
+        const decoder = new TextDecoder();
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            yield decoder.decode(value, { stream: true });
+        }
+    }
+    async ping() {
+        const start = Date.now();
+        try {
+            // Use a minimal chat request to verify the key and model are valid
+            const res = await fetch(`${AIPING_BASE_URL}/chat/completions`, {
+                method: 'POST',
+                headers: this.buildHeaders(),
+                body: JSON.stringify({
+                    model: this.config.cloudModel,
+                    messages: [{ role: 'user', content: 'ping' }],
+                    max_tokens: 1,
+                    stream: false,
+                }),
+                signal: AbortSignal.timeout(10000),
+            });
+            const latencyMs = Date.now() - start;
+            if (res.status === 401) {
+                return {
+                    ok: false,
+                    latencyMs,
+                    model: this.config.cloudModel,
+                    error: 'Invalid API key',
+                };
+            }
+            if (!res.ok) {
+                return {
+                    ok: false,
+                    latencyMs,
+                    model: this.config.cloudModel,
+                    error: `HTTP ${res.status}`,
+                };
+            }
+            return { ok: true, latencyMs, model: this.config.cloudModel };
+        }
+        catch (err) {
+            return {
+                ok: false,
+                latencyMs: Date.now() - start,
+                model: this.config.cloudModel,
+                error: err.message,
+            };
+        }
+    }
+}
+exports.CloudAdapter = CloudAdapter;
+class CloudAdapterError extends Error {
+    statusCode;
+    constructor(message, statusCode) {
+        super(message);
+        this.statusCode = statusCode;
+        this.name = 'CloudAdapterError';
+    }
+}
+exports.CloudAdapterError = CloudAdapterError;
+//# sourceMappingURL=cloud.js.map

package/dist/providers/cloud.js.map

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

package/dist/providers/local.d.ts

@@ -0,0 +1,25 @@
+import type { ChatRequest, ChatResponse, PluginConfig } from '../types.js';
+/**
+ * LocalAdapter forwards requests to an Ollama-compatible local server
+ * using the OpenAI-compatible /v1/chat/completions endpoint.
+ */
+export declare class LocalAdapter {
+    private readonly config;
+    constructor(config: PluginConfig);
+    private get baseUrl();
+    private buildHeaders;
+    chat(request: ChatRequest): Promise<ChatResponse>;
+    chatStream(request: ChatRequest): AsyncGenerator<string>;
+    ping(): Promise<{
+        ok: boolean;
+        latencyMs: number;
+        error?: string;
+    }>;
+    /** Returns list of model names available on the local server. */
+    listModels(): Promise<string[]>;
+}
+export declare class LocalAdapterError extends Error {
+    readonly statusCode: number;
+    constructor(message: string, statusCode: number);
+}
+//# sourceMappingURL=local.d.ts.map

package/dist/providers/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../src/providers/local.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3E;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;gBAE1B,MAAM,EAAE,YAAY;IAIhC,OAAO,KAAK,OAAO,GAElB;IAED,OAAO,CAAC,YAAY;IAUd,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IA6ChD,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,CAAC,MAAM,CAAC;IAoDzD,IAAI,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IA+BzE,iEAAiE;IAC3D,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAyBtC;AAED,qBAAa,iBAAkB,SAAQ,KAAK;aAGxB,UAAU,EAAE,MAAM;gBADlC,OAAO,EAAE,MAAM,EACC,UAAU,EAAE,MAAM;CAKrC"}