@amodalai/core 0.1.0

package/dist/src/tools/chain-tool.js

@@ -0,0 +1,294 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { BaseDeclarativeTool, BaseToolInvocation, Kind, } from '@google/gemini-cli-core';
+import { ToolErrorType } from '@google/gemini-cli-core';
+import { resolveTemplate, resolveTemplateObject, } from '../templates/template-resolver.js';
+import { isPrivateIp } from '@google/gemini-cli-core';
+import { httpFetch, shapeResponse, formatTemplateErrors } from './tool-utils.js';
+import { resolveMergeTemplate, resolveMergeTemplateObject, } from './merge-template.js';
+/**
+ * Invocation for a chain tool call — parallel HTTP steps merged into one result.
+ */
+export class ChainToolInvocation extends BaseToolInvocation {
+    config;
+    connections;
+    constructor(params, messageBus, toolName, toolDisplayName, config, connections) {
+        super(params, messageBus, toolName, toolDisplayName);
+        this.config = config;
+        this.connections = connections;
+    }
+    getDescription() {
+        const stepNames = this.config.steps.map((s) => s.name).join(', ');
+        return `Chain: [${stepNames}]`;
+    }
+    async execute(signal) {
+        const controller = new AbortController();
+        const aggregateTimeout = setTimeout(() => controller.abort(), this.config.timeout);
+        // Forward external abort
+        if (signal.aborted) {
+            clearTimeout(aggregateTimeout);
+            return this.errorResult(ToolErrorType.EXECUTION_FAILED, 'Chain aborted before execution');
+        }
+        signal.addEventListener('abort', () => controller.abort(), { once: true });
+        try {
+            // Execute all steps in parallel
+            const stepPromises = this.config.steps.map((step) => this.executeStep(step, controller.signal));
+            const results = await Promise.all(stepPromises);
+            // Check for step failures
+            for (const result of results) {
+                if (result.error) {
+                    return result.error;
+                }
+            }
+            // Build merge context
+            const mergeContext = {};
+            for (const result of results) {
+                mergeContext[result.name] = result.data;
+            }
+            // Apply merge template
+            return this.applyMerge(mergeContext);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            if (message.includes('abort')) {
+                return this.errorResult(ToolErrorType.EXECUTION_FAILED, `Chain timed out after ${this.config.timeout}ms`);
+            }
+            return this.errorResult(ToolErrorType.EXECUTION_FAILED, `Chain execution failed: ${message}`);
+        }
+        finally {
+            clearTimeout(aggregateTimeout);
+        }
+    }
+    async executeStep(step, signal) {
+        const context = {
+            connections: this.connections,
+            params: this.params,
+        };
+        // 1. Resolve URL template
+        const urlResult = resolveTemplate(step.urlTemplate, context);
+        if (urlResult.errors.length > 0) {
+            return {
+                name: step.name,
+                data: null,
+                error: this.stepTemplateError(step.name, 'URL', urlResult.errors),
+            };
+        }
+        // 2. Resolve query params
+        let fullUrl = urlResult.value;
+        if (step.queryParams) {
+            const qpResult = resolveTemplateObject(step.queryParams, context);
+            if (qpResult.errors.length > 0) {
+                return {
+                    name: step.name,
+                    data: null,
+                    error: this.stepTemplateError(step.name, 'query params', qpResult.errors),
+                };
+            }
+            const searchParams = new URLSearchParams();
+            for (const [key, val] of Object.entries(qpResult.value)) {
+                searchParams.append(key, String(val));
+            }
+            const sep = fullUrl.includes('?') ? '&' : '?';
+            fullUrl = `${fullUrl}${sep}${searchParams.toString()}`;
+        }
+        // 3. Validate URL
+        let parsedUrl;
+        try {
+            parsedUrl = new URL(fullUrl);
+        }
+        catch {
+            return {
+                name: step.name,
+                data: null,
+                error: this.errorResult(ToolErrorType.EXECUTION_FAILED, `Step "${step.name}": Invalid URL: ${fullUrl}`),
+            };
+        }
+        if (!['http:', 'https:'].includes(parsedUrl.protocol)) {
+            return {
+                name: step.name,
+                data: null,
+                error: this.errorResult(ToolErrorType.EXECUTION_FAILED, `Step "${step.name}": Unsupported protocol: ${parsedUrl.protocol}`),
+            };
+        }
+        // 4. Private IP check
+        if (isPrivateIp(fullUrl)) {
+            return {
+                name: step.name,
+                data: null,
+                error: this.errorResult(ToolErrorType.EXECUTION_FAILED, `Step "${step.name}": Request to private IP blocked: ${parsedUrl.hostname}`),
+            };
+        }
+        // 5. Resolve headers
+        const baseHeaders = {
+            'Content-Type': 'application/json',
+        };
+        let resolvedHeaders = baseHeaders;
+        if (step.headers) {
+            const headersResult = resolveTemplateObject(step.headers, context);
+            if (headersResult.errors.length > 0) {
+                return {
+                    name: step.name,
+                    data: null,
+                    error: this.stepTemplateError(step.name, 'headers', headersResult.errors),
+                };
+            }
+            resolvedHeaders = { ...baseHeaders, ...headersResult.value };
+        }
+        // 6. Resolve body
+        let body;
+        const methodsWithBody = ['POST', 'PUT', 'PATCH'];
+        if (methodsWithBody.includes(step.method) && step.bodyTemplate !== undefined) {
+            if (typeof step.bodyTemplate === 'string') {
+                const bodyResult = resolveTemplate(step.bodyTemplate, context);
+                if (bodyResult.errors.length > 0) {
+                    return {
+                        name: step.name,
+                        data: null,
+                        error: this.stepTemplateError(step.name, 'body', bodyResult.errors),
+                    };
+                }
+                body = bodyResult.value;
+            }
+            else {
+                const bodyResult = resolveTemplateObject(step.bodyTemplate, context);
+                if (bodyResult.errors.length > 0) {
+                    return {
+                        name: step.name,
+                        data: null,
+                        error: this.stepTemplateError(step.name, 'body', bodyResult.errors),
+                    };
+                }
+                body = JSON.stringify(bodyResult.value);
+            }
+        }
+        // 7. Make the HTTP request
+        let response;
+        try {
+            response = await httpFetch(fullUrl, {
+                method: step.method,
+                headers: resolvedHeaders,
+                body,
+                timeout: step.timeout,
+                signal,
+            });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            if (message.includes('abort')) {
+                return {
+                    name: step.name,
+                    data: null,
+                    error: this.errorResult(ToolErrorType.EXECUTION_FAILED, `Step "${step.name}": Request timed out after ${step.timeout}ms`),
+                };
+            }
+            return {
+                name: step.name,
+                data: null,
+                error: this.errorResult(ToolErrorType.EXECUTION_FAILED, `Step "${step.name}": HTTP request failed: ${message}`),
+            };
+        }
+        // 8. Handle HTTP errors
+        if (!response.ok) {
+            let errorBody;
+            try {
+                errorBody = await response.text();
+            }
+            catch {
+                errorBody = '';
+            }
+            const truncated = errorBody.length > 500 ? errorBody.slice(0, 500) + '...' : errorBody;
+            return {
+                name: step.name,
+                data: null,
+                error: this.errorResult(ToolErrorType.EXECUTION_FAILED, `Step "${step.name}": HTTP ${response.status} ${response.statusText}: ${truncated}`),
+            };
+        }
+        // 9. Parse response
+        let responseData;
+        const contentType = response.headers.get('content-type') ?? '';
+        if (contentType.includes('application/json')) {
+            try {
+                responseData = await response.json();
+            }
+            catch {
+                responseData = await response.text();
+            }
+        }
+        else {
+            responseData = await response.text();
+        }
+        // 10. Shape step response if configured
+        if (step.responseShaping?.path) {
+            const shaped = shapeResponse(responseData, step.responseShaping);
+            try {
+                responseData = JSON.parse(shaped);
+            }
+            catch {
+                responseData = shaped;
+            }
+        }
+        return { name: step.name, data: responseData };
+    }
+    applyMerge(context) {
+        let merged;
+        if (typeof this.config.merge === 'string') {
+            const result = resolveMergeTemplate(this.config.merge, context);
+            if (result.errors.length > 0) {
+                const errMsg = result.errors
+                    .map((e) => `  - {{${e.expression}}}: ${e.message}`)
+                    .join('\n');
+                return this.errorResult(ToolErrorType.EXECUTION_FAILED, `Merge template resolution failed:\n${errMsg}`);
+            }
+            merged = result.value;
+        }
+        else {
+            const result = resolveMergeTemplateObject(this.config.merge, context);
+            if (result.errors.length > 0) {
+                const errMsg = result.errors
+                    .map((e) => `  - {{${e.expression}}}: ${e.message}`)
+                    .join('\n');
+                return this.errorResult(ToolErrorType.EXECUTION_FAILED, `Merge template resolution failed:\n${errMsg}`);
+            }
+            merged = JSON.stringify(result.value);
+        }
+        // Apply final response shaping
+        const shaped = shapeResponse(merged, this.config.responseShaping);
+        return {
+            llmContent: shaped,
+            returnDisplay: shaped,
+        };
+    }
+    stepTemplateError(stepName, location, errors) {
+        const msg = `Step "${stepName}": Template resolution failed in ${location}:\n${formatTemplateErrors(errors)}`;
+        return this.errorResult(ToolErrorType.EXECUTION_FAILED, msg);
+    }
+    errorResult(type, message) {
+        return {
+            llmContent: `Error: ${message}`,
+            returnDisplay: message,
+            error: { message, type },
+        };
+    }
+}
+/**
+ * A declarative chain tool — parallel API calls merged into one response.
+ */
+export class ChainTool extends BaseDeclarativeTool {
+    chainConfig;
+    connections;
+    constructor(chainConfig, connections, messageBus) {
+        super(chainConfig.name, chainConfig.displayName, chainConfig.description, Kind.Fetch, chainConfig.parameters, messageBus, false, // isOutputMarkdown
+        false, // canUpdateOutput
+        undefined, // extensionName
+        undefined);
+        this.chainConfig = chainConfig;
+        this.connections = connections;
+    }
+    createInvocation(params, messageBus, toolName, toolDisplayName) {
+        return new ChainToolInvocation(params, messageBus, toolName ?? this.name, toolDisplayName ?? this.displayName, this.chainConfig, this.connections);
+    }
+}
+//# sourceMappingURL=chain-tool.js.map

package/dist/src/tools/chain-tool.js.map

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

package/dist/src/tools/custom-tool-registrar.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+export { registerHttpTools } from './http-tool-registry.js';
+export { registerChainTools } from './chain-tool-registry.js';
+export { registerFunctionTools } from './function-tool-registry.js';

package/dist/src/tools/custom-tool-registrar.js

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+// Re-export the individual registrar functions
+export { registerHttpTools } from './http-tool-registry.js';
+export { registerChainTools } from './chain-tool-registry.js';
+export { registerFunctionTools } from './function-tool-registry.js';
+//# sourceMappingURL=custom-tool-registrar.js.map

package/dist/src/tools/custom-tool-registrar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-tool-registrar.js","sourceRoot":"","sources":["../../../src/tools/custom-tool-registrar.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,+CAA+C;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/src/tools/definitions/amodal-tools.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { ToolDefinition } from '../tool-definition-types.js';
+export declare function getProposeKnowledgeDefinition(): ToolDefinition;
+export declare function getPresentToolDefinition(): ToolDefinition;
+export declare function getRequestToolDefinition(): ToolDefinition;

package/dist/src/tools/definitions/amodal-tools.js

@@ -0,0 +1,192 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { PROPOSE_KNOWLEDGE_TOOL_NAME, PRESENT_TOOL_NAME, REQUEST_TOOL_NAME, } from '../amodal-tool-names.js';
+// ============================================================================
+// PROPOSE_KNOWLEDGE TOOL
+// ============================================================================
+export function getProposeKnowledgeDefinition() {
+    return {
+        base: {
+            name: PROPOSE_KNOWLEDGE_TOOL_NAME,
+            description: `Propose a knowledge base update. Use when you discover a new pattern, learn domain context from the analyst, notice a gap in the knowledge base, find outdated information, or want to record working memory for future sessions. Choose 'application' scope for knowledge that applies to all tenants, 'tenant' for knowledge specific to this deployment. Working memory is always tenant-scoped.
+
+When to propose:
+- New false positive discovered → category: false_positives
+- New risk pattern identified → category: patterns
+- Baseline shift detected → category: baselines
+- Session notes for future reference → category: working_memory (always tenant-scoped)
+
+Working memory is for session-to-session continuity. Formal categories (patterns, false_positives, etc.) are for permanent knowledge. Do not use this for analyst preferences — use save_memory instead.`,
+            parametersJsonSchema: {
+                type: 'object',
+                properties: {
+                    action: {
+                        type: 'string',
+                        enum: ['create', 'update'],
+                        description: 'Create a new document or update an existing one.',
+                    },
+                    scope: {
+                        type: 'string',
+                        enum: ['application', 'tenant'],
+                        description: 'application = shared across all tenants (universal patterns, product knowledge). tenant = specific to this deployment (local incidents, environment details, working memory).',
+                    },
+                    document_id: {
+                        type: 'string',
+                        description: 'For updates: ID of the document to update. Omit for new documents.',
+                    },
+                    title: {
+                        type: 'string',
+                        description: 'Title of the proposed document.',
+                    },
+                    category: {
+                        type: 'string',
+                        enum: [
+                            'system_docs',
+                            'methodology',
+                            'patterns',
+                            'false_positives',
+                            'response_procedures',
+                            'environment',
+                            'baselines',
+                            'team',
+                            'incident_history',
+                            'working_memory',
+                        ],
+                        description: 'Category for the document. Application-level: system_docs, methodology, patterns, false_positives, response_procedures. Tenant-level: environment, baselines, team, incident_history, working_memory.',
+                    },
+                    body: {
+                        type: 'string',
+                        description: 'The proposed content.',
+                    },
+                    reasoning: {
+                        type: 'string',
+                        description: 'Why you are proposing this — what did you discover or what gap did you notice?',
+                    },
+                },
+                required: [
+                    'action',
+                    'scope',
+                    'title',
+                    'category',
+                    'body',
+                    'reasoning',
+                ],
+            },
+        },
+    };
+}
+// ============================================================================
+// PRESENT TOOL
+// ============================================================================
+export function getPresentToolDefinition() {
+    return {
+        base: {
+            name: PRESENT_TOOL_NAME,
+            description: `Show a visual widget inline in the conversation. Use to display entities, maps, alerts, timelines, score breakdowns, status boards, credential input forms, document previews, and other structured data visually instead of describing them in text.
+
+Before first use in a session, load knowledge tagged widget_schemas for the correct data format for each widget type.
+
+Widget selection:
+- entity-card: Single entity profile or lookup result
+- entity-list: Multiple entities in table format
+- alert-card: Individual finding or alert with severity
+- timeline: Chronological event sequence
+- data-table: Structured data, comparisons, lists
+- scope-map: Spatial/scope visualization
+- comparison: Side-by-side entity or metric comparison
+- score-breakdown: Risk/severity score with factor breakdown
+- status-board: Overview of all active findings with severity
+- credential-input: Securely capture connection credentials
+- document-preview: Show proposed resources for approval
+- info-card: Generic entity/object profile with key-value fields
+- metric: Single highlighted metric with optional trend`,
+            parametersJsonSchema: {
+                type: 'object',
+                properties: {
+                    widget: {
+                        type: 'string',
+                        enum: [
+                            'entity-card',
+                            'entity-list',
+                            'scope-map',
+                            'alert-card',
+                            'timeline',
+                            'comparison',
+                            'data-table',
+                            'score-breakdown',
+                            'status-board',
+                            'credential-input',
+                            'document-preview',
+                            'info-card',
+                            'metric',
+                        ],
+                        description: 'Widget type to render.',
+                    },
+                    data: {
+                        type: 'object',
+                        description: 'Widget-specific data. Schema depends on widget type.',
+                    },
+                },
+                required: ['widget', 'data'],
+            },
+        },
+    };
+}
+// ============================================================================
+// REQUEST TOOL
+// ============================================================================
+export function getRequestToolDefinition() {
+    return {
+        base: {
+            name: REQUEST_TOOL_NAME,
+            description: `Make an HTTP request to a connected system. Use intent "read" for GET/query operations. For write operations (POST/PUT/PATCH/DELETE that modify data), first call with intent "write" to preview what will be executed. Present the preview to the user and ask for confirmation. Once confirmed, call again with intent "confirmed_write" to execute.
+
+If the API returns an error:
+- 401/403: Connection credentials may be invalid or expired — report to analyst
+- 404: Endpoint may not exist — load system_docs to verify correct path
+- 429: Rate limited — reduce query scope or wait before retrying
+- 500+: Server error — try alternative endpoint, do not retry immediately`,
+            parametersJsonSchema: {
+                type: 'object',
+                properties: {
+                    connection: {
+                        type: 'string',
+                        description: 'Name of the connection to use (e.g., "datadog", "slack").',
+                    },
+                    method: {
+                        type: 'string',
+                        enum: ['GET', 'POST', 'PUT', 'PATCH', 'DELETE'],
+                        description: 'HTTP method.',
+                    },
+                    endpoint: {
+                        type: 'string',
+                        description: 'Relative API path (e.g., "/monitors", "/api/v1/events").',
+                    },
+                    params: {
+                        type: 'object',
+                        additionalProperties: { type: 'string' },
+                        description: 'Query parameters as key-value pairs.',
+                    },
+                    data: {
+                        description: 'Request body (for POST/PUT/PATCH).',
+                    },
+                    headers: {
+                        type: 'object',
+                        additionalProperties: { type: 'string' },
+                        description: 'Additional HTTP headers.',
+                    },
+                    intent: {
+                        type: 'string',
+                        enum: ['read', 'write', 'confirmed_write'],
+                        description: '"read" executes immediately. "write" returns a preview without executing — present it to the user for confirmation. "confirmed_write" executes after user approval.',
+                    },
+                },
+                required: ['connection', 'method', 'endpoint', 'intent'],
+            },
+        },
+    };
+}
+//# sourceMappingURL=amodal-tools.js.map

package/dist/src/tools/definitions/amodal-tools.js.map

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

package/dist/src/tools/function-tool-registry.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { type FunctionHandlerMap } from './function-tool-types.js';
+import type { ToolRegistry } from '@google/gemini-cli-core';
+import type { ConnectionsMap } from '../templates/connections.js';
+import type { MessageBus } from '@google/gemini-cli-core';
+export interface RegisterFunctionToolsResult {
+    registered: string[];
+    errors: Array<{
+        index: number;
+        error: string;
+    }>;
+}
+/**
+ * Validate and register function tool configs into the tool registry.
+ * Each config must reference a handler that exists in the handler map.
+ * Invalid configs produce errors but don't block other registrations.
+ */
+export declare function registerFunctionTools(registry: ToolRegistry, configs: unknown[], handlers: FunctionHandlerMap, connections: ConnectionsMap, messageBus: MessageBus): RegisterFunctionToolsResult;

package/dist/src/tools/function-tool-registry.js

@@ -0,0 +1,45 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { FunctionToolConfigSchema } from './function-tool-types.js';
+import { FunctionTool } from './function-tool.js';
+import { debugLogger } from '@google/gemini-cli-core';
+/**
+ * Validate and register function tool configs into the tool registry.
+ * Each config must reference a handler that exists in the handler map.
+ * Invalid configs produce errors but don't block other registrations.
+ */
+export function registerFunctionTools(registry, configs, handlers, connections, messageBus) {
+    const registered = [];
+    const errors = [];
+    for (let i = 0; i < configs.length; i++) {
+        const raw = configs[i];
+        const parsed = FunctionToolConfigSchema.safeParse(raw);
+        if (!parsed.success) {
+            const errorMsg = parsed.error.issues
+                .map((issue) => `${issue.path.join('.')}: ${issue.message}`)
+                .join('; ');
+            errors.push({ index: i, error: errorMsg });
+            debugLogger.log(`Function tool config #${i} invalid: ${errorMsg}`);
+            continue;
+        }
+        const config = parsed.data;
+        // Validate that the handler exists
+        const handler = handlers.get(config.handler);
+        if (!handler) {
+            errors.push({
+                index: i,
+                error: `Handler "${config.handler}" not found in handler map`,
+            });
+            debugLogger.log(`Function tool config #${i} ("${config.name}"): handler "${config.handler}" not found`);
+            continue;
+        }
+        const tool = new FunctionTool(config, handler, connections, messageBus);
+        registry.registerTool(tool);
+        registered.push(config.name);
+    }
+    return { registered, errors };
+}
+//# sourceMappingURL=function-tool-registry.js.map

package/dist/src/tools/function-tool-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"function-tool-registry.js","sourceRoot":"","sources":["../../../src/tools/function-tool-registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,wBAAwB,EAAoD,MAAM,0BAA0B,CAAC;AACtH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIlD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAOtD;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAAsB,EACtB,OAAkB,EAClB,QAA4B,EAC5B,WAA2B,EAC3B,UAAsB;IAEtB,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,MAAM,GAA4C,EAAE,CAAC;IAE3D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACvB,MAAM,MAAM,GAAG,wBAAwB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACvD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM;iBACjC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;iBAC3D,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC3C,WAAW,CAAC,GAAG,CAAC,yBAAyB,CAAC,aAAa,QAAQ,EAAE,CAAC,CAAC;YACnE,SAAS;QACX,CAAC;QAED,MAAM,MAAM,GAAuB,MAAM,CAAC,IAAI,CAAC;QAE/C,mCAAmC;QACnC,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC;gBACV,KAAK,EAAE,CAAC;gBACR,KAAK,EAAE,YAAY,MAAM,CAAC,OAAO,4BAA4B;aAC9D,CAAC,CAAC;YACH,WAAW,CAAC,GAAG,CACb,yBAAyB,CAAC,MAAM,MAAM,CAAC,IAAI,gBAAgB,MAAM,CAAC,OAAO,aAAa,CACvF,CAAC;YACF,SAAS;QACX,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;QACxE,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAC5B,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;AAChC,CAAC"}