@defai.digital/contracts 13.0.3

package/dist/orchestration/v1/schema.d.ts.map

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

package/dist/orchestration/v1/schema.js

@@ -0,0 +1,394 @@
+/**
+ * Orchestration Domain Contracts v1
+ *
+ * Schemas for task orchestration, scheduling, and multi-agent coordination.
+ */
+import { z } from 'zod';
+import { RETRY_MAX_DEFAULT, RETRY_MAX_LIMIT, RETRY_DELAY_DEFAULT, RETRY_DELAY_MAX, RETRY_BACKOFF_CAP, TIMEOUT_ORCHESTRATION_EXECUTION, TIMEOUT_ORCHESTRATION_GRACEFUL, TIMEOUT_QUEUE_MAX, TIMEOUT_SESSION, STRING_LENGTH_CONTENT, STRING_LENGTH_LONG, } from '../../constants.js';
+// ============================================================================
+// Task Status and Priority Schemas
+// ============================================================================
+/**
+ * Orchestration task status
+ */
+export const OrchTaskStatusSchema = z.enum([
+    'pending',
+    'queued',
+    'running',
+    'paused',
+    'completed',
+    'failed',
+    'cancelled',
+    'timeout',
+]);
+/**
+ * Orchestration task priority
+ */
+export const OrchTaskPrioritySchema = z.enum(['critical', 'high', 'medium', 'low', 'background']);
+/**
+ * Orchestration task type
+ */
+export const OrchTaskTypeSchema = z.enum([
+    'sequential',
+    'parallel',
+    'conditional',
+    'loop',
+    'retry',
+    'timeout',
+    'wait',
+    'callback',
+    'other',
+]);
+// ============================================================================
+// Task Definition Schemas
+// ============================================================================
+/**
+ * Task dependency
+ */
+export const TaskDependencySchema = z.object({
+    taskId: z.string().uuid(),
+    condition: z.enum(['completed', 'failed', 'any', 'all']).default('completed'),
+    timeout: z.number().int().min(0).optional(),
+});
+/**
+ * Orchestration retry policy
+ */
+export const OrchRetryPolicySchema = z.object({
+    maxAttempts: z.number().int().min(1).max(RETRY_MAX_LIMIT).default(RETRY_MAX_DEFAULT),
+    initialDelayMs: z.number().int().min(100).max(RETRY_BACKOFF_CAP).default(RETRY_DELAY_DEFAULT),
+    maxDelayMs: z.number().int().min(RETRY_DELAY_DEFAULT).max(TIMEOUT_SESSION).default(RETRY_DELAY_MAX),
+    backoffMultiplier: z.number().min(1).max(5).default(2),
+    retryableErrors: z.array(z.string().max(100)).max(20).optional(),
+});
+/**
+ * Task timeout policy
+ */
+export const TimeoutPolicySchema = z.object({
+    executionTimeoutMs: z.number().int().min(RETRY_DELAY_DEFAULT).max(TIMEOUT_QUEUE_MAX).default(TIMEOUT_ORCHESTRATION_EXECUTION),
+    queueTimeoutMs: z.number().int().min(RETRY_DELAY_DEFAULT).max(TIMEOUT_QUEUE_MAX).optional(),
+    gracefulShutdownMs: z.number().int().min(RETRY_DELAY_DEFAULT).max(RETRY_BACKOFF_CAP).default(TIMEOUT_ORCHESTRATION_GRACEFUL),
+});
+/**
+ * Task definition
+ */
+export const TaskDefinitionSchema = z.object({
+    taskId: z.string().uuid(),
+    name: z.string().max(200),
+    description: z.string().max(2000).optional(),
+    type: OrchTaskTypeSchema.default('sequential'),
+    priority: OrchTaskPrioritySchema.default('medium'),
+    agentId: z.string().uuid().optional(),
+    sessionId: z.string().uuid().optional(),
+    input: z.record(z.string(), z.unknown()).optional(),
+    dependencies: z.array(TaskDependencySchema).max(50).optional(),
+    retryPolicy: OrchRetryPolicySchema.optional(),
+    timeoutPolicy: TimeoutPolicySchema.optional(),
+    scheduledAt: z.string().datetime().optional(),
+    tags: z.array(z.string().max(50)).max(20).optional(),
+    metadata: z.record(z.string(), z.unknown()).optional(),
+});
+/**
+ * Task execution state
+ */
+export const TaskExecutionSchema = z.object({
+    taskId: z.string().uuid(),
+    status: OrchTaskStatusSchema,
+    attempt: z.number().int().min(1).default(1),
+    startedAt: z.string().datetime().optional(),
+    completedAt: z.string().datetime().optional(),
+    output: z.record(z.string(), z.unknown()).optional(),
+    error: z.string().max(STRING_LENGTH_CONTENT).optional(),
+    progress: z.number().min(0).max(100).optional(),
+    lastHeartbeat: z.string().datetime().optional(),
+});
+// ============================================================================
+// Task Queue Schemas
+// ============================================================================
+/**
+ * Queue create request
+ */
+export const QueueCreateRequestSchema = z.object({
+    name: z.string().max(100),
+    description: z.string().max(STRING_LENGTH_LONG).optional(),
+    maxConcurrency: z.number().int().min(1).max(100).default(5),
+    defaultPriority: OrchTaskPrioritySchema.default('medium'),
+    defaultRetryPolicy: OrchRetryPolicySchema.optional(),
+    defaultTimeoutPolicy: TimeoutPolicySchema.optional(),
+});
+/**
+ * Queue state
+ */
+export const QueueStateSchema = z.object({
+    queueId: z.string().uuid(),
+    name: z.string(),
+    pending: z.number().int().min(0),
+    running: z.number().int().min(0),
+    completed: z.number().int().min(0),
+    failed: z.number().int().min(0),
+    maxConcurrency: z.number().int().min(1),
+    isPaused: z.boolean().default(false),
+    createdAt: z.string().datetime(),
+    updatedAt: z.string().datetime(),
+});
+// ============================================================================
+// Task Submission Schemas
+// ============================================================================
+/**
+ * Task submit request
+ */
+export const TaskSubmitRequestSchema = z.object({
+    queueId: z.string().uuid().optional(),
+    name: z.string().max(200),
+    description: z.string().max(2000).optional(),
+    type: OrchTaskTypeSchema.default('sequential'),
+    priority: OrchTaskPrioritySchema.default('medium'),
+    agentId: z.string().uuid().optional(),
+    input: z.record(z.string(), z.unknown()).optional(),
+    dependencies: z.array(z.string().uuid()).max(50).optional(),
+    retryPolicy: OrchRetryPolicySchema.optional(),
+    timeoutPolicy: TimeoutPolicySchema.optional(),
+    scheduledAt: z.string().datetime().optional(),
+    tags: z.array(z.string().max(50)).max(20).optional(),
+});
+/**
+ * Task submit result
+ */
+export const TaskSubmitResultSchema = z.object({
+    taskId: z.string().uuid(),
+    queueId: z.string().uuid(),
+    status: OrchTaskStatusSchema,
+    position: z.number().int().min(0).optional(),
+    estimatedStartTime: z.string().datetime().optional(),
+    submittedAt: z.string().datetime(),
+});
+// ============================================================================
+// Task Query Schemas
+// ============================================================================
+/**
+ * Task query request
+ */
+export const TaskQueryRequestSchema = z.object({
+    queueId: z.string().uuid().optional(),
+    status: z.array(OrchTaskStatusSchema).optional(),
+    priority: z.array(OrchTaskPrioritySchema).optional(),
+    agentId: z.string().uuid().optional(),
+    tags: z.array(z.string().max(50)).optional(),
+    createdAfter: z.string().datetime().optional(),
+    createdBefore: z.string().datetime().optional(),
+    limit: z.number().int().min(1).max(100).default(50),
+    offset: z.number().int().min(0).default(0),
+    orderBy: z.enum(['createdAt', 'priority', 'scheduledAt', 'status']).default('createdAt'),
+    orderDir: z.enum(['asc', 'desc']).default('desc'),
+});
+/**
+ * Task query result
+ */
+export const TaskQueryResultSchema = z.object({
+    tasks: z.array(TaskDefinitionSchema.merge(TaskExecutionSchema.partial())),
+    total: z.number().int().min(0),
+    hasMore: z.boolean(),
+});
+// ============================================================================
+// Task Control Schemas
+// ============================================================================
+/**
+ * Task cancel request
+ */
+export const TaskCancelRequestSchema = z.object({
+    taskId: z.string().uuid(),
+    reason: z.string().max(500).optional(),
+    force: z.boolean().default(false),
+});
+/**
+ * Task pause request
+ */
+export const TaskPauseRequestSchema = z.object({
+    taskId: z.string().uuid(),
+    reason: z.string().max(500).optional(),
+});
+/**
+ * Task resume request
+ */
+export const TaskResumeRequestSchema = z.object({
+    taskId: z.string().uuid(),
+});
+/**
+ * Task retry request
+ */
+export const TaskRetryRequestSchema = z.object({
+    taskId: z.string().uuid(),
+    resetAttempts: z.boolean().default(false),
+});
+// ============================================================================
+// Orchestration Flow Schemas
+// ============================================================================
+/**
+ * Flow step
+ */
+export const FlowStepSchema = z.object({
+    stepId: z.string().max(100),
+    name: z.string().max(200),
+    type: OrchTaskTypeSchema,
+    agentId: z.string().uuid().optional(),
+    input: z.record(z.string(), z.unknown()).optional(),
+    condition: z.string().max(500).optional(),
+    onSuccess: z.string().max(100).optional(),
+    onFailure: z.string().max(100).optional(),
+    retryPolicy: OrchRetryPolicySchema.optional(),
+    timeoutPolicy: TimeoutPolicySchema.optional(),
+});
+/**
+ * Orchestration flow definition
+ */
+export const FlowDefinitionSchema = z.object({
+    flowId: z.string().uuid(),
+    name: z.string().max(200),
+    description: z.string().max(2000).optional(),
+    version: z.string().max(50).default('1.0.0'),
+    steps: z.array(FlowStepSchema).min(1).max(100),
+    startStep: z.string().max(100),
+    endSteps: z.array(z.string().max(100)).min(1).max(10),
+    defaultRetryPolicy: OrchRetryPolicySchema.optional(),
+    defaultTimeoutPolicy: TimeoutPolicySchema.optional(),
+    metadata: z.record(z.string(), z.unknown()).optional(),
+});
+/**
+ * Flow execution state
+ */
+export const FlowExecutionSchema = z.object({
+    executionId: z.string().uuid(),
+    flowId: z.string().uuid(),
+    status: OrchTaskStatusSchema,
+    currentStep: z.string().max(100).optional(),
+    stepHistory: z.array(z.object({
+        stepId: z.string(),
+        status: OrchTaskStatusSchema,
+        startedAt: z.string().datetime(),
+        completedAt: z.string().datetime().optional(),
+        output: z.record(z.string(), z.unknown()).optional(),
+        error: z.string().optional(),
+    })).optional(),
+    input: z.record(z.string(), z.unknown()).optional(),
+    output: z.record(z.string(), z.unknown()).optional(),
+    startedAt: z.string().datetime(),
+    completedAt: z.string().datetime().optional(),
+});
+// ============================================================================
+// Error Codes
+// ============================================================================
+export const OrchestrationErrorCode = {
+    TASK_NOT_FOUND: 'TASK_NOT_FOUND',
+    QUEUE_NOT_FOUND: 'QUEUE_NOT_FOUND',
+    FLOW_NOT_FOUND: 'FLOW_NOT_FOUND',
+    INVALID_STATE: 'INVALID_STATE',
+    DEPENDENCY_FAILED: 'DEPENDENCY_FAILED',
+    TIMEOUT: 'TIMEOUT',
+    CANCELLED: 'CANCELLED',
+    MAX_RETRIES: 'MAX_RETRIES',
+    QUEUE_FULL: 'QUEUE_FULL',
+    AGENT_UNAVAILABLE: 'AGENT_UNAVAILABLE',
+};
+// ============================================================================
+// Validation Functions
+// ============================================================================
+export function validateTaskSubmitRequest(data) {
+    return TaskSubmitRequestSchema.parse(data);
+}
+export function validateTaskQueryRequest(data) {
+    return TaskQueryRequestSchema.parse(data);
+}
+export function validateFlowDefinition(data) {
+    return FlowDefinitionSchema.parse(data);
+}
+export function validateQueueCreateRequest(data) {
+    return QueueCreateRequestSchema.parse(data);
+}
+export function safeValidateTaskSubmitRequest(data) {
+    const result = TaskSubmitRequestSchema.safeParse(data);
+    if (result.success)
+        return { success: true, data: result.data };
+    return { success: false, error: result.error };
+}
+// ============================================================================
+// Application Initialization Schemas
+// ============================================================================
+/**
+ * Storage mode for application initialization
+ * Note: This is specific to app bootstrap - see storage/v1 for the canonical StorageMode
+ */
+export const AppStorageModeSchema = z.enum(['sqlite', 'memory']);
+/**
+ * Application initialization configuration
+ */
+export const AppInitConfigSchema = z.object({
+    /** Storage backend mode */
+    storageMode: AppStorageModeSchema.default('sqlite'),
+    /** Custom storage path (optional, defaults to ~/.automatosx/data.db) */
+    storagePath: z.string().optional(),
+    /** Enable agent registry initialization */
+    enableAgents: z.boolean().default(true),
+    /** Enable ability registry initialization */
+    enableAbilities: z.boolean().default(true),
+    /** Enable provider registry initialization */
+    enableProviders: z.boolean().default(true),
+    /** Enable trace store initialization */
+    enableTracing: z.boolean().default(true),
+});
+/**
+ * Dependency container for initialized application
+ */
+export const DependencyContainerSchema = z.object({
+    /** Whether SQLite is actually being used (may fall back to memory) */
+    usingSqlite: z.boolean(),
+    /** Storage mode that was requested */
+    requestedMode: AppStorageModeSchema,
+    /** Initialization timestamp */
+    initializedAt: z.string().datetime(),
+    /** Features that were enabled */
+    enabledFeatures: z.object({
+        agents: z.boolean(),
+        abilities: z.boolean(),
+        providers: z.boolean(),
+        tracing: z.boolean(),
+    }),
+});
+/**
+ * Bootstrap result
+ */
+export const BootstrapResultSchema = z.object({
+    /** Whether bootstrap succeeded */
+    success: z.boolean(),
+    /** Container if successful */
+    container: DependencyContainerSchema.optional(),
+    /** Error message if failed */
+    error: z.string().optional(),
+    /** Warnings during initialization */
+    warnings: z.array(z.string()).default([]),
+});
+// ============================================================================
+// App Initialization Error Codes
+// ============================================================================
+export const AppInitErrorCode = {
+    SQLITE_UNAVAILABLE: 'APP_INIT_SQLITE_UNAVAILABLE',
+    STORAGE_INIT_FAILED: 'APP_INIT_STORAGE_FAILED',
+    PROVIDER_INIT_FAILED: 'APP_INIT_PROVIDER_FAILED',
+    AGENT_INIT_FAILED: 'APP_INIT_AGENT_FAILED',
+    ABILITY_INIT_FAILED: 'APP_INIT_ABILITY_FAILED',
+    ALREADY_INITIALIZED: 'APP_INIT_ALREADY_INITIALIZED',
+};
+// ============================================================================
+// App Initialization Validation Functions
+// ============================================================================
+export function validateAppInitConfig(data) {
+    return AppInitConfigSchema.parse(data);
+}
+export function safeValidateAppInitConfig(data) {
+    const result = AppInitConfigSchema.safeParse(data);
+    if (result.success)
+        return { success: true, data: result.data };
+    return { success: false, error: result.error };
+}
+export function createDefaultAppInitConfig() {
+    return AppInitConfigSchema.parse({});
+}
+//# sourceMappingURL=schema.js.map

package/dist/orchestration/v1/schema.js.map

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

package/dist/provider/v1/circuit-breaker.d.ts

@@ -0,0 +1,151 @@
+/**
+ * Circuit Breaker Contract V1
+ *
+ * Provides circuit breaker pattern for provider resilience.
+ * Prevents cascading failures when providers become unhealthy.
+ *
+ * Invariants:
+ * - INV-CB-001: Closed state allows all requests
+ * - INV-CB-002: Open state rejects until resetTimeout elapsed
+ * - INV-CB-003: Half-open state allows limited test requests
+ * - INV-CB-004: Failure threshold triggers transition to open
+ * - INV-CB-005: Successful tests in half-open trigger transition to closed
+ */
+import { z } from 'zod';
+/**
+ * Circuit breaker states
+ */
+export declare const CircuitStateSchema: z.ZodEnum<["closed", "open", "halfOpen"]>;
+export type CircuitState = z.infer<typeof CircuitStateSchema>;
+/**
+ * Circuit breaker configuration
+ */
+export declare const CircuitBreakerConfigSchema: z.ZodObject<{
+    /** Failures before opening circuit (INV-CB-004) */
+    failureThreshold: z.ZodDefault<z.ZodNumber>;
+    /** Time before attempting half-open state in ms (INV-CB-002) */
+    resetTimeoutMs: z.ZodDefault<z.ZodNumber>;
+    /** Number of test requests allowed in half-open state (INV-CB-003) */
+    halfOpenRequests: z.ZodDefault<z.ZodNumber>;
+    /** Interval for passive health checks in ms */
+    monitorIntervalMs: z.ZodDefault<z.ZodNumber>;
+    /** Success threshold to close circuit from half-open */
+    successThreshold: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    failureThreshold: number;
+    resetTimeoutMs: number;
+    halfOpenRequests: number;
+    monitorIntervalMs: number;
+    successThreshold: number;
+}, {
+    failureThreshold?: number | undefined;
+    resetTimeoutMs?: number | undefined;
+    halfOpenRequests?: number | undefined;
+    monitorIntervalMs?: number | undefined;
+    successThreshold?: number | undefined;
+}>;
+export type CircuitBreakerConfig = z.infer<typeof CircuitBreakerConfigSchema>;
+/**
+ * Circuit breaker state snapshot
+ */
+export declare const CircuitBreakerStateSchema: z.ZodObject<{
+    /** Current circuit state */
+    state: z.ZodEnum<["closed", "open", "halfOpen"]>;
+    /** Consecutive failure count */
+    failureCount: z.ZodNumber;
+    /** Success count in half-open state */
+    successCount: z.ZodNumber;
+    /** Timestamp of last failure */
+    lastFailureTime: z.ZodOptional<z.ZodString>;
+    /** Timestamp of last success */
+    lastSuccessTime: z.ZodOptional<z.ZodString>;
+    /** Next allowed attempt time (when open) */
+    nextAttemptTime: z.ZodOptional<z.ZodString>;
+    /** Time of last state transition */
+    lastTransitionTime: z.ZodOptional<z.ZodString>;
+    /** Total requests since last reset */
+    totalRequests: z.ZodDefault<z.ZodNumber>;
+    /** Total failures since last reset */
+    totalFailures: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    successCount: number;
+    failureCount: number;
+    state: "open" | "closed" | "halfOpen";
+    totalRequests: number;
+    totalFailures: number;
+    lastFailureTime?: string | undefined;
+    lastSuccessTime?: string | undefined;
+    nextAttemptTime?: string | undefined;
+    lastTransitionTime?: string | undefined;
+}, {
+    successCount: number;
+    failureCount: number;
+    state: "open" | "closed" | "halfOpen";
+    lastFailureTime?: string | undefined;
+    lastSuccessTime?: string | undefined;
+    nextAttemptTime?: string | undefined;
+    lastTransitionTime?: string | undefined;
+    totalRequests?: number | undefined;
+    totalFailures?: number | undefined;
+}>;
+export type CircuitBreakerState = z.infer<typeof CircuitBreakerStateSchema>;
+/**
+ * Circuit breaker event types
+ */
+export declare const CircuitBreakerEventTypeSchema: z.ZodEnum<["circuit.opened", "circuit.closed", "circuit.halfOpen", "circuit.requestAllowed", "circuit.requestRejected", "circuit.successRecorded", "circuit.failureRecorded"]>;
+export type CircuitBreakerEventType = z.infer<typeof CircuitBreakerEventTypeSchema>;
+/**
+ * Circuit breaker event
+ */
+export declare const CircuitBreakerEventSchema: z.ZodObject<{
+    eventId: z.ZodString;
+    type: z.ZodEnum<["circuit.opened", "circuit.closed", "circuit.halfOpen", "circuit.requestAllowed", "circuit.requestRejected", "circuit.successRecorded", "circuit.failureRecorded"]>;
+    providerId: z.ZodString;
+    timestamp: z.ZodString;
+    previousState: z.ZodOptional<z.ZodEnum<["closed", "open", "halfOpen"]>>;
+    currentState: z.ZodEnum<["closed", "open", "halfOpen"]>;
+    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    type: "circuit.opened" | "circuit.closed" | "circuit.halfOpen" | "circuit.requestAllowed" | "circuit.requestRejected" | "circuit.successRecorded" | "circuit.failureRecorded";
+    timestamp: string;
+    eventId: string;
+    providerId: string;
+    currentState: "open" | "closed" | "halfOpen";
+    details?: Record<string, unknown> | undefined;
+    previousState?: "open" | "closed" | "halfOpen" | undefined;
+}, {
+    type: "circuit.opened" | "circuit.closed" | "circuit.halfOpen" | "circuit.requestAllowed" | "circuit.requestRejected" | "circuit.successRecorded" | "circuit.failureRecorded";
+    timestamp: string;
+    eventId: string;
+    providerId: string;
+    currentState: "open" | "closed" | "halfOpen";
+    details?: Record<string, unknown> | undefined;
+    previousState?: "open" | "closed" | "halfOpen" | undefined;
+}>;
+export type CircuitBreakerEvent = z.infer<typeof CircuitBreakerEventSchema>;
+/**
+ * Error codes for circuit breaker operations
+ */
+export declare const CircuitBreakerErrorCodes: {
+    readonly CIRCUIT_OPEN: "CIRCUIT_BREAKER_OPEN";
+    readonly HALF_OPEN_LIMIT: "CIRCUIT_BREAKER_HALF_OPEN_LIMIT";
+    readonly INVALID_CONFIG: "CIRCUIT_BREAKER_INVALID_CONFIG";
+};
+export type CircuitBreakerErrorCode = (typeof CircuitBreakerErrorCodes)[keyof typeof CircuitBreakerErrorCodes];
+/**
+ * Validates circuit breaker configuration
+ */
+export declare function validateCircuitBreakerConfig(data: unknown): CircuitBreakerConfig;
+/**
+ * Validates circuit breaker state
+ */
+export declare function validateCircuitBreakerState(data: unknown): CircuitBreakerState;
+/**
+ * Creates default circuit breaker configuration
+ */
+export declare function createDefaultCircuitBreakerConfig(): CircuitBreakerConfig;
+/**
+ * Creates initial circuit breaker state (closed)
+ */
+export declare function createInitialCircuitBreakerState(): CircuitBreakerState;
+//# sourceMappingURL=circuit-breaker.d.ts.map

package/dist/provider/v1/circuit-breaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.d.ts","sourceRoot":"","sources":["../../../src/provider/v1/circuit-breaker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,kBAAkB,2CAAyC,CAAC;AAEzE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,0BAA0B;IACrC,mDAAmD;;IAGnD,gEAAgE;;IAGhE,sEAAsE;;IAGtE,+CAA+C;;IAG/C,wDAAwD;;;;;;;;;;;;;;EAExD,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,yBAAyB;IACpC,4BAA4B;;IAG5B,gCAAgC;;IAGhC,uCAAuC;;IAGvC,gCAAgC;;IAGhC,gCAAgC;;IAGhC,4CAA4C;;IAG5C,oCAAoC;;IAGpC,sCAAsC;;IAGtC,sCAAsC;;;;;;;;;;;;;;;;;;;;;;EAEtC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;GAEG;AACH,eAAO,MAAM,6BAA6B,gLAQxC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEpF;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;EAQpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;CAI3B,CAAC;AAEX,MAAM,MAAM,uBAAuB,GACjC,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,OAAO,wBAAwB,CAAC,CAAC;AAE3E;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,OAAO,GAAG,oBAAoB,CAEhF;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,OAAO,GAAG,mBAAmB,CAE9E;AAED;;GAEG;AACH,wBAAgB,iCAAiC,IAAI,oBAAoB,CAExE;AAED;;GAEG;AACH,wBAAgB,gCAAgC,IAAI,mBAAmB,CAQtE"}