@generacy-ai/workflow-engine 0.0.0-preview-20260304013206

package/dist/actions/builtin/humancy-api-handler.js

@@ -0,0 +1,521 @@
+import { CorrelationTimeoutError } from '../../errors/correlation-timeout.js';
+/** Default no-op logger used when none is provided. */
+const noopLogger = {
+    info() { },
+    warn() { },
+    error() { },
+    debug() { },
+};
+// ---------------------------------------------------------------------------
+// Mapping helpers
+// ---------------------------------------------------------------------------
+/** Buffer added to the caller's timeout for the expiresAt field (5 minutes). */
+const EXPIRY_BUFFER_MS = 5 * 60 * 1000;
+/**
+ * Maps workflow-engine urgency to Humancy Cloud API urgency.
+ */
+function mapUrgency(urgency) {
+    switch (urgency) {
+        case 'low':
+        case 'normal':
+            return 'when_available';
+        case 'blocking_soon':
+            return 'blocking_soon';
+        case 'blocking_now':
+            return 'blocking_now';
+    }
+}
+// ---------------------------------------------------------------------------
+// Handler
+// ---------------------------------------------------------------------------
+/**
+ * Concrete HumanDecisionHandler that communicates with the Humancy
+ * Cloud API's decision endpoints to request and await human decisions.
+ */
+export class HumancyApiDecisionHandler {
+    config;
+    logger;
+    constructor(config, logger) {
+        this.config = {
+            apiUrl: config.apiUrl.replace(/\/+$/, ''), // strip trailing slashes
+            agentId: config.agentId,
+            projectId: config.projectId,
+            authToken: config.authToken,
+            fallbackToSimulation: config.fallbackToSimulation ?? true,
+            sseReconnectDelay: config.sseReconnectDelay ?? 1000,
+            maxReconnectAttempts: config.maxReconnectAttempts ?? 10,
+        };
+        this.logger = logger ?? noopLogger;
+    }
+    /**
+     * Maps a workflow-engine ReviewDecisionRequest to the Humancy Cloud API's
+     * POST /decisions payload (CreateDecisionInput shape).
+     *
+     * Field mapping:
+     *   title        → question
+     *   description  → context (with workflow/step metadata)
+     *   artifact     → appended to context
+     *   options      → options (requiresComment → description hint)
+     *   urgency      → urgency (low/normal → when_available)
+     *   type         → type ('review')
+     *   config.agentId → agentId
+     *   config.projectId → projectId
+     *   timeout+5min  → expiresAt
+     */
+    mapRequestToPayload(request, timeout) {
+        // Build context string from description, artifact, and workflow metadata
+        const contextParts = [];
+        if (request.description) {
+            contextParts.push(request.description);
+        }
+        if (request.artifact) {
+            contextParts.push(`\n---\nArtifact:\n${request.artifact}`);
+        }
+        // Include workflow/step IDs as metadata for traceability
+        contextParts.push(`\n[workflow=${request.workflowId}, step=${request.stepId}]`);
+        const context = contextParts.join('');
+        const options = request.options.map((opt) => {
+            const mapped = {
+                id: opt.id,
+                label: opt.label,
+            };
+            if (opt.requiresComment) {
+                mapped.description = 'Comment required';
+            }
+            return mapped;
+        });
+        const payload = {
+            agentId: this.config.agentId,
+            type: 'review',
+            urgency: mapUrgency(request.urgency),
+            question: request.title,
+            context,
+            options: options.length > 0 ? options : undefined,
+            expiresAt: new Date(Date.now() + timeout + EXPIRY_BUFFER_MS).toISOString(),
+        };
+        if (this.config.projectId) {
+            payload.projectId = this.config.projectId;
+        }
+        return payload;
+    }
+    /**
+     * Maps a Humancy Cloud API decision:resolved event response back to the
+     * workflow engine's ReviewDecisionResponse format.
+     *
+     * Response mapping:
+     *   selectedOptionId === first option → approved: true
+     *   selectedOptionId !== first option → approved: false, decision: selectedOptionId
+     *   customResponse   → input (free-text response)
+     *   respondedAt      → respondedAt
+     */
+    mapResolvedEvent(response, request) {
+        const result = {
+            respondedBy: 'human',
+            respondedAt: response.respondedAt,
+        };
+        if (response.customResponse) {
+            result.input = response.customResponse;
+        }
+        const firstOptionId = request.options[0]?.id;
+        if (response.selectedOptionId) {
+            result.decision = response.selectedOptionId;
+            result.approved = response.selectedOptionId === firstOptionId;
+        }
+        else if (response.customResponse) {
+            // Free-text response without option selection — treat as custom input
+            result.approved = false;
+        }
+        else {
+            // No option selected and no custom response — treat as rejection
+            result.approved = false;
+        }
+        return result;
+    }
+    /**
+     * Async generator that parses SSE text protocol from a fetch Response body.
+     *
+     * Reads the streaming body via `getReader()`, splits on newlines, and
+     * interprets SSE fields:
+     *   - `event: <type>` — sets the event type
+     *   - `data: <payload>` — appends to data buffer (multi-line joined with \n)
+     *   - `id: <value>` — sets the event ID and updates lastEventId
+     *   - `:<comment>` — ignored (used for heartbeats)
+     *   - empty line — dispatches the accumulated event
+     *
+     * Tracks `lastEventId` on the instance for reconnection support.
+     */
+    lastEventId = '';
+    async *parseSSEStream(body) {
+        const reader = body.getReader();
+        const decoder = new TextDecoder();
+        // Accumulator for partial lines split across chunks
+        let buffer = '';
+        // Current event fields being accumulated
+        let eventType = '';
+        let dataLines = [];
+        let eventId = '';
+        try {
+            for (;;) {
+                const { done, value } = await reader.read();
+                if (done) {
+                    // Stream ended — if there's a pending event with data, dispatch it
+                    if (dataLines.length > 0) {
+                        yield { event: eventType, data: dataLines.join('\n'), id: eventId };
+                    }
+                    break;
+                }
+                buffer += decoder.decode(value, { stream: true });
+                // Process complete lines (SSE uses \n, \r\n, or \r as line endings)
+                const lines = buffer.split(/\r\n|\r|\n/);
+                // The last element may be an incomplete line — keep it in the buffer
+                buffer = lines.pop() ?? '';
+                for (const line of lines) {
+                    if (line === '') {
+                        // Empty line = dispatch event (only if we have data)
+                        if (dataLines.length > 0) {
+                            const parsed = {
+                                event: eventType,
+                                data: dataLines.join('\n'),
+                                id: eventId,
+                            };
+                            // Update lastEventId for reconnection (per SSE spec:
+                            // only update when id field was present in the event)
+                            if (eventId) {
+                                this.lastEventId = eventId;
+                            }
+                            yield parsed;
+                            // Reset accumulators for next event
+                            eventType = '';
+                            dataLines = [];
+                            eventId = '';
+                        }
+                        continue;
+                    }
+                    if (line.startsWith(':')) {
+                        // Comment line (heartbeat) — ignore
+                        continue;
+                    }
+                    // Parse field name and value
+                    const colonIndex = line.indexOf(':');
+                    let field;
+                    let fieldValue;
+                    if (colonIndex === -1) {
+                        // Line with no colon — field name is the entire line, value is empty
+                        field = line;
+                        fieldValue = '';
+                    }
+                    else {
+                        field = line.slice(0, colonIndex);
+                        // Per SSE spec: if first char after colon is a space, strip it
+                        fieldValue = line[colonIndex + 1] === ' '
+                            ? line.slice(colonIndex + 2)
+                            : line.slice(colonIndex + 1);
+                    }
+                    switch (field) {
+                        case 'event':
+                            eventType = fieldValue;
+                            break;
+                        case 'data':
+                            dataLines.push(fieldValue);
+                            break;
+                        case 'id':
+                            // Per SSE spec: ignore id fields containing null (\0)
+                            if (!fieldValue.includes('\0')) {
+                                eventId = fieldValue;
+                            }
+                            break;
+                        case 'retry':
+                            // Retry field — not used by this parser (reconnection logic
+                            // is handled by connectSSE with fixed config delays)
+                            break;
+                        default:
+                            // Unknown field — ignore per SSE spec
+                            break;
+                    }
+                }
+            }
+        }
+        finally {
+            reader.releaseLock();
+        }
+    }
+    /**
+     * Connects to the Humancy Cloud API's SSE endpoint and yields parsed events,
+     * automatically reconnecting on stream errors or unexpected closes.
+     *
+     * Uses `GET {apiUrl}/decisions/events?token={authToken}` with:
+     *   - Auth via `token` query parameter (Humancy SSE auth convention)
+     *   - `Last-Event-ID` header on reconnection attempts
+     *   - `Accept: text/event-stream` header
+     *
+     * The generator transparently reconnects up to `maxReconnectAttempts` times
+     * with a delay of `sseReconnectDelay` ms between attempts. Each reconnection
+     * sends the last received event ID so the server can replay missed events.
+     *
+     * Cancellation is supported via the provided `AbortSignal` — when aborted,
+     * the current fetch is cancelled and the generator returns cleanly.
+     */
+    async *connectSSE(signal) {
+        let attempts = 0;
+        while (attempts <= this.config.maxReconnectAttempts) {
+            // Build SSE endpoint URL with token auth via query parameter
+            const sseUrl = new URL(`${this.config.apiUrl}/decisions/events`);
+            if (this.config.authToken) {
+                sseUrl.searchParams.set('token', this.config.authToken);
+            }
+            const url = sseUrl.toString();
+            // Build headers
+            const headers = {
+                Accept: 'text/event-stream',
+                'Cache-Control': 'no-cache',
+            };
+            if (this.lastEventId) {
+                headers['Last-Event-ID'] = this.lastEventId;
+            }
+            let response;
+            try {
+                response = await fetch(url, {
+                    method: 'GET',
+                    headers,
+                    signal,
+                });
+            }
+            catch (err) {
+                // If the signal was aborted, exit cleanly (timeout or cancellation)
+                if (signal.aborted) {
+                    return;
+                }
+                attempts++;
+                if (attempts > this.config.maxReconnectAttempts) {
+                    this.logger.error(`SSE connection failed after ${this.config.maxReconnectAttempts} reconnection attempts: ${String(err)}`);
+                    throw new Error(`SSE connection failed after ${this.config.maxReconnectAttempts} attempts: ${String(err)}`);
+                }
+                this.logger.warn(`SSE connection error, reconnecting (attempt ${attempts}/${this.config.maxReconnectAttempts}): ${String(err)}`);
+                await this.delay(this.config.sseReconnectDelay, signal);
+                if (signal.aborted)
+                    return;
+                continue;
+            }
+            // Check for non-200 responses
+            if (!response.ok) {
+                attempts++;
+                if (attempts > this.config.maxReconnectAttempts) {
+                    this.logger.error(`SSE endpoint returned ${response.status} after ${this.config.maxReconnectAttempts} reconnection attempts`);
+                    throw new Error(`SSE connection failed: server returned ${response.status} ${response.statusText}`);
+                }
+                this.logger.warn(`SSE endpoint returned ${response.status}, reconnecting (attempt ${attempts}/${this.config.maxReconnectAttempts})`);
+                await this.delay(this.config.sseReconnectDelay, signal);
+                if (signal.aborted)
+                    return;
+                continue;
+            }
+            if (!response.body) {
+                throw new Error('SSE response has no body');
+            }
+            this.logger.debug(`SSE connected to ${this.config.apiUrl}/decisions/events${this.lastEventId ? ` (resuming from ${this.lastEventId})` : ''}`);
+            // Reset attempts on successful connection
+            attempts = 0;
+            // Parse and yield events from the stream
+            try {
+                for await (const event of this.parseSSEStream(response.body)) {
+                    yield event;
+                }
+            }
+            catch (err) {
+                // If the signal was aborted, exit cleanly
+                if (signal.aborted) {
+                    return;
+                }
+                // Stream broke unexpectedly — attempt reconnection
+                attempts++;
+                if (attempts > this.config.maxReconnectAttempts) {
+                    this.logger.error(`SSE stream broke after ${this.config.maxReconnectAttempts} reconnection attempts: ${String(err)}`);
+                    throw new Error(`SSE stream failed after ${this.config.maxReconnectAttempts} reconnection attempts: ${String(err)}`);
+                }
+                this.logger.warn(`SSE stream error, reconnecting (attempt ${attempts}/${this.config.maxReconnectAttempts}): ${String(err)}`);
+                await this.delay(this.config.sseReconnectDelay, signal);
+                if (signal.aborted)
+                    return;
+                continue;
+            }
+            // Stream ended cleanly (server closed connection) — reconnect
+            // This can happen if the server restarts or the connection times out
+            attempts++;
+            if (attempts > this.config.maxReconnectAttempts) {
+                this.logger.error(`SSE stream closed by server after ${this.config.maxReconnectAttempts} reconnection attempts`);
+                throw new Error(`SSE connection lost: stream closed by server after ${this.config.maxReconnectAttempts} reconnection attempts`);
+            }
+            this.logger.warn(`SSE stream closed by server, reconnecting (attempt ${attempts}/${this.config.maxReconnectAttempts})`);
+            await this.delay(this.config.sseReconnectDelay, signal);
+            if (signal.aborted)
+                return;
+        }
+    }
+    /**
+     * Delay helper that respects AbortSignal for cancellation.
+     * Resolves after `ms` milliseconds, or immediately if the signal is aborted.
+     */
+    delay(ms, signal) {
+        return new Promise((resolve) => {
+            if (signal.aborted) {
+                resolve();
+                return;
+            }
+            const timer = setTimeout(resolve, ms);
+            signal.addEventListener('abort', () => {
+                clearTimeout(timer);
+                resolve();
+            }, { once: true });
+        });
+    }
+    /**
+     * Request a human decision via the Humancy Cloud API.
+     *
+     * Flow:
+     *   1. Map ReviewDecisionRequest → CreateDecisionPayload
+     *   2. POST /decisions to create the decision
+     *   3. On POST failure → fall back to simulation if configured
+     *   4. Connect to SSE stream and wait for decision:resolved matching the decision ID
+     *   5. Extract response from the event data
+     *   6. Map response → ReviewDecisionResponse
+     *   7. Clean up timeout timer and SSE connection
+     *
+     * Throws CorrelationTimeoutError if the timeout elapses before a response.
+     */
+    async requestDecision(request, timeout) {
+        // --- Step 1: Map request to Humancy Cloud API payload ---
+        const payload = this.mapRequestToPayload(request, timeout);
+        // --- Step 2: Set up abort controller for timeout management ---
+        const controller = new AbortController();
+        const { signal } = controller;
+        let timeoutTimer;
+        let decisionId;
+        try {
+            // --- Step 3: POST /decisions to create the decision ---
+            const createUrl = `${this.config.apiUrl}/decisions`;
+            const headers = {
+                'Content-Type': 'application/json',
+            };
+            if (this.config.authToken) {
+                headers['Authorization'] = `Bearer ${this.config.authToken}`;
+            }
+            let createResponse;
+            try {
+                createResponse = await fetch(createUrl, {
+                    method: 'POST',
+                    headers,
+                    body: JSON.stringify(payload),
+                    signal,
+                });
+            }
+            catch (err) {
+                // Network error during POST — apply fallback logic
+                return this.handlePostFailure(err, 'network');
+            }
+            if (!createResponse.ok) {
+                // HTTP error — classify and apply fallback logic
+                const status = createResponse.status;
+                const body = await createResponse.text().catch(() => '');
+                const errorMsg = `POST /decisions failed: ${status} ${createResponse.statusText}${body ? ` — ${body}` : ''}`;
+                if (status >= 400 && status < 500) {
+                    // 4xx = client error / misconfiguration — always throw, never fall back
+                    throw new Error(errorMsg);
+                }
+                // 5xx = server error — apply fallback logic
+                return this.handlePostFailure(new Error(errorMsg), 'server');
+            }
+            // Humancy Cloud API returns { id, status, createdAt, expiresAt, success, data }
+            const createdItem = (await createResponse.json());
+            decisionId = createdItem.id;
+            this.logger.info(`Decision created: ${decisionId} (workflow=${request.workflowId}, step=${request.stepId})`);
+            // --- Step 4: Set up timeout timer ---
+            // The timer aborts the SSE connection and rejects with CorrelationTimeoutError
+            const timeoutPromise = new Promise((_resolve, reject) => {
+                timeoutTimer = setTimeout(() => {
+                    this.logger.error(`Decision timed out: ${decisionId} after ${timeout}ms (workflow=${request.workflowId}, step=${request.stepId})`);
+                    controller.abort();
+                    reject(new CorrelationTimeoutError(`Decision ${decisionId} timed out after ${timeout}ms`, decisionId));
+                }, timeout);
+            });
+            // --- Step 5: Connect to SSE and wait for matching event ---
+            const resolutionPromise = this.waitForResolution(decisionId, request, signal);
+            // Race: resolution vs timeout
+            const result = await Promise.race([resolutionPromise, timeoutPromise]);
+            return result;
+        }
+        finally {
+            // --- Step 7: Clean up ---
+            if (timeoutTimer !== undefined) {
+                clearTimeout(timeoutTimer);
+            }
+            // Abort any in-flight SSE connection if still open
+            if (!signal.aborted) {
+                controller.abort();
+            }
+        }
+    }
+    /**
+     * Connects to SSE and waits for a `decision:resolved` event whose
+     * `data.id` matches the given decisionId. Returns the mapped response.
+     *
+     * Humancy Cloud API SSE event format:
+     *   event: decision:resolved
+     *   id: evt_<timestamp>_<random>
+     *   data: { id, type, urgency, preview, projectId, status, response }
+     */
+    async waitForResolution(decisionId, request, signal) {
+        for await (const event of this.connectSSE(signal)) {
+            this.logger.debug(`SSE event received: ${event.event} (id=${event.id})`);
+            if (event.event !== 'decision:resolved') {
+                continue;
+            }
+            // Parse the event data to check if it matches our decision
+            let eventData;
+            try {
+                eventData = JSON.parse(event.data);
+            }
+            catch {
+                this.logger.warn(`Failed to parse SSE event data: ${event.data.slice(0, 200)}`);
+                continue;
+            }
+            if (eventData.id !== decisionId) {
+                continue;
+            }
+            // Matched! Extract the response from the event data
+            if (!eventData.response) {
+                this.logger.warn(`decision:resolved event for ${decisionId} has no response — treating as rejection`);
+                return {
+                    approved: false,
+                    respondedBy: 'human',
+                    respondedAt: new Date().toISOString(),
+                };
+            }
+            const mapped = this.mapResolvedEvent(eventData.response, request);
+            this.logger.info(`Decision resolved: ${decisionId} (${mapped.approved ? 'approved' : 'rejected'}${mapped.decision ? `, decision=${mapped.decision}` : ''})`);
+            return mapped;
+        }
+        // SSE stream exhausted without matching event (all reconnect attempts failed)
+        throw new Error(`SSE stream ended without receiving resolution for decision ${decisionId}`);
+    }
+    /**
+     * Handles POST /decisions failures with optional simulation fallback.
+     *
+     * Fallback rules:
+     *   - Network errors (connection refused, DNS, fetch errors) → fall back if configured
+     *   - 5xx server errors → fall back if configured
+     *   - 4xx client errors → always throw (misconfiguration, fail loudly)
+     *   - fallbackToSimulation=false → always throw
+     */
+    handlePostFailure(err, category) {
+        if (!this.config.fallbackToSimulation) {
+            throw err instanceof Error ? err : new Error(String(err));
+        }
+        this.logger.warn(`Humancy API unreachable (${category} error), falling back to simulation mode: ${String(err)}`);
+        return {
+            approved: true,
+            respondedBy: 'simulated',
+            respondedAt: new Date().toISOString(),
+        };
+    }
+}
+//# sourceMappingURL=humancy-api-handler.js.map

package/dist/actions/builtin/humancy-api-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"humancy-api-handler.js","sourceRoot":"","sources":["../../../src/actions/builtin/humancy-api-handler.ts"],"names":[],"mappings":"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"}

package/dist/actions/builtin/humancy-review.d.ts

@@ -0,0 +1,83 @@
+import { BaseAction } from '../base-action.js';
+import type { ActionContext, ActionResult, ActionType, ValidationResult, StepDefinition, HumancyUrgency } from '../../types/index.js';
+import type { WorkflowStore } from '../../types/store.js';
+/**
+ * Decision request payload for HumanHandler
+ */
+interface ReviewDecisionRequest {
+    type: 'review';
+    title: string;
+    description: string;
+    options: Array<{
+        id: string;
+        label: string;
+        requiresComment?: boolean;
+    }>;
+    workflowId: string;
+    stepId: string;
+    urgency: HumancyUrgency;
+    artifact?: string;
+}
+/**
+ * Decision response from HumanHandler
+ */
+interface ReviewDecisionResponse {
+    approved?: boolean;
+    decision?: string;
+    input?: string;
+    respondedBy: string;
+    respondedAt: string;
+}
+/**
+ * Human handler interface for requesting decisions.
+ * This interface allows dependency injection for testing.
+ */
+export interface HumanDecisionHandler {
+    requestDecision(request: ReviewDecisionRequest, timeout: number): Promise<ReviewDecisionResponse>;
+}
+/**
+ * HumancyReviewAction implementation.
+ * Handles humancy.request_review workflow steps.
+ */
+export declare class HumancyReviewAction extends BaseAction {
+    readonly type: ActionType;
+    private store;
+    private humanHandler;
+    /**
+     * Create a new HumancyReviewAction
+     * @param humanHandler Optional human handler for decision routing
+     * @param store Optional workflow store for state persistence
+     */
+    constructor(humanHandler?: HumanDecisionHandler, store?: WorkflowStore);
+    /**
+     * Set the human handler for decision routing.
+     * This allows late binding when the handler is created after the action.
+     */
+    setHumanHandler(handler: HumanDecisionHandler): void;
+    /**
+     * Set the workflow store for state persistence.
+     */
+    setStore(store: WorkflowStore): void;
+    /**
+     * Check if this handler can process the given step
+     */
+    canHandle(step: StepDefinition): boolean;
+    /**
+     * Validate step configuration
+     */
+    validate(step: StepDefinition): ValidationResult;
+    /**
+     * Execute the humancy review action
+     */
+    protected executeInternal(step: StepDefinition, context: ActionContext): Promise<Omit<ActionResult, 'duration'>>;
+    /**
+     * Save workflow checkpoint before waiting for human response
+     */
+    private saveCheckpoint;
+    /**
+     * Clear workflow checkpoint after successful completion
+     */
+    private clearCheckpoint;
+}
+export {};
+//# sourceMappingURL=humancy-review.d.ts.map

package/dist/actions/builtin/humancy-review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"humancy-review.d.ts","sourceRoot":"","sources":["../../../src/actions/builtin/humancy-review.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,cAAc,EAGd,cAAc,EACf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAiB,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAUzE;;GAEG;AACH,UAAU,qBAAqB;IAC7B,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACzE,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,cAAc,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,UAAU,sBAAsB;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,eAAe,CAAC,OAAO,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACnG;AAED;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,UAAU;IACjD,QAAQ,CAAC,IAAI,EAAE,UAAU,CAA4B;IACrD,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,YAAY,CAA8B;IAElD;;;;OAIG;gBACS,YAAY,CAAC,EAAE,oBAAoB,EAAE,KAAK,CAAC,EAAE,aAAa;IAMtE;;;OAGG;IACH,eAAe,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI;IAIpD;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAIpC;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO;IAIxC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,gBAAgB;IAsDhD;;OAEG;cACa,eAAe,CAC7B,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IAgH1C;;OAEG;YACW,cAAc;IA8C5B;;OAEG;YACW,eAAe;CAO9B"}