@chatlychat/cli 0.2.0 → 0.4.0

package/dist/commands/listen-relay.js

@@ -0,0 +1,434 @@
+/**
+ * `chatly listen --relay` — receive Chatly's SYNCHRONOUS calls on localhost.
+ *
+ * ═══ WHY A LEDGER TAIL CANNOT DO THIS ═════════════════════════════════════
+ *
+ * `listen` and `listen --bot` tail delivery LOGS: the platform has already
+ * made the request, and the CLI replays a copy. Three surfaces have no such
+ * log and could not use one if they did — an AI tool call, a customer-card
+ * fetch and a canvas step. Each is made INSIDE a visitor's request: Chatly
+ * calls the configured URL and waits for the answer, which is the point of
+ * the call (the tool result, the card's content, the next step). A copy that
+ * arrives afterwards is useless, because by then the visitor has been shown
+ * the configured URL's answer, or its timeout.
+ *
+ * So `--relay` opens an outbound session and, while it lives, the server
+ * sends calls for the ids named on the command line to this process instead
+ * of to the configured URL. The CLI forwards each to `--forward-to`, re-signed
+ * (`listen-relay-sign.ts` says why the server does not sign), and posts the
+ * answer back, and the server hands that answer to the waiting caller as if
+ * the configured URL had given it.
+ *
+ * ═══ WHICH HALF OF THIS IS REAL ═══════════════════════════════════════════
+ *
+ * BOTH. The server half is `apps/api/src/modules/relay/` (shipped 2026-10-15),
+ * built against `apps/cli/RELAY-SERVER-SPEC.md`, which stays the contract: if
+ * the two disagree, the spec is right and this is the bug. The wire types are
+ * `@livechat/shared/relay`, and `scripts/check-relay-protocol-parity.mjs`
+ * checks the fields this file reads against them.
+ *
+ * `explainMissingServer` stays anyway. A CLI release reaches users before an
+ * API deploy does, and a 404 on the first request is then the route being
+ * absent, not a typo — it needs a sentence that says nothing was redirected,
+ * rather than a bare "Not Found". (Chatly is a managed service, so there is no
+ * older self-hosted API to blame; the window is the deploy ordering.)
+ *
+ * ═══ WHY LONG-POLL AND NOT A WEBSOCKET ════════════════════════════════════
+ *
+ * The CLI declares one dependency, the published SDK, and runs on Node 20,
+ * which has no WebSocket client without a package. Server-Sent Events would
+ * need a second channel for the answers anyway. A long-poll goes through the
+ * SDK's own transport — auth, retries, typed errors — and its lease semantics
+ * are the teardown rule: a session nobody has polled for 30 seconds is dead.
+ * The poll waits 10 seconds because the SDK's request timeout is 15.
+ *
+ * ═══ THE TWO SAFETY RULES, AND WHERE THEY LIVE ════════════════════════════
+ *
+ *  1. **Explicit ids.** `--tool`, `--card`, `--canvas` — there is no
+ *     "everything" form, because a relay takes PRODUCTION traffic. A frame
+ *     for an id that was not asked for is answered with an error rather than
+ *     forwarded: that would be a server bug routing a stranger's visitor to a
+ *     developer's laptop, and the laptop is the last place it can be stopped.
+ *  2. **10 minutes idle.** Enforced by the server (authoritative) AND here,
+ *     so a forgotten terminal detaches itself and says so. It is not a flag:
+ *     a longer one is how a relay gets forgotten.
+ */
+import { hostname, userInfo } from 'node:os';
+import { ChatlyApiError } from '@chatlychat/sdk-node';
+import { secretFor, selectedFor, relayTargetUrl, readFrames, } from './listen-relay-options.js';
+import { RELAY_OWNED_HEADERS, signRelayedRequest } from './listen-relay-sign.js';
+import { printJson } from '../output.js';
+export { parseRelayOptions, readFrames, relayOnlyFlagWithoutRelay, relayTargetUrl, } from './listen-relay-options.js';
+/** Detach after this long with no frame. See the header, rule 2. */
+export const RELAY_IDLE_TIMEOUT_MS = 10 * 60_000;
+/** Long-poll wait. Under the SDK transport's 15s request timeout. */
+export const RELAY_POLL_WAIT_SECONDS = 10;
+/** A local answer larger than this is refused rather than relayed. */
+export const RELAY_MAX_RESPONSE_BYTES = 1_048_576;
+/** The protocol version this CLI speaks, sent on attach. */
+export const RELAY_PROTOCOL_VERSION = 1;
+/**
+ * `relayAnswerSchema` caps an error answer's `message` at 2,000 characters.
+ * An `unreachable` message embeds the OS error and the URL, so a long one is
+ * possible — and over the cap the server answers 422, the answer is never
+ * recorded, and the visitor waits out the whole deadline instead of failing
+ * fast. Clamped here rather than trusting the message to be short.
+ */
+const MAX_ERROR_MESSAGE_CHARS = 2_000;
+/** Backoff ceiling for a poll that failed to reach the server. */
+const MAX_BACKOFF_MS = 8_000;
+/** The forward leg of `answerFrame`, before the message cap is applied. */
+async function answerFrameUnclamped(opts, deps, frame, signal) {
+    const started = deps.now();
+    const elapsed = () => Math.max(0, deps.now() - started);
+    if (!selectedFor(opts, frame.kind).includes(frame.targetId)) {
+        return {
+            error: 'not_selected',
+            message: `this relay did not ask for ${frame.kind} ${frame.targetId}`,
+            durationMs: 0,
+        };
+    }
+    const url = relayTargetUrl(opts.forwardTo, frame.path);
+    const headers = {};
+    for (const [name, value] of Object.entries(frame.headers)) {
+        if (!RELAY_OWNED_HEADERS.has(name.toLowerCase())) {
+            headers[name.toLowerCase()] = value;
+        }
+    }
+    // Not a header Chatly sends; see listen-core.ts.
+    headers['x-chatly-cli-forwarded'] = '1';
+    const secret = secretFor(opts, frame.targetId);
+    if (secret !== null) {
+        const signed = signRelayedRequest({
+            kind: frame.kind,
+            method: frame.method,
+            targetUrl: url,
+            body: frame.body,
+            secret,
+            nowMs: deps.now(),
+        });
+        if (!signed.ok) {
+            return {
+                error: 'signing_failed',
+                message: `the signature chatly listen minted does not verify (${signed.message})`,
+                durationMs: 0,
+            };
+        }
+        Object.assign(headers, signed.headers);
+    }
+    // Abort at the caller's deadline: after it, nobody is waiting for this.
+    const budget = Date.parse(frame.deadlineAt) - deps.now();
+    const ctrl = new AbortController();
+    const onAbort = () => {
+        ctrl.abort();
+    };
+    signal.addEventListener('abort', onAbort, { once: true });
+    let timedOut = false;
+    const timer = setTimeout(() => {
+        timedOut = true;
+        ctrl.abort();
+    }, Math.max(0, budget));
+    try {
+        const method = frame.method.toUpperCase();
+        const res = await deps.fetchFn(url, {
+            method,
+            headers,
+            ...(method === 'GET' || method === 'HEAD' ? {} : { body: frame.body }),
+            signal: ctrl.signal,
+        });
+        const text = await res.text();
+        if (Buffer.byteLength(text, 'utf8') > RELAY_MAX_RESPONSE_BYTES) {
+            return {
+                error: 'too_large',
+                message: `your handler answered more than ${String(RELAY_MAX_RESPONSE_BYTES)} bytes`,
+                durationMs: elapsed(),
+            };
+        }
+        const contentType = res.headers.get('content-type');
+        return {
+            status: res.status,
+            headers: contentType === null ? {} : { 'content-type': contentType },
+            body: text,
+            durationMs: elapsed(),
+        };
+    }
+    catch (err) {
+        if (timedOut) {
+            return {
+                error: 'timeout',
+                message: `${url} did not answer before the caller's deadline (${frame.deadlineAt})`,
+                durationMs: elapsed(),
+            };
+        }
+        if (signal.aborted) {
+            return { error: 'interrupted', message: 'the relay was stopped', durationMs: elapsed() };
+        }
+        return {
+            error: 'unreachable',
+            message: `${url} unreachable: ${err instanceof Error ? err.message : String(err)}`,
+            durationMs: elapsed(),
+        };
+    }
+    finally {
+        clearTimeout(timer);
+        signal.removeEventListener('abort', onAbort);
+    }
+}
+/**
+ * Forward one frame to localhost and build the answer. Never throws: every
+ * failure is an answer, because the server is holding a visitor's request
+ * open until it gets one.
+ */
+export async function answerFrame(opts, deps, frame, signal) {
+    const answer = await answerFrameUnclamped(opts, deps, frame, signal);
+    return 'error' in answer && answer.message.length > MAX_ERROR_MESSAGE_CHARS
+        ? { ...answer, message: `${answer.message.slice(0, MAX_ERROR_MESSAGE_CHARS - 1)}…` }
+        : answer;
+}
+/** A promise that settles to `null` on abort, so Ctrl-C does not wait out a long-poll. */
+function raceAbort(p, signal) {
+    if (signal.aborted) {
+        p.catch(() => undefined);
+        return Promise.resolve(null);
+    }
+    return new Promise((resolve, reject) => {
+        const onAbort = () => {
+            resolve(null);
+        };
+        signal.addEventListener('abort', onAbort, { once: true });
+        p.then((v) => {
+            signal.removeEventListener('abort', onAbort);
+            resolve(v);
+        }, (e) => {
+            signal.removeEventListener('abort', onAbort);
+            reject(e instanceof Error ? e : new Error(String(e)));
+        });
+    });
+}
+/** `relay_ended_<reason>` → `<reason>`, per RELAY-SERVER-SPEC.md §4. */
+function endReasonFromCode(code) {
+    return code !== null && code.startsWith('relay_ended_')
+        ? code.slice('relay_ended_'.length)
+        : 'ended';
+}
+/**
+ * The 404 a server without this feature answers, as a sentence.
+ *
+ * Exported for the spec. A CLI released ahead of the API deploy gets this, so
+ * it has to say plainly that the route is missing rather than that the user
+ * typed something wrong.
+ */
+export function explainMissingServer(err) {
+    /*
+     * 404 can only mean the ROUTE: the spec answers an unknown target id with
+     * 422 `relay_target_not_found`, precisely so this branch cannot mistake a
+     * typo'd id for a missing feature (RELAY-SERVER-SPEC.md §3.1).
+     */
+    if (err instanceof ChatlyApiError && (err.status === 404 || err.status === 405)) {
+        return new Error('This Chatly API has no relay route (POST /v1/relay-sessions answered ' +
+            `${String(err.status)}). This API has not been deployed with the relay yet, or ` +
+            'this CLI is newer than the API it talks to. Tool calls, card fetches and canvas steps still go to their configured ' +
+            'URLs — nothing was redirected.');
+    }
+    return null;
+}
+function attachLabel() {
+    // `userInfo()` throws when the uid has no passwd entry (some containers).
+    let user = 'unknown';
+    try {
+        user = userInfo().username;
+    }
+    catch {
+        user = 'unknown';
+    }
+    return `chatly-cli ${user}@${hostname()}`;
+}
+function readSession(value) {
+    const r = (typeof value === 'object' && value !== null ? value : {});
+    if (typeof r['id'] !== 'string') {
+        throw new Error('POST /v1/relay-sessions answered without a session id; refusing to poll.');
+    }
+    const by = (typeof r['attachedBy'] === 'object' && r['attachedBy'] !== null ? r['attachedBy'] : {});
+    const who = typeof by['displayName'] === 'string' ? by['displayName'] : 'this API key';
+    return { id: r['id'], attachedBy: who };
+}
+function banner(opts, session, deps) {
+    deps.out(`Relay ${session.id} attached as ${session.attachedBy}.`);
+    deps.out('PRODUCTION calls for these targets now come to this terminal instead of their URLs:');
+    for (const id of opts.tools) {
+        deps.out(`  tool    ${id}`);
+    }
+    for (const id of opts.cards) {
+        deps.out(`  card    ${id}`);
+    }
+    for (const id of opts.canvases) {
+        deps.out(`  canvas  ${id}  (channel)`);
+    }
+    deps.out(`Forwarding to ${opts.forwardTo} (each call's own path is appended).`);
+    const unsigned = [...opts.tools, ...opts.cards, ...opts.canvases].filter((id) => secretFor(opts, id) === null);
+    if (unsigned.length > 0) {
+        deps.out(`UNSIGNED for ${unsigned.join(', ')}: no --secret, so your handler's verifier will ` +
+            'reject those calls and the visitor will see the failure.');
+    }
+    deps.out('The dashboard shows a banner while this is attached. Detaches after 10 minutes with no ' +
+        'call, or on Ctrl-C.\n');
+}
+/**
+ * The relay loop. Exported for the spec, bounded by `deps.maxPolls` there.
+ *
+ * Frames are answered CONCURRENTLY: each one has its own caller waiting with
+ * its own deadline, and a slow tool call must not make a card fetch behind it
+ * time out.
+ */
+export async function relay(chatly, opts, deps) {
+    let created;
+    try {
+        created = await chatly.request('POST', '/v1/relay-sessions', {
+            body: {
+                protocol: RELAY_PROTOCOL_VERSION,
+                targets: { tools: opts.tools, customerCards: opts.cards, canvasChannels: opts.canvases },
+                idleTimeoutSeconds: RELAY_IDLE_TIMEOUT_MS / 1000,
+                label: attachLabel(),
+            },
+        });
+    }
+    catch (err) {
+        throw explainMissingServer(err) ?? err;
+    }
+    const session = readSession(created);
+    banner(opts, session, deps);
+    const base = `/v1/relay-sessions/${encodeURIComponent(session.id)}`;
+    const forwards = new AbortController();
+    const stopForwards = () => {
+        forwards.abort();
+    };
+    deps.signal.addEventListener('abort', stopForwards, { once: true });
+    const inflight = new Set();
+    let frames = 0;
+    let answered = 0;
+    let failed = 0;
+    let polls = 0;
+    let failures = 0;
+    let lastActivity = deps.now();
+    let endReason = 'interrupted';
+    let endedByServer = false;
+    const handle = async (frame) => {
+        const answer = await answerFrame(opts, deps, frame, forwards.signal);
+        const line = 'error' in answer
+            ? `   ↳ ${answer.error}: ${answer.message}`
+            : `   ↳ ${String(answer.status)} in ${String(answer.durationMs)}ms`;
+        if ('error' in answer) {
+            failed += 1;
+            deps.err(`${line}\n`);
+        }
+        else {
+            // A 4xx/5xx from the handler is still an ANSWER: it is relayed, and the
+            // surface treats it exactly as it treats one from the configured url.
+            answered += 1;
+            if (answer.status >= 400) {
+                deps.err(`${line}\n`);
+            }
+            else {
+                deps.out(line);
+            }
+        }
+        try {
+            await chatly.request('POST', `${base}/frames/${encodeURIComponent(frame.id)}/response`, {
+                body: answer,
+            });
+        }
+        catch (err) {
+            // 410: the deadline passed or the session ended first. The caller has
+            // already been answered with the surface's own timeout.
+            const why = err instanceof ChatlyApiError ? `${String(err.status)} ${err.code ?? ''}` : String(err);
+            deps.err(`   ↳ the answer to ${frame.id} was not accepted (${why.trim()})\n`);
+        }
+    };
+    try {
+        for (;;) {
+            if (deps.signal.aborted) {
+                endReason = 'interrupted';
+                break;
+            }
+            if (deps.maxPolls !== undefined && polls >= deps.maxPolls) {
+                endReason = 'max_polls';
+                break;
+            }
+            if (deps.now() - lastActivity >= RELAY_IDLE_TIMEOUT_MS) {
+                endReason = 'idle';
+                deps.out('No call for 10 minutes; detaching so this relay cannot be forgotten.');
+                break;
+            }
+            polls += 1;
+            let page;
+            try {
+                page = await raceAbort(chatly.request('GET', `${base}/frames`, {
+                    query: { waitSeconds: RELAY_POLL_WAIT_SECONDS },
+                }), deps.signal);
+            }
+            catch (err) {
+                if (err instanceof ChatlyApiError && (err.status === 410 || err.status === 404)) {
+                    endedByServer = true;
+                    endReason = err.status === 404 ? 'not_found' : endReasonFromCode(err.code);
+                    deps.err(`The server ended this relay (${endReason}).\n`);
+                    break;
+                }
+                /*
+                 * Network or 5xx after the SDK's own retries. Keep trying, with
+                 * backoff: if this outlasts the server's 30s lease the session is
+                 * torn down there and the next successful poll answers 410, which is
+                 * the exit. The CLI does not guess the lease itself.
+                 */
+                failures += 1;
+                deps.err(`poll failed (${err instanceof Error ? err.message : String(err)}); retrying. ` +
+                    'Calls for these targets fail until it recovers.\n');
+                await deps.sleep(Math.min(MAX_BACKOFF_MS, 500 * 2 ** (failures - 1)), deps.signal);
+                continue;
+            }
+            if (page === null) {
+                continue; // aborted mid-poll; the top of the loop sees it
+            }
+            failures = 0;
+            const { frames: fresh, unreadable } = readFrames(page);
+            if (unreadable > 0) {
+                deps.err(`${String(unreadable)} frame(s) this CLI could not read and could not answer — a newer ` +
+                    'server protocol than this CLI speaks? Upgrade @chatlychat/cli.\n');
+            }
+            for (const frame of fresh) {
+                frames += 1;
+                lastActivity = deps.now();
+                if (opts.json) {
+                    printJson(frame);
+                }
+                else {
+                    deps.out(`${frame.kind}  ${frame.targetId}  ${frame.method.toUpperCase()} ${frame.path}  ${frame.id}`);
+                }
+                const p = handle(frame).finally(() => {
+                    inflight.delete(p);
+                });
+                inflight.add(p);
+            }
+        }
+    }
+    finally {
+        deps.signal.removeEventListener('abort', stopForwards);
+        /*
+         * In-flight forwards are NOT aborted on a graceful end (idle, the server
+         * ending it): each has a caller waiting with its own deadline, and an
+         * answer that arrives is better than an `interrupted` one. Ctrl-C aborts
+         * them through `stopForwards`, which is the developer asking.
+         */
+        await Promise.allSettled([...inflight]);
+        if (!endedByServer) {
+            // Best effort: the server's lease tears it down anyway if this fails.
+            try {
+                await chatly.request('DELETE', base);
+            }
+            catch {
+                deps.err('Could not detach cleanly; the server will drop the relay within 30s.\n');
+            }
+        }
+    }
+    return { frames, answered, failed, polls, endReason };
+}
+//# sourceMappingURL=listen-relay.js.map

package/dist/commands/listen-relay.js.map

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

package/dist/commands/listen.d.ts

@@ -1,44 +1,7 @@
+import { type ListenDeps, type ListenOptions, type ListenSummary } from './listen-core.js';
 import { type ParsedArgs } from '../args.js';
 import type { ChatlyClient } from '@chatlychat/sdk-node';
-export interface ListenOptions {
-    /** Where to POST each event. `null` prints without forwarding. */
-    readonly forwardTo: string | null;
-    readonly endpointId: string | null;
-    /** Client-side event filter. `null` means every event in the log. */
-    readonly events: ReadonlySet<string> | null;
-    readonly status: string | null;
-    /** The `whsec_…` to re-sign forwarded requests with. `null` sends unsigned. */
-    readonly secret: string | null;
-    readonly intervalMs: number;
-    /** How many deliveries already in the log to forward before tailing. */
-    readonly replay: number;
-    /** Rows per poll. Also the most this can see between two polls. */
-    readonly pageLimit: number;
-    readonly json: boolean;
-}
-export interface ListenDeps {
-    /** For the FORWARD leg only. API calls go through the SDK's own transport. */
-    readonly fetchFn: typeof fetch;
-    readonly now: () => number;
-    readonly sleep: (ms: number, signal: AbortSignal) => Promise<void>;
-    readonly signal: AbortSignal;
-    readonly out: (line: string) => void;
-    readonly err: (line: string) => void;
-    /**
-     * Stop after this many polls. Test-only, and the reason it exists rather
-     * than a timer the test races: a tail loop with no bound is not a thing a
-     * unit test can assert the end of.
-     */
-    readonly maxPolls?: number;
-}
-export interface ListenSummary {
-    readonly seen: number;
-    readonly forwarded: number;
-    readonly refused: number;
-    readonly polls: number;
-}
-/** Read the flags, refusing anything that cannot work, with the fix named. */
-export declare function parseListenOptions(args: ParsedArgs): ListenOptions;
+export { parseListenOptions, type ListenDeps, type ListenOptions, type ListenSummary, } from './listen-core.js';
 /**
  * The tail loop, abortable, with the process boundary left to the caller.
  *

package/dist/commands/listen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"listen.d.ts","sourceRoot":"","sources":["../../src/commands/listen.ts"],"names":[],"mappings":"AA6EA,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AA4BzD,MAAM,WAAW,aAAa;IAC5B,kEAAkE;IAClE,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,qEAAqE;IACrE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,wEAAwE;IACxE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,mEAAmE;IACnE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,EAAE,OAAO,KAAK,CAAC;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAyCD,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,aAAa,CAsElE;AAyLD;;;;;GAKG;AACH,wBAAsB,IAAI,CACxB,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,aAAa,EACnB,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,aAAa,CAAC,CA2HxB;AAqBD;;;;;;GAMG;AACH,wBAAsB,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAmCpF"}
+{"version":3,"file":"listen.d.ts","sourceRoot":"","sources":["../../src/commands/listen.ts"],"names":[],"mappings":"AAsFA,OAAO,EAML,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,aAAa,EACnB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAQ,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAGnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,OAAO,EACL,kBAAkB,EAClB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,kBAAkB,CAAC;AA6H1B;;;;;GAKG;AACH,wBAAsB,IAAI,CACxB,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,aAAa,EACnB,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,aAAa,CAAC,CAoIxB;AAED;;;;;;GAMG;AACH,wBAAsB,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAgEpF"}