@tapflowio/relay 0.17.0 → 0.18.0

package/dist/RelayServer.d.ts

@@ -21,9 +21,12 @@ export declare class RelayServer {
     private droppers;
     private idrRequesters;
     private wsRoles;
+    private agentHolds;
+    private stopping;
     private wsExternal;
     private readonly backpressureBytes;
     private readonly screenshotTimeoutMs;
+    private readonly agentGraceMs;
     private readonly corsAllowed;
     private warnedProxyMisconfig;
     private pendingScreenshots;
@@ -43,6 +46,7 @@ export declare class RelayServer {
             cert: string;
             key: string;
         };
+        agentGraceMs?: number;
     });
     private registerRoutes;
     pushLog(msg: string): void;
@@ -60,10 +64,56 @@ export declare class RelayServer {
     private handleConnection;
     private route;
     private handleAgentResources;
+    /**
+     * Every message the relay *originates* goes through here. The union checks the shape where the
+     * literal is written — a mistyped `type`, a missing field or one that does not belong are all
+     * compile errors — and the readyState guard replaces the check that was repeated (and sometimes
+     * omitted) at each call site.
+     *
+     * Messages the relay merely *forwards* do not use this: they are re-serialised unchanged, so
+     * they keep their inbound type and there is nothing new to check.
+     */
+    private sendTo;
+    /**
+     * Settle every in-flight screenshot / UI-tree request belonging to these sessions. Both callers
+     * are moments where the agent that was going to answer them no longer exists — it disconnected,
+     * or it restarted and its session moved to the new process. Left alone these reject on their own
+     * timeout, minutes later, having told the caller nothing in between.
+     */
+    private rejectPending;
+    /**
+     * The agent's socket went away. Keep its sessions and wait for that agent to come back, instead
+     * of ending them here — a restarting agent registers about a second later, and until #426 stage 3
+     * the close always won that race, so a restart cost the tester their place.
+     *
+     * The sessions stay exactly where they are. They are NOT moved to a holding structure of their
+     * own: `getAgentSocketsByIdentity` finds the returning agent's previous socket by walking
+     * `sessions` and reading `agentSocket`, so a session parked anywhere else is a session that can
+     * never be reclaimed.
+     *
+     * @returns whether this was an agent socket, matching `evictAgentSocket`'s contract — the close
+     *   handler uses it to decide whether to keep looking.
+     */
+    private holdAgentSocket;
+    /** Stop waiting on a socket, whether or not anything was reclaimed from it. */
+    private releaseHold;
+    /**
+     * @param cause  `'disconnect'` — the socket closed. `'replaced'` — the same agent re-registered
+     *   and this is its previous socket. Only affects the log line: a restart otherwise reads as a
+     *   crash followed by a recovery, which is not what happened.
+     */
     private evictAgentSocket;
     private handleAgentRegister;
     private handleSessionStart;
+    /** Relay looks up file_path from DB and enriches it for the agent.
+     *
+     *  Every exit carries the request's `sessionId`, including the failures. A dashboard viewer holds
+     *  one session per socket, so an uncorrelated error still lands somewhere sensible — but an MCP
+     *  caller waits for the reply matching its own sessionId, so anything else is indistinguishable
+     *  from silence and it waits out the deadline (#445). `Session not found` is app-specific for the
+     *  same reason: a generic `error` cannot be correlated by construction. */
     private handleBrowserAppInstall;
+    /** Relay looks up bundle_id from DB. Same correlation rules as `handleBrowserAppInstall`. */
     private handleBrowserAppLaunch;
     private handleGetScreenshot;
     private handleGetUITree;

package/dist/RelayServer.d.ts.map

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