poe-code 3.0.29 → 3.0.31

package/dist/sdk/spawn.js

@@ -0,0 +1,109 @@
+import { getPoeApiKey } from "./credentials.js";
+import { spawnCore } from "./spawn-core.js";
+import { createSdkContainer } from "./container.js";
+import { getSpawnConfig, spawn as spawnNonStreaming, spawnInteractive, spawnStreaming } from "@poe-code/agent-spawn";
+export function spawn(service, promptOrOptions, maybeOptions) {
+    const options = typeof promptOrOptions === "string"
+        ? { ...maybeOptions, prompt: promptOrOptions }
+        : promptOrOptions;
+    const emptyEvents = (async function* () { })();
+    /**
+     * Deferred event stream resolution.
+     *
+     * This pattern allows us to return both `events` and `result` synchronously from `spawn()`,
+     * while the actual event source is determined asynchronously inside the `result` promise.
+     *
+     * The flow:
+     * 1. Caller receives `{ events, result }` immediately
+     * 2. Caller can start iterating `events` right away (iteration blocks on `eventsPromise`)
+     * 3. Inside `result`, we determine if streaming is supported and resolve `eventsPromise`
+     *    with either the real event stream or an empty generator
+     * 4. The outer `events` generator then yields from the resolved inner stream
+     *
+     * This avoids forcing callers to `await` before they can set up their event handlers,
+     * enabling patterns like: `for await (const e of events) { ... }` without race conditions.
+     */
+    let resolveEvents;
+    let eventsResolved = false;
+    const eventsPromise = new Promise((resolve) => {
+        resolveEvents = resolve;
+    });
+    const resolveEventsOnce = (value) => {
+        if (eventsResolved)
+            return;
+        eventsResolved = true;
+        resolveEvents?.(value);
+    };
+    const events = (async function* () {
+        for await (const e of await eventsPromise) {
+            yield e;
+        }
+    })();
+    const result = (async () => {
+        try {
+            await getPoeApiKey();
+            if (options.interactive) {
+                resolveEventsOnce(emptyEvents);
+                const interactiveResult = await spawnInteractive(service, {
+                    prompt: options.prompt,
+                    cwd: options.cwd,
+                    model: options.model,
+                    args: options.args
+                });
+                return {
+                    stdout: interactiveResult.stdout,
+                    stderr: interactiveResult.stderr,
+                    exitCode: interactiveResult.exitCode
+                };
+            }
+            const spawnConfig = getSpawnConfig(service);
+            const supportsStreaming = !!spawnConfig &&
+                spawnConfig.kind === "cli" &&
+                typeof spawnConfig.adapter === "string";
+            if (supportsStreaming) {
+                const { events: innerEvents, done } = spawnStreaming({
+                    agentId: service,
+                    prompt: options.prompt,
+                    cwd: options.cwd,
+                    model: options.model,
+                    args: options.args,
+                    useStdin: false
+                });
+                resolveEventsOnce(innerEvents);
+                const final = await done;
+                return {
+                    stdout: final.stdout,
+                    stderr: final.stderr,
+                    exitCode: final.exitCode,
+                    threadId: final.threadId,
+                    sessionId: final.sessionId ?? final.threadId
+                };
+            }
+            if (spawnConfig && spawnConfig.kind === "cli") {
+                resolveEventsOnce(emptyEvents);
+                return spawnNonStreaming(service, {
+                    prompt: options.prompt,
+                    cwd: options.cwd,
+                    model: options.model,
+                    args: options.args,
+                    useStdin: false
+                });
+            }
+            resolveEventsOnce(emptyEvents);
+            const container = createSdkContainer({ cwd: options.cwd });
+            return spawnCore(container, service, {
+                prompt: options.prompt,
+                cwd: options.cwd,
+                model: options.model,
+                args: options.args,
+                useStdin: false
+            });
+        }
+        catch (error) {
+            resolveEventsOnce(emptyEvents);
+            throw error;
+        }
+    })();
+    return { events, result };
+}
+//# sourceMappingURL=spawn.js.map

package/dist/sdk/spawn.js.map

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

package/dist/sdk/types.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Options for spawning a provider CLI.
+ */
+export interface SpawnOptions {
+    /** The prompt to send to the provider */
+    prompt: string;
+    /** Working directory for the service CLI */
+    cwd?: string;
+    /** Model identifier override */
+    model?: string;
+    /** Additional arguments forwarded to the CLI */
+    args?: string[];
+    /** Launch the agent in interactive (TUI) mode with inherited stdio */
+    interactive?: boolean;
+}
+/**
+ * Result from spawning a provider CLI.
+ */
+export interface SpawnResult {
+    /** Standard output from the CLI */
+    stdout: string;
+    /** Standard error from the CLI */
+    stderr: string;
+    /** Exit code from the CLI process */
+    exitCode: number;
+    /** Thread identifier from streaming agents (if available) */
+    threadId?: string;
+    /** Backward-compatible alias for threadId */
+    sessionId?: string;
+}
+export interface GenerateOptions {
+    /** Model identifier override */
+    model?: string;
+    /** Additional parameters passed to the API */
+    params?: Record<string, string>;
+}
+export type MediaGenerateOptions = GenerateOptions;
+export interface GenerateResult {
+    content: string;
+}
+export interface MediaGenerateResult {
+    url: string;
+    mimeType?: string;
+}

package/dist/sdk/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/sdk/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/sdk/types.ts"],"names":[],"mappings":""}

package/dist/services/client-instance.d.ts

@@ -0,0 +1,12 @@
+import type { FileSystem } from "../utils/file-system.js";
+import type { HttpClient } from "../cli/http.js";
+import type { LlmClient } from "./llm-client.js";
+export declare function setGlobalClient(client: LlmClient): void;
+export declare function getGlobalClient(): LlmClient;
+export declare function hasGlobalClient(): boolean;
+export declare function initializeClient(options: {
+    fs: FileSystem;
+    credentialsPath: string;
+    baseUrl: string;
+    httpClient?: HttpClient;
+}): Promise<void>;

package/dist/services/client-instance.js

@@ -0,0 +1,36 @@
+import { AuthenticationError } from "../cli/errors.js";
+import { loadCredentials } from "./credentials.js";
+import { createPoeClient } from "./llm-client.js";
+let globalClient = null;
+export function setGlobalClient(client) {
+    globalClient = client;
+}
+export function getGlobalClient() {
+    if (!globalClient) {
+        throw new Error("LLM client not initialized. Call setGlobalClient() first.");
+    }
+    return globalClient;
+}
+export function hasGlobalClient() {
+    return globalClient !== null;
+}
+export async function initializeClient(options) {
+    // Don't reinitialize if a client is already set (e.g., in tests)
+    if (globalClient !== null) {
+        return;
+    }
+    const apiKey = await loadCredentials({
+        fs: options.fs,
+        filePath: options.credentialsPath
+    });
+    if (!apiKey) {
+        throw new AuthenticationError("Poe API key not found. Run 'poe-code login' first.");
+    }
+    const client = createPoeClient({
+        apiKey,
+        baseUrl: options.baseUrl,
+        httpClient: options.httpClient
+    });
+    setGlobalClient(client);
+}
+//# sourceMappingURL=client-instance.js.map

package/dist/services/client-instance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-instance.js","sourceRoot":"","sources":["../../src/services/client-instance.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGlD,IAAI,YAAY,GAAqB,IAAI,CAAC;AAE1C,MAAM,UAAU,eAAe,CAAC,MAAiB;IAC/C,YAAY,GAAG,MAAM,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,YAAY,KAAK,IAAI,CAAC;AAC/B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAKtC;IACC,iEAAiE;IACjE,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;QAC1B,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC;QACnC,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,QAAQ,EAAE,OAAO,CAAC,eAAe;KAClC,CAAC,CAAC;IACH,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,mBAAmB,CAC3B,oDAAoD,CACrD,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,eAAe,CAAC;QAC7B,MAAM;QACN,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,UAAU,EAAE,OAAO,CAAC,UAAU;KAC/B,CAAC,CAAC;IAEH,eAAe,CAAC,MAAM,CAAC,CAAC;AAC1B,CAAC"}

package/dist/services/credentials.d.ts

@@ -0,0 +1,24 @@
+import type { FileSystem } from "../utils/file-system.js";
+export interface CredentialsStoreOptions {
+    fs: FileSystem;
+    filePath: string;
+}
+export interface SaveCredentialsOptions extends CredentialsStoreOptions {
+    apiKey: string;
+}
+export interface ConfiguredServiceMetadata {
+    files: string[];
+}
+export interface SaveConfiguredServiceOptions extends CredentialsStoreOptions {
+    service: string;
+    metadata: ConfiguredServiceMetadata;
+}
+export interface UnconfigureServiceOptions extends CredentialsStoreOptions {
+    service: string;
+}
+export declare function saveCredentials(options: SaveCredentialsOptions): Promise<void>;
+export declare function loadCredentials(options: CredentialsStoreOptions): Promise<string | null>;
+export declare function deleteCredentials(options: CredentialsStoreOptions): Promise<boolean>;
+export declare function loadConfiguredServices(options: CredentialsStoreOptions): Promise<Record<string, ConfiguredServiceMetadata>>;
+export declare function saveConfiguredService(options: SaveConfiguredServiceOptions): Promise<void>;
+export declare function unconfigureService(options: UnconfigureServiceOptions): Promise<boolean>;

package/dist/services/credentials.js

@@ -0,0 +1,157 @@
+import path from "node:path";
+import { isNotFound } from "@poe-code/config-mutations";
+export async function saveCredentials(options) {
+    const { fs, filePath, apiKey } = options;
+    const document = await readCredentialsDocument(fs, filePath);
+    document.apiKey = apiKey;
+    await writeCredentialsDocument(fs, filePath, document);
+}
+export async function loadCredentials(options) {
+    const { fs, filePath } = options;
+    const document = await readCredentialsDocument(fs, filePath);
+    return typeof document.apiKey === "string" && document.apiKey.length > 0
+        ? document.apiKey
+        : null;
+}
+export async function deleteCredentials(options) {
+    const { fs, filePath } = options;
+    try {
+        await fs.unlink(filePath);
+        return true;
+    }
+    catch (error) {
+        if (isNotFound(error)) {
+            return false;
+        }
+        throw error;
+    }
+}
+export async function loadConfiguredServices(options) {
+    const { fs, filePath } = options;
+    const document = await readCredentialsDocument(fs, filePath);
+    return { ...(document.configured_services ?? {}) };
+}
+export async function saveConfiguredService(options) {
+    const { fs, filePath, service, metadata } = options;
+    const document = await readCredentialsDocument(fs, filePath);
+    const normalized = normalizeConfiguredServiceMetadata(metadata);
+    document.configured_services = {
+        ...(document.configured_services ?? {}),
+        [service]: normalized
+    };
+    await writeCredentialsDocument(fs, filePath, document);
+}
+export async function unconfigureService(options) {
+    const { fs, filePath, service } = options;
+    const document = await readCredentialsDocument(fs, filePath);
+    const services = document.configured_services;
+    if (!services || !(service in services)) {
+        return false;
+    }
+    delete services[service];
+    if (Object.keys(services).length === 0) {
+        delete document.configured_services;
+    }
+    await writeCredentialsDocument(fs, filePath, document);
+    return true;
+}
+function normalizeConfiguredServiceMetadata(metadata) {
+    const seen = new Set();
+    const files = [];
+    for (const entry of metadata.files ?? []) {
+        if (typeof entry !== "string" || entry.length === 0) {
+            continue;
+        }
+        if (!seen.has(entry)) {
+            files.push(entry);
+            seen.add(entry);
+        }
+    }
+    return {
+        files
+    };
+}
+async function readCredentialsDocument(fs, filePath) {
+    try {
+        const raw = await fs.readFile(filePath, "utf8");
+        return await parseCredentialsDocument(fs, filePath, raw);
+    }
+    catch (error) {
+        if (isNotFound(error)) {
+            return {};
+        }
+        throw error;
+    }
+}
+async function parseCredentialsDocument(fs, filePath, raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        return normalizeCredentialsDocument(parsed);
+    }
+    catch (error) {
+        if (error instanceof SyntaxError) {
+            await recoverInvalidCredentials(fs, filePath, raw);
+            return {};
+        }
+        throw error;
+    }
+}
+function normalizeCredentialsDocument(value) {
+    if (!isRecord(value)) {
+        return {};
+    }
+    const document = {};
+    if (typeof value.apiKey === "string" && value.apiKey.length > 0) {
+        document.apiKey = value.apiKey;
+    }
+    const services = normalizeConfiguredServices(value.configured_services);
+    if (Object.keys(services).length > 0) {
+        document.configured_services = services;
+    }
+    return document;
+}
+function normalizeConfiguredServices(value) {
+    if (!isRecord(value)) {
+        return {};
+    }
+    const entries = {};
+    for (const [key, entry] of Object.entries(value)) {
+        if (!isRecord(entry)) {
+            continue;
+        }
+        const normalized = normalizeConfiguredServiceMetadata({
+            files: Array.isArray(entry.files) ? entry.files : []
+        });
+        entries[key] = normalized;
+    }
+    return entries;
+}
+async function writeCredentialsDocument(fs, filePath, document) {
+    await fs.mkdir(path.dirname(filePath), { recursive: true });
+    const payload = {};
+    if (document.apiKey) {
+        payload.apiKey = document.apiKey;
+    }
+    if (document.configured_services) {
+        payload.configured_services = document.configured_services;
+    }
+    await fs.writeFile(filePath, `${JSON.stringify(payload, null, 2)}\n`, {
+        encoding: "utf8"
+    });
+}
+async function recoverInvalidCredentials(fs, filePath, content) {
+    const backupPath = createInvalidBackupPath(filePath);
+    await fs.writeFile(backupPath, content, { encoding: "utf8" });
+    await fs.writeFile(filePath, EMPTY_DOCUMENT, { encoding: "utf8" });
+}
+function createInvalidBackupPath(filePath) {
+    const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
+    const dir = path.dirname(filePath);
+    const base = path.basename(filePath);
+    return path.join(dir, `${base}.invalid-${timestamp}.json`);
+}
+function isRecord(value) {
+    return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}
+const EMPTY_DOCUMENT = `${JSON.stringify({}, null, 2)}\n`;
+//# sourceMappingURL=credentials.js.map

package/dist/services/credentials.js.map

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

package/dist/services/llm-client.d.ts

@@ -0,0 +1,22 @@
+import type { HttpClient } from "../cli/http.js";
+export interface LlmRequest {
+    model: string;
+    prompt: string;
+    params?: Record<string, string>;
+}
+export interface LlmResponse {
+    content?: string;
+    url?: string;
+    mimeType?: string;
+    data?: string;
+}
+export interface LlmClient {
+    text(request: LlmRequest): Promise<LlmResponse>;
+    media(type: "image" | "video" | "audio", request: LlmRequest): Promise<LlmResponse>;
+}
+export interface PoeClientOptions {
+    apiKey: string;
+    baseUrl: string;
+    httpClient?: HttpClient;
+}
+export declare function createPoeClient(options: PoeClientOptions): LlmClient;

package/dist/services/llm-client.js

@@ -0,0 +1,138 @@
+import { ApiError } from "../cli/errors.js";
+export function createPoeClient(options) {
+    const httpClient = options.httpClient ?? createDefaultHttpClient();
+    return {
+        async text(request) {
+            const data = await requestCompletion(httpClient, options.baseUrl, options.apiKey, request);
+            return { content: extractTextContent(data) };
+        },
+        async media(_type, request) {
+            const data = await requestCompletion(httpClient, options.baseUrl, options.apiKey, request);
+            return extractMediaFromCompletion(data);
+        }
+    };
+}
+function createDefaultHttpClient() {
+    return async (url, init) => {
+        const response = await globalThis.fetch(url, init);
+        return {
+            ok: response.ok,
+            status: response.status,
+            json: () => response.json(),
+            text: () => response.text()
+        };
+    };
+}
+async function requestCompletion(httpClient, baseUrl, apiKey, request) {
+    const body = {
+        model: request.model,
+        messages: [{ role: "user", content: request.prompt }]
+    };
+    if (request.params && Object.keys(request.params).length > 0) {
+        body.extra_body = request.params;
+    }
+    const response = await httpClient(`${baseUrl}/chat/completions`, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${apiKey}`
+        },
+        body: JSON.stringify(body)
+    });
+    if (!response.ok) {
+        const detail = await readErrorBody(response);
+        const message = detail ? `Poe API error (${response.status}): ${detail}` : `Poe API error (${response.status})`;
+        throw new ApiError(message, {
+            httpStatus: response.status,
+            endpoint: "chat/completions",
+            context: detail ? { responseBody: detail } : undefined
+        });
+    }
+    return response.json();
+}
+async function readErrorBody(response) {
+    if (!response.text) {
+        return undefined;
+    }
+    try {
+        const text = await response.text();
+        return text?.trim() || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function extractTextContent(data) {
+    if (!isRecord(data))
+        return undefined;
+    const choices = data.choices;
+    if (!Array.isArray(choices) || choices.length === 0)
+        return undefined;
+    const first = choices[0];
+    if (!isRecord(first))
+        return undefined;
+    const message = first.message;
+    if (!isRecord(message))
+        return undefined;
+    return typeof message.content === "string" ? message.content : undefined;
+}
+function extractMediaFromCompletion(data) {
+    const content = extractTextContent(data);
+    if (!content)
+        return {};
+    // Try parsing as JSON first (API returns { url, mimeType })
+    try {
+        const parsed = JSON.parse(content);
+        if (isRecord(parsed) && typeof parsed.url === "string") {
+            return {
+                url: parsed.url,
+                mimeType: typeof parsed.mimeType === "string" ? parsed.mimeType : undefined,
+                data: typeof parsed.data === "string" ? parsed.data : undefined
+            };
+        }
+        if (isRecord(parsed) && typeof parsed.data === "string") {
+            return {
+                data: parsed.data,
+                mimeType: typeof parsed.mimeType === "string" ? parsed.mimeType : undefined
+            };
+        }
+    }
+    catch {
+        // Not JSON, continue
+    }
+    // Try as raw URL
+    if (isValidUrl(content.trim())) {
+        return { url: content.trim() };
+    }
+    // Try extracting URL from markdown (e.g., "![image](url)")
+    const markdownUrl = extractMarkdownUrl(content);
+    if (markdownUrl) {
+        return { url: markdownUrl };
+    }
+    // No URL found, return content for error message
+    return { content };
+}
+function extractMarkdownUrl(content) {
+    const start = content.indexOf("](");
+    if (start === -1)
+        return undefined;
+    const urlStart = start + 2;
+    const end = content.indexOf(")", urlStart);
+    if (end === -1)
+        return undefined;
+    const url = content.slice(urlStart, end);
+    return isValidUrl(url) ? url : undefined;
+}
+function isValidUrl(value) {
+    try {
+        new URL(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function isRecord(value) {
+    return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}
+//# sourceMappingURL=llm-client.js.map

package/dist/services/llm-client.js.map

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

package/dist/services/media-download.d.ts

@@ -0,0 +1,17 @@
+import type { FileSystem } from "../utils/file-system.js";
+export declare class MediaDownloadError extends Error {
+    readonly kind: "fetch" | "write";
+    readonly url: string;
+    readonly outputPath: string;
+    constructor(message: string, options: {
+        kind: "fetch" | "write";
+        url: string;
+        outputPath: string;
+    });
+}
+export declare function downloadToFile(options: {
+    url: string;
+    outputPath: string;
+    fs: FileSystem;
+    fetcher?: typeof fetch;
+}): Promise<void>;

package/dist/services/media-download.js

@@ -0,0 +1,42 @@
+export class MediaDownloadError extends Error {
+    kind;
+    url;
+    outputPath;
+    constructor(message, options) {
+        super(message);
+        this.name = "MediaDownloadError";
+        this.kind = options.kind;
+        this.url = options.url;
+        this.outputPath = options.outputPath;
+    }
+}
+export async function downloadToFile(options) {
+    const fetcher = options.fetcher ?? globalThis.fetch;
+    if (!fetcher) {
+        throw new MediaDownloadError("Fetch is not available", {
+            kind: "fetch",
+            url: options.url,
+            outputPath: options.outputPath
+        });
+    }
+    const response = await fetcher(options.url);
+    if (!response.ok) {
+        throw new MediaDownloadError("Failed to download media", {
+            kind: "fetch",
+            url: options.url,
+            outputPath: options.outputPath
+        });
+    }
+    const buffer = Buffer.from(await response.arrayBuffer());
+    try {
+        await options.fs.writeFile(options.outputPath, buffer);
+    }
+    catch {
+        throw new MediaDownloadError("Failed to write media", {
+            kind: "write",
+            url: options.url,
+            outputPath: options.outputPath
+        });
+    }
+}
+//# sourceMappingURL=media-download.js.map

package/dist/services/media-download.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-download.js","sourceRoot":"","sources":["../../src/services/media-download.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,IAAI,CAAoB;IACxB,GAAG,CAAS;IACZ,UAAU,CAAS;IAE5B,YAAY,OAAe,EAAE,OAAqE;QAChG,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;QACvB,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACvC,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAKpC;IACC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC;IACpD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,kBAAkB,CAAC,wBAAwB,EAAE;YACrD,IAAI,EAAE,OAAO;YACb,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,UAAU,EAAE,OAAO,CAAC,UAAU;SAC/B,CAAC,CAAC;IACL,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC5C,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,kBAAkB,CAAC,0BAA0B,EAAE;YACvD,IAAI,EAAE,OAAO;YACb,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,UAAU,EAAE,OAAO,CAAC,UAAU;SAC/B,CAAC,CAAC;IACL,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;IAEzD,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,kBAAkB,CAAC,uBAAuB,EAAE;YACpD,IAAI,EAAE,OAAO;YACb,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,UAAU,EAAE,OAAO,CAAC,UAAU;SAC/B,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}