@dcyfr/ai 2.1.3 → 3.0.0

package/dist/ai/src/container/agent-container-dispatcher.d.ts

@@ -0,0 +1,154 @@
+/**
+ * AgentContainerDispatcher
+ * TLP:CLEAR
+ *
+ * High-level coordinator that bridges GitHub issues / freeform tasks with the
+ * container execution backend and the delegation framework.
+ *
+ * Responsibilities:
+ *  - Parse issue metadata → detect affected scope, capabilities, resource tier
+ *  - Select the best delegatee agent via CapabilityRegistry
+ *  - Create a DelegationContract and provision an agent container
+ *  - Track active dispatches in-memory; surface them via getActiveDispatches()
+ *  - Cancel running dispatches (tears down container, marks contract failed)
+ *
+ * @module container/agent-container-dispatcher
+ * @version 1.0.0
+ * @date 2026-03-12
+ */
+import { EventEmitter } from 'node:events';
+import type { DelegationContractManager } from '../../delegation/contract-manager.js';
+import type { CapabilityRegistry } from '../capability-registry.js';
+import type { ContainerExecutionBackend, ContainerHandle, ContainerBackendType } from './types.js';
+import type { DelegationAgent } from '../../types/delegation-contracts.js';
+/** Lightweight description of a GitHub issue for dispatch purposes. */
+export interface IssueDispatchInput {
+    /** The GitHub issue number (used for PR linking). */
+    issueNumber: number;
+    /** Issue title. */
+    title: string;
+    /** Issue body (markdown). May be empty. */
+    body?: string;
+    /** Labels applied to the issue (lowercase, hyphenated). */
+    labels?: string[];
+    /** GitHub repository in "owner/repo" format. */
+    repo: string;
+    /** Optional runtime backend override (e.g. 'remote-docker'). */
+    backendType?: ContainerBackendType;
+}
+/** Freeform task dispatch (no issue linked). */
+export interface TaskDispatchInput {
+    /** Short task identifier (slug). */
+    taskId: string;
+    /** Human-readable description of what the agent should do. */
+    description: string;
+    /** Constrain which capabilities the agent must have. */
+    requiredCapabilities?: string[];
+    /** GitHub repository the agent should operate on. */
+    repo: string;
+    /** Optional runtime backend override (e.g. 'remote-docker'). */
+    backendType?: ContainerBackendType;
+}
+/** Options shared by both dispatch methods. */
+export interface DispatchOptions {
+    /**
+     * Override image for this dispatch.
+     * Defaults to `AgentContainerDispatcherOptions.defaultImage`.
+     */
+    image?: string;
+    /** Execution time limit in milliseconds. Defaults to 1800000 (30 min). */
+    maxExecutionTimeMs?: number;
+    /** When true, skip push / PR creation (dry-run mode). */
+    dryRun?: boolean;
+    /**
+     * Base64-encoded script to run inside the container.
+     * Takes priority over task description auto-generation.
+     */
+    taskScriptB64?: string;
+    /** Runtime backend override for this dispatch (e.g. 'remote-docker'). */
+    backendType?: ContainerBackendType;
+}
+/** Record of a live dispatch. */
+export interface DispatchRecord {
+    /** Contract ID (also used as primary key in the delegation DB). */
+    contractId: string;
+    /** Human-readable task slug. */
+    taskId: string;
+    /** Container handle returned by the backend. */
+    containerHandle: ContainerHandle;
+    /** ISO timestamp when the dispatch was started. */
+    dispatchedAt: string;
+    /** GitHub issue number, if this dispatch originated from an issue. */
+    issueNumber?: number;
+    /** Target repository. */
+    repo: string;
+}
+export interface AgentContainerDispatcherOptions {
+    /** Agent container backend (e.g., LocalDockerBackend). */
+    backend: ContainerExecutionBackend;
+    /** Delegation contract manager for contract lifecycle. */
+    contractManager: DelegationContractManager;
+    /** Capability registry for delegatee agent selection. */
+    capabilityRegistry?: CapabilityRegistry;
+    /**
+     * Agent to use as delegator (who is "assigning" the container work).
+     * Defaults to a system dispatcher agent.
+     */
+    delegatorAgent?: DelegationAgent;
+    /** GitHub token for container secret injection. */
+    githubToken: string;
+    /** Default container image tag. */
+    defaultImage?: string;
+    /** Optional backend map for runtime per-dispatch backend override. */
+    backendsByType?: Partial<Record<ContainerBackendType, ContainerExecutionBackend>>;
+}
+export declare class AgentContainerDispatcher extends EventEmitter {
+    private readonly backend;
+    private readonly contractManager;
+    private readonly capabilityRegistry?;
+    private readonly delegatorAgent;
+    private readonly githubToken;
+    private readonly defaultImage;
+    private readonly backendsByType;
+    /** In-memory active dispatch registry. */
+    private readonly _dispatches;
+    constructor(options: AgentContainerDispatcherOptions);
+    /**
+     * Dispatch an agent container from a GitHub issue.
+     *
+     * Detects scope (affected packages/capabilities) from issue labels and
+     * body keywords, selects the best available delegatee agent via the
+     * capability registry, creates a delegation contract, and provisions
+     * an agent container.
+     */
+    dispatchFromIssue(issue: IssueDispatchInput, options?: DispatchOptions): Promise<DispatchRecord>;
+    /**
+     * Dispatch an agent container from a freeform task description.
+     */
+    dispatchFromTask(task: TaskDispatchInput, options?: DispatchOptions): Promise<DispatchRecord>;
+    /**
+     * Cancel a running dispatch by contract ID.
+     * Tears down the container and marks the contract as failed.
+     */
+    cancel(contractId: string): Promise<void>;
+    /**
+     * List all currently active dispatches.
+     */
+    getActiveDispatches(): Promise<DispatchRecord[]>;
+    private createDispatch;
+    /** Watch container exit and reconcile contract state. */
+    private watchContainer;
+    /** Resolve per-dispatch backend override, falling back to constructor backend. */
+    private resolveBackend;
+    /** Select the best delegatee for a given capability. */
+    private selectDelegatee;
+    /** Detect the best capability from issue labels, then fall back to keywords. */
+    private detectCapability;
+    /** Keyword-based capability detection from free text. */
+    private detectCapabilityFromText;
+    /** Estimate a resource tier based on keywords in the task text. */
+    private estimateResourceTier;
+    /** Format a task description for the agent entrypoint. */
+    private buildTaskDescription;
+}
+//# sourceMappingURL=agent-container-dispatcher.d.ts.map

package/dist/ai/src/container/agent-container-dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-container-dispatcher.d.ts","sourceRoot":"","sources":["../../../../packages/ai/src/container/agent-container-dispatcher.ts"],"names":[],"mappings":"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"}

package/dist/ai/src/container/agent-container-dispatcher.js

@@ -0,0 +1,329 @@
+/**
+ * AgentContainerDispatcher
+ * TLP:CLEAR
+ *
+ * High-level coordinator that bridges GitHub issues / freeform tasks with the
+ * container execution backend and the delegation framework.
+ *
+ * Responsibilities:
+ *  - Parse issue metadata → detect affected scope, capabilities, resource tier
+ *  - Select the best delegatee agent via CapabilityRegistry
+ *  - Create a DelegationContract and provision an agent container
+ *  - Track active dispatches in-memory; surface them via getActiveDispatches()
+ *  - Cancel running dispatches (tears down container, marks contract failed)
+ *
+ * @module container/agent-container-dispatcher
+ * @version 1.0.0
+ * @date 2026-03-12
+ */
+import { EventEmitter } from 'node:events';
+import { randomUUID } from 'node:crypto';
+const RESOURCE_PRESETS = {
+    small: { maxMemory: '512m', maxCpus: 1, maxExecutionTimeMs: 900_000 }, // 15 min
+    medium: { maxMemory: '2g', maxCpus: 2, maxExecutionTimeMs: 1_800_000 }, // 30 min
+    large: { maxMemory: '4g', maxCpus: 4, maxExecutionTimeMs: 3_600_000 }, // 60 min
+};
+// Scope / label → capability category mapping ----------------------------
+const LABEL_TO_CAPABILITY = {
+    'type:bug': 'code_review',
+    'type:feature': 'code_generation',
+    'type:refactor': 'code_generation',
+    'type:test': 'test_generation',
+    'type:docs': 'documentation',
+    'type:security': 'security_analysis',
+    'type:performance': 'performance_analysis',
+    'type:api': 'api_development',
+    'type:ui': 'ui_development',
+};
+// Keywords in issue title/body that suggest specific capabilities ----------
+const KEYWORD_TO_CAPABILITY = [
+    [/\btest(s|ing)?\b/i, 'test_generation'],
+    [/\bsecurity|vuln|CVE\b/i, 'security_analysis'],
+    [/\bperformance|slow|latency\b/i, 'performance_analysis'],
+    [/\bdocument(ation)?\b/i, 'documentation'],
+    [/\brefactor\b/i, 'code_generation'],
+    [/\bbug|fix|error|crash\b/i, 'code_review'],
+];
+// ---------------------------------------------------------------------------
+// Implementation
+// ---------------------------------------------------------------------------
+export class AgentContainerDispatcher extends EventEmitter {
+    backend;
+    contractManager;
+    capabilityRegistry;
+    delegatorAgent;
+    githubToken;
+    defaultImage;
+    backendsByType;
+    /** In-memory active dispatch registry. */
+    _dispatches = new Map();
+    constructor(options) {
+        super();
+        this.backend = options.backend;
+        this.contractManager = options.contractManager;
+        this.capabilityRegistry = options.capabilityRegistry;
+        this.githubToken = options.githubToken;
+        this.defaultImage = options.defaultImage ?? 'dcyfr/agent:latest';
+        this.backendsByType = {
+            [this.backend.backendType]: this.backend,
+            ...(options.backendsByType ?? {}),
+        };
+        this.delegatorAgent = options.delegatorAgent ?? {
+            agent_id: 'agent-container-dispatcher',
+            agent_name: 'AgentContainerDispatcher',
+        };
+    }
+    // ── Public API ─────────────────────────────────────────────────────────────
+    /**
+     * Dispatch an agent container from a GitHub issue.
+     *
+     * Detects scope (affected packages/capabilities) from issue labels and
+     * body keywords, selects the best available delegatee agent via the
+     * capability registry, creates a delegation contract, and provisions
+     * an agent container.
+     */
+    async dispatchFromIssue(issue, options = {}) {
+        const capability = this.detectCapability(issue.labels ?? [], issue.title + ' ' + (issue.body ?? ''));
+        const tier = this.estimateResourceTier(issue.title + ' ' + (issue.body ?? ''));
+        const taskId = `issue-${issue.issueNumber}-${randomUUID().slice(0, 8)}`;
+        const taskDescription = this.buildTaskDescription(issue);
+        return this.createDispatch({
+            taskId,
+            taskDescription,
+            capability,
+            tier,
+            repo: issue.repo,
+            issueNumber: issue.issueNumber,
+            options: {
+                ...options,
+                backendType: options.backendType ?? issue.backendType,
+            },
+        });
+    }
+    /**
+     * Dispatch an agent container from a freeform task description.
+     */
+    async dispatchFromTask(task, options = {}) {
+        const capability = (task.requiredCapabilities?.[0]) ??
+            this.detectCapabilityFromText(task.description);
+        const tier = this.estimateResourceTier(task.description);
+        return this.createDispatch({
+            taskId: task.taskId,
+            taskDescription: task.description,
+            capability,
+            tier,
+            repo: task.repo,
+            options: {
+                ...options,
+                backendType: options.backendType ?? task.backendType,
+            },
+        });
+    }
+    /**
+     * Cancel a running dispatch by contract ID.
+     * Tears down the container and marks the contract as failed.
+     */
+    async cancel(contractId) {
+        const record = this._dispatches.get(contractId);
+        if (!record) {
+            return; // Already gone
+        }
+        try {
+            const selectedBackend = this.resolveBackend(record.containerHandle.backendType);
+            await selectedBackend.teardown(record.containerHandle);
+        }
+        catch {
+            // Best-effort teardown
+        }
+        this._dispatches.delete(contractId);
+        try {
+            await this.contractManager.updateContract({
+                contract_id: contractId,
+                status: 'failed',
+                metadata: { cancellation_reason: 'Cancelled by AgentContainerDispatcher.cancel()' },
+            });
+        }
+        catch {
+            // Best-effort contract update
+        }
+        this.emit('dispatch_cancelled', { contractId });
+    }
+    /**
+     * List all currently active dispatches.
+     */
+    async getActiveDispatches() {
+        return Array.from(this._dispatches.values());
+    }
+    // ── Private helpers ────────────────────────────────────────────────────────
+    async createDispatch(params) {
+        const { taskId, taskDescription, capability, tier, repo, issueNumber, options } = params;
+        const contractId = randomUUID();
+        const resources = RESOURCE_PRESETS[tier];
+        const selectedBackend = this.resolveBackend(options.backendType);
+        // Select best available delegatee agent for the capability
+        const delegateeAgent = await this.selectDelegatee(capability);
+        // Create delegation contract
+        const contract = await this.contractManager.createContract({
+            contract_id: contractId,
+            delegator: this.delegatorAgent,
+            delegatee: delegateeAgent,
+            task_id: taskId,
+            task_description: taskDescription,
+            verification_policy: 'automated_test',
+            success_criteria: {
+                quality_threshold: 0.85,
+                required_checks: ['typecheck', 'lint', 'test'],
+            },
+            timeout_ms: options.maxExecutionTimeMs ?? resources.maxExecutionTimeMs,
+        });
+        // Build container config
+        const containerConfig = {
+            image: options.image ?? this.defaultImage,
+            repo,
+            taskId,
+            taskDescription,
+            contractId: contract.contract_id,
+            githubToken: this.githubToken,
+            issueNumber: issueNumber,
+            dryRun: options.dryRun,
+            taskScriptB64: options.taskScriptB64,
+            resourceLimits: {
+                maxMemory: resources.maxMemory,
+                maxCpus: resources.maxCpus,
+                maxExecutionTimeMs: options.maxExecutionTimeMs ?? resources.maxExecutionTimeMs,
+            },
+        };
+        // Provision container
+        const handle = await selectedBackend.provision(containerConfig);
+        // Link contract to container
+        this.contractManager.dispatchToContainer(contract.contract_id, {
+            containerId: handle.containerId,
+            containerName: handle.containerName,
+            startedAt: handle.startedAt.toISOString(),
+            backendType: handle.backendType,
+        });
+        const record = {
+            contractId: contract.contract_id,
+            taskId,
+            containerHandle: handle,
+            dispatchedAt: new Date().toISOString(),
+            issueNumber,
+            repo,
+        };
+        this._dispatches.set(contract.contract_id, record);
+        // Auto-cleanup when container exits
+        this.watchContainer(contract, handle, selectedBackend);
+        this.emit('dispatched', record);
+        return record;
+    }
+    /** Watch container exit and reconcile contract state. */
+    watchContainer(contract, handle, backend) {
+        backend.waitForExit(handle).then((result) => {
+            this._dispatches.delete(contract.contract_id);
+            const newStatus = result.success ? 'completed' : 'failed';
+            const existing = this.contractManager.getContractById(contract.contract_id);
+            const existingMetadata = existing?.metadata ?? {};
+            this.contractManager.updateContract({
+                contract_id: contract.contract_id,
+                status: newStatus,
+                metadata: {
+                    ...existingMetadata,
+                    container_exit_code: result.exitCode,
+                    container_execution_time_ms: result.executionTimeMs,
+                    pull_request_url: result.pullRequestUrl,
+                    timed_out: result.timedOut,
+                },
+            }).catch(() => { });
+            this.emit(result.success ? 'dispatch_completed' : 'dispatch_failed', {
+                contractId: contract.contract_id,
+                result,
+            });
+        }).catch(() => {
+            // Container watch failed — mark as failed
+            this._dispatches.delete(contract.contract_id);
+            const existing = this.contractManager.getContractById(contract.contract_id);
+            const existingMetadata = existing?.metadata ?? {};
+            this.contractManager.updateContract({
+                contract_id: contract.contract_id,
+                status: 'failed',
+                metadata: {
+                    ...existingMetadata,
+                    container_watch_error: true,
+                },
+            }).catch(() => { });
+            this.emit('dispatch_failed', {
+                contractId: contract.contract_id,
+                result: { success: false, exitCode: -1 },
+            });
+        });
+    }
+    /** Resolve per-dispatch backend override, falling back to constructor backend. */
+    resolveBackend(overrideType) {
+        if (!overrideType)
+            return this.backend;
+        return this.backendsByType[overrideType] ?? this.backend;
+    }
+    /** Select the best delegatee for a given capability. */
+    async selectDelegatee(capability) {
+        if (this.capabilityRegistry) {
+            try {
+                const agents = await this.capabilityRegistry
+                    .getAgentsForCapability?.(capability);
+                if (agents && agents.length > 0) {
+                    return {
+                        agent_id: agents[0].agentName,
+                        agent_name: agents[0].agentName,
+                    };
+                }
+            }
+            catch {
+                // Fall through to default
+            }
+        }
+        // Default: map capability to a known workspace agent
+        const capabilityToAgent = {
+            code_review: 'security-engineer',
+            code_generation: 'fullstack-developer',
+            test_generation: 'test-engineer',
+            security_analysis: 'security-engineer',
+            performance_analysis: 'performance-profiler',
+            documentation: 'documentation-expert',
+            api_development: 'fullstack-developer',
+            ui_development: 'frontend-developer',
+        };
+        const agentName = capabilityToAgent[capability] ?? 'fullstack-developer';
+        return { agent_id: agentName, agent_name: agentName };
+    }
+    /** Detect the best capability from issue labels, then fall back to keywords. */
+    detectCapability(labels, text) {
+        for (const label of labels) {
+            const cap = LABEL_TO_CAPABILITY[label.toLowerCase()];
+            if (cap)
+                return cap;
+        }
+        return this.detectCapabilityFromText(text);
+    }
+    /** Keyword-based capability detection from free text. */
+    detectCapabilityFromText(text) {
+        for (const [pattern, cap] of KEYWORD_TO_CAPABILITY) {
+            if (pattern.test(text))
+                return cap;
+        }
+        return 'code_generation'; // safe default
+    }
+    /** Estimate a resource tier based on keywords in the task text. */
+    estimateResourceTier(text) {
+        const lower = text.toLowerCase();
+        if (/\brefactor all\b|\bmigrat\b|\blarge\b|\bcomp(lex|rehensive)\b/.test(lower))
+            return 'large';
+        if (/\bmultiple\b|\bseveral\b|\bcross.pack(age)?\b|\bmedium\b/.test(lower))
+            return 'medium';
+        return 'small';
+    }
+    /** Format a task description for the agent entrypoint. */
+    buildTaskDescription(issue) {
+        const labels = issue.labels?.length ? `Labels: ${issue.labels.join(', ')}\n` : '';
+        return `Issue #${issue.issueNumber}: ${issue.title}\n${labels}\n${issue.body ?? ''}`.trim();
+    }
+}
+//# sourceMappingURL=agent-container-dispatcher.js.map

package/dist/ai/src/container/agent-container-dispatcher.js.map

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

package/dist/ai/src/container/backend-factory.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Backend factory — create ContainerExecutionBackend instances by type.
+ * TLP:CLEAR
+ *
+ * Provides a unified entry-point so callers don't need to import individual
+ * backend classes directly. Also exports a failover wrapper that automatically
+ * falls back to a secondary backend when the primary is unhealthy.
+ *
+ * @module container/backend-factory
+ * @version 1.0.0
+ */
+import { type LocalDockerBackendOptions } from './local-docker-backend.js';
+import { type RemoteDockerBackendOptions } from './remote-docker-backend.js';
+import { z } from 'zod';
+import { type ContainerBackendType, type ContainerExecutionBackend } from './types.js';
+export type BackendOptions = LocalDockerBackendOptions | RemoteDockerBackendOptions | Record<string, never>;
+export declare const AgentContainersConfigSchema: z.ZodObject<{
+    backend: z.ZodOptional<z.ZodObject<{
+        type: z.ZodOptional<z.ZodOptional<z.ZodEnum<{
+            kubernetes: "kubernetes";
+            "local-docker": "local-docker";
+            "remote-docker": "remote-docker";
+            codespaces: "codespaces";
+        }>>>;
+        defaultBackend: z.ZodOptional<z.ZodOptional<z.ZodEnum<{
+            kubernetes: "kubernetes";
+            "local-docker": "local-docker";
+            "remote-docker": "remote-docker";
+            codespaces: "codespaces";
+        }>>>;
+        localDocker: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+            maxConcurrent: z.ZodOptional<z.ZodNumber>;
+            defaultImage: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>>;
+        remoteDocker: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+            host: z.ZodOptional<z.ZodString>;
+            tlsCertPath: z.ZodOptional<z.ZodString>;
+            maxConcurrent: z.ZodOptional<z.ZodNumber>;
+            defaultImage: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>>;
+        kubernetes: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+            namespace: z.ZodOptional<z.ZodString>;
+            kubeConfigPath: z.ZodOptional<z.ZodString>;
+            maxConcurrent: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$loose>>>;
+    }, z.core.$strip>>;
+    defaults: z.ZodOptional<z.ZodObject<{
+        agentImage: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        baseBranch: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        resourceLimits: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+            maxMemory: z.ZodString;
+            maxCpus: z.ZodNumber;
+            maxExecutionTimeMs: z.ZodNumber;
+            maxDiskSpace: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+    }, z.core.$strip>>;
+    telemetry: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+        logDir: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    }, z.core.$strip>>;
+}, z.core.$loose>;
+export type AgentContainersConfigLike = z.infer<typeof AgentContainersConfigSchema>;
+/**
+ * Create a ContainerExecutionBackend of the given type.
+ *
+ * @param type - The backend variant to instantiate.
+ * @param options - Backend-specific constructor options.
+ */
+export declare function createBackend(type: ContainerBackendType, options?: BackendOptions): ContainerExecutionBackend;
+/**
+ * Create backend from parsed agent-containers config object.
+ * Supports both `backend.type` and legacy `backend.defaultBackend`.
+ */
+export declare function createBackendFromConfig(config: AgentContainersConfigLike): ContainerExecutionBackend;
+/**
+ * Load backend from config JSON file path.
+ */
+export declare function loadBackendFromConfigFile(filePath: string): ContainerExecutionBackend;
+/**
+ * Wrap a primary backend with an automatic failover to a secondary backend.
+ *
+ * On each operation, the wrapper first checks the primary backend's health.
+ * If unavailable, the operation is transparently delegated to the fallback.
+ *
+ * @param primary   - The preferred backend.
+ * @param fallback  - Used when primary healthCheck returns `available: false`.
+ */
+export declare function createBackendWithFailover(primary: ContainerExecutionBackend, fallback: ContainerExecutionBackend): ContainerExecutionBackend;
+//# sourceMappingURL=backend-factory.d.ts.map

package/dist/ai/src/container/backend-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-factory.d.ts","sourceRoot":"","sources":["../../../../packages/ai/src/container/backend-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAsB,KAAK,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAC/F,OAAO,EAAuB,KAAK,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAGlG,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAO/B,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,cAAc,GAAG,yBAAyB,GAAG,0BAA0B,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAE5G,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmDxB,CAAC;AAEjB,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEpF;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,oBAAoB,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,yBAAyB,CAe3B;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,yBAAyB,GAAG,yBAAyB,CA0BpG;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,yBAAyB,CAIrF;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,yBAAyB,EAClC,QAAQ,EAAE,yBAAyB,GAClC,yBAAyB,CAE3B"}