@winstonfassett/webdev-gateway 0.1.0-alpha.0

package/dist/playwright-commands.js

@@ -0,0 +1,356 @@
+/**
+ * Playwright command implementations — used when Chrome extension CDP is available.
+ * Falls back to injected client RPC commands when extension is not connected.
+ *
+ * Each function maps an MCP tool command to the equivalent Playwright API call.
+ * Based on @xmorse/playwright-core with getExistingCDPSession pattern from Playwriter.
+ */
+/**
+ * Try to execute a browser command via Playwright.
+ * Returns the result if CDP is available, or null to signal fallback to RPC.
+ *
+ * @param serverPort - dev server port to match against page URLs for multi-tab targeting
+ */
+export async function tryPlaywrightCommand(relay, method, params, serverPort) {
+    if (!relay)
+        return null;
+    // Auto-activate debugging on first CDP tool use (passive mode)
+    if (!relay.isAvailable) {
+        if (!relay.canActivate)
+            return null;
+        const activated = await relay.ensureDebugging();
+        if (!activated)
+            return null;
+    }
+    else {
+        // Reset idle timer on every tool call
+        relay.ensureDebugging();
+    }
+    const page = await relay.getPage(serverPort);
+    if (!page)
+        return null;
+    try {
+        switch (method) {
+            case 'screenshot':
+                return await pwScreenshot(page, params);
+            case 'click':
+                return await pwClick(page, params, relay);
+            case 'fill':
+                return await pwFill(page, params, relay);
+            case 'hover':
+                return await pwHover(page, params, relay);
+            case 'selectOption':
+                return await pwSelectOption(page, params);
+            case 'pressKey':
+                return await pwPressKey(page, params);
+            case 'scroll':
+                return await pwScroll(page, params);
+            case 'navigate':
+                return await pwNavigate(page, params);
+            case 'goBack':
+                await page.goBack();
+                return { url: page.url() };
+            case 'goForward':
+                await page.goForward();
+                return { url: page.url() };
+            case 'queryDom':
+                return await pwQueryDom(relay, page, params);
+            case 'a11ySnapshot':
+                return await pwA11ySnapshot(relay, page, params);
+            case 'getVisibleText':
+                return await pwGetVisibleText(page, params);
+            default:
+                // Not a command we handle via Playwright — fall back to RPC
+                return null;
+        }
+    }
+    catch (e) {
+        // If Playwright fails, fall back to RPC rather than erroring
+        console.log(`[playwright] ${method} failed, falling back to RPC: ${e.message}`);
+        return null;
+    }
+}
+// ---- Command implementations ----
+async function pwScreenshot(page, params) {
+    const opts = { type: params?.format === 'png' ? 'png' : 'jpeg' };
+    if (params?.format === 'jpeg' || !params?.format) {
+        opts.quality = params?.quality ?? 80;
+    }
+    if (params?.selector) {
+        const el = page.locator(params.selector).first();
+        const buf = await el.screenshot(opts);
+        const box = await el.boundingBox();
+        return {
+            data: `data:image/${opts.type};base64,${buf.toString('base64')}`,
+            width: Math.round(box?.width ?? 0),
+            height: Math.round(box?.height ?? 0),
+        };
+    }
+    if (params?.preset === 'full') {
+        opts.fullPage = true;
+    }
+    const buf = await page.screenshot(opts);
+    const viewport = page.viewportSize() || { width: 1280, height: 720 };
+    return {
+        data: `data:image/${opts.type};base64,${buf.toString('base64')}`,
+        width: viewport.width,
+        height: params?.preset === 'full' ? undefined : viewport.height,
+    };
+}
+/** Resolve a selector — supports CSS, text=, and ref= prefixes */
+async function resolveLocator(page, relay, selector) {
+    if (selector.startsWith('ref=')) {
+        if (!relay)
+            throw new Error('ref= requires CDP extension');
+        const locator = await resolveRef(relay, page, selector.slice(4));
+        if (locator.error)
+            throw new Error(locator.error);
+        return locator;
+    }
+    if (selector.startsWith('text=')) {
+        return page.getByText(selector.slice(5)).first();
+    }
+    return page.locator(selector).first();
+}
+async function pwClick(page, params, relay) {
+    const selector = params?.selector;
+    if (!selector)
+        throw new Error('selector required');
+    const locator = await resolveLocator(page, relay || null, selector);
+    await locator.click();
+    return { clicked: selector };
+}
+async function pwFill(page, params, relay) {
+    const { selector, value } = params || {};
+    if (!selector || value === undefined)
+        throw new Error('selector and value required');
+    const locator = await resolveLocator(page, relay || null, selector);
+    await locator.fill(String(value));
+    return { filled: selector, value };
+}
+async function pwHover(page, params, relay) {
+    const selector = params?.selector;
+    if (!selector)
+        throw new Error('selector required');
+    const locator = await resolveLocator(page, relay || null, selector);
+    await locator.hover();
+    return { hovered: selector };
+}
+async function pwSelectOption(page, params) {
+    const { selector, value } = params || {};
+    await page.locator(selector).first().selectOption(value);
+    return { selected: selector, value };
+}
+async function pwPressKey(page, params) {
+    const { key, modifiers } = params || {};
+    let keyCombo = key;
+    if (modifiers) {
+        const mods = Array.isArray(modifiers) ? modifiers : [modifiers];
+        keyCombo = [...mods, key].join('+');
+    }
+    await page.keyboard.press(keyCombo);
+    return { pressed: keyCombo };
+}
+async function pwScroll(page, params) {
+    if (params?.selector) {
+        await page.locator(params.selector).first().scrollIntoViewIfNeeded();
+        return { scrolled: params.selector };
+    }
+    const x = params?.x ?? 0;
+    const y = params?.y ?? 0;
+    await page.evaluate(([sx, sy]) => window.scrollTo(sx, sy), [x, y]);
+    return { scrolled: { x, y } };
+}
+async function pwNavigate(page, params) {
+    await page.goto(params?.url, { waitUntil: 'domcontentloaded', timeout: 15000 });
+    return { url: page.url(), title: await page.title() };
+}
+async function pwQueryDom(relay, page, params) {
+    // Use CDP Accessibility.getFullAXTree for richer DOM inspection
+    try {
+        const cdp = await relay.getCDPSession(page);
+        const { nodes } = await cdp.send('Accessibility.getFullAXTree');
+        // Build a simplified a11y tree
+        const interactive = nodes.filter((n) => n.role?.value && !['none', 'generic', 'InlineTextBox', 'StaticText'].includes(n.role.value));
+        const lines = [];
+        for (const node of interactive.slice(0, 100)) {
+            const role = node.role?.value || '';
+            const name = node.name?.value || '';
+            const value = node.value?.value || '';
+            lines.push(`${role}: ${name}${value ? ` = "${value}"` : ''}`);
+        }
+        return { html: lines.join('\n'), nodeCount: nodes.length };
+    }
+    catch {
+        // Fall back to null — will use RPC
+        return null;
+    }
+}
+// ---- A11y Snapshot with Refs ----
+/** Roles that are structural containers — keep for tree context but don't assign refs */
+const STRUCTURAL_ROLES = new Set([
+    'banner', 'complementary', 'contentinfo', 'form', 'main', 'navigation',
+    'region', 'search', 'list', 'listitem', 'table', 'row', 'cell',
+    'heading', 'group', 'toolbar', 'tablist', 'tabpanel', 'menu', 'menubar',
+    'tree', 'treegrid', 'grid', 'dialog', 'alertdialog', 'article', 'figure',
+]);
+/** Roles that are interactive — assign refs to these */
+const INTERACTIVE_ROLES = new Set([
+    'button', 'link', 'textbox', 'checkbox', 'radio', 'combobox', 'switch',
+    'slider', 'spinbutton', 'searchbox', 'menuitem', 'menuitemcheckbox',
+    'menuitemradio', 'option', 'tab', 'treeitem', 'gridcell', 'scrollbar',
+    'progressbar',
+]);
+/** Roles to skip entirely — these are noise */
+const SKIP_ROLES = new Set([
+    'none', 'presentation', 'generic', 'InlineTextBox', 'StaticText',
+    'LineBreak', 'paragraph', 'Section',
+]);
+/**
+ * Build a filtered a11y tree from CDP AX nodes.
+ * Assigns ref IDs to interactive elements.
+ */
+function buildA11yTree(nodes) {
+    if (!nodes.length)
+        return { tree: [], refs: new Map() };
+    // Build lookup: nodeId → AX node
+    const nodeMap = new Map();
+    for (const node of nodes) {
+        nodeMap.set(node.nodeId, node);
+    }
+    let refCounter = 0;
+    const refs = new Map();
+    function processNode(axNode) {
+        const role = axNode.role?.value || '';
+        const name = axNode.name?.value || '';
+        const value = axNode.value?.value;
+        // Skip noise roles
+        if (SKIP_ROLES.has(role)) {
+            // But process children — they might be meaningful
+            const promotedChildren = [];
+            for (const childId of axNode.childIds || []) {
+                const child = nodeMap.get(childId);
+                if (child) {
+                    const processed = processNode(child);
+                    if (processed)
+                        promotedChildren.push(processed);
+                }
+            }
+            // If skipped node has exactly one child, promote it directly
+            if (promotedChildren.length === 1)
+                return promotedChildren[0];
+            // If multiple children, skip this level but return children
+            if (promotedChildren.length > 1) {
+                return { role: '', name: '', children: promotedChildren };
+            }
+            return null;
+        }
+        // Ignore elements with no name and no children (empty containers)
+        const childIds = axNode.childIds || [];
+        // Process children
+        const children = [];
+        for (const childId of childIds) {
+            const child = nodeMap.get(childId);
+            if (child) {
+                const processed = processNode(child);
+                if (processed)
+                    children.push(processed);
+            }
+        }
+        // Skip empty structural nodes with no name
+        if (!name && children.length === 0 && !INTERACTIVE_ROLES.has(role)) {
+            return null;
+        }
+        const treeNode = { role, name, children };
+        if (value)
+            treeNode.value = value;
+        if (axNode.backendDOMNodeId)
+            treeNode.backendDOMNodeId = axNode.backendDOMNodeId;
+        // Assign ref to interactive elements
+        if (INTERACTIVE_ROLES.has(role)) {
+            // Check for stable IDs from common test attributes
+            const props = axNode.properties || [];
+            // Build ref: prefer data-testid from description, fall back to sequential
+            const ref = `e${refCounter++}`;
+            treeNode.ref = ref;
+            refs.set(ref, {
+                role,
+                name,
+                backendDOMNodeId: axNode.backendDOMNodeId,
+            });
+        }
+        return treeNode;
+    }
+    // Start from root (first node)
+    const root = processNode(nodes[0]);
+    const tree = root ? (root.role ? [root] : root.children) : [];
+    return { tree, refs };
+}
+/**
+ * Render a11y tree as indented text.
+ * Interactive elements get [ref=eN] annotations.
+ */
+function renderA11yTree(nodes, indent = 0) {
+    const lines = [];
+    const pad = '  '.repeat(indent);
+    for (const node of nodes) {
+        // Skip wrapper nodes with empty role (promoted from skipped parents)
+        if (!node.role && node.children.length > 0) {
+            lines.push(renderA11yTree(node.children, indent));
+            continue;
+        }
+        let line = `${pad}- ${node.role}`;
+        if (node.name)
+            line += ` "${node.name}"`;
+        if (node.value)
+            line += ` = "${node.value}"`;
+        if (node.ref)
+            line += ` [ref=${node.ref}]`;
+        lines.push(line);
+        if (node.children.length > 0) {
+            lines.push(renderA11yTree(node.children, indent + 1));
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Take an a11y snapshot with ref IDs for interactive elements.
+ * Caches refs on the relay for subsequent ref-based actions.
+ */
+export async function pwA11ySnapshot(relay, page, params) {
+    try {
+        const cdp = await relay.getCDPSession(page);
+        const { nodes } = await cdp.send('Accessibility.getFullAXTree');
+        const { tree, refs } = buildA11yTree(nodes);
+        const snapshot = renderA11yTree(tree);
+        // Cache refs on relay for ref-based actions
+        relay.refCache = refs;
+        return {
+            snapshot,
+            refCount: refs.size,
+            nodeCount: nodes.length,
+        };
+    }
+    catch (e) {
+        return { error: `a11y snapshot failed: ${e.message}` };
+    }
+}
+/**
+ * Resolve a ref (e.g. "e3") to a Playwright locator action.
+ * Uses cached refs from the last a11y_snapshot call.
+ */
+export async function resolveRef(relay, page, ref) {
+    const entry = relay.refCache?.get(ref);
+    if (!entry) {
+        return { error: `Unknown ref "${ref}". Call a11y_snapshot first to assign refs.` };
+    }
+    // Resolve via role + name (most reliable Playwright locator)
+    const { role, name } = entry;
+    return page.getByRole(role, name ? { name } : undefined).first();
+}
+async function pwGetVisibleText(page, params) {
+    const selector = params?.selector || 'body';
+    const text = await page.locator(selector).first().innerText();
+    return { text };
+}
+//# sourceMappingURL=playwright-commands.js.map

package/dist/playwright-commands.js.map

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

package/dist/registry.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Server Registry - tracks dev servers registered with the gateway
+ *
+ * Identity model:
+ *   Project  = directory path (persistent scope)
+ *   Server   = projectId:type or projectId:key (stable, survives restarts)
+ *   Endpoint = port on a server (can have multiple per server)
+ *   Process  = PID serving an endpoint (ephemeral, rotates transparently)
+ *   Browser  = affiliated with a server, not an endpoint or process
+ */
+/** Stable project short ID: basename-hash4 (e.g. "nextjs-turbopack-a3f7") */
+export declare function makeProjectId(directory: string): string;
+/**
+ * Stable server identity: projectId:type (default) or projectId:key (user override).
+ * This is the join key between browsers and servers — survives restarts.
+ */
+export declare function makeServerId(directory: string, type: string, key?: string): string;
+export interface Endpoint {
+    port: number;
+    pid: number;
+    registeredAt: number;
+}
+export interface RegisteredServer {
+    id: string;
+    projectId: string;
+    directory: string;
+    type: 'vite' | 'nextjs' | 'storybook' | 'astro' | 'generic';
+    key?: string;
+    name?: string;
+    endpoints: Endpoint[];
+    logPaths: Record<string, string>;
+    logDir: string;
+}
+/** Create per-project log directory and return channel file paths */
+export declare function initProjectLogDir(directory: string, channels?: string[]): {
+    logDir: string;
+    logPaths: Record<string, string>;
+};
+export type ServerEvent = 'register' | 'deregister';
+export type ServerEventCallback = (event: ServerEvent, data: {
+    serverId: string;
+    server?: RegisteredServer;
+}) => void;
+export declare function onServerEvent(cb: ServerEventCallback): () => void;
+export declare class ServerRegistry {
+    private servers;
+    private projectIdIndex;
+    private connectionOrder;
+    /**
+     * Register an endpoint on a server. Creates the server if it doesn't exist.
+     * Same server + same port = update PID (restart on same port).
+     * Same server + new port = add endpoint (additional instance).
+     */
+    addEndpoint(serverId: string, serverInfo: Omit<RegisteredServer, 'endpoints'>, endpoint: Endpoint): RegisteredServer;
+    /**
+     * Remove a specific endpoint from a server.
+     * If the server has no more endpoints, the server entry stays (browsers still affiliated).
+     */
+    removeEndpoint(serverId: string, port: number): void;
+    /** Remove a server entirely (explicit unregister) */
+    remove(id: string): void;
+    get(id: string): RegisteredServer | undefined;
+    getByProjectId(projectId: string): RegisteredServer[];
+    getByDirectory(directory: string): RegisteredServer[];
+    getAll(): RegisteredServer[];
+    getByType(type: RegisteredServer['type']): RegisteredServer[];
+    /** Find a server that has an endpoint on this port */
+    getByPort(port: number): RegisteredServer | undefined;
+    getLatest(): RegisteredServer | undefined;
+    has(id: string): boolean;
+    size(): number;
+    /** List all registered project directories */
+    directories(): string[];
+    /** Check if any endpoint on any server has a live process */
+    hasLiveEndpoints(serverId: string): boolean;
+    /**
+     * Remove endpoints whose processes are no longer running.
+     * Skips endpoints registered within the last 30s (grace period for process forks).
+     * Server entries are never removed — only endpoints are cleaned up.
+     */
+    cleanupDeadEndpoints(): string[];
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAIvD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAElF;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,CAAA;IAC3D,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,QAAQ,EAAE,CAAA;IACrB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,MAAM,EAAE,MAAM,CAAA;CACf;AAED,qEAAqE;AACrE,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,MAAM,EAA0D,GACzE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAatD;AAED,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,YAAY,CAAA;AACnD,MAAM,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,gBAAgB,CAAA;CAAE,KAAK,IAAI,CAAA;AAIrH,wBAAgB,aAAa,CAAC,EAAE,EAAE,mBAAmB,GAAG,MAAM,IAAI,CAGjE;AAMD,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAsC;IACrD,OAAO,CAAC,cAAc,CAAiC;IACvD,OAAO,CAAC,eAAe,CAAe;IAEtC;;;;OAIG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,gBAAgB,EAAE,WAAW,CAAC,EAAE,QAAQ,EAAE,QAAQ,GAAG,gBAAgB;IA+CpH;;;OAGG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAWpD,qDAAqD;IACrD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAoBxB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAI7C,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAMrD,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAIrD,MAAM,IAAI,gBAAgB,EAAE;IAI5B,SAAS,CAAC,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,GAAG,gBAAgB,EAAE;IAI7D,sDAAsD;IACtD,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAIrD,SAAS,IAAI,gBAAgB,GAAG,SAAS;IAMzC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB,IAAI,IAAI,MAAM;IAId,8CAA8C;IAC9C,WAAW,IAAI,MAAM,EAAE;IAIvB,6DAA6D;IAC7D,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAM3C;;;;OAIG;IACH,oBAAoB,IAAI,MAAM,EAAE;CAgBjC"}

package/dist/registry.js

@@ -0,0 +1,205 @@
+/**
+ * Server Registry - tracks dev servers registered with the gateway
+ *
+ * Identity model:
+ *   Project  = directory path (persistent scope)
+ *   Server   = projectId:type or projectId:key (stable, survives restarts)
+ *   Endpoint = port on a server (can have multiple per server)
+ *   Process  = PID serving an endpoint (ephemeral, rotates transparently)
+ *   Browser  = affiliated with a server, not an endpoint or process
+ */
+import { createHash } from 'node:crypto';
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { join, basename } from 'node:path';
+/** Stable project short ID: basename-hash4 (e.g. "nextjs-turbopack-a3f7") */
+export function makeProjectId(directory) {
+    const name = basename(directory);
+    const hash = createHash('sha256').update(directory).digest('hex').slice(0, 4);
+    return `${name}-${hash}`;
+}
+/**
+ * Stable server identity: projectId:type (default) or projectId:key (user override).
+ * This is the join key between browsers and servers — survives restarts.
+ */
+export function makeServerId(directory, type, key) {
+    return `${makeProjectId(directory)}:${key || type}`;
+}
+/** Create per-project log directory and return channel file paths */
+export function initProjectLogDir(directory, channels = ['console', 'errors', 'dev-events', 'server-console']) {
+    const logDir = join(directory, '.webdev');
+    mkdirSync(logDir, { recursive: true });
+    const logPaths = {};
+    for (const ch of channels) {
+        const filePath = join(logDir, `${ch}.ndjson`);
+        logPaths[ch] = filePath;
+        // Truncate on registration (fresh session)
+        writeFileSync(filePath, '');
+    }
+    return { logDir, logPaths };
+}
+const serverEventListeners = new Set();
+export function onServerEvent(cb) {
+    serverEventListeners.add(cb);
+    return () => serverEventListeners.delete(cb);
+}
+function emitServerEvent(event, data) {
+    for (const cb of serverEventListeners)
+        cb(event, data);
+}
+export class ServerRegistry {
+    servers = new Map(); // server ID → server
+    projectIdIndex = new Map(); // projectId → set of server IDs
+    connectionOrder = [];
+    /**
+     * Register an endpoint on a server. Creates the server if it doesn't exist.
+     * Same server + same port = update PID (restart on same port).
+     * Same server + new port = add endpoint (additional instance).
+     */
+    addEndpoint(serverId, serverInfo, endpoint) {
+        let server = this.servers.get(serverId);
+        if (server) {
+            // Existing server — update or add endpoint
+            const existing = server.endpoints.find(e => e.port === endpoint.port);
+            if (existing) {
+                // Same port, new PID (restart)
+                existing.pid = endpoint.pid;
+                existing.registeredAt = endpoint.registeredAt;
+                console.log(`[registry] Endpoint updated: ${serverId} port=${endpoint.port} pid=${endpoint.pid}`);
+            }
+            else {
+                // New port (additional instance)
+                server.endpoints.push(endpoint);
+                console.log(`[registry] Endpoint added: ${serverId} port=${endpoint.port} pid=${endpoint.pid}`);
+            }
+            // Update log paths (may change if re-registered with different channels)
+            server.logPaths = serverInfo.logPaths;
+            server.logDir = serverInfo.logDir;
+            if (serverInfo.name)
+                server.name = serverInfo.name;
+        }
+        else {
+            // New server
+            server = { ...serverInfo, endpoints: [endpoint] };
+            this.servers.set(serverId, server);
+            // Update project index
+            let projectServers = this.projectIdIndex.get(server.projectId);
+            if (!projectServers) {
+                projectServers = new Set();
+                this.projectIdIndex.set(server.projectId, projectServers);
+            }
+            projectServers.add(serverId);
+            console.log(`[registry] Server registered: ${serverId} (${server.type}) dir=${server.directory} port=${endpoint.port}`);
+        }
+        // Track connection order (most recent registration at end)
+        const index = this.connectionOrder.indexOf(serverId);
+        if (index !== -1) {
+            this.connectionOrder.splice(index, 1);
+        }
+        this.connectionOrder.push(serverId);
+        emitServerEvent('register', { serverId, server });
+        return server;
+    }
+    /**
+     * Remove a specific endpoint from a server.
+     * If the server has no more endpoints, the server entry stays (browsers still affiliated).
+     */
+    removeEndpoint(serverId, port) {
+        const server = this.servers.get(serverId);
+        if (!server)
+            return;
+        server.endpoints = server.endpoints.filter(e => e.port !== port);
+        console.log(`[registry] Endpoint removed: ${serverId} port=${port} (${server.endpoints.length} remaining)`);
+        if (server.endpoints.length === 0) {
+            emitServerEvent('deregister', { serverId, server });
+        }
+    }
+    /** Remove a server entirely (explicit unregister) */
+    remove(id) {
+        const server = this.servers.get(id);
+        if (server) {
+            this.servers.delete(id);
+            const projectServers = this.projectIdIndex.get(server.projectId);
+            if (projectServers) {
+                projectServers.delete(id);
+                if (projectServers.size === 0) {
+                    this.projectIdIndex.delete(server.projectId);
+                }
+            }
+            const index = this.connectionOrder.indexOf(id);
+            if (index !== -1) {
+                this.connectionOrder.splice(index, 1);
+            }
+            console.log(`[registry] Server removed: ${id}`);
+            emitServerEvent('deregister', { serverId: id, server });
+        }
+    }
+    get(id) {
+        return this.servers.get(id);
+    }
+    getByProjectId(projectId) {
+        const serverIds = this.projectIdIndex.get(projectId);
+        if (!serverIds)
+            return [];
+        return [...serverIds].map(id => this.servers.get(id)).filter(Boolean);
+    }
+    getByDirectory(directory) {
+        return this.getAll().filter(s => s.directory === directory);
+    }
+    getAll() {
+        return Array.from(this.servers.values());
+    }
+    getByType(type) {
+        return this.getAll().filter(s => s.type === type);
+    }
+    /** Find a server that has an endpoint on this port */
+    getByPort(port) {
+        return this.getAll().find(s => s.endpoints.some(e => e.port === port));
+    }
+    getLatest() {
+        if (this.connectionOrder.length === 0)
+            return undefined;
+        const latestId = this.connectionOrder[this.connectionOrder.length - 1];
+        return this.servers.get(latestId);
+    }
+    has(id) {
+        return this.servers.has(id);
+    }
+    size() {
+        return this.servers.size;
+    }
+    /** List all registered project directories */
+    directories() {
+        return [...new Set(this.getAll().map(s => s.directory))];
+    }
+    /** Check if any endpoint on any server has a live process */
+    hasLiveEndpoints(serverId) {
+        const server = this.servers.get(serverId);
+        if (!server)
+            return false;
+        return server.endpoints.length > 0;
+    }
+    /**
+     * Remove endpoints whose processes are no longer running.
+     * Skips endpoints registered within the last 30s (grace period for process forks).
+     * Server entries are never removed — only endpoints are cleaned up.
+     */
+    cleanupDeadEndpoints() {
+        const cleaned = [];
+        const now = Date.now();
+        for (const server of this.getAll()) {
+            for (const endpoint of [...server.endpoints]) {
+                if (now - endpoint.registeredAt < 30_000)
+                    continue;
+                try {
+                    process.kill(endpoint.pid, 0);
+                }
+                catch {
+                    this.removeEndpoint(server.id, endpoint.port);
+                    cleaned.push(`${server.id}:${endpoint.port}`);
+                }
+            }
+        }
+        return cleaned;
+    }
+}
+//# sourceMappingURL=registry.js.map