@workglow/ai 0.2.8 → 0.2.10

package/dist/task/ChatMessage.d.ts

@@ -0,0 +1,356 @@
+/**
+ * @license
+ * Copyright 2026 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export type ContentBlockText = {
+    readonly type: "text";
+    readonly text: string;
+};
+export type ContentBlockImage = {
+    readonly type: "image";
+    readonly mimeType: string;
+    readonly data: string;
+};
+export type ContentBlockToolUse = {
+    readonly type: "tool_use";
+    readonly id: string;
+    readonly name: string;
+    readonly input: Record<string, unknown>;
+};
+export type ContentBlockToolResult = {
+    readonly type: "tool_result";
+    readonly tool_use_id: string;
+    readonly content: ReadonlyArray<ContentBlock>;
+    readonly is_error: boolean | undefined;
+};
+export type ContentBlock = ContentBlockText | ContentBlockImage | ContentBlockToolUse | ContentBlockToolResult;
+export type ChatRole = "user" | "assistant" | "tool" | "system";
+export interface ChatMessage {
+    readonly role: ChatRole;
+    readonly content: ReadonlyArray<ContentBlock>;
+}
+export declare const ContentBlockSchema: {
+    readonly oneOf: readonly [{
+        readonly type: "object";
+        readonly properties: {
+            readonly type: {
+                readonly type: "string";
+                readonly enum: readonly ["text"];
+            };
+            readonly text: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["type", "text"];
+        readonly additionalProperties: false;
+    }, {
+        readonly type: "object";
+        readonly properties: {
+            readonly type: {
+                readonly type: "string";
+                readonly enum: readonly ["image"];
+            };
+            readonly mimeType: {
+                readonly type: "string";
+            };
+            readonly data: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["type", "mimeType", "data"];
+        readonly additionalProperties: false;
+    }, {
+        readonly type: "object";
+        readonly properties: {
+            readonly type: {
+                readonly type: "string";
+                readonly enum: readonly ["tool_use"];
+            };
+            readonly id: {
+                readonly type: "string";
+            };
+            readonly name: {
+                readonly type: "string";
+            };
+            readonly input: {
+                readonly type: "object";
+                readonly additionalProperties: true;
+            };
+        };
+        readonly required: readonly ["type", "id", "name", "input"];
+        readonly additionalProperties: false;
+    }, {
+        readonly type: "object";
+        readonly properties: {
+            readonly type: {
+                readonly type: "string";
+                readonly enum: readonly ["tool_result"];
+            };
+            readonly tool_use_id: {
+                readonly type: "string";
+            };
+            readonly content: {
+                readonly type: "array";
+                readonly items: {
+                    readonly $ref: "#/definitions/ContentBlock";
+                };
+            };
+            readonly is_error: {
+                readonly type: "boolean";
+            };
+        };
+        readonly required: readonly ["type", "tool_use_id", "content"];
+        readonly additionalProperties: false;
+    }];
+    readonly definitions: {
+        readonly ContentBlock: {
+            readonly oneOf: readonly [{
+                readonly type: "object";
+                readonly properties: {
+                    readonly type: {
+                        readonly type: "string";
+                        readonly enum: readonly ["text"];
+                    };
+                    readonly text: {
+                        readonly type: "string";
+                    };
+                };
+                readonly required: readonly ["type", "text"];
+                readonly additionalProperties: false;
+            }, {
+                readonly type: "object";
+                readonly properties: {
+                    readonly type: {
+                        readonly type: "string";
+                        readonly enum: readonly ["image"];
+                    };
+                    readonly mimeType: {
+                        readonly type: "string";
+                    };
+                    readonly data: {
+                        readonly type: "string";
+                    };
+                };
+                readonly required: readonly ["type", "mimeType", "data"];
+                readonly additionalProperties: false;
+            }, {
+                readonly type: "object";
+                readonly properties: {
+                    readonly type: {
+                        readonly type: "string";
+                        readonly enum: readonly ["tool_use"];
+                    };
+                    readonly id: {
+                        readonly type: "string";
+                    };
+                    readonly name: {
+                        readonly type: "string";
+                    };
+                    readonly input: {
+                        readonly type: "object";
+                        readonly additionalProperties: true;
+                    };
+                };
+                readonly required: readonly ["type", "id", "name", "input"];
+                readonly additionalProperties: false;
+            }, {
+                readonly type: "object";
+                readonly properties: {
+                    readonly type: {
+                        readonly type: "string";
+                        readonly enum: readonly ["tool_result"];
+                    };
+                    readonly tool_use_id: {
+                        readonly type: "string";
+                    };
+                    readonly content: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly $ref: "#/definitions/ContentBlock";
+                        };
+                    };
+                    readonly is_error: {
+                        readonly type: "boolean";
+                    };
+                };
+                readonly required: readonly ["type", "tool_use_id", "content"];
+                readonly additionalProperties: false;
+            }];
+        };
+    };
+    readonly title: "ContentBlock";
+    readonly description: "A single content block within a chat message";
+};
+export declare const ChatMessageSchema: {
+    readonly type: "object";
+    readonly properties: {
+        readonly role: {
+            readonly type: "string";
+            readonly enum: readonly ["user", "assistant", "tool", "system"];
+        };
+        readonly content: {
+            readonly type: "array";
+            readonly items: {
+                readonly oneOf: readonly [{
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly type: {
+                            readonly type: "string";
+                            readonly enum: readonly ["text"];
+                        };
+                        readonly text: {
+                            readonly type: "string";
+                        };
+                    };
+                    readonly required: readonly ["type", "text"];
+                    readonly additionalProperties: false;
+                }, {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly type: {
+                            readonly type: "string";
+                            readonly enum: readonly ["image"];
+                        };
+                        readonly mimeType: {
+                            readonly type: "string";
+                        };
+                        readonly data: {
+                            readonly type: "string";
+                        };
+                    };
+                    readonly required: readonly ["type", "mimeType", "data"];
+                    readonly additionalProperties: false;
+                }, {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly type: {
+                            readonly type: "string";
+                            readonly enum: readonly ["tool_use"];
+                        };
+                        readonly id: {
+                            readonly type: "string";
+                        };
+                        readonly name: {
+                            readonly type: "string";
+                        };
+                        readonly input: {
+                            readonly type: "object";
+                            readonly additionalProperties: true;
+                        };
+                    };
+                    readonly required: readonly ["type", "id", "name", "input"];
+                    readonly additionalProperties: false;
+                }, {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly type: {
+                            readonly type: "string";
+                            readonly enum: readonly ["tool_result"];
+                        };
+                        readonly tool_use_id: {
+                            readonly type: "string";
+                        };
+                        readonly content: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly $ref: "#/definitions/ContentBlock";
+                            };
+                        };
+                        readonly is_error: {
+                            readonly type: "boolean";
+                        };
+                    };
+                    readonly required: readonly ["type", "tool_use_id", "content"];
+                    readonly additionalProperties: false;
+                }];
+                readonly definitions: {
+                    readonly ContentBlock: {
+                        readonly oneOf: readonly [{
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly type: {
+                                    readonly type: "string";
+                                    readonly enum: readonly ["text"];
+                                };
+                                readonly text: {
+                                    readonly type: "string";
+                                };
+                            };
+                            readonly required: readonly ["type", "text"];
+                            readonly additionalProperties: false;
+                        }, {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly type: {
+                                    readonly type: "string";
+                                    readonly enum: readonly ["image"];
+                                };
+                                readonly mimeType: {
+                                    readonly type: "string";
+                                };
+                                readonly data: {
+                                    readonly type: "string";
+                                };
+                            };
+                            readonly required: readonly ["type", "mimeType", "data"];
+                            readonly additionalProperties: false;
+                        }, {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly type: {
+                                    readonly type: "string";
+                                    readonly enum: readonly ["tool_use"];
+                                };
+                                readonly id: {
+                                    readonly type: "string";
+                                };
+                                readonly name: {
+                                    readonly type: "string";
+                                };
+                                readonly input: {
+                                    readonly type: "object";
+                                    readonly additionalProperties: true;
+                                };
+                            };
+                            readonly required: readonly ["type", "id", "name", "input"];
+                            readonly additionalProperties: false;
+                        }, {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly type: {
+                                    readonly type: "string";
+                                    readonly enum: readonly ["tool_result"];
+                                };
+                                readonly tool_use_id: {
+                                    readonly type: "string";
+                                };
+                                readonly content: {
+                                    readonly type: "array";
+                                    readonly items: {
+                                        readonly $ref: "#/definitions/ContentBlock";
+                                    };
+                                };
+                                readonly is_error: {
+                                    readonly type: "boolean";
+                                };
+                            };
+                            readonly required: readonly ["type", "tool_use_id", "content"];
+                            readonly additionalProperties: false;
+                        }];
+                    };
+                };
+                readonly title: "ContentBlock";
+                readonly description: "A single content block within a chat message";
+            };
+        };
+    };
+    readonly required: readonly ["role", "content"];
+    readonly additionalProperties: false;
+    readonly title: "ChatMessage";
+    readonly description: "A single chat message with role and structured content blocks";
+};
+export declare function isContentBlock(value: unknown): value is ContentBlock;
+export declare function isChatMessage(value: unknown): value is ChatMessage;
+export declare function textMessage(role: ChatRole, text: string): ChatMessage;
+//# sourceMappingURL=ChatMessage.d.ts.map

package/dist/task/ChatMessage.d.ts.map

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

package/dist/task/MessageConversion.d.ts

@@ -1,16 +1,8 @@
 /**
  * @license
- * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * Copyright 2026 Steven Roussey <sroussey@gmail.com>
  * SPDX-License-Identifier: Apache-2.0
  */
-/**
- * Shared message conversion utilities for converting provider-agnostic
- * ChatMessage arrays to provider-specific formats.
- *
- * These are pure functions safe for both main-thread and worker contexts.
- * Providers with unique requirements (Anthropic, Gemini, LlamaCpp)
- * maintain their own conversion logic.
- */
 import type { ToolCallingTaskInput } from "./ToolCallingTask";
 export interface OpenAICompatMessage {
     role: string;

package/dist/task/MessageConversion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MessageConversion.d.ts","sourceRoot":"","sources":["../../src/task/MessageConversion.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAsB9D,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC,CAAC;IACzE,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,UAAU,CAAC;QACjB,QAAQ,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC;KAC/C,CAAC,CAAC;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,oBAAoB,GAAG,mBAAmB,EAAE,CAuInF;AAMD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,oBAAoB,GAAG,eAAe,EAAE,CAqFjF"}
+{"version":3,"file":"MessageConversion.d.ts","sourceRoot":"","sources":["../../src/task/MessageConversion.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAoB9D,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC,CAAC;IACzE,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,UAAU,CAAC;QACjB,QAAQ,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC;KAC/C,CAAC,CAAC;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,oBAAoB,GAAG,mBAAmB,EAAE,CAyGnF;AAMD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,oBAAoB,GAAG,eAAe,EAAE,CA2DjF"}

package/dist/task/StructuredGenerationTask.d.ts

@@ -3,9 +3,9 @@
  * Copyright 2025 Steven Roussey <sroussey@gmail.com>
  * SPDX-License-Identifier: Apache-2.0
  */
-import { CreateWorkflow } from "@workglow/task-graph";
-import type { TaskConfig } from "@workglow/task-graph";
-import { DataPortSchema, FromSchema } from "@workglow/util/schema";
+import { CreateWorkflow, TaskError } from "@workglow/task-graph";
+import type { IExecuteContext, StreamEvent, TaskConfig } from "@workglow/task-graph";
+import type { DataPortSchema, FromSchema } from "@workglow/util/schema";
 import { StreamingAiTask } from "./base/StreamingAiTask";
 export declare const StructuredGenerationInputSchema: {
     readonly type: "object";
@@ -102,6 +102,15 @@ export declare const StructuredGenerationInputSchema: {
             readonly maximum: 2;
             readonly "x-ui-group": "Configuration";
         };
+        readonly maxRetries: {
+            readonly type: "integer";
+            readonly title: "Max Retries";
+            readonly description: "Number of times to re-prompt the model with validation errors when its output doesn't match the schema. 0 disables retries (fail on first mismatch).";
+            readonly minimum: 0;
+            readonly maximum: 10;
+            readonly default: 2;
+            readonly "x-ui-group": "Configuration";
+        };
     };
     readonly required: readonly ["model", "prompt", "outputSchema"];
     readonly additionalProperties: false;
@@ -124,6 +133,27 @@ export declare const StructuredGenerationOutputSchema: {
 export type StructuredGenerationTaskInput = FromSchema<typeof StructuredGenerationInputSchema>;
 export type StructuredGenerationTaskOutput = FromSchema<typeof StructuredGenerationOutputSchema>;
 export type StructuredGenerationTaskConfig = TaskConfig<StructuredGenerationTaskInput>;
+/**
+ * One round of validation errors from a failed attempt.
+ */
+export interface StructuredOutputValidationAttempt {
+    readonly attempt: number;
+    readonly errors: ReadonlyArray<{
+        readonly path: string;
+        readonly message: string;
+    }>;
+    /** The invalid object the model produced on this attempt. */
+    readonly object: Record<string, unknown> | undefined;
+}
+/**
+ * Thrown when the model's output fails schema validation on every attempt
+ * (including retries).
+ */
+export declare class StructuredOutputValidationError extends TaskError {
+    static readonly type: string;
+    readonly attempts: ReadonlyArray<StructuredOutputValidationAttempt>;
+    constructor(attempts: ReadonlyArray<StructuredOutputValidationAttempt>);
+}
 export declare class StructuredGenerationTask extends StreamingAiTask<StructuredGenerationTaskInput, StructuredGenerationTaskOutput, StructuredGenerationTaskConfig> {
     static type: string;
     static category: string;
@@ -131,6 +161,23 @@ export declare class StructuredGenerationTask extends StreamingAiTask<Structured
     static description: string;
     static inputSchema(): DataPortSchema;
     static outputSchema(): DataPortSchema;
+    /**
+     * Runs the provider, validates the resulting object against `input.outputSchema`,
+     * and retries with validation-error feedback up to `input.maxRetries` times if
+     * the model's output doesn't match. Between attempts, emits an empty
+     * object-delta so downstream accumulators reset.
+     *
+     * Throws:
+     * - `TaskConfigurationError` if `input.outputSchema` isn't a compilable JSON Schema.
+     * - `StructuredOutputValidationError` if every attempt fails validation.
+     */
+    executeStream(input: StructuredGenerationTaskInput, context: IExecuteContext): AsyncIterable<StreamEvent<StructuredGenerationTaskOutput>>;
+    /**
+     * Drains executeStream so non-streaming callers get the validated output.
+     * Without this override, `execute()` would route through the base class's
+     * non-streaming path and bypass validation + retry entirely.
+     */
+    execute(input: StructuredGenerationTaskInput, context: IExecuteContext): Promise<StructuredGenerationTaskOutput | undefined>;
 }
 /**
  * Task for generating structured JSON output using a language model

package/dist/task/StructuredGenerationTask.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StructuredGenerationTask.d.ts","sourceRoot":"","sources":["../../src/task/StructuredGenerationTask.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAY,MAAM,sBAAsB,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAIzD,eAAO,MAAM,+BAA+B;mBACpC,QAAQ;;iBAEZ,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBACL,MAAM;qBACJ,IAAI,EAAE,QAAQ;qBACd,KAAK,EAAE,QAAQ;qBACf,WAAW,EAAE,+CAA+C;;iBAE9D,YAAY;qBACV,IAAI,EAAE,QAAQ;qBACd,KAAK,EAAE,eAAe;qBACtB,WAAW,EAAE,qDAAqD;qBAClE,oBAAoB;;iBAEtB,SAAS;qBACP,IAAI,EAAE,QAAQ;qBACd,KAAK,EAAE,YAAY;qBACnB,WAAW,EAAE,0CAA0C;qBACvD,OAAO,EAAE,CAAC;qBACV,OAAO,EAAE,IAAI;qBACb,YAAY,EAAE,eAAe;;iBAE/B,WAAW;qBACT,IAAI,EAAE,QAAQ;qBACd,KAAK,EAAE,aAAa;qBACpB,WAAW,EAAE,qCAAqC;qBAClD,OAAO,EAAE,CAAC;qBACV,OAAO,EAAE,CAAC;qBACV,YAAY,EAAE,eAAe;;;;;CAKA,CAAC;AAEpC,eAAO,MAAM,gCAAgC;mBACrC,QAAQ;;iBAEZ,MAAM;qBACJ,IAAI,EAAE,QAAQ;qBACd,KAAK,EAAE,mBAAmB;qBAC1B,WAAW,EAAE,mEAAmE;qBAChF,UAAU,EAAE,QAAQ;qBACpB,qBAAqB;qBACrB,oBAAoB;;;;;CAKS,CAAC;AAEpC,MAAM,MAAM,6BAA6B,GAAG,UAAU,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAC/F,MAAM,MAAM,8BAA8B,GAAG,UAAU,CAAC,OAAO,gCAAgC,CAAC,CAAC;AACjG,MAAM,MAAM,8BAA8B,GAAG,UAAU,CAAC,6BAA6B,CAAC,CAAC;AAEvF,qBAAa,wBAAyB,SAAQ,eAAe,CAC3D,6BAA6B,EAC7B,8BAA8B,EAC9B,8BAA8B,CAC/B;IACC,OAAuB,IAAI,SAA8B;IACzD,OAAuB,QAAQ,SAAmB;IAClD,OAAuB,KAAK,SAA2B;IACvD,OAAuB,WAAW,SACyD;IAC3F,OAAuB,WAAW,IAAI,cAAc,CAEnD;IACD,OAAuB,YAAY,IAAI,cAAc,CAEpD;CACF;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,UACxB,6BAA6B,WAC3B,8BAA8B;;;;EAGxC,CAAC;AAEF,OAAO,QAAQ,sBAAsB,CAAC,CAAC;IACrC,UAAU,QAAQ;QAChB,oBAAoB,EAAE,cAAc,CAClC,6BAA6B,EAC7B,8BAA8B,EAC9B,8BAA8B,CAC/B,CAAC;KACH;CACF"}
+{"version":3,"file":"StructuredGenerationTask.d.ts","sourceRoot":"","sources":["../../src/task/StructuredGenerationTask.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAA0B,SAAS,EAAY,MAAM,sBAAsB,CAAC;AACnG,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAErF,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAc,MAAM,uBAAuB,CAAC;AAEpF,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAIzD,eAAO,MAAM,+BAA+B;mBACpC,QAAQ;;iBAEZ,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBACL,MAAM;qBACJ,IAAI,EAAE,QAAQ;qBACd,KAAK,EAAE,QAAQ;qBACf,WAAW,EAAE,+CAA+C;;iBAE9D,YAAY;qBACV,IAAI,EAAE,QAAQ;qBACd,KAAK,EAAE,eAAe;qBACtB,WAAW,EAAE,qDAAqD;qBAClE,oBAAoB;;iBAEtB,SAAS;qBACP,IAAI,EAAE,QAAQ;qBACd,KAAK,EAAE,YAAY;qBACnB,WAAW,EAAE,0CAA0C;qBACvD,OAAO,EAAE,CAAC;qBACV,OAAO,EAAE,IAAI;qBACb,YAAY,EAAE,eAAe;;iBAE/B,WAAW;qBACT,IAAI,EAAE,QAAQ;qBACd,KAAK,EAAE,aAAa;qBACpB,WAAW,EAAE,qCAAqC;qBAClD,OAAO,EAAE,CAAC;qBACV,OAAO,EAAE,CAAC;qBACV,YAAY,EAAE,eAAe;;iBAE/B,UAAU;qBACR,IAAI,EAAE,SAAS;qBACf,KAAK,EAAE,aAAa;qBACpB,WAAW,EACT,sJAAsJ;qBACxJ,OAAO,EAAE,CAAC;qBACV,OAAO,EAAE,EAAE;qBACX,OAAO,EAAE,CAAC;qBACV,YAAY,EAAE,eAAe;;;;;CAKA,CAAC;AAEpC,eAAO,MAAM,gCAAgC;mBACrC,QAAQ;;iBAEZ,MAAM;qBACJ,IAAI,EAAE,QAAQ;qBACd,KAAK,EAAE,mBAAmB;qBAC1B,WAAW,EAAE,mEAAmE;qBAChF,UAAU,EAAE,QAAQ;qBACpB,qBAAqB;qBACrB,oBAAoB;;;;;CAKS,CAAC;AAEpC,MAAM,MAAM,6BAA6B,GAAG,UAAU,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAC/F,MAAM,MAAM,8BAA8B,GAAG,UAAU,CAAC,OAAO,gCAAgC,CAAC,CAAC;AACjG,MAAM,MAAM,8BAA8B,GAAG,UAAU,CAAC,6BAA6B,CAAC,CAAC;AAEvF;;GAEG;AACH,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpF,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CACtD;AAED;;;GAGG;AACH,qBAAa,+BAAgC,SAAQ,SAAS;IAC5D,gBAAgC,IAAI,EAAE,MAAM,CAAqC;IACjF,SAAgB,QAAQ,EAAE,aAAa,CAAC,iCAAiC,CAAC,CAAC;IAC3E,YAAY,QAAQ,EAAE,aAAa,CAAC,iCAAiC,CAAC,EAQrE;CACF;AAsBD,qBAAa,wBAAyB,SAAQ,eAAe,CAC3D,6BAA6B,EAC7B,8BAA8B,EAC9B,8BAA8B,CAC/B;IACC,OAAuB,IAAI,SAA8B;IACzD,OAAuB,QAAQ,SAAmB;IAClD,OAAuB,KAAK,SAA2B;IACvD,OAAuB,WAAW,SAC0G;IAC5I,OAAuB,WAAW,IAAI,cAAc,CAEnD;IACD,OAAuB,YAAY,IAAI,cAAc,CAEpD;IAED;;;;;;;;;OASG;IACa,aAAa,CAC3B,KAAK,EAAE,6BAA6B,EACpC,OAAO,EAAE,eAAe,GACvB,aAAa,CAAC,WAAW,CAAC,8BAA8B,CAAC,CAAC,CA4E5D;IAED;;;;OAIG;IACY,OAAO,CACpB,KAAK,EAAE,6BAA6B,EACpC,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,8BAA8B,GAAG,SAAS,CAAC,CAQrD;CACF;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,UACxB,6BAA6B,WAC3B,8BAA8B;;;;EAGxC,CAAC;AAEF,OAAO,QAAQ,sBAAsB,CAAC,CAAC;IACrC,UAAU,QAAQ;QAChB,oBAAoB,EAAE,cAAc,CAClC,6BAA6B,EAC7B,8BAA8B,EAC9B,8BAA8B,CAC/B,CAAC;KACH;CACF"}