@jamesaphoenix/tx-core 0.4.1

package/dist/services/auto-sync-service.js

@@ -0,0 +1,66 @@
+/**
+ * AutoSyncService provides hooks for automatic JSONL export on data mutations.
+ *
+ * When auto-sync is enabled, any create/update/delete operation on tasks,
+ * learnings, file-learnings, attempts, or dependencies triggers an export
+ * to keep JSONL files in sync with SQLite.
+ *
+ * Design:
+ * - Non-blocking: Exports run in background fiber to avoid latency impact
+ * - Error-resilient: Export errors are logged but never propagate to caller
+ * - Configurable: Controlled via sync_config "auto_sync" setting
+ */
+import { Context, Effect, Layer } from "effect";
+import { SqliteClient } from "../db.js";
+import { SyncService } from "./sync-service.js";
+import { DatabaseError } from "../errors.js";
+export class AutoSyncService extends Context.Tag("AutoSyncService")() {
+}
+export const AutoSyncServiceLive = Layer.effect(AutoSyncService, Effect.gen(function* () {
+    const db = yield* SqliteClient;
+    const syncService = yield* SyncService;
+    // Check if auto-sync is enabled
+    const isEnabled = () => Effect.try({
+        try: () => {
+            const row = db.prepare("SELECT value FROM sync_config WHERE key = ?").get("auto_sync");
+            return row?.value === "true";
+        },
+        catch: (cause) => new DatabaseError({ cause })
+    });
+    // Run export in background, catching and logging any errors
+    const runInBackground = (exportEffect) => Effect.gen(function* () {
+        const enabled = yield* isEnabled().pipe(Effect.catchAll(() => Effect.succeed(false)));
+        if (!enabled) {
+            return;
+        }
+        // Fork the export and ignore the fiber - fire and forget
+        yield* Effect.fork(exportEffect.pipe(Effect.catchAll((error) => Effect.sync(() => {
+            // Log error but don't propagate
+            console.error("[auto-sync] Export failed:", error);
+        }))));
+    });
+    return {
+        // Tasks use the standard export
+        afterTaskMutation: () => runInBackground(syncService.export()),
+        // TODO: Implement when learning sync is added to SyncService
+        afterLearningMutation: () => runInBackground(syncService.export()),
+        // TODO: Implement when file-learning sync is added to SyncService
+        afterFileLearningMutation: () => runInBackground(syncService.export()),
+        // TODO: Implement when attempt sync is added to SyncService
+        afterAttemptMutation: () => runInBackground(syncService.export()),
+        // For now, just exports tasks - extend when other entity types are supported
+        afterAnyMutation: () => runInBackground(syncService.export())
+    };
+}));
+/**
+ * Noop implementation for use when auto-sync is not needed.
+ * All hooks do nothing.
+ */
+export const AutoSyncServiceNoop = Layer.succeed(AutoSyncService, AutoSyncService.of({
+    afterTaskMutation: () => Effect.void,
+    afterLearningMutation: () => Effect.void,
+    afterFileLearningMutation: () => Effect.void,
+    afterAttemptMutation: () => Effect.void,
+    afterAnyMutation: () => Effect.void
+}));
+//# sourceMappingURL=auto-sync-service.js.map

package/dist/services/auto-sync-service.js.map

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

package/dist/services/candidate-extractor-service.d.ts

@@ -0,0 +1,56 @@
+import { Context, Effect, Layer } from "effect";
+import { ExtractionUnavailableError } from "../errors.js";
+import type { TranscriptChunk, ExtractionResult } from "@jamesaphoenix/tx-types";
+declare const CandidateExtractorService_base: Context.TagClass<CandidateExtractorService, "CandidateExtractorService", {
+    /**
+     * Extract learning candidates from a transcript chunk.
+     * Returns structured candidates with confidence and category.
+     */
+    readonly extract: (chunk: TranscriptChunk) => Effect.Effect<ExtractionResult, ExtractionUnavailableError>;
+    /** Check if extraction functionality is available */
+    readonly isAvailable: () => Effect.Effect<boolean>;
+}>;
+/**
+ * CandidateExtractorService extracts learning candidates from Claude Code transcripts.
+ *
+ * This service uses LLM to analyze transcript content and identify:
+ * - Technical decisions with rationale
+ * - Gotchas and pitfalls to avoid
+ * - Patterns that worked well
+ * - Future improvements
+ *
+ * Design: Following DD-006 patterns for LLM integration with pluggable backends.
+ * Supports Anthropic, OpenAI, and noop backends with graceful degradation.
+ *
+ * @see PRD-015 for the JSONL daemon and knowledge promotion pipeline
+ */
+export declare class CandidateExtractorService extends CandidateExtractorService_base {
+}
+/**
+ * Noop implementation - returns empty results without LLM processing.
+ * Used when no LLM API key is configured or for testing.
+ */
+export declare const CandidateExtractorServiceNoop: Layer.Layer<CandidateExtractorService, never, never>;
+/**
+ * Anthropic (Claude) implementation.
+ * Uses Claude to extract learning candidates from transcripts.
+ */
+export declare const CandidateExtractorServiceAnthropic: Layer.Layer<CandidateExtractorService, ExtractionUnavailableError, never>;
+/**
+ * OpenAI (GPT) implementation.
+ * Uses GPT to extract learning candidates from transcripts.
+ */
+export declare const CandidateExtractorServiceOpenAI: Layer.Layer<CandidateExtractorService, ExtractionUnavailableError, never>;
+/**
+ * Auto-detecting layer that selects the appropriate backend based on environment.
+ *
+ * Priority:
+ * 1. ANTHROPIC_API_KEY set → Use Anthropic (Claude)
+ * 2. OPENAI_API_KEY set → Use OpenAI (GPT)
+ * 3. Neither set → Use Noop (graceful degradation)
+ *
+ * This allows graceful degradation when no LLM API keys are configured.
+ */
+export declare const CandidateExtractorServiceAuto: Layer.Layer<CandidateExtractorService, ExtractionUnavailableError, never>;
+export {};
+//# sourceMappingURL=candidate-extractor-service.d.ts.map

package/dist/services/candidate-extractor-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidate-extractor-service.d.ts","sourceRoot":"","sources":["../../src/services/candidate-extractor-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAkB,MAAM,QAAQ,CAAA;AAC/D,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAA;AACzD,OAAO,KAAK,EACV,eAAe,EAEf,gBAAgB,EAGjB,MAAM,yBAAyB,CAAA;;IAgL5B;;;OAGG;sBACe,CAAC,KAAK,EAAE,eAAe,KAAK,MAAM,CAAC,MAAM,CAAC,gBAAgB,EAAE,0BAA0B,CAAC;IACzG,qDAAqD;0BAC/B,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;;AAvBtD;;;;;;;;;;;;;GAaG;AACH,qBAAa,yBAA0B,SAAQ,8BAW5C;CAAG;AAEN;;;GAGG;AACH,eAAO,MAAM,6BAA6B,sDAUzC,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,kCAAkC,2EA0G9C,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,+BAA+B,2EA4G3C,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,6BAA6B,2EAmBzC,CAAA"}

package/dist/services/candidate-extractor-service.js

@@ -0,0 +1,365 @@
+import { Context, Effect, Layer, Config, Option } from "effect";
+import { ExtractionUnavailableError } from "../errors.js";
+/**
+ * The prompt template for learning candidate extraction.
+ * Designed to extract actionable, generalizable learnings from Claude Code transcripts.
+ * @see PRD-015 for specification
+ */
+const EXTRACTION_PROMPT = `Analyze this Claude Code session transcript and extract actionable learnings.
+
+<transcript>
+{transcript_excerpt}
+</transcript>
+
+Extract learnings that meet these criteria:
+1. **Technical decisions**: Describes a choice and its rationale
+2. **Gotchas/pitfalls**: Something to avoid next time
+3. **Patterns that worked**: Reusable approaches
+4. **Future improvements**: Things to do differently
+
+For each learning, provide:
+- content: The learning text (1-3 sentences, actionable)
+- confidence: "high" (certain, tested), "medium" (likely useful), "low" (speculative)
+- category: One of [architecture, testing, performance, security, debugging, tooling, patterns, other]
+
+Return JSON array:
+[
+  {
+    "content": "Always wrap database operations in transactions to ensure atomicity",
+    "confidence": "high",
+    "category": "patterns"
+  }
+]
+
+Rules:
+- Skip generic advice (things any developer knows)
+- Skip context-specific details that won't generalize
+- Prefer actionable "do X when Y" format
+- Maximum 5 learnings per transcript
+- If no meaningful learnings found, return empty array: []`;
+/**
+ * Valid confidence levels for validation.
+ */
+const VALID_CONFIDENCES = ["high", "medium", "low"];
+/**
+ * Valid categories for validation.
+ */
+const VALID_CATEGORIES = [
+    "architecture",
+    "testing",
+    "performance",
+    "security",
+    "debugging",
+    "tooling",
+    "patterns",
+    "other"
+];
+/**
+ * Parse LLM JSON response, handling common formatting issues.
+ * Robust parser following DD-006 patterns.
+ */
+const parseLlmJson = (raw) => {
+    // Step 1: Try direct parse
+    try {
+        return JSON.parse(raw);
+    }
+    catch { /* continue */ }
+    // Step 2: Strip markdown code fences
+    const fenceMatch = raw.match(/```(?:json)?\s*\n?([\s\S]*?)```/);
+    if (fenceMatch && fenceMatch[1]) {
+        try {
+            return JSON.parse(fenceMatch[1].trim());
+        }
+        catch { /* continue */ }
+    }
+    // Step 3: Find first [ or { and parse from there
+    const jsonStart = raw.search(/[[{]/);
+    if (jsonStart >= 0) {
+        const candidate = raw.slice(jsonStart);
+        try {
+            return JSON.parse(candidate);
+        }
+        catch { /* continue */ }
+        // Step 4: Find matching bracket and extract
+        const openChar = candidate[0];
+        const closeChar = openChar === "[" ? "]" : "}";
+        const lastClose = candidate.lastIndexOf(closeChar);
+        if (lastClose > 0) {
+            try {
+                return JSON.parse(candidate.slice(0, lastClose + 1));
+            }
+            catch { /* continue */ }
+        }
+    }
+    return null;
+};
+/**
+ * Validate and normalize an extracted candidate from LLM response.
+ * Returns null if the candidate is invalid.
+ */
+const validateCandidate = (raw) => {
+    if (!raw || typeof raw !== "object")
+        return null;
+    const obj = raw;
+    // Validate content
+    if (typeof obj.content !== "string" || obj.content.trim().length === 0)
+        return null;
+    const content = obj.content.trim();
+    // Skip if content is too short (likely not actionable)
+    if (content.length < 10)
+        return null;
+    // Validate confidence
+    const rawConfidence = String(obj.confidence || "").toLowerCase();
+    const confidence = VALID_CONFIDENCES.includes(rawConfidence)
+        ? rawConfidence
+        : "medium"; // Default to medium if invalid
+    // Validate category
+    const rawCategory = String(obj.category || "").toLowerCase();
+    const category = VALID_CATEGORIES.includes(rawCategory)
+        ? rawCategory
+        : "other"; // Default to other if invalid
+    return { content, confidence, category };
+};
+/**
+ * CandidateExtractorService extracts learning candidates from Claude Code transcripts.
+ *
+ * This service uses LLM to analyze transcript content and identify:
+ * - Technical decisions with rationale
+ * - Gotchas and pitfalls to avoid
+ * - Patterns that worked well
+ * - Future improvements
+ *
+ * Design: Following DD-006 patterns for LLM integration with pluggable backends.
+ * Supports Anthropic, OpenAI, and noop backends with graceful degradation.
+ *
+ * @see PRD-015 for the JSONL daemon and knowledge promotion pipeline
+ */
+export class CandidateExtractorService extends Context.Tag("CandidateExtractorService")() {
+}
+/**
+ * Noop implementation - returns empty results without LLM processing.
+ * Used when no LLM API key is configured or for testing.
+ */
+export const CandidateExtractorServiceNoop = Layer.succeed(CandidateExtractorService, {
+    extract: (chunk) => Effect.succeed({
+        candidates: [],
+        sourceChunk: chunk,
+        wasExtracted: false
+    }),
+    isAvailable: () => Effect.succeed(false)
+});
+/**
+ * Anthropic (Claude) implementation.
+ * Uses Claude to extract learning candidates from transcripts.
+ */
+export const CandidateExtractorServiceAnthropic = Layer.effect(CandidateExtractorService, Effect.gen(function* () {
+    // Read API key from environment
+    const apiKey = yield* Config.string("ANTHROPIC_API_KEY").pipe(Effect.mapError(() => new ExtractionUnavailableError({
+        reason: "ANTHROPIC_API_KEY environment variable is not set"
+    })));
+    // Lazy-load client
+    let client = null;
+    const ensureClient = Effect.gen(function* () {
+        if (client)
+            return client;
+        // Dynamic import of Anthropic SDK (optional peer dependency)
+        const Anthropic = yield* Effect.tryPromise({
+            try: async () => {
+                // @ts-expect-error - @anthropic-ai/sdk is an optional peer dependency
+                const mod = await import("@anthropic-ai/sdk");
+                return mod.default;
+            },
+            catch: () => new ExtractionUnavailableError({
+                reason: "@anthropic-ai/sdk is not installed"
+            })
+        });
+        client = new Anthropic({ apiKey });
+        return client;
+    });
+    return {
+        extract: (chunk) => Effect.gen(function* () {
+            const startTime = Date.now();
+            const anthropic = yield* ensureClient;
+            // Build prompt with transcript content
+            const prompt = EXTRACTION_PROMPT.replace("{transcript_excerpt}", chunk.content);
+            const response = yield* Effect.tryPromise({
+                try: () => anthropic.messages.create({
+                    model: "claude-haiku-4-20250514",
+                    max_tokens: 1024,
+                    messages: [{
+                            role: "user",
+                            content: prompt
+                        }]
+                }),
+                catch: (e) => new ExtractionUnavailableError({
+                    reason: `Anthropic API call failed: ${String(e)}`
+                })
+            });
+            // Extract text from response
+            const textContent = response.content.find(c => c.type === "text");
+            if (!textContent || !textContent.text) {
+                return {
+                    candidates: [],
+                    sourceChunk: chunk,
+                    wasExtracted: true,
+                    metadata: {
+                        model: "claude-haiku-4-20250514",
+                        tokensUsed: (response.usage?.input_tokens ?? 0) + (response.usage?.output_tokens ?? 0),
+                        durationMs: Date.now() - startTime
+                    }
+                };
+            }
+            // Parse the JSON array of candidates
+            const rawCandidates = parseLlmJson(textContent.text);
+            if (!rawCandidates || !Array.isArray(rawCandidates)) {
+                return {
+                    candidates: [],
+                    sourceChunk: chunk,
+                    wasExtracted: true,
+                    metadata: {
+                        model: "claude-haiku-4-20250514",
+                        tokensUsed: (response.usage?.input_tokens ?? 0) + (response.usage?.output_tokens ?? 0),
+                        durationMs: Date.now() - startTime
+                    }
+                };
+            }
+            // Validate and normalize each candidate
+            const candidates = rawCandidates
+                .map(validateCandidate)
+                .filter((c) => c !== null)
+                .slice(0, 5); // Max 5 candidates per chunk
+            return {
+                candidates,
+                sourceChunk: chunk,
+                wasExtracted: true,
+                metadata: {
+                    model: "claude-haiku-4-20250514",
+                    tokensUsed: (response.usage?.input_tokens ?? 0) + (response.usage?.output_tokens ?? 0),
+                    durationMs: Date.now() - startTime
+                }
+            };
+        }),
+        isAvailable: () => Effect.succeed(true)
+    };
+}));
+/**
+ * OpenAI (GPT) implementation.
+ * Uses GPT to extract learning candidates from transcripts.
+ */
+export const CandidateExtractorServiceOpenAI = Layer.effect(CandidateExtractorService, Effect.gen(function* () {
+    // Read API key from environment
+    const apiKey = yield* Config.string("OPENAI_API_KEY").pipe(Effect.mapError(() => new ExtractionUnavailableError({
+        reason: "OPENAI_API_KEY environment variable is not set"
+    })));
+    // Lazy-load client
+    let client = null;
+    const ensureClient = Effect.gen(function* () {
+        if (client)
+            return client;
+        // Dynamic import of OpenAI SDK (optional peer dependency)
+        const OpenAI = yield* Effect.tryPromise({
+            try: async () => {
+                // @ts-expect-error - openai is an optional peer dependency
+                const mod = await import("openai");
+                return mod.default;
+            },
+            catch: () => new ExtractionUnavailableError({
+                reason: "openai package is not installed"
+            })
+        });
+        client = new OpenAI({ apiKey });
+        return client;
+    });
+    return {
+        extract: (chunk) => Effect.gen(function* () {
+            const startTime = Date.now();
+            const openai = yield* ensureClient;
+            // Build prompt with transcript content
+            const prompt = EXTRACTION_PROMPT.replace("{transcript_excerpt}", chunk.content);
+            const response = yield* Effect.tryPromise({
+                try: () => openai.chat.completions.create({
+                    model: "gpt-4o-mini",
+                    max_tokens: 1024,
+                    messages: [{
+                            role: "user",
+                            content: prompt
+                        }],
+                    response_format: { type: "json_object" }
+                }),
+                catch: (e) => new ExtractionUnavailableError({
+                    reason: `OpenAI API call failed: ${String(e)}`
+                })
+            });
+            // Extract text from response
+            const textContent = response.choices[0]?.message?.content;
+            if (!textContent) {
+                return {
+                    candidates: [],
+                    sourceChunk: chunk,
+                    wasExtracted: true,
+                    metadata: {
+                        model: "gpt-4o-mini",
+                        tokensUsed: (response.usage?.prompt_tokens ?? 0) + (response.usage?.completion_tokens ?? 0),
+                        durationMs: Date.now() - startTime
+                    }
+                };
+            }
+            // Parse the JSON array of candidates
+            // OpenAI with json_object mode might wrap in an object
+            const parsed = parseLlmJson(textContent);
+            let rawCandidates = [];
+            if (Array.isArray(parsed)) {
+                rawCandidates = parsed;
+            }
+            else if (parsed && typeof parsed === "object") {
+                // Handle wrapped response like { candidates: [...] } or { learnings: [...] }
+                const obj = parsed;
+                const arrayField = Object.values(obj).find(Array.isArray);
+                if (arrayField) {
+                    rawCandidates = arrayField;
+                }
+            }
+            // Validate and normalize each candidate
+            const candidates = rawCandidates
+                .map(validateCandidate)
+                .filter((c) => c !== null)
+                .slice(0, 5); // Max 5 candidates per chunk
+            return {
+                candidates,
+                sourceChunk: chunk,
+                wasExtracted: true,
+                metadata: {
+                    model: "gpt-4o-mini",
+                    tokensUsed: (response.usage?.prompt_tokens ?? 0) + (response.usage?.completion_tokens ?? 0),
+                    durationMs: Date.now() - startTime
+                }
+            };
+        }),
+        isAvailable: () => Effect.succeed(true)
+    };
+}));
+/**
+ * Auto-detecting layer that selects the appropriate backend based on environment.
+ *
+ * Priority:
+ * 1. ANTHROPIC_API_KEY set → Use Anthropic (Claude)
+ * 2. OPENAI_API_KEY set → Use OpenAI (GPT)
+ * 3. Neither set → Use Noop (graceful degradation)
+ *
+ * This allows graceful degradation when no LLM API keys are configured.
+ */
+export const CandidateExtractorServiceAuto = Layer.unwrapEffect(Effect.gen(function* () {
+    // Check for Anthropic API key first (preferred)
+    const anthropicKey = yield* Config.string("ANTHROPIC_API_KEY").pipe(Effect.option);
+    if (Option.isSome(anthropicKey) && anthropicKey.value.trim().length > 0) {
+        return CandidateExtractorServiceAnthropic;
+    }
+    // Fall back to OpenAI if available
+    const openaiKey = yield* Config.string("OPENAI_API_KEY").pipe(Effect.option);
+    if (Option.isSome(openaiKey) && openaiKey.value.trim().length > 0) {
+        return CandidateExtractorServiceOpenAI;
+    }
+    // No API keys configured - use noop
+    return CandidateExtractorServiceNoop;
+}));
+//# sourceMappingURL=candidate-extractor-service.js.map

package/dist/services/candidate-extractor-service.js.map

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

package/dist/services/claim-service.d.ts

@@ -0,0 +1,52 @@
+/**
+ * ClaimService - PRD-018
+ *
+ * Manages task claims with lease-based expiration.
+ * Uses Effect-TS patterns per DD-002.
+ */
+import { Context, Effect, Layer } from "effect";
+import { ClaimRepository } from "../repo/claim-repo.js";
+import { TaskRepository } from "../repo/task-repo.js";
+import { OrchestratorStateRepository } from "../repo/orchestrator-state-repo.js";
+import { AlreadyClaimedError, ClaimIdNotFoundError, ClaimNotFoundError, DatabaseError, LeaseExpiredError, MaxRenewalsExceededError, TaskNotFoundError } from "../errors.js";
+import type { TaskClaim } from "../schemas/worker.js";
+declare const ClaimService_base: Context.TagClass<ClaimService, "ClaimService", {
+    /**
+     * Claim a task for a worker with a lease.
+     * The lease duration is taken from orchestrator config or defaults to 30 minutes.
+     */
+    readonly claim: (taskId: string, workerId: string, leaseDurationMinutes?: number) => Effect.Effect<TaskClaim, TaskNotFoundError | AlreadyClaimedError | DatabaseError>;
+    /**
+     * Release a claim on a task.
+     * Only the worker who holds the claim can release it.
+     */
+    readonly release: (taskId: string, workerId: string) => Effect.Effect<void, ClaimNotFoundError | DatabaseError>;
+    /**
+     * Renew the lease on an existing claim.
+     * Fails if the claim is expired or max renewals exceeded.
+     */
+    readonly renew: (taskId: string, workerId: string) => Effect.Effect<TaskClaim, ClaimNotFoundError | LeaseExpiredError | MaxRenewalsExceededError | DatabaseError>;
+    /**
+     * Get all claims that have expired but are still marked as active.
+     */
+    readonly getExpired: () => Effect.Effect<readonly TaskClaim[], DatabaseError>;
+    /**
+     * Mark a claim as expired.
+     * Used during reconciliation to handle stale claims.
+     */
+    readonly expire: (claimId: number) => Effect.Effect<void, ClaimIdNotFoundError | DatabaseError>;
+    /**
+     * Release all active claims held by a worker.
+     * Used during worker deregistration.
+     */
+    readonly releaseByWorker: (workerId: string) => Effect.Effect<number, DatabaseError>;
+    /**
+     * Get the active claim for a task, if any.
+     */
+    readonly getActiveClaim: (taskId: string) => Effect.Effect<TaskClaim | null, DatabaseError>;
+}>;
+export declare class ClaimService extends ClaimService_base {
+}
+export declare const ClaimServiceLive: Layer.Layer<ClaimService, never, TaskRepository | ClaimRepository | OrchestratorStateRepository>;
+export {};
+//# sourceMappingURL=claim-service.d.ts.map

package/dist/services/claim-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claim-service.d.ts","sourceRoot":"","sources":["../../src/services/claim-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAA;AAChF,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,wBAAwB,EACxB,iBAAiB,EAClB,MAAM,cAAc,CAAA;AACrB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;;IAWjD;;;OAGG;oBACa,CACd,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,oBAAoB,CAAC,EAAE,MAAM,KAC1B,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,iBAAiB,GAAG,mBAAmB,GAAG,aAAa,CAAC;IAEtF;;;OAGG;sBACe,CAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,KACb,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,kBAAkB,GAAG,aAAa,CAAC;IAE5D;;;OAGG;oBACa,CACd,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,KACb,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,kBAAkB,GAAG,iBAAiB,GAAG,wBAAwB,GAAG,aAAa,CAAC;IAEhH;;OAEG;yBACkB,MAAM,MAAM,CAAC,MAAM,CAAC,SAAS,SAAS,EAAE,EAAE,aAAa,CAAC;IAE7E;;;OAGG;qBACc,CACf,OAAO,EAAE,MAAM,KACZ,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,oBAAoB,GAAG,aAAa,CAAC;IAE9D;;;OAGG;8BACuB,CACxB,QAAQ,EAAE,MAAM,KACb,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC;IAEzC;;OAEG;6BACsB,CACvB,MAAM,EAAE,MAAM,KACX,MAAM,CAAC,MAAM,CAAC,SAAS,GAAG,IAAI,EAAE,aAAa,CAAC;;AAzDvD,qBAAa,YAAa,SAAQ,iBA2D/B;CAAG;AAEN,eAAO,MAAM,gBAAgB,kGA6J5B,CAAA"}