task-o-matic-core 0.1.0

package/dist/types/results.d.ts

@@ -0,0 +1,200 @@
+import { Task, TaskAIMetadata, DocumentationDetection, BTSConfig } from "./index";
+/**
+ * Generic operation result using discriminated union pattern.
+ * Prevents invalid states like { success: true, error: "..." }
+ *
+ * Note: This type uses discriminated unions for operations that may return
+ * either success or failure. Most task operations throw exceptions on error
+ * instead of returning error results.
+ *
+ * @example
+ * ```typescript
+ * const result: OperationResult<Task> =
+ *   condition
+ *     ? { success: true, data: task }
+ *     : { success: false, error: "Task not found" };
+ *
+ * if (result.success) {
+ *   console.log(result.data.title); // ✓ TypeScript knows data exists
+ * } else {
+ *   console.error(result.error); // ✓ TypeScript knows error exists
+ * }
+ * ```
+ */
+export type OperationResult<T = any> = {
+    success: true;
+    data: T;
+    stats?: Record<string, any>;
+    metadata?: Record<string, any>;
+} | {
+    success: false;
+    error: string;
+    stats?: Record<string, any>;
+    metadata?: Record<string, any>;
+};
+/**
+ * Result of task creation operation.
+ * Always returns success; throws exception on error.
+ */
+export interface CreateTaskResult {
+    success: true;
+    task: Task;
+    aiMetadata?: TaskAIMetadata;
+}
+/**
+ * Result of task enhancement operation.
+ * Always returns success; throws exception on error.
+ */
+export interface EnhanceTaskResult {
+    success: true;
+    task: Task;
+    enhancedContent: string;
+    stats: {
+        originalLength: number;
+        enhancedLength: number;
+        duration: number;
+        tokenUsage?: {
+            prompt: number;
+            completion: number;
+            total: number;
+        };
+        timeToFirstToken?: number;
+        cost?: number;
+    };
+    metadata: {
+        aiProvider: string;
+        aiModel: string;
+        confidence: number;
+    };
+}
+/**
+ * Result of task splitting operation.
+ * Always returns success; throws exception on error.
+ */
+export interface SplitTaskResult {
+    success: true;
+    task: Task;
+    subtasks: Task[];
+    stats: {
+        subtasksCreated: number;
+        duration: number;
+        tokenUsage?: {
+            prompt: number;
+            completion: number;
+            total: number;
+        };
+        timeToFirstToken?: number;
+        cost?: number;
+    };
+    metadata: {
+        aiProvider: string;
+        aiModel: string;
+        confidence?: number;
+    };
+}
+/**
+ * Result of task planning operation.
+ * Always returns success; throws exception on error.
+ */
+export interface PlanTaskResult {
+    success: true;
+    task: Task;
+    plan: string;
+    stats: {
+        duration: number;
+        tokenUsage?: {
+            prompt: number;
+            completion: number;
+            total: number;
+        };
+        timeToFirstToken?: number;
+        cost?: number;
+    };
+    metadata: {
+        aiProvider: string;
+        aiModel: string;
+    };
+}
+/**
+ * Result of task documentation operation.
+ * Always returns success; throws exception on error.
+ */
+export interface DocumentTaskResult {
+    success: true;
+    task: Task;
+    analysis?: DocumentationDetection;
+    documentation?: any;
+    stats: {
+        duration: number;
+    };
+}
+/**
+ * Result of task deletion operation.
+ * Always returns success; throws exception on error.
+ */
+export interface DeleteTaskResult {
+    success: true;
+    deleted: Task[];
+    orphanedSubtasks: Task[];
+}
+/**
+ * Result of PRD parsing operation.
+ * Always returns success; throws exception on error.
+ */
+export interface PRDParseResult {
+    success: true;
+    prd: {
+        overview: string;
+        objectives: string[];
+        features: string[];
+    };
+    tasks: Task[];
+    stats: {
+        tasksCreated: number;
+        duration: number;
+        aiProvider: string;
+        aiModel: string;
+        tokenUsage?: {
+            prompt: number;
+            completion: number;
+            total: number;
+        };
+        timeToFirstToken?: number;
+        cost?: number;
+    };
+    steps: {
+        step: string;
+        status: "completed" | "failed";
+        duration: number;
+        details?: any;
+    }[];
+}
+/**
+ * AI response wrapper for stack suggestion.
+ * Contains the config and reasoning explanation.
+ */
+export interface StackSuggestionResponse {
+    config: BTSConfig;
+    reasoning: string;
+}
+/**
+ * Result of stack suggestion operation.
+ * Always returns success; throws exception on error.
+ */
+export interface SuggestStackResult {
+    success: true;
+    stack: BTSConfig;
+    reasoning: string;
+    savedPath?: string;
+    stats: {
+        duration: number;
+        tokenUsage?: {
+            prompt: number;
+            completion: number;
+            total: number;
+        };
+        timeToFirstToken?: number;
+        cost?: number;
+    };
+}
+//# sourceMappingURL=results.d.ts.map

package/dist/types/results.d.ts.map

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

package/dist/types/results.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/workflow-options.d.ts

@@ -0,0 +1,82 @@
+import { StreamingAIOptions } from "./options";
+import type { BTSConfig } from "./index";
+/**
+ * Comprehensive options for workflow command automation.
+ * All options are optional - workflow remains fully interactive by default.
+ */
+export interface WorkflowAutomationOptions extends StreamingAIOptions {
+    skipAll?: boolean;
+    autoAccept?: boolean;
+    configFile?: string;
+    skipInit?: boolean;
+    projectName?: string;
+    initMethod?: "quick" | "custom" | "ai";
+    projectDescription?: string;
+    useExistingConfig?: boolean;
+    frontend?: string;
+    backend?: string;
+    database?: string;
+    auth?: boolean;
+    bootstrap?: boolean;
+    includeDocs?: boolean;
+    skipPrd?: boolean;
+    prdMethod?: "upload" | "manual" | "ai" | "skip";
+    prdFile?: string;
+    prdDescription?: string;
+    prdContent?: string;
+    prdMultiGeneration?: boolean;
+    skipPrdMultiGeneration?: boolean;
+    prdMultiGenerationModels?: string;
+    prdCombine?: boolean;
+    skipPrdCombine?: boolean;
+    prdCombineModel?: string;
+    skipStackSuggestion?: boolean;
+    suggestStackFromPrd?: string | true;
+    skipBootstrap?: boolean;
+    skipRefine?: boolean;
+    refineMethod?: "manual" | "ai" | "skip";
+    refineFeedback?: string;
+    skipPrdQuestionRefine?: boolean;
+    prdQuestionRefine?: boolean;
+    prdAnswerMode?: "user" | "ai";
+    prdAnswerAiProvider?: string;
+    prdAnswerAiModel?: string;
+    prdAnswerAiKey?: string;
+    prdAnswerAiProviderUrl?: string;
+    prdAnswerAiReasoning?: boolean;
+    skipGenerate?: boolean;
+    generateMethod?: "standard" | "ai";
+    generateInstructions?: string;
+    skipSplit?: boolean;
+    splitTasks?: string;
+    splitAll?: boolean;
+    splitMethod?: "interactive" | "standard" | "custom";
+    splitInstructions?: string;
+    execute?: boolean;
+    executeTasks?: boolean;
+    executeConcurrency?: number;
+    autoCommit?: boolean;
+    executeTool?: string;
+    executeModel?: string;
+    executeMaxRetries?: number;
+    executePlan?: boolean;
+    executePlanModel?: string;
+    executeReview?: boolean;
+    executeReviewModel?: string;
+}
+export interface WorkflowState {
+    initialized: boolean;
+    currentStep: "initialize" | "define-prd" | "stack-suggestion" | "bootstrap" | "question-refine-prd" | "refine-prd" | "generate-tasks" | "split-tasks" | "execute-tasks" | "complete";
+    projectName?: string;
+    projectDir?: string;
+    aiConfig?: any;
+    prdFile?: string;
+    prdContent?: string;
+    tasks?: Array<{
+        id: string;
+        title: string;
+        description?: string;
+    }>;
+    suggestedStack?: BTSConfig;
+}
+//# sourceMappingURL=workflow-options.d.ts.map

package/dist/types/workflow-options.d.ts.map

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

package/dist/types/workflow-options.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/workflow-results.d.ts

@@ -0,0 +1,82 @@
+import { Task } from "./index";
+/**
+ * Result types for workflow service operations
+ */
+export interface InitializeResult {
+    success: boolean;
+    projectDir: string;
+    projectName: string;
+    aiConfig: {
+        provider: string;
+        model: string;
+        key: string;
+    };
+    stackConfig?: {
+        projectName: string;
+        aiProvider: string;
+        aiModel: string;
+        frontend?: string;
+        backend?: string;
+        database?: string;
+        auth?: boolean;
+        reasoning?: string;
+    };
+    bootstrapped: boolean;
+}
+export interface DefinePRDResult {
+    success: boolean;
+    prdFile: string;
+    prdContent: string;
+    method: "upload" | "manual" | "ai" | "skip";
+    stats?: {
+        duration: number;
+        tokenUsage?: {
+            prompt: number;
+            completion: number;
+            total: number;
+        };
+        timeToFirstToken?: number;
+        cost?: number;
+    };
+}
+export interface RefinePRDResult {
+    success: boolean;
+    prdFile: string;
+    prdContent: string;
+    questions?: string[];
+    answers?: Record<string, string>;
+    stats?: {
+        duration: number;
+        tokenUsage?: {
+            prompt: number;
+            completion: number;
+            total: number;
+        };
+        timeToFirstToken?: number;
+        cost?: number;
+    };
+}
+export interface GenerateTasksResult {
+    success: boolean;
+    tasks: Task[];
+    stats: {
+        tasksCreated: number;
+        duration: number;
+        tokenUsage?: {
+            prompt: number;
+            completion: number;
+            total: number;
+        };
+        timeToFirstToken?: number;
+        cost?: number;
+    };
+}
+export interface SplitTasksResult {
+    success: boolean;
+    results: Array<{
+        taskId: string;
+        subtasks: Task[];
+        error?: string;
+    }>;
+}
+//# sourceMappingURL=workflow-results.d.ts.map

package/dist/types/workflow-results.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-results.d.ts","sourceRoot":"","sources":["../../src/types/workflow-results.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAY,MAAM,SAAS,CAAC;AAEzC;;GAEG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE;QACR,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IACF,WAAW,CAAC,EAAE;QACZ,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,IAAI,GAAG,MAAM,CAAC;IAC5C,KAAK,CAAC,EAAE;QACN,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE;YACX,MAAM,EAAE,MAAM,CAAC;YACf,UAAU,EAAE,MAAM,CAAC;YACnB,KAAK,EAAE,MAAM,CAAC;SACf,CAAC;QACF,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE;QACN,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE;YACX,MAAM,EAAE,MAAM,CAAC;YACf,UAAU,EAAE,MAAM,CAAC;YACnB,KAAK,EAAE,MAAM,CAAC;SACf,CAAC;QACF,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,KAAK,EAAE;QACL,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE;YACX,MAAM,EAAE,MAAM,CAAC;YACf,UAAU,EAAE,MAAM,CAAC;YACnB,KAAK,EAAE,MAAM,CAAC;SACf,CAAC;QACF,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,KAAK,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,IAAI,EAAE,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;CACJ"}

package/dist/types/workflow-results.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/utils/ai-config-builder.d.ts

@@ -0,0 +1,14 @@
+import { AIConfig } from "../types";
+export interface AIOptions {
+    aiProvider?: string;
+    aiModel?: string;
+    aiKey?: string;
+    aiProviderUrl?: string;
+    aiReasoning?: string;
+}
+/**
+ * Builds an AI configuration object from CLI options
+ * This eliminates the duplication of this pattern across 10+ files
+ */
+export declare function buildAIConfig(options?: AIOptions): Partial<AIConfig>;
+//# sourceMappingURL=ai-config-builder.d.ts.map

package/dist/utils/ai-config-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-config-builder.d.ts","sourceRoot":"","sources":["../../src/utils/ai-config-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEpC,MAAM,WAAW,SAAS;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,CAkBpE"}

package/dist/utils/ai-config-builder.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildAIConfig = buildAIConfig;
+/**
+ * Builds an AI configuration object from CLI options
+ * This eliminates the duplication of this pattern across 10+ files
+ */
+function buildAIConfig(options) {
+    if (!options)
+        return {};
+    return {
+        ...(options.aiProvider && {
+            provider: options.aiProvider,
+        }),
+        ...(options.aiModel && { model: options.aiModel }),
+        ...(options.aiKey && { apiKey: options.aiKey }),
+        ...(options.aiProviderUrl && { baseURL: options.aiProviderUrl }),
+        ...(options.aiReasoning && {
+            reasoning: { maxTokens: parseInt(options.aiReasoning, 10) },
+        }),
+    };
+}

package/dist/utils/ai-operation-utility.d.ts

@@ -0,0 +1,142 @@
+import type { ToolSet } from "ai";
+import { AIConfig, StreamingOptions, RetryConfig } from "../types";
+import { BaseOperations } from "../lib/ai-service/base-operations";
+export interface AIOperationResult<T> {
+    result: T;
+    metrics: {
+        duration: number;
+        tokenUsage?: {
+            prompt: number;
+            completion: number;
+            total: number;
+        };
+        timeToFirstToken?: number;
+    };
+}
+export interface AIOperationOptions {
+    streamingOptions?: StreamingOptions;
+    retryConfig?: Partial<RetryConfig>;
+    aiConfig?: Partial<AIConfig>;
+    enableFilesystemTools?: boolean;
+    context?: Record<string, unknown>;
+    maxRetries?: number;
+}
+/**
+ * AIOperationUtility - Centralized utility for AI operations with metrics and error handling
+ *
+ * Extends BaseOperations to inherit core AI functionality (streamText, model provider, etc.)
+ * and adds standardized metrics collection, error handling, and retry logic.
+ *
+ * @example
+ * ```typescript
+ * const utility = new AIOperationUtility();
+ *
+ * // Execute operation with metrics
+ * const result = await utility.executeAIOperation(
+ *   "Task breakdown",
+ *   async () => performBreakdown(task),
+ *   {
+ *     maxRetries: 3,
+ *     streamingOptions: { onChunk: console.log }
+ *   }
+ * );
+ *
+ * console.log(result.metrics.duration);
+ * console.log(result.metrics.timeToFirstToken);
+ * ```
+ */
+export declare class AIOperationUtility extends BaseOperations {
+    /**
+     * Execute an AI operation with standardized metrics, error handling, and streaming support
+     *
+     * This method wraps AI operations to provide:
+     * - Automatic retry logic with configurable attempts
+     * - Metrics collection (duration, token usage, time to first token)
+     * - Error handling with TaskOMaticError wrapping
+     * - Streaming support with metrics capture
+     *
+     * @param operationName - Human-readable name for the operation (used in errors)
+     * @param operation - The async operation to execute
+     * @param options - Configuration options for retry, streaming, and AI config
+     * @returns Promise resolving to AIOperationResult with result and metrics
+     * @throws {TaskOMaticError} If operation fails after all retry attempts
+     *
+     * @example
+     * ```typescript
+     * try {
+     *   const result = await utility.executeAIOperation(
+     *     "Task enhancement",
+     *     async () => enhanceTask(task),
+     *     { maxRetries: 2 }
+     *   );
+     *   console.log(`Operation took ${result.metrics.duration}ms`);
+     * } catch (error) {
+     *   if (error instanceof TaskOMaticError) {
+     *     console.error(error.getDetails());
+     *   }
+     * }
+     * ```
+     */
+    executeAIOperation<T>(operationName: string, operation: () => Promise<T>, options?: AIOperationOptions): Promise<AIOperationResult<T>>;
+    /**
+     * Standardized streaming text operation with tool support
+     *
+     * This method provides a unified interface for AI text generation with:
+     * - Optional tool integration (filesystem, MCP, etc.)
+     * - Streaming support with callbacks
+     * - Context7 documentation caching
+     * - Metrics collection
+     * - Error handling
+     *
+     * @param systemPrompt - System prompt for the AI
+     * @param userMessage - User message/prompt
+     * @param config - Optional AI configuration overrides
+     * @param streamingOptions - Optional streaming callbacks
+     * @param tools - Optional tool set to provide to the AI
+     * @returns Promise resolving to the generated text
+     *
+     * @example
+     * ```typescript
+     * const result = await utility.streamTextWithTools(
+     *   "You are a helpful assistant",
+     *   "Explain quantum computing",
+     *   undefined,
+     *   { onChunk: (chunk) => console.log(chunk) },
+     *   filesystemTools
+     * );
+     * ```
+     */
+    streamTextWithTools(systemPrompt: string, userMessage: string, config?: Partial<AIConfig>, streamingOptions?: StreamingOptions, tools?: ToolSet): Promise<string>;
+    /**
+     * Wrap streaming options to capture metrics
+     *
+     * @private
+     */
+    private wrapStreamingOptions;
+    /**
+     * Create streaming configuration with Context7 handling and callbacks
+     *
+     * This method creates a unified streaming configuration that:
+     * - Always handles Context7 tool-result events (even without streaming UI)
+     * - Forwards text-delta events to onChunk callback
+     * - Forwards reasoning-delta events to onReasoning callback
+     * - Handles errors with onError callback
+     * - Provides onFinish callback with completion data
+     *
+     * @private
+     */
+    private createStreamingConfig;
+    /**
+     * Extract token usage from AI result
+     *
+     * @private
+     */
+    private extractTokenUsageFromResult;
+    /**
+     * Get error message from any error type
+     *
+     * @private
+     */
+    private getErrorMessage;
+}
+//# sourceMappingURL=ai-operation-utility.d.ts.map

package/dist/utils/ai-operation-utility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-operation-utility.d.ts","sourceRoot":"","sources":["../../src/utils/ai-operation-utility.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAGnE,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,MAAM,EAAE,CAAC,CAAC;IACV,OAAO,EAAE;QACP,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE;YACX,MAAM,EAAE,MAAM,CAAC;YACf,UAAU,EAAE,MAAM,CAAC;YACnB,KAAK,EAAE,MAAM,CAAC;SACf,CAAC;QACF,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH;AAED,MAAM,WAAW,kBAAkB;IACjC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,WAAW,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC7B,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,kBAAmB,SAAQ,cAAc;IACpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACG,kBAAkB,CAAC,CAAC,EACxB,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAyEhC;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACG,mBAAmB,CACvB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,EAC1B,gBAAgB,CAAC,EAAE,gBAAgB,EACnC,KAAK,CAAC,EAAE,OAAO,GACd,OAAO,CAAC,MAAM,CAAC;IA8DlB;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAgC5B;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,qBAAqB;IAqC7B;;;;OAIG;IACH,OAAO,CAAC,2BAA2B;IAiBnC;;;;OAIG;IACH,OAAO,CAAC,eAAe;CASxB"}