limen-ai 1.0.0

package/dist/substrate/scheduler/task_scheduler.js

@@ -0,0 +1,486 @@
+/**
+ * Task Scheduler implementation.
+ * S ref: §25.1 (Task Scheduler), §25.7 (Queue Cleanup, Worker Exhaustion)
+ *
+ * Phase: 2 (Execution Substrate)
+ * Implements: SQLite-backed priority queue with three configurable policies,
+ *             100ms polling interval, enqueue/dequeue semantics, task lifecycle
+ *             management, cleanup, and backpressure.
+ *
+ * Three scheduling policies per §25.1:
+ *   - 'fifo': First-in-first-out by created_at
+ *   - 'priority': Lower priority integer = higher execution priority
+ *   - 'deadline': Tasks from missions closest to deadline get priority
+ *     (Approximated by priority since deadline info comes from orchestration layer)
+ *
+ * Invariants enforced: I-03 (audit in same transaction), I-05 (transactional), I-14 (latency)
+ * Failure modes defended: FM-20 (heartbeat columns), backpressure (§25.7)
+ *
+ * SYNC interface. All methods return Result<T>.
+ */
+// ─── Error Constructors ───
+function err(code, message, spec) {
+    return { ok: false, error: { code, message, spec } };
+}
+function ok(value) {
+    return { ok: true, value };
+}
+// ─── Constants ───
+/** §25.7: Maximum queue depth for backpressure */
+const MAX_QUEUE_DEPTH = 1000;
+// ─── Task Scheduler Factory ───
+/**
+ * Create a TaskScheduler implementation.
+ * S ref: §25.1, C-07 (Object.freeze), I-03 (audit in same transaction)
+ */
+export function createTaskScheduler(audit, time) {
+    const clock = time ?? { nowISO: () => new Date().toISOString(), nowMs: () => Date.now() };
+    /** §25.1: Enqueue a task for execution */
+    function enqueue(conn, _ctx, request) {
+        // F-02: Input validation
+        if (!request.taskId || typeof request.taskId !== 'string' || request.taskId.trim() === '') {
+            return err('INVALID_INPUT', 'taskId must be a non-empty string', '§25.1');
+        }
+        if (typeof request.priority !== 'number' || !Number.isFinite(request.priority) || !Number.isInteger(request.priority) || request.priority < 0) {
+            return err('INVALID_INPUT', 'priority must be a finite integer >= 0', '§25.1');
+        }
+        if (request.timeoutMs !== undefined && (typeof request.timeoutMs !== 'number' || request.timeoutMs <= 0)) {
+            return err('INVALID_INPUT', 'timeoutMs must be > 0 if provided', '§25.1');
+        }
+        // §25.7: Backpressure check
+        const depthRow = conn.get('SELECT COUNT(*) as cnt FROM core_task_queue');
+        const depth = depthRow?.cnt ?? 0;
+        if (depth >= MAX_QUEUE_DEPTH) {
+            return err('WORKER_UNAVAILABLE', `Queue depth ${depth} exceeds maxQueueDepth ${MAX_QUEUE_DEPTH}`, '§25.7');
+        }
+        const now = clock.nowISO();
+        // F-10: scheduled_at is NULL for PENDING tasks. It is set when poll()
+        // transitions PENDING -> SCHEDULED. This correctly reflects the semantics:
+        // a task is not "scheduled" until it is picked up by the scheduler.
+        // I-03: mutation + audit in same transaction
+        conn.transaction(() => {
+            conn.run(`INSERT INTO core_task_queue
+          (task_id, mission_id, tenant_id, agent_id, priority, status, execution_mode,
+           scheduled_at, retry_count, max_retries, timeout_ms, heartbeat_interval_ms,
+           estimated_tokens, capabilities_required, payload, created_at)
+         VALUES (?, ?, ?, ?, ?, 'PENDING', ?, NULL, 0, ?, ?, ?, ?, ?, ?, ?)`, [
+                request.taskId,
+                request.missionId,
+                request.tenantId,
+                request.agentId,
+                request.priority,
+                request.executionMode,
+                request.maxRetries ?? 2,
+                request.timeoutMs ?? 300000,
+                request.heartbeatIntervalMs ?? 30000,
+                request.estimatedTokens ?? null,
+                JSON.stringify(request.capabilitiesRequired),
+                JSON.stringify(request.payload),
+                now,
+            ]);
+            audit?.append(conn, {
+                tenantId: request.tenantId,
+                actorType: 'system',
+                actorId: 'substrate.scheduler',
+                operation: 'task.enqueue',
+                resourceType: 'task',
+                resourceId: request.taskId,
+                detail: { missionId: request.missionId, priority: request.priority },
+            });
+        });
+        return ok(undefined);
+    }
+    /**
+     * §25.1: Poll for the next available task.
+     * Selection depends on the active policy:
+     *   - 'fifo': ORDER BY created_at ASC
+     *   - 'priority': ORDER BY priority ASC (lower = higher)
+     *   - 'deadline': ORDER BY priority ASC (proxy for deadline urgency)
+     *
+     * Atomically transitions PENDING -> SCHEDULED.
+     */
+    function poll(conn, policy) {
+        let orderClause;
+        switch (policy) {
+            case 'fifo':
+                orderClause = 'ORDER BY created_at ASC';
+                break;
+            case 'priority':
+                orderClause = 'ORDER BY priority ASC, created_at ASC';
+                break;
+            case 'deadline':
+                // Deadline info comes from orchestration; we approximate with priority
+                orderClause = 'ORDER BY priority ASC, created_at ASC';
+                break;
+            default:
+                orderClause = 'ORDER BY priority ASC, created_at ASC';
+        }
+        const result = conn.transaction(() => {
+            const row = conn.get(`SELECT task_id, mission_id, tenant_id, agent_id, priority, execution_mode,
+                estimated_tokens, capabilities_required, payload, max_retries,
+                timeout_ms, heartbeat_interval_ms, retry_count
+         FROM core_task_queue
+         WHERE status = 'PENDING'
+         ${orderClause}
+         LIMIT 1`);
+            if (!row)
+                return null;
+            // Atomic transition PENDING -> SCHEDULED
+            conn.run(`UPDATE core_task_queue SET status = 'SCHEDULED', scheduled_at = strftime('%Y-%m-%dT%H:%M:%fZ', 'now')
+         WHERE task_id = ? AND status = 'PENDING'`, [row.task_id]);
+            // I-03: audit in same transaction as state mutation
+            audit?.append(conn, {
+                tenantId: row.tenant_id ?? null, // lint-allow: as any — SQLite row typing
+                actorType: 'scheduler',
+                actorId: 'substrate.scheduler',
+                operation: 'task.schedule',
+                resourceType: 'task',
+                resourceId: row.task_id,
+                detail: { policy, missionId: row.mission_id },
+            });
+            return row;
+        });
+        if (!result) {
+            return ok(null);
+        }
+        let capabilities;
+        try {
+            capabilities = JSON.parse(result.capabilities_required);
+        }
+        catch {
+            capabilities = [];
+        }
+        let payload;
+        try {
+            payload = JSON.parse(result.payload);
+        }
+        catch {
+            payload = {};
+        }
+        return ok({
+            taskId: result.task_id,
+            missionId: result.mission_id,
+            tenantId: result.tenant_id, // lint-allow: as any — SQLite row typing
+            agentId: result.agent_id, // lint-allow: as any — SQLite row typing
+            priority: result.priority,
+            executionMode: result.execution_mode,
+            estimatedTokens: result.estimated_tokens,
+            capabilitiesRequired: capabilities,
+            payload,
+            maxRetries: result.max_retries,
+            timeoutMs: result.timeout_ms,
+            heartbeatIntervalMs: result.heartbeat_interval_ms,
+            retryCount: result.retry_count,
+        });
+    }
+    /** §25.1: Mark a task as running with assigned worker */
+    function markRunning(conn, _ctx, taskId, workerId) {
+        const now = clock.nowISO();
+        // I-03: mutation + audit in same transaction
+        const result = conn.transaction(() => {
+            const r = conn.run(`UPDATE core_task_queue
+         SET status = 'RUNNING', started_at = ?, worker_id = ?, last_heartbeat_at = ?
+         WHERE task_id = ? AND status = 'SCHEDULED'`, [now, workerId, now, taskId]);
+            if (r.changes > 0) {
+                audit?.append(conn, {
+                    tenantId: null,
+                    actorType: 'system',
+                    actorId: 'substrate.scheduler',
+                    operation: 'task.start',
+                    resourceType: 'task',
+                    resourceId: taskId,
+                    detail: { workerId },
+                });
+            }
+            return r;
+        });
+        if (result.changes === 0) {
+            return err('TASK_NOT_SCHEDULED', `Task ${taskId} is not in SCHEDULED state`, '§25.1');
+        }
+        return ok(undefined);
+    }
+    /** §25.1: Complete a task (archive + remove from queue) */
+    function complete(conn, _ctx, taskId) {
+        conn.transaction(() => {
+            const task = conn.get(`SELECT task_id, mission_id, tenant_id, agent_id, execution_mode, retry_count,
+                worker_id, started_at, created_at
+         FROM core_task_queue WHERE task_id = ?`, [taskId]);
+            if (!task)
+                return;
+            // Archive with COMPLETED status
+            conn.run(`INSERT OR REPLACE INTO core_task_archive
+          (task_id, mission_id, tenant_id, agent_id, final_status, execution_mode,
+           retry_count, worker_id, started_at, completed_at, created_at)
+         VALUES (?, ?, ?, ?, 'COMPLETED', ?, ?, ?, ?, strftime('%Y-%m-%dT%H:%M:%fZ', 'now'), ?)`, [
+                task.task_id,
+                task.mission_id,
+                task.tenant_id,
+                task.agent_id,
+                task.execution_mode,
+                task.retry_count,
+                task.worker_id,
+                task.started_at,
+                task.created_at,
+            ]);
+            // Remove from active queue
+            conn.run('DELETE FROM core_task_queue WHERE task_id = ?', [taskId]);
+            // I-03: audit in same transaction
+            audit?.append(conn, {
+                tenantId: task.tenant_id ?? null, // lint-allow: as any — SQLite row typing
+                actorType: 'system',
+                actorId: 'substrate.scheduler',
+                operation: 'task.complete',
+                resourceType: 'task',
+                resourceId: taskId,
+                detail: { missionId: task.mission_id },
+            });
+        });
+        return ok(undefined);
+    }
+    /** §25.1: Fail a task (archive with error details) */
+    function fail(conn, _ctx, taskId, errorCode, errorMessage, errorDetail) {
+        conn.transaction(() => {
+            const task = conn.get(`SELECT task_id, mission_id, tenant_id, agent_id, execution_mode, retry_count,
+                max_retries, worker_id, started_at, created_at
+         FROM core_task_queue WHERE task_id = ?`, [taskId]);
+            if (!task)
+                return;
+            // Check if task should be retried (§25.2: retry if retryCount < maxRetries)
+            if (task.retry_count < task.max_retries) {
+                // Re-enqueue with incremented retry count
+                conn.run(`UPDATE core_task_queue
+           SET status = 'PENDING', worker_id = NULL, started_at = NULL,
+               allocated_at = NULL, retry_count = ?, missed_heartbeats = 0,
+               last_heartbeat_at = NULL,
+               scheduled_at = NULL
+           WHERE task_id = ?`, [task.retry_count + 1, taskId]);
+            }
+            else {
+                // Permanently fail -- archive
+                conn.run(`INSERT OR REPLACE INTO core_task_archive
+            (task_id, mission_id, tenant_id, agent_id, final_status, execution_mode,
+             retry_count, worker_id, started_at, completed_at, error_code,
+             error_message, error_detail, created_at)
+           VALUES (?, ?, ?, ?, 'FAILED', ?, ?, ?, ?, strftime('%Y-%m-%dT%H:%M:%fZ', 'now'), ?, ?, ?, ?)`, [
+                    task.task_id,
+                    task.mission_id,
+                    task.tenant_id,
+                    task.agent_id,
+                    task.execution_mode,
+                    task.retry_count,
+                    task.worker_id,
+                    task.started_at,
+                    errorCode,
+                    errorMessage,
+                    errorDetail ?? null,
+                    task.created_at,
+                ]);
+                conn.run('DELETE FROM core_task_queue WHERE task_id = ?', [taskId]);
+            }
+            // I-03: audit in same transaction (covers both retry and permanent fail paths)
+            audit?.append(conn, {
+                tenantId: task.tenant_id ?? null, // lint-allow: as any — SQLite row typing
+                actorType: 'system',
+                actorId: 'substrate.scheduler',
+                operation: 'task.fail',
+                resourceType: 'task',
+                resourceId: taskId,
+                detail: {
+                    missionId: task.mission_id,
+                    errorCode,
+                    retryCount: task.retry_count,
+                    maxRetries: task.max_retries,
+                    retried: task.retry_count < task.max_retries,
+                },
+            });
+        });
+        return ok(undefined);
+    }
+    /** §25.1: Cancel a task */
+    function cancel(conn, _ctx, taskId) {
+        conn.transaction(() => {
+            const task = conn.get(`SELECT task_id, mission_id, tenant_id, agent_id, execution_mode, retry_count,
+                worker_id, started_at, created_at
+         FROM core_task_queue WHERE task_id = ?`, [taskId]);
+            if (!task)
+                return;
+            // Archive as CANCELLED
+            conn.run(`INSERT OR REPLACE INTO core_task_archive
+          (task_id, mission_id, tenant_id, agent_id, final_status, execution_mode,
+           retry_count, worker_id, started_at, completed_at, created_at)
+         VALUES (?, ?, ?, ?, 'CANCELLED', ?, ?, ?, ?, strftime('%Y-%m-%dT%H:%M:%fZ', 'now'), ?)`, [
+                task.task_id,
+                task.mission_id,
+                task.tenant_id,
+                task.agent_id,
+                task.execution_mode,
+                task.retry_count,
+                task.worker_id,
+                task.started_at,
+                task.created_at,
+            ]);
+            conn.run('DELETE FROM core_task_queue WHERE task_id = ?', [taskId]);
+            // I-03: audit in same transaction
+            audit?.append(conn, {
+                tenantId: task.tenant_id ?? null, // lint-allow: as any — SQLite row typing
+                actorType: 'system',
+                actorId: 'substrate.scheduler',
+                operation: 'task.cancel',
+                resourceType: 'task',
+                resourceId: taskId,
+                detail: { missionId: task.mission_id },
+            });
+        });
+        return ok(undefined);
+    }
+    /** §25.7: Bulk-cancel all tasks for a mission */
+    function cancelMissionTasks(conn, _ctx, missionId) {
+        let cancelled = 0;
+        conn.transaction(() => {
+            // Get all PENDING tasks for this mission
+            const tasks = conn.query(`SELECT task_id, mission_id, tenant_id, agent_id, execution_mode, retry_count,
+                worker_id, started_at, created_at
+         FROM core_task_queue WHERE mission_id = ? AND status = 'PENDING'`, [missionId]);
+            for (const task of tasks) {
+                conn.run(`INSERT OR REPLACE INTO core_task_archive
+            (task_id, mission_id, tenant_id, agent_id, final_status, execution_mode,
+             retry_count, worker_id, started_at, completed_at, created_at)
+           VALUES (?, ?, ?, ?, 'CANCELLED', ?, ?, ?, ?, strftime('%Y-%m-%dT%H:%M:%fZ', 'now'), ?)`, [
+                    task.task_id,
+                    task.mission_id,
+                    task.tenant_id,
+                    task.agent_id,
+                    task.execution_mode,
+                    task.retry_count,
+                    task.worker_id,
+                    task.started_at,
+                    task.created_at,
+                ]);
+            }
+            const result = conn.run(`DELETE FROM core_task_queue WHERE mission_id = ? AND status = 'PENDING'`, [missionId]);
+            cancelled = result.changes;
+            // I-03: audit bulk cancellation in same transaction
+            if (cancelled > 0) {
+                audit?.append(conn, {
+                    tenantId: null,
+                    actorType: 'system',
+                    actorId: 'substrate.scheduler',
+                    operation: 'task.cancel_mission',
+                    resourceType: 'mission',
+                    resourceId: missionId,
+                    detail: { cancelled },
+                });
+            }
+        });
+        return ok({ cancelled });
+    }
+    /** §32.4: Get queue statistics */
+    function getStats(conn) {
+        const row = conn.get(`SELECT
+        SUM(CASE WHEN status = 'PENDING' THEN 1 ELSE 0 END) as pending,
+        SUM(CASE WHEN status = 'SCHEDULED' THEN 1 ELSE 0 END) as scheduled,
+        SUM(CASE WHEN status = 'RUNNING' THEN 1 ELSE 0 END) as running,
+        COUNT(*) as total
+       FROM core_task_queue`);
+        if (!row) {
+            return ok({ pending: 0, scheduled: 0, running: 0, total: 0 });
+        }
+        return ok({
+            pending: row.pending ?? 0,
+            scheduled: row.scheduled ?? 0,
+            running: row.running ?? 0,
+            total: row.total ?? 0,
+        });
+    }
+    /**
+     * §25.7: Cleanup stale tasks.
+     * - Archive stale RUNNING tasks that have exceeded their timeout
+     * - Cancel orphaned PENDING tasks older than 24 hours (prevents indefinite queue growth)
+     */
+    function cleanup(conn, _ctx) {
+        let archived = 0;
+        let orphansCancelled = 0;
+        conn.transaction(() => {
+            // Archive stale RUNNING tasks that have exceeded their timeout
+            const staleTasks = conn.query(`SELECT task_id, mission_id, tenant_id, agent_id, execution_mode, retry_count,
+                worker_id, started_at, timeout_ms, created_at
+         FROM core_task_queue
+         WHERE status = 'RUNNING'
+         AND started_at IS NOT NULL
+         AND (julianday('now') - julianday(started_at)) * 86400000 > timeout_ms`);
+            for (const task of staleTasks) {
+                conn.run(`INSERT OR REPLACE INTO core_task_archive
+            (task_id, mission_id, tenant_id, agent_id, final_status, execution_mode,
+             retry_count, worker_id, started_at, completed_at, error_code,
+             error_message, created_at)
+           VALUES (?, ?, ?, ?, 'FAILED', ?, ?, ?, ?, strftime('%Y-%m-%dT%H:%M:%fZ', 'now'),
+                   'EXECUTION_TIMEOUT', 'Task exceeded timeout', ?)`, [
+                    task.task_id,
+                    task.mission_id,
+                    task.tenant_id,
+                    task.agent_id,
+                    task.execution_mode,
+                    task.retry_count,
+                    task.worker_id,
+                    task.started_at,
+                    task.created_at,
+                ]);
+                conn.run('DELETE FROM core_task_queue WHERE task_id = ?', [task.task_id]);
+                archived++;
+            }
+            // §25.7: Cancel orphaned PENDING tasks older than 24 hours.
+            // Prevents indefinite queue growth — matches §25.7 "FAILED tasks remain for 24 hours" semantics.
+            const orphanedTasks = conn.query(`SELECT task_id, mission_id, tenant_id, agent_id, execution_mode, retry_count,
+                worker_id, started_at, created_at
+         FROM core_task_queue
+         WHERE status = 'PENDING'
+         AND (julianday('now') - julianday(created_at)) * 86400000 > 86400000`);
+            for (const task of orphanedTasks) {
+                conn.run(`INSERT OR REPLACE INTO core_task_archive
+            (task_id, mission_id, tenant_id, agent_id, final_status, execution_mode,
+             retry_count, worker_id, started_at, completed_at, error_code,
+             error_message, created_at)
+           VALUES (?, ?, ?, ?, 'CANCELLED', ?, ?, ?, ?, strftime('%Y-%m-%dT%H:%M:%fZ', 'now'),
+                   'ORPHAN_TIMEOUT', 'PENDING task exceeded 24-hour queue age limit', ?)`, [
+                    task.task_id,
+                    task.mission_id,
+                    task.tenant_id,
+                    task.agent_id,
+                    task.execution_mode,
+                    task.retry_count,
+                    task.worker_id,
+                    task.started_at,
+                    task.created_at,
+                ]);
+                conn.run('DELETE FROM core_task_queue WHERE task_id = ?', [task.task_id]);
+                orphansCancelled++;
+            }
+            // I-03: audit cleanup mutations in same transaction
+            if (archived > 0 || orphansCancelled > 0) {
+                audit?.append(conn, {
+                    tenantId: null,
+                    actorType: 'system',
+                    actorId: 'substrate.scheduler',
+                    operation: 'task.cleanup',
+                    resourceType: 'task_queue',
+                    resourceId: 'cleanup',
+                    detail: { archived, orphansCancelled },
+                });
+            }
+        });
+        return ok({ archived, orphansCancelled });
+    }
+    const scheduler = {
+        enqueue,
+        poll,
+        markRunning,
+        complete,
+        fail,
+        cancel,
+        cancelMissionTasks,
+        getStats,
+        cleanup,
+    };
+    return Object.freeze(scheduler);
+}
+//# sourceMappingURL=task_scheduler.js.map

package/dist/substrate/scheduler/task_scheduler.js.map

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

package/dist/substrate/transport/adapters/anthropic_adapter.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Anthropic Messages API adapter.
+ * S ref: §25.4 (LLM Gateway), I-01 (no SDK deps), I-04 (provider independence)
+ *
+ * Phase: 5A (Sprint 5A — Shared Transport Infrastructure)
+ * Implements: ProviderAdapter for Anthropic's Messages API
+ *
+ * Request translation:
+ *   - systemPrompt → top-level "system" parameter
+ *   - LlmContentBlock mapping to Anthropic content format
+ *   - thinking config (extended_thinking)
+ *
+ * Response parsing:
+ *   - content blocks, tool calls, usage extraction
+ *   - C-SEC-P5-22: Provider output is untrusted input
+ *   - C-SEC-P5-23: Tool call structural validation
+ *
+ * Stream parsing:
+ *   - thinking_delta events aggregated internally (NOT emitted as LlmStreamChunk)
+ *   - content_delta/tool_call_delta/usage/done emitted
+ *
+ * Deliberation:
+ *   - provider_authoritative when thinking blocks present
+ *   - CR-5: No reasoning_tokens subtraction (that is OpenAI-specific)
+ *
+ * Retryable status codes: 429, 500, 502, 503, 529 (overloaded)
+ *
+ * Security:
+ *   - C-SEC-P5-01/02: API key NEVER in logs or error messages
+ *   - C-SEC-P5-04 / CR-1: API key resolved ONCE at creation
+ *   - C-SEC-P5-22: Provider output is untrusted input
+ *   - C-SEC-P5-23: Tool call structural validation
+ */
+import type { ProviderAdapter } from '../transport_types.js';
+import type { TimeProvider } from '../../../kernel/interfaces/time.js';
+/**
+ * Create an Anthropic Messages API adapter.
+ *
+ * @param providerId - Provider identifier for health tracking
+ * @param baseUrl - Base URL for the Anthropic API
+ * @param apiKey - API key (resolved ONCE at creation — CR-1 / C-SEC-P5-04)
+ * @param time - Optional TimeProvider for clock injection
+ */
+export declare function createAnthropicAdapter(providerId: string, baseUrl: string, apiKey: string, time?: TimeProvider): ProviderAdapter;
+/**
+ * Create an Anthropic adapter with API key from environment variable.
+ * C-SEC-P5-01/02: Key is read from env and NEVER logged.
+ * CR-1: Key resolved once at creation.
+ *
+ * @param providerId - Provider identifier
+ * @param baseUrl - Base URL (e.g., 'https://api.anthropic.com')
+ * @param apiKeyEnvVar - Environment variable name containing the API key
+ * @param time - Optional TimeProvider
+ * @throws Error if API key env var is not set (for non-Ollama providers)
+ */
+export declare function createAnthropicAdapterFromEnv(providerId: string, baseUrl: string, apiKeyEnvVar: string, time?: TimeProvider): ProviderAdapter;
+//# sourceMappingURL=anthropic_adapter.d.ts.map

package/dist/substrate/transport/adapters/anthropic_adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic_adapter.d.ts","sourceRoot":"","sources":["../../../../src/substrate/transport/adapters/anthropic_adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,EACV,eAAe,EAMhB,MAAM,uBAAuB,CAAC;AAS/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AA+EvE;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,YAAY,GAClB,eAAe,CAuVjB;AAqBD;;;;;;;;;;GAUG;AACH,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,IAAI,CAAC,EAAE,YAAY,GAClB,eAAe,CAWjB"}