explorbot 0.0.1

package/dist/boat/api-tester/src/ai/curler-tools.js

@@ -0,0 +1,263 @@
+import { tool } from 'ai';
+import { expect } from 'expect';
+import { readFileSync } from 'node:fs';
+import dedent from 'dedent';
+import { z } from 'zod';
+import { TestResult } from "../../../../src/test-plan.js";
+import { tag } from "../../../../src/utils/logger.js";
+const readResponseData = (responseFile) => {
+    return JSON.parse(readFileSync(responseFile, 'utf8'));
+};
+function summarizeStructure(value, depth = 0) {
+    if (depth > 2)
+        return '...';
+    if (Array.isArray(value)) {
+        if (value.length === 0)
+            return '[]';
+        return `[${summarizeStructure(value[0], depth + 1)}]`;
+    }
+    if (value && typeof value === 'object') {
+        const entries = Object.keys(value).slice(0, 10);
+        const parts = entries.map((k) => `${k}: ${summarizeStructure(value[k], depth + 1)}`);
+        if (Object.keys(value).length > 10)
+            parts.push('...');
+        return `{ ${parts.join(', ')} }`;
+    }
+    return typeof value;
+}
+export function createCurlerTools(apiClient, requestState, test, searchSpec) {
+    const commitVerification = (label, passed, failDetail) => {
+        const activeNote = test.startNote(label);
+        if (passed) {
+            tag('success').log(`${label} passed`);
+            activeNote.commit(TestResult.PASSED);
+        }
+        else {
+            tag('warning').log(`${label} failed — ${failDetail}`);
+            activeNote.commit(TestResult.FAILED);
+        }
+    };
+    return {
+        request: tool({
+            description: dedent `
+        Make an HTTP request to the API endpoint.
+        Returns status, timing, and a preview of the response body (first 500 chars).
+        Full response is saved to responseFile — use verifyStructure and verifyData to check it.
+      `,
+            inputSchema: z.object({
+                method: z.enum(['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD', 'OPTIONS']).describe('HTTP method'),
+                path: z.string().describe('API path (e.g., /users, /users/1)'),
+                headers: z.record(z.string(), z.string()).optional().describe('Additional headers'),
+                body: z.any().optional().describe('Request body (JSON object or string)'),
+                queryParams: z.record(z.string(), z.string()).optional().describe('Query parameters'),
+            }),
+            execute: async (input) => {
+                tag('step').log(`${input.method} ${input.path}`);
+                const activeNote = test.startNote(`${input.method} ${input.path}`);
+                const result = await apiClient.request({
+                    method: input.method,
+                    path: input.path,
+                    headers: input.headers,
+                    body: input.body,
+                    queryParams: input.queryParams,
+                });
+                requestState.addRequest(result);
+                if (result.error) {
+                    tag('error').log(`${input.method} ${input.path} > Network error: ${result.error}`);
+                    activeNote.commit(TestResult.FAILED);
+                    return {
+                        success: false,
+                        error: result.error,
+                        curlCommand: result.toCurlCommand(),
+                    };
+                }
+                const statusLine = `${result.status} ${result.statusText}`;
+                const bodyString = input.body ? (typeof input.body === 'string' ? input.body : JSON.stringify(input.body, null, 2)) : undefined;
+                test.addStep(`${input.method} ${input.path} > ${statusLine} (${result.timing}ms)`, result.timing, undefined, undefined, bodyString, [result.responseFile]);
+                if (result.status >= 400) {
+                    tag('error').log(`${input.method} ${input.path} > ${statusLine} (${result.timing}ms)`);
+                    activeNote.commit(TestResult.FAILED);
+                }
+                else {
+                    tag('success').log(`${input.method} ${input.path} > ${statusLine} (${result.timing}ms)`);
+                    activeNote.commit(TestResult.PASSED);
+                }
+                if (bodyString) {
+                    tag('multiline').log(`Request body:\n${bodyString}`);
+                }
+                tag('multiline').log(`Response body:\n${result.rawResponseBody}`);
+                return {
+                    success: true,
+                    status: result.status,
+                    statusText: result.statusText,
+                    timing: result.timing,
+                    responsePreview: result.rawResponseBody.substring(0, 500),
+                    responseFile: result.responseFile,
+                    curlCommand: result.toCurlCommand(),
+                };
+            },
+        }),
+        ...(searchSpec
+            ? {
+                schemaFor: tool({
+                    description: dedent `
+              Search the API spec for endpoints matching a keyword.
+              Returns endpoint paths, HTTP methods, and schema definitions.
+              Use to discover related endpoints when you need to set up test data or find dependencies.
+              Pass "*" to list all available endpoints (paths and methods only).
+            `,
+                    inputSchema: z.object({
+                        query: z.string().describe('Keyword to search for in endpoint paths (e.g., "comments", "users"). Use "*" to list all endpoints.'),
+                    }),
+                    execute: async ({ query }) => {
+                        tag('step').log(`Schema lookup: ${query}`);
+                        return { result: searchSpec(query) };
+                    },
+                }),
+            }
+            : {}),
+        verifyStructure: tool({
+            description: dedent `
+        Verify response JSON structure using a Zod schema.
+        Write a JS expression that returns a Zod schema (z is available).
+        Example schema: "z.object({ id: z.number(), name: z.string(), items: z.array(z.object({ title: z.string() })) })"
+        Returns validation errors if the response doesn't match.
+        On success, returns a "structure" field showing the actual response shape — use it to write correct verifyData assertions.
+      `,
+            inputSchema: z.object({
+                responseFile: z.string().describe('Path to the response JSON file'),
+                schema: z.string().describe('JS expression returning a Zod schema, e.g. "z.object({ id: z.number(), name: z.string() })"'),
+            }),
+            execute: async ({ responseFile, schema: schemaCode }) => {
+                let data;
+                try {
+                    data = readResponseData(responseFile);
+                }
+                catch (e) {
+                    commitVerification('Structure check: failed to read response', false, e.message);
+                    return { passed: false, errors: [e.message] };
+                }
+                try {
+                    const schemaObj = new Function('z', `return ${schemaCode}`)(z);
+                    const result = schemaObj.safeParse(data);
+                    if (result.success) {
+                        commitVerification('Structure check: ✓ schema valid', true, '');
+                        const structure = summarizeStructure(data);
+                        return { passed: true, errors: [], structure };
+                    }
+                    const errors = result.error.issues.map((i) => `${i.path.join('.')}: ${i.message}`);
+                    commitVerification(`Structure check: ✗ ${errors.join(', ')}`, false, errors.join('; '));
+                    return { passed: false, errors };
+                }
+                catch (e) {
+                    commitVerification(`Structure check: schema error — ${e.message}`, false, e.message);
+                    return { passed: false, errors: [e.message] };
+                }
+            },
+        }),
+        verifyData: tool({
+            description: dedent `
+        Verify specific values in the response JSON using expect() assertions.
+        Each assertion is a JS expression with "response" (full parsed JSON body) and "expect" (Jest expect) available.
+        "response" is the entire parsed JSON — access nested fields accordingly.
+        Example assertions:
+        - "expect(response.name).toBe('Test Suite')"
+        - "expect(response.items).toHaveLength(3)"
+        - "expect(response).toHaveProperty('id')"
+        - "expect(response.count).toBeGreaterThan(0)"
+        - "expect(response.data.tags).toContain('urgent')"
+        - "expect(response).toMatchObject({ status: 'active' })"
+      `,
+            inputSchema: z.object({
+                responseFile: z.string().describe('Path to the response JSON file'),
+                assertions: z.array(z.string()).describe('JS expressions using expect(response) — e.g. "expect(response.id).toBe(1)"'),
+            }),
+            execute: async ({ responseFile, assertions }) => {
+                let response;
+                try {
+                    response = readResponseData(responseFile);
+                }
+                catch (e) {
+                    commitVerification('Data check: failed to read response', false, e.message);
+                    return { passed: false, results: [{ code: '<read file>', passed: false, error: e.message }] };
+                }
+                const results = [];
+                for (const code of assertions) {
+                    try {
+                        new Function('expect', 'response', code)(expect, response);
+                        results.push({ code, passed: true });
+                    }
+                    catch (e) {
+                        results.push({ code, passed: false, error: e.message });
+                    }
+                }
+                const passed = results.every((r) => r.passed);
+                const okResults = results.filter((r) => r.passed);
+                const failedResults = results.filter((r) => !r.passed);
+                let label = 'Data check:';
+                if (okResults.length > 0)
+                    label += ` ✓ ${okResults.map((r) => r.code).join(', ')}`;
+                if (failedResults.length > 0)
+                    label += ` ✗ ${failedResults.map((f) => `${f.code}: ${f.error}`).join(', ')}`;
+                commitVerification(label, passed, failedResults.map((f) => `${f.code}: ${f.error}`).join('; '));
+                return { passed, results };
+            },
+        }),
+        record: tool({
+            description: dedent `
+        Record a note or observation during testing.
+        Use status "success" for achieved outcomes, "fail" for failures.
+      `,
+            inputSchema: z.object({
+                note: z.string().describe('Observation or finding'),
+                status: z.enum(['success', 'fail']).optional().describe('Outcome status'),
+            }),
+            execute: async ({ note, status }) => {
+                let mappedStatus = null;
+                if (status === 'success')
+                    mappedStatus = TestResult.PASSED;
+                else if (status === 'fail')
+                    mappedStatus = TestResult.FAILED;
+                test.addNote(note, mappedStatus);
+                if (status === 'success') {
+                    tag('success').log(`${note}`);
+                }
+                else if (status === 'fail') {
+                    tag('warning').log(`${note}`);
+                }
+                return { recorded: true };
+            },
+        }),
+        finish: tool({
+            description: dedent `
+        Mark the test as complete. Use when all test goals are achieved.
+      `,
+            inputSchema: z.object({
+                summary: z.string().describe('Summary of what was tested and results'),
+            }),
+            execute: async ({ summary }) => {
+                test.summary = summary;
+                test.addNote(`Test complete: ${summary}`, TestResult.PASSED);
+                test.finish(TestResult.PASSED);
+                tag('success').log(`Test finished: ${summary}`);
+                return { finished: true };
+            },
+        }),
+        stop: tool({
+            description: dedent `
+        Abort the test. Use when the scenario cannot be completed.
+      `,
+            inputSchema: z.object({
+                reason: z.string().describe('Why the test cannot continue'),
+            }),
+            execute: async ({ reason }) => {
+                test.summary = `Test stopped: ${reason}`;
+                test.addNote(`Test stopped: ${reason}`, TestResult.FAILED);
+                test.finish(TestResult.FAILED);
+                tag('warning').log(`Test stopped: ${reason}`);
+                return { stopped: true };
+            },
+        }),
+    };
+}
+//# sourceMappingURL=curler-tools.js.map

package/dist/boat/api-tester/src/ai/curler-tools.js.map

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

package/dist/boat/api-tester/src/ai/curler.js

@@ -0,0 +1,271 @@
+import dedent from 'dedent';
+import { z } from 'zod';
+import { TestResult } from "../../../../src/test-plan.js";
+import { createDebug, tag } from "../../../../src/utils/logger.js";
+import { loop } from "../../../../src/utils/loop.js";
+import { createCurlerTools } from "./curler-tools.js";
+const debugLog = createDebug('explorbot:curler');
+const MAX_ITERATIONS = 10;
+export class Curler {
+    provider;
+    apiClient;
+    requestState;
+    reporter;
+    constructor(provider, apiClient, requestState, reporter) {
+        this.provider = provider;
+        this.apiClient = apiClient;
+        this.requestState = requestState;
+        this.reporter = reporter;
+    }
+    async test(test, opts) {
+        tag('info').log(`Testing: ${test.scenario}`);
+        debugLog('Starting test:', test.scenario);
+        this.requestState.clear();
+        test.start();
+        await this.reporter.reportTestStart(test);
+        const conversation = this.provider.startConversation(this.buildSystemPrompt(), 'curler', this.provider.getAgenticModel('curler'));
+        const tools = createCurlerTools(this.apiClient, this.requestState, test, opts?.searchSpec);
+        const initialPrompt = this.buildTestPrompt(test, opts?.specDefinition, opts?.baseEndpoint);
+        conversation.addUserText(initialPrompt);
+        await loop(async ({ stop, iteration }) => {
+            debugLog(`Iteration ${iteration}`);
+            if (iteration > 1) {
+                const requestLog = this.requestState.toLog();
+                const nextStep = dedent `
+            <request_log>
+            ${requestLog || 'No requests made yet'}
+            </request_log>
+
+            <task>
+            Continue testing. Review the request log above and proceed with the next step.
+            </task>
+
+            <notes>
+            ${test.notesToString() || 'No notes yet'}
+            </notes>
+          `;
+                conversation.addUserText(nextStep);
+            }
+            const result = await this.provider.invokeConversation(conversation, tools, {
+                maxToolRoundtrips: 5,
+                toolChoice: 'required',
+                agentName: 'curler',
+            });
+            if (!result)
+                throw new Error('Failed to get response from provider');
+            const toolNames = result.toolExecutions?.map((e) => e.toolName) || [];
+            debugLog('Tool calls:', toolNames.join(', '));
+            if (test.hasFinished) {
+                stop();
+                return;
+            }
+            if (iteration >= MAX_ITERATIONS) {
+                tag('warning').log('Max iterations reached, running final review...');
+                stop();
+            }
+        }, {
+            maxAttempts: MAX_ITERATIONS,
+            observability: {
+                name: `curler: ${test.scenario}`,
+                agent: 'curler',
+                sessionId: test.sessionName,
+                metadata: {
+                    input: {
+                        scenario: test.scenario,
+                        startUrl: test.startUrl,
+                        expected: test.expected,
+                    },
+                },
+            },
+            catch: async ({ error, stop }) => {
+                tag('error').log(`Test execution error: ${error}`);
+                stop();
+            },
+        });
+        try {
+            await this.finalReview(test);
+        }
+        catch (error) {
+            tag('error').log(`Final review failed: ${error}`);
+        }
+        this.finishTest(test);
+        const meta = {
+            endpoint: test.startUrl,
+            style: test.style,
+            sessionName: test.sessionName,
+        };
+        await this.reporter.reportTest(test, meta);
+        return { success: test.isSuccessful };
+    }
+    finishTest(test) {
+        if (!test.hasFinished) {
+            test.finish(TestResult.FAILED);
+        }
+        tag('info').log(`Finished: ${test.scenario}`);
+        tag('multiline').log(test.getPrintableNotes().join('\n'));
+        if (test.isSuccessful) {
+            tag('success').log(`Passed: ${test.scenario}`);
+        }
+        else if (test.isSkipped) {
+            tag('warning').log(`Skipped: ${test.scenario}`);
+        }
+        else {
+            tag('error').log(`Failed: ${test.scenario}`);
+        }
+    }
+    async finalReview(test) {
+        const notes = test.notesToString() || 'No notes recorded.';
+        const requestLog = this.requestState.toLog() || 'No requests made.';
+        const hasFailedNotes = test.getCheckedNotes().some((n) => n.status === TestResult.FAILED);
+        const isUnfinished = !test.hasFinished;
+        if (!hasFailedNotes && !isUnfinished)
+            return;
+        tag('info').log('Running final review...');
+        const schema = z.object({
+            summary: z.string().describe('One-line summary of test results'),
+            goalsAchieved: z.boolean().describe('Whether the main test goals were accomplished'),
+            failuresCritical: z.boolean().describe('Whether any assertion failures are critical enough to fail the test'),
+            details: z.string().describe('Brief explanation of what passed, what failed, and why failures are or are not critical'),
+        });
+        const model = this.provider.getAgenticModel('curler');
+        const response = await this.provider.generateObject([
+            {
+                role: 'system',
+                content: this.buildFinalReviewSystemPrompt(),
+            },
+            {
+                role: 'user',
+                content: dedent `
+            Scenario: ${test.scenario}
+
+            Expected outcomes:
+            ${test.expected.map((e) => `- ${e}`).join('\n')}
+
+            <notes>
+            ${notes}
+            </notes>
+
+            <request_log>
+            ${requestLog}
+            </request_log>
+
+            Evaluate:
+            1. Were the expected outcomes achieved based on the request results?
+            2. Are any assertion failures critical (wrong status codes, missing core data) or minor (optional fields, cosmetic)?
+            3. Should the test pass or fail overall?
+          `,
+            },
+        ], schema, model);
+        const result = response?.object;
+        if (!result)
+            return;
+        test.summary = result.summary;
+        test.addNote(`Review: ${result.details}`);
+        if (result.goalsAchieved && !result.failuresCritical) {
+            test.addNote(result.summary, TestResult.PASSED);
+            test.finish(TestResult.PASSED);
+        }
+        else {
+            test.addNote(result.summary, TestResult.FAILED);
+            test.finish(TestResult.FAILED);
+        }
+    }
+    buildTestPrompt(test, specDefinition, baseEndpoint) {
+        let prompt = dedent `
+      <task>
+      SCENARIO: ${test.scenario}
+
+      EXPECTED OUTCOMES:
+      ${test.expected.map((e) => `- ${e}`).join('\n')}
+
+      PLANNED STEPS:
+      ${test.plannedSteps.map((s) => `- ${s}`).join('\n')}
+
+      ENDPOINT: ${test.startUrl}
+
+      Execute the test by making HTTP requests using the request tool.
+      Use verifyStructure and verifyData to check responses.
+      Use record to document findings.
+      Use finish when all goals are achieved.
+      Use stop only if the scenario is fundamentally impossible.
+      </task>
+    `;
+        if (specDefinition) {
+            let specBlock = `\n\n<api_spec>\n${specDefinition}\n</api_spec>`;
+            if (baseEndpoint) {
+                specBlock += dedent `
+
+          <path_mapping>
+          IMPORTANT: The spec shows absolute paths (e.g. /api/v2/{project_id}/suites) but the base URL is ${baseEndpoint}.
+          The request tool prepends the base URL automatically.
+          Use ONLY the relative path after the base prefix: e.g. /suites, /suites/{id} — NOT the full spec path.
+          </path_mapping>
+        `;
+            }
+            prompt += specBlock;
+        }
+        return prompt;
+    }
+    buildSystemPrompt() {
+        return dedent `
+      <role>
+      You are a senior API test engineer. Execute HTTP requests to test API endpoints.
+      Validate responses against expectations.
+      </role>
+
+      <approach>
+      1. Use the request tool to make HTTP calls — response preview shows first 500 chars
+      2. If you need a related endpoint (e.g., to create prerequisite data), use schemaFor to discover it
+      3. Extract IDs and key values from the response preview to chain requests
+      4. After each request, use verifyStructure with a Zod schema to validate response shape
+         Example: schema = "z.object({ id: z.number(), name: z.string(), items: z.array(z.string()) })"
+         Use z.any() for fields you don't care about, z.optional() for nullable fields
+      5. Use verifyData with expect() assertions to check specific values
+         The "response" variable is the full parsed JSON body — use the structure from verifyStructure to access nested fields correctly
+         Example: "expect(response.name).toBe('Test Suite')"
+         Example: "expect(response.data.items).toHaveLength(3)"
+         Example: "expect(response.status).not.toBe('deleted')"
+      6. Use record to document findings and observations
+      7. Use finish when all test goals are achieved and verified
+      8. Use stop only if the scenario cannot be completed at all
+      </approach>
+
+      <rules>
+      - Always check HTTP status codes from the request tool result
+      - After each request, verify structure with a Zod schema matching the API spec
+      - Use verifyData with expect() for value assertions — "response" is the full parsed JSON, use the structure returned by verifyStructure to access the correct paths
+      - For CRUD tests: create first, extract ID from preview, then read/update/delete
+      - Chain requests logically — extract IDs from response preview
+      - Record important findings as you go
+      - Be precise about what you expect vs what you observe
+      - If a test requires data from another endpoint, use schemaFor to look it up before guessing
+      </rules>
+    `;
+    }
+    buildFinalReviewSystemPrompt() {
+        return dedent `
+      You evaluate API test results.
+      Analyze notes and request log to determine if test goals were achieved.
+      Decide if assertion failures are critical (should fail the test) or minor (test still passes).
+
+      
+      Status code rules:
+      - 500+ errors are always critical failures regardless of test type
+      - 4xx codes (400, 403, 404, 412, 422, etc.) are NOT failures by themselves — different APIs return different 4xx codes for similar situations, so do not be strict about the exact 4xx code
+      
+      For positive tests (creating/updating data):
+      - Focus on whether the expected data was actually saved correctly
+      - Never trust POST/PUT/PATCH response alone — a follow-up GET must confirm the data was persisted
+      - The real measure of success is the data state verified via GET, not the write response or status code
+      
+      For negative tests (invalid input, unauthorized access):
+      - PUT and PATCH methods are usually the same so do not treat them differently.
+      - Verify the invalid data was NOT created — check with GET to ensure nothing was saved by accident
+      - Any 4xx response that correctly rejects the request is acceptable
+
+      Critical failures: 500+ errors, data not saved in positive tests, invalid data accidentally created in negative tests, broken CRUD operations.
+      Minor failures: optional fields missing, cosmetic differences, extra fields in response, different-than-expected 4xx code.
+    `;
+    }
+}
+//# sourceMappingURL=curler.js.map

package/dist/boat/api-tester/src/ai/curler.js.map

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

package/dist/boat/api-tester/src/api-client.js

@@ -0,0 +1,26 @@
+import { ApiClient as BaseApiClient } from "../../../src/api/api-client.js";
+export class ApiClient extends BaseApiClient {
+    bootstrapHook;
+    teardownHook;
+    constructor(baseEndpoint, defaultHeaders = {}, hooks) {
+        super(baseEndpoint, defaultHeaders);
+        this.bootstrapHook = hooks?.bootstrap;
+        this.teardownHook = hooks?.teardown;
+    }
+    async bootstrap() {
+        if (!this.bootstrapHook)
+            return;
+        const ctx = { headers: this.getHeaders(), baseEndpoint: this.getBaseEndpoint() };
+        const result = await this.bootstrapHook(ctx);
+        if (result && typeof result === 'object') {
+            this.setHeaders(result);
+        }
+    }
+    async teardown() {
+        if (!this.teardownHook)
+            return;
+        const ctx = { headers: this.getHeaders(), baseEndpoint: this.getBaseEndpoint() };
+        await this.teardownHook(ctx);
+    }
+}
+//# sourceMappingURL=api-client.js.map

package/dist/boat/api-tester/src/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../../../../boat/api-tester/src/api-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAG5E,MAAM,OAAO,SAAU,SAAQ,aAAa;IAClC,aAAa,CAAU;IACvB,YAAY,CAAU;IAE9B,YAAY,YAAoB,EAAE,iBAAyC,EAAE,EAAE,KAAiD;QAC9H,KAAK,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;QACpC,IAAI,CAAC,aAAa,GAAG,KAAK,EAAE,SAAS,CAAC;QACtC,IAAI,CAAC,YAAY,GAAG,KAAK,EAAE,QAAQ,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,SAAS;QACb,IAAI,CAAC,IAAI,CAAC,aAAa;YAAE,OAAO;QAChC,MAAM,GAAG,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC;QACjF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QAC7C,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YACzC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC,IAAI,CAAC,YAAY;YAAE,OAAO;QAC/B,MAAM,GAAG,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC;QACjF,MAAM,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;CACF"}