@ahpd/server 0.1.0 → 0.3.0

package/dist/listen.js

@@ -1,183 +0,0 @@
-import { createPeer, receive } from './rpc.js';
-/**
- * Accepts WebSocket connections on Node, Bun or Deno.
- *
- * The runtime is detected at startup and the matching server is used: `ws` on
- * Node, which has no WebSocket server of its own, and the built-in servers on
- * Bun and Deno. `ws` is an optional dependency and is imported only on Node.
- *
- * This is the only module that knows which runtime it is on. Supporting
- * another one is a case added here.
- */
-const runtimeOf = () => {
-    const g = globalThis;
-    if (g.Bun !== undefined)
-        return 'bun';
-    if (g.Deno !== undefined)
-        return 'deno';
-    return 'node';
-};
-/**
- * The token a connection presented, if it presented one.
- *
- * Two places, because only one of them always works: a browser cannot set
- * headers on a WebSocket handshake, so the query string is the portable form
- * and the header is for clients that can.
- */
-const presented = (url, authorization) => {
-    const query = /[?&]tkn=([^&]*)/.exec(url ?? '');
-    if (query)
-        return decodeURIComponent(query[1] ?? '');
-    const bearer = /^Bearer\s+(.+)$/i.exec(authorization ?? '');
-    return bearer?.[1];
-};
-/**
- * Compares two secrets without returning early on the first difference.
- *
- * The lengths still differ observably, which is why a token is generated
- * rather than chosen: they are all the same length.
- */
-const same = (a, b) => {
-    if (a.length !== b.length)
-        return false;
-    let differing = 0;
-    for (let i = 0; i < a.length; i++)
-        differing |= a.charCodeAt(i) ^ b.charCodeAt(i);
-    return differing === 0;
-};
-export async function listen(options, onConnect) {
-    const runtime = runtimeOf();
-    const host = options.host ?? '127.0.0.1';
-    const token = options.token;
-    /** Whether this handshake may proceed. No token configured accepts any. */
-    const allowed = (url, authorization) => token === undefined || same(token, presented(url, authorization) ?? '');
-    if (runtime === 'bun') {
-        const Bun = globalThis.Bun;
-        // Per socket, because Bun's handler table is one set of callbacks for
-        // every connection - `ws` is the only thing distinguishing them.
-        const bound = new Map();
-        const server = Bun.serve({
-            port: options.port,
-            hostname: host,
-            fetch(request, server_) {
-                // Refused before the upgrade, so an unauthorised client is told in
-                // HTTP rather than handed a socket that closes on its first message.
-                if (!allowed(request.url, request.headers.get('authorization'))) {
-                    return new Response('A connection token is required', { status: 401 });
-                }
-                if (server_.upgrade(request))
-                    return undefined;
-                return new Response('ahpd speaks the Agent Host Protocol over WebSocket', { status: 426 });
-            },
-            websocket: {
-                open(ws) {
-                    const peer = createPeer({
-                        send: (text) => { ws.send(text); },
-                        close: () => ws.close(),
-                        isOpen: () => ws.readyState === 1,
-                    });
-                    bound.set(ws, { peer, connected: onConnect(peer) });
-                },
-                message(ws, raw) {
-                    const held = bound.get(ws);
-                    if (!held)
-                        return;
-                    const text = typeof raw === 'string' ? raw : new TextDecoder().decode(raw);
-                    receive(text, held.peer, (request) => held.connected.handle(request));
-                },
-                close(ws) {
-                    const held = bound.get(ws);
-                    // The peer first: a question this host asked is still pending, and
-                    // the socket that would have answered it is gone.
-                    held?.peer.close();
-                    held?.connected.close();
-                    bound.delete(ws);
-                },
-            },
-        });
-        return { runtime, host, port: server.port, guarded: token !== undefined, close: () => server.stop(true) };
-    }
-    if (runtime === 'deno') {
-        const Deno = globalThis.Deno;
-        const server = Deno.serve({ port: options.port, hostname: host }, (request) => {
-            if (!allowed(request.url, request.headers.get('authorization'))) {
-                return new Response('A connection token is required', { status: 401 });
-            }
-            if ((request.headers.get('upgrade') ?? '').toLowerCase() !== 'websocket') {
-                return new Response('ahpd speaks the Agent Host Protocol over WebSocket', { status: 426 });
-            }
-            const { socket, response } = Deno.upgradeWebSocket(request);
-            let held;
-            socket.onopen = () => {
-                const peer = createPeer({
-                    send: (text) => { socket.send(text); },
-                    close: () => socket.close(),
-                    isOpen: () => socket.readyState === 1,
-                });
-                held = { peer, connected: onConnect(peer) };
-            };
-            socket.onmessage = (event) => {
-                const open = held;
-                if (!open)
-                    return;
-                receive(String(event.data), open.peer, (request_) => open.connected.handle(request_));
-            };
-            socket.onclose = () => { held?.peer.close(); held?.connected.close(); held = undefined; };
-            return response;
-        });
-        return {
-            runtime,
-            host,
-            port: server.addr.port,
-            guarded: token !== undefined,
-            close: () => server.shutdown(),
-        };
-    }
-    let WebSocketServer;
-    try {
-        ({ WebSocketServer } = await import('ws'));
-    }
-    catch {
-        throw new Error('Running on Node needs the `ws` package, which has no server in the standard library.\n'
-            + '  npm install ws\n'
-            + 'Bun and Deno have one built in and need nothing.');
-    }
-    const server = new WebSocketServer({
-        port: options.port,
-        host,
-        // `ws` answers a rejected handshake with the status this passes back, so
-        // an unauthorised client reads 401 rather than a socket that opened and
-        // then closed for no stated reason.
-        verifyClient: (info, accept) => {
-            if (allowed(info.req.url, info.req.headers.authorization ?? null))
-                accept(true);
-            else
-                accept(false, 401, 'A connection token is required');
-        },
-    });
-    server.on('connection', (socket) => {
-        const peer = createPeer({
-            send: (text) => { socket.send(text); },
-            close: () => socket.close(),
-            isOpen: () => socket.readyState === 1,
-        });
-        const connected = onConnect(peer);
-        socket.on('message', (raw) => {
-            receive(typeof raw === 'string' ? raw : raw.toString('utf8'), peer, (request) => connected.handle(request));
-        });
-        socket.on('close', () => { peer.close(); connected.close(); });
-    });
-    await new Promise((resolve, reject) => {
-        server.once('listening', () => resolve());
-        server.once('error', (error) => reject(error instanceof Error ? error : new Error(String(error))));
-    });
-    return {
-        runtime,
-        host,
-        // What was bound, not what was asked for: port 0 means the OS chooses.
-        port: server.address()?.port ?? options.port,
-        guarded: token !== undefined,
-        close: () => { server.close(); },
-    };
-}
-//# sourceMappingURL=listen.js.map

package/dist/listen.js.map

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

package/dist/paging.d.ts

@@ -1,38 +0,0 @@
-import type { Bag } from './types/common.js';
-import type { Page } from './types/paging.js';
-/**
- * A long list of turns, served a page at a time.
- *
- * Nothing here knows what a turn is beyond it being one of many, which is why
- * it is not in `transcript.ts`: reading a transcript is the backend's, because
- * only the thing that ran the session knows the shape its frames are in.
- * Paging is the host's, and it is the same paging whichever backend produced
- * them.
- */
-/**
- * How many turns a snapshot carries.
- *
- * A session in this directory has eight hundred and fifty turns. Sending them
- * all works and will not keep working: a snapshot is what a client waits for
- * before it can draw anything, and the oldest turns are the ones nobody is
- * looking at.
- */
-export declare const PAGE = 50;
-/**
- * The newest page, and where the rest begins.
- *
- * The cursor is the index of the oldest turn served - opaque to a client, and
- * deliberately so, but it has to mean something here or `fetchTurns` cannot
- * answer twice in a row.
- */
-export declare function tail(turns: Bag[], size?: number): Page;
-/**
- * The page before a cursor, or nothing when the cursor is not one of ours.
- *
- * The protocol requires an unrecognised cursor to be rejected rather than
- * guessed at: a host that quietly returned its newest page for a cursor it
- * did not issue would answer a question about old turns with new ones, and
- * the client would page forever without noticing.
- */
-export declare function older(turns: Bag[], cursor: string, size?: number): Page | undefined;
-//# sourceMappingURL=paging.d.ts.map

package/dist/paging.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"paging.d.ts","sourceRoot":"","sources":["../src/paging.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAE9C;;;;;;;;GAQG;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,IAAI,KAAK,CAAC;AAEvB;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,IAAI,SAAO,GAAG,IAAI,CAMpD;AAED;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,SAAO,GAAG,IAAI,GAAG,SAAS,CASjF"}

package/dist/paging.js

@@ -1,53 +0,0 @@
-/**
- * A long list of turns, served a page at a time.
- *
- * Nothing here knows what a turn is beyond it being one of many, which is why
- * it is not in `transcript.ts`: reading a transcript is the backend's, because
- * only the thing that ran the session knows the shape its frames are in.
- * Paging is the host's, and it is the same paging whichever backend produced
- * them.
- */
-/**
- * How many turns a snapshot carries.
- *
- * A session in this directory has eight hundred and fifty turns. Sending them
- * all works and will not keep working: a snapshot is what a client waits for
- * before it can draw anything, and the oldest turns are the ones nobody is
- * looking at.
- */
-export const PAGE = 50;
-/**
- * The newest page, and where the rest begins.
- *
- * The cursor is the index of the oldest turn served - opaque to a client, and
- * deliberately so, but it has to mean something here or `fetchTurns` cannot
- * answer twice in a row.
- */
-export function tail(turns, size = PAGE) {
-    const start = Math.max(0, turns.length - size);
-    return {
-        turns: turns.slice(start),
-        ...(start > 0 ? { turnsNextCursor: String(start) } : {}),
-    };
-}
-/**
- * The page before a cursor, or nothing when the cursor is not one of ours.
- *
- * The protocol requires an unrecognised cursor to be rejected rather than
- * guessed at: a host that quietly returned its newest page for a cursor it
- * did not issue would answer a question about old turns with new ones, and
- * the client would page forever without noticing.
- */
-export function older(turns, cursor, size = PAGE) {
-    if (!/^\d+$/.test(cursor))
-        return undefined;
-    const at = Number(cursor);
-    if (at <= 0 || at > turns.length)
-        return undefined;
-    const start = Math.max(0, at - size);
-    return {
-        turns: turns.slice(start, at),
-        ...(start > 0 ? { turnsNextCursor: String(start) } : {}),
-    };
-}
-//# sourceMappingURL=paging.js.map

package/dist/paging.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"paging.js","sourceRoot":"","sources":["../src/paging.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AAEH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;AAEvB;;;;;;GAMG;AACH,MAAM,UAAU,IAAI,CAAC,KAAY,EAAE,IAAI,GAAG,IAAI;IAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC/C,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC;QACzB,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACzD,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,KAAK,CAAC,KAAY,EAAE,MAAc,EAAE,IAAI,GAAG,IAAI;IAC7D,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5C,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1B,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IACnD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IACrC,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;QAC7B,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACzD,CAAC;AACJ,CAAC"}

package/dist/paths.d.ts

@@ -1,15 +0,0 @@
-/**
- * Whether a path is a served root or under one.
- *
- * By `relative` rather than by string: `startsWith(root + '/')` is wrong for
- * `/` - it asks whether the path begins `//` and refuses the whole filesystem -
- * and `root === path` alone is wrong for everything else. Three places check
- * this and they used to do it three ways, of which one was exact equality: a
- * host told to serve `/home/you` served that directory and refused every
- * project inside it, which is the only kind of directory anybody opens.
- *
- * Textual, so callers that can resolve symlinks resolve first and pass the
- * real path - `served/link` pointing at `/etc` passes any textual test.
- */
-export declare const within: (root: string, path: string) => boolean;
-//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,MAAM,GAAI,MAAM,MAAM,EAAE,MAAM,MAAM,KAAG,OAGnD,CAAC"}

package/dist/paths.js

@@ -1,19 +0,0 @@
-import { isAbsolute, relative } from 'node:path';
-/**
- * Whether a path is a served root or under one.
- *
- * By `relative` rather than by string: `startsWith(root + '/')` is wrong for
- * `/` - it asks whether the path begins `//` and refuses the whole filesystem -
- * and `root === path` alone is wrong for everything else. Three places check
- * this and they used to do it three ways, of which one was exact equality: a
- * host told to serve `/home/you` served that directory and refused every
- * project inside it, which is the only kind of directory anybody opens.
- *
- * Textual, so callers that can resolve symlinks resolve first and pass the
- * real path - `served/link` pointing at `/etc` passes any textual test.
- */
-export const within = (root, path) => {
-    const step = relative(root, path);
-    return step === '' || (!step.startsWith('..') && !isAbsolute(step));
-};
-//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAEjD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,IAAY,EAAE,IAAY,EAAW,EAAE;IAC5D,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAClC,OAAO,IAAI,KAAK,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;AACtE,CAAC,CAAC"}

package/dist/resources.d.ts

@@ -1,122 +0,0 @@
-import type { Entry, Metadata, Read, ResourceChange, WatchOptions, Watcher, Write } from './types/resources.js';
-import type { ResourceStore } from './types/host.js';
-/** `file:///a/b` and `/a/b` both mean the same path here. */
-export declare const pathOf: (uri: string) => string;
-/** A path, back as the URI a client sends and receives. */
-export declare const uriOf: (path: string) => string;
-/**
- * The real path, if the client may see it.
- *
- * Resolved *before* the check, not after: `served/link` pointing at `/etc`
- * passes a textual test and opens something else entirely. A path that does
- * not exist yet is checked as written, since there is nothing to resolve.
- */
-export declare function allowed(uri: string, roots: string[]): Promise<string>;
-/**
- * The path to write, if the client may write it.
- *
- * Not `allowed`, and the difference is the whole security of the write half.
- * `allowed` resolves the path itself and falls back to the written text when
- * there is nothing there yet - which is right for reading, where a file that
- * does not exist has nothing to hand back either way. For a write it is a
- * hole: `served/link` pointing at `/etc` resolves to nothing for
- * `served/link/passwd`, so the textual test passes and the file is created
- * in `/etc`.
- *
- * So the *parent* is resolved, and the check is on that. A directory that is
- * not there yet is walked up until one is, because `mkdir -p` may be creating
- * several at once and none of them can escape a real ancestor.
- */
-export declare function writable(uri: string, roots: string[]): Promise<string>;
-/** One directory's entries, names only. */
-export declare function list(uri: string, roots: string[]): Promise<Entry[]>;
-/**
- * What a path is, without opening it.
- *
- * `followSymlinks` decides which of the two questions is being asked - what
- * the link points at, or what the link is - and they have different answers
- * for size and type.
- */
-export declare function resolve(uri: string, roots: string[], followSymlinks?: boolean): Promise<Metadata>;
-/**
- * One file's bytes, as text where that is meaningful.
- *
- * The encoding is *reported* rather than assumed by the caller: a client that
- * asked for utf-8 and got a PNG would render the replacement character four
- * hundred thousand times, so anything not recognisably textual comes back
- * base64 whatever was asked for - which the protocol allows for exactly this.
- */
-export declare function read(uri: string, roots: string[], wanted?: string): Promise<Read>;
-/**
- * Paths under `base` that start with what was typed.
- *
- * The typed text is a path fragment, so its last segment is the prefix and
- * everything before it is the directory to look in - which is what makes
- * `@src/ho` complete to `@src/host.ts` rather than looking for a file called
- * `src/ho`.
- */
-export declare function complete(typed: string, base: string, roots: string[], limit?: number): Promise<string[]>;
-/**
- * Write, create or splice one file.
- *
- * The three modes differ in where `position` is rooted, which the protocol is
- * explicit about and which is easy to get subtly wrong: `truncate` and
- * `insert` count from the start of the file and `append` counts *backwards
- * from EOF*, so `append` with `position: 0` is a POSIX append and with
- * `position: 5` splices five bytes before the end.
- *
- * Everything is done on a buffer and written once. A file is not a stream
- * here - the protocol has no chunked write - so reading it, splicing, and
- * putting it back is both the simplest form and the only one that can honour
- * `insert` at all.
- */
-export declare function write(uri: string, roots: string[], content: Write): Promise<void>;
-/**
- * Remove one.
- *
- * A directory needs `recursive`, and a directory without it is refused rather
- * than emptied: the protocol has the flag so that deleting a tree is
- * something a client asked for in as many words.
- */
-export declare function remove(uri: string, roots: string[], recursive?: boolean): Promise<void>;
-/** Make a directory, and the parents it needs. */
-export declare function mkdir(uri: string, roots: string[]): Promise<void>;
-/** Rename, within the served directories on both ends. */
-export declare function move(source: string, destination: string, roots: string[], failIfExists?: boolean): Promise<void>;
-/** Copy, within the served directories on both ends. */
-export declare function copy(source: string, destination: string, roots: string[], failIfExists?: boolean): Promise<void>;
-/**
- * Tell me when that changes.
- *
- * `node:fs.watch`, and the two things about it worth stating. It reports one
- * event per file, so a save that rewrites four files is four events and a
- * `git checkout` is hundreds - hence the window: events are gathered and sent
- * as one batch, which is what the protocol asks a server to do and what keeps
- * a client from redrawing per file.
- *
- * And its event names are not the protocol's, nor even the same across
- * runtimes: creating a file is `rename` on Node and `change` on Deno, which is
- * the sort of thing only running it on both ever tells you. So the name is
- * ignored and the file is *looked at*. Gone is `deleted`. There and created
- * since this watch started is `added`. Anything else is `updated`.
- *
- * `birthtime` rather than an inventory of the tree, because the tree may be a
- * hundred thousand files and the question is only ever asked about the handful
- * that moved. A path already reported as `added` is `updated` from then on, so
- * a file created and then written twice is one appearance and two edits rather
- * than three appearances.
- */
-export declare function watch(uri: string, roots: string[], options: WatchOptions, onChange: (changes: ResourceChange[]) => void): Promise<Watcher>;
-/**
- * The filesystem this process is on, as a host's `ResourceStore`.
- *
- * Kept out of `createHost` so the protocol imports no runtime: this file is
- * the one that touches `node:fs`, and a host that never opens a file never
- * loads it.
- *
- * ```ts
- * createHost({ path, agents, resources: fileResources() });
- * ```
- */
-export declare const fileResources: () => ResourceStore;
-//# sourceMappingURL=resources.d.ts.map

package/dist/resources.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,EAAE,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAChH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAuBrD,6DAA6D;AAC7D,eAAO,MAAM,MAAM,GAAI,KAAK,MAAM,KAAG,MAGpC,CAAC;AAEF,2DAA2D;AAC3D,eAAO,MAAM,KAAK,GAAI,MAAM,MAAM,KAAG,MAA0B,CAAC;AAsBhE;;;;;;GAMG;AACH,wBAAsB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAe3E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAwB5E;AAKD,2CAA2C;AAC3C,wBAAsB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAUzE;AAED;;;;;;GAMG;AACH,wBAAsB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,cAAc,UAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAgBpG;AASD;;;;;;;GAOG;AACH,wBAAsB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAYvF;AAED;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAY1G;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAmDvF;AAED;;;;;;GAMG;AACH,wBAAsB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,SAAS,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAW3F;AAED,kDAAkD;AAClD,wBAAsB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAUvE;AAuBD,0DAA0D;AAC1D,wBAAsB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,YAAY,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAKpH;AAED,wDAAwD;AACxD,wBAAsB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,YAAY,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAWpH;AA6CD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,KAAK,CACzB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,IAAI,GAC5C,OAAO,CAAC,OAAO,CAAC,CAoElB;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,aAAa,QAAO,aAI/B,CAAC"}