@nac3/forge-cli 0.2.0-alpha.8 → 0.2.1-alpha.60

package/dist/llm/deepseek_client.js

@@ -0,0 +1,188 @@
+const DEEPSEEK_BASE = 'https://api.deepseek.com/chat/completions';
+const DEFAULT_DEEPSEEK_MODEL = 'deepseek-chat';
+const DEFAULT_MAX_TOOL_ROUNDS = 5;
+export class DeepSeekApiError extends Error {
+    status;
+    constructor(message, status) {
+        super(message);
+        this.name = 'DeepSeekApiError';
+        this.status = status;
+    }
+}
+export class DeepSeekClient {
+    apiKey;
+    fetchImpl;
+    defaultModel;
+    constructor(opts) {
+        if (!opts.apiKey || opts.apiKey.trim() === '') {
+            throw new Error('DeepSeekClient: apiKey required');
+        }
+        this.apiKey = opts.apiKey.trim();
+        this.fetchImpl = opts.fetchImpl ?? fetch;
+        this.defaultModel = opts.defaultModel ?? DEFAULT_DEEPSEEK_MODEL;
+    }
+    async chat(req) {
+        if (req.tools && !req.runTool) {
+            throw new Error('DeepSeekChatRequest.tools requires a runTool callback');
+        }
+        const model = req.model ?? this.defaultModel;
+        const maxTokens = req.maxTokens ?? 1024;
+        /* alpha.59g -- config-driven cap + family resolver, mirrors
+         * what OpenAI/Gemini/Claude clients do. */
+        const { readLimitsConfig, classifyVerbFamily, getMaxToolRoundsForFamily } = await import('../core/limits_config.js');
+        const limits = await readLimitsConfig();
+        const callerSpecifiedCap = req.maxToolRounds !== undefined;
+        const autonomousMode = limits.danger_zone && limits.danger_zone.auto_approve_all === true;
+        const baseCap = autonomousMode
+            ? limits.max_tool_rounds.autonomous
+            : limits.max_tool_rounds.default;
+        let maxRounds = req.maxToolRounds ?? baseCap;
+        let familyResolved = null;
+        const messages = [];
+        if (req.system && req.system.trim() !== '') {
+            messages.push({ role: 'system', content: req.system });
+        }
+        for (const m of req.messages) {
+            messages.push({ role: m.role, content: m.content });
+        }
+        const tools = (req.tools ?? []).map((t) => ({
+            type: 'function',
+            function: {
+                name: t.name,
+                description: t.description,
+                parameters: t.input_schema,
+            },
+        }));
+        let totalIn = 0;
+        let totalOut = 0;
+        let serverModel = model;
+        const toolRounds = [];
+        for (let round = 0; round < maxRounds; round++) {
+            void round;
+            void DEFAULT_MAX_TOOL_ROUNDS;
+            const body = {
+                model,
+                messages,
+                max_tokens: maxTokens,
+                temperature: 0.7,
+            };
+            if (tools.length > 0) {
+                body.tools = tools;
+                body.tool_choice = 'auto';
+            }
+            const res = await this.fetchImpl(DEEPSEEK_BASE, {
+                method: 'POST',
+                headers: {
+                    'content-type': 'application/json',
+                    'authorization': 'Bearer ' + this.apiKey,
+                },
+                body: JSON.stringify(body),
+            });
+            const json = await res.json();
+            if (!res.ok || json.error) {
+                const msg = json.error?.message || ('HTTP ' + res.status);
+                throw new DeepSeekApiError('DeepSeek API error: ' + msg, res.status);
+            }
+            if (json.model)
+                serverModel = json.model;
+            const usage = json.usage || {};
+            totalIn += usage.prompt_tokens ?? 0;
+            totalOut += usage.completion_tokens ?? 0;
+            const choice = json.choices && json.choices[0];
+            if (!choice) {
+                throw new DeepSeekApiError('DeepSeek returned no choices', 502);
+            }
+            const aMessage = choice.message;
+            const finishReason = choice.finish_reason;
+            if (!aMessage.tool_calls || aMessage.tool_calls.length === 0 || finishReason !== 'tool_calls') {
+                return {
+                    text: aMessage.content || '',
+                    tokensIn: totalIn,
+                    tokensOut: totalOut,
+                    model: serverModel,
+                    toolRounds,
+                };
+            }
+            if (familyResolved === null && aMessage.tool_calls.length > 0) {
+                const firstTc = aMessage.tool_calls[0];
+                if (firstTc) {
+                    let firstArgs = {};
+                    try {
+                        firstArgs = JSON.parse(firstTc.function.arguments || '{}');
+                    }
+                    catch { /* */ }
+                    const firstVerb = firstArgs.verb_id || firstTc.function.name || '';
+                    const fam = classifyVerbFamily(firstVerb);
+                    familyResolved = fam;
+                    if (!callerSpecifiedCap) {
+                        const famCap = getMaxToolRoundsForFamily(limits.max_tool_rounds, fam);
+                        if (famCap > maxRounds)
+                            maxRounds = famCap;
+                    }
+                }
+            }
+            messages.push({
+                role: 'assistant',
+                content: aMessage.content ?? null,
+                tool_calls: aMessage.tool_calls,
+            });
+            for (const tc of aMessage.tool_calls) {
+                let parsedArgs = {};
+                try {
+                    parsedArgs = JSON.parse(tc.function.arguments || '{}');
+                }
+                catch {
+                    parsedArgs = {};
+                }
+                let result;
+                let isError = false;
+                try {
+                    const r = await req.runTool(tc.function.name, parsedArgs);
+                    result = r.result;
+                    isError = r.is_error === true;
+                }
+                catch (err) {
+                    result = { error: err instanceof Error ? err.message : String(err) };
+                    isError = true;
+                }
+                const display = typeof result === 'object' && result !== null && 'display' in result
+                    ? String(result.display)
+                    : undefined;
+                toolRounds.push({
+                    tool: tc.function.name,
+                    tool_use_id: tc.id,
+                    input: parsedArgs,
+                    ...(display ? { display } : {}),
+                    ...(isError ? { is_error: true } : {}),
+                    result,
+                });
+                let resultStr;
+                try {
+                    resultStr = typeof result === 'string' ? result : JSON.stringify(result);
+                }
+                catch {
+                    resultStr = String(result);
+                }
+                if (resultStr.length > 200_000) {
+                    resultStr = JSON.stringify({ _truncated: true, _bytes: resultStr.length });
+                }
+                messages.push({
+                    role: 'tool',
+                    tool_call_id: tc.id,
+                    content: resultStr,
+                });
+            }
+        }
+        return {
+            text: '[Alcance el limite de rondas (' + maxRounds + '/' + maxRounds +
+                ') en esta tarea (familia=' + (familyResolved ?? 'default') +
+                '). Decime "continua" y sigo desde aca, o sube el cap en ' +
+                '`yf limits set max_tool_rounds.' + (familyResolved ?? 'default') + ' <N>`.]',
+            tokensIn: totalIn,
+            tokensOut: totalOut,
+            model: serverModel,
+            toolRounds,
+        };
+    }
+}
+//# sourceMappingURL=deepseek_client.js.map

package/dist/llm/deepseek_client.js.map

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

package/dist/llm/gemini_client.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Gemini brain client (alpha.52).
+ *
+ * Implements the same shape as ClaudeClient (chat({messages,
+ * system, tools, runTool, ...}) -> {text, tokensIn, tokensOut,
+ * model, toolRounds}) so the chat server can swap brain
+ * providers transparently. Uses plain HTTP fetch + Google
+ * Generative Language v1beta API. No SDK dependency.
+ *
+ * API model:
+ *   POST https://generativelanguage.googleapis.com/v1beta/models/
+ *        {model}:generateContent?key={API_KEY}
+ *
+ *   Body:
+ *     {
+ *       "systemInstruction": { "parts": [{"text": "..."}] },
+ *       "contents": [
+ *         { "role": "user" | "model" | "function",
+ *           "parts": [
+ *             { "text": "..." }
+ *             | { "functionCall": { name, args } }
+ *             | { "functionResponse": { name, response } }
+ *           ]
+ *         }
+ *       ],
+ *       "tools": [{ "functionDeclarations": [...] }],
+ *       "toolConfig": { "functionCallingConfig": { "mode": "AUTO" } },
+ *       "generationConfig": { "maxOutputTokens": N, "temperature": 0.7 }
+ *     }
+ *
+ *   Response candidate.content has parts that mix text +
+ *   functionCalls. We loop while the finishReason indicates
+ *   tool_use (Gemini uses functionCall parts alongside STOP).
+ *
+ * ASCII-only.
+ */
+import type { ToolRound, ChatMessage } from '../chat/claude.js';
+import type { ToolSpec } from '../chat/tools.js';
+import type { UsageKind } from '../telemetry/usage.js';
+export interface GeminiChatRequest {
+    messages: ChatMessage[];
+    system?: string;
+    maxTokens?: number;
+    model?: string;
+    tools?: ToolSpec[];
+    runTool?: (name: string, input: Record<string, unknown>) => Promise<{
+        result: unknown;
+        is_error?: boolean;
+    }>;
+    maxToolRounds?: number;
+    usageKind?: UsageKind;
+    usageLabel?: string;
+    projectRoot?: string;
+}
+export interface GeminiChatResponse {
+    text: string;
+    tokensIn: number;
+    tokensOut: number;
+    model: string;
+    toolRounds: ToolRound[];
+}
+export interface GeminiClientOptions {
+    apiKey: string;
+    defaultModel?: string;
+    fetchImpl?: typeof fetch;
+}
+export declare class GeminiApiError extends Error {
+    status: number;
+    constructor(message: string, status: number);
+}
+export declare class GeminiClient {
+    private apiKey;
+    private fetchImpl;
+    private defaultModel;
+    constructor(opts: GeminiClientOptions);
+    chat(req: GeminiChatRequest): Promise<GeminiChatResponse>;
+}
+//# sourceMappingURL=gemini_client.d.ts.map

package/dist/llm/gemini_client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini_client.d.ts","sourceRoot":"","sources":["../../src/llm/gemini_client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAMvD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;QAClE,MAAM,EAAE,OAAO,CAAC;QAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,SAAS,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AA6BD,qBAAa,cAAe,SAAQ,KAAK;IACvC,MAAM,EAAE,MAAM,CAAC;gBACH,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAK5C;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAe;IAChC,OAAO,CAAC,YAAY,CAAS;gBAEjB,IAAI,EAAE,mBAAmB;IAS/B,IAAI,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAiLhE"}

package/dist/llm/gemini_client.js

@@ -0,0 +1,189 @@
+const GEMINI_BASE = 'https://generativelanguage.googleapis.com/v1beta/models/';
+const DEFAULT_GEMINI_MODEL = 'gemini-2.5-flash-lite';
+export class GeminiApiError extends Error {
+    status;
+    constructor(message, status) {
+        super(message);
+        this.name = 'GeminiApiError';
+        this.status = status;
+    }
+}
+export class GeminiClient {
+    apiKey;
+    fetchImpl;
+    defaultModel;
+    constructor(opts) {
+        if (!opts.apiKey || opts.apiKey.trim() === '') {
+            throw new Error('GeminiClient: apiKey required');
+        }
+        this.apiKey = opts.apiKey.trim();
+        this.fetchImpl = opts.fetchImpl ?? fetch;
+        this.defaultModel = opts.defaultModel ?? DEFAULT_GEMINI_MODEL;
+    }
+    async chat(req) {
+        if (req.tools && !req.runTool) {
+            throw new Error('GeminiChatRequest.tools requires a runTool callback');
+        }
+        const model = req.model ?? this.defaultModel;
+        const maxTokens = req.maxTokens ?? 1024;
+        /* alpha.59c -- config-driven cap + family resolver. */
+        const { readLimitsConfig, classifyVerbFamily, getMaxToolRoundsForFamily } = await import('../core/limits_config.js');
+        const limits = await readLimitsConfig();
+        const callerSpecifiedCap = req.maxToolRounds !== undefined;
+        const autonomousMode = limits.danger_zone && limits.danger_zone.auto_approve_all === true;
+        const baseCap = autonomousMode
+            ? limits.max_tool_rounds.autonomous
+            : limits.max_tool_rounds.default;
+        let maxRounds = req.maxToolRounds ?? baseCap;
+        let familyResolved = null;
+        /* Translate the caller's ChatMessage[] into Gemini contents.
+         * ChatMessage has {role: 'user'|'assistant', content: string}
+         * and is text-only. assistant -> model. */
+        const contents = req.messages.map((m) => ({
+            role: m.role === 'assistant' ? 'model' : 'user',
+            parts: [{ text: m.content }],
+        }));
+        /* Translate Anthropic-shaped ToolSpec[] into Gemini
+         * functionDeclarations. The input_schema is JSON Schema in
+         * both, so the shape is compatible. */
+        const functionDeclarations = (req.tools ?? []).map((t) => ({
+            name: t.name,
+            description: t.description,
+            parameters: t.input_schema,
+        }));
+        const systemInstruction = req.system
+            ? { parts: [{ text: req.system }] }
+            : undefined;
+        let totalIn = 0;
+        let totalOut = 0;
+        const toolRounds = [];
+        for (let round = 0; round < maxRounds; round++) {
+            const body = {
+                contents,
+                generationConfig: { maxOutputTokens: maxTokens, temperature: 0.7 },
+            };
+            if (systemInstruction)
+                body.systemInstruction = systemInstruction;
+            if (functionDeclarations.length > 0) {
+                body.tools = [{ functionDeclarations }];
+                body.toolConfig = { functionCallingConfig: { mode: 'AUTO' } };
+            }
+            const url = GEMINI_BASE + encodeURIComponent(model) + ':generateContent?key=' + encodeURIComponent(this.apiKey);
+            const res = await this.fetchImpl(url, {
+                method: 'POST',
+                headers: { 'content-type': 'application/json' },
+                body: JSON.stringify(body),
+            });
+            const json = await res.json();
+            if (!res.ok || json.error) {
+                const msg = json.error?.message || ('HTTP ' + res.status);
+                throw new GeminiApiError('Gemini API error: ' + msg, res.status);
+            }
+            /* Accumulate token usage. */
+            const usage = json.usageMetadata ?? {};
+            totalIn += usage.promptTokenCount ?? 0;
+            totalOut += usage.candidatesTokenCount ?? 0;
+            const candidate = (json.candidates ?? [])[0];
+            const content = candidate?.content;
+            if (!content || !Array.isArray(content.parts)) {
+                /* Empty response -- return whatever text we have so far. */
+                break;
+            }
+            /* Walk the parts. Collect text + function calls. If there
+             * are function calls, dispatch them via runTool, append the
+             * model turn + the function response turn to contents, and
+             * loop. Otherwise return. */
+            const textParts = [];
+            const functionCalls = [];
+            for (const p of content.parts) {
+                if (typeof p.text === 'string')
+                    textParts.push(p.text);
+                if (p.functionCall) {
+                    functionCalls.push({
+                        name: p.functionCall.name,
+                        args: p.functionCall.args ?? {},
+                    });
+                }
+            }
+            if (functionCalls.length === 0) {
+                /* Pure text reply -- terminal. */
+                return {
+                    text: textParts.join('\n').trim(),
+                    tokensIn: totalIn,
+                    tokensOut: totalOut,
+                    model,
+                    toolRounds,
+                };
+            }
+            /* alpha.59c -- family detection on first verb. */
+            if (familyResolved === null && functionCalls.length > 0) {
+                const first = functionCalls[0];
+                if (first) {
+                    const firstVerb = first.args.verb_id || first.name || '';
+                    const fam = classifyVerbFamily(firstVerb);
+                    familyResolved = fam;
+                    if (!callerSpecifiedCap) {
+                        const famCap = getMaxToolRoundsForFamily(limits.max_tool_rounds, fam);
+                        if (famCap > maxRounds)
+                            maxRounds = famCap;
+                    }
+                }
+            }
+            /* Tool round. Append the model turn (with all its parts) to
+             * contents, then for each functionCall invoke runTool +
+             * append a function response turn. Loop. */
+            contents.push({
+                role: 'model',
+                parts: content.parts,
+            });
+            for (const fc of functionCalls) {
+                let toolResult;
+                try {
+                    toolResult = await req.runTool(fc.name, fc.args);
+                }
+                catch (err) {
+                    toolResult = {
+                        result: { error: err instanceof Error ? err.message : String(err) },
+                        is_error: true,
+                    };
+                }
+                /* Gemini expects functionResponse.response to be a JSON
+                 * object. If runTool returned a primitive, wrap. */
+                const responsePayload = (toolResult.result && typeof toolResult.result === 'object' && !Array.isArray(toolResult.result))
+                    ? toolResult.result
+                    : { value: toolResult.result };
+                contents.push({
+                    role: 'function',
+                    parts: [{
+                            functionResponse: {
+                                name: fc.name,
+                                response: responsePayload,
+                            },
+                        }],
+                });
+                toolRounds.push({
+                    tool: fc.name,
+                    input: fc.args,
+                    result: toolResult.result,
+                    is_error: Boolean(toolResult.is_error),
+                    tool_use_id: 'gem_' + Date.now().toString(36) + '_' + Math.random().toString(36).slice(2, 6),
+                });
+            }
+            /* Continue the loop -- Gemini will return text in the next
+             * call once it has seen the function responses. */
+        }
+        /* alpha.59c -- graceful exhaustion. Return what we have +
+         * helpful summary instead of a generic "loop reached" line. */
+        return {
+            text: '[Alcance el limite de rondas (' + maxRounds + '/' + maxRounds +
+                ') en esta tarea (familia=' + (familyResolved ?? 'default') +
+                '). Decime "continua" y sigo desde aca, o sube el cap en ' +
+                '`yf limits set max_tool_rounds.' + (familyResolved ?? 'default') + ' <N>`.]',
+            tokensIn: totalIn,
+            tokensOut: totalOut,
+            model,
+            toolRounds,
+        };
+    }
+}
+//# sourceMappingURL=gemini_client.js.map

package/dist/llm/gemini_client.js.map

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

package/dist/llm/managed_client.d.ts

@@ -0,0 +1,70 @@
+/**
+ * ManagedBrainClient -- talks to the HITO 4 worker's
+ * /v1/llm/chat endpoint instead of pegging the provider
+ * directly (alpha.59).
+ *
+ * Why: for managed plans (free / starter / pro / pro+), the
+ * client should NOT carry Yujin's provider API keys. The keys
+ * live in worker secrets. The client only sends license_handle
+ * + HMAC bearer + the conversation, and the worker proxies the
+ * call.
+ *
+ * Tool roundtrip stays client-driven: each POST is one LLM
+ * round-trip. When the LLM emits tool_calls, the client gets
+ * them in the response + executes them locally + re-POSTs with
+ * the tool_result blocks appended to messages. Loop bounded by
+ * `maxToolRounds`.
+ *
+ * Interface matches ClaudeClient / GeminiClient / OpenAIClient
+ * so `makeUnifiedClient` can route to it transparently.
+ *
+ * ASCII-only.
+ */
+import type { ChatMessage, ToolRound } from '../chat/claude.js';
+import type { ToolSpec } from '../chat/tools.js';
+export interface ManagedChatRequest {
+    messages: ChatMessage[];
+    system?: string;
+    maxTokens?: number;
+    /** Optional model override. Server has a default per plan+tier. */
+    model?: string;
+    tools?: ToolSpec[];
+    runTool?: (name: string, input: Record<string, unknown>) => Promise<{
+        result: unknown;
+        is_error?: boolean;
+    }>;
+    maxToolRounds?: number;
+}
+export interface ManagedChatResponse {
+    text: string;
+    tokensIn: number;
+    tokensOut: number;
+    model: string;
+    toolRounds: ToolRound[];
+}
+export interface ManagedClientOptions {
+    /** Server-resolved tier the router picked. The proxy uses
+     *  this to choose provider+model server-side. */
+    tier: 'eco' | 'frontier';
+    /** Override the proxy base URL (tests / dev). */
+    baseUrl?: string;
+    fetchImpl?: typeof fetch;
+    /** Override the bearer signing pieces -- tests can inject
+     *  ad-hoc secret + handle without touching the vault. */
+    secret?: string;
+    handle?: string;
+}
+export declare class ManagedBrainError extends Error {
+    status: number;
+    upstream_error?: string;
+    constructor(message: string, status: number, upstream_error?: string);
+}
+export declare class ManagedBrainClient {
+    private tier;
+    private baseUrl;
+    private fetchImpl;
+    private opts;
+    constructor(opts: ManagedClientOptions);
+    chat(req: ManagedChatRequest): Promise<ManagedChatResponse>;
+}
+//# sourceMappingURL=managed_client.d.ts.map

package/dist/llm/managed_client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed_client.d.ts","sourceRoot":"","sources":["../../src/llm/managed_client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAajD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;QAClE,MAAM,EAAE,OAAO,CAAC;QAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,SAAS,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC;qDACiD;IACjD,IAAI,EAAE,KAAK,GAAG,UAAU,CAAC;IACzB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB;6DACyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;gBACZ,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM;CAMrE;AAyCD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,IAAI,CAAqB;IACjC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAe;IAChC,OAAO,CAAC,IAAI,CAAuB;gBAEvB,IAAI,EAAE,oBAAoB;IAOhC,IAAI,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CA2LlE"}