@kdonev/termscape 0.1.0

package/dist/server.js

@@ -0,0 +1,438 @@
+import { randomUUID } from 'node:crypto';
+import { existsSync } from 'node:fs';
+import { dirname, join, sep } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import Fastify from 'fastify';
+import websocket from '@fastify/websocket';
+import fastifyStatic from '@fastify/static';
+import { ClientMsg, BinaryFrameKind, decodeBinaryFrame, encodeBinaryFrame, } from './protocol/index.js';
+import { HUB_VERSION } from './hub.js';
+import { createPeerServer } from './remote/peer-serve.js';
+import { registerEnrollment } from './remote/enroll.js';
+import { advertisedHost, coversLoopback, preferredHostname, urlHost, } from './remote/lan.js';
+import { buildMcpServer, buildMcpTransport } from './mcp/server.js';
+/**
+ * Ports to try before falling back to whatever the OS hands out.
+ *
+ * The join page is the one URL someone has to type by hand, on a different
+ * machine, from memory — it carries no token precisely so it can be typed. A
+ * five-digit ephemeral port makes that miserable, so prefer something a person
+ * can hold in their head.
+ *
+ * Ordered by memorability, skipping ports that common dev tooling squats on:
+ * 3000/8000/8080 (everything), 5555 (adb), 8888 (Jupyter), 2222 (alt ssh).
+ */
+export const MEMORABLE_PORTS = [7777, 4242, 7333, 3333, 9999, 7070, 4040, 1212];
+/**
+ * Locate the built web assets relative to this file, if they exist.
+ *
+ * Two layouts have to work. In the monorepo the hub runs from
+ * `packages/hub/dist/` and the UI is its sibling at `packages/web/dist`. In the
+ * published package there are no siblings: the UI is copied to `web/` beside
+ * `dist/`, because npm ships one package and a relative walk out of it would
+ * land in whatever the user happens to have installed next door.
+ */
+function webRoot() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const candidates = [
+        // Published layout: <pkg>/dist/server.js -> <pkg>/web
+        join(here, '..', 'web'),
+        join(here, '..', '..', 'web', 'dist'),
+        join(here, '..', '..', '..', 'web', 'dist'),
+    ];
+    return candidates.find((p) => existsSync(p)) ?? null;
+}
+export async function serve(opts) {
+    const { hub, clientToken } = opts;
+    const app = Fastify({ logger: false });
+    await app.register(websocket, {
+        options: { maxPayload: 8 * 1024 * 1024 },
+    });
+    /* ------------------------------------------------------------- health */
+    app.get('/health', async () => ({
+        ok: true,
+        hubVersion: HUB_VERSION,
+        pid: process.pid,
+    }));
+    /* -------------------------------------------------------------- hooks */
+    /**
+     * Agent CLIs POST here at turn boundaries. The path carries the agent's own
+     * bearer token, which is also how we know which window changed state.
+     */
+    app.post('/hook/:token', async (req, reply) => {
+        const sessionId = hub.tokens.resolve(req.params.token);
+        if (!sessionId)
+            return reply.code(404).send({ ok: false });
+        const event = req.query.event === 'idle' ? 'idle' : 'busy';
+        hub.sessions.setStatusFromHook(sessionId, event);
+        return { ok: true };
+    });
+    /* ---------------------------------------------------------------- MCP */
+    app.all('/mcp', async (req, reply) => {
+        const auth = req.headers.authorization ?? '';
+        const token = auth.startsWith('Bearer ') ? auth.slice(7) : '';
+        const sessionId = token ? hub.tokens.resolve(token) : null;
+        if (!sessionId) {
+            return reply.code(401).send({
+                jsonrpc: '2.0',
+                error: { code: -32001, message: 'unauthorized' },
+                id: null,
+            });
+        }
+        // Stateless: a fresh server + transport per request, bound to this caller.
+        const server = buildMcpServer(sessionId, hub);
+        const transport = buildMcpTransport();
+        reply.raw.on('close', () => {
+            void transport.close();
+            void server.close();
+        });
+        await server.connect(transport);
+        await transport.handleRequest(req.raw, reply.raw, req.body);
+        return reply;
+    });
+    /* --------------------------------------------------------- peer (hub↔hub) */
+    /**
+     * The answering half of the hub-to-hub link. A hub deployed over SSH serves
+     * this and the canvas-owning hub dials it through the tunnel, so on that
+     * path the endpoint is only ever reachable over loopback on the remote
+     * machine. The logic lives in peer-serve.ts because a hub that enrolled
+     * itself runs the identical thing over a socket it dialled out instead.
+     */
+    const peerServer = createPeerServer(hub, clientToken);
+    // It is also this hub's link back to whatever canvas it was attached to.
+    // On a hub that owns its own canvas nothing ever attaches, and the uplink
+    // reports itself as detached forever.
+    hub.setUplink(peerServer);
+    app.get('/peer', { websocket: true }, (socket) => {
+        peerServer.serve(socket);
+    });
+    /* --------------------------------------------------------------- join */
+    // The bind address is not known until listen() resolves, so the enroll
+    // routes read it through a closure rather than a captured value.
+    let enrollOrigin = null;
+    let enrollAltOrigin = null;
+    const enrollment = registerEnrollment(app, { hub, enrollOrigin: () => enrollOrigin });
+    /* ---------------------------------------------------------- WebSocket */
+    const clients = new Set();
+    const send = (ws, msg) => {
+        if (ws.readyState === ws.OPEN)
+            ws.send(JSON.stringify(msg));
+    };
+    const broadcast = (msg) => {
+        for (const ws of clients)
+            send(ws, msg);
+    };
+    const snapshotState = () => ({
+        hubVersion: HUB_VERSION,
+        enrollUrl: enrollOrigin ? `${enrollOrigin}/join` : null,
+        enrollAltUrl: enrollAltOrigin ? `${enrollAltOrigin}/join` : null,
+        hosts: hub.store.listHosts(),
+        workspaces: hub.store.listWorkspaces(),
+        sessions: hub.allSessions(),
+        messages: hub.messages(),
+        viewport: hub.store.getViewport(),
+        profiles: hub.profiles.list().map((p) => ({
+            id: p.id,
+            description: p.description,
+            mcp: p.mcp,
+            resumable: !!p.resumeArgs,
+        })),
+    });
+    hub.on('session', (s) => broadcast({ t: 'sessionUpserted', session: s }));
+    hub.on('removed', (id) => broadcast({ t: 'sessionRemoved', sessionId: id }));
+    hub.on('workspace', (w) => broadcast({ t: 'workspaceUpserted', workspace: w }));
+    hub.on('workspaceRemoved', (id) => broadcast({ t: 'workspaceRemoved', workspaceId: id }));
+    hub.on('message', (m) => broadcast({ t: 'messageSent', message: m }));
+    hub.on('host', (h) => broadcast({ t: 'hostUpserted', host: h }));
+    hub.on('hostRemoved', (id) => broadcast({ t: 'hostRemoved', hostId: id }));
+    // Deploy progress. Installing on a remote can take minutes; the panel shows
+    // these lines so it is not a frozen button.
+    hub.on('hostLog', (hostId, line) => broadcast({ t: 'hostLog', hostId, line }));
+    // A peer connecting, dropping, or resyncing changes many sessions at
+    // once, so push the whole list rather than diffing it here.
+    hub.on('peersChanged', () => {
+        for (const s of hub.peers.sessions())
+            broadcast({ t: 'sessionUpserted', session: s });
+    });
+    // Terminal output goes only to clients that have attached to that window,
+    // so a canvas showing 20 terminals zoomed out is not paying for 20 streams.
+    const attached = new Map();
+    hub.on('data', (sessionId, chunk) => {
+        const frame = encodeBinaryFrame(BinaryFrameKind.PtyOutput, sessionId, Buffer.from(chunk, 'utf8'));
+        for (const ws of clients) {
+            if (attached.get(ws)?.has(sessionId) && ws.readyState === ws.OPEN)
+                ws.send(frame);
+        }
+    });
+    app.get('/ws', { websocket: true }, (socket) => {
+        let authed = false;
+        clients.add(socket);
+        attached.set(socket, new Set());
+        socket.on('message', (raw, isBinary) => {
+            try {
+                if (isBinary) {
+                    if (!authed)
+                        return;
+                    const f = decodeBinaryFrame(new Uint8Array(raw));
+                    if (f.kind === BinaryFrameKind.PtyInput) {
+                        const data = Buffer.from(f.payload).toString('utf8');
+                        const remote = hub.peers.find(f.sessionId);
+                        if (remote) {
+                            // Typing into a remote terminal whose PTY has since exited is
+                            // ordinary, and the peer says so by rejecting. Unhandled, that
+                            // rejection reaches the process and takes the whole canvas with
+                            // it — so it is reported to this browser and goes no further.
+                            void remote.peer
+                                .request({ t: 'input', id: randomUUID(), address: f.sessionId, data })
+                                .catch((e) => send(socket, { t: 'error', message: e.message, sessionId: f.sessionId }));
+                        }
+                        else {
+                            hub.sessions.write(f.sessionId, data);
+                        }
+                    }
+                    return;
+                }
+                const parsed = ClientMsg.safeParse(JSON.parse(raw.toString('utf8')));
+                if (!parsed.success) {
+                    send(socket, { t: 'error', message: 'malformed message' });
+                    return;
+                }
+                const msg = parsed.data;
+                if (!authed) {
+                    if (msg.t !== 'hello' || msg.token !== clientToken) {
+                        send(socket, { t: 'error', message: 'unauthorized' });
+                        socket.close();
+                        return;
+                    }
+                    authed = true;
+                    send(socket, { t: 'ready', state: snapshotState() });
+                    return;
+                }
+                void handleClientMsg(socket, msg);
+            }
+            catch (err) {
+                send(socket, { t: 'error', message: err.message });
+            }
+        });
+        socket.on('close', () => {
+            clients.delete(socket);
+            attached.delete(socket);
+        });
+    });
+    async function handleClientMsg(socket, msg) {
+        try {
+            switch (msg.t) {
+                case 'hello':
+                    return;
+                // Remote sessions are keyed by their address, so a single lookup
+                // decides whether a request is served locally or forwarded to a peer.
+                case 'attach': {
+                    attached.get(socket)?.add(msg.sessionId);
+                    const remote = hub.peers.find(msg.sessionId);
+                    if (remote) {
+                        await remote.peer.attach(msg.sessionId);
+                        return;
+                    }
+                    const snap = hub.sessions.snapshotForAttach(msg.sessionId);
+                    if (snap) {
+                        send(socket, {
+                            t: 'snapshot',
+                            sessionId: msg.sessionId,
+                            serialized: snap.serialized,
+                            cols: snap.cols,
+                            rows: snap.rows,
+                        });
+                    }
+                    return;
+                }
+                case 'detach': {
+                    attached.get(socket)?.delete(msg.sessionId);
+                    const remote = hub.peers.find(msg.sessionId);
+                    if (remote)
+                        await remote.peer.detach(msg.sessionId);
+                    return;
+                }
+                case 'resize': {
+                    const remote = hub.peers.find(msg.sessionId);
+                    if (remote) {
+                        await remote.peer.request({
+                            t: 'resize',
+                            id: randomUUID(),
+                            address: msg.sessionId,
+                            cols: msg.cols,
+                            rows: msg.rows,
+                        });
+                        return;
+                    }
+                    hub.sessions.resize(msg.sessionId, msg.cols, msg.rows);
+                    return;
+                }
+                case 'createWorkspace':
+                    hub.createWorkspace(msg.name, msg.rootPath, msg.hostId ?? null);
+                    return;
+                case 'removeWorkspace':
+                    await hub.removeWorkspace(msg.workspaceId);
+                    return;
+                case 'startSession':
+                    await hub.startSession({
+                        workspaceId: msg.workspaceId,
+                        profile: msg.profile,
+                        name: msg.name,
+                        cwd: msg.cwd,
+                    });
+                    return;
+                case 'stopSession': {
+                    const remote = hub.peers.find(msg.sessionId);
+                    if (remote) {
+                        await remote.peer.request({ t: 'stopSession', id: randomUUID(), address: msg.sessionId });
+                        return;
+                    }
+                    hub.sessions.stop(msg.sessionId);
+                    return;
+                }
+                case 'removeSession':
+                    // A remote window's session belongs to its peer. Removing it here
+                    // would delete nothing and merely hide the window until that peer
+                    // reported it again.
+                    if (await hub.peers.removeSession(msg.sessionId))
+                        return;
+                    hub.sessions.remove(msg.sessionId);
+                    return;
+                case 'resumeSession': {
+                    const remote = hub.peers.find(msg.sessionId);
+                    if (remote) {
+                        await remote.peer.request({ t: 'resumeSession', id: randomUUID(), address: msg.sessionId });
+                        return;
+                    }
+                    await hub.sessions.resume(msg.sessionId);
+                    return;
+                }
+                case 'resumeWorkspace':
+                    await hub.resumeWorkspace(msg.workspaceId);
+                    return;
+                case 'moveWindow':
+                    // Layout is always local, even for a peer's session.
+                    if (!hub.peers.saveLayout(msg.sessionId, msg.rect)) {
+                        hub.moveWindow(msg.sessionId, msg.rect);
+                    }
+                    return;
+                case 'setViewport':
+                    hub.setViewport(msg.viewport);
+                    return;
+                case 'addHost': {
+                    const host = hub.addHost(msg);
+                    // Connect immediately: adding a host the user then has to connect
+                    // by hand is a pointless second step.
+                    void hub.connectHost(host.id).catch((e) => send(socket, { t: 'error', message: `connect ${host.label}: ${e.message}` }));
+                    return;
+                }
+                case 'removeHost':
+                    await hub.removeHost(msg.hostId);
+                    return;
+                case 'connectHost':
+                    await hub.connectHost(msg.hostId);
+                    return;
+                default:
+                    send(socket, { t: 'error', message: `unhandled: ${msg.t}` });
+            }
+        }
+        catch (err) {
+            send(socket, { t: 'error', message: err.message });
+        }
+    }
+    /* ------------------------------------------------------------- static */
+    if (!opts.headless) {
+        const root = webRoot();
+        if (root) {
+            await app.register(fastifyStatic, {
+                root,
+                wildcard: false,
+                // Asset filenames are content-hashed by vite, so they may be cached
+                // forever. index.html must NOT be: a cached copy points at the
+                // previous build's hashed bundle, which now 404s, leaving a blank
+                // page that only a manual hard-reload fixes.
+                setHeaders: (res, filePath) => {
+                    const immutable = filePath.includes(`${sep}assets${sep}`);
+                    res.header('cache-control', immutable ? 'public, max-age=31536000, immutable' : 'no-cache');
+                },
+            });
+            // SPA fallback, but only for navigations. Serving index.html for a
+            // missing /assets/*.js turns a cache-stale asset into a confusing MIME
+            // type error instead of an honest 404, so anything that looks like a
+            // file must 404 as a file.
+            app.setNotFoundHandler((req, reply) => {
+                const url = (req.raw.url ?? '/').split('?')[0];
+                const looksLikeFile = /\.[a-z0-9]+$/i.test(url);
+                const isApi = url.startsWith('/mcp') || url.startsWith('/hook') || url.startsWith('/ws');
+                if (looksLikeFile || isApi) {
+                    return reply.code(404).send({ error: 'not found', path: url });
+                }
+                return reply.sendFile('index.html');
+            });
+        }
+    }
+    /* ----------------------------------------------------------- shutdown */
+    /**
+     * Fastify's close() waits for open connections to drain, and a WebSocket
+     * never drains on its own — an idle browser tab or a connected peer would
+     * hang shutdown indefinitely. Terminate them explicitly instead.
+     */
+    app.addHook('onClose', async () => {
+        for (const ws of clients) {
+            try {
+                ws.terminate();
+            }
+            catch {
+                // Already gone.
+            }
+        }
+        peerServer.closeAll();
+        clients.clear();
+        attached.clear();
+    });
+    /* --------------------------------------------------------------- bind */
+    // Loopback unless the operator asked otherwise. An SSH-deployed hub is
+    // always reached through its tunnel and never binds wider; `--listen` exists
+    // so a machine can fetch the join page and enroll itself.
+    const host = opts.host ?? '127.0.0.1';
+    const address = await listenOnFirstFree(app, host, opts.port ?? 0);
+    const port = app.server.address().port;
+    // Agents' MCP endpoint stays on loopback whenever the bind answers there,
+    // which for `--listen lan` it does: that binds the wildcard precisely so
+    // this stays true.
+    const origin = `http://${coversLoopback(host) ? '127.0.0.1' : urlHost(host)}:${port}`;
+    hub.setOrigin(origin);
+    const advertised = advertisedHost(host);
+    if (advertised) {
+        // Prefer this machine's name: it is the URL someone has to carry to
+        // another machine and type in. The IP stays available underneath.
+        const name = await preferredHostname(advertised);
+        enrollOrigin = `http://${name ?? advertised}:${port}`;
+        enrollAltOrigin = name ? `http://${advertised}:${port}` : null;
+    }
+    void address;
+    return { app, origin, enrollOrigin, enrollAltOrigin, port, peerServer, enrollment };
+}
+/**
+ * Bind the first candidate that is free.
+ *
+ * A probe-then-bind would race, so this just tries to bind for real and moves
+ * on when the port is taken. The last resort is `0` — an unmemorable port
+ * still beats refusing to start.
+ */
+async function listenOnFirstFree(app, host, port) {
+    const candidates = Array.isArray(port) ? [...port, 0] : [port];
+    for (let i = 0; i < candidates.length; i++) {
+        try {
+            return await app.listen({ host, port: candidates[i] });
+        }
+        catch (err) {
+            const code = err.code;
+            const inUse = code === 'EADDRINUSE' || code === 'EACCES';
+            if (!inUse || i === candidates.length - 1)
+                throw err;
+        }
+    }
+    throw new Error('no port available');
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,OAAiC,MAAM,SAAS,CAAC;AACxD,OAAO,SAAS,MAAM,oBAAoB,CAAC;AAC3C,OAAO,aAAa,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EACL,SAAS,EAET,eAAe,EACf,iBAAiB,EACjB,iBAAiB,GAGlB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAO,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAmB,MAAM,wBAAwB,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAmB,MAAM,oBAAoB,CAAC;AACzE,OAAO,EACL,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,OAAO,GACR,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAwCpE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAEhF;;;;;;;;GAQG;AACH,SAAS,OAAO;IACd,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,MAAM,UAAU,GAAG;QACjB,sDAAsD;QACtD,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC;QACvB,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC;QACrC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC;KAC5C,CAAC;IACF,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AACvD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,IAAkB;IAC5C,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IAClC,MAAM,GAAG,GAAG,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAEvC,MAAM,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE;QAC5B,OAAO,EAAE,EAAE,UAAU,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI,EAAE;KACzC,CAAC,CAAC;IAEH,0EAA0E;IAE1E,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC9B,EAAE,EAAE,IAAI;QACR,UAAU,EAAE,WAAW;QACvB,GAAG,EAAE,OAAO,CAAC,GAAG;KACjB,CAAC,CAAC,CAAC;IAEJ,0EAA0E;IAE1E;;;OAGG;IACH,GAAG,CAAC,IAAI,CACN,cAAc,EACd,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;QACnB,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvD,IAAI,CAAC,SAAS;YAAE,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3D,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;QAC3D,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACjD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IACtB,CAAC,CACF,CAAC;IAEF,0EAA0E;IAE1E,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;QACnC,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC;QAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3D,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBAC1B,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE;gBAChD,EAAE,EAAE,IAAI;aACT,CAAC,CAAC;QACL,CAAC;QAED,2EAA2E;QAC3E,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QAC9C,MAAM,SAAS,GAAG,iBAAiB,EAAE,CAAC;QACtC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACzB,KAAK,SAAS,CAAC,KAAK,EAAE,CAAC;YACvB,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC;QACtB,CAAC,CAAC,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAChC,MAAM,SAAS,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QAC5D,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,8EAA8E;IAE9E;;;;;;OAMG;IACH,MAAM,UAAU,GAAG,gBAAgB,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IACtD,yEAAyE;IACzE,0EAA0E;IAC1E,sCAAsC;IACtC,GAAG,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IAE1B,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,EAAE,EAAE;QAC/C,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,0EAA0E;IAE1E,uEAAuE;IACvE,iEAAiE;IACjE,IAAI,YAAY,GAAkB,IAAI,CAAC;IACvC,IAAI,eAAe,GAAkB,IAAI,CAAC;IAC1C,MAAM,UAAU,GAAG,kBAAkB,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,YAAY,EAAE,CAAC,CAAC;IAEtF,0EAA0E;IAE1E,MAAM,OAAO,GAAG,IAAI,GAAG,EAA0B,CAAC;IAElD,MAAM,IAAI,GAAG,CAAC,EAA0B,EAAE,GAAc,EAAQ,EAAE;QAChE,IAAI,EAAE,CAAC,UAAU,KAAK,EAAE,CAAC,IAAI;YAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9D,CAAC,CAAC;IACF,MAAM,SAAS,GAAG,CAAC,GAAc,EAAQ,EAAE;QACzC,KAAK,MAAM,EAAE,IAAI,OAAO;YAAE,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IAC1C,CAAC,CAAC;IAEF,MAAM,aAAa,GAAG,GAAa,EAAE,CAAC,CAAC;QACrC,UAAU,EAAE,WAAW;QACvB,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,YAAY,OAAO,CAAC,CAAC,CAAC,IAAI;QACvD,YAAY,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,eAAe,OAAO,CAAC,CAAC,CAAC,IAAI;QAChE,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE;QAC5B,UAAU,EAAE,GAAG,CAAC,KAAK,CAAC,cAAc,EAAE;QACtC,QAAQ,EAAE,GAAG,CAAC,WAAW,EAAE;QAC3B,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE;QACxB,QAAQ,EAAE,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE;QACjC,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACxC,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU;SAC1B,CAAC,CAAC;KACJ,CAAC,CAAC;IAEH,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,iBAAiB,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1E,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,gBAAgB,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAC7E,GAAG,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,mBAAmB,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAChF,GAAG,CAAC,EAAE,CAAC,kBAAkB,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,kBAAkB,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAC1F,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACtE,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACjE,GAAG,CAAC,EAAE,CAAC,aAAa,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAC3E,4EAA4E;IAC5E,4CAA4C;IAC5C,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC/E,qEAAqE;IACrE,4DAA4D;IAC5D,GAAG,CAAC,EAAE,CAAC,cAAc,EAAE,GAAG,EAAE;QAC1B,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE;YAAE,SAAS,CAAC,EAAE,CAAC,EAAE,iBAAiB,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;IACxF,CAAC,CAAC,CAAC;IAEH,0EAA0E;IAC1E,4EAA4E;IAC5E,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAuC,CAAC;IAChE,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,SAAiB,EAAE,KAAa,EAAE,EAAE;QAClD,MAAM,KAAK,GAAG,iBAAiB,CAC7B,eAAe,CAAC,SAAS,EACzB,SAAS,EACT,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAC3B,CAAC;QACF,KAAK,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;YACzB,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,UAAU,KAAK,EAAE,CAAC,IAAI;gBAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpF,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,EAAE,EAAE;QAC7C,IAAI,MAAM,GAAG,KAAK,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpB,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QAEhC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,GAAW,EAAE,QAAiB,EAAE,EAAE;YACtD,IAAI,CAAC;gBACH,IAAI,QAAQ,EAAE,CAAC;oBACb,IAAI,CAAC,MAAM;wBAAE,OAAO;oBACpB,MAAM,CAAC,GAAG,iBAAiB,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;oBACjD,IAAI,CAAC,CAAC,IAAI,KAAK,eAAe,CAAC,QAAQ,EAAE,CAAC;wBACxC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;wBACrD,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;wBAC3C,IAAI,MAAM,EAAE,CAAC;4BACX,8DAA8D;4BAC9D,+DAA+D;4BAC/D,gEAAgE;4BAChE,8DAA8D;4BAC9D,KAAK,MAAM,CAAC,IAAI;iCACb,OAAO,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC;iCACrE,KAAK,CAAC,CAAC,CAAQ,EAAE,EAAE,CAClB,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CACzE,CAAC;wBACN,CAAC;6BAAM,CAAC;4BACN,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;wBACxC,CAAC;oBACH,CAAC;oBACD,OAAO;gBACT,CAAC;gBAED,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;gBACrE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;oBACpB,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC,CAAC;oBAC3D,OAAO;gBACT,CAAC;gBACD,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC;gBAExB,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,IAAI,GAAG,CAAC,CAAC,KAAK,OAAO,IAAI,GAAG,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;wBACnD,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC;wBACtD,MAAM,CAAC,KAAK,EAAE,CAAC;wBACf,OAAO;oBACT,CAAC;oBACD,MAAM,GAAG,IAAI,CAAC;oBACd,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE,CAAC,CAAC;oBACrD,OAAO;gBACT,CAAC;gBAED,KAAK,eAAe,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YACpC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,EAAG,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;YAChE,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACtB,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACvB,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,KAAK,UAAU,eAAe,CAC5B,MAA8B,EAC9B,GAAc;QAEd,IAAI,CAAC;YACH,QAAQ,GAAG,CAAC,CAAC,EAAE,CAAC;gBACd,KAAK,OAAO;oBACV,OAAO;gBAET,iEAAiE;gBACjE,sEAAsE;gBACtE,KAAK,QAAQ,CAAC,CAAC,CAAC;oBACd,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;oBACzC,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;oBAC7C,IAAI,MAAM,EAAE,CAAC;wBACX,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;wBACxC,OAAO;oBACT,CAAC;oBACD,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;oBAC3D,IAAI,IAAI,EAAE,CAAC;wBACT,IAAI,CAAC,MAAM,EAAE;4BACX,CAAC,EAAE,UAAU;4BACb,SAAS,EAAE,GAAG,CAAC,SAAS;4BACxB,UAAU,EAAE,IAAI,CAAC,UAAU;4BAC3B,IAAI,EAAE,IAAI,CAAC,IAAI;4BACf,IAAI,EAAE,IAAI,CAAC,IAAI;yBAChB,CAAC,CAAC;oBACL,CAAC;oBACD,OAAO;gBACT,CAAC;gBAED,KAAK,QAAQ,CAAC,CAAC,CAAC;oBACd,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;oBAC5C,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;oBAC7C,IAAI,MAAM;wBAAE,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;oBACpD,OAAO;gBACT,CAAC;gBAED,KAAK,QAAQ,CAAC,CAAC,CAAC;oBACd,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;oBAC7C,IAAI,MAAM,EAAE,CAAC;wBACX,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;4BACxB,CAAC,EAAE,QAAQ;4BACX,EAAE,EAAE,UAAU,EAAE;4BAChB,OAAO,EAAE,GAAG,CAAC,SAAS;4BACtB,IAAI,EAAE,GAAG,CAAC,IAAI;4BACd,IAAI,EAAE,GAAG,CAAC,IAAI;yBACf,CAAC,CAAC;wBACH,OAAO;oBACT,CAAC;oBACD,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;oBACvD,OAAO;gBACT,CAAC;gBAED,KAAK,iBAAiB;oBACpB,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC;oBAChE,OAAO;gBAET,KAAK,iBAAiB;oBACpB,MAAM,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;oBAC3C,OAAO;gBAET,KAAK,cAAc;oBACjB,MAAM,GAAG,CAAC,YAAY,CAAC;wBACrB,WAAW,EAAE,GAAG,CAAC,WAAW;wBAC5B,OAAO,EAAE,GAAG,CAAC,OAAO;wBACpB,IAAI,EAAE,GAAG,CAAC,IAAI;wBACd,GAAG,EAAE,GAAG,CAAC,GAAG;qBACb,CAAC,CAAC;oBACH,OAAO;gBAET,KAAK,aAAa,CAAC,CAAC,CAAC;oBACnB,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;oBAC7C,IAAI,MAAM,EAAE,CAAC;wBACX,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,aAAa,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;wBAC1F,OAAO;oBACT,CAAC;oBACD,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;oBACjC,OAAO;gBACT,CAAC;gBAED,KAAK,eAAe;oBAClB,kEAAkE;oBAClE,kEAAkE;oBAClE,qBAAqB;oBACrB,IAAI,MAAM,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC;wBAAE,OAAO;oBACzD,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;oBACnC,OAAO;gBAET,KAAK,eAAe,CAAC,CAAC,CAAC;oBACrB,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;oBAC7C,IAAI,MAAM,EAAE,CAAC;wBACX,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,eAAe,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;wBAC5F,OAAO;oBACT,CAAC;oBACD,MAAM,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;oBACzC,OAAO;gBACT,CAAC;gBAED,KAAK,iBAAiB;oBACpB,MAAM,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;oBAC3C,OAAO;gBAET,KAAK,YAAY;oBACf,qDAAqD;oBACrD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;wBACnD,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;oBAC1C,CAAC;oBACD,OAAO;gBAET,KAAK,aAAa;oBAChB,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;oBAC9B,OAAO;gBAET,KAAK,SAAS,CAAC,CAAC,CAAC;oBACf,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;oBAC9B,kEAAkE;oBAClE,sCAAsC;oBACtC,KAAK,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CACxC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAC7E,CAAC;oBACF,OAAO;gBACT,CAAC;gBAED,KAAK,YAAY;oBACf,MAAM,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;oBACjC,OAAO;gBAET,KAAK,aAAa;oBAChB,MAAM,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;oBAClC,OAAO;gBAET;oBACE,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,cAAe,GAAqB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACpF,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,EAAG,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAED,0EAA0E;IAE1E,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACnB,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;QACvB,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,GAAG,CAAC,QAAQ,CAAC,aAAa,EAAE;gBAChC,IAAI;gBACJ,QAAQ,EAAE,KAAK;gBACf,oEAAoE;gBACpE,+DAA+D;gBAC/D,kEAAkE;gBAClE,6CAA6C;gBAC7C,UAAU,EAAE,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE;oBAC5B,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,GAAG,GAAG,SAAS,GAAG,EAAE,CAAC,CAAC;oBAC1D,GAAG,CAAC,MAAM,CACR,eAAe,EACf,SAAS,CAAC,CAAC,CAAC,qCAAqC,CAAC,CAAC,CAAC,UAAU,CAC/D,CAAC;gBACJ,CAAC;aACF,CAAC,CAAC;YAEH,mEAAmE;YACnE,uEAAuE;YACvE,qEAAqE;YACrE,2BAA2B;YAC3B,GAAG,CAAC,kBAAkB,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;gBACpC,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;gBAChD,MAAM,aAAa,GAAG,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAChD,MAAM,KAAK,GAAG,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;gBACzF,IAAI,aAAa,IAAI,KAAK,EAAE,CAAC;oBAC3B,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;gBACjE,CAAC;gBACD,OAAO,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;YACtC,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,0EAA0E;IAE1E;;;;OAIG;IACH,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;QAChC,KAAK,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;YACzB,IAAI,CAAC;gBACH,EAAE,CAAC,SAAS,EAAE,CAAC;YACjB,CAAC;YAAC,MAAM,CAAC;gBACP,gBAAgB;YAClB,CAAC;QACH,CAAC;QACD,UAAU,CAAC,QAAQ,EAAE,CAAC;QACtB,OAAO,CAAC,KAAK,EAAE,CAAC;QAChB,QAAQ,CAAC,KAAK,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,0EAA0E;IAE1E,uEAAuE;IACvE,6EAA6E;IAC7E,0DAA0D;IAC1D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,WAAW,CAAC;IACtC,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;IACnE,MAAM,IAAI,GAAI,GAAG,CAAC,MAAM,CAAC,OAAO,EAAuB,CAAC,IAAI,CAAC;IAE7D,0EAA0E;IAC1E,yEAAyE;IACzE,mBAAmB;IACnB,MAAM,MAAM,GAAG,UAAU,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;IACtF,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAEtB,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,UAAU,EAAE,CAAC;QACf,oEAAoE;QACpE,kEAAkE;QAClE,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC,UAAU,CAAC,CAAC;QACjD,YAAY,GAAG,UAAU,IAAI,IAAI,UAAU,IAAI,IAAI,EAAE,CAAC;QACtD,eAAe,GAAG,IAAI,CAAC,CAAC,CAAC,UAAU,UAAU,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACjE,CAAC;IAED,KAAK,OAAO,CAAC;IACb,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC;AACtF,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,iBAAiB,CAC9B,GAAoB,EACpB,IAAY,EACZ,IAAuB;IAEvB,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAE/D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,IAAI,CAAC;YACH,OAAO,MAAM,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAE,EAAE,CAAC,CAAC;QAC1D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,GAAI,GAA6B,CAAC,IAAI,CAAC;YACjD,MAAM,KAAK,GAAG,IAAI,KAAK,YAAY,IAAI,IAAI,KAAK,QAAQ,CAAC;YACzD,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,UAAU,CAAC,MAAM,GAAG,CAAC;gBAAE,MAAM,GAAG,CAAC;QACvD,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;AACvC,CAAC"}

package/dist/session/manager.d.ts

@@ -0,0 +1,104 @@
+import { EventEmitter } from 'node:events';
+import { type Session, type WindowRect } from '../protocol/index.js';
+import { Store } from '../db/store.js';
+import { ProfileRegistry } from '../agents/profiles.js';
+import { TokenRegistry } from '../agents/tokens.js';
+import { PtySession } from './pty.js';
+/** Debounce for persisting window geometry while a window is being dragged. */
+export declare const LAYOUT_DEBOUNCE_MS = 250;
+export interface StartOptions {
+    workspaceId: string;
+    profileId: string;
+    name?: string;
+    cwd?: string;
+    spawnedBy?: string | null;
+    cols?: number;
+    rows?: number;
+    window?: WindowRect;
+}
+export interface ManagerEvents {
+    session: (s: Session) => void;
+    /**
+     * The address travels with the id: after the delete there is nothing left
+     * to look it up from, and peers address sessions by name.
+     */
+    removed: (sessionId: string, address: string | null) => void;
+    data: (sessionId: string, chunk: string) => void;
+    exit: (sessionId: string, code: number) => void;
+}
+/**
+ * Owns every PTY on this hub, plus the persistence of their state.
+ *
+ * The invariant worth stating: SQLite always holds enough to redraw the canvas
+ * and relaunch each agent. Live objects here are a cache over that, never the
+ * other way round.
+ */
+export declare class SessionManager extends EventEmitter {
+    private readonly store;
+    private readonly profiles;
+    readonly tokens: TokenRegistry;
+    private hubOrigin;
+    private readonly live;
+    private readonly snapshotTimers;
+    private readonly layoutTimers;
+    /** Latest title per session, waiting for the coalescing window to close. */
+    private readonly pendingTitles;
+    private titleTimer;
+    constructor(store: Store, profiles: ProfileRegistry, tokens: TokenRegistry, hubOrigin: string);
+    setHubOrigin(origin: string): void;
+    private isResumable;
+    list(): Session[];
+    get(id: string): Session | null;
+    getByAddress(address: string): Session | null;
+    /** Overlay live runtime status onto the persisted row. */
+    private decorate;
+    pty(id: string): PtySession | null;
+    /** Build the resolved argv/env for a launch. `resume` swaps in --resume. */
+    private buildSpec;
+    private peersOf;
+    start(opts: StartOptions): Promise<Session>;
+    /** Bring a stopped session back, reusing its recorded argv and cwd. */
+    resume(sessionId: string): Promise<Session>;
+    private spawn;
+    write(sessionId: string, data: string): void;
+    resize(sessionId: string, cols: number, rows: number): void;
+    setStatusText(sessionId: string, text: string): void;
+    /**
+     * A title the program in the PTY set for itself.
+     *
+     * An agent rewrites this as it works, several times a second, so the write
+     * and the broadcast are held to the last value in a window rather than one
+     * apiece. Unrefed: a pending title is never a reason to keep the process up.
+     */
+    private noteTitle;
+    /** Called by the hooks endpoint: exact turn boundaries from the agent CLI. */
+    setStatusFromHook(sessionId: string, status: 'busy' | 'idle'): void;
+    stop(sessionId: string): void;
+    remove(sessionId: string): void;
+    private scheduleSnapshot;
+    /** Screen only — the deliberate cost of the snapshot-only design. */
+    persistSnapshot(sessionId: string): void;
+    persistAllSnapshots(): void;
+    snapshotForAttach(sessionId: string): {
+        serialized: string;
+        cols: number;
+        rows: number;
+    } | null;
+    moveWindow(sessionId: string, rect: WindowRect): void;
+    /**
+     * Place a new window: tucked below-right of its parent when spawned by
+     * another agent, otherwise in the next free slot of a simple grid.
+     */
+    private placeWindow;
+    /** Workspaces are laid out left to right so their groups do not overlap. */
+    private workspaceOriginX;
+    private clearTimer;
+    private emitSession;
+    /**
+     * Startup reconciliation. Sessions cannot outlive the hub, so anything the
+     * DB still calls running is stale and is marked stopped, ready to resume.
+     */
+    reconcileOnBoot(): void;
+    shutdown(): void;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/session/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/session/manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,EAGL,KAAK,OAAO,EACZ,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAkB,KAAK,EAA0B,MAAM,gBAAgB,CAAC;AAC/E,OAAO,EAAE,eAAe,EAA4C,MAAM,uBAAuB,CAAC;AAElG,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAUtC,+EAA+E;AAC/E,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAC9B;;;OAGG;IACH,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAC7D,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACjD,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjD;AAED;;;;;;GAMG;AACH,qBAAa,cAAe,SAAQ,YAAY;IAS5C,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,QAAQ,CAAC,MAAM,EAAE,aAAa;IAC9B,OAAO,CAAC,SAAS;IAXnB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAiC;IACtD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqC;IACpE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqC;IAClE,4EAA4E;IAC5E,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA6B;IAC3D,OAAO,CAAC,UAAU,CAA+B;gBAG9B,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,eAAe,EACjC,MAAM,EAAE,aAAa,EACtB,SAAS,EAAE,MAAM;IAK3B,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAMlC,OAAO,CAAC,WAAW,CAAoE;IAEvF,IAAI,IAAI,OAAO,EAAE;IAIjB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;IAK/B,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;IAI7C,0DAA0D;IAC1D,OAAO,CAAC,QAAQ;IAMhB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAMlC,4EAA4E;IAC5E,OAAO,CAAC,SAAS;IAqDjB,OAAO,CAAC,OAAO;IAMT,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IA8CjD,uEAAuE;IACjE,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAuBjD,OAAO,CAAC,KAAK;IAkEb,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAO5C,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAM3D,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAKpD;;;;;;OAMG;IACH,OAAO,CAAC,SAAS;IAejB,8EAA8E;IAC9E,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKnE,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAU7B,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAe/B,OAAO,CAAC,gBAAgB;IAWxB,qEAAqE;IACrE,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAUxC,mBAAmB,IAAI,IAAI;IAI3B,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAS/F,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI;IAUrD;;;OAGG;IACH,OAAO,CAAC,WAAW;IAyBnB,4EAA4E;IAC5E,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,WAAW;IAKnB;;;OAGG;IACH,eAAe,IAAI,IAAI;IAQvB,QAAQ,IAAI,IAAI;CAoBjB"}