@quenty/studio-bridge 0.7.1 → 0.9.0

package/dist/src/bridge/bridge-connection.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Public entry point for connecting to the studio-bridge network. Handles
+ * host/client role detection transparently. Consumers never create a
+ * BridgeHost, BridgeClient, TransportServer, or any other internal type.
+ *
+ * Use the static factory `connectAsync()` to create instances.
+ */
+import { EventEmitter } from 'events';
+import { BridgeSession } from './bridge-session.js';
+import type { SessionInfo, SessionContext, InstanceInfo } from './types.js';
+export interface BridgeConnectionOptions {
+    /** Port for the bridge host. Default: 38741. */
+    port?: number;
+    /** Max time to wait for initial connection setup. Default: 30_000ms. */
+    timeoutMs?: number;
+    /** Keep the host alive even when idle. Default: false. */
+    keepAlive?: boolean;
+    /** Skip local port-bind attempt and connect directly as client (host:port). */
+    remoteHost?: string;
+    /** Force local mode -- skip devcontainer auto-detection. */
+    local?: boolean;
+    /**
+     * When true and this process becomes the host, wait for active Studios to
+     * discover and connect before returning. Use for short-lived commands that
+     * need all sessions available immediately. Default: false.
+     */
+    waitForSessions?: boolean;
+}
+export declare class BridgeConnection extends EventEmitter {
+    private _role;
+    private _isConnected;
+    private _keepAlive;
+    private _hasSettled;
+    private _host;
+    private _tracker;
+    private _hostSessions;
+    private _hostHandles;
+    private _client;
+    private _idleTimer;
+    private constructor();
+    /**
+     * Connect to the studio-bridge network and return a ready-to-use
+     * BridgeConnection.
+     *
+     * - If remoteHost is specified: connects directly as a client.
+     * - If local is specified: skips devcontainer auto-detection, uses local mode.
+     * - If no host is running: binds the port, becomes the host.
+     * - If a host is running: connects as a client.
+     */
+    static connectAsync(options?: BridgeConnectionOptions): Promise<BridgeConnection>;
+    disconnectAsync(): Promise<void>;
+    /** Whether this process ended up as host or client. */
+    get role(): 'host' | 'client';
+    /** Whether the connection is currently active. */
+    get isConnected(): boolean;
+    /** The actual port the bridge is bound to (host) or connected to (client). */
+    get port(): number;
+    /** List all currently connected Studio sessions. */
+    listSessions(): SessionInfo[];
+    /**
+     * List unique Studio instances. Each instance groups 1-3 context sessions
+     * that share the same instanceId.
+     */
+    listInstances(): InstanceInfo[];
+    /** Get a session handle by ID. Returns undefined if not connected. */
+    getSession(sessionId: string): BridgeSession | undefined;
+    /**
+     * Resolve a session for command execution. Instance-aware: groups sessions
+     * by instanceId and auto-selects context within an instance.
+     *
+     * Algorithm (from tech-spec 07, section 6.7):
+     * 1. If sessionId -> return that specific session.
+     * 2. If instanceId -> select that instance, then apply context selection.
+     * 3. Collect unique instances.
+     * 4. 0 instances -> throw SessionNotFoundError.
+     * 5. 1 instance:
+     *    a. If context -> return matching context. Throw ContextNotFoundError if not found.
+     *    b. If 1 context -> return it.
+     *    c. If N contexts (Play mode) -> return Edit context by default.
+     * 6. N instances -> throw SessionNotFoundError with instance list.
+     */
+    resolveSessionAsync(sessionId?: string, context?: SessionContext, instanceId?: string): Promise<BridgeSession>;
+    /** Resolves with the first connected session. Rejects after timeout. */
+    waitForSessionAsync(timeout?: number): Promise<BridgeSession>;
+    /**
+     * Ensure that session discovery has completed at least once for this
+     * host connection. No-op if already settled, not a host, or sessions
+     * are already connected.
+     */
+    private _ensureSettledAsync;
+    /**
+     * Wait for all active Studios to discover this host and connect. Waits for
+     * the first session, then keeps waiting until no new sessions arrive for a
+     * full plugin poll cycle (~2.5s). Guarantees all polling plugins have had
+     * a chance to find the host. Safe to call when not a host (returns immediately).
+     */
+    waitForSessionsToSettleAsync(options?: {
+        /** Max time to wait for the first session (ms). Default: 5000 */
+        firstSessionTimeout?: number;
+        /** How long to wait after the last connection before considering settled (ms). Default: 4000 */
+        settleMs?: number;
+        /** Absolute max wait time (ms). Default: 15000 */
+        maxMs?: number;
+    }): Promise<void>;
+    private _initHostAsync;
+    private _initClientAsync;
+    private static _deriveContext;
+    private _resolveByInstance;
+    private _resetIdleTimer;
+    private _clearIdleTimer;
+}
+//# sourceMappingURL=bridge-connection.d.ts.map

package/dist/src/bridge/bridge-connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-connection.d.ts","sourceRoot":"","sources":["../../../src/bridge/bridge-connection.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAWtC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAMpD,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI5E,MAAM,WAAW,uBAAuB;IACtC,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AA+CD,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,YAAY,CAAkB;IACtC,OAAO,CAAC,UAAU,CAAU;IAC5B,OAAO,CAAC,WAAW,CAAkB;IAGrC,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,aAAa,CAAyC;IAC9D,OAAO,CAAC,YAAY,CAA+C;IAGnE,OAAO,CAAC,OAAO,CAA2B;IAG1C,OAAO,CAAC,UAAU,CAA4C;IAE9D,OAAO;IASP;;;;;;;;OAQG;WACU,YAAY,CACvB,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,gBAAgB,CAAC;IAgGtB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAmCtC,uDAAuD;IACvD,IAAI,IAAI,IAAI,MAAM,GAAG,QAAQ,CAE5B;IAED,kDAAkD;IAClD,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,8EAA8E;IAC9E,IAAI,IAAI,IAAI,MAAM,CAKjB;IAED,oDAAoD;IACpD,YAAY,IAAI,WAAW,EAAE;IAY7B;;;OAGG;IACH,aAAa,IAAI,YAAY,EAAE;IAY/B,sEAAsE;IACtE,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAYxD;;;;;;;;;;;;;;OAcG;IACG,mBAAmB,CACvB,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,cAAc,EACxB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,aAAa,CAAC;IAuCzB,wEAAwE;IAClE,mBAAmB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAkCnE;;;;OAIG;YACW,mBAAmB;IAuBjC;;;;;OAKG;IACG,4BAA4B,CAAC,OAAO,CAAC,EAAE;QAC3C,iEAAiE;QACjE,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,gGAAgG;QAChG,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,kDAAkD;QAClD,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,IAAI,CAAC;YAsCH,cAAc;YAyGd,gBAAgB;IA2B9B,OAAO,CAAC,MAAM,CAAC,cAAc;IAM7B,OAAO,CAAC,kBAAkB;IAsD1B,OAAO,CAAC,eAAe;IAyBvB,OAAO,CAAC,eAAe;CAMxB"}

package/dist/src/bridge/bridge-connection.js

@@ -0,0 +1,528 @@
+/**
+ * Public entry point for connecting to the studio-bridge network. Handles
+ * host/client role detection transparently. Consumers never create a
+ * BridgeHost, BridgeClient, TransportServer, or any other internal type.
+ *
+ * Use the static factory `connectAsync()` to create instances.
+ */
+import { EventEmitter } from 'events';
+import { BridgeHost } from './internal/bridge-host.js';
+import { BridgeClient } from './internal/bridge-client.js';
+import { SessionTracker, } from './internal/session-tracker.js';
+import { detectRoleAsync, getDefaultRemoteHost, } from './internal/environment-detection.js';
+import { BridgeSession } from './bridge-session.js';
+import { SessionNotFoundError, ContextNotFoundError } from './types.js';
+import { OutputHelper } from '@quenty/cli-output-helpers';
+const DEFAULT_PORT = 38741;
+const DEFAULT_TIMEOUT_MS = 30_000;
+const IDLE_EXIT_GRACE_MS = 5_000;
+/**
+ * Transport handle that relays messages to a plugin's WebSocket via BridgeHost.
+ * Used by SessionTracker in host mode so that BridgeSession.sendActionAsync()
+ * works the same way whether we're a host or a client.
+ */
+class HostTransportHandle extends EventEmitter {
+    _connected = true;
+    _sessionId;
+    _host;
+    constructor(sessionId, host) {
+        super();
+        this._sessionId = sessionId;
+        this._host = host;
+    }
+    get isConnected() {
+        return this._connected;
+    }
+    async sendActionAsync(message, timeoutMs) {
+        return this._host.sendToPluginAsync(this._sessionId, message, timeoutMs);
+    }
+    sendMessage(message) {
+        this._host.sendToPlugin(this._sessionId, message);
+    }
+    markDisconnected() {
+        this._connected = false;
+        this.emit('disconnected');
+    }
+}
+export class BridgeConnection extends EventEmitter {
+    _role;
+    _isConnected = false;
+    _keepAlive;
+    _hasSettled = false;
+    // Host mode internals
+    _host;
+    _tracker;
+    _hostSessions = new Map();
+    _hostHandles = new Map();
+    // Client mode internals
+    _client;
+    // Idle exit
+    _idleTimer;
+    constructor(role, keepAlive) {
+        super();
+        this._role = role;
+        this._keepAlive = keepAlive;
+        // keepAlive connections (serve mode) manage their own lifecycle —
+        // don't auto-settle in resolveSessionAsync
+        this._hasSettled = keepAlive;
+    }
+    /**
+     * Connect to the studio-bridge network and return a ready-to-use
+     * BridgeConnection.
+     *
+     * - If remoteHost is specified: connects directly as a client.
+     * - If local is specified: skips devcontainer auto-detection, uses local mode.
+     * - If no host is running: binds the port, becomes the host.
+     * - If a host is running: connects as a client.
+     */
+    static async connectAsync(options) {
+        const keepAlive = options?.keepAlive ?? false;
+        const remoteHost = options?.remoteHost;
+        let parsedRemoteHost;
+        let port = options?.port ?? DEFAULT_PORT;
+        if (remoteHost) {
+            if (remoteHost.includes(':')) {
+                const parts = remoteHost.split(':');
+                parsedRemoteHost = remoteHost;
+                port = parseInt(parts[parts.length - 1], 10) || DEFAULT_PORT;
+            }
+            else {
+                parsedRemoteHost = `${remoteHost}:${port}`;
+            }
+        }
+        // Devcontainer auto-detection: if no explicit remoteHost and not forced local,
+        // try connecting to the default remote host with a short timeout before falling
+        // back to local mode.
+        if (!parsedRemoteHost && !options?.local) {
+            const autoRemoteHost = getDefaultRemoteHost();
+            if (autoRemoteHost) {
+                const AUTO_DETECT_TIMEOUT_MS = 3_000;
+                try {
+                    const autoConn = new BridgeConnection('client', keepAlive);
+                    const autoHost = autoRemoteHost.split(':')[0];
+                    const autoPort = parseInt(autoRemoteHost.split(':')[1], 10) || DEFAULT_PORT;
+                    await Promise.race([
+                        autoConn._initClientAsync(autoPort, autoHost),
+                        new Promise((_, reject) => setTimeout(() => reject(new Error('Auto-detection timed out')), AUTO_DETECT_TIMEOUT_MS)),
+                    ]);
+                    return autoConn;
+                }
+                catch {
+                    console.warn(`Devcontainer detected, but could not connect to bridge host at ${autoRemoteHost}. ` +
+                        `Falling back to local mode. Run \`studio-bridge serve\` on the host OS, ` +
+                        `or use --remote to specify a different address.`);
+                }
+            }
+        }
+        const detection = await detectRoleAsync({
+            port,
+            remoteHost: parsedRemoteHost,
+        });
+        const conn = new BridgeConnection(detection.role, keepAlive);
+        OutputHelper.verbose(`[bridge] Role: ${detection.role}, port: ${detection.port}`);
+        if (detection.role === 'host') {
+            await conn._initHostAsync(detection.port);
+        }
+        else {
+            try {
+                await conn._initClientAsync(detection.port, parsedRemoteHost);
+            }
+            catch (err) {
+                if (parsedRemoteHost && err instanceof Error) {
+                    const code = err.code;
+                    if (code === 'ECONNREFUSED') {
+                        throw new Error(`Could not connect to bridge host at ${parsedRemoteHost}. ` +
+                            `Is \`studio-bridge serve\` running on the host?`);
+                    }
+                    if (err.message.includes('timed out') ||
+                        err.message.includes('timeout')) {
+                        throw new Error(`Connection to bridge host at ${parsedRemoteHost} timed out after 5 seconds.`);
+                    }
+                }
+                throw err;
+            }
+        }
+        // If requested, wait for active Studios to discover this host and connect
+        if (conn._role === 'host' && options?.waitForSessions) {
+            await conn._ensureSettledAsync();
+        }
+        return conn;
+    }
+    async disconnectAsync() {
+        if (!this._isConnected) {
+            return;
+        }
+        OutputHelper.verbose(`[bridge] disconnectAsync called (role=${this._role})`);
+        OutputHelper.verbose(`[bridge] disconnect stack: ${new Error().stack
+            ?.split('\n')
+            .slice(1, 5)
+            .map((s) => s.trim())
+            .join(' <- ')}`);
+        this._clearIdleTimer();
+        this._isConnected = false;
+        if (this._role === 'host' && this._host) {
+            for (const handle of this._hostHandles.values()) {
+                handle.markDisconnected();
+            }
+            await this._host.shutdownAsync();
+            this._host = undefined;
+            this._tracker = undefined;
+            this._hostSessions.clear();
+            this._hostHandles.clear();
+        }
+        if (this._role === 'client' && this._client) {
+            await this._client.disconnectAsync();
+            this._client = undefined;
+        }
+    }
+    /** Whether this process ended up as host or client. */
+    get role() {
+        return this._role;
+    }
+    /** Whether the connection is currently active. */
+    get isConnected() {
+        return this._isConnected;
+    }
+    /** The actual port the bridge is bound to (host) or connected to (client). */
+    get port() {
+        if (this._role === 'host' && this._host) {
+            return this._host.port;
+        }
+        return 0;
+    }
+    /** List all currently connected Studio sessions. */
+    listSessions() {
+        if (this._role === 'host' && this._tracker) {
+            return this._tracker.listSessions();
+        }
+        if (this._role === 'client' && this._client) {
+            return this._client.listSessions();
+        }
+        return [];
+    }
+    /**
+     * List unique Studio instances. Each instance groups 1-3 context sessions
+     * that share the same instanceId.
+     */
+    listInstances() {
+        if (this._role === 'host' && this._tracker) {
+            return this._tracker.listInstances();
+        }
+        if (this._role === 'client' && this._client) {
+            return this._client.listInstances();
+        }
+        return [];
+    }
+    /** Get a session handle by ID. Returns undefined if not connected. */
+    getSession(sessionId) {
+        if (this._role === 'host') {
+            return this._hostSessions.get(sessionId);
+        }
+        if (this._role === 'client' && this._client) {
+            return this._client.getSession(sessionId);
+        }
+        return undefined;
+    }
+    /**
+     * Resolve a session for command execution. Instance-aware: groups sessions
+     * by instanceId and auto-selects context within an instance.
+     *
+     * Algorithm (from tech-spec 07, section 6.7):
+     * 1. If sessionId -> return that specific session.
+     * 2. If instanceId -> select that instance, then apply context selection.
+     * 3. Collect unique instances.
+     * 4. 0 instances -> throw SessionNotFoundError.
+     * 5. 1 instance:
+     *    a. If context -> return matching context. Throw ContextNotFoundError if not found.
+     *    b. If 1 context -> return it.
+     *    c. If N contexts (Play mode) -> return Edit context by default.
+     * 6. N instances -> throw SessionNotFoundError with instance list.
+     */
+    async resolveSessionAsync(sessionId, context, instanceId) {
+        // Fresh host hasn't settled yet — wait for persistent plugins to discover us
+        await this._ensureSettledAsync();
+        if (sessionId) {
+            const session = this.getSession(sessionId);
+            if (session) {
+                return session;
+            }
+            throw new SessionNotFoundError(`Session '${sessionId}' not found`, sessionId);
+        }
+        if (instanceId) {
+            return this._resolveByInstance(instanceId, context);
+        }
+        const instances = this.listInstances();
+        if (instances.length === 0) {
+            throw new SessionNotFoundError('No sessions connected');
+        }
+        if (instances.length === 1) {
+            return this._resolveByInstance(instances[0].instanceId, context);
+        }
+        // Multiple instances: list session IDs so the user can copy one into --session
+        const sessionList = this.listSessions()
+            .map((s) => `  - ${s.sessionId}: ${s.placeName} (${s.context})`)
+            .join('\n');
+        throw new SessionNotFoundError(`Multiple Studio instances connected. Use --session <id> to select one.\n${sessionList}`);
+    }
+    /** Resolves with the first connected session. Rejects after timeout. */
+    async waitForSessionAsync(timeout) {
+        const sessions = this.listSessions();
+        if (sessions.length > 0) {
+            const session = this.getSession(sessions[0].sessionId);
+            if (session) {
+                return session;
+            }
+        }
+        const timeoutMs = timeout ?? DEFAULT_TIMEOUT_MS;
+        return new Promise((resolve, reject) => {
+            let timer;
+            const onSession = (session) => {
+                if (timer) {
+                    clearTimeout(timer);
+                }
+                resolve(session);
+            };
+            timer = setTimeout(() => {
+                this.off('session-connected', onSession);
+                reject(new Error(`Timed out waiting for a session to connect (${timeoutMs}ms)`));
+            }, timeoutMs);
+            this.once('session-connected', onSession);
+        });
+    }
+    /**
+     * Ensure that session discovery has completed at least once for this
+     * host connection. No-op if already settled, not a host, or sessions
+     * are already connected.
+     */
+    async _ensureSettledAsync() {
+        if (this._hasSettled ||
+            this._role !== 'host' ||
+            this.listSessions().length > 0) {
+            return;
+        }
+        OutputHelper.verbose('[bridge] No sessions yet — waiting for plugins to discover us');
+        await this.waitForSessionsToSettleAsync();
+        this._hasSettled = true;
+        const settled = this.listSessions();
+        OutputHelper.verbose(`[bridge] Settled with ${settled.length} session(s)${settled.length > 0
+            ? ': ' + settled.map((s) => s.sessionId).join(', ')
+            : ''}`);
+    }
+    /**
+     * Wait for all active Studios to discover this host and connect. Waits for
+     * the first session, then keeps waiting until no new sessions arrive for a
+     * full plugin poll cycle (~2.5s). Guarantees all polling plugins have had
+     * a chance to find the host. Safe to call when not a host (returns immediately).
+     */
+    async waitForSessionsToSettleAsync(options) {
+        if (this._role !== 'host') {
+            return;
+        }
+        const firstTimeout = options?.firstSessionTimeout ?? 5_000;
+        const settleMs = options?.settleMs ?? 4_000;
+        const maxMs = options?.maxMs ?? 15_000;
+        // Wait for the first session
+        try {
+            await this.waitForSessionAsync(firstTimeout);
+        }
+        catch {
+            // No session appeared — nothing to settle
+            return;
+        }
+        // Wait for sessions to stabilize: reset timer on each new connection
+        await new Promise((resolve) => {
+            const cleanup = () => {
+                clearTimeout(settleTimer);
+                clearTimeout(maxTimer);
+                this.off('session-connected', onSession);
+                resolve();
+            };
+            const onSession = () => {
+                clearTimeout(settleTimer);
+                settleTimer = setTimeout(cleanup, settleMs);
+            };
+            let settleTimer = setTimeout(cleanup, settleMs);
+            const maxTimer = setTimeout(cleanup, maxMs);
+            this.on('session-connected', onSession);
+        });
+    }
+    async _initHostAsync(port) {
+        this._host = new BridgeHost();
+        this._tracker = new SessionTracker();
+        this._tracker.on('session-added', (tracked) => {
+            const session = new BridgeSession(tracked.info, tracked.handle);
+            this._hostSessions.set(tracked.info.sessionId, session);
+            this.emit('session-connected', session);
+            this._resetIdleTimer();
+            this._host?.broadcastToClients({
+                type: 'session-event',
+                event: 'connected',
+                sessionId: tracked.info.sessionId,
+                session: tracked.info,
+                context: tracked.info.context,
+                instanceId: tracked.info.instanceId,
+            });
+        });
+        this._tracker.on('session-removed', (sessionId) => {
+            const removed = this._hostSessions.get(sessionId);
+            this._hostSessions.delete(sessionId);
+            this._hostHandles.delete(sessionId);
+            this.emit('session-disconnected', sessionId);
+            this._resetIdleTimer();
+            this._host?.broadcastToClients({
+                type: 'session-event',
+                event: 'disconnected',
+                sessionId,
+                context: removed?.info.context ?? 'edit',
+                instanceId: removed?.info.instanceId ?? sessionId,
+            });
+        });
+        this._tracker.on('instance-added', (instance) => {
+            this.emit('instance-connected', instance);
+        });
+        this._tracker.on('instance-removed', (instanceId) => {
+            this.emit('instance-disconnected', instanceId);
+        });
+        this._host.on('plugin-connected', (info) => {
+            const state = info.state ?? 'Edit';
+            const context = BridgeConnection._deriveContext(state);
+            const sessionInfo = {
+                sessionId: info.sessionId,
+                placeName: info.placeName ?? '',
+                placeFile: info.placeFile,
+                state: state,
+                pluginVersion: info.pluginVersion ?? '',
+                capabilities: info.capabilities,
+                connectedAt: new Date(),
+                origin: 'user',
+                context,
+                instanceId: info.instanceId ?? info.sessionId,
+                placeId: 0,
+                gameId: 0,
+            };
+            const handle = new HostTransportHandle(info.sessionId, this._host);
+            this._hostHandles.set(info.sessionId, handle);
+            this._tracker.addSession(info.sessionId, sessionInfo, handle);
+        });
+        this._host.on('plugin-disconnected', (sessionId) => {
+            const handle = this._hostHandles.get(sessionId);
+            if (handle) {
+                handle.markDisconnected();
+            }
+            this._tracker.removeSession(sessionId);
+        });
+        // Handle client protocol messages (list-sessions, list-instances, etc.)
+        this._host.on('client-message', (msg, reply) => {
+            if (msg.type === 'list-sessions') {
+                const req = msg;
+                reply({
+                    type: 'list-sessions-response',
+                    requestId: req.requestId,
+                    sessions: this._tracker.listSessions(),
+                });
+            }
+            else if (msg.type === 'list-instances') {
+                const req = msg;
+                reply({
+                    type: 'list-instances-response',
+                    requestId: req.requestId,
+                    instances: this._tracker.listInstances(),
+                });
+            }
+        });
+        await this._host.startAsync({ port });
+        this._isConnected = true;
+        // Don't start idle timer on init -- callers like `sessions` manage their
+        // own lifecycle via disconnectAsync().  The idle timer should only fire
+        // when sessions are removed (going from >0 to 0).
+    }
+    async _initClientAsync(port, remoteHost) {
+        this._client = new BridgeClient();
+        this._client.on('session-connected', (session) => {
+            this.emit('session-connected', session);
+        });
+        this._client.on('session-disconnected', (sessionId) => {
+            this.emit('session-disconnected', sessionId);
+        });
+        this._client.on('disconnected', () => {
+            this._isConnected = false;
+        });
+        this._client.on('host-promoted', () => {
+            this._role = 'host';
+        });
+        const host = remoteHost ? remoteHost.split(':')[0] : undefined;
+        await this._client.connectAsync(port, host);
+        this._isConnected = true;
+    }
+    static _deriveContext(state) {
+        if (state === 'Server')
+            return 'server';
+        if (state === 'Client')
+            return 'client';
+        return 'edit';
+    }
+    _resolveByInstance(instanceId, context) {
+        const sessions = this.listSessions().filter((s) => s.instanceId === instanceId);
+        if (sessions.length === 0) {
+            throw new SessionNotFoundError(`Instance '${instanceId}' not found`);
+        }
+        const contexts = sessions.map((s) => s.context);
+        // 5a: Context specified
+        if (context) {
+            const match = sessions.find((s) => s.context === context);
+            if (match) {
+                const session = this.getSession(match.sessionId);
+                if (session) {
+                    return session;
+                }
+            }
+            throw new ContextNotFoundError(context, instanceId, contexts);
+        }
+        // 5b: Single context
+        if (sessions.length === 1) {
+            const session = this.getSession(sessions[0].sessionId);
+            if (session) {
+                return session;
+            }
+        }
+        // 5c: Multiple contexts -> return Edit
+        const editSession = sessions.find((s) => s.context === 'edit');
+        if (editSession) {
+            const session = this.getSession(editSession.sessionId);
+            if (session) {
+                return session;
+            }
+        }
+        // Fallback: return first session
+        const fallback = this.getSession(sessions[0].sessionId);
+        if (fallback) {
+            return fallback;
+        }
+        throw new SessionNotFoundError(`No session found for instance '${instanceId}'`);
+    }
+    _resetIdleTimer() {
+        if (this._keepAlive) {
+            return;
+        }
+        this._clearIdleTimer();
+        // Only start idle timer if we're the host and have no sessions
+        if (this._role === 'host' && this._tracker) {
+            if (this._tracker.sessionCount === 0) {
+                OutputHelper.verbose(`[bridge] Starting idle exit timer (${IDLE_EXIT_GRACE_MS}ms, sessionCount=0)`);
+                this._idleTimer = setTimeout(() => {
+                    OutputHelper.verbose('[bridge] Idle exit timer fired — disconnecting');
+                    this.disconnectAsync().catch(() => {
+                        // Ignore disconnect errors during idle shutdown
+                    });
+                }, IDLE_EXIT_GRACE_MS);
+            }
+        }
+    }
+    _clearIdleTimer() {
+        if (this._idleTimer !== undefined) {
+            clearTimeout(this._idleTimer);
+            this._idleTimer = undefined;
+        }
+    }
+}
+//# sourceMappingURL=bridge-connection.js.map

package/dist/src/bridge/bridge-connection.js.map

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