pulseed 0.0.1 → 0.1.0

package/dist/llm/provider-config.js

@@ -0,0 +1,280 @@
+// ─── Provider Configuration ───
+//
+// Pluggable provider configuration system for PulSeed.
+// Reads/writes ~/.pulseed/provider.json to configure which LLM provider
+// and default adapter to use. Env vars always take precedence over config file.
+import * as fsp from "node:fs/promises";
+import * as path from "node:path";
+import { getPulseedDirPath } from "../utils/paths.js";
+import { writeJsonFileAtomic } from "../utils/json-io.js";
+// ─── Model Registry ───
+/**
+ * Known models and their compatible providers/adapters.
+ * Ollama models are dynamic and not listed here.
+ */
+export const MODEL_REGISTRY = {
+    "gpt-5.4-mini": { provider: "openai", adapters: ["openai_codex_cli", "openai_api"] },
+    "gpt-4.1": { provider: "openai", adapters: ["openai_codex_cli", "openai_api"] },
+    "gpt-4o-mini": { provider: "openai", adapters: ["openai_api"] },
+    "o3-mini": { provider: "openai", adapters: ["openai_api"] },
+    "claude-sonnet-4-6": { provider: "anthropic", adapters: ["claude_code_cli", "claude_api"] },
+    "claude-haiku-4-5": { provider: "anthropic", adapters: ["claude_code_cli", "claude_api"] },
+};
+// ─── Constants ───
+const PROVIDER_CONFIG_PATH = path.join(getPulseedDirPath(), "provider.json");
+const DEFAULT_PROVIDER_CONFIG = {
+    provider: "openai",
+    model: "gpt-5.4-mini",
+    adapter: "openai_codex_cli",
+};
+// Track whether we've already warned about provider config issues in this process
+let _warnedOnce = false;
+// ─── Helpers ───
+/** Default model for a given provider. Single source of truth. */
+function defaultModelForProvider(provider) {
+    switch (provider) {
+        case "anthropic": return "claude-sonnet-4-6";
+        case "ollama": return "qwen3:4b";
+        default: return "gpt-5.4-mini";
+    }
+}
+// ─── Migration ───
+/**
+ * Detect whether a config object is in the old nested format.
+ */
+function isLegacyConfig(config) {
+    return "llm_provider" in config || "default_adapter" in config;
+}
+/**
+ * Migrate old nested format to new flat format.
+ */
+export function migrateProviderConfig(old) {
+    const provider = old.llm_provider === "codex" ? "openai" : (old.llm_provider ?? "openai");
+    // Resolve model from the provider-specific section
+    let model;
+    switch (old.llm_provider) {
+        case "codex":
+            model = old.codex?.model ?? old.openai?.model ?? defaultModelForProvider(provider);
+            break;
+        case "openai":
+            model = old.openai?.model ?? defaultModelForProvider(provider);
+            break;
+        case "anthropic":
+            model = old.anthropic?.model ?? defaultModelForProvider(provider);
+            break;
+        case "ollama":
+            model = old.ollama?.model ?? defaultModelForProvider(provider);
+            break;
+        default:
+            model = defaultModelForProvider(provider);
+    }
+    const adapter = old.default_adapter ?? "openai_codex_cli";
+    // Resolve api_key from the active provider section
+    const api_key = old.llm_provider === "anthropic"
+        ? old.anthropic?.api_key
+        : (old.openai?.api_key);
+    // Resolve base_url
+    const base_url = old.llm_provider === "ollama"
+        ? old.ollama?.base_url
+        : old.openai?.base_url;
+    const result = { provider, model, adapter };
+    if (api_key !== undefined)
+        result.api_key = api_key;
+    if (base_url !== undefined)
+        result.base_url = base_url;
+    if (old.codex?.cli_path !== undefined)
+        result.codex_cli_path = old.codex.cli_path;
+    if (old.a2a !== undefined)
+        result.a2a = old.a2a;
+    return result;
+}
+/**
+ * Validate provider config for model/adapter compatibility and required fields.
+ * Logs warnings but does not throw — allows unknown models for flexibility.
+ */
+export function validateProviderConfig(config) {
+    const errors = [];
+    // Check model-adapter compatibility (skip for ollama or unknown models)
+    const registryEntry = MODEL_REGISTRY[config.model];
+    if (registryEntry) {
+        if (registryEntry.provider !== config.provider) {
+            errors.push(`Model "${config.model}" requires provider "${registryEntry.provider}" but got "${config.provider}"`);
+        }
+        if (!registryEntry.adapters.includes(config.adapter)) {
+            errors.push(`Model "${config.model}" is not compatible with adapter "${config.adapter}". Compatible: ${registryEntry.adapters.join(", ")}`);
+        }
+    }
+    // Check required api_key
+    if ((config.provider === "openai" || config.provider === "anthropic") && !config.api_key) {
+        const envName = config.provider === "openai" ? "OPENAI_API_KEY" : "ANTHROPIC_API_KEY";
+        errors.push(`API key required for provider "${config.provider}". Set ${envName} or add api_key to config.`);
+    }
+    return { valid: errors.length === 0, errors };
+}
+// ─── Env Var Resolution ───
+function resolveProvider(fileProvider) {
+    const envProvider = process.env["PULSEED_PROVIDER"] ?? process.env["PULSEED_LLM_PROVIDER"];
+    if (envProvider === "anthropic" || envProvider === "openai" || envProvider === "ollama") {
+        return envProvider;
+    }
+    // "codex" env var maps to "openai"
+    if (envProvider === "codex") {
+        return "openai";
+    }
+    return fileProvider ?? "openai";
+}
+function resolveAdapter(fileAdapter) {
+    const envAdapter = process.env["PULSEED_ADAPTER"] ?? process.env["PULSEED_DEFAULT_ADAPTER"];
+    if (envAdapter === "claude_code_cli" ||
+        envAdapter === "claude_api" ||
+        envAdapter === "openai_codex_cli" ||
+        envAdapter === "openai_api") {
+        return envAdapter;
+    }
+    return fileAdapter ?? "openai_codex_cli";
+}
+function resolveModel(fileModel, provider) {
+    const envModel = process.env["PULSEED_MODEL"];
+    if (envModel)
+        return envModel;
+    // provider.json explicit value takes priority over generic env vars
+    if (fileModel)
+        return fileModel;
+    // Provider-specific env vars apply only as fallback when model is not set in provider.json
+    if (provider === "openai") {
+        const m = process.env["OPENAI_MODEL"];
+        if (m)
+            return m;
+    }
+    else if (provider === "anthropic") {
+        const m = process.env["ANTHROPIC_MODEL"];
+        if (m)
+            return m;
+    }
+    else if (provider === "ollama") {
+        const m = process.env["OLLAMA_MODEL"];
+        if (m)
+            return m;
+    }
+    return defaultModelForProvider(provider);
+}
+function resolveApiKey(fileKey, provider) {
+    if (provider === "anthropic") {
+        return process.env["ANTHROPIC_API_KEY"] ?? fileKey;
+    }
+    // openai (and codex) both use OPENAI_API_KEY
+    if (provider === "openai") {
+        return process.env["OPENAI_API_KEY"] ?? fileKey;
+    }
+    return fileKey;
+}
+function resolveBaseUrl(fileUrl, provider) {
+    if (provider === "ollama") {
+        return process.env["OLLAMA_BASE_URL"] ?? fileUrl;
+    }
+    if (provider === "openai") {
+        return process.env["OPENAI_BASE_URL"] ?? fileUrl;
+    }
+    return fileUrl;
+}
+// ─── Public API ───
+/**
+ * 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 async function loadProviderConfig() {
+    let fileConfig = {};
+    let needsMigrationSave = false;
+    try {
+        await fsp.access(PROVIDER_CONFIG_PATH);
+        try {
+            const raw = await fsp.readFile(PROVIDER_CONFIG_PATH, "utf-8");
+            const parsed = JSON.parse(raw);
+            if (isLegacyConfig(parsed)) {
+                fileConfig = migrateProviderConfig(parsed);
+                needsMigrationSave = true;
+            }
+            else {
+                fileConfig = parsed;
+            }
+        }
+        catch {
+            fileConfig = {};
+        }
+    }
+    catch {
+        // File does not exist
+    }
+    const provider = resolveProvider(fileConfig.provider);
+    let model = resolveModel(fileConfig.model, provider);
+    const adapter = resolveAdapter(fileConfig.adapter);
+    // Auto-correct model-adapter incompatibility (e.g. OPENAI_MODEL=gpt-4o-mini with openai_codex_cli)
+    const registryEntry = MODEL_REGISTRY[model];
+    if (registryEntry && !registryEntry.adapters.includes(adapter)) {
+        const fallback = defaultModelForProvider(provider);
+        console.warn(`[provider-config] Model "${model}" is not compatible with adapter "${adapter}". Falling back to "${fallback}".`);
+        model = fallback;
+    }
+    const api_key = resolveApiKey(fileConfig.api_key, provider);
+    const base_url = resolveBaseUrl(fileConfig.base_url, provider);
+    const config = { provider, model, adapter };
+    if (api_key !== undefined)
+        config.api_key = api_key;
+    if (base_url !== undefined)
+        config.base_url = base_url;
+    if (fileConfig.codex_cli_path !== undefined)
+        config.codex_cli_path = fileConfig.codex_cli_path;
+    if (fileConfig.a2a !== undefined)
+        config.a2a = fileConfig.a2a;
+    if (fileConfig.light_model !== undefined)
+        config.light_model = fileConfig.light_model;
+    if (fileConfig.openclaw !== undefined)
+        config.openclaw = fileConfig.openclaw;
+    // Validate and log warnings (only once per process)
+    const validation = validateProviderConfig(config);
+    if (!validation.valid && !_warnedOnce) {
+        for (const err of validation.errors) {
+            console.warn(`[provider-config] Warning: ${err}`);
+        }
+        _warnedOnce = true;
+    }
+    // Auto-save migrated config (save file-only values, not env-var-resolved ones)
+    if (needsMigrationSave) {
+        try {
+            const fileOnly = {
+                provider: fileConfig.provider ?? "openai",
+                model: fileConfig.model ?? "gpt-5.4-mini",
+                adapter: fileConfig.adapter ?? "openai_codex_cli",
+            };
+            if (fileConfig.api_key !== undefined)
+                fileOnly.api_key = fileConfig.api_key;
+            if (fileConfig.base_url !== undefined)
+                fileOnly.base_url = fileConfig.base_url;
+            if (fileConfig.codex_cli_path !== undefined)
+                fileOnly.codex_cli_path = fileConfig.codex_cli_path;
+            if (fileConfig.a2a !== undefined)
+                fileOnly.a2a = fileConfig.a2a;
+            await saveProviderConfig(fileOnly);
+        }
+        catch {
+            // Best-effort — don't fail if we can't save
+        }
+    }
+    return config;
+}
+/**
+ * Save provider configuration to ~/.pulseed/provider.json.
+ * Creates the ~/.pulseed directory if it does not exist.
+ */
+export async function saveProviderConfig(config) {
+    await writeJsonFileAtomic(PROVIDER_CONFIG_PATH, config);
+}
+// Re-export default for tests that need it
+export { DEFAULT_PROVIDER_CONFIG };
+//# sourceMappingURL=provider-config.js.map

package/dist/llm/provider-config.js.map

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

package/dist/llm/provider-factory.d.ts

@@ -0,0 +1,24 @@
+import { type ILLMClient } from "./llm-client.js";
+import { AdapterRegistry } from "../execution/adapter-layer.js";
+import type { ProviderConfig } from "./provider-config.js";
+/**
+ * Build an LLM client based on provider configuration.
+ *
+ * Configuration priority (highest to lowest):
+ *   1. PULSEED_PROVIDER environment variable
+ *   2. ~/.pulseed/provider.json provider field
+ *   3. Default: OpenAI
+ *
+ * Providers:
+ *   - "anthropic" → LLMClient (api_key required)
+ *   - "openai"    → OpenAILLMClient or CodexLLMClient depending on adapter
+ *   - "ollama"    → OllamaLLMClient
+ */
+export declare function buildLLMClient(): Promise<ILLMClient>;
+/**
+ * Build an AdapterRegistry pre-populated with the standard adapters.
+ * Registers ClaudeCodeCLIAdapter, ClaudeAPIAdapter, OpenAICodexCLIAdapter, GitHubIssueAdapter,
+ * and any A2A agents configured in provider config or environment variables.
+ */
+export declare function buildAdapterRegistry(llmClient: ILLMClient, providerConfig?: ProviderConfig): Promise<AdapterRegistry>;
+//# sourceMappingURL=provider-factory.d.ts.map

package/dist/llm/provider-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-factory.d.ts","sourceRoot":"","sources":["../../src/llm/provider-factory.ts"],"names":[],"mappings":"AAKA,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAM7D,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAQhE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,UAAU,CAAC,CA6D1D;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,UAAU,EACrB,cAAc,CAAC,EAAE,cAAc,GAC9B,OAAO,CAAC,eAAe,CAAC,CAoD1B"}

package/dist/llm/provider-factory.js

@@ -0,0 +1,135 @@
+// ─── Provider Factory ───
+//
+// Shared factory helpers for building LLM clients and adapter registries.
+// Used by both CLIRunner and TUI entry to avoid duplicating wiring logic.
+import { LLMClient } from "./llm-client.js";
+import { LLMError } from "../utils/errors.js";
+import { OllamaLLMClient } from "./ollama-client.js";
+import { OpenAILLMClient } from "./openai-client.js";
+import { CodexLLMClient } from "./codex-llm-client.js";
+import { loadProviderConfig } from "./provider-config.js";
+import { AdapterRegistry } from "../execution/adapter-layer.js";
+import { ClaudeCodeCLIAdapter } from "../adapters/claude-code-cli.js";
+import { ClaudeAPIAdapter } from "../adapters/claude-api.js";
+import { OpenAICodexCLIAdapter } from "../adapters/openai-codex.js";
+import { GitHubIssueAdapter } from "../adapters/github-issue.js";
+import { A2AAdapter } from "../adapters/a2a-adapter.js";
+import { BrowserUseCLIAdapter } from "../adapters/browser-use-cli.js";
+import { OpenClawACPAdapter } from "../adapters/openclaw-acp.js";
+/**
+ * Build an LLM client based on provider configuration.
+ *
+ * Configuration priority (highest to lowest):
+ *   1. PULSEED_PROVIDER environment variable
+ *   2. ~/.pulseed/provider.json provider field
+ *   3. Default: OpenAI
+ *
+ * Providers:
+ *   - "anthropic" → LLMClient (api_key required)
+ *   - "openai"    → OpenAILLMClient or CodexLLMClient depending on adapter
+ *   - "ollama"    → OllamaLLMClient
+ */
+export async function buildLLMClient() {
+    const config = await loadProviderConfig();
+    switch (config.provider) {
+        case "openai": {
+            // Use CodexLLMClient when adapter is openai_codex_cli
+            if (config.adapter === "openai_codex_cli") {
+                if (!config.api_key) {
+                    throw new LLMError("OPENAI_API_KEY is not set.\nSet it via: export OPENAI_API_KEY=sk-...");
+                }
+                return new CodexLLMClient({
+                    cliPath: config.codex_cli_path,
+                    model: config.model,
+                    lightModel: config.light_model,
+                });
+            }
+            // Otherwise use OpenAILLMClient
+            if (!config.api_key) {
+                throw new LLMError("OPENAI_API_KEY is not set.\nSet it via: export OPENAI_API_KEY=sk-...");
+            }
+            return new OpenAILLMClient({
+                apiKey: config.api_key,
+                model: config.model,
+                baseURL: config.base_url,
+                lightModel: config.light_model,
+            });
+        }
+        case "ollama":
+            return new OllamaLLMClient({
+                baseUrl: config.base_url ?? "http://localhost:11434",
+                model: config.model ?? "qwen3:4b",
+                lightModel: config.light_model,
+            });
+        case "anthropic":
+            if (!config.api_key) {
+                throw new LLMError("ANTHROPIC_API_KEY is not set.\nSet it via: export ANTHROPIC_API_KEY=sk-ant-...");
+            }
+            return new LLMClient(config.api_key, undefined, config.light_model);
+        default:
+            // Unknown provider falls back to OpenAI
+            if (!config.api_key) {
+                throw new LLMError("OPENAI_API_KEY is not set.\nSet it via: export OPENAI_API_KEY=sk-...");
+            }
+            return new OpenAILLMClient({
+                apiKey: config.api_key,
+                model: config.model,
+                baseURL: config.base_url,
+                lightModel: config.light_model,
+            });
+    }
+}
+/**
+ * Build an AdapterRegistry pre-populated with the standard adapters.
+ * Registers ClaudeCodeCLIAdapter, ClaudeAPIAdapter, OpenAICodexCLIAdapter, GitHubIssueAdapter,
+ * and any A2A agents configured in provider config or environment variables.
+ */
+export async function buildAdapterRegistry(llmClient, providerConfig) {
+    const registry = new AdapterRegistry();
+    registry.register(new ClaudeCodeCLIAdapter());
+    registry.register(new ClaudeAPIAdapter(llmClient));
+    registry.register(new OpenAICodexCLIAdapter());
+    registry.register(new GitHubIssueAdapter());
+    registry.register(new BrowserUseCLIAdapter());
+    // Register A2A agents from config
+    const config = providerConfig ?? await loadProviderConfig();
+    if (config.a2a?.agents) {
+        for (const [name, agentConfig] of Object.entries(config.a2a.agents)) {
+            registry.register(new A2AAdapter({
+                adapterType: name.startsWith("a2a") ? name : `a2a_${name}`,
+                baseUrl: agentConfig.base_url,
+                authToken: agentConfig.auth_token,
+                capabilities: agentConfig.capabilities,
+                preferStreaming: agentConfig.prefer_streaming,
+                pollIntervalMs: agentConfig.poll_interval_ms,
+                maxWaitMs: agentConfig.max_wait_ms,
+            }));
+        }
+    }
+    // Single-agent env var shortcut
+    const envBaseUrl = process.env["PULSEED_A2A_BASE_URL"];
+    if (envBaseUrl && !config.a2a?.agents) {
+        registry.register(new A2AAdapter({
+            baseUrl: envBaseUrl,
+            authToken: process.env["PULSEED_A2A_AUTH_TOKEN"],
+        }));
+    }
+    // OpenClaw from provider config
+    if (config.openclaw) {
+        registry.register(new OpenClawACPAdapter({
+            cliPath: config.openclaw.cli_path,
+            profile: config.openclaw.profile,
+            model: config.openclaw.model,
+            workDir: config.openclaw.work_dir,
+        }));
+    }
+    // Environment variable shortcut
+    if (process.env["PULSEED_OPENCLAW_CLI_PATH"] && !config.openclaw) {
+        registry.register(new OpenClawACPAdapter({
+            cliPath: process.env["PULSEED_OPENCLAW_CLI_PATH"],
+            profile: process.env["PULSEED_OPENCLAW_PROFILE"],
+        }));
+    }
+    return registry;
+}
+//# sourceMappingURL=provider-factory.js.map

package/dist/llm/provider-factory.js.map

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

package/dist/llm-client.d.ts

@@ -0,0 +1,65 @@
+import type { ZodSchema } from "zod";
+export interface LLMMessage {
+    role: "user" | "assistant";
+    content: string;
+}
+export interface LLMRequestOptions {
+    model?: string;
+    max_tokens?: number;
+    system?: string;
+    temperature?: number;
+}
+export interface LLMResponse {
+    content: string;
+    usage: {
+        input_tokens: number;
+        output_tokens: number;
+    };
+    stop_reason: string;
+}
+export interface ILLMClient {
+    sendMessage(messages: LLMMessage[], options?: LLMRequestOptions): Promise<LLMResponse>;
+    parseJSON<T>(content: string, schema: ZodSchema<T>): T;
+}
+/**
+ * Extract JSON from a string that may contain markdown code blocks.
+ * Tries ```json ... ``` first, then ``` ... ```, then bare JSON.
+ */
+export declare function extractJSON(text: string): string;
+/**
+ * Thin wrapper around the Anthropic SDK.
+ * Provides retry logic and JSON extraction/validation.
+ *
+ * Constructor throws if no API key is available (no param, no env var).
+ */
+export declare class LLMClient implements ILLMClient {
+    private readonly client;
+    constructor(apiKey?: string);
+    /**
+     * Send a message to the Anthropic API with retry logic.
+     * Retries up to MAX_RETRY_ATTEMPTS times with exponential backoff.
+     */
+    sendMessage(messages: LLMMessage[], options?: LLMRequestOptions): Promise<LLMResponse>;
+    /**
+     * Extract JSON from LLM response text (handles markdown code blocks)
+     * and validate against the given Zod schema.
+     * Throws on parse failure or schema validation failure.
+     */
+    parseJSON<T>(content: string, schema: ZodSchema<T>): T;
+}
+/**
+ * Mock implementation for testing.
+ * Returns provided responses in order, tracking call count.
+ */
+export declare class MockLLMClient implements ILLMClient {
+    private readonly responses;
+    private _callCount;
+    constructor(responses: string[]);
+    get callCount(): number;
+    sendMessage(_messages: LLMMessage[], _options?: LLMRequestOptions): Promise<LLMResponse>;
+    /**
+     * Delegates to real JSON extraction and Zod validation.
+     */
+    parseJSON<T>(content: string, schema: ZodSchema<T>): T;
+}
+//# sourceMappingURL=llm-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"llm-client.d.ts","sourceRoot":"","sources":["../src/llm-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAIrC,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE;QACL,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,WAAW,EAAE,MAAM,CAAC;CACrB;AAID,MAAM,WAAW,UAAU;IACzB,WAAW,CACT,QAAQ,EAAE,UAAU,EAAE,EACtB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,WAAW,CAAC,CAAC;IACxB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;CACxD;AAkBD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAehD;AAID;;;;;GAKG;AACH,qBAAa,SAAU,YAAW,UAAU;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;gBAEvB,MAAM,CAAC,EAAE,MAAM;IAU3B;;;OAGG;IACG,WAAW,CACf,QAAQ,EAAE,UAAU,EAAE,EACtB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,WAAW,CAAC;IA2CvB;;;;OAIG;IACH,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC;CAYvD;AAID;;;GAGG;AACH,qBAAa,aAAc,YAAW,UAAU;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,OAAO,CAAC,UAAU,CAAa;gBAEnB,SAAS,EAAE,MAAM,EAAE;IAI/B,IAAI,SAAS,IAAI,MAAM,CAEtB;IAEK,WAAW,CACf,SAAS,EAAE,UAAU,EAAE,EACvB,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,OAAO,CAAC,WAAW,CAAC;IAsBvB;;OAEG;IACH,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC;CAYvD"}