@roj-ai/sdk 0.1.3 → 0.1.4

package/dist/plugins/user-chat/plugin.js

@@ -0,0 +1,544 @@
+/**
+ * User Chat Plugin - Three-level plugin architecture for user interaction
+ *
+ * Level 1 (Preset): UserChatPresetConfig with session-wide enable flag
+ * Level 2 (Session): Plugin methods (askQuestion, tellUser, getMessages, sendMessage, answerQuestion)
+ * Level 3 (Agent): Agent-specific configuration and tools
+ *
+ * Owns the `messages` state slice (chat messages for the UI)
+ * and the full user message lifecycle via dequeue.
+ */
+import z from "zod/v4";
+import { getAgentRole } from "../../core/agents/agent-roles.js";
+import { agentIdSchema } from "../../core/agents/schema.js";
+import { ValidationErrors } from "../../core/errors.js";
+import { createEventsFactory } from "../../core/events/types.js";
+import { estimateTokens, truncateByTokens } from "../../core/llm/tokens.js";
+import { definePlugin } from "../../core/plugins/plugin-builder.js";
+import { sessionIdSchema } from "../../core/sessions/schema.js";
+import { getEntryAgentId } from "../../core/sessions/state.js";
+import { createTool } from "../../core/tools/definition.js";
+import { Err, Ok } from "../../lib/utils/result.js";
+import { getUserCommunicationInstructions } from "../../prompts/base.js";
+import { ASKING_QUESTIONS_SECTION, USER_COMMUNICATION_SECTION, } from "./prompts.js";
+import { askUserInputTypeSchema, chatMessageIdSchema, generateChatMessageId, } from "./schema.js";
+// ============================================================================
+// Events
+// ============================================================================
+export const userChatEvents = createEventsFactory({
+    events: {
+        user_question_asked: z.object({
+            agentId: agentIdSchema,
+            messageId: chatMessageIdSchema,
+            question: z.string(),
+            inputType: askUserInputTypeSchema,
+        }),
+        user_message_sent: z.object({
+            agentId: agentIdSchema,
+            messageId: chatMessageIdSchema,
+            message: z.string(),
+            format: z.enum(["text", "markdown"]),
+        }),
+        user_chat_message_received: z.object({
+            agentId: agentIdSchema,
+            messageId: chatMessageIdSchema,
+            content: z.string(),
+            timestamp: z.number(),
+        }),
+        user_chat_answer_received: z.object({
+            agentId: agentIdSchema,
+            messageId: chatMessageIdSchema,
+            questionId: chatMessageIdSchema,
+            answerValue: z.unknown(),
+            timestamp: z.number(),
+        }),
+        user_chat_messages_consumed: z.object({
+            agentId: agentIdSchema,
+            messageIds: z.array(chatMessageIdSchema),
+        }),
+    },
+});
+// For backwards compat
+export { userChatEvents as userCommunicationEvents };
+// ============================================================================
+// Tool schema
+// ============================================================================
+/**
+ * Flat option schema for choice inputs (simpler for LLM).
+ */
+const askUserOptionSchema = z.object({
+    value: z.string().describe("Option value (returned when selected)"),
+    label: z.string().describe("Option label (displayed to user)"),
+});
+/**
+ * Flat schema for ask_user tool - easier for LLM to understand than nested oneOf.
+ * Transformed to AskUserInputType in the executor.
+ */
+const askUserFlatInputSchema = z.object({
+    question: z
+        .string()
+        .describe("Question to ask the user. One question per call, but you can call ask_user multiple times in a single response."),
+    inputType: z
+        .enum(["text", "confirm", "rating", "single_choice", "multi_choice"])
+        .describe("Type of input: text (free text), confirm (yes/no), rating (numeric scale), single_choice or multi_choice (selection from options)"),
+    // text options
+    placeholder: z
+        .string()
+        .optional()
+        .describe("Placeholder text for text input"),
+    multiline: z.boolean().optional().describe("Allow multiline text input"),
+    // rating options
+    min: z
+        .number()
+        .int()
+        .optional()
+        .describe("Minimum value for rating (required when inputType=rating)"),
+    max: z
+        .number()
+        .int()
+        .optional()
+        .describe("Maximum value for rating (required when inputType=rating)"),
+    // choice options
+    options: z
+        .array(askUserOptionSchema)
+        .optional()
+        .describe("Options array for single_choice or multi_choice (required for these types)"),
+    // confirm options
+    confirmLabel: z
+        .string()
+        .optional()
+        .describe("Custom label for confirm button"),
+    cancelLabel: z.string().optional().describe("Custom label for cancel button"),
+});
+/**
+ * Transform flat input to proper AskUserInputType discriminated union.
+ */
+function transformToAskUserInputType(input) {
+    switch (input.inputType) {
+        case "text":
+            return {
+                type: "text",
+                placeholder: input.placeholder,
+                multiline: input.multiline,
+            };
+        case "confirm":
+            return {
+                type: "confirm",
+                confirmLabel: input.confirmLabel,
+                cancelLabel: input.cancelLabel,
+            };
+        case "rating":
+            return {
+                type: "rating",
+                min: input.min ?? 1,
+                max: input.max ?? 5,
+            };
+        case "single_choice":
+            return {
+                type: "single_choice",
+                options: input.options ?? [],
+            };
+        case "multi_choice":
+            return {
+                type: "multi_choice",
+                options: input.options ?? [],
+            };
+    }
+}
+// ============================================================================
+// Constants
+// ============================================================================
+const MESSAGE_MAX_TOKENS = 200_000;
+const MESSAGE_TRUNCATION_THRESHOLD = 10_000;
+const MESSAGE_TRUNCATION_TARGET = 5_000;
+// ============================================================================
+// Helpers
+// ============================================================================
+/**
+ * Format pending inbound messages for the LLM.
+ */
+function formatPendingForLLM(pending) {
+    const parts = [];
+    for (const msg of pending) {
+        if (msg.questionId !== undefined) {
+            parts.push(`[User answered question ${msg.questionId}]: ${JSON.stringify(msg.answerValue)}`);
+        }
+        else {
+            parts.push(`[User]: ${msg.content}`);
+        }
+    }
+    return parts.join("\n");
+}
+// ============================================================================
+// Plugin
+// ============================================================================
+export const userChatPlugin = definePlugin("user-chat")
+    .pluginConfig()
+    .events([userChatEvents])
+    .state({
+    key: "messages",
+    initial: () => ({
+        messages: [],
+        counter: 0,
+        pendingInbound: [],
+    }),
+    reduce: (state, event) => {
+        switch (event.type) {
+            case "user_chat_message_received": {
+                const userMessage = {
+                    type: "user_message",
+                    messageId: event.messageId,
+                    content: event.content,
+                    timestamp: event.timestamp,
+                };
+                const pending = {
+                    messageId: event.messageId,
+                    agentId: event.agentId,
+                    content: event.content,
+                    timestamp: event.timestamp,
+                    consumed: false,
+                };
+                return {
+                    messages: [...state.messages, userMessage],
+                    counter: state.counter + 1,
+                    pendingInbound: [...state.pendingInbound, pending],
+                };
+            }
+            case "user_chat_answer_received": {
+                // Update the question in messages as answered
+                const updatedMessages = state.messages.map((msg) => msg.type === "ask_user" && msg.questionId === event.questionId
+                    ? { ...msg, answered: true, answer: event.answerValue }
+                    : msg);
+                const pending = {
+                    messageId: event.messageId,
+                    agentId: event.agentId,
+                    content: JSON.stringify(event.answerValue),
+                    timestamp: event.timestamp,
+                    consumed: false,
+                    questionId: event.questionId,
+                    answerValue: event.answerValue,
+                };
+                return {
+                    messages: updatedMessages,
+                    counter: state.counter + 1,
+                    pendingInbound: [...state.pendingInbound, pending],
+                };
+            }
+            case "user_chat_messages_consumed": {
+                const consumedSet = new Set(event.messageIds.map(String));
+                return {
+                    ...state,
+                    pendingInbound: state.pendingInbound.map((msg) => consumedSet.has(String(msg.messageId)) &&
+                        msg.agentId === event.agentId
+                        ? { ...msg, consumed: true }
+                        : msg),
+                };
+            }
+            case "user_question_asked": {
+                const askMessage = {
+                    type: "ask_user",
+                    questionId: event.messageId,
+                    question: event.question,
+                    inputType: event.inputType,
+                    answered: false,
+                    timestamp: event.timestamp,
+                };
+                return {
+                    ...state,
+                    messages: [...state.messages, askMessage],
+                    counter: state.counter + 1,
+                };
+            }
+            case "user_message_sent": {
+                const agentMessage = {
+                    type: "agent_message",
+                    messageId: event.messageId,
+                    content: event.message,
+                    format: event.format,
+                    timestamp: event.timestamp,
+                };
+                return {
+                    ...state,
+                    messages: [...state.messages, agentMessage],
+                    counter: state.counter + 1,
+                };
+            }
+            default:
+                return state;
+        }
+    },
+})
+    .agentConfig()
+    .notification("agentMessage", {
+    schema: z.object({
+        sessionId: sessionIdSchema,
+        content: z.string(),
+        format: z.enum(["text", "markdown"]),
+        timestamp: z.number(),
+    }),
+})
+    .notification("askUser", {
+    schema: z.object({
+        sessionId: sessionIdSchema,
+        questionId: z.string(),
+        question: z.string(),
+        inputType: askUserInputTypeSchema,
+        timestamp: z.number(),
+    }),
+})
+    .method("askQuestion", {
+    input: z.object({
+        agentId: agentIdSchema,
+        question: z.string(),
+        inputType: askUserInputTypeSchema,
+    }),
+    output: z.object({
+        messageId: z.string(),
+    }),
+    handler: async (ctx, input) => {
+        const messageId = generateChatMessageId(ctx.pluginState.counter + 1);
+        const timestamp = Date.now();
+        await ctx.emitEvent(userChatEvents.create("user_question_asked", {
+            agentId: input.agentId,
+            messageId,
+            question: input.question,
+            inputType: input.inputType,
+        }));
+        ctx.notify("askUser", {
+            sessionId: ctx.sessionId,
+            questionId: messageId,
+            question: input.question,
+            inputType: input.inputType,
+            timestamp,
+        });
+        return Ok({ messageId });
+    },
+})
+    .method("tellUser", {
+    input: z.object({
+        agentId: agentIdSchema,
+        message: z.string(),
+        format: z.enum(["text", "markdown"]),
+    }),
+    output: z.object({
+        messageId: z.string(),
+    }),
+    handler: async (ctx, input) => {
+        const messageId = generateChatMessageId(ctx.pluginState.counter + 1);
+        const timestamp = Date.now();
+        await ctx.emitEvent(userChatEvents.create("user_message_sent", {
+            agentId: input.agentId,
+            messageId,
+            message: input.message,
+            format: input.format,
+        }));
+        ctx.notify("agentMessage", {
+            sessionId: ctx.sessionId,
+            content: input.message,
+            format: input.format,
+            timestamp,
+        });
+        return Ok({ messageId });
+    },
+})
+    .method("sendMessage", {
+    input: z.object({
+        agentId: agentIdSchema.optional(),
+        content: z.string(),
+    }),
+    output: z.object({
+        messageId: chatMessageIdSchema,
+    }),
+    handler: async (ctx, input) => {
+        const agentId = input.agentId ?? getEntryAgentId(ctx.sessionState);
+        if (!agentId) {
+            throw new Error("No agent available");
+        }
+        // Hard limit
+        const tokenCount = estimateTokens(input.content);
+        if (tokenCount > MESSAGE_MAX_TOKENS) {
+            return Err(ValidationErrors.invalid(`Message too large: ~${tokenCount} tokens (max ${MESSAGE_MAX_TOKENS})`));
+        }
+        const messageId = generateChatMessageId(ctx.pluginState.counter + 1);
+        // Soft truncation — save full content to file, pass truncated + reference
+        let content = input.content;
+        const truncation = tokenCount > MESSAGE_TRUNCATION_THRESHOLD
+            ? truncateByTokens(input.content, MESSAGE_TRUNCATION_TARGET)
+            : null;
+        if (truncation) {
+            const filePath = `.user-messages/${messageId}.md`;
+            await ctx.files.session.write(filePath, input.content);
+            content = `${truncation.content}\n\n[Full message saved to: ${filePath} — use read_file to access it]`;
+        }
+        await ctx.emitEvent(userChatEvents.create("user_chat_message_received", {
+            agentId: agentId,
+            messageId,
+            content,
+            timestamp: Date.now(),
+        }));
+        ctx.scheduleAgent(agentId);
+        return Ok({ messageId });
+    },
+})
+    .method("answerQuestion", {
+    input: z.object({
+        agentId: agentIdSchema,
+        questionId: chatMessageIdSchema,
+        answer: z.unknown(),
+    }),
+    output: z.object({}),
+    handler: async (ctx, input) => {
+        const messageId = generateChatMessageId(ctx.pluginState.counter + 1);
+        await ctx.emitEvent(userChatEvents.create("user_chat_answer_received", {
+            agentId: input.agentId,
+            messageId,
+            questionId: input.questionId,
+            answerValue: input.answer,
+            timestamp: Date.now(),
+        }));
+        ctx.scheduleAgent(input.agentId);
+        return Ok({});
+    },
+})
+    .method("getMessages", {
+    input: z.object({
+        sessionId: z.string(),
+    }),
+    output: z.object({
+        messages: z.array(z.unknown()),
+    }),
+    handler: async (ctx) => {
+        return Ok({ messages: ctx.pluginState.messages });
+    },
+})
+    .dequeue({
+    hasPendingMessages: (ctx) => ctx.pluginState.pendingInbound.some((m) => !m.consumed && m.agentId === ctx.agentId),
+    getPendingMessages: (ctx) => {
+        const pending = ctx.pluginState.pendingInbound.filter((m) => !m.consumed && m.agentId === ctx.agentId);
+        if (pending.length === 0)
+            return null;
+        return {
+            messages: [{ role: "user", content: formatPendingForLLM(pending) }],
+            token: pending.map((m) => m.messageId),
+        };
+    },
+    markConsumed: async (ctx, token) => {
+        await ctx.emitEvent(userChatEvents.create("user_chat_messages_consumed", {
+            agentId: ctx.agentId,
+            messageIds: token,
+        }));
+    },
+})
+    .hook("afterInference", async (ctx) => {
+    const mode = ctx.pluginAgentConfig?.userCommunication;
+    if (mode !== "xml" && mode !== "both")
+        return null;
+    const responseContent = ctx.response.content;
+    if (!responseContent)
+        return null;
+    const userTagRegex = /<user>([\s\S]*?)<\/user>/g;
+    let match;
+    let localCounter = ctx.pluginState.counter;
+    while ((match = userTagRegex.exec(responseContent)) !== null) {
+        const content = match[1].trim();
+        if (!content)
+            continue;
+        localCounter++;
+        const chatMessageId = generateChatMessageId(localCounter);
+        await ctx.emitEvent(userChatEvents.create("user_message_sent", {
+            agentId: ctx.agentId,
+            messageId: chatMessageId,
+            message: content,
+            format: "text",
+        }));
+        ctx.notify("agentMessage", {
+            sessionId: ctx.sessionId,
+            content,
+            format: "text",
+            timestamp: Date.now(),
+        });
+    }
+    // Strip <user> tags from response content
+    const cleanedContent = responseContent
+        .replace(/<user>[\s\S]*?<\/user>/g, "")
+        .trim();
+    if (cleanedContent !== responseContent) {
+        return {
+            action: "modify",
+            response: { ...ctx.response, content: cleanedContent || null },
+        };
+    }
+    return null;
+})
+    .systemPrompt((ctx) => {
+    const enabled = ctx.pluginConfig.enabled !== false;
+    const agentEnabled = ctx.pluginAgentConfig?.enabled !== false;
+    if (!enabled || !agentEnabled)
+        return null;
+    const role = getAgentRole(ctx.agentState, ctx.sessionState);
+    if (role !== "entry" && role !== "communicator")
+        return null;
+    return (USER_COMMUNICATION_SECTION +
+        "\n\n" +
+        ASKING_QUESTIONS_SECTION +
+        getUserCommunicationInstructions(ctx.pluginAgentConfig?.userCommunication, true));
+})
+    .tools((ctx) => {
+    const enabled = ctx.pluginConfig.enabled !== false;
+    if (!enabled)
+        return [];
+    const agentEnabled = ctx.pluginAgentConfig?.enabled !== false;
+    if (!agentEnabled)
+        return [];
+    const role = getAgentRole(ctx.agentState, ctx.sessionState);
+    if (role !== "entry" && role !== "communicator")
+        return [];
+    return [
+        createTool({
+            name: "tell_user",
+            description: "Send a message to the user (async, in response will ONLY confirm sending).",
+            input: z.object({
+                message: z.string().describe("Message to send to the user"),
+                format: z
+                    .enum(["text", "markdown"])
+                    .optional()
+                    .describe("Message format (text or markdown). Defaults to text."),
+            }),
+            execute: async (input, context) => {
+                const format = input.format ?? "text";
+                const result = await ctx.self.tellUser({
+                    agentId: context.agentId,
+                    message: input.message,
+                    format,
+                });
+                if (!result.ok)
+                    return Err({ message: result.error.message, recoverable: false });
+                return Ok(JSON.stringify({
+                    messageId: result.value.messageId,
+                    status: "sent",
+                }));
+            },
+        }),
+        createTool({
+            name: "ask_user",
+            description: "Ask the user a question. One question per call, but you can call ask_user multiple times in a single response. The response will arrive in your mailbox. Prefer single_choice/multi_choice/confirm when possible options are known; use text only when the answer is truly open-ended. (async, in response will ONLY confirm sending)",
+            input: askUserFlatInputSchema,
+            execute: async (input, context) => {
+                const inputType = transformToAskUserInputType(input);
+                const result = await ctx.self.askQuestion({
+                    agentId: context.agentId,
+                    question: input.question,
+                    inputType,
+                });
+                if (!result.ok)
+                    return Err({ message: result.error.message, recoverable: false });
+                return Ok(JSON.stringify({
+                    messageId: result.value.messageId,
+                    status: "sent",
+                }));
+            },
+        }),
+    ];
+})
+    .build();
+//# sourceMappingURL=plugin.js.map

package/dist/plugins/user-chat/plugin.js.map

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

package/dist/plugins/user-chat/prompts.js

@@ -0,0 +1,29 @@
+/**
+ * User communication prompt sections for system prompt composition.
+ * Used by agents that communicate directly with users (entry + communicator roles).
+ */
+/**
+ * Mandatory user communication instructions.
+ */
+export const USER_COMMUNICATION_SECTION = `## User Communication (MANDATORY)
+
+**Every time you receive a user message, you MUST respond to the user via \`tell_user\` or \`ask_user\` before stopping.** The user is waiting for a response and will see nothing unless you explicitly call a communication tool.
+
+- **Direct response**: If you can answer immediately, call \`tell_user\`.
+- **Delegating work**: If you spawn child agents or start background work, call \`tell_user\` to inform the user what is happening (e.g. "I'm starting work on your request…"). Once the work is done, call \`tell_user\` again with the results.
+- **Need more info**: If you need clarification, call \`ask_user\`.
+
+**Never stop without calling \`tell_user\` or \`ask_user\`.** Silent processing leaves the user with no feedback.`;
+/**
+ * Structured input preferences for asking questions.
+ */
+export const ASKING_QUESTIONS_SECTION = `## Asking Users Questions
+
+When you need to ask the user multiple questions, **call \`ask_user\` multiple times in a single response** rather than asking one question at a time. The user will receive all questions as a single questionnaire, which is much better UX than being asked one-by-one.
+
+Only ask questions sequentially when a later question depends on the answer to an earlier one.
+
+### Prefer Structured Input Types
+
+When asking questions, prefer \`single_choice\`, \`multi_choice\`, or \`confirm\` over free-text \`text\` input whenever the possible answers are known. Only use \`text\` when the answer is truly open-ended. Structured inputs are faster for users and produce more consistent answers.`;
+//# sourceMappingURL=prompts.js.map

package/dist/plugins/user-chat/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../../src/plugins/user-chat/prompts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;;;;;;;;kHAQwE,CAAA;AAElH;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;;;;;;;;4RAQoP,CAAA"}

package/dist/plugins/user-chat/schema.js

@@ -0,0 +1,46 @@
+import z from 'zod/v4';
+export const chatMessageIdSchema = z.string().brand('ChatMessageId');
+export const ChatMessageId = (id) => id;
+export const generateChatMessageId = (seq) => ChatMessageId(`m${seq}`);
+// ============================================================================
+// AskUser - Zod schemas
+// ============================================================================
+export const askUserOptionSchema = z.object({
+    value: z.string(),
+    label: z.string(),
+    description: z.string().optional(),
+});
+export const askUserInputTypeSchema = z.discriminatedUnion('type', [
+    z.object({
+        type: z.literal('text'),
+        placeholder: z.string().optional(),
+        multiline: z.boolean().optional(),
+    }),
+    z.object({
+        type: z.literal('single_choice'),
+        options: z.array(askUserOptionSchema).min(1),
+    }),
+    z.object({
+        type: z.literal('multi_choice'),
+        options: z.array(askUserOptionSchema).min(1),
+        minSelect: z.number().int().min(0).optional(),
+        maxSelect: z.number().int().min(1).optional(),
+    }),
+    z.object({
+        type: z.literal('rating'),
+        min: z.number().int(),
+        max: z.number().int(),
+        labels: z
+            .object({
+            min: z.string().optional(),
+            max: z.string().optional(),
+        })
+            .optional(),
+    }),
+    z.object({
+        type: z.literal('confirm'),
+        confirmLabel: z.string().optional(),
+        cancelLabel: z.string().optional(),
+    }),
+]);
+//# sourceMappingURL=schema.js.map

package/dist/plugins/user-chat/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/plugins/user-chat/schema.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,QAAQ,CAAA;AAEtB,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,eAAe,CAAC,CAAA;AAIpE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,EAAU,EAAiB,EAAE,CAAC,EAAmB,CAAA;AAE/E,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,GAAW,EAAiB,EAAE,CAAC,aAAa,CAAC,IAAI,GAAG,EAAE,CAAC,CAAA;AA0B7F,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IAClE,CAAC,CAAC,MAAM,CAAC;QACR,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;QACvB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAClC,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;KACjC,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACR,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC;QAChC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;KAC5C,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACR,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC;QAC/B,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;QAC7C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;KAC7C,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACR,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;QACzB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;QACrB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;QACrB,MAAM,EAAE,CAAC;aACP,MAAM,CAAC;YACP,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC1B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC1B,CAAC;aACD,QAAQ,EAAE;KACZ,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACR,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;QAC1B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACnC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAClC,CAAC;CACF,CAAC,CAAA"}