@jclaw/core 0.1.0

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

@@ -0,0 +1,108 @@
+/**
+ * LLM Client
+ *
+ * Provides a generic interface for LLM API calls.
+ * Supports OpenAI-compatible APIs and can be extended for other providers.
+ *
+ * @module @jclaw/core/runtime/llm-client
+ */
+/**
+ * Configuration for LLM client
+ */
+export interface LLMClientConfig {
+    /** API endpoint URL */
+    apiBase: string;
+    /** API key for authentication */
+    apiKey: string;
+    /** Model identifier */
+    model: string;
+    /** Request timeout in milliseconds (default: 60000) */
+    timeout?: number;
+    /** Maximum tokens in response (default: 4096) */
+    maxTokens?: number;
+    /** Temperature for sampling (default: 0.7) */
+    temperature?: number;
+}
+/**
+ * Message structure for chat completions
+ */
+export interface ChatMessage {
+    /** Role of the message sender */
+    role: 'system' | 'user' | 'assistant';
+    /** Content of the message */
+    content: string;
+}
+/**
+ * Response from LLM completion
+ */
+export interface LLMResponse {
+    /** Generated text content */
+    content: string;
+    /** Model used for generation */
+    model: string;
+    /** Token usage statistics */
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    /** Duration of the request in milliseconds */
+    duration: number;
+}
+/**
+ * LLM Client for making API calls to language models.
+ *
+ * Supports OpenAI-compatible APIs and provides a unified interface
+ * for chat completions.
+ *
+ * @example
+ * ```typescript
+ * const client = new LLMClient({
+ *   apiBase: 'https://api.openai.com/v1',
+ *   apiKey: 'sk-...',
+ *   model: 'gpt-4'
+ * });
+ *
+ * const response = await client.chat([
+ *   { role: 'user', content: 'Hello!' }
+ * ]);
+ * ```
+ */
+export declare class LLMClient {
+    private readonly config;
+    /**
+     * Create a new LLM client instance.
+     *
+     * @param config - Configuration options including API credentials
+     */
+    constructor(config: LLMClientConfig);
+    /**
+     * Send a chat completion request to the LLM.
+     *
+     * @param messages - Array of chat messages
+     * @param options - Optional overrides for this specific request
+     * @returns Promise resolving to LLM response
+     * @throws Error if the API request fails
+     */
+    chat(messages: ChatMessage[], options?: Partial<Pick<LLMClientConfig, 'maxTokens' | 'temperature'>>): Promise<LLMResponse>;
+    /**
+     * Send a simple text prompt and get a response.
+     *
+     * @param prompt - The prompt text
+     * @param systemPrompt - Optional system prompt
+     * @returns Promise resolving to response content
+     */
+    complete(prompt: string, systemPrompt?: string): Promise<string>;
+    /**
+     * Get the configured model name.
+     */
+    get model(): string;
+}
+/**
+ * Create a new LLM client instance.
+ *
+ * @param config - Configuration options
+ * @returns New LLMClient instance
+ */
+export declare function createLLMClient(config: LLMClientConfig): LLMClient;
+//# sourceMappingURL=llm-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"llm-client.d.ts","sourceRoot":"","sources":["../../src/runtime/llm-client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,iCAAiC;IACjC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACtC,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,KAAK,CAAC,EAAE;QACN,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiE;IAExF;;;;OAIG;gBACS,MAAM,EAAE,eAAe;IASnC;;;;;;;OAOG;IACG,IAAI,CACR,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,WAAW,GAAG,aAAa,CAAC,CAAC,GACpE,OAAO,CAAC,WAAW,CAAC;IAuDvB;;;;;;OAMG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAatE;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;CACF;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAElE"}

package/dist/runtime/llm-client.js

@@ -0,0 +1,125 @@
+/**
+ * LLM Client
+ *
+ * Provides a generic interface for LLM API calls.
+ * Supports OpenAI-compatible APIs and can be extended for other providers.
+ *
+ * @module @jclaw/core/runtime/llm-client
+ */
+/**
+ * LLM Client for making API calls to language models.
+ *
+ * Supports OpenAI-compatible APIs and provides a unified interface
+ * for chat completions.
+ *
+ * @example
+ * ```typescript
+ * const client = new LLMClient({
+ *   apiBase: 'https://api.openai.com/v1',
+ *   apiKey: 'sk-...',
+ *   model: 'gpt-4'
+ * });
+ *
+ * const response = await client.chat([
+ *   { role: 'user', content: 'Hello!' }
+ * ]);
+ * ```
+ */
+export class LLMClient {
+    config;
+    /**
+     * Create a new LLM client instance.
+     *
+     * @param config - Configuration options including API credentials
+     */
+    constructor(config) {
+        this.config = {
+            timeout: 60000,
+            maxTokens: 4096,
+            temperature: 0.7,
+            ...config,
+        };
+    }
+    /**
+     * Send a chat completion request to the LLM.
+     *
+     * @param messages - Array of chat messages
+     * @param options - Optional overrides for this specific request
+     * @returns Promise resolving to LLM response
+     * @throws Error if the API request fails
+     */
+    async chat(messages, options) {
+        const startTime = Date.now();
+        try {
+            const response = await fetch(`${this.config.apiBase}/chat/completions`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${this.config.apiKey}`,
+                },
+                body: JSON.stringify({
+                    model: this.config.model,
+                    messages,
+                    max_tokens: options?.maxTokens ?? this.config.maxTokens,
+                    temperature: options?.temperature ?? this.config.temperature,
+                }),
+                signal: AbortSignal.timeout(this.config.timeout),
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new Error(`LLM API error: ${response.status} - ${errorText}`);
+            }
+            const data = (await response.json());
+            const content = data.choices[0]?.message?.content ?? '';
+            const duration = Date.now() - startTime;
+            return {
+                content,
+                model: data.model,
+                usage: data.usage
+                    ? {
+                        promptTokens: data.usage.prompt_tokens,
+                        completionTokens: data.usage.completion_tokens,
+                        totalTokens: data.usage.total_tokens,
+                    }
+                    : undefined,
+                duration,
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            throw new Error(`LLM request failed: ${message}`);
+        }
+    }
+    /**
+     * Send a simple text prompt and get a response.
+     *
+     * @param prompt - The prompt text
+     * @param systemPrompt - Optional system prompt
+     * @returns Promise resolving to response content
+     */
+    async complete(prompt, systemPrompt) {
+        const messages = [];
+        if (systemPrompt) {
+            messages.push({ role: 'system', content: systemPrompt });
+        }
+        messages.push({ role: 'user', content: prompt });
+        const response = await this.chat(messages);
+        return response.content;
+    }
+    /**
+     * Get the configured model name.
+     */
+    get model() {
+        return this.config.model;
+    }
+}
+/**
+ * Create a new LLM client instance.
+ *
+ * @param config - Configuration options
+ * @returns New LLMClient instance
+ */
+export function createLLMClient(config) {
+    return new LLMClient(config);
+}
+//# sourceMappingURL=llm-client.js.map

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

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

package/dist/runtime/task-executor.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Task Executor
+ *
+ * Manages task execution workflow including context retrieval,
+ * LLM interaction, and command execution.
+ *
+ * @module @jclaw/core/runtime/task-executor
+ */
+import type { Task, TaskResult, ContextManager, Executor } from '../types.js';
+import { LLMClient } from './llm-client.js';
+/**
+ * Configuration for task executor
+ */
+export interface TaskExecutorConfig {
+    /** LLM client for generating responses */
+    llmClient: LLMClient;
+    /** Context manager for knowledge retrieval */
+    contextManager?: ContextManager;
+    /** Command executor for running shell commands */
+    executor?: Executor;
+    /** System prompt for the agent */
+    systemPrompt?: string;
+    /** Maximum retries for failed tasks (default: 3) */
+    maxRetries?: number;
+    /** Enable verbose logging */
+    verbose?: boolean;
+}
+/**
+ * Task Executor
+ *
+ * Orchestrates task execution by:
+ * - Retrieving relevant context
+ * - Generating plans with LLM
+ * - Executing commands when needed
+ * - Handling errors and retries
+ *
+ * @example
+ * ```typescript
+ * const executor = new TaskExecutor({
+ *   llmClient: createLLMClient(config),
+ *   contextManager: openVikingClient,
+ *   executor: localExecutor
+ * });
+ *
+ * const result = await executor.execute({
+ *   id: 'task-1',
+ *   prompt: 'List all files in the current directory'
+ * });
+ * ```
+ */
+export declare class TaskExecutor {
+    private readonly config;
+    /**
+     * Create a new task executor instance.
+     *
+     * @param config - Configuration options
+     */
+    constructor(config: TaskExecutorConfig);
+    /**
+     * Execute a task and return the result.
+     *
+     * @param task - The task to execute
+     * @returns Promise resolving to task result
+     */
+    execute(task: Task): Promise<TaskResult>;
+    /**
+     * Internal method to execute a single task attempt.
+     */
+    private executeTask;
+    /**
+     * Extract shell commands from LLM response.
+     *
+     * Looks for commands in code blocks marked as shell/bash.
+     */
+    private extractCommands;
+    /**
+     * Log message if verbose mode is enabled.
+     */
+    private log;
+    /**
+     * Sleep for specified milliseconds.
+     */
+    private sleep;
+}
+/**
+ * Create a new task executor instance.
+ *
+ * @param config - Configuration options
+ * @returns New TaskExecutor instance
+ */
+export declare function createTaskExecutor(config: TaskExecutorConfig): TaskExecutor;
+//# sourceMappingURL=task-executor.d.ts.map

package/dist/runtime/task-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-executor.d.ts","sourceRoot":"","sources":["../../src/runtime/task-executor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAoB,MAAM,iBAAiB,CAAC;AAc9D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,0CAA0C;IAC1C,SAAS,EAAE,SAAS,CAAC;IACrB,8CAA8C;IAC9C,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,kDAAkD;IAClD,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,kCAAkC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAGrB;IAEF;;;;OAIG;gBACS,MAAM,EAAE,kBAAkB;IAStC;;;;;OAKG;IACG,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC;IAsC9C;;OAEG;YACW,WAAW;IAuEzB;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAiBvB;;OAEG;IACH,OAAO,CAAC,GAAG;IAMX;;OAEG;IACH,OAAO,CAAC,KAAK;CAGd;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY,CAE3E"}

package/dist/runtime/task-executor.js

@@ -0,0 +1,203 @@
+/**
+ * Task Executor
+ *
+ * Manages task execution workflow including context retrieval,
+ * LLM interaction, and command execution.
+ *
+ * @module @jclaw/core/runtime/task-executor
+ */
+/**
+ * System prompt for the agent
+ */
+const DEFAULT_SYSTEM_PROMPT = `You are JClaw, a self-evolving AI agent.
+You help users complete tasks by:
+1. Understanding their request
+2. Planning the necessary steps
+3. Executing commands when needed
+4. Reporting results clearly
+
+Always think step by step and explain your reasoning.`;
+/**
+ * Task Executor
+ *
+ * Orchestrates task execution by:
+ * - Retrieving relevant context
+ * - Generating plans with LLM
+ * - Executing commands when needed
+ * - Handling errors and retries
+ *
+ * @example
+ * ```typescript
+ * const executor = new TaskExecutor({
+ *   llmClient: createLLMClient(config),
+ *   contextManager: openVikingClient,
+ *   executor: localExecutor
+ * });
+ *
+ * const result = await executor.execute({
+ *   id: 'task-1',
+ *   prompt: 'List all files in the current directory'
+ * });
+ * ```
+ */
+export class TaskExecutor {
+    config;
+    /**
+     * Create a new task executor instance.
+     *
+     * @param config - Configuration options
+     */
+    constructor(config) {
+        this.config = {
+            systemPrompt: DEFAULT_SYSTEM_PROMPT,
+            maxRetries: 3,
+            verbose: false,
+            ...config,
+        };
+    }
+    /**
+     * Execute a task and return the result.
+     *
+     * @param task - The task to execute
+     * @returns Promise resolving to task result
+     */
+    async execute(task) {
+        const startTime = Date.now();
+        let attempts = 0;
+        let lastError;
+        while (attempts < this.config.maxRetries) {
+            attempts++;
+            try {
+                const output = await this.executeTask(task);
+                const duration = Date.now() - startTime;
+                return {
+                    taskId: task.id,
+                    success: true,
+                    output,
+                    duration,
+                };
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error.message : 'Unknown error';
+                this.log(`Attempt ${attempts} failed: ${lastError}`);
+                // Wait before retry (exponential backoff)
+                if (attempts < this.config.maxRetries) {
+                    await this.sleep(1000 * Math.pow(2, attempts - 1));
+                }
+            }
+        }
+        const duration = Date.now() - startTime;
+        return {
+            taskId: task.id,
+            success: false,
+            error: `Task failed after ${attempts} attempts. Last error: ${lastError}`,
+            duration,
+        };
+    }
+    /**
+     * Internal method to execute a single task attempt.
+     */
+    async executeTask(task) {
+        // Build messages array
+        const messages = [
+            { role: 'system', content: this.config.systemPrompt },
+        ];
+        // Add context if available
+        if (this.config.contextManager) {
+            try {
+                const context = await this.config.contextManager.query(task.prompt, { topK: 5 });
+                if (context) {
+                    messages.push({
+                        role: 'system',
+                        content: `Relevant context:\n${context}`,
+                    });
+                }
+            }
+            catch {
+                this.log('Warning: Failed to retrieve context');
+            }
+        }
+        // Add user prompt
+        messages.push({ role: 'user', content: task.prompt });
+        // Add task context if provided
+        if (task.context) {
+            messages.push({
+                role: 'user',
+                content: `Additional context: ${JSON.stringify(task.context, null, 2)}`,
+            });
+        }
+        // Get LLM response
+        const response = await this.config.llmClient.chat(messages);
+        // Check if we need to execute commands
+        const commands = this.extractCommands(response.content);
+        if (commands.length > 0 && this.config.executor) {
+            for (const cmd of commands) {
+                this.log(`Executing command: ${cmd}`);
+                const result = await this.config.executor.execute(cmd, {
+                    mode: task.executionMode,
+                });
+                if (result.exitCode !== 0) {
+                    // Feed error back to LLM
+                    messages.push({ role: 'assistant', content: response.content });
+                    messages.push({
+                        role: 'user',
+                        content: `Command failed with exit code ${result.exitCode}:\n${result.stderr}`,
+                    });
+                    const retryResponse = await this.config.llmClient.chat(messages);
+                    return retryResponse.content;
+                }
+                // Feed output back to LLM
+                messages.push({ role: 'assistant', content: response.content });
+                messages.push({
+                    role: 'user',
+                    content: `Command output:\n${result.stdout}`,
+                });
+            }
+            const finalResponse = await this.config.llmClient.chat(messages);
+            return finalResponse.content;
+        }
+        return response.content;
+    }
+    /**
+     * Extract shell commands from LLM response.
+     *
+     * Looks for commands in code blocks marked as shell/bash.
+     */
+    extractCommands(content) {
+        const commands = [];
+        // Match ```shell or ```bash code blocks
+        const shellBlockRegex = /```(?:shell|bash|sh)\n([\s\S]*?)```/g;
+        let match;
+        while ((match = shellBlockRegex.exec(content)) !== null) {
+            const cmd = match[1]?.trim();
+            if (cmd && !cmd.startsWith('#')) {
+                commands.push(cmd);
+            }
+        }
+        return commands;
+    }
+    /**
+     * Log message if verbose mode is enabled.
+     */
+    log(message) {
+        if (this.config.verbose) {
+            console.log(`[TaskExecutor] ${message}`);
+        }
+    }
+    /**
+     * Sleep for specified milliseconds.
+     */
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+/**
+ * Create a new task executor instance.
+ *
+ * @param config - Configuration options
+ * @returns New TaskExecutor instance
+ */
+export function createTaskExecutor(config) {
+    return new TaskExecutor(config);
+}
+//# sourceMappingURL=task-executor.js.map

package/dist/runtime/task-executor.js.map

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

package/dist/skill-sh/adapter.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Skill.sh Adapter
+ *
+ * @module @jclaw/core/skill-sh/adapter
+ */
+import type { LLMClient } from '../runtime/llm-client.js';
+import type { SkillShResult, SkillShDetail, SkillShAdapterConfig, SkillSearchOptions, SkillFrontmatter, SkillInstallationResult } from './types.js';
+export declare class SkillShAdapter {
+    private llmClient;
+    private readonly config;
+    private cache;
+    constructor(llmClient: LLMClient, config?: SkillShAdapterConfig);
+    search(options: SkillSearchOptions): Promise<SkillShResult[]>;
+    getSkill(skillId: string): Promise<SkillShDetail | null>;
+    downloadSkillMd(owner: string, repo: string): Promise<string | null>;
+    installSkill(skillId: string): Promise<SkillInstallationResult>;
+    parseFrontmatter(content: string): SkillFrontmatter | null;
+    private getSkillInstallPath;
+    private getCache;
+    private setCache;
+    private ensureCacheDir;
+    private getHeaders;
+}
+export declare function createSkillShAdapter(llmClient: LLMClient, config?: SkillShAdapterConfig): SkillShAdapter;
+export interface SkillShSearchResponse {
+    results: SkillShResult[];
+    total: number;
+    page: number;
+    hasMore: boolean;
+}
+export declare function searchSkillShAPI(query: string, options?: {
+    limit?: number;
+    sortBy?: string;
+}): Promise<SkillShSearchResponse>;
+export declare function clearSkillShCache(): void;
+export declare function getCacheStats(): {
+    size: number;
+    keys: string[];
+};
+//# sourceMappingURL=adapter.d.ts.map

package/dist/skill-sh/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/skill-sh/adapter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,uBAAuB,EACxB,MAAM,YAAY,CAAC;AAapB,qBAAa,cAAc;IAKvB,OAAO,CAAC,SAAS;IAJnB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiC;IACxD,OAAO,CAAC,KAAK,CAAgE;gBAGnE,SAAS,EAAE,SAAS,EAC5B,MAAM,CAAC,EAAE,oBAAoB;IAMzB,MAAM,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAgC7D,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAyBxD,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA0BpE,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;IA6BrE,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IA+B1D,OAAO,CAAC,mBAAmB;IAc3B,OAAO,CAAC,QAAQ;IAWhB,OAAO,CAAC,QAAQ;YAKF,cAAc;IAO5B,OAAO,CAAC,UAAU;CAMnB;AAED,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,SAAS,EACpB,MAAM,CAAC,EAAE,oBAAoB,GAC5B,cAAc,CAEhB;AAGD,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB;AAMD,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5C,OAAO,CAAC,qBAAqB,CAAC,CAmChC;AAGD,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAGD,wBAAgB,aAAa,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAahE"}