couchloop-eq-mcp 1.0.0

package/dist/tools/sendMessage.js

@@ -0,0 +1,278 @@
+import { z } from 'zod';
+import { eq, desc } from 'drizzle-orm';
+import { getDb } from '../db/client.js';
+import { getShrinkChatClient } from '../clients/shrinkChatClient.js';
+import { sessions, checkpoints, journeys } from '../db/schema.js';
+import { logger } from '../utils/logger.js';
+import { NotFoundError } from '../utils/errors.js';
+import { errorHandler, ErrorType } from '../utils/errorHandler.js';
+import { v4 as uuidv4 } from 'uuid';
+// Input validation schema
+const SendMessageSchema = z.object({
+    session_id: z.string().uuid({
+        message: 'Invalid session ID format',
+    }),
+    message: z.string().min(1, 'Message cannot be empty'),
+    save_checkpoint: z.boolean().default(false),
+    checkpoint_key: z.string().optional(),
+    advance_step: z.boolean().default(false),
+    include_memory: z.boolean().default(true),
+    system_prompt: z.string().optional(),
+    conversation_type: z.string().optional(),
+});
+// type SendMessageInput = z.infer<typeof SendMessageSchema>; // Removed - unused type
+/**
+ * Send a message through the shrink-chat therapeutic stack
+ * This is the primary integration point with the shrink-chat backend
+ */
+export async function sendMessage(args) {
+    let threadId; // Declare at function level for error handler access
+    try {
+        // Validate input
+        const input = SendMessageSchema.parse(args);
+        logger.info(`Sending message for session ${input.session_id}`);
+        const db = getDb();
+        const client = getShrinkChatClient();
+        // 1. Get session and verify it exists
+        const [session] = await db
+            .select()
+            .from(sessions)
+            .where(eq(sessions.id, input.session_id))
+            .limit(1);
+        if (!session) {
+            throw new NotFoundError(`Session ${input.session_id} not found`);
+        }
+        // 2. Get or generate thread ID
+        // Threads in shrink-chat are created lazily on first message
+        threadId = session.threadId || undefined;
+        if (!threadId) {
+            // Generate a new thread ID for this session
+            threadId = uuidv4();
+            logger.info(`Generated new thread ID ${threadId} for session ${input.session_id}`);
+            // Update session with thread ID
+            await db.update(sessions)
+                .set({ threadId })
+                .where(eq(sessions.id, input.session_id));
+        }
+        // Get journey if exists
+        let journey = null;
+        if (session.journeyId) {
+            const [journeyRecord] = await db
+                .select()
+                .from(journeys)
+                .where(eq(journeys.id, session.journeyId))
+                .limit(1);
+            journey = journeyRecord;
+        }
+        // 3. Prepare context for shrink-chat
+        const memoryContext = input.include_memory && session.metadata
+            ? JSON.stringify(session.metadata)
+            : '';
+        const enhancedContext = {
+            sessionId: session.id,
+            journeyId: session.journeyId,
+            journeySlug: journey?.slug,
+            currentStep: session.currentStep,
+            sessionStatus: session.status,
+        };
+        // 4. Get conversation history if available
+        const recentCheckpoints = await db
+            .select()
+            .from(checkpoints)
+            .where(eq(checkpoints.sessionId, session.id))
+            .orderBy(desc(checkpoints.createdAt))
+            .limit(5);
+        const history = recentCheckpoints
+            .reverse()
+            .filter(cp => cp.value && typeof cp.value === 'object' && 'message' in cp.value && 'response' in cp.value)
+            .flatMap(cp => {
+            const val = cp.value;
+            return [
+                { role: 'user', content: val.message },
+                { role: 'assistant', content: val.response },
+            ];
+        })
+            .slice(-10); // Last 10 messages (5 exchanges)
+        // 5. Send message through shrink-chat
+        const response = await client.sendMessage(threadId, input.message, // This is 'prompt' in the API
+        {
+            memoryContext,
+            enhancedContext,
+            history,
+            systemPrompt: input.system_prompt,
+            conversationType: input.conversation_type,
+            idempotencyKey: uuidv4(),
+        });
+        // 6. Handle crisis detection if present
+        let crisisHandled = false;
+        if (response.crisisLevel && Number(response.crisisLevel) > 7) {
+            logger.warn(`Crisis detected: Level ${response.crisisLevel} for session ${session.id}`);
+            crisisHandled = await handleCrisisDetection(session.id, threadId, response);
+        }
+        // 7. Save checkpoint if requested
+        if (input.save_checkpoint) {
+            const checkpointKey = input.checkpoint_key || 'message_response';
+            await db.insert(checkpoints).values({
+                sessionId: session.id,
+                stepId: session.currentStep.toString(),
+                key: checkpointKey,
+                value: {
+                    message: input.message,
+                    response: response.content,
+                    messageId: response.messageId,
+                    crisisLevel: response.crisisLevel,
+                    emotions: response.emotions,
+                    therapeuticTechnique: response.therapeuticTechnique,
+                    timestamp: new Date().toISOString(),
+                },
+            });
+            logger.debug(`Saved checkpoint '${checkpointKey}' for session ${session.id}`);
+        }
+        // 8. Advance step if requested (for journey progression)
+        if (input.advance_step && session.journeyId) {
+            const newStep = session.currentStep + 1;
+            await db.update(sessions)
+                .set({
+                currentStep: newStep,
+                updatedAt: new Date(),
+            })
+                .where(eq(sessions.id, input.session_id));
+            logger.info(`Advanced session ${session.id} to step ${newStep}`);
+        }
+        // 9. Return formatted response
+        return {
+            success: true,
+            content: response.content || '',
+            messageId: response.messageId,
+            metadata: {
+                crisisDetected: response.crisisDetected || (response.crisisLevel && Number(response.crisisLevel) > 7),
+                crisisLevel: response.crisisLevel,
+                crisisHandled,
+                crisisConfidence: response.crisis_confidence, // Add crisis confidence
+                ragConfidence: response.meta?.rag_confidence, // Add RAG confidence if available
+                emotions: response.emotions,
+                therapeuticTechnique: response.therapeuticTechnique,
+                resources: response.resources,
+                sessionId: session.id,
+                threadId,
+                currentStep: input.advance_step ? session.currentStep + 1 : session.currentStep,
+            },
+            timestamp: new Date().toISOString(),
+        };
+    }
+    catch (error) {
+        logger.error('Error in sendMessage:', error);
+        // Parse input for error handling (may have failed validation)
+        let sessionId;
+        let messageLength;
+        try {
+            const parsedInput = SendMessageSchema.parse(args);
+            sessionId = parsedInput.session_id;
+            messageLength = parsedInput.message.length;
+        }
+        catch {
+            // Input validation failed, use defaults
+        }
+        // Handle error with our error handler
+        const errorContext = await errorHandler.handle(error, {
+            sessionId,
+            threadId,
+            messageLength,
+        });
+        // Check if we should fallback based on error type
+        if (errorContext.recoverable && process.env.FALLBACK_TO_LOCAL_PROCESSING === 'true') {
+            // Fallback for recoverable errors
+            if (errorContext.type === ErrorType.NETWORK ||
+                errorContext.type === ErrorType.TIMEOUT ||
+                errorContext.type === ErrorType.SERVER) {
+                logger.info('Falling back to local processing due to recoverable error');
+                return handleLocalFallback(args);
+            }
+        }
+        // Special handling for crisis errors
+        if (errorContext.type === ErrorType.CRISIS) {
+            return {
+                success: false,
+                error: errorContext.userMessage || errorContext.message,
+                metadata: {
+                    emergencyResources: errorContext.metadata?.emergencyResources,
+                    crisisDetected: true,
+                },
+                timestamp: new Date().toISOString(),
+            };
+        }
+        // Return error response with appropriate user message
+        return {
+            success: false,
+            error: errorContext.userMessage || errorContext.message,
+            errorType: errorContext.type,
+            recoverable: errorContext.recoverable,
+            timestamp: new Date().toISOString(),
+        };
+    }
+}
+/**
+ * Handle crisis detection and escalation
+ */
+async function handleCrisisDetection(sessionId, threadId, response) {
+    const db = getDb();
+    try {
+        // 1. Update session metadata with crisis flag
+        const [existingSession] = await db
+            .select()
+            .from(sessions)
+            .where(eq(sessions.id, sessionId))
+            .limit(1);
+        const updatedMetadata = {
+            ...(existingSession?.metadata || {}),
+            crisisDetected: true,
+            crisisLevel: response.crisisLevel,
+            crisisTimestamp: new Date().toISOString(),
+            lastCrisisThreadId: threadId,
+        };
+        await db.update(sessions)
+            .set({
+            metadata: updatedMetadata,
+            updatedAt: new Date(),
+        })
+            .where(eq(sessions.id, sessionId));
+        // 2. Save crisis checkpoint
+        await db.insert(checkpoints).values({
+            sessionId,
+            stepId: 'crisis',
+            key: 'crisis_detection',
+            value: {
+                level: response.crisisLevel,
+                resources: response.resources,
+                escalationPath: response.escalationPath,
+                threadId,
+                timestamp: new Date().toISOString(),
+            },
+        });
+        logger.info(`Crisis handled for session ${sessionId}, thread ${threadId}`);
+        return true;
+    }
+    catch (error) {
+        logger.error('Error handling crisis detection:', error);
+        return false;
+    }
+}
+/**
+ * Fallback to local processing when shrink-chat is unavailable
+ */
+async function handleLocalFallback(args) {
+    logger.warn('Falling back to local processing due to shrink-chat unavailability');
+    const input = SendMessageSchema.parse(args);
+    // Basic local response - this would be expanded with actual logic
+    return {
+        success: true,
+        content: "I understand you're trying to communicate. The therapeutic service is temporarily unavailable, but your message has been noted. Please try again shortly or contact support if this persists.",
+        messageId: uuidv4(),
+        metadata: {
+            fallbackMode: true,
+            sessionId: input.session_id,
+            timestamp: new Date().toISOString(),
+        },
+    };
+}
+//# sourceMappingURL=sendMessage.js.map

package/dist/tools/sendMessage.js.map

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

package/dist/tools/session.d.ts

@@ -0,0 +1,106 @@
+export declare function createSession(args: any): Promise<{
+    error: string;
+    details?: any;
+} | {
+    session_id: string;
+    journey: {
+        id: string;
+        name: string;
+        createdAt: Date;
+        updatedAt: Date;
+        slug: string;
+        description: string;
+        steps: {
+            id: string;
+            order: number;
+            type: "prompt" | "checkpoint" | "summary";
+            content: {
+                prompt?: string;
+                checkpoint_key?: string;
+                instructions?: string;
+            };
+            optional: boolean;
+        }[];
+        estimatedMinutes: number;
+        tags: string[];
+    } | null;
+    current_step: {
+        id: string;
+        order: number;
+        type: "prompt" | "checkpoint" | "summary";
+        content: {
+            prompt?: string;
+            checkpoint_key?: string;
+            instructions?: string;
+        };
+        optional: boolean;
+    } | null | undefined;
+    message: string;
+}>;
+export declare function resumeSession(args: any): Promise<{
+    error: string;
+    details?: any;
+} | {
+    message: string;
+    session: null;
+    journey?: undefined;
+    current_step?: undefined;
+    checkpoints?: undefined;
+} | {
+    session: {
+        id: string;
+        updatedAt: Date;
+        userId: string;
+        journeyId: string | null;
+        status: "active" | "paused" | "completed" | "abandoned";
+        currentStep: number;
+        startedAt: Date;
+        lastActiveAt: Date;
+        completedAt: Date | null;
+        metadata: unknown;
+        threadId: string | null;
+        lastSyncedAt: Date | null;
+    };
+    journey: {
+        id: string;
+        name: string;
+        createdAt: Date;
+        updatedAt: Date;
+        slug: string;
+        description: string;
+        steps: {
+            id: string;
+            order: number;
+            type: "prompt" | "checkpoint" | "summary";
+            content: {
+                prompt?: string;
+                checkpoint_key?: string;
+                instructions?: string;
+            };
+            optional: boolean;
+        }[];
+        estimatedMinutes: number;
+        tags: string[];
+    } | null | undefined;
+    current_step: {
+        id: string;
+        order: number;
+        type: "prompt" | "checkpoint" | "summary";
+        content: {
+            prompt?: string;
+            checkpoint_key?: string;
+            instructions?: string;
+        };
+        optional: boolean;
+    } | null | undefined;
+    checkpoints: {
+        id: string;
+        createdAt: Date;
+        sessionId: string;
+        stepId: string;
+        key: string;
+        value: unknown;
+    }[];
+    message: string;
+}>;
+//# sourceMappingURL=session.d.ts.map

package/dist/tools/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/tools/session.ts"],"names":[],"mappings":"AAQA,wBAAsB,aAAa,CAAC,IAAI,EAAE,GAAG;;;;;;;;;;;;;;;;;sBAsBhC,CAAC;8BACN,CAAC;4BACI,CAAC;;;;;;;;;;;;kBAFD,CAAC;0BACN,CAAC;wBACI,CAAC;;;;;GA+Cb;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAnDhC,CAAC;8BACN,CAAC;4BACI,CAAC;;;;;;;;;;;;kBAFD,CAAC;0BACN,CAAC;wBACI,CAAC;;;;;;;;;;;;;GAyJb"}

package/dist/tools/session.js

@@ -0,0 +1,161 @@
+import { getDb } from '../db/client.js';
+import { sessions, journeys, users, checkpoints } from '../db/schema.js';
+import { eq, desc, and } from 'drizzle-orm';
+import { CreateSessionSchema, ResumeSessionSchema } from '../types/session.js';
+import { extractUserFromContext } from '../types/auth.js';
+import { handleError, NotFoundError } from '../utils/errors.js';
+import { logger } from '../utils/logger.js';
+export async function createSession(args) {
+    try {
+        const input = CreateSessionSchema.parse(args);
+        const db = getDb();
+        // Extract user ID from auth context or generate anonymous user
+        const externalUserId = await extractUserFromContext(input.auth);
+        const userResult = await db
+            .insert(users)
+            .values({
+            externalId: externalUserId,
+            preferences: {},
+        })
+            .onConflictDoUpdate({
+            target: users.externalId,
+            set: { updatedAt: new Date() },
+        })
+            .returning();
+        const user = userResult[0];
+        // Look up journey if specified
+        let journey = null;
+        let currentStep = null;
+        if (input.journey_slug) {
+            const [foundJourney] = await db
+                .select()
+                .from(journeys)
+                .where(eq(journeys.slug, input.journey_slug))
+                .limit(1);
+            if (!foundJourney) {
+                throw new NotFoundError('Journey with slug', input.journey_slug);
+            }
+            journey = foundJourney;
+            // Get first step
+            if (journey.steps && journey.steps.length > 0) {
+                currentStep = journey.steps[0];
+            }
+        }
+        // Create new session
+        const sessionResult = await db
+            .insert(sessions)
+            .values({
+            userId: user.id,
+            journeyId: journey?.id || null,
+            status: 'active',
+            currentStep: 0,
+            metadata: { context: input.context },
+        })
+            .returning();
+        const session = sessionResult[0];
+        logger.info(`Created new session: ${session.id}`);
+        return {
+            session_id: session.id,
+            journey: journey,
+            current_step: currentStep,
+            message: journey
+                ? `Started ${journey.name}. ${currentStep?.content?.prompt || ''}`
+                : 'Started freeform session.',
+        };
+    }
+    catch (error) {
+        logger.error('Error creating session:', error);
+        return handleError(error);
+    }
+}
+export async function resumeSession(args) {
+    try {
+        const input = ResumeSessionSchema.parse(args);
+        const db = getDb();
+        // Extract user ID from auth context or generate anonymous user
+        const externalUserId = await extractUserFromContext(input.auth);
+        const [user] = await db
+            .select()
+            .from(users)
+            .where(eq(users.externalId, externalUserId))
+            .limit(1);
+        if (!user) {
+            // Create user if doesn't exist
+            const [newUser] = await db
+                .insert(users)
+                .values({
+                externalId: externalUserId,
+                preferences: {},
+            })
+                .returning();
+            if (!newUser) {
+                throw new NotFoundError('User');
+            }
+            return {
+                message: 'No previous sessions found for this user. Please create a new session.',
+                session: null,
+            };
+        }
+        // Find session to resume
+        let session;
+        if (input.session_id) {
+            [session] = await db
+                .select()
+                .from(sessions)
+                .where(and(eq(sessions.id, input.session_id), eq(sessions.userId, user.id)))
+                .limit(1);
+        }
+        else {
+            // Get most recent pausable session
+            [session] = await db
+                .select()
+                .from(sessions)
+                .where(and(eq(sessions.userId, user.id), eq(sessions.status, 'paused')))
+                .orderBy(desc(sessions.lastActiveAt))
+                .limit(1);
+        }
+        if (!session) {
+            throw new NotFoundError('Session to resume');
+        }
+        // Get journey if linked
+        let journey = null;
+        let currentStep = null;
+        if (session.journeyId) {
+            [journey] = await db
+                .select()
+                .from(journeys)
+                .where(eq(journeys.id, session.journeyId))
+                .limit(1);
+            if (journey && journey.steps && journey.steps[session.currentStep]) {
+                currentStep = journey.steps[session.currentStep];
+            }
+        }
+        // Get existing checkpoints
+        const existingCheckpoints = await db
+            .select()
+            .from(checkpoints)
+            .where(eq(checkpoints.sessionId, session.id))
+            .orderBy(checkpoints.createdAt);
+        // Update session status to active
+        await db
+            .update(sessions)
+            .set({
+            status: 'active',
+            lastActiveAt: new Date(),
+        })
+            .where(eq(sessions.id, session.id));
+        logger.info(`Resumed session: ${session.id}`);
+        return {
+            session: session,
+            journey: journey,
+            current_step: currentStep,
+            checkpoints: existingCheckpoints,
+            message: `Resumed session. ${currentStep?.content?.prompt || 'Continue where you left off.'}`,
+        };
+    }
+    catch (error) {
+        logger.error('Error resuming session:', error);
+        return handleError(error);
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/tools/session.js.map

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

package/dist/types/auth.d.ts

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+/**
+ * Authentication context that can be passed through MCP tool calls
+ * This allows the AI agent to provide user authentication info
+ */
+export declare const AuthContextSchema: z.ZodObject<{
+    /**
+     * OAuth access token or session identifier
+     * This will be validated against the OAuth tokens table
+     */
+    token: z.ZodOptional<z.ZodString>;
+    /**
+     * External user identifier (from OAuth provider)
+     * Used as a fallback if token validation fails
+     */
+    user_id: z.ZodOptional<z.ZodString>;
+    /**
+     * Client identifier (ChatGPT, Claude, etc.)
+     * Helps track which AI agent is making the request
+     */
+    client_id: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    user_id?: string | undefined;
+    client_id?: string | undefined;
+    token?: string | undefined;
+}, {
+    user_id?: string | undefined;
+    client_id?: string | undefined;
+    token?: string | undefined;
+}>;
+export type AuthContext = z.infer<typeof AuthContextSchema>;
+/**
+ * Extract user ID from authentication context
+ * Returns a mock user ID if no context is provided (backward compatibility)
+ */
+export declare function extractUserFromContext(authContext?: AuthContext): Promise<string>;
+//# sourceMappingURL=auth.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/types/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,iBAAiB;IAC5B;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;;;;;;;;;EAEH,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,WAAW,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBvF"}

package/dist/types/auth.js

@@ -0,0 +1,44 @@
+import { z } from 'zod';
+/**
+ * Authentication context that can be passed through MCP tool calls
+ * This allows the AI agent to provide user authentication info
+ */
+export const AuthContextSchema = z.object({
+    /**
+     * OAuth access token or session identifier
+     * This will be validated against the OAuth tokens table
+     */
+    token: z.string().optional().describe('OAuth access token or session identifier'),
+    /**
+     * External user identifier (from OAuth provider)
+     * Used as a fallback if token validation fails
+     */
+    user_id: z.string().optional().describe('External user identifier from OAuth provider'),
+    /**
+     * Client identifier (ChatGPT, Claude, etc.)
+     * Helps track which AI agent is making the request
+     */
+    client_id: z.string().optional().describe('Client application identifier'),
+});
+/**
+ * Extract user ID from authentication context
+ * Returns a mock user ID if no context is provided (backward compatibility)
+ */
+export async function extractUserFromContext(authContext) {
+    // If we have a user_id directly, use it
+    if (authContext?.user_id) {
+        return authContext.user_id;
+    }
+    // If we have a token, we could validate it here
+    // For now, we'll extract a user ID from the token if it's a JWT-like structure
+    if (authContext?.token) {
+        // TODO: Implement proper JWT validation and extraction
+        // For now, just use the token as a user identifier
+        return `oauth_${authContext.token.substring(0, 16)}`;
+    }
+    // Fallback to anonymous user with optional client tracking
+    const clientPrefix = authContext?.client_id ? `${authContext.client_id}_` : '';
+    const { nanoid } = await import('nanoid');
+    return `usr_${clientPrefix}${nanoid(8)}`;
+}
+//# sourceMappingURL=auth.js.map

package/dist/types/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/types/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC;;;OAGG;IACH,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;IAEjF;;;OAGG;IACH,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;IAEvF;;;OAGG;IACH,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;CAC3E,CAAC,CAAC;AAIH;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,WAAyB;IACpE,wCAAwC;IACxC,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC;QACzB,OAAO,WAAW,CAAC,OAAO,CAAC;IAC7B,CAAC;IAED,gDAAgD;IAChD,+EAA+E;IAC/E,IAAI,WAAW,EAAE,KAAK,EAAE,CAAC;QACvB,uDAAuD;QACvD,mDAAmD;QACnD,OAAO,SAAS,WAAW,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IACvD,CAAC;IAED,2DAA2D;IAC3D,MAAM,YAAY,GAAG,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/E,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC1C,OAAO,OAAO,YAAY,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;AAC3C,CAAC"}