green-screen-proxy 1.3.8 → 1.4.0

package/dist/session.d.ts

@@ -10,12 +10,54 @@ export declare class Session extends EventEmitter {
     private _host;
     private _port;
     private _idleTimer;
+    private _connectWatchdog;
     private _lastActivity;
+    /** The options the session was last connected with. Replayed verbatim on
+     *  reconnect() so a stable display device name (DEVNAME), code page and
+     *  terminal type survive a reconnect — otherwise the host would auto-assign a
+     *  fresh QPADEVxxxx and the reattach-by-device-name guarantee would break. */
+    private _connectOptions?;
+    /** When true (set via the ``autoReconnect`` connect option), the proxy itself
+     *  re-establishes the TCP on an UNEXPECTED host drop — replaying the stable
+     *  DEVNAME — and emits ``session.reconnected`` so the integrator re-drives only
+     *  sign-on, instead of detecting staleness and opening a fresh session. Off by
+     *  default (legacy: the integrator owns all recovery). */
+    private _autoReconnect;
+    /** Set on any caller-initiated teardown so the auto-reconnect path stands
+     *  down — we only auto-recover from drops we did NOT ask for. */
+    private _intentionalClose;
+    /** Guards the auto-reconnect loop against re-entrancy. */
+    private _reconnecting;
+    /** Server-side single-writer lock. When non-null, an exclusive driver (e.g.
+     *  ``agent:<id>`` set by the integrator for the duration of an automated run)
+     *  owns input — the proxy rejects WS key/text/cursor commands from anyone else,
+     *  so a dashboard operator can't type into a session mid-transaction even if a
+     *  client-side guard fails. Null = unlocked (interactive clients may drive). */
+    private _driveHolder;
     /** Timeout (ms) to wait for screen data after connect or key send (default 5000) */
     screenTimeout: number;
-    /** Idle timeout (ms) — session auto-destroys if no activity. Default 5 min.
-     *  Prevents stale TCP sessions when the backend crashes or misses a disconnect call. */
+    /** Idle timeout (ms) — session auto-destroys if no REST/screen activity.
+     *  Safety net for backend crashes; the backend's own keepalive handles
+     *  IBM i QINACTITV separately. 30 min is long enough that hot-reload
+     *  restarts and slow startup sequences don't race against this timer. */
     static IDLE_TIMEOUT: number;
+    /** Default connect-watchdog deadline (ms) for a session pinned in
+     *  'connecting'. The idle timer only arms AFTER a successful connect, so a
+     *  connect that never completes — a TCP blackhole (SYN with no SYN-ACK/RST),
+     *  or a reject the caller forgot to tear down — would otherwise leave the
+     *  session in the store forever holding a half-open socket. This watchdog is
+     *  the backstop: 30s default socket connectTimeout + the grace below. */
+    static CONNECT_TIMEOUT: number;
+    /** Grace (ms) added on top of the socket's own connectTimeout before the
+     *  watchdog reaps. Keeps the watchdog strictly a backstop — the socket-level
+     *  timeout/reject (and the caller's error handling) get first crack at a
+     *  failed connect; the watchdog only fires when that path doesn't. */
+    static CONNECT_WATCHDOG_GRACE: number;
+    /** Backoff schedule (ms) for proxy-driven auto-reconnect after an unexpected
+     *  host drop. Bounded + capped so a host that's truly down can't be stormed
+     *  (respects IBM i QMAXSIGN); on exhaustion the session reports ``session.lost``
+     *  and the integrator's own reconnect policy takes over. */
+    static RECONNECT_BACKOFF_MS: number[];
     constructor(protocol?: ProtocolType);
     /** Reset idle timer — called on any API activity (screen read, key send, etc.) */
     touch(): void;
@@ -23,15 +65,42 @@ export declare class Session extends EventEmitter {
     startIdleTimer(): void;
     /** Stop the idle timer. */
     stopIdleTimer(): void;
+    /** Arm the connect watchdog. Called when the session enters 'connecting'.
+     *  If it's still 'connecting' when the deadline elapses, the session never
+     *  connected — destroy it so it can't leak in the store. A successful
+     *  connect (or any teardown) clears it first. */
+    private startConnectWatchdog;
+    /** Stop the connect watchdog. */
+    private stopConnectWatchdog;
     get status(): ConnectionStatus;
+    /** The current exclusive input owner, or null when unlocked. */
+    get driveHolder(): string | null;
+    /** Claim exclusive input for ``holder``. Idempotent for the same holder;
+     *  refused (returns false) if a different holder already owns it. */
+    acquireDrive(holder: string): boolean;
+    /** Release the input lock. A ``holder`` mismatch is ignored (returns false)
+     *  so a stale releaser can't free a lock it doesn't own; pass no holder to
+     *  force-release (teardown). */
+    releaseDrive(holder?: string): boolean;
     /** Mark this session as authenticated after a successful auto-sign-in */
     markAuthenticated(username: string): void;
     connect(host: string, port: number, options?: ProtocolOptions): Promise<void>;
     disconnect(): void;
     reconnect(): Promise<void>;
+    /**
+     * Proxy-driven recovery from an UNEXPECTED host drop (autoReconnect sessions
+     * only). Re-establishes the TCP with the original connect options (so the
+     * stable DEVNAME makes IBM i reattach the disconnected job instead of minting
+     * a fresh QPADEVxxxx), with bounded backoff. On success it emits
+     * ``session.reconnected`` with ``needsSignOn`` so the integrator re-drives only
+     * its sign-on cascade (the proxy holds no credentials). On exhaustion it emits
+     * ``session.lost`` and the integrator's own reconnect policy takes over.
+     */
+    private _attemptAutoReconnect;
     sendText(text: string): boolean;
     sendKey(keyName: string): boolean;
     setCursor(row: number, col: number): boolean;
+    eraseEOF(): boolean;
     getScreenData(): ScreenData;
     /** Read input field values from the current screen.
      *  @param modifiedOnly — when true (default), only fields with MDT bit set. */

package/dist/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,eAAe,EAAyB,MAAM,sBAAsB,CAAC;AAC9E,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACtF,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGvE,qBAAa,OAAQ,SAAQ,YAAY;IACvC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAEhC,OAAO,CAAC,OAAO,CAAkE;IACjF,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,aAAa,CAAsB;IAE3C,oFAAoF;IACpF,aAAa,EAAE,MAAM,CAAQ;IAE7B;4FACwF;IACxF,MAAM,CAAC,YAAY,SAAiB;gBAExB,QAAQ,GAAE,YAAuB;IA4B7C,kFAAkF;IAClF,KAAK,IAAI,IAAI;IAIb,kEAAkE;IAClE,cAAc,IAAI,IAAI;IAUtB,2BAA2B;IAC3B,aAAa,IAAI,IAAI;IAOrB,IAAI,MAAM,IAAI,gBAAgB,CAE7B;IAED,yEAAyE;IACzE,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IASnC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAcnF,UAAU,IAAI,IAAI;IAOZ,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAKhC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI/B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIjC,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5C,aAAa;IAIb;mFAC+E;IAC/E,eAAe,CAAC,YAAY,GAAE,OAAc,GAAG,UAAU,EAAE;IAK3D,qFAAqF;IACrF,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAKlF,mFAAmF;IACnF,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAUrD;;2CAEuC;IACvC,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,UAAU,CAAA;KAAE,CAAC;IAwBhG,OAAO,IAAI,IAAI;IAMf;;;;;;;;OAQG;IACG,eAAe,CAAC,SAAS,GAAE,MAAa,GAAG,OAAO,CAAC,IAAI,CAAC;CAa/D;AAMD,wBAAgB,aAAa,CAAC,QAAQ,GAAE,YAAuB,GAAG,OAAO,CAIxE;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAE1D;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAO/C;AAED;;;;GAIG;AACH,wBAAsB,wBAAwB,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,GAAE,MAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CASlG;AAED,wBAAgB,iBAAiB,IAAI,OAAO,GAAG,SAAS,CAMvD;AAED,wBAAgB,cAAc,IAAI,OAAO,EAAE,CAE1C"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"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"}

package/dist/session.js

@@ -10,12 +10,54 @@ export class Session extends EventEmitter {
     _host = '';
     _port = 23;
     _idleTimer = null;
+    _connectWatchdog = null;
     _lastActivity = Date.now();
+    /** The options the session was last connected with. Replayed verbatim on
+     *  reconnect() so a stable display device name (DEVNAME), code page and
+     *  terminal type survive a reconnect — otherwise the host would auto-assign a
+     *  fresh QPADEVxxxx and the reattach-by-device-name guarantee would break. */
+    _connectOptions;
+    /** When true (set via the ``autoReconnect`` connect option), the proxy itself
+     *  re-establishes the TCP on an UNEXPECTED host drop — replaying the stable
+     *  DEVNAME — and emits ``session.reconnected`` so the integrator re-drives only
+     *  sign-on, instead of detecting staleness and opening a fresh session. Off by
+     *  default (legacy: the integrator owns all recovery). */
+    _autoReconnect = false;
+    /** Set on any caller-initiated teardown so the auto-reconnect path stands
+     *  down — we only auto-recover from drops we did NOT ask for. */
+    _intentionalClose = false;
+    /** Guards the auto-reconnect loop against re-entrancy. */
+    _reconnecting = false;
+    /** Server-side single-writer lock. When non-null, an exclusive driver (e.g.
+     *  ``agent:<id>`` set by the integrator for the duration of an automated run)
+     *  owns input — the proxy rejects WS key/text/cursor commands from anyone else,
+     *  so a dashboard operator can't type into a session mid-transaction even if a
+     *  client-side guard fails. Null = unlocked (interactive clients may drive). */
+    _driveHolder = null;
     /** Timeout (ms) to wait for screen data after connect or key send (default 5000) */
     screenTimeout = 5000;
-    /** Idle timeout (ms) — session auto-destroys if no activity. Default 5 min.
-     *  Prevents stale TCP sessions when the backend crashes or misses a disconnect call. */
-    static IDLE_TIMEOUT = 5 * 60 * 1000;
+    /** Idle timeout (ms) — session auto-destroys if no REST/screen activity.
+     *  Safety net for backend crashes; the backend's own keepalive handles
+     *  IBM i QINACTITV separately. 30 min is long enough that hot-reload
+     *  restarts and slow startup sequences don't race against this timer. */
+    static IDLE_TIMEOUT = 30 * 60 * 1000;
+    /** Default connect-watchdog deadline (ms) for a session pinned in
+     *  'connecting'. The idle timer only arms AFTER a successful connect, so a
+     *  connect that never completes — a TCP blackhole (SYN with no SYN-ACK/RST),
+     *  or a reject the caller forgot to tear down — would otherwise leave the
+     *  session in the store forever holding a half-open socket. This watchdog is
+     *  the backstop: 30s default socket connectTimeout + the grace below. */
+    static CONNECT_TIMEOUT = 45 * 1000;
+    /** Grace (ms) added on top of the socket's own connectTimeout before the
+     *  watchdog reaps. Keeps the watchdog strictly a backstop — the socket-level
+     *  timeout/reject (and the caller's error handling) get first crack at a
+     *  failed connect; the watchdog only fires when that path doesn't. */
+    static CONNECT_WATCHDOG_GRACE = 15 * 1000;
+    /** Backoff schedule (ms) for proxy-driven auto-reconnect after an unexpected
+     *  host drop. Bounded + capped so a host that's truly down can't be stormed
+     *  (respects IBM i QMAXSIGN); on exhaustion the session reports ``session.lost``
+     *  and the integrator's own reconnect policy takes over. */
+    static RECONNECT_BACKOFF_MS = [2000, 4000, 8000, 15000, 30000];
     constructor(protocol = 'tn5250') {
         super();
         this.id = randomUUID();
@@ -29,12 +71,25 @@ export class Session extends EventEmitter {
             this._status = { connected: false, status: 'disconnected', protocol: this.protocol, host: this._host };
             this.stopIdleTimer();
             this.emit('statusChange', this._status);
+            // Auto-reconnect path: an UNEXPECTED drop on an autoReconnect session is
+            // recovered in place (proxy re-establishes the TCP on the same DEVNAME).
+            // We do NOT emit session.lost here — that would unbind the connect-by-key
+            // mapping and let a fresh session open. session.lost is emitted only if
+            // auto-reconnect exhausts its attempts.
+            if (this._autoReconnect && !this._intentionalClose) {
+                this._attemptAutoReconnect().catch(() => { });
+                return;
+            }
             sessionLifecycle.emit('session.lost', this.id, this._status);
         });
         this.handler.on('error', (err) => {
             this._status = { connected: false, status: 'error', protocol: this.protocol, host: this._host, error: err.message };
             this.emit('statusChange', this._status);
-            sessionLifecycle.emit('session.lost', this.id, this._status);
+            // For an autoReconnect session, let the ensuing disconnect drive recovery
+            // (don't unbind the key via session.lost first).
+            if (!(this._autoReconnect && !this._intentionalClose)) {
+                sessionLifecycle.emit('session.lost', this.id, this._status);
+            }
             // Close the upstream TCP socket on unrecoverable protocol errors.
             // Without this, a parser exception would leak the half-open 5250
             // session on the host until the 5-min idle timeout — and on IBM i
@@ -54,8 +109,11 @@ export class Session extends EventEmitter {
         this.stopIdleTimer();
         this._idleTimer = setInterval(() => {
             if (Date.now() - this._lastActivity > Session.IDLE_TIMEOUT) {
-                console.log(`[Session ${this.id.slice(0, 8)}] Idle timeout (${Session.IDLE_TIMEOUT / 1000}s) — destroying`);
-                destroySession(this.id);
+                console.log(`[Session ${this.id.slice(0, 8)}] Idle timeout (${Session.IDLE_TIMEOUT / 1000}s) — signing off`);
+                // Graceful SIGNOFF + TCP close, not a bare destroy: a hard drop leaves
+                // the IBM i QPADEV device hanging (it accumulates and, under churn,
+                // trips QMAXSIGN/QAUTOVRT and gets disabled). Best-effort + non-blocking.
+                void gracefullyDestroySession(this.id).catch(() => { });
             }
         }, 30_000); // Check every 30s
     }
@@ -66,9 +124,58 @@ export class Session extends EventEmitter {
             this._idleTimer = null;
         }
     }
+    /** Arm the connect watchdog. Called when the session enters 'connecting'.
+     *  If it's still 'connecting' when the deadline elapses, the session never
+     *  connected — destroy it so it can't leak in the store. A successful
+     *  connect (or any teardown) clears it first. */
+    startConnectWatchdog(deadlineMs) {
+        this.stopConnectWatchdog();
+        this._connectWatchdog = setTimeout(() => {
+            this._connectWatchdog = null;
+            // Reap only if the session never left 'connecting'. A successful
+            // connect flips status to 'connected'/'authenticated' (and clears this
+            // timer); a connect that hung — or rejected without the caller tearing
+            // the session down — is still pinned here.
+            if (this._status.status !== 'connecting')
+                return;
+            console.log(`[connect-reap] Session ${this.id.slice(0, 8)} stuck in 'connecting' for ${Math.round(deadlineMs / 1000)}s — destroying (never connected)`);
+            // Bare destroy, not a graceful SIGNOFF: the TCP connect never
+            // completed, so there is no signed-on host job to end. This closes any
+            // half-open socket and drops the store entry.
+            destroySession(this.id);
+        }, deadlineMs);
+    }
+    /** Stop the connect watchdog. */
+    stopConnectWatchdog() {
+        if (this._connectWatchdog) {
+            clearTimeout(this._connectWatchdog);
+            this._connectWatchdog = null;
+        }
+    }
     get status() {
         return { ...this._status };
     }
+    /** The current exclusive input owner, or null when unlocked. */
+    get driveHolder() {
+        return this._driveHolder;
+    }
+    /** Claim exclusive input for ``holder``. Idempotent for the same holder;
+     *  refused (returns false) if a different holder already owns it. */
+    acquireDrive(holder) {
+        if (this._driveHolder && this._driveHolder !== holder)
+            return false;
+        this._driveHolder = holder;
+        return true;
+    }
+    /** Release the input lock. A ``holder`` mismatch is ignored (returns false)
+     *  so a stale releaser can't free a lock it doesn't own; pass no holder to
+     *  force-release (teardown). */
+    releaseDrive(holder) {
+        if (holder !== undefined && this._driveHolder && this._driveHolder !== holder)
+            return false;
+        this._driveHolder = null;
+        return true;
+    }
     /** Mark this session as authenticated after a successful auto-sign-in */
     markAuthenticated(username) {
         this._status = {
@@ -81,23 +188,100 @@ export class Session extends EventEmitter {
     async connect(host, port, options) {
         this._host = host;
         this._port = port;
+        // Remember the options so reconnect() can replay them (esp. DEVNAME).
+        this._connectOptions = options;
+        // Opt-in proxy-driven recovery: when set, an unexpected host drop is
+        // re-established in place rather than surfaced as a lost session.
+        this._autoReconnect = !!options?.autoReconnect;
+        this._intentionalClose = false;
         this._status = { connected: false, status: 'connecting', protocol: this.protocol, host };
         this.emit('statusChange', this._status);
+        // Arm the connect watchdog before awaiting the handshake. Sit it beyond
+        // the socket's own connectTimeout (default 30s) so it only fires when the
+        // socket-level timeout/reject fails to. If handler.connect() hangs or
+        // rejects without the caller cleaning up, the watchdog reaps the session.
+        const socketConnectTimeout = options?.connectTimeout;
+        const deadlineMs = typeof socketConnectTimeout === 'number' && socketConnectTimeout > 0
+            ? socketConnectTimeout + Session.CONNECT_WATCHDOG_GRACE
+            : Session.CONNECT_TIMEOUT;
+        this.startConnectWatchdog(deadlineMs);
         await this.handler.connect(host, port, options);
+        this.stopConnectWatchdog();
         this._status = { connected: true, status: 'connected', protocol: this.protocol, host };
         this.touch();
         this.startIdleTimer();
         this.emit('statusChange', this._status);
     }
     disconnect() {
+        this._intentionalClose = true;
         this.stopIdleTimer();
+        this.stopConnectWatchdog();
         this.handler.disconnect();
         this._status = { connected: false, status: 'disconnected', protocol: this.protocol, host: this._host };
         this.emit('statusChange', this._status);
     }
     async reconnect() {
         this.disconnect();
-        await this.connect(this._host, this._port);
+        // Replay the original connect options so the reconnect keeps the same
+        // stable device name / code page / terminal type — without them the host
+        // auto-assigns a fresh QPADEVxxxx and the device-reattach guarantee breaks.
+        await this.connect(this._host, this._port, this._connectOptions);
+    }
+    /**
+     * Proxy-driven recovery from an UNEXPECTED host drop (autoReconnect sessions
+     * only). Re-establishes the TCP with the original connect options (so the
+     * stable DEVNAME makes IBM i reattach the disconnected job instead of minting
+     * a fresh QPADEVxxxx), with bounded backoff. On success it emits
+     * ``session.reconnected`` with ``needsSignOn`` so the integrator re-drives only
+     * its sign-on cascade (the proxy holds no credentials). On exhaustion it emits
+     * ``session.lost`` and the integrator's own reconnect policy takes over.
+     */
+    async _attemptAutoReconnect() {
+        if (this._reconnecting || this._intentionalClose)
+            return;
+        this._reconnecting = true;
+        // Tell watchers the proxy has taken ownership of recovery so an integrator
+        // with its own stale-detection/watchdog stands down instead of racing us
+        // into a second reconnect. We always conclude with session.reconnected
+        // (success) or session.lost (exhaustion), so the integrator never defers
+        // forever.
+        sessionLifecycle.emit('session.reconnecting', this.id);
+        const schedule = Session.RECONNECT_BACKOFF_MS;
+        try {
+            for (let attempt = 0; attempt < schedule.length; attempt++) {
+                await new Promise((r) => setTimeout(r, schedule[attempt]));
+                if (this._intentionalClose)
+                    return;
+                this._status = { connected: false, status: 'connecting', protocol: this.protocol, host: this._host };
+                this.emit('statusChange', this._status);
+                try {
+                    await this.handler.connect(this._host, this._port, this._connectOptions);
+                }
+                catch (err) {
+                    console.warn(`[auto-reconnect] Session ${this.id.slice(0, 8)} attempt ${attempt + 1}/${schedule.length} failed: ${err instanceof Error ? err.message : String(err)}`);
+                    continue;
+                }
+                if (this._intentionalClose) {
+                    try {
+                        this.handler.disconnect();
+                    }
+                    catch { /* ignore */ }
+                    return;
+                }
+                this._status = { connected: true, status: 'connected', protocol: this.protocol, host: this._host };
+                this.touch();
+                this.startIdleTimer();
+                this.emit('statusChange', this._status);
+                console.log(`[auto-reconnect] Session ${this.id.slice(0, 8)} re-established TCP on attempt ${attempt + 1} — signalling needsSignOn`);
+                sessionLifecycle.emit('session.reconnected', this.id, { needsSignOn: true });
+                return;
+            }
+            console.warn(`[auto-reconnect] Session ${this.id.slice(0, 8)} exhausted ${schedule.length} attempts — reporting lost`);
+            sessionLifecycle.emit('session.lost', this.id, this._status);
+        }
+        finally {
+            this._reconnecting = false;
+        }
     }
     sendText(text) {
         return this.handler.sendText(text);
@@ -108,6 +292,9 @@ export class Session extends EventEmitter {
     setCursor(row, col) {
         return this.handler.setCursor(row, col);
     }
+    eraseEOF() {
+        return this.handler.eraseEOF();
+    }
     getScreenData() {
         return this.handler.getScreenData();
     }
@@ -156,7 +343,9 @@ export class Session extends EventEmitter {
         });
     }
     destroy() {
+        this._intentionalClose = true;
         this.stopIdleTimer();
+        this.stopConnectWatchdog();
         this.handler.destroy();
         this.removeAllListeners();
     }
@@ -170,7 +359,9 @@ export class Session extends EventEmitter {
      * store entry is not removed here.
      */
     async gracefulDestroy(timeoutMs = 1500) {
+        this._intentionalClose = true;
         this.stopIdleTimer();
+        this.stopConnectWatchdog();
         const isAuth = this._status.status === 'authenticated';
         if (isAuth && typeof this.handler.attemptSignOff === 'function') {
             try {

package/dist/session.js.map

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

package/dist/structural-signature.d.ts

@@ -0,0 +1,18 @@
+import type { Field } from 'green-screen-types';
+/**
+ * Bottom-region cutoff. Rows at/above this index are treated as the transient
+ * host status / F-key footer and excluded from identity. 21 matches a standard
+ * 24-row screen's status region and is the value the LegacyBridge backend's
+ * input-skeleton dedup uses (`_FOOTER_CUTOFF`); keep them aligned for parity.
+ */
+export declare const DEFAULT_FOOTER_CUTOFF = 21;
+/** Canonical scheme tag, prefixed onto the serialized skeleton. Bump on format change. */
+export declare const STRUCTURAL_SIGNATURE_SCHEME = "v1";
+/**
+ * Compute the structural signature of a screen from its field list.
+ * @param fields the screen's `Field[]` (as built for `ScreenData.fields`).
+ * @param footerCutoff rows >= this are excluded (default {@link DEFAULT_FOOTER_CUTOFF}).
+ * @returns the sha256 hex id, or `undefined` if the screen has no input fields.
+ */
+export declare function computeStructuralSignature(fields: Field[], footerCutoff?: number): string | undefined;
+//# sourceMappingURL=structural-signature.d.ts.map

package/dist/structural-signature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structural-signature.d.ts","sourceRoot":"","sources":["../src/structural-signature.ts"],"names":[],"mappings":"AAyCA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAEhD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,0FAA0F;AAC1F,eAAO,MAAM,2BAA2B,OAAO,CAAC;AAEhD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,KAAK,EAAE,EACf,YAAY,GAAE,MAA8B,GAC3C,MAAM,GAAG,SAAS,CAapB"}

package/dist/structural-signature.js

@@ -0,0 +1,73 @@
+/**
+ * Structural screen signature — a value- and text-independent identity for a
+ * block-mode terminal screen, derived from the geometry of its INPUT fields.
+ *
+ * WHY THIS EXISTS
+ * ---------------
+ * The wire `ScreenData.screen_signature` is `md5(rendered_content)` — it flips
+ * on every keystroke, counter tick, or status line, so it cannot answer the one
+ * question every consumer actually asks: *which screen is this?* Downstream
+ * integrators (e.g. the LegacyBridge backend) therefore reconstruct screen
+ * identity several different ways from the rendered grid. The raw material for a
+ * stable answer is already on the wire — every `Field` carries its protocol
+ * structure (row/col/length/is_input). This primitive computes the canonical
+ * structural id once, at the layer that owns the field structure, so consumers
+ * can carry it instead of re-deriving it.
+ *
+ * Protocol-generic: it operates only on `Field[]`, so 5250 / 3270 / VT / HP6530
+ * screen builders can all emit it. It bakes in no host-specific semantics.
+ *
+ * DEFINITION (scheme `v1`)
+ * ------------------------
+ *   1. Keep only INPUT (unprotected) fields.
+ *   2. Drop fields in the bottom status/function-key region (row >= footerCutoff).
+ *      Block-mode hosts re-paint transient messages there as input-shaped fields;
+ *      excluding the region keeps a screen's identity stable mid-error-recovery.
+ *   3. Sort the surviving (row, col, length) triples.
+ *   4. signature = sha256( "v1:" + triples.join(";")  )  where each triple is "r,c,l".
+ *   Returns `undefined` when there are no qualifying input fields (identity
+ *   degrades to a no-op; consumers fall back to their own keys).
+ *
+ * The serialization is a stable, language-neutral string so an independent
+ * re-implementation (the backend mirrors it in `ai/services/structural_signature.py`)
+ * produces a byte-identical hash. Keep the two in lockstep.
+ *
+ * PARITY VECTOR (must match the backend mirror exactly):
+ *   fields with input (row,col,length) = (3,20,10),(5,35,8),(7,20,12)
+ *   canonical = "v1:3,20,10;5,35,8;7,20,12"
+ *   sha256    = 1837c10a7a6733441e2810bb6fd62213ec9929de384e27fb2b8eb86246511968
+ *   verify:  node -e "import('crypto').then(c=>console.log(c.createHash('sha256').update('v1:3,20,10;5,35,8;7,20,12').digest('hex')))"
+ */
+import { createHash } from 'crypto';
+/**
+ * Bottom-region cutoff. Rows at/above this index are treated as the transient
+ * host status / F-key footer and excluded from identity. 21 matches a standard
+ * 24-row screen's status region and is the value the LegacyBridge backend's
+ * input-skeleton dedup uses (`_FOOTER_CUTOFF`); keep them aligned for parity.
+ */
+export const DEFAULT_FOOTER_CUTOFF = 21;
+/** Canonical scheme tag, prefixed onto the serialized skeleton. Bump on format change. */
+export const STRUCTURAL_SIGNATURE_SCHEME = 'v1';
+/**
+ * Compute the structural signature of a screen from its field list.
+ * @param fields the screen's `Field[]` (as built for `ScreenData.fields`).
+ * @param footerCutoff rows >= this are excluded (default {@link DEFAULT_FOOTER_CUTOFF}).
+ * @returns the sha256 hex id, or `undefined` if the screen has no input fields.
+ */
+export function computeStructuralSignature(fields, footerCutoff = DEFAULT_FOOTER_CUTOFF) {
+    const triples = [];
+    for (const f of fields) {
+        if (f.is_protected)
+            continue; // structural skeleton = input fields only
+        if (f.row >= footerCutoff)
+            continue; // skip transient status/error region
+        triples.push([f.row, f.col, f.length]);
+    }
+    if (triples.length === 0)
+        return undefined;
+    triples.sort((a, b) => a[0] - b[0] || a[1] - b[1] || a[2] - b[2]);
+    const canonical = `${STRUCTURAL_SIGNATURE_SCHEME}:` +
+        triples.map(([r, c, l]) => `${r},${c},${l}`).join(';');
+    return createHash('sha256').update(canonical).digest('hex');
+}
+//# sourceMappingURL=structural-signature.js.map

package/dist/structural-signature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structural-signature.js","sourceRoot":"","sources":["../src/structural-signature.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAGpC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC;AAExC,0FAA0F;AAC1F,MAAM,CAAC,MAAM,2BAA2B,GAAG,IAAI,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CACxC,MAAe,EACf,eAAuB,qBAAqB;IAE5C,MAAM,OAAO,GAAoC,EAAE,CAAC;IACpD,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,CAAC,CAAC,YAAY;YAAE,SAAS,CAAC,0CAA0C;QACxE,IAAI,CAAC,CAAC,GAAG,IAAI,YAAY;YAAE,SAAS,CAAC,qCAAqC;QAC1E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC3C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClE,MAAM,SAAS,GACb,GAAG,2BAA2B,GAAG;QACjC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzD,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9D,CAAC"}

package/dist/tn5250/connection.d.ts

@@ -20,11 +20,36 @@ export declare class TN5250Connection extends EventEmitter {
     /** Environment variables to send in NEW_ENVIRON (e.g., DEVNAME for device name). */
     private envVars;
     private keepAliveTimer;
+    /**
+     * Wall-clock ms timestamp of the most recent byte received from the
+     * host (any byte — telnet IAC, 5250 record header, payload, anything).
+     * Set to ``connect()`` resolution time on session open. Updated in
+     * ``onData`` before any parsing. This is the unambiguous liveness
+     * signal: if (now - lastRecvAtMs) is large AND we sent something
+     * after lastRecvAtMs, the host stopped replying. No interpretation of
+     * screen state, no overlap with kbd-locked-for-error / etc.
+     */
+    private lastRecvAtMs;
+    /**
+     * Wall-clock ms timestamp of the most recent AID byte sent to the
+     * host. Updated only on ``sendRaw`` calls that follow a host-bound
+     * AID write (AID/PRINT/CLEAR/SYS_REQUEST/etc.); telnet keepalive
+     * probes and negotiation traffic do NOT count, since "is the host
+     * sending us anything?" is what we're measuring against.
+     * Set by callers via ``recordHostBoundSend()``.
+     */
+    private lastHostBoundSendAtMs;
     private static readonly KEEP_ALIVE_INTERVAL;
     private static readonly KEEP_ALIVE_TM;
     get isConnected(): boolean;
     get remoteHost(): string;
     get remotePort(): number;
+    /** Wall-clock ms of the most recent byte received from the host. 0 if never. */
+    get lastReceivedAtMs(): number;
+    /** Wall-clock ms of the most recent byte sent to the host. 0 if never.
+     * Includes 5250 records, telnet negotiation, telnet keepalive — every
+     * write that expects a reply. */
+    get lastSentAtMs(): number;
     /**
      * Set environment variables to send during NEW_ENVIRON negotiation.
      * Per lib5250 telnetstr.c:632-664, these are sent as VAR name VALUE value
@@ -33,7 +58,10 @@ export declare class TN5250Connection extends EventEmitter {
     setEnvVars(vars: Record<string, string>): void;
     connect(host: string, port: number, terminalType?: string, connectTimeout?: number): Promise<void>;
     disconnect(): void;
-    /** Send raw bytes over the socket */
+    /** Send raw bytes over the socket. Stamps ``lastHostBoundSendAtMs``
+     * so the liveness check has a definitive "did the host respond
+     * since I last asked it something?" comparison. Includes telnet
+     * negotiation and keepalive — they all expect host replies. */
     sendRaw(data: Buffer): void;
     private startKeepAlive;
     private stopKeepAlive;

package/dist/tn5250/connection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/tn5250/connection.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAGtC,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,KAAK,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;CAC7B;AAED;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,IAAI,CAAc;IAC1B,OAAO,CAAC,IAAI,CAAc;IAC1B,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,YAAY,CAAiC;IACrD,oFAAoF;IACpF,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,cAAc,CAA+C;IACrE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAU;IAKrD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAgE;IAErG,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAI9C,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiDlG,UAAU,IAAI,IAAI;IASlB,qCAAqC;IACrC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM3B,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,OAAO;IAUf,OAAO,CAAC,MAAM;IAQd,OAAO,CAAC,aAAa;IA6DrB,4EAA4E;IAC5E,OAAO,CAAC,aAAa;IAerB,wCAAwC;IACxC,OAAO,CAAC,aAAa;IASrB,wCAAwC;IACxC,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,iBAAiB;IA0CzB,OAAO,CAAC,oBAAoB;IAiB5B,OAAO,CAAC,gBAAgB;IAgBxB,OAAO,CAAC,WAAW;IAmBnB,OAAO,CAAC,mBAAmB;IAK3B,OAAO,CAAC,UAAU;CAGnB"}
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/tn5250/connection.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAGtC,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,KAAK,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;CAC7B;AAED;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,IAAI,CAAc;IAC1B,OAAO,CAAC,IAAI,CAAc;IAC1B,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,YAAY,CAAiC;IACrD,oFAAoF;IACpF,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,cAAc,CAA+C;IACrE;;;;;;;;OAQG;IACH,OAAO,CAAC,YAAY,CAAa;IACjC;;;;;;;OAOG;IACH,OAAO,CAAC,qBAAqB,CAAa;IAC1C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAU;IAKrD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAgE;IAErG,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,gFAAgF;IAChF,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED;;qCAEiC;IACjC,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAI9C,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0DlG,UAAU,IAAI,IAAI;IASlB;;;mEAG+D;IAC/D,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAO3B,OAAO,CAAC,cAAc;IA+BtB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,OAAO;IAUf,OAAO,CAAC,MAAM;IAad,OAAO,CAAC,aAAa;IA6DrB,4EAA4E;IAC5E,OAAO,CAAC,aAAa;IAerB,wCAAwC;IACxC,OAAO,CAAC,aAAa;IASrB,wCAAwC;IACxC,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,iBAAiB;IA0CzB,OAAO,CAAC,oBAAoB;IAiB5B,OAAO,CAAC,gBAAgB;IAgBxB,OAAO,CAAC,WAAW;IAmBnB,OAAO,CAAC,mBAAmB;IAK3B,OAAO,CAAC,UAAU;CAGnB"}