@powerhousedao/reactor 4.1.0-dev.12 → 4.1.0-dev.121

package/dist/src/executor/interfaces.d.ts

@@ -1,72 +1,49 @@
-import { Job } from "../queue/types.js";
-import { JobExecutorConfig, JobResult } from "./types.js";
+import type { Job } from "../queue/types.js";
+import type { ExecutorManagerStatus, JobResult } from "./types.js";
 /**
- * Interface for executing jobs from the queue.
- * Listens for 'jobAvailable' events from the event bus and pulls jobs from IQueue when capacity allows.
+ * Simple interface for executing a job.
+ * A JobExecutor simply takes a job and executes it - nothing more.
  */
 export interface IJobExecutor {
     /**
-     * Start the job executor.
-     * Begins listening for 'jobAvailable' events from the event bus and executing jobs when capacity allows.
-     *
-     * @param config - Configuration options for the executor
-     * @returns Promise that resolves when the executor is started
-     */
-    start(config?: JobExecutorConfig): Promise<void>;
-    /**
-     * Stop the job executor.
-     * Gracefully stops listening for events and waits for current jobs to complete.
-     * @param graceful - Whether to wait for current jobs to complete
-     * @returns Promise that resolves when the executor is stopped
-     */
-    stop(graceful?: boolean): Promise<void>;
-    /**
-     * Execute a single job immediately.
+     * Execute a single job.
      * @param job - The job to execute
      * @returns Promise that resolves to the job result
      */
     executeJob(job: Job): Promise<JobResult>;
+}
+/**
+ * Interface for managing multiple job executors.
+ * Listens for 'jobAvailable' events from the event bus, pulls jobs from the queue,
+ * and coordinates the distribution of jobs across multiple executor instances.
+ */
+export interface IJobExecutorManager {
     /**
-     * Get the current status of the job executor.
-     * @returns Promise that resolves to the executor status
-     */
-    getStatus(): Promise<{
-        isRunning: boolean;
-        activeJobs: number;
-        totalJobsProcessed: number;
-        totalJobsSucceeded: number;
-        totalJobsFailed: number;
-        lastJobCompletedAt?: string;
-        uptime?: number;
-    }>;
-    /**
-     * Get statistics about job execution performance.
-     * @returns Promise that resolves to execution statistics
+     * Start the executor manager.
+     * Begins listening for 'jobAvailable' events and dispatching to executors.
+     *
+     * @param numExecutors - Number of executor instances to create
+     * @returns Promise that resolves when the manager is started
      */
-    getStats(): Promise<{
-        averageExecutionTime: number;
-        successRate: number;
-        jobsPerSecond: number;
-        queueBacklog: number;
-    }>;
+    start(numExecutors: number): Promise<void>;
     /**
-     * Pause job execution.
-     * Stops processing new jobs but keeps the executor running.
-     * @returns Promise that resolves when execution is paused
+     * Stop the executor manager.
+     *
+     * @param graceful - Whether to wait for current jobs to complete
+     * @returns Promise that resolves when the manager is stopped
      */
-    pause(): Promise<void>;
+    stop(graceful?: boolean): Promise<void>;
     /**
-     * Resume job execution.
-     * Resumes processing jobs from the queue.
-     * @returns Promise that resolves when execution is resumed
+     * Get all managed executor instances.
+     *
+     * @returns Array of executor instances
      */
-    resume(): Promise<void>;
+    getExecutors(): IJobExecutor[];
     /**
-     * Subscribe to job execution events.
-     * @param event - The event type to subscribe to
-     * @param handler - The event handler function
-     * @returns Function to unsubscribe from the event
+     * Get the current status of the manager.
+     *
+     * @returns The current manager status
      */
-    on(event: "jobStarted" | "jobCompleted" | "jobFailed" | "executorStarted" | "executorStopped", handler: (data: any) => void): () => void;
+    getStatus(): ExecutorManagerStatus;
 }
 //# sourceMappingURL=interfaces.d.ts.map

package/dist/src/executor/interfaces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../../src/executor/interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE1D;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;OAMG;IACH,KAAK,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjD;;;;;OAKG;IACH,IAAI,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC;;;;OAIG;IACH,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAEzC;;;OAGG;IACH,SAAS,IAAI,OAAO,CAAC;QACnB,SAAS,EAAE,OAAO,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,kBAAkB,EAAE,MAAM,CAAC;QAC3B,eAAe,EAAE,MAAM,CAAC;QACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IAEH;;;OAGG;IACH,QAAQ,IAAI,OAAO,CAAC;QAClB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IAEH;;;;OAIG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;;;OAIG;IACH,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAExB;;;;;OAKG;IACH,EAAE,CACA,KAAK,EACD,YAAY,GACZ,cAAc,GACd,WAAW,GACX,iBAAiB,GACjB,iBAAiB,EACrB,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,GAC3B,MAAM,IAAI,CAAC;CACf"}
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../../src/executor/interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,KAAK,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEnE;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;CAC1C;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;OAMG;IACH,KAAK,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3C;;;;;OAKG;IACH,IAAI,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC;;;;OAIG;IACH,YAAY,IAAI,YAAY,EAAE,CAAC;IAE/B;;;;OAIG;IACH,SAAS,IAAI,qBAAqB,CAAC;CACpC"}

package/dist/src/executor/simple-job-executor-manager.d.ts

@@ -0,0 +1,32 @@
+import type { IEventBus } from "../events/interfaces.js";
+import type { IJobTracker } from "../job-tracker/interfaces.js";
+import type { IQueue } from "../queue/interfaces.js";
+import type { IJobExecutor, IJobExecutorManager } from "./interfaces.js";
+import type { ExecutorManagerStatus } from "./types.js";
+export type JobExecutorFactory = () => IJobExecutor;
+/**
+ * Manages multiple job executors and coordinates job distribution.
+ * Listens for job available events and dispatches jobs to executors.
+ */
+export declare class SimpleJobExecutorManager implements IJobExecutorManager {
+    private executorFactory;
+    private eventBus;
+    private queue;
+    private jobTracker;
+    private executors;
+    private isRunning;
+    private activeJobs;
+    private totalJobsProcessed;
+    private unsubscribe?;
+    constructor(executorFactory: JobExecutorFactory, eventBus: IEventBus, queue: IQueue, jobTracker: IJobTracker);
+    start(numExecutors: number): Promise<void>;
+    stop(graceful?: boolean): Promise<void>;
+    getExecutors(): IJobExecutor[];
+    getStatus(): ExecutorManagerStatus;
+    private processNextJob;
+    private checkForMoreJobs;
+    private processExistingJobs;
+    private toErrorInfo;
+    private formatErrorHistory;
+}
+//# sourceMappingURL=simple-job-executor-manager.d.ts.map

package/dist/src/executor/simple-job-executor-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple-job-executor-manager.d.ts","sourceRoot":"","sources":["../../../src/executor/simple-job-executor-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAIrD,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,KAAK,EAAE,qBAAqB,EAAa,MAAM,YAAY,CAAC;AAGnE,MAAM,MAAM,kBAAkB,GAAG,MAAM,YAAY,CAAC;AAEpD;;;GAGG;AACH,qBAAa,wBAAyB,YAAW,mBAAmB;IAQhE,OAAO,CAAC,eAAe;IACvB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,UAAU;IAVpB,OAAO,CAAC,SAAS,CAAsB;IACvC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,WAAW,CAAC,CAAa;gBAGvB,eAAe,EAAE,kBAAkB,EACnC,QAAQ,EAAE,SAAS,EACnB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,WAAW;IAG3B,KAAK,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgC1C,IAAI,CAAC,QAAQ,UAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB1C,YAAY,IAAI,YAAY,EAAE;IAI9B,SAAS,IAAI,qBAAqB;YASpB,cAAc;YAiGd,gBAAgB;YAkBhB,mBAAmB;IAwBjC,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,kBAAkB;CAwB3B"}

package/dist/src/executor/simple-job-executor-manager.js

@@ -0,0 +1,214 @@
+import { QueueEventTypes } from "../queue/types.js";
+import { createConsistencyToken } from "./util.js";
+/**
+ * Manages multiple job executors and coordinates job distribution.
+ * Listens for job available events and dispatches jobs to executors.
+ */
+export class SimpleJobExecutorManager {
+    executorFactory;
+    eventBus;
+    queue;
+    jobTracker;
+    executors = [];
+    isRunning = false;
+    activeJobs = 0;
+    totalJobsProcessed = 0;
+    unsubscribe;
+    constructor(executorFactory, eventBus, queue, jobTracker) {
+        this.executorFactory = executorFactory;
+        this.eventBus = eventBus;
+        this.queue = queue;
+        this.jobTracker = jobTracker;
+    }
+    async start(numExecutors) {
+        if (this.isRunning) {
+            throw new Error("JobExecutorManager is already running");
+        }
+        if (numExecutors < 1) {
+            throw new Error("Number of executors must be at least 1");
+        }
+        // Create executors
+        this.executors = [];
+        for (let i = 0; i < numExecutors; i++) {
+            this.executors.push(this.executorFactory());
+        }
+        // Start listening for job available events
+        this.unsubscribe = this.eventBus.subscribe(QueueEventTypes.JOB_AVAILABLE, async () => {
+            // Only process if we have capacity (simple round-robin for now)
+            if (this.activeJobs < this.executors.length) {
+                await this.processNextJob();
+            }
+        });
+        this.isRunning = true;
+        // Process any existing jobs in the queue
+        await this.processExistingJobs();
+    }
+    async stop(graceful = true) {
+        if (!this.isRunning) {
+            return;
+        }
+        // Stop listening for new jobs
+        if (this.unsubscribe) {
+            this.unsubscribe();
+            this.unsubscribe = undefined;
+        }
+        if (graceful) {
+            // Wait for active jobs to complete
+            while (this.activeJobs > 0) {
+                await new Promise((resolve) => setTimeout(resolve, 100));
+            }
+        }
+        this.executors = [];
+        this.isRunning = false;
+    }
+    getExecutors() {
+        return [...this.executors];
+    }
+    getStatus() {
+        return {
+            isRunning: this.isRunning,
+            numExecutors: this.executors.length,
+            activeJobs: this.activeJobs,
+            totalJobsProcessed: this.totalJobsProcessed,
+        };
+    }
+    async processNextJob() {
+        // dequeue next available job
+        let handle;
+        try {
+            handle = await this.queue.dequeueNext();
+        }
+        catch (error) {
+            console.error("Error dequeueing job:", error);
+            return;
+        }
+        if (!handle) {
+            return;
+        }
+        // start the job execution
+        handle.start();
+        this.activeJobs++;
+        this.jobTracker.markRunning(handle.job.id);
+        // Find an available executor (simple round-robin)
+        const executorIndex = this.totalJobsProcessed % this.executors.length;
+        const executor = this.executors[executorIndex];
+        // execute the job
+        let result;
+        try {
+            result = await executor.executeJob(handle.job);
+        }
+        catch (error) {
+            const errorInfo = this.toErrorInfo(error instanceof Error ? error : String(error));
+            console.error(`Error executing job ${handle.job.id}:`, errorInfo.message);
+            handle.fail(errorInfo);
+            this.activeJobs--;
+            this.jobTracker.markFailed(handle.job.id, errorInfo);
+            await this.checkForMoreJobs();
+            return;
+        }
+        // handle the result
+        if (result.success) {
+            handle.complete();
+            this.totalJobsProcessed++;
+            const consistencyToken = createConsistencyToken(result.operationsWithContext || []);
+            this.jobTracker.markCompleted(handle.job.id, consistencyToken, result.operations);
+        }
+        else {
+            // Handle retry logic
+            const retryCount = handle.job.retryCount || 0;
+            const maxRetries = handle.job.maxRetries || 0;
+            if (retryCount < maxRetries) {
+                const currentErrorInfo = result.error
+                    ? this.toErrorInfo(result.error)
+                    : this.toErrorInfo("Unknown error");
+                try {
+                    await this.queue.retryJob(handle.job.id, currentErrorInfo);
+                }
+                catch (error) {
+                    const retryErrorInfo = this.toErrorInfo(error instanceof Error ? error : "Failed to retry job");
+                    console.error(`Failed to retry job ${handle.job.id}:`, retryErrorInfo.message);
+                    this.jobTracker.markFailed(handle.job.id, retryErrorInfo);
+                    handle.fail(retryErrorInfo);
+                }
+            }
+            else {
+                const currentErrorInfo = result.error
+                    ? this.toErrorInfo(result.error)
+                    : this.toErrorInfo("Unknown error");
+                const fullErrorInfo = this.formatErrorHistory(handle.job.errorHistory, currentErrorInfo, retryCount + 1);
+                this.jobTracker.markFailed(handle.job.id, fullErrorInfo);
+                handle.fail(fullErrorInfo);
+            }
+        }
+        this.activeJobs--;
+        await this.checkForMoreJobs();
+    }
+    async checkForMoreJobs() {
+        if (!this.isRunning) {
+            return;
+        }
+        let hasMore;
+        try {
+            hasMore = await this.queue.hasJobs();
+        }
+        catch (error) {
+            console.error("Error checking for more jobs:", error);
+            return;
+        }
+        if (hasMore) {
+            await this.processNextJob();
+        }
+    }
+    async processExistingJobs() {
+        let hasJobs;
+        try {
+            hasJobs = await this.queue.hasJobs();
+        }
+        catch (error) {
+            console.error("Error checking for existing jobs:", error);
+            return;
+        }
+        if (hasJobs) {
+            // Start processing up to the number of executors
+            const promises = [];
+            for (let i = 0; i < Math.min(this.executors.length, 5); i++) {
+                promises.push(this.processNextJob());
+            }
+            try {
+                await Promise.all(promises);
+            }
+            catch (error) {
+                console.error("Error processing existing jobs:", error);
+            }
+        }
+    }
+    toErrorInfo(error) {
+        if (error instanceof Error) {
+            return {
+                message: error.message,
+                stack: error.stack || new Error().stack || "",
+            };
+        }
+        return {
+            message: error,
+            stack: new Error().stack || "",
+        };
+    }
+    formatErrorHistory(errorHistory, currentError, totalAttempts) {
+        const allErrors = [...errorHistory, currentError];
+        if (allErrors.length === 1) {
+            return currentError;
+        }
+        const messageLines = [`Job failed after ${totalAttempts} attempts:`];
+        const stackLines = [];
+        allErrors.forEach((error, index) => {
+            messageLines.push(`[Attempt ${index + 1}] ${error.message}`);
+            stackLines.push(`[Attempt ${index + 1}] Stack trace:\n${error.stack}`);
+        });
+        return {
+            message: messageLines.join("\n"),
+            stack: stackLines.join("\n\n"),
+        };
+    }
+}
+//# sourceMappingURL=simple-job-executor-manager.js.map

package/dist/src/executor/simple-job-executor-manager.js.map

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

package/dist/src/executor/simple-job-executor.d.ts

@@ -0,0 +1,62 @@
+import type { IDocumentOperationStorage, IDocumentStorage } from "document-drive";
+import type { IOperationIndex } from "../cache/operation-index-types.js";
+import type { IWriteCache } from "../cache/write/interfaces.js";
+import type { IEventBus } from "../events/interfaces.js";
+import type { Job } from "../queue/types.js";
+import type { IDocumentModelRegistry } from "../registry/interfaces.js";
+import type { IOperationStore } from "../storage/interfaces.js";
+import type { IJobExecutor } from "./interfaces.js";
+import type { JobExecutorConfig, JobResult } from "./types.js";
+/**
+ * Simple job executor that processes a job by applying actions through document model reducers.
+ *
+ * @see docs/planning/Storage/IOperationStore.md for storage schema
+ * @see docs/planning/Operations/index.md for operation structure
+ * @see docs/planning/Jobs/reshuffle.md for skip mechanism details
+ */
+export declare class SimpleJobExecutor implements IJobExecutor {
+    private registry;
+    private documentStorage;
+    private operationStorage;
+    private operationStore;
+    private eventBus;
+    private writeCache;
+    private operationIndex;
+    private config;
+    constructor(registry: IDocumentModelRegistry, documentStorage: IDocumentStorage, operationStorage: IDocumentOperationStorage, operationStore: IOperationStore, eventBus: IEventBus, writeCache: IWriteCache, operationIndex: IOperationIndex, config: JobExecutorConfig);
+    /**
+     * Execute a single job by applying all its actions through the appropriate reducers.
+     * Actions are processed sequentially in order.
+     */
+    executeJob(job: Job): Promise<JobResult>;
+    private processActions;
+    /**
+     * Execute a CREATE_DOCUMENT system action.
+     * This creates a new document in storage along with its initial operation.
+     * For a new document, the operation index is always 0.
+     */
+    private executeCreateDocumentAction;
+    /**
+     * Execute a DELETE_DOCUMENT system action.
+     * This deletes a document from legacy storage and writes the operation to IOperationStore.
+     * The operation index is determined from the document's current operation count.
+     */
+    private executeDeleteDocumentAction;
+    /**
+     * Execute an UPGRADE_DOCUMENT system action.
+     * This sets the document's initial state from the upgrade action.
+     * The operation index is determined from the document's current operation count.
+     */
+    private executeUpgradeDocumentAction;
+    private executeAddRelationshipAction;
+    private executeRemoveRelationshipAction;
+    private createOperation;
+    private executeLoadJob;
+    private writeOperationToStore;
+    private updateDocumentRevision;
+    private writeCacheState;
+    private buildSuccessResult;
+    private buildErrorResult;
+    private accumulateResultOrReturnError;
+}
+//# sourceMappingURL=simple-job-executor.d.ts.map

package/dist/src/executor/simple-job-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple-job-executor.d.ts","sourceRoot":"","sources":["../../../src/executor/simple-job-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EACzB,gBAAgB,EACjB,MAAM,gBAAgB,CAAC;AAYxB,OAAO,KAAK,EACV,eAAe,EAEhB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAExE,OAAO,KAAK,EACV,eAAe,EAEhB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAU/D;;;;;;GAMG;AACH,qBAAa,iBAAkB,YAAW,YAAY;IAIlD,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,eAAe;IACvB,OAAO,CAAC,gBAAgB;IACxB,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,cAAc;IATxB,OAAO,CAAC,MAAM,CAA8B;gBAGlC,QAAQ,EAAE,sBAAsB,EAChC,eAAe,EAAE,gBAAgB,EACjC,gBAAgB,EAAE,yBAAyB,EAC3C,cAAc,EAAE,eAAe,EAC/B,QAAQ,EAAE,SAAS,EACnB,UAAU,EAAE,WAAW,EACvB,cAAc,EAAE,eAAe,EACvC,MAAM,EAAE,iBAAiB;IAW3B;;;OAGG;IACG,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC;YAiDhC,cAAc;IAiS5B;;;;OAIG;YACW,2BAA2B;IAgIzC;;;;OAIG;YACW,2BAA2B;IAuHzC;;;;OAIG;YACW,4BAA4B;YAoI5B,4BAA4B;YAoK5B,+BAA+B;IA8H7C,OAAO,CAAC,eAAe;YAcT,cAAc;YAqGd,qBAAqB;IAiCnC,OAAO,CAAC,sBAAsB;IAW9B,OAAO,CAAC,eAAe;IAgBvB,OAAO,CAAC,kBAAkB;IA4B1B,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,6BAA6B;CAgBtC"}