task-o-matic-core 0.1.0

package/dist/index.js

@@ -0,0 +1,46 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./lib/config"), exports);
+__exportStar(require("./lib/logger"), exports);
+__exportStar(require("./lib/better-t-stack-cli"), exports);
+__exportStar(require("./lib/validation"), exports);
+__exportStar(require("./lib/context-builder"), exports);
+__exportStar(require("./lib/ai-service/ai-operations"), exports);
+__exportStar(require("./lib/ai-service/task-operations"), exports);
+__exportStar(require("./lib/ai-service/prd-operations"), exports);
+__exportStar(require("./lib/ai-service/documentation-operations"), exports);
+__exportStar(require("./lib/executors/executor-factory"), exports);
+__exportStar(require("./lib/prompt-builder"), exports);
+__exportStar(require("./lib/task-execution"), exports);
+__exportStar(require("./lib/task-loop-execution"), exports);
+__exportStar(require("./services/tasks"), exports);
+__exportStar(require("./services/workflow"), exports);
+__exportStar(require("./services/prd"), exports);
+__exportStar(require("./services/benchmark"), exports);
+__exportStar(require("./lib/benchmark/registry"), exports);
+__exportStar(require("./lib/benchmark/types"), exports);
+__exportStar(require("./utils/ai-service-factory"), exports);
+__exportStar(require("./utils/task-o-matic-error"), exports);
+__exportStar(require("./lib/hooks"), exports);
+// Moved to CLI:
+// - ./utils/streaming-options
+// - ./utils/display-helpers
+// - ./lib/hooks/logger
+__exportStar(require("./utils/model-executor-parser"), exports);
+__exportStar(require("./utils/model-parser"), exports);
+__exportStar(require("./prompts"), exports);

package/dist/lib/ai-service/ai-operations.d.ts

@@ -0,0 +1,45 @@
+import { AIConfig, Task, AIPRDParseResult, DocumentationDetection, StreamingOptions, RetryConfig, TaskDocumentation } from "../../types";
+import { BaseOperations } from "./base-operations";
+/**
+ * Main AIOperations class that delegates to specialized operation classes.
+ * This provides a unified API for all AI operations while keeping the implementation modular.
+ */
+export declare class AIOperations extends BaseOperations {
+    private prdOps;
+    private taskOps;
+    private docOps;
+    parsePRD(prdContent: string, config?: Partial<AIConfig>, promptOverride?: string, userMessage?: string, streamingOptions?: StreamingOptions, retryConfig?: Partial<RetryConfig>, workingDirectory?: string, enableFilesystemTools?: boolean): Promise<AIPRDParseResult>;
+    breakdownTask(task: Task, config?: Partial<AIConfig>, promptOverride?: string, userMessage?: string, streamingOptions?: StreamingOptions, retryConfig?: Partial<RetryConfig>, fullContent?: string, stackInfo?: string, existingSubtasks?: Task[], enableFilesystemTools?: boolean): Promise<Array<{
+        title: string;
+        content: string;
+        estimatedEffort?: string;
+    }>>;
+    enhanceTask(title: string, description?: string, config?: Partial<AIConfig>, promptOverride?: string, userMessage?: string, taskId?: string, streamingOptions?: StreamingOptions, retryConfig?: Partial<RetryConfig>): Promise<string>;
+    reworkPRD(prdContent: string, feedback: string, config?: Partial<AIConfig>, promptOverride?: string, userMessage?: string, streamingOptions?: StreamingOptions, retryConfig?: Partial<RetryConfig>, workingDirectory?: string, enableFilesystemTools?: boolean): Promise<string>;
+    generatePRDQuestions(prdContent: string, config?: Partial<AIConfig>, promptOverride?: string, userMessage?: string, streamingOptions?: StreamingOptions, retryConfig?: Partial<RetryConfig>, workingDirectory?: string, enableFilesystemTools?: boolean): Promise<string[]>;
+    answerPRDQuestions(prdContent: string, questions: string[], config?: Partial<AIConfig>, contextInfo?: {
+        stackInfo?: string;
+        projectDescription?: string;
+    }, streamingOptions?: StreamingOptions, retryConfig?: Partial<RetryConfig>): Promise<Record<string, string>>;
+    generatePRD(description: string, config?: Partial<AIConfig>, promptOverride?: string, userMessage?: string, streamingOptions?: StreamingOptions, retryConfig?: Partial<RetryConfig>): Promise<string>;
+    combinePRDs(prds: string[], originalDescription: string, config?: Partial<AIConfig>, promptOverride?: string, userMessage?: string, streamingOptions?: StreamingOptions, retryConfig?: Partial<RetryConfig>): Promise<string>;
+    enhanceTaskWithDocumentation(taskId: string, taskTitle: string, taskDescription: string, stackInfo?: string, streamingOptions?: StreamingOptions, retryConfig?: Partial<RetryConfig>, config?: Partial<AIConfig>, existingResearch?: Record<string, Array<{
+        query: string;
+        doc: string;
+    }>>): Promise<string>;
+    analyzeDocumentationNeeds(taskId: string, taskTitle: string, taskDescription: string, stackInfo?: string, streamingOptions?: StreamingOptions, retryConfig?: Partial<RetryConfig>, config?: Partial<AIConfig>, existingResearch?: (TaskDocumentation | undefined)[]): Promise<DocumentationDetection>;
+    generateDocumentationRecap(libraries: Array<{
+        name: string;
+        context7Id: string;
+        reason: string;
+    }>, documentContents: Array<{
+        library: string;
+        content: string;
+    }>, streamingOptions?: StreamingOptions, retryConfig?: Partial<RetryConfig>): Promise<string>;
+    planTask(taskContext: string, taskDetails: string, config?: Partial<AIConfig>, promptOverride?: string, userMessage?: string, streamingOptions?: StreamingOptions, retryConfig?: Partial<RetryConfig>): Promise<string>;
+    suggestStack(prdContent: string, projectName?: string, config?: Partial<AIConfig>, promptOverride?: string, userMessage?: string, streamingOptions?: StreamingOptions, retryConfig?: Partial<RetryConfig>, workingDirectory?: string, enableFilesystemTools?: boolean): Promise<{
+        config: import("../../types").BTSConfig;
+        reasoning: string;
+    }>;
+}
+//# sourceMappingURL=ai-operations.d.ts.map

package/dist/lib/ai-service/ai-operations.d.ts.map

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

package/dist/lib/ai-service/ai-operations.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AIOperations = void 0;
+const base_operations_1 = require("./base-operations");
+const prd_operations_1 = require("./prd-operations");
+const task_operations_1 = require("./task-operations");
+const documentation_operations_1 = require("./documentation-operations");
+/**
+ * Main AIOperations class that delegates to specialized operation classes.
+ * This provides a unified API for all AI operations while keeping the implementation modular.
+ */
+class AIOperations extends base_operations_1.BaseOperations {
+    prdOps = new prd_operations_1.PRDOperations();
+    taskOps = new task_operations_1.TaskOperations();
+    docOps = new documentation_operations_1.DocumentationOperations();
+    // PRD Operations - Delegated to PRDOperations
+    async parsePRD(prdContent, config, promptOverride, userMessage, streamingOptions, retryConfig, workingDirectory, enableFilesystemTools) {
+        return this.prdOps.parsePRD(prdContent, config, promptOverride, userMessage, streamingOptions, retryConfig, workingDirectory, enableFilesystemTools);
+    }
+    // Task Operations - Delegated to TaskOperations
+    async breakdownTask(task, config, promptOverride, userMessage, streamingOptions, retryConfig, fullContent, stackInfo, existingSubtasks, enableFilesystemTools) {
+        return this.taskOps.breakdownTask(task, config, promptOverride, userMessage, streamingOptions, retryConfig, fullContent, stackInfo, existingSubtasks, enableFilesystemTools);
+    }
+    async enhanceTask(title, description, config, promptOverride, userMessage, taskId, streamingOptions, retryConfig) {
+        return this.taskOps.enhanceTask(title, description, config, promptOverride, userMessage, taskId, streamingOptions, retryConfig);
+    }
+    async reworkPRD(prdContent, feedback, config, promptOverride, userMessage, streamingOptions, retryConfig, workingDirectory, enableFilesystemTools) {
+        return this.prdOps.reworkPRD(prdContent, feedback, config, promptOverride, userMessage, streamingOptions, retryConfig, workingDirectory, enableFilesystemTools);
+    }
+    async generatePRDQuestions(prdContent, config, promptOverride, userMessage, streamingOptions, retryConfig, workingDirectory, enableFilesystemTools) {
+        return this.prdOps.generatePRDQuestions(prdContent, config, promptOverride, userMessage, streamingOptions, retryConfig, workingDirectory, enableFilesystemTools);
+    }
+    async answerPRDQuestions(prdContent, questions, config, contextInfo, streamingOptions, retryConfig) {
+        return this.prdOps.answerPRDQuestions(prdContent, questions, config, contextInfo, streamingOptions, retryConfig);
+    }
+    async generatePRD(description, config, promptOverride, userMessage, streamingOptions, retryConfig) {
+        return this.prdOps.generatePRD(description, config, promptOverride, userMessage, streamingOptions, retryConfig);
+    }
+    async combinePRDs(prds, originalDescription, config, promptOverride, userMessage, streamingOptions, retryConfig) {
+        return this.prdOps.combinePRDs(prds, originalDescription, config, promptOverride, userMessage, streamingOptions, retryConfig);
+    }
+    // Documentation Operations - Delegated to DocumentationOperations
+    async enhanceTaskWithDocumentation(taskId, taskTitle, taskDescription, stackInfo, streamingOptions, retryConfig, config, existingResearch) {
+        return this.docOps.enhanceTaskWithDocumentation(taskId, taskTitle, taskDescription, stackInfo, streamingOptions, retryConfig, config, existingResearch);
+    }
+    async analyzeDocumentationNeeds(taskId, taskTitle, taskDescription, stackInfo, streamingOptions, retryConfig, config, existingResearch) {
+        return this.docOps.analyzeDocumentationNeeds(taskId, taskTitle, taskDescription, stackInfo, streamingOptions, retryConfig, config, existingResearch);
+    }
+    async generateDocumentationRecap(libraries, documentContents, streamingOptions, retryConfig) {
+        return this.docOps.generateDocumentationRecap(libraries, documentContents, streamingOptions, retryConfig);
+    }
+    async planTask(taskContext, taskDetails, config, promptOverride, userMessage, streamingOptions, retryConfig) {
+        return this.taskOps.planTask(taskContext, taskDetails, config, promptOverride, userMessage, streamingOptions, retryConfig);
+    }
+    // Stack suggestion - Delegated to PRDOperations
+    async suggestStack(prdContent, projectName, config, promptOverride, userMessage, streamingOptions, retryConfig, workingDirectory, enableFilesystemTools) {
+        return this.prdOps.suggestStack(prdContent, projectName, config, promptOverride, userMessage, streamingOptions, retryConfig, workingDirectory, enableFilesystemTools);
+    }
+}
+exports.AIOperations = AIOperations;

package/dist/lib/ai-service/base-operations.d.ts

@@ -0,0 +1,43 @@
+import { AIConfig, StreamingOptions, RetryConfig } from "../../types";
+import { JSONParser } from "./json-parser";
+import { Context7Client } from "./mcp-client";
+import { RetryHandler } from "./retry-handler";
+import { ModelProvider } from "./model-provider";
+export declare class BaseOperations {
+    protected jsonParser: JSONParser;
+    protected context7Client: Context7Client;
+    protected retryHandler: RetryHandler;
+    protected modelProvider: ModelProvider;
+    /**
+     * Merges AI configuration with proper precedence.
+     *
+     * Configuration precedence (highest to lowest):
+     * 1. Method parameter `config` (operation-specific overrides)
+     * 2. ConfigManager global config (project-level settings)
+     * 3. Environment variables (OPENAI_API_KEY, etc.)
+     * 4. Provider defaults (defined in config.ts)
+     *
+     * @param config - Optional operation-specific config overrides
+     * @returns Merged AIConfig with all precedence levels applied
+     *
+     * @example
+     * ```typescript
+     * // Override just the model for this operation
+     * const finalConfig = this.mergeAIConfig({ model: "gpt-4o" });
+     *
+     * // Use default config (from ConfigManager + env vars)
+     * const finalConfig = this.mergeAIConfig();
+     * ```
+     */
+    protected mergeAIConfig(config?: Partial<AIConfig>): AIConfig;
+    /**
+     * Handles Context7 tool results by caching documentation.
+     * Extracts and saves documentation from get-library-docs tool results.
+     *
+     * @param chunk - The chunk to check for Context7 tool results
+     * @protected
+     */
+    protected handleContext7ToolResult(chunk: any): void;
+    streamText(prompt: string, config?: Partial<AIConfig>, systemPrompt?: string, userMessage?: string, streamingOptions?: StreamingOptions, retryConfig?: Partial<RetryConfig>): Promise<string>;
+}
+//# sourceMappingURL=base-operations.d.ts.map

package/dist/lib/ai-service/base-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-operations.d.ts","sourceRoot":"","sources":["../../../src/lib/ai-service/base-operations.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,qBAAa,cAAc;IACzB,SAAS,CAAC,UAAU,aAAoB;IACxC,SAAS,CAAC,cAAc,iBAAwB;IAChD,SAAS,CAAC,YAAY,eAAsB;IAC5C,SAAS,CAAC,aAAa,gBAAuB;IAE9C;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,SAAS,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ;IAQ7D;;;;;;OAMG;IACH,SAAS,CAAC,wBAAwB,CAAC,KAAK,EAAE,GAAG,GAAG,IAAI;IAkB9C,UAAU,CACd,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,EAC1B,YAAY,CAAC,EAAE,MAAM,EACrB,WAAW,CAAC,EAAE,MAAM,EACpB,gBAAgB,CAAC,EAAE,gBAAgB,EACnC,WAAW,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GACjC,OAAO,CAAC,MAAM,CAAC;CAgEnB"}

package/dist/lib/ai-service/base-operations.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseOperations = void 0;
+const ai_1 = require("ai");
+const json_parser_1 = require("./json-parser");
+const mcp_client_1 = require("./mcp-client");
+const retry_handler_1 = require("./retry-handler");
+const model_provider_1 = require("./model-provider");
+class BaseOperations {
+    jsonParser = new json_parser_1.JSONParser();
+    context7Client = new mcp_client_1.Context7Client();
+    retryHandler = new retry_handler_1.RetryHandler();
+    modelProvider = new model_provider_1.ModelProvider();
+    /**
+     * Merges AI configuration with proper precedence.
+     *
+     * Configuration precedence (highest to lowest):
+     * 1. Method parameter `config` (operation-specific overrides)
+     * 2. ConfigManager global config (project-level settings)
+     * 3. Environment variables (OPENAI_API_KEY, etc.)
+     * 4. Provider defaults (defined in config.ts)
+     *
+     * @param config - Optional operation-specific config overrides
+     * @returns Merged AIConfig with all precedence levels applied
+     *
+     * @example
+     * ```typescript
+     * // Override just the model for this operation
+     * const finalConfig = this.mergeAIConfig({ model: "gpt-4o" });
+     *
+     * // Use default config (from ConfigManager + env vars)
+     * const finalConfig = this.mergeAIConfig();
+     * ```
+     */
+    mergeAIConfig(config) {
+        // Get base config (includes ConfigManager + env vars + defaults)
+        const baseConfig = this.modelProvider.getAIConfig();
+        // Apply operation-specific overrides (highest priority)
+        return { ...baseConfig, ...config };
+    }
+    /**
+     * Handles Context7 tool results by caching documentation.
+     * Extracts and saves documentation from get-library-docs tool results.
+     *
+     * @param chunk - The chunk to check for Context7 tool results
+     * @protected
+     */
+    handleContext7ToolResult(chunk) {
+        if (chunk.type === "tool-result" && chunk.toolName === "get-library-docs") {
+            const docs = chunk.output;
+            const libraryID = chunk.input?.context7CompatibleLibraryID || "unknown";
+            const topic = chunk.input?.topic || "general";
+            if (docs && typeof docs === "object" && "content" in docs) {
+                this.context7Client.saveContext7Documentation(libraryID, docs.content, topic);
+            }
+            else if (docs && typeof docs === "string") {
+                this.context7Client.saveContext7Documentation(libraryID, docs, topic);
+            }
+        }
+    }
+    async streamText(prompt, config, systemPrompt, userMessage, streamingOptions, retryConfig) {
+        // Merge config with proper precedence (Bug fix 2.9)
+        const aiConfig = this.mergeAIConfig(config);
+        return this.retryHandler.executeWithRetry(async () => {
+            const model = this.modelProvider.getModel(aiConfig);
+            const result = (0, ai_1.streamText)({
+                model,
+                system: systemPrompt,
+                messages: [{ role: "user", content: userMessage || prompt }],
+                maxRetries: 0,
+                onError: ({ error }) => {
+                    streamingOptions?.onError?.(error);
+                    throw error;
+                },
+                onChunk: streamingOptions?.onChunk
+                    ? ({ chunk }) => {
+                        if (chunk.type === "text-delta") {
+                            streamingOptions.onChunk(chunk.text);
+                        }
+                        else if (chunk.type === "reasoning-delta") {
+                            streamingOptions.onReasoning?.(chunk.text);
+                        }
+                        // Handle Context7 tool result caching
+                        this.handleContext7ToolResult(chunk);
+                    }
+                    : undefined,
+                onFinish: streamingOptions?.onFinish
+                    ? ({ text, finishReason, usage }) => {
+                        streamingOptions.onFinish({
+                            text,
+                            finishReason,
+                            usage,
+                            isAborted: false,
+                        });
+                    }
+                    : undefined,
+                ...(aiConfig.provider === "openrouter" &&
+                    aiConfig.reasoning &&
+                    aiConfig.reasoning.maxTokens
+                    ? {
+                        providerOptions: {
+                            openrouter: {
+                                reasoning: {
+                                    max_tokens: aiConfig.reasoning.maxTokens,
+                                },
+                            },
+                        },
+                    }
+                    : {}),
+            });
+            let fullText = "";
+            for await (const textPart of result.textStream) {
+                fullText += textPart;
+            }
+            return fullText;
+        }, retryConfig, "AI streaming");
+    }
+}
+exports.BaseOperations = BaseOperations;

package/dist/lib/ai-service/documentation-operations.d.ts

@@ -0,0 +1,18 @@
+import { AIConfig, DocumentationDetection, StreamingOptions, RetryConfig, TaskDocumentation } from "../../types";
+import { BaseOperations } from "./base-operations";
+export declare class DocumentationOperations extends BaseOperations {
+    enhanceTaskWithDocumentation(taskId: string, taskTitle: string, taskDescription: string, stackInfo?: string, streamingOptions?: StreamingOptions, retryConfig?: Partial<RetryConfig>, config?: Partial<AIConfig>, existingResearch?: Record<string, Array<{
+        query: string;
+        doc: string;
+    }>>, enableFilesystemTools?: boolean): Promise<string>;
+    analyzeDocumentationNeeds(taskId: string, taskTitle: string, taskDescription: string, stackInfo?: string, streamingOptions?: StreamingOptions, retryConfig?: Partial<RetryConfig>, config?: Partial<AIConfig>, existingResearch?: (TaskDocumentation | undefined)[], enableFilesystemTools?: boolean): Promise<DocumentationDetection>;
+    generateDocumentationRecap(libraries: Array<{
+        name: string;
+        context7Id: string;
+        reason: string;
+    }>, documentContents: Array<{
+        library: string;
+        content: string;
+    }>, streamingOptions?: StreamingOptions, retryConfig?: Partial<RetryConfig>): Promise<string>;
+}
+//# sourceMappingURL=documentation-operations.d.ts.map

package/dist/lib/ai-service/documentation-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentation-operations.d.ts","sourceRoot":"","sources":["../../../src/lib/ai-service/documentation-operations.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,QAAQ,EACR,sBAAsB,EACtB,gBAAgB,EAChB,WAAW,EACX,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAKrB,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGnD,qBAAa,uBAAwB,SAAQ,cAAc;IACnD,4BAA4B,CAChC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,SAAS,CAAC,EAAE,MAAM,EAClB,gBAAgB,CAAC,EAAE,gBAAgB,EACnC,WAAW,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,EAClC,MAAM,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,EAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,EACxE,qBAAqB,CAAC,EAAE,OAAO,GAC9B,OAAO,CAAC,MAAM,CAAC;IA2JZ,yBAAyB,CAC7B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,SAAS,CAAC,EAAE,MAAM,EAClB,gBAAgB,CAAC,EAAE,gBAAgB,EACnC,WAAW,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,EAClC,MAAM,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,EAC1B,gBAAgB,CAAC,EAAE,CAAC,iBAAiB,GAAG,SAAS,CAAC,EAAE,EACpD,qBAAqB,CAAC,EAAE,OAAO,GAC9B,OAAO,CAAC,sBAAsB,CAAC;IAkM5B,0BAA0B,CAC9B,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,EACtE,gBAAgB,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,EAC7D,gBAAgB,CAAC,EAAE,gBAAgB,EACnC,WAAW,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GACjC,OAAO,CAAC,MAAM,CAAC;CA8CnB"}