hawkeye-mcp-server 1.0.0

package/build/tools/inspect-session.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Tool: hawkeye_inspect_session
+ * Gets detailed information about a session including all prompt cycles
+ */
+import { ToolServices } from './index.js';
+import { z } from 'zod';
+/**
+ * Input validation schema
+ */
+declare const InspectSessionInputSchema: z.ZodObject<{
+    session_uuid: z.ZodString;
+    project_uuid: z.ZodOptional<z.ZodString>;
+    organization_uuid: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    session_uuid: string;
+    project_uuid?: string | undefined;
+    organization_uuid?: string | undefined;
+}, {
+    session_uuid: string;
+    project_uuid?: string | undefined;
+    organization_uuid?: string | undefined;
+}>;
+export type InspectSessionInput = z.infer<typeof InspectSessionInputSchema>;
+/**
+ * Inspect session to get detailed information
+ */
+export declare function inspectSession(services: ToolServices, args: unknown): Promise<any>;
+export {};

package/build/tools/inspect-session.js

@@ -0,0 +1,51 @@
+/**
+ * Tool: hawkeye_inspect_session
+ * Gets detailed information about a session including all prompt cycles
+ */
+import { getConfig } from '../config/config.js';
+import { logger } from '../utils/logger.js';
+import { z } from 'zod';
+/**
+ * Input validation schema
+ */
+const InspectSessionInputSchema = z.object({
+    session_uuid: z.string(),
+    project_uuid: z.string().optional(),
+    organization_uuid: z.string().optional(),
+});
+/**
+ * Inspect session to get detailed information
+ */
+export async function inspectSession(services, args) {
+    const config = getConfig();
+    const input = InspectSessionInputSchema.parse(args);
+    logger.info('Inspecting session', { sessionUuid: input.session_uuid });
+    // Get project UUID (use default if not provided)
+    const projectUuid = input.project_uuid || (await services.projectService.getDefaultProject()).uuid;
+    const organizationUuid = input.organization_uuid || config.defaultOrganizationUuid;
+    // Inspect the session
+    const sessionDetails = await services.sessionService.inspectSession(input.session_uuid, projectUuid, organizationUuid);
+    logger.info('Session inspection complete');
+    // Format the response
+    const session_info = sessionDetails.session_info || {
+        session_uuid: sessionDetails.session_uuid || sessionDetails.uuid || input.session_uuid,
+        name: sessionDetails.name || '',
+        create_time: sessionDetails.create_time || sessionDetails.created_at || '',
+        last_update: sessionDetails.last_update || sessionDetails.updated_at || '',
+    };
+    const prompt_cycles = sessionDetails.prompt_cycle || [];
+    return {
+        session_info,
+        prompt_cycles: prompt_cycles.map((cycle) => ({
+            id: cycle.id,
+            status: cycle.status,
+            request: cycle.request,
+            final_answer: cycle.final_answer,
+            chain_of_thoughts: cycle.chain_of_thoughts || [],
+            sources: cycle.sources || [],
+            follow_up_suggestions: cycle.follow_up_suggestions || [],
+        })),
+        prompt_cycle_count: prompt_cycles.length,
+    };
+}
+//# sourceMappingURL=inspect-session.js.map

package/build/tools/inspect-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect-session.js","sourceRoot":"","sources":["../../src/tools/inspect-session.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACzC,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,QAAsB,EACtB,IAAa;IAEb,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,yBAAyB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEpD,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,WAAW,EAAE,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC;IAEvE,iDAAiD;IACjD,MAAM,WAAW,GAAG,KAAK,CAAC,YAAY,IAAI,CAAC,MAAM,QAAQ,CAAC,cAAc,CAAC,iBAAiB,EAAE,CAAC,CAAC,IAAI,CAAC;IACnG,MAAM,gBAAgB,GAAG,KAAK,CAAC,iBAAiB,IAAI,MAAM,CAAC,uBAAuB,CAAC;IAEnF,sBAAsB;IACtB,MAAM,cAAc,GAAG,MAAM,QAAQ,CAAC,cAAc,CAAC,cAAc,CACjE,KAAK,CAAC,YAAY,EAClB,WAAW,EACX,gBAAgB,CACjB,CAAC;IAEF,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IAE3C,sBAAsB;IACtB,MAAM,YAAY,GAAG,cAAc,CAAC,YAAY,IAAI;QAClD,YAAY,EAAE,cAAc,CAAC,YAAY,IAAI,cAAc,CAAC,IAAI,IAAI,KAAK,CAAC,YAAY;QACtF,IAAI,EAAE,cAAc,CAAC,IAAI,IAAI,EAAE;QAC/B,WAAW,EAAE,cAAc,CAAC,WAAW,IAAI,cAAc,CAAC,UAAU,IAAI,EAAE;QAC1E,WAAW,EAAE,cAAc,CAAC,WAAW,IAAI,cAAc,CAAC,UAAU,IAAI,EAAE;KAC3E,CAAC;IAEF,MAAM,aAAa,GAAG,cAAc,CAAC,YAAY,IAAI,EAAE,CAAC;IAExD,OAAO;QACL,YAAY;QACZ,aAAa,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,KAAU,EAAE,EAAE,CAAC,CAAC;YAChD,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,IAAI,EAAE;YAChD,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,EAAE;YAC5B,qBAAqB,EAAE,KAAK,CAAC,qBAAqB,IAAI,EAAE;SACzD,CAAC,CAAC;QACH,kBAAkB,EAAE,aAAa,CAAC,MAAM;KACzC,CAAC;AACJ,CAAC"}

package/build/tools/investigate-alert.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Tool: hawkeye_investigate_alert
+ * Finds existing RCA or creates new investigation for an alert ID
+ */
+import { ToolServices } from './index.js';
+import { InvestigateAlertOutput } from '../types/mcp.js';
+/**
+ * Investigate an alert by ID
+ */
+export declare function investigateAlert(services: ToolServices, args: unknown): Promise<InvestigateAlertOutput>;

package/build/tools/investigate-alert.js

@@ -0,0 +1,122 @@
+/**
+ * Tool: hawkeye_investigate_alert
+ * Finds existing RCA or creates new investigation for an alert ID
+ */
+import { InvestigateAlertInputSchema } from '../utils/validation.js';
+import { getConfig } from '../config/config.js';
+import { logger } from '../utils/logger.js';
+/**
+ * Investigate an alert by ID
+ */
+export async function investigateAlert(services, args) {
+    const config = getConfig();
+    const input = InvestigateAlertInputSchema.parse(args);
+    logger.info('Investigating alert', { alertId: input.alert_id });
+    // Get project UUID (use default if not provided)
+    const projectUuid = input.project_uuid || (await services.projectService.getDefaultProject()).uuid;
+    const organizationUuid = config.defaultOrganizationUuid;
+    // Step 1: Search for existing sessions with this alert ID
+    logger.info('Searching for existing sessions', { alertId: input.alert_id, projectUuid });
+    const existingSessions = await services.sessionService.findSessionsByAlertId(input.alert_id, projectUuid, organizationUuid);
+    // If we found existing session(s), return the most recent one
+    if (existingSessions.length > 0) {
+        logger.info(`Found ${existingSessions.length} existing session(s) for alert`);
+        // Sort by updated_at to get the most recent
+        const latestSession = existingSessions.sort((a, b) => {
+            const aTime = a.last_update || a.updated_at || a.create_time || a.created_at || '';
+            const bTime = b.last_update || b.updated_at || b.create_time || b.created_at || '';
+            return new Date(bTime).getTime() - new Date(aTime).getTime();
+        })[0];
+        const sessionUuid = latestSession.session_uuid || latestSession.uuid || '';
+        logger.info('Using most recent session', { sessionUuid });
+        // Inspect the session to get full details
+        const sessionDetails = await services.sessionService.inspectSession(sessionUuid, projectUuid, organizationUuid);
+        // Check if investigation is complete
+        const isComplete = sessionDetails.final_answer !== undefined && sessionDetails.final_answer !== null;
+        return {
+            status: isComplete ? 'completed' : 'in_progress',
+            session_uuid: sessionUuid,
+            investigation_results: isComplete ? formatInvestigationResults(sessionDetails) : undefined,
+            message: isComplete
+                ? `Found completed investigation for alert ${input.alert_id}`
+                : `Found in-progress investigation for alert ${input.alert_id}. Use hawkeye_get_investigation_status to check progress.`,
+        };
+    }
+    // Step 2: No existing session found, create a new investigation
+    logger.info('No existing session found, creating new investigation');
+    // Create a new session
+    const session = await services.sessionService.createSession(projectUuid, organizationUuid);
+    const sessionUuid = session.session_uuid || session.uuid || '';
+    logger.info('Created new session', { sessionUuid });
+    // Send investigation prompt
+    const investigationPrompt = `Investigate alert: ${input.alert_id}
+
+Please provide a root cause analysis for this alert, including:
+1. What triggered the alert
+2. The root cause of the issue
+3. Impact assessment
+4. Recommended remediation steps
+5. Prevention strategies`;
+    await services.sessionService.sendPrompt(sessionUuid, projectUuid, investigationPrompt);
+    logger.info('Investigation prompt sent');
+    // If wait_for_completion is true, poll for results
+    if (input.wait_for_completion) {
+        logger.info('Waiting for investigation to complete', {
+            maxWaitSeconds: input.max_wait_seconds,
+        });
+        const maxAttempts = Math.ceil(input.max_wait_seconds / (config.pollIntervalMs / 1000));
+        try {
+            const completedSession = await services.sessionService.pollForCompletion(sessionUuid, projectUuid, organizationUuid, maxAttempts, config.pollIntervalMs);
+            return {
+                status: 'completed',
+                session_uuid: sessionUuid,
+                investigation_results: formatInvestigationResults(completedSession),
+                message: `Investigation completed for alert ${input.alert_id}`,
+            };
+        }
+        catch (error) {
+            // Timeout or error during polling
+            return {
+                status: 'in_progress',
+                session_uuid: sessionUuid,
+                message: `Investigation started but not yet complete. Use hawkeye_get_investigation_status with session_uuid: ${sessionUuid} to check progress.`,
+            };
+        }
+    }
+    // Return immediately without waiting
+    return {
+        status: 'new_investigation',
+        session_uuid: sessionUuid,
+        message: `New investigation started for alert ${input.alert_id}. Use hawkeye_get_investigation_status with session_uuid: ${sessionUuid} to check progress.`,
+    };
+}
+/**
+ * Format investigation results from session details
+ */
+function formatInvestigationResults(session) {
+    return {
+        final_answer: session.final_answer,
+        chain_of_thoughts: session.chain_of_thoughts || [],
+        sources: session.sources || [],
+        follow_up_suggestions: generateFollowUpSuggestions(session),
+    };
+}
+/**
+ * Generate follow-up suggestions based on investigation results
+ */
+function generateFollowUpSuggestions(session) {
+    const suggestions = [];
+    if (session.final_answer) {
+        suggestions.push('Can you provide more details about the root cause?');
+        suggestions.push('What are the exact steps to remediate this issue?');
+        suggestions.push('How can we prevent this from happening again?');
+    }
+    if (session.chain_of_thoughts && session.chain_of_thoughts.length > 0) {
+        suggestions.push('Can you explain the investigation process in more detail?');
+    }
+    if (session.sources && session.sources.length > 0) {
+        suggestions.push('Which logs or metrics were most relevant to this investigation?');
+    }
+    return suggestions;
+}
+//# sourceMappingURL=investigate-alert.js.map

package/build/tools/investigate-alert.js.map

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

package/build/tools/list-sessions.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Tool: hawkeye_list_sessions
+ * Lists investigation sessions for a project with pagination and date filtering
+ */
+import { ToolServices } from './index.js';
+import { z } from 'zod';
+/**
+ * Input validation schema
+ */
+declare const ListSessionsInputSchema: z.ZodObject<{
+    project_uuid: z.ZodOptional<z.ZodString>;
+    page: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    date_from: z.ZodOptional<z.ZodString>;
+    date_to: z.ZodOptional<z.ZodString>;
+    organization_uuid: z.ZodOptional<z.ZodString>;
+    investigation_status: z.ZodOptional<z.ZodString>;
+    session_type: z.ZodOptional<z.ZodString>;
+    only_uninvestigated: z.ZodOptional<z.ZodBoolean>;
+    hide_grouped_incidents: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    project_uuid?: string | undefined;
+    organization_uuid?: string | undefined;
+    investigation_status?: string | undefined;
+    session_type?: string | undefined;
+    limit?: number | undefined;
+    page?: number | undefined;
+    date_from?: string | undefined;
+    date_to?: string | undefined;
+    only_uninvestigated?: boolean | undefined;
+    hide_grouped_incidents?: boolean | undefined;
+}, {
+    project_uuid?: string | undefined;
+    organization_uuid?: string | undefined;
+    investigation_status?: string | undefined;
+    session_type?: string | undefined;
+    limit?: number | undefined;
+    page?: number | undefined;
+    date_from?: string | undefined;
+    date_to?: string | undefined;
+    only_uninvestigated?: boolean | undefined;
+    hide_grouped_incidents?: boolean | undefined;
+}>;
+export type ListSessionsInput = z.infer<typeof ListSessionsInputSchema>;
+/**
+ * List sessions with pagination and filtering
+ */
+export declare function listSessions(services: ToolServices, args: unknown): Promise<any>;
+export {};

package/build/tools/list-sessions.js

@@ -0,0 +1,79 @@
+/**
+ * Tool: hawkeye_list_sessions
+ * Lists investigation sessions for a project with pagination and date filtering
+ */
+import { getConfig } from '../config/config.js';
+import { logger } from '../utils/logger.js';
+import { z } from 'zod';
+/**
+ * Input validation schema
+ */
+const ListSessionsInputSchema = z.object({
+    project_uuid: z.string().optional(),
+    page: z.number().int().positive().optional(),
+    limit: z.number().int().positive().max(100).optional(),
+    date_from: z.string().optional(),
+    date_to: z.string().optional(),
+    organization_uuid: z.string().optional(),
+    investigation_status: z.string().optional(),
+    session_type: z.string().optional(),
+    only_uninvestigated: z.boolean().optional(),
+    hide_grouped_incidents: z.boolean().optional(),
+});
+/**
+ * List sessions with pagination and filtering
+ */
+export async function listSessions(services, args) {
+    const config = getConfig();
+    const input = ListSessionsInputSchema.parse(args);
+    logger.info('Listing sessions', {
+        projectUuid: input.project_uuid,
+        page: input.page,
+        limit: input.limit,
+        onlyUninvestigated: input.only_uninvestigated,
+    });
+    // Get project UUID (use default if not provided)
+    const projectUuid = input.project_uuid || (await services.projectService.getDefaultProject()).uuid;
+    const organizationUuid = input.organization_uuid || config.defaultOrganizationUuid;
+    // Handle convenience parameter for uninvestigated incidents
+    let investigationStatus = input.investigation_status;
+    let sessionType = input.session_type;
+    if (input.only_uninvestigated === true) {
+        investigationStatus = 'INVESTIGATION_STATUS_NOT_STARTED';
+        sessionType = 'SESSION_TYPE_INCIDENT';
+    }
+    // List sessions with pagination
+    const sessions = await services.sessionService.listSessionsWithPagination(projectUuid, organizationUuid, {
+        page: input.page,
+        limit: input.limit,
+        dateFrom: input.date_from,
+        dateTo: input.date_to,
+        investigationStatus,
+        sessionType,
+        hideGroupedIncidents: input.hide_grouped_incidents,
+    });
+    logger.info(`Found ${sessions.length} sessions`);
+    return {
+        sessions: sessions.map((s) => ({
+            session_uuid: s.session_uuid || s.uuid,
+            name: s.name,
+            create_time: s.create_time || s.created_at,
+            last_update: s.last_update || s.updated_at,
+            prompt_cycle_count: s.prompt_cycle_ids?.length || s.prompt_cycle_count || 0,
+            incident_info: s.incident_info,
+        })),
+        page: input.page || 1,
+        limit: input.limit || 50,
+        count: sessions.length,
+        project_uuid: projectUuid,
+        filters_applied: {
+            date_from: input.date_from,
+            date_to: input.date_to,
+            investigation_status: investigationStatus,
+            session_type: sessionType,
+            only_uninvestigated: input.only_uninvestigated,
+            hide_grouped_incidents: input.hide_grouped_incidents,
+        },
+    };
+}
+//# sourceMappingURL=list-sessions.js.map

package/build/tools/list-sessions.js.map

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

package/build/types/errors.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Error type definitions for Hawkeye MCP Server
+ */
+export type ErrorType = 'authentication' | 'api' | 'validation' | 'investigation' | 'unknown';
+/**
+ * Base error class for Hawkeye MCP errors
+ */
+export declare class HawkeyeError extends Error {
+    readonly type: ErrorType;
+    readonly details?: any;
+    readonly recoverySuggestions?: string[];
+    constructor(type: ErrorType, message: string, details?: any, recoverySuggestions?: string[]);
+    /**
+     * Convert to JSON format for MCP tool responses
+     */
+    toJSON(): {
+        error: {
+            type: ErrorType;
+            message: string;
+            details: any;
+            recovery_suggestions: string[] | undefined;
+        };
+    };
+}
+/**
+ * Authentication-related errors
+ */
+export declare class AuthenticationError extends HawkeyeError {
+    constructor(message: string, details?: any, recoverySuggestions?: string[]);
+}
+/**
+ * API-related errors (network, HTTP status codes, etc.)
+ */
+export declare class ApiError extends HawkeyeError {
+    readonly statusCode?: number;
+    readonly response?: any;
+    constructor(message: string, statusCode?: number, response?: any, recoverySuggestions?: string[]);
+}
+/**
+ * Validation errors (invalid inputs, schema violations, etc.)
+ */
+export declare class ValidationError extends HawkeyeError {
+    constructor(message: string, details?: any, recoverySuggestions?: string[]);
+}
+/**
+ * Investigation-related errors (session creation, timeouts, etc.)
+ */
+export declare class InvestigationError extends HawkeyeError {
+    constructor(message: string, details?: any, recoverySuggestions?: string[]);
+}
+/**
+ * Error response format for MCP tools
+ */
+export interface ErrorResponse {
+    error: {
+        type: ErrorType;
+        message: string;
+        details?: any;
+        recovery_suggestions?: string[];
+    };
+}

package/build/types/errors.js

@@ -0,0 +1,76 @@
+/**
+ * Error type definitions for Hawkeye MCP Server
+ */
+/**
+ * Base error class for Hawkeye MCP errors
+ */
+export class HawkeyeError extends Error {
+    type;
+    details;
+    recoverySuggestions;
+    constructor(type, message, details, recoverySuggestions) {
+        super(message);
+        this.name = 'HawkeyeError';
+        this.type = type;
+        this.details = details;
+        this.recoverySuggestions = recoverySuggestions;
+        // Maintain proper stack trace for V8
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, HawkeyeError);
+        }
+    }
+    /**
+     * Convert to JSON format for MCP tool responses
+     */
+    toJSON() {
+        return {
+            error: {
+                type: this.type,
+                message: this.message,
+                details: this.details,
+                recovery_suggestions: this.recoverySuggestions,
+            },
+        };
+    }
+}
+/**
+ * Authentication-related errors
+ */
+export class AuthenticationError extends HawkeyeError {
+    constructor(message, details, recoverySuggestions) {
+        super('authentication', message, details, recoverySuggestions);
+        this.name = 'AuthenticationError';
+    }
+}
+/**
+ * API-related errors (network, HTTP status codes, etc.)
+ */
+export class ApiError extends HawkeyeError {
+    statusCode;
+    response;
+    constructor(message, statusCode, response, recoverySuggestions) {
+        super('api', message, { statusCode, response }, recoverySuggestions);
+        this.name = 'ApiError';
+        this.statusCode = statusCode;
+        this.response = response;
+    }
+}
+/**
+ * Validation errors (invalid inputs, schema violations, etc.)
+ */
+export class ValidationError extends HawkeyeError {
+    constructor(message, details, recoverySuggestions) {
+        super('validation', message, details, recoverySuggestions);
+        this.name = 'ValidationError';
+    }
+}
+/**
+ * Investigation-related errors (session creation, timeouts, etc.)
+ */
+export class InvestigationError extends HawkeyeError {
+    constructor(message, details, recoverySuggestions) {
+        super('investigation', message, details, recoverySuggestions);
+        this.name = 'InvestigationError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/build/types/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrB,IAAI,CAAY;IAChB,OAAO,CAAO;IACd,mBAAmB,CAAY;IAE/C,YACE,IAAe,EACf,OAAe,EACf,OAAa,EACb,mBAA8B;QAE9B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,mBAAmB,GAAG,mBAAmB,CAAC;QAE/C,qCAAqC;QACrC,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO;YACL,KAAK,EAAE;gBACL,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,oBAAoB,EAAE,IAAI,CAAC,mBAAmB;aAC/C;SACF,CAAC;IACJ,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,YAAY;IACnD,YAAY,OAAe,EAAE,OAAa,EAAE,mBAA8B;QACxE,KAAK,CAAC,gBAAgB,EAAE,OAAO,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAC;QAC/D,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,YAAY;IACxB,UAAU,CAAU;IACpB,QAAQ,CAAO;IAE/B,YACE,OAAe,EACf,UAAmB,EACnB,QAAc,EACd,mBAA8B;QAE9B,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,mBAAmB,CAAC,CAAC;QACrE,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,YAAY;IAC/C,YAAY,OAAe,EAAE,OAAa,EAAE,mBAA8B;QACxE,KAAK,CAAC,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAC;QAC3D,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,YAAY;IAClD,YAAY,OAAe,EAAE,OAAa,EAAE,mBAA8B;QACxE,KAAK,CAAC,eAAe,EAAE,OAAO,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAC;QAC9D,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF"}