pulseed 0.1.5 → 0.2.0

package/dist/base/llm/llm-client.js.map

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

package/dist/base/llm/ollama-client.d.ts

@@ -0,0 +1,27 @@
+import { BaseLLMClient } from "./base-llm-client.js";
+import { type ILLMClient, type LLMMessage, type LLMRequestOptions, type LLMResponse } from "./llm-client.js";
+export interface OllamaClientConfig {
+    baseUrl: string;
+    model?: string;
+    /** Optional lighter model for routine tasks */
+    lightModel?: string;
+}
+/**
+ * LLM client for Ollama's OpenAI-compatible API.
+ * Uses native fetch (Node 18+) — no extra dependencies.
+ *
+ * Set PULSEED_LLM_PROVIDER=ollama to activate via CLIRunner.
+ * Optionally set OLLAMA_BASE_URL and OLLAMA_MODEL to configure.
+ */
+export declare class OllamaLLMClient extends BaseLLMClient implements ILLMClient {
+    private readonly baseUrl;
+    private readonly model;
+    constructor(config: OllamaClientConfig);
+    /**
+     * Send a message to Ollama's OpenAI-compatible chat completions endpoint.
+     * Retries up to MAX_RETRY_ATTEMPTS times with exponential backoff on network errors.
+     * Retries up to RATE_LIMIT_RETRY_DELAYS_MS.length times on HTTP 429 with extended backoff.
+     */
+    sendMessage(messages: LLMMessage[], options?: LLMRequestOptions): Promise<LLMResponse>;
+}
+//# sourceMappingURL=ollama-client.d.ts.map

package/dist/base/llm/ollama-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama-client.d.ts","sourceRoot":"","sources":["../../../src/base/llm/ollama-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAyJ,MAAM,sBAAsB,CAAC;AAC5M,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAW7G,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,qBAAa,eAAgB,SAAQ,aAAc,YAAW,UAAU;IACtE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,MAAM,EAAE,kBAAkB;IAOtC;;;;OAIG;IACG,WAAW,CACf,QAAQ,EAAE,UAAU,EAAE,EACtB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,WAAW,CAAC;CAqGxB"}

package/dist/base/llm/ollama-client.js

@@ -0,0 +1,111 @@
+import { BaseLLMClient, DEFAULT_MAX_TOKENS, DEFAULT_LLM_TIMEOUT_MS, MAX_RETRY_ATTEMPTS, RETRY_DELAYS_MS, RATE_LIMIT_RETRY_DELAYS_MS, isRateLimitError, getRateLimitRetryDelay } from "./base-llm-client.js";
+import { sleep } from "../utils/sleep.js";
+import { LLMError } from "../utils/errors.js";
+// ─── Constants ───
+const DEFAULT_MODEL = "qwen3:4b";
+const DEFAULT_TEMPERATURE = 0;
+/**
+ * LLM client for Ollama's OpenAI-compatible API.
+ * Uses native fetch (Node 18+) — no extra dependencies.
+ *
+ * Set PULSEED_LLM_PROVIDER=ollama to activate via CLIRunner.
+ * Optionally set OLLAMA_BASE_URL and OLLAMA_MODEL to configure.
+ */
+export class OllamaLLMClient extends BaseLLMClient {
+    baseUrl;
+    model;
+    constructor(config) {
+        super();
+        this.baseUrl = config.baseUrl.replace(/\/$/, ""); // strip trailing slash
+        this.model = config.model ?? DEFAULT_MODEL;
+        this.lightModel = config.lightModel;
+    }
+    /**
+     * Send a message to Ollama's OpenAI-compatible chat completions endpoint.
+     * Retries up to MAX_RETRY_ATTEMPTS times with exponential backoff on network errors.
+     * Retries up to RATE_LIMIT_RETRY_DELAYS_MS.length times on HTTP 429 with extended backoff.
+     */
+    async sendMessage(messages, options) {
+        const model = this.resolveEffectiveModel(options?.model ?? this.model, options?.model_tier);
+        const max_tokens = options?.max_tokens ?? DEFAULT_MAX_TOKENS;
+        const temperature = options?.temperature ?? DEFAULT_TEMPERATURE;
+        const system = options?.system;
+        // Build OpenAI-format messages array
+        const openAiMessages = [];
+        if (system) {
+            openAiMessages.push({ role: "system", content: system });
+        }
+        for (const msg of messages) {
+            openAiMessages.push({ role: msg.role, content: msg.content });
+        }
+        const body = JSON.stringify({
+            model,
+            messages: openAiMessages,
+            max_tokens,
+            temperature,
+            stream: false,
+        });
+        const url = `${this.baseUrl}/v1/chat/completions`;
+        let lastError;
+        let normalAttempts = 0;
+        let rateLimitAttempts = 0;
+        while (normalAttempts < MAX_RETRY_ATTEMPTS) {
+            try {
+                const controller = new AbortController();
+                const timeoutId = setTimeout(() => controller.abort(), DEFAULT_LLM_TIMEOUT_MS);
+                let response;
+                try {
+                    response = await fetch(url, {
+                        method: "POST",
+                        headers: {
+                            "Content-Type": "application/json",
+                        },
+                        body,
+                        signal: controller.signal,
+                    });
+                }
+                finally {
+                    clearTimeout(timeoutId);
+                }
+                if (!response.ok) {
+                    const errorText = await response.text().catch(() => "(no body)");
+                    throw new LLMError(`OllamaLLMClient: HTTP ${response.status} ${response.statusText} — ${errorText}`);
+                }
+                const data = (await response.json());
+                const choice = data.choices?.[0];
+                const content = choice?.message?.content ?? "";
+                const stop_reason = choice?.finish_reason ?? "unknown";
+                return {
+                    content,
+                    usage: {
+                        input_tokens: data.usage?.prompt_tokens ?? 0,
+                        output_tokens: data.usage?.completion_tokens ?? 0,
+                    },
+                    stop_reason,
+                };
+            }
+            catch (err) {
+                lastError = err;
+                // Rate limit: retry with extended backoff (does not count against normalAttempts)
+                if (isRateLimitError(err) && rateLimitAttempts < RATE_LIMIT_RETRY_DELAYS_MS.length) {
+                    await sleep(getRateLimitRetryDelay(err, rateLimitAttempts));
+                    rateLimitAttempts++;
+                    continue;
+                }
+                // Only retry on network/fetch errors, not on HTTP 4xx client errors (excluding 429)
+                const isNetworkError = err instanceof TypeError ||
+                    (err instanceof Error &&
+                        !err.message.startsWith("OllamaLLMClient: HTTP 4"));
+                normalAttempts++;
+                if (normalAttempts < MAX_RETRY_ATTEMPTS && isNetworkError) {
+                    await sleep(RETRY_DELAYS_MS[normalAttempts - 1] ?? 1000);
+                }
+                else if (!isNetworkError) {
+                    throw err;
+                }
+            }
+        }
+        throw lastError;
+    }
+}
+//# sourceMappingURL=ollama-client.js.map

package/dist/base/llm/ollama-client.js.map

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

package/dist/base/llm/openai-client.d.ts

@@ -0,0 +1,37 @@
+import { BaseLLMClient } from "./base-llm-client.js";
+import { type ILLMClient, type LLMMessage, type LLMRequestOptions, type LLMResponse } from "./llm-client.js";
+export interface OpenAIClientConfig {
+    /** API key for OpenAI. Required. */
+    apiKey?: string;
+    /** Default: "gpt-4o" */
+    model?: string;
+    /** Optional base URL for Azure OpenAI or proxy endpoints */
+    baseURL?: string;
+    /** Optional lighter model for routine tasks (observation, verification, etc.) */
+    lightModel?: string;
+}
+/**
+ * LLM client for OpenAI.
+ *
+ * Primary path: Chat Completions API.
+ * Fallback: Responses API when the selected model is not compatible with
+ * /v1/chat/completions (e.g., some Codex-style models).
+ *
+ * Set PULSEED_LLM_PROVIDER=openai to activate via CLIRunner.
+ * Optionally set OPENAI_API_KEY, OPENAI_MODEL, and OPENAI_BASE_URL to configure.
+ */
+export declare class OpenAILLMClient extends BaseLLMClient implements ILLMClient {
+    private readonly client;
+    private readonly model;
+    constructor(config?: OpenAIClientConfig);
+    /**
+     * Send a message to the OpenAI chat completions API with retry logic.
+     * Retries up to MAX_RETRY_ATTEMPTS times with exponential backoff on network errors.
+     * Retries up to RATE_LIMIT_RETRY_DELAYS_MS.length times on HTTP 429 with extended backoff.
+     *
+     * For reasoning models (o1, o3, o4), temperature is omitted as it is not supported.
+     * System prompt is sent as a "developer" role message, prepended to the messages array.
+     */
+    sendMessage(messages: LLMMessage[], options?: LLMRequestOptions): Promise<LLMResponse>;
+}
+//# sourceMappingURL=openai-client.d.ts.map

package/dist/base/llm/openai-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-client.d.ts","sourceRoot":"","sources":["../../../src/base/llm/openai-client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAyJ,MAAM,sBAAsB,CAAC;AAC5M,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAkB7G,MAAM,WAAW,kBAAkB;IACjC,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,qBAAa,eAAgB,SAAQ,aAAc,YAAW,UAAU;IACtE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,MAAM,GAAE,kBAAuB;IAe3C;;;;;;;OAOG;IACG,WAAW,CACf,QAAQ,EAAE,UAAU,EAAE,EACtB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,WAAW,CAAC;CA4HxB"}

package/dist/base/llm/openai-client.js

@@ -0,0 +1,156 @@
+import OpenAI from "openai";
+import { BaseLLMClient, DEFAULT_MAX_TOKENS, DEFAULT_LLM_TIMEOUT_MS, MAX_RETRY_ATTEMPTS, RETRY_DELAYS_MS, RATE_LIMIT_RETRY_DELAYS_MS, isRateLimitError, getRateLimitRetryDelay } from "./base-llm-client.js";
+import { sleep } from "../utils/sleep.js";
+import { LLMError } from "../utils/errors.js";
+// ─── Constants ───
+const DEFAULT_MODEL = "gpt-4o";
+const DEFAULT_TEMPERATURE = 0.2;
+/** Model prefixes that do not support the temperature parameter */
+const REASONING_MODEL_PREFIXES = ["o1", "o3", "o4"];
+function isReasoningModel(model) {
+    return REASONING_MODEL_PREFIXES.some((prefix) => model.startsWith(prefix));
+}
+/**
+ * LLM client for OpenAI.
+ *
+ * Primary path: Chat Completions API.
+ * Fallback: Responses API when the selected model is not compatible with
+ * /v1/chat/completions (e.g., some Codex-style models).
+ *
+ * Set PULSEED_LLM_PROVIDER=openai to activate via CLIRunner.
+ * Optionally set OPENAI_API_KEY, OPENAI_MODEL, and OPENAI_BASE_URL to configure.
+ */
+export class OpenAILLMClient extends BaseLLMClient {
+    client;
+    model;
+    constructor(config = {}) {
+        super();
+        if (!config.apiKey) {
+            throw new LLMError("OpenAILLMClient: no API key provided. Pass apiKey to constructor.");
+        }
+        this.model = config.model ?? DEFAULT_MODEL;
+        this.client = new OpenAI({
+            apiKey: config.apiKey,
+            ...(config.baseURL ? { baseURL: config.baseURL } : {}),
+        });
+        this.lightModel = config.lightModel;
+    }
+    /**
+     * Send a message to the OpenAI chat completions API with retry logic.
+     * Retries up to MAX_RETRY_ATTEMPTS times with exponential backoff on network errors.
+     * Retries up to RATE_LIMIT_RETRY_DELAYS_MS.length times on HTTP 429 with extended backoff.
+     *
+     * For reasoning models (o1, o3, o4), temperature is omitted as it is not supported.
+     * System prompt is sent as a "developer" role message, prepended to the messages array.
+     */
+    async sendMessage(messages, options) {
+        const model = this.resolveEffectiveModel(options?.model ?? this.model, options?.model_tier);
+        const max_tokens = options?.max_tokens ?? DEFAULT_MAX_TOKENS;
+        const temperature = options?.temperature ?? DEFAULT_TEMPERATURE;
+        const system = options?.system;
+        // Build OpenAI messages array
+        const openAiMessages = [];
+        if (system) {
+            openAiMessages.push({ role: "developer", content: system });
+        }
+        for (const msg of messages) {
+            openAiMessages.push({ role: msg.role, content: msg.content });
+        }
+        // Reasoning models do not accept the temperature parameter
+        const createParams = {
+            model,
+            messages: openAiMessages,
+            max_completion_tokens: max_tokens,
+            ...(isReasoningModel(model) ? {} : { temperature }),
+        };
+        let lastError;
+        let normalAttempts = 0;
+        let rateLimitAttempts = 0;
+        while (normalAttempts < MAX_RETRY_ATTEMPTS) {
+            try {
+                try {
+                    const response = await this.client.chat.completions.create(createParams, { timeout: DEFAULT_LLM_TIMEOUT_MS });
+                    const choice = response.choices[0];
+                    const content = choice?.message.content ?? "";
+                    const stop_reason = choice?.finish_reason ?? "unknown";
+                    return {
+                        content,
+                        usage: {
+                            input_tokens: response.usage?.prompt_tokens ?? 0,
+                            output_tokens: response.usage?.completion_tokens ?? 0,
+                        },
+                        stop_reason,
+                    };
+                }
+                catch (err) {
+                    // Some models (notably Codex-style) are not compatible with the
+                    // chat completions endpoint. In that case, fall back to Responses API.
+                    const msg = err instanceof Error ? err.message : String(err);
+                    const shouldFallback = msg.includes("not a chat model") ||
+                        msg.includes("v1/chat/completions") ||
+                        msg.includes("Did you mean to use v1/completions");
+                    if (!shouldFallback)
+                        throw err;
+                    const input = [
+                        system ? `SYSTEM:\n${system}` : null,
+                        ...messages.map((m) => `${m.role.toUpperCase()}:\n${m.content}`),
+                    ]
+                        .filter(Boolean)
+                        .join("\n\n");
+                    // Use Responses API (SDK supports this as of openai v4+).
+                    // The TypeScript types for the Responses API are not yet in the openai
+                    // package typings, so we cast through unknown to access this endpoint.
+                    const responsesApi = this.client.responses;
+                    let timer;
+                    const timeout = new Promise((_, reject) => {
+                        timer = setTimeout(() => reject(new LLMError(`OpenAILLMClient: Responses API timed out after ${DEFAULT_LLM_TIMEOUT_MS}ms`)), DEFAULT_LLM_TIMEOUT_MS);
+                    });
+                    const resp = await Promise.race([
+                        responsesApi.create({
+                            model,
+                            input,
+                            max_output_tokens: max_tokens,
+                            ...(isReasoningModel(model) ? {} : { temperature }),
+                        }),
+                        timeout,
+                    ]);
+                    clearTimeout(timer);
+                    const content = typeof resp["output_text"] === "string"
+                        ? resp["output_text"]
+                        : "";
+                    const usage = resp["usage"];
+                    return {
+                        content,
+                        usage: {
+                            input_tokens: typeof usage?.["input_tokens"] === "number" ? usage["input_tokens"] : 0,
+                            output_tokens: typeof usage?.["output_tokens"] === "number" ? usage["output_tokens"] : 0,
+                        },
+                        stop_reason: typeof resp["status"] === "string" ? resp["status"] : "unknown",
+                    };
+                }
+            }
+            catch (err) {
+                lastError = err;
+                // Rate limit: retry with extended backoff (does not count against normalAttempts)
+                if (isRateLimitError(err) && rateLimitAttempts < RATE_LIMIT_RETRY_DELAYS_MS.length) {
+                    await sleep(getRateLimitRetryDelay(err, rateLimitAttempts));
+                    rateLimitAttempts++;
+                    continue;
+                }
+                // Only retry on network/transient errors, not on HTTP 4xx client errors (excluding 429)
+                const isNetworkError = err instanceof TypeError ||
+                    (err instanceof Error &&
+                        !err.message.startsWith("OpenAILLMClient: HTTP 4"));
+                normalAttempts++;
+                if (normalAttempts < MAX_RETRY_ATTEMPTS && isNetworkError) {
+                    await sleep(RETRY_DELAYS_MS[normalAttempts - 1] ?? 1000);
+                }
+                else if (!isNetworkError) {
+                    throw err;
+                }
+            }
+        }
+        throw lastError;
+    }
+}
+//# sourceMappingURL=openai-client.js.map

package/dist/base/llm/openai-client.js.map

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

package/dist/base/llm/provider-config.d.ts

@@ -0,0 +1,102 @@
+/** Check if a JWT access token is expired. Returns true if malformed or expired. */
+export declare function isJwtExpired(token: string): boolean;
+/** Read the OAuth access_token from ~/.codex/auth.json (written by `codex auth login`). */
+export declare function readCodexOAuthToken(): Promise<string | undefined>;
+/**
+ * Known models and their compatible providers/adapters.
+ * Ollama models are dynamic and not listed here.
+ */
+export declare const MODEL_REGISTRY: Record<string, {
+    provider: string;
+    adapters: string[];
+}>;
+export interface ProviderConfig {
+    /** Which provider to use for internal LLM calls */
+    provider: "openai" | "anthropic" | "ollama";
+    /** Which model to use */
+    model: string;
+    /** Optional lighter model for routine tasks (observation, verification, reflection).
+     *  When not set, all calls use `model`. */
+    light_model?: string;
+    /** Which adapter to use by default for task execution */
+    adapter: "claude_code_cli" | "claude_api" | "openai_codex_cli" | "openai_api";
+    /** API key (for openai or anthropic) */
+    api_key?: string;
+    /** Base URL (for ollama or custom endpoints) */
+    base_url?: string;
+    /** CLI path for openai_codex_cli adapter */
+    codex_cli_path?: string;
+    /** A2A protocol agent endpoints */
+    a2a?: {
+        agents?: Record<string, {
+            base_url: string;
+            auth_token?: string;
+            capabilities?: string[];
+            prefer_streaming?: boolean;
+            poll_interval_ms?: number;
+            max_wait_ms?: number;
+        }>;
+    };
+    /** OpenClaw ACP adapter configuration */
+    openclaw?: {
+        cli_path?: string;
+        profile?: string;
+        model?: string;
+        work_dir?: string;
+    };
+}
+/** Old nested provider config format (for migration) */
+interface LegacyProviderConfig {
+    llm_provider: "anthropic" | "openai" | "ollama" | "codex";
+    default_adapter: "claude_code_cli" | "claude_api" | "openai_codex_cli" | "openai_api";
+    anthropic?: {
+        api_key?: string;
+        model?: string;
+    };
+    openai?: {
+        api_key?: string;
+        model?: string;
+        base_url?: string;
+    };
+    ollama?: {
+        base_url?: string;
+        model?: string;
+    };
+    codex?: {
+        cli_path?: string;
+        model?: string;
+    };
+    a2a?: ProviderConfig["a2a"];
+}
+declare const DEFAULT_PROVIDER_CONFIG: ProviderConfig;
+/**
+ * Migrate old nested format to new flat format.
+ */
+export declare function migrateProviderConfig(old: LegacyProviderConfig): ProviderConfig;
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+/**
+ * Validate provider config for model/adapter compatibility and required fields.
+ * Logs warnings but does not throw — allows unknown models for flexibility.
+ */
+export declare function validateProviderConfig(config: ProviderConfig): ValidationResult;
+/**
+ * Load provider configuration.
+ *
+ * Priority (highest to lowest):
+ *   1. Environment variables (PULSEED_PROVIDER, PULSEED_ADAPTER, PULSEED_MODEL, etc.)
+ *   2. ~/.pulseed/provider.json
+ *   3. Defaults (openai + gpt-5.4-mini + openai_codex_cli)
+ *
+ * Auto-migrates old nested format to new flat format.
+ */
+export declare function loadProviderConfig(): Promise<ProviderConfig>;
+/**
+ * Save provider configuration to ~/.pulseed/provider.json.
+ * Creates the ~/.pulseed directory if it does not exist.
+ */
+export declare function saveProviderConfig(config: ProviderConfig): Promise<void>;
+export { DEFAULT_PROVIDER_CONFIG };
+//# sourceMappingURL=provider-config.d.ts.map

package/dist/base/llm/provider-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-config.d.ts","sourceRoot":"","sources":["../../../src/base/llm/provider-config.ts"],"names":[],"mappings":"AAcA,oFAAoF;AACpF,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAUnD;AAED,2FAA2F;AAC3F,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAevE;AAID;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAOnF,CAAC;AAIF,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,QAAQ,EAAE,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;IAE5C,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IAEd;+CAC2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,yDAAyD;IACzD,OAAO,EAAE,iBAAiB,GAAG,YAAY,GAAG,kBAAkB,GAAG,YAAY,CAAC;IAE9E,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,4CAA4C;IAC5C,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,mCAAmC;IACnC,GAAG,CAAC,EAAE;QACJ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;YACtB,QAAQ,EAAE,MAAM,CAAC;YACjB,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;YACxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;YAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;YAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;SACtB,CAAC,CAAC;KACJ,CAAC;IAEF,yCAAyC;IACzC,QAAQ,CAAC,EAAE;QACT,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,wDAAwD;AACxD,UAAU,oBAAoB;IAC5B,YAAY,EAAE,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC1D,eAAe,EAAE,iBAAiB,GAAG,YAAY,GAAG,kBAAkB,GAAG,YAAY,CAAC;IACtF,SAAS,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,MAAM,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjE,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,GAAG,CAAC,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC;CAC7B;AAMD,QAAA,MAAM,uBAAuB,EAAE,cAI9B,CAAC;AAyBF;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,oBAAoB,GAAG,cAAc,CA0C/E;AAID,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,cAAc,GAAG,gBAAgB,CAyB/E;AAuFD;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,cAAc,CAAC,CAkFlE;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9E;AAGD,OAAO,EAAE,uBAAuB,EAAE,CAAC"}