@adonis-agora/agent 0.76.2 → 0.77.0

package/dist/src/poppy-client/conversations.d.ts

@@ -0,0 +1,89 @@
+import type { CompanyClient } from './company.js';
+import type { ConversationEvent, ConversationState, EventsPage, OutgoingMessage, PoppyProtocolEntry, StartConversationResponse, TextDelta } from './types.js';
+/** A fresh message ID: URL-safe base64, prefixed, unique for the User (7.2, 7.3). */
+export declare function newMessageId(): string;
+/** Picks the `poppy` conversation protocol entry (7.1); unknown types are skipped. */
+export declare function poppyProtocol(company: CompanyClient): PoppyProtocolEntry | undefined;
+export type StreamItem = {
+    kind: 'event';
+    event: ConversationEvent;
+} | {
+    kind: 'delta';
+    delta: TextDelta;
+}
+/** The reader reconnected; any provisional `text-delta` pieces must be dropped (7.6). */
+ | {
+    kind: 'reconnected';
+}
+/** `cursor_expired`: the read restarted from the beginning; part of history is missing. */
+ | {
+    kind: 'history_gap';
+};
+export interface FollowOptions {
+    signal?: AbortSignal | undefined;
+    /** Stop once the conversation is `idle`, `queued` or `closed` after this many events. */
+    untilSettled?: boolean | undefined;
+    /** Prefer SSE (default). When the Company answers with JSON, long-polling is used. */
+    stream?: boolean | undefined;
+    /** Long-poll `wait` seconds. */
+    wait?: number | undefined;
+}
+/**
+ * Client for one Company's Poppy conversation endpoint (section 7). Every request carries the
+ * Session Token with a DPoP proof (7.2), through `CompanyClient.fetch`.
+ */
+export declare class ConversationClient {
+    readonly company: CompanyClient;
+    readonly endpoint: string;
+    private readonly resource?;
+    /** Narrower scope for every request of this client (4.3 "Narrower tokens"), when set. */
+    private readonly scope?;
+    constructor(company: CompanyClient, entry?: PoppyProtocolEntry | undefined, options?: {
+        scope?: string | undefined;
+    });
+    private url;
+    /**
+     * POST with retries on network errors / 5xx. Safe because the message ID makes the request
+     * idempotent: the Company returns the original response for a repeat (7.3).
+     */
+    private post;
+    private remember;
+    /** Starts a conversation (7.3), or a Direct Conversation with `parentConversationId` (7.10). */
+    start(message: OutgoingMessage, opts?: {
+        parentConversationId?: string | undefined;
+        wait?: number | undefined;
+        cursor?: string | undefined;
+    }): Promise<StartConversationResponse>;
+    /** Sends another message (7.3). Returns 202 with `status`/`responder` (+ events with `wait`). */
+    send(id: string, message: OutgoingMessage, opts?: {
+        wait?: number | undefined;
+        cursor?: string | undefined;
+    }): Promise<StartConversationResponse>;
+    /** One read of events after `cursor` (7.5). */
+    read(id: string, opts?: {
+        cursor?: string | undefined;
+        wait?: number | undefined;
+    }): Promise<EventsPage>;
+    /** Asks for a person at the Company (7.9). */
+    handoff(id: string): Promise<ConversationState>;
+    /** Closes the conversation (7.12). */
+    close(id: string): Promise<ConversationState>;
+    /**
+     * Reads (long-polling, JSON) until the Company is no longer `working` and `has_more` is
+     * false, returning the new events. Used by the autonomous `ask` mode.
+     */
+    collect(id: string, opts?: {
+        timeoutMs?: number | undefined;
+        wait?: number | undefined;
+    }): Promise<{
+        events: ConversationEvent[];
+        state: ConversationState;
+    }>;
+    /**
+     * Follows a conversation's events in order, from the saved cursor: SSE when the Company
+     * streams (reconnecting with `Last-Event-ID`), long-polling otherwise. Skips event IDs it
+     * already handled, restarts from the beginning on `cursor_expired`, and persists the cursor.
+     */
+    follow(id: string, opts?: FollowOptions): AsyncGenerator<StreamItem>;
+}
+//# sourceMappingURL=conversations.d.ts.map

package/dist/src/poppy-client/conversations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversations.d.ts","sourceRoot":"","sources":["../../../src/poppy-client/conversations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAKlD,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,yBAAyB,EACzB,SAAS,EACV,MAAM,YAAY,CAAC;AAKpB,qFAAqF;AACrF,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,sFAAsF;AACtF,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,kBAAkB,GAAG,SAAS,CAEpF;AAED,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,iBAAiB,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE;AACrC,yFAAyF;GACvF;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE;AACzB,2FAA2F;GACzF;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,CAAC;AAE5B,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACjC,yFAAyF;IACzF,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACnC,sFAAsF;IACtF,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED;;;GAGG;AACH,qBAAa,kBAAkB;IAO3B,QAAQ,CAAC,OAAO,EAAE,aAAa;IANjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAqB;IAC/C,yFAAyF;IACzF,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAqB;IAE5C,YACW,OAAO,EAAE,aAAa,EAC/B,KAAK,GAAE,kBAAkB,GAAG,SAAkC,EAC9D,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAO,EAS7C;IAED,OAAO,CAAC,GAAG;IAaX;;;OAGG;YACW,IAAI;IA+BlB,OAAO,CAAC,QAAQ;IAgBhB,gGAAgG;IAC1F,KAAK,CACT,OAAO,EAAE,eAAe,EACxB,IAAI,GAAE;QACJ,oBAAoB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC1C,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KACxB,GACL,OAAO,CAAC,yBAAyB,CAAC,CAYpC;IAED,iGAAiG;IAC3F,IAAI,CACR,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,eAAe,EACxB,IAAI,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAO,GACpE,OAAO,CAAC,yBAAyB,CAAC,CAOpC;IAED,+CAA+C;IACzC,IAAI,CACR,EAAE,EAAE,MAAM,EACV,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAO,GACpE,OAAO,CAAC,UAAU,CAAC,CASrB;IAED,8CAA8C;IACxC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAEpD;IAED,sCAAsC;IAChC,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAKlD;IAED;;;OAGG;IACG,OAAO,CACX,EAAE,EAAE,MAAM,EACV,IAAI,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAO,GACvE,OAAO,CAAC;QAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;QAAC,KAAK,EAAE,iBAAiB,CAAA;KAAE,CAAC,CA6BpE;IAED;;;;OAIG;IACI,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,cAAc,CAAC,UAAU,CAAC,CA4H9E;CACF"}

package/dist/src/poppy-client/conversations.js

@@ -0,0 +1,332 @@
+import { throwForResponse } from './company.js';
+import { ConversationError, PoppyError } from './errors.js';
+import { readJson } from './http.js';
+import { parseSse } from './sse.js';
+import { randomId, requireSecureUrl, sleep } from './util.js';
+const ID_RE = /^[A-Za-z0-9_-]{1,256}$/;
+/** A fresh message ID: URL-safe base64, prefixed, unique for the User (7.2, 7.3). */
+export function newMessageId() {
+    return randomId('msg_', 12);
+}
+/** Picks the `poppy` conversation protocol entry (7.1); unknown types are skipped. */
+export function poppyProtocol(company) {
+    return company.document.agent?.protocols?.find((p) => p?.type === 'poppy');
+}
+/**
+ * Client for one Company's Poppy conversation endpoint (section 7). Every request carries the
+ * Session Token with a DPoP proof (7.2), through `CompanyClient.fetch`.
+ */
+export class ConversationClient {
+    company;
+    endpoint;
+    resource;
+    /** Narrower scope for every request of this client (4.3 "Narrower tokens"), when set. */
+    scope;
+    constructor(company, entry = poppyProtocol(company), options = {}) {
+        this.company = company;
+        if (!entry)
+            throw new PoppyError('no_conversation_protocol', 'Company lists no `poppy` protocol');
+        this.endpoint = requireSecureUrl(entry.endpoint, 'agent endpoint', company.security)
+            .toString()
+            .replace(/\/+$/, '');
+        this.resource = entry.resource;
+        this.scope = options.scope;
+    }
+    url(id, suffix, query) {
+        if (id !== undefined && !ID_RE.test(id))
+            throw new PoppyError('invalid_id', `bad conversation id ${id}`);
+        const u = new URL(id === undefined ? this.endpoint : `${this.endpoint}/${id}${suffix ?? ''}`);
+        for (const [k, v] of Object.entries(query ?? {}))
+            if (v !== undefined)
+                u.searchParams.set(k, String(v));
+        return u.toString();
+    }
+    /**
+     * POST with retries on network errors / 5xx. Safe because the message ID makes the request
+     * idempotent: the Company returns the original response for a repeat (7.3).
+     */
+    async post(url, body, retries = 2) {
+        let lastErr;
+        for (let attempt = 0; attempt <= retries; attempt++) {
+            try {
+                const res = await this.company.fetch(url, {
+                    method: 'POST',
+                    headers: { 'content-type': 'application/json', accept: 'application/json' },
+                    body: JSON.stringify(body),
+                    resource: this.resource,
+                    scope: this.scope,
+                });
+                if (res.status >= 500 && attempt < retries) {
+                    lastErr = new PoppyError(`http_${res.status}`);
+                    await sleep(300 * (attempt + 1));
+                    continue;
+                }
+                if (!res.ok)
+                    await throwForResponse(res);
+                return { status: res.status, body: (await readJson(res)) };
+            }
+            catch (e) {
+                if (e instanceof PoppyError)
+                    throw e;
+                lastErr = e;
+                if (attempt < retries)
+                    await sleep(300 * (attempt + 1));
+            }
+        }
+        throw lastErr;
+    }
+    remember(id, patch) {
+        const convs = this.company.state.conversations;
+        convs[id] ??= { endpoint: this.endpoint, createdAt: Date.now() };
+        const rec = convs[id];
+        if (patch.cursor !== undefined)
+            rec.cursor = patch.cursor;
+        if (patch.closed !== undefined)
+            rec.closed = patch.closed;
+        if (patch.parent !== undefined)
+            rec.parentConversationId = patch.parent;
+    }
+    /** Starts a conversation (7.3), or a Direct Conversation with `parentConversationId` (7.10). */
+    async start(message, opts = {}) {
+        checkMessage(message);
+        const body = { message };
+        if (opts.parentConversationId)
+            body.parent_conversation_id = opts.parentConversationId;
+        const r = await this.post(this.url(undefined, undefined, { wait: opts.wait, cursor: opts.cursor }), body);
+        if (!r.body?.conversation_id)
+            throw new PoppyError('invalid_response', 'no conversation_id');
+        this.remember(r.body.conversation_id, { parent: opts.parentConversationId });
+        await this.company.save();
+        return r.body;
+    }
+    /** Sends another message (7.3). Returns 202 with `status`/`responder` (+ events with `wait`). */
+    async send(id, message, opts = {}) {
+        checkMessage(message);
+        const r = await this.post(this.url(id, '/messages', { wait: opts.wait, cursor: opts.cursor }), { message });
+        return r.body;
+    }
+    /** One read of events after `cursor` (7.5). */
+    async read(id, opts = {}) {
+        const { body } = await this.company.json(this.url(id, '/events', opts), {
+            headers: { accept: 'application/json' },
+            resource: this.resource,
+            scope: this.scope,
+        });
+        if (!Array.isArray(body?.events))
+            throw new PoppyError('invalid_response', 'events must be a list');
+        return body;
+    }
+    /** Asks for a person at the Company (7.9). */
+    async handoff(id) {
+        return (await this.post(this.url(id, '/handoff'), {})).body;
+    }
+    /** Closes the conversation (7.12). */
+    async close(id) {
+        const r = (await this.post(this.url(id, '/close'), {})).body;
+        this.remember(id, { closed: true });
+        await this.company.save();
+        return r;
+    }
+    /**
+     * Reads (long-polling, JSON) until the Company is no longer `working` and `has_more` is
+     * false, returning the new events. Used by the autonomous `ask` mode.
+     */
+    async collect(id, opts = {}) {
+        const deadline = Date.now() + (opts.timeoutMs ?? 120_000);
+        const events = [];
+        const seen = new Set();
+        let cursor = this.company.state.conversations[id]?.cursor || undefined;
+        for (;;) {
+            let page;
+            try {
+                page = await this.read(id, { cursor, wait: opts.wait ?? 20 });
+            }
+            catch (e) {
+                if (e instanceof ConversationError && e.code === 'cursor_expired') {
+                    cursor = undefined;
+                    continue;
+                }
+                throw e;
+            }
+            for (const ev of page.events) {
+                if (seen.has(ev.id))
+                    continue;
+                seen.add(ev.id);
+                events.push(ev);
+            }
+            if (page.cursor)
+                cursor = page.cursor;
+            this.remember(id, { cursor });
+            await this.company.save();
+            if (page.has_more)
+                continue;
+            if (page.status !== 'working' || Date.now() > deadline) {
+                return { events, state: { status: page.status, responder: page.responder } };
+            }
+        }
+    }
+    /**
+     * Follows a conversation's events in order, from the saved cursor: SSE when the Company
+     * streams (reconnecting with `Last-Event-ID`), long-polling otherwise. Skips event IDs it
+     * already handled, restarts from the beginning on `cursor_expired`, and persists the cursor.
+     */
+    async *follow(id, opts = {}) {
+        const seen = new Set();
+        let cursor = this.company.state.conversations[id]?.cursor;
+        let useStream = opts.stream !== false;
+        let firstConnect = true;
+        let status;
+        const handle = async (ev) => {
+            if (!ev || typeof ev.id !== 'string' || seen.has(ev.id))
+                return false;
+            seen.add(ev.id);
+            cursor = ev.id;
+            this.remember(id, { cursor });
+            if (ev.type === 'state' && ev.status)
+                status = ev.status;
+            return true;
+        };
+        const settled = () => opts.untilSettled && (status === 'idle' || status === 'queued' || status === 'closed');
+        // `untilSettled` ends on a `state` event — but a request that changes nothing (a handoff with
+        // no one available, a context-only message) emits none, and a stream would then wait forever.
+        // So read what is there first: if the conversation is already settled, that is the answer.
+        if (opts.untilSettled) {
+            for (;;) {
+                let page;
+                try {
+                    page = await this.read(id, cursor ? { cursor } : {});
+                }
+                catch (e) {
+                    if (e instanceof ConversationError && e.code === 'cursor_expired') {
+                        cursor = undefined;
+                        this.remember(id, { cursor: '' });
+                        yield { kind: 'history_gap' };
+                        continue;
+                    }
+                    throw e;
+                }
+                for (const ev of page.events) {
+                    if (await handle(ev))
+                        yield { kind: 'event', event: ev };
+                }
+                status = page.status ?? status;
+                if (page.cursor) {
+                    cursor = page.cursor;
+                    this.remember(id, { cursor });
+                }
+                if (!page.has_more)
+                    break;
+            }
+            await this.company.save();
+            if (settled())
+                return;
+        }
+        while (!opts.signal?.aborted) {
+            if (!firstConnect)
+                yield { kind: 'reconnected' };
+            firstConnect = false;
+            let res;
+            try {
+                const headers = {
+                    accept: useStream ? 'text/event-stream' : 'application/json',
+                };
+                // Reconnects carry Last-Event-ID in place of `cursor` (7.6).
+                if (useStream && cursor)
+                    headers['last-event-id'] = cursor;
+                res = await this.company.fetch(this.url(id, '/events', useStream ? {} : { cursor, wait: opts.wait ?? 25 }), { headers, signal: opts.signal, resource: this.resource, scope: this.scope });
+            }
+            catch (e) {
+                if (opts.signal?.aborted)
+                    return;
+                throw e;
+            }
+            if (!res.ok) {
+                const body = await readJson(res.clone());
+                if (body?.error === 'cursor_expired') {
+                    cursor = undefined;
+                    this.remember(id, { cursor: '' });
+                    yield { kind: 'history_gap' };
+                    continue;
+                }
+                await throwForResponse(res);
+            }
+            const type = res.headers.get('content-type') ?? '';
+            if (type.includes('text/event-stream') && res.body) {
+                try {
+                    for await (const sse of parseSse(res.body)) {
+                        if (sse.event === 'text-delta') {
+                            const delta = safeJson(sse.data);
+                            if (delta?.message_id)
+                                yield { kind: 'delta', delta };
+                            continue;
+                        }
+                        if (sse.event !== 'message')
+                            continue; // unknown SSE event names are skipped
+                        const ev = safeJson(sse.data);
+                        if (ev && (await handle(ev))) {
+                            yield { kind: 'event', event: ev };
+                            if (settled()) {
+                                await this.company.save();
+                                return;
+                            }
+                        }
+                    }
+                }
+                catch (e) {
+                    if (opts.signal?.aborted)
+                        return;
+                    this.company.agent.log(`stream interrupted: ${e.message}`);
+                }
+                await this.company.save();
+                if (status === 'closed')
+                    return;
+                await sleep(250, opts.signal).catch(() => { });
+                continue;
+            }
+            // The Company answered with JSON: it doesn't stream, so long-poll from now on (7.6).
+            useStream = false;
+            const page = (await readJson(res));
+            status = page?.status ?? status;
+            for (const ev of page?.events ?? []) {
+                if (await handle(ev))
+                    yield { kind: 'event', event: ev };
+            }
+            if (page?.cursor) {
+                cursor = page.cursor;
+                this.remember(id, { cursor });
+            }
+            await this.company.save();
+            if (page?.has_more) {
+                firstConnect = true; // not a reconnect, just the next page
+                continue;
+            }
+            if (settled() || status === 'closed')
+                return;
+            firstConnect = true;
+        }
+    }
+}
+function safeJson(s) {
+    try {
+        return JSON.parse(s);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** 7.4: `id` + `sender` required, and at least one of `text`, `data`, `context`. */
+function checkMessage(m) {
+    if (!ID_RE.test(m.id))
+        throw new ConversationError('invalid_message', { description: 'bad message id' });
+    if (m.sender !== 'agent' && m.sender !== 'human') {
+        throw new ConversationError('invalid_message', {
+            description: 'sender must be agent or human',
+        });
+    }
+    if (m.text === undefined && m.data === undefined && m.context === undefined) {
+        throw new ConversationError('invalid_message', {
+            description: 'a message needs text, data or context',
+        });
+    }
+}
+//# sourceMappingURL=conversations.js.map

package/dist/src/poppy-client/conversations.js.map

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

package/dist/src/poppy-client/discovery.d.ts

@@ -0,0 +1,41 @@
+import type { AuthServerMetadata, PoppyDocument } from './types.js';
+import { type FetchLike, type SecurityOptions } from './util.js';
+/** Major protocol versions this client implements (3.1). */
+export declare const SUPPORTED_MAJOR_VERSIONS: string[];
+export interface DiscoveryOptions extends SecurityOptions {
+    fetch?: FetchLike | undefined;
+    /** Shared cache honoring `Cache-Control: max-age` (3, 3.2: SHOULD cache). */
+    cache?: HttpJsonCache | undefined;
+}
+export interface Discovered {
+    /** The host the agent asked for (no scheme), e.g. `example.com`. */
+    domain: string;
+    wellKnownUrl: string;
+    document: PoppyDocument;
+    /** Absent only when the Company publishes no `auth` (web-only). */
+    metadata?: AuthServerMetadata | undefined;
+}
+/** In-memory cache of JSON documents by URL, by `Cache-Control: max-age`. */
+export declare class HttpJsonCache {
+    private readonly entries;
+    get(url: string): unknown | undefined;
+    set(url: string, value: unknown, cacheControl: string | null): void;
+}
+/**
+ * Turns user input into the well-known URL. `example.com` → `https://example.com/...`.
+ * With `insecureDev`, an explicit `http://host:port` is kept, and a bare loopback host
+ * (`localhost:3333`) defaults to `http:`.
+ */
+export declare function wellKnownUrlFor(input: string, sec?: SecurityOptions): URL;
+/** Validates `poppy.json` against 3.1. Unknown fields are ignored, never rejected. */
+export declare function validatePoppyDocument(json: unknown, requestedHost: string, sec?: SecurityOptions): PoppyDocument;
+/** RFC 8414 section 3: the well-known suffix goes between the host and the issuer's path. */
+export declare function authServerMetadataUrl(issuer: string): URL;
+/** Validates the issuer metadata against 3.2. */
+export declare function validateMetadata(json: unknown, doc: PoppyDocument, sec?: SecurityOptions): AuthServerMetadata;
+/**
+ * Discovery (section 3): fetches `/.well-known/poppy.json` (HTTPS-only redirects), validates
+ * it, then fetches and validates the issuer's RFC 8414 metadata (3.2).
+ */
+export declare function discover(input: string, opts?: DiscoveryOptions): Promise<Discovered>;
+//# sourceMappingURL=discovery.d.ts.map

package/dist/src/poppy-client/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../src/poppy-client/discovery.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACpE,OAAO,EACL,KAAK,SAAS,EAId,KAAK,eAAe,EACrB,MAAM,WAAW,CAAC;AAEnB,4DAA4D;AAC5D,eAAO,MAAM,wBAAwB,UAAQ,CAAC;AAI9C,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,KAAK,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAC9B,6EAA6E;IAC7E,KAAK,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;CACnC;AAED,MAAM,WAAW,UAAU;IACzB,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,aAAa,CAAC;IACxB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;CAC3C;AAED,6EAA6E;AAC7E,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0D;IAClF,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAQpC;IACD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,QAK3D;CACF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,GAAE,eAAoB,GAAG,GAAG,CAU7E;AA2DD,sFAAsF;AACtF,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,OAAO,EACb,aAAa,EAAE,MAAM,EACrB,GAAG,GAAE,eAAoB,GACxB,aAAa,CAsFf;AAED,6FAA6F;AAC7F,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAIzD;AAED,iDAAiD;AACjD,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,aAAa,EAClB,GAAG,GAAE,eAAoB,GACxB,kBAAkB,CA6BpB;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC,CAc9F"}