@loopman/langchain-sdk 1.0.9

package/dist/mcp/tool-registry.js

@@ -0,0 +1,143 @@
+import { DynamicStructuredTool } from "@langchain/core/tools";
+import { z } from "zod";
+export class LoopmanToolRegistry {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    toDynamicTools(mcpTools) {
+        return mcpTools.map((tool) => this.createTool(tool));
+    }
+    createTool(tool) {
+        const schema = this.resolveSchema(tool);
+        if (this.config.debug) {
+            console.log(`[LoopmanToolRegistry] Creating tool ${tool.name} with schema:`, schema);
+        }
+        return new DynamicStructuredTool({
+            name: tool.name,
+            description: this.buildDescription(tool, schema),
+            schema,
+            returnDirect: tool.name === "submitForHumanReview",
+            func: async (input) => {
+                const args = this.prepareArgs(tool.name, input);
+                if (this.config.debug) {
+                    console.log(`[LoopmanTool] Executing ${tool.name}`, args);
+                }
+                const result = await tool.func(args);
+                if (this.config.debug) {
+                    console.log(`[LoopmanTool] Result for ${tool.name}`, result);
+                }
+                return result;
+            },
+        });
+    }
+    resolveSchema(tool) {
+        // Override empty schema for submitForHumanReview with explicit schema
+        // This is needed because @langchain/mcp-adapters doesn't correctly convert JSON Schema to Zod
+        if (tool.name === "submitForHumanReview") {
+            return z.object({
+                title: z.string().describe("Brief description of the action"),
+                description: z
+                    .string()
+                    .describe("Brief description of the decision being requested"),
+                proposedDecision: z.string().describe("The exact action you propose"),
+                decisionReasoning: z
+                    .string()
+                    .describe("Detailed explanation of why you made this decision based on guidelines"),
+                businessContext: z
+                    .string()
+                    .describe("Background context about the situation - explain the circumstances like you're writing to your supervisor"),
+                information: z
+                    .array(z.object({
+                    type: z
+                        .enum(["text", "url", "image", "bulletPoints"])
+                        .describe("Type of information for proper display formatting"),
+                    label: z
+                        .string()
+                        .optional()
+                        .describe("Descriptive title for this information item (e.g., 'Original Article Content', 'Email Body', 'Document to Review')"),
+                    value: z
+                        .union([z.string(), z.array(z.string())])
+                        .describe("The actual information content. IMPORTANT: Include ALL relevant data that the human reviewer needs to make an informed decision. For content workflows (summarizing, reviewing, publishing), always include the COMPLETE original content/document/article text, not just metadata or excerpts. The human needs to see the full context to verify accuracy."),
+                    importance: z
+                        .number()
+                        .min(0)
+                        .max(10)
+                        .optional()
+                        .describe("Optional importance level (0-10)"),
+                    ruleIds: z
+                        .array(z.string())
+                        .optional()
+                        .describe("Optional rule identifiers from guidelines"),
+                }))
+                    .describe("Array of information items providing ALL context and data needed for human review. Include complete content, not just summaries or metadata."),
+            });
+        }
+        if (tool.schema && this.isZodSchema(tool.schema)) {
+            return tool.schema;
+        }
+        if (tool.inputSchema && this.isZodSchema(tool.inputSchema)) {
+            return tool.inputSchema;
+        }
+        return z.object({});
+    }
+    prepareArgs(toolName, input) {
+        const args = { ...input };
+        if (toolName === "submitForHumanReview") {
+            // Debug: log the actual input received
+            if (this.config.debug) {
+                console.log("[LoopmanToolRegistry] submitForHumanReview input:", JSON.stringify(input, null, 2));
+            }
+            // Only inject workflow metadata, don't validate (MCP will validate)
+            args.workflowIdentifier ??= this.config.workflowId;
+            args.executionIdentifier ??= this.config.executionId;
+            args.category ??= this.config.category;
+            if (this.config.channelId) {
+                args.channelId ??= this.config.channelId;
+            }
+        }
+        if (toolName === "getHumanGuidelines") {
+            args.workflow_id ??= this.config.workflowId;
+            args.execution_id ??= this.config.executionId;
+            args.category ??= this.config.category ?? "general";
+        }
+        if (toolName === "getDecisionContext") {
+            args.workflow_id ??= this.config.workflowId;
+            args.execution_id ??= this.config.executionId;
+        }
+        return args;
+    }
+    buildDescription(tool, schema) {
+        const description = tool.description ?? "Loopman MCP tool";
+        const schemaDescription = this.describeSchema(schema);
+        return `${description}\n\nInput Schema:\n${schemaDescription}`;
+    }
+    describeSchema(schema) {
+        if (!schema || !this.isZodSchema(schema)) {
+            return "(no schema documentation available)";
+        }
+        const zodObject = schema;
+        if (!zodObject._def || typeof zodObject._def.shape !== "function") {
+            return "(schema not available)";
+        }
+        const shape = zodObject._def.shape();
+        const entries = Object.entries(shape).map(([key, value]) => {
+            const typeAny = value;
+            const isOptionalFn = typeof typeAny.isOptional === "function";
+            const required = isOptionalFn
+                ? !typeAny.isOptional()
+                : typeAny._def?.typeName !== "ZodOptional";
+            const typeName = typeAny._def?.typeName ?? "unknown";
+            const description = typeAny._def?.description ?? "";
+            return `- ${key}: ${typeName} ${required ? "(required)" : "(optional)"} ${description}`;
+        });
+        if (entries.length === 0) {
+            return "(no fields)";
+        }
+        return entries.join("\n");
+    }
+    isZodSchema(schema) {
+        return (Boolean(schema) && typeof schema === "object" && "_def" in schema);
+    }
+}
+//# sourceMappingURL=tool-registry.js.map

package/dist/mcp/tool-registry.js.map

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

package/dist/services/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Loopman Services
+ *
+ * Core services for interacting with the Loopman API
+ */
+export type { CreateTaskRequest, DecisionContextEntry, DecisionContextResponse, Guideline, GuidelinesResponse, LoopmanDecisionResponse, LoopmanServiceConfig, LoopmanTaskResponse, LoopmanTaskStatus, TaskInformation, } from "../types";
+export { LoopmanService } from "./loopman.service";
+export { PollingService } from "./polling.service";
+export type { DecisionStatusResponse, PollingOptions, PollingResult, } from "./polling.service";
+export { LoggerService } from "./logger.service";
+export type { LoggerConfig, LogLevel } from "./logger.service";
+//# sourceMappingURL=index.d.ts.map

package/dist/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,uBAAuB,EACvB,SAAS,EACT,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,GAChB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EACV,sBAAsB,EACtB,cAAc,EACd,aAAa,GACd,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/services/index.js

@@ -0,0 +1,9 @@
+/**
+ * Loopman Services
+ *
+ * Core services for interacting with the Loopman API
+ */
+export { LoopmanService } from "./loopman.service";
+export { PollingService } from "./polling.service";
+export { LoggerService } from "./logger.service";
+//# sourceMappingURL=index.js.map

package/dist/services/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAOnD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/services/logger.service.d.ts

@@ -0,0 +1,107 @@
+import { LoopmanApiClient } from "../client/loopman-api";
+/**
+ * Log levels supported by the logger
+ */
+export type LogLevel = "debug" | "info" | "warn" | "error";
+/**
+ * Configuration for LoggerService
+ */
+export interface LoggerConfig {
+    /** API client for sending logs to Loopman */
+    apiClient: LoopmanApiClient;
+    /** API key for authentication */
+    apiKey: string;
+    /** Workflow ID for context */
+    workflowId: string;
+    /** Execution ID for context */
+    executionId: string;
+    /** Task ID for context (optional, can be set after task creation) */
+    taskId?: string;
+    /** Logger name/source (e.g., "PollingService", "Middleware") */
+    source: string;
+    /** Enable debug logging to console */
+    debug?: boolean;
+    /** Enable sending logs to Loopman API */
+    enableRemoteLogs?: boolean;
+}
+/**
+ * Centralized logging service for Loopman SDK
+ *
+ * Features:
+ * - Logs to console (when debug mode is enabled)
+ * - Sends logs to Loopman API (non-blocking)
+ * - Adds context automatically (workflow, execution, source)
+ * - Handles errors gracefully
+ *
+ * @example
+ * ```typescript
+ * const logger = new LoggerService({
+ *   apiClient,
+ *   apiKey: "key",
+ *   workflowId: "workflow-1",
+ *   executionId: "exec-1",
+ *   source: "PollingService",
+ *   debug: true,
+ * });
+ *
+ * logger.info("Polling started", { decisionId: "dec_123" });
+ * logger.error("Failed to poll", error);
+ * ```
+ */
+export declare class LoggerService {
+    private config;
+    constructor(config: LoggerConfig);
+    /**
+     * Update logger configuration (e.g., to add taskId after task creation)
+     */
+    setTaskId(taskId: string): void;
+    /**
+     * Log debug message (only shown if debug mode is enabled)
+     */
+    debug(message: string, data?: any): void;
+    /**
+     * Log info message
+     */
+    info(message: string, data?: any): void;
+    /**
+     * Log warning message (always shown to console)
+     */
+    warn(message: string, data?: any): void;
+    /**
+     * Log error message (always shown to console)
+     */
+    error(message: string, data?: any): void;
+    /**
+     * Generic log method
+     */
+    private log;
+    /**
+     * Log to console based on level and debug mode
+     */
+    private logToConsole;
+    /**
+     * Send log to Loopman API (non-blocking, fails silently)
+     */
+    private sendToLoopman;
+    /**
+     * Async method to send log to Loopman API
+     */
+    private sendLogAsync;
+    /**
+     * Create a child logger with a different source
+     * Useful for creating sub-loggers within a service
+     *
+     * @example
+     * ```typescript
+     * const mainLogger = new LoggerService({ source: "PollingService", ... });
+     * const sessionLogger = mainLogger.child("PollingSession");
+     * sessionLogger.info("Session started"); // [PollingSession] Session started
+     * ```
+     */
+    child(source: string): LoggerService;
+    /**
+     * Update logger configuration (e.g., toggle debug mode)
+     */
+    updateConfig(updates: Partial<LoggerConfig>): void;
+}
+//# sourceMappingURL=logger.service.d.ts.map

package/dist/services/logger.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.service.d.ts","sourceRoot":"","sources":["../../src/services/logger.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,6CAA6C;IAC7C,SAAS,EAAE,gBAAgB,CAAC;IAC5B,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,yCAAyC;IACzC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAe;gBAEjB,MAAM,EAAE,YAAY;IAQhC;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAIxC;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAIvC;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAIvC;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAIxC;;OAEG;IACH,OAAO,CAAC,GAAG;IAUX;;OAEG;IACH,OAAO,CAAC,YAAY;IA+BpB;;OAEG;IACH,OAAO,CAAC,aAAa;IAarB;;OAEG;YACW,YAAY;IAqC1B;;;;;;;;;;OAUG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa;IAOpC;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI;CAMnD"}

package/dist/services/logger.service.js

@@ -0,0 +1,173 @@
+/**
+ * Centralized logging service for Loopman SDK
+ *
+ * Features:
+ * - Logs to console (when debug mode is enabled)
+ * - Sends logs to Loopman API (non-blocking)
+ * - Adds context automatically (workflow, execution, source)
+ * - Handles errors gracefully
+ *
+ * @example
+ * ```typescript
+ * const logger = new LoggerService({
+ *   apiClient,
+ *   apiKey: "key",
+ *   workflowId: "workflow-1",
+ *   executionId: "exec-1",
+ *   source: "PollingService",
+ *   debug: true,
+ * });
+ *
+ * logger.info("Polling started", { decisionId: "dec_123" });
+ * logger.error("Failed to poll", error);
+ * ```
+ */
+export class LoggerService {
+    config;
+    constructor(config) {
+        this.config = {
+            debug: false,
+            enableRemoteLogs: true,
+            ...config,
+        };
+    }
+    /**
+     * Update logger configuration (e.g., to add taskId after task creation)
+     */
+    setTaskId(taskId) {
+        this.config.taskId = taskId;
+    }
+    /**
+     * Log debug message (only shown if debug mode is enabled)
+     */
+    debug(message, data) {
+        this.log("debug", message, data);
+    }
+    /**
+     * Log info message
+     */
+    info(message, data) {
+        this.log("info", message, data);
+    }
+    /**
+     * Log warning message (always shown to console)
+     */
+    warn(message, data) {
+        this.log("warn", message, data);
+    }
+    /**
+     * Log error message (always shown to console)
+     */
+    error(message, data) {
+        this.log("error", message, data);
+    }
+    /**
+     * Generic log method
+     */
+    log(level, message, data) {
+        // Console logging
+        this.logToConsole(level, message, data);
+        // Remote logging (non-blocking)
+        if (this.config.enableRemoteLogs && level !== "debug") {
+            this.sendToLoopman(level, message, data);
+        }
+    }
+    /**
+     * Log to console based on level and debug mode
+     */
+    logToConsole(level, message, data) {
+        const prefix = `[${this.config.source}]`;
+        const logData = data !== undefined ? data : "";
+        switch (level) {
+            case "debug":
+                // Debug only shown if debug mode is enabled
+                if (this.config.debug) {
+                    console.log(prefix, message, logData);
+                }
+                break;
+            case "info":
+                // Info only shown if debug mode is enabled
+                if (this.config.debug) {
+                    console.log(prefix, message, logData);
+                }
+                break;
+            case "warn":
+                // Warnings always shown
+                console.warn(prefix, message, logData);
+                break;
+            case "error":
+                // Errors always shown
+                console.error(prefix, message, logData);
+                break;
+        }
+    }
+    /**
+     * Send log to Loopman API (non-blocking, fails silently)
+     */
+    sendToLoopman(level, message, data) {
+        // Fire and forget - don't await or block on this
+        this.sendLogAsync(level, message, data).catch((error) => {
+            // Silent fail - only log to console in debug mode
+            if (this.config.debug) {
+                console.error(`[${this.config.source}] Failed to send log to Loopman:`, error);
+            }
+        });
+    }
+    /**
+     * Async method to send log to Loopman API
+     */
+    async sendLogAsync(level, message, data) {
+        try {
+            const payload = {
+                comment: message,
+                category: "SDK_OPERATION",
+                workflowId: this.config.workflowId,
+                workflowIdentifier: this.config.workflowId,
+                executionIdentifier: this.config.executionId,
+                counter: 0,
+                data: {
+                    level,
+                    source: this.config.source,
+                    timestamp: new Date().toISOString(),
+                    rawData: data,
+                },
+            };
+            // Add taskId if available
+            if (this.config.taskId) {
+                payload.taskId = this.config.taskId;
+            }
+            await this.config.apiClient.post(this.config.apiKey, "/api/v1/logs", payload);
+        }
+        catch (error) {
+            // Silent fail - already handled in sendToLoopman
+            throw error;
+        }
+    }
+    /**
+     * Create a child logger with a different source
+     * Useful for creating sub-loggers within a service
+     *
+     * @example
+     * ```typescript
+     * const mainLogger = new LoggerService({ source: "PollingService", ... });
+     * const sessionLogger = mainLogger.child("PollingSession");
+     * sessionLogger.info("Session started"); // [PollingSession] Session started
+     * ```
+     */
+    child(source) {
+        return new LoggerService({
+            ...this.config,
+            source,
+        });
+    }
+    /**
+     * Update logger configuration (e.g., toggle debug mode)
+     */
+    updateConfig(updates) {
+        this.config = {
+            ...this.config,
+            ...updates,
+        };
+    }
+}
+//# sourceMappingURL=logger.service.js.map

package/dist/services/logger.service.js.map

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

package/dist/services/loopman.service.d.ts

@@ -0,0 +1,72 @@
+import { DecisionContextResponse, GuidelinesResponse, LoopmanServiceConfig, LoopmanTaskResponse } from "../types";
+import { LoggerService } from "./logger.service";
+import { PollingService, type PollingOptions } from "./polling.service";
+/**
+ * Service to interact with Loopman Backoffice API
+ * Handles logs, decisions, and polling
+ */
+export declare class LoopmanService {
+    private apiClient;
+    private config;
+    readonly polling: PollingService;
+    readonly logger: LoggerService;
+    constructor(config: LoopmanServiceConfig);
+    /**
+     * Send a log to Loopman API
+     * @deprecated Use logger.info(), logger.warn(), etc. instead
+     */
+    sendLog(level: "debug" | "info" | "warn" | "error", message: string): Promise<void>;
+    /**
+     * Get current user information
+     */
+    getCurrentUser(): Promise<import("..").LoopmanUser>;
+    /**
+     * Get guidelines for the current workflow
+     * @param category - Optional category filter
+     * @returns Guidelines response with list of guidelines
+     */
+    getGuidelines(category?: string): Promise<GuidelinesResponse>;
+    /**
+     * Get decision context (history of decisions) for the current workflow execution
+     * @returns Decision context with history of previous decisions
+     */
+    getDecisionContext(): Promise<DecisionContextResponse>;
+    /**
+     * Get workflow categories
+     * Returns available categories for guidelines in this workflow
+     * @returns Array of category names
+     */
+    getWorkflowCategories(): Promise<string[]>;
+    /**
+     * Convert tool arguments to structured information items
+     * Formats tool parameters for human-readable display in Loopman UI
+     */
+    private convertToolArgsToInformation;
+    /**
+     * Create a task in Loopman for human review of a tool call
+     * Maps tool call data to a task that humans can validate/reject/modify
+     *
+     * @param toolName - Name of the tool to be validated
+     * @param toolArgs - Arguments for the tool call
+     * @param description - Optional description of the action
+     * @param toolCallId - Optional unique ID from LangChain tool call
+     * @param businessContext - Optional business context explaining the action
+     * @param parentTaskId - Optional parent task ID to create hierarchical link
+     * @param proposedDecision - Optional proposed decision from parent task
+     * @param decisionReasoning - Optional decision reasoning from parent task
+     * @returns The created task response from Loopman API
+     */
+    createTaskForValidation(toolName: string, toolArgs: any, description?: string, toolCallId?: string, businessContext?: string, parentTaskId?: string, proposedDecision?: string, decisionReasoning?: string): Promise<LoopmanTaskResponse>;
+    /**
+     * Get the current status of a task
+     * @param taskId - The ID of the task to check
+     * @returns The task response from Loopman API
+     */
+    getTask(taskId: string): Promise<LoopmanTaskResponse>;
+    /**
+     * Get polling options with current configuration
+     * Helper method to construct PollingOptions for direct PollingService usage
+     */
+    getPollingOptions(taskId: string, abortSignal?: AbortSignal): PollingOptions;
+}
+//# sourceMappingURL=loopman.service.d.ts.map

package/dist/services/loopman.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loopman.service.d.ts","sourceRoot":"","sources":["../../src/services/loopman.service.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,uBAAuB,EACvB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EAEpB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExE;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,MAAM,CAAuB;IAGrC,SAAgB,OAAO,EAAE,cAAc,CAAC;IACxC,SAAgB,MAAM,EAAE,aAAa,CAAC;gBAE1B,MAAM,EAAE,oBAAoB;IAkCxC;;;OAGG;IACG,OAAO,CACX,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,EAC1C,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;IAKhB;;OAEG;IACG,cAAc;IAIpB;;;;OAIG;IACG,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA6BnE;;;OAGG;IACG,kBAAkB,IAAI,OAAO,CAAC,uBAAuB,CAAC;IA0B5D;;;;OAIG;IACG,qBAAqB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAyBhD;;;OAGG;IACH,OAAO,CAAC,4BAA4B;IAyDpC;;;;;;;;;;;;;OAaG;IACG,uBAAuB,CAC3B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,GAAG,EACb,WAAW,CAAC,EAAE,MAAM,EACpB,UAAU,CAAC,EAAE,MAAM,EACnB,eAAe,CAAC,EAAE,MAAM,EACxB,YAAY,CAAC,EAAE,MAAM,EACrB,gBAAgB,CAAC,EAAE,MAAM,EACzB,iBAAiB,CAAC,EAAE,MAAM,GACzB,OAAO,CAAC,mBAAmB,CAAC;IAwE/B;;;;OAIG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAsB3D;;;OAGG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,cAAc;CAY7E"}