@manuelfedele/postino 0.2.0 → 0.2.1

package/dist/index.js

@@ -2,9 +2,9 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { loadConfig } from "./types.js";
-import { connect, disconnect, registerAgent, deregisterAgent } from "./valkey.js";
+import { connect, disconnect, valkey, valkeySub, keys, registerAgent, deregisterAgent } from "./valkey.js";
 import { registerMessagingTools } from "./tools/messaging.js";
-import { startWebServer } from "./web/server.js";
+import { startWebServer, getGuiState, restartOnPort } from "./web/server.js";
 const config = loadConfig();
 const server = new McpServer({
     name: "postino",
@@ -15,6 +15,35 @@ const server = new McpServer({
     },
 });
 registerMessagingTools(server, config.agentName);
+function subscribeGuiTakeover() {
+    const channel = keys.guiTakeoverChannel();
+    valkeySub.subscribe(channel).catch(() => {
+        process.stderr.write("postino: failed to subscribe to GUI takeover channel\n");
+    });
+    valkeySub.on("message", (ch, message) => {
+        if (ch !== channel)
+            return;
+        let data;
+        try {
+            data = JSON.parse(message);
+        }
+        catch {
+            return;
+        }
+        const state = getGuiState();
+        // Skip if we already have a GUI on an equal or lower port
+        if (state.running && state.port !== null && state.port <= data.port)
+            return;
+        // Random jitter (100-500ms) so not all instances race at once
+        const jitter = 100 + Math.random() * 400;
+        setTimeout(async () => {
+            const ok = await restartOnPort(data.port);
+            if (ok) {
+                process.stderr.write(`postino: took over GUI on port ${data.port}\n`);
+            }
+        }, jitter);
+    });
+}
 async function main() {
     try {
         await connect();
@@ -36,9 +65,20 @@ async function main() {
     await server.connect(transport);
     if (config.webEnabled) {
         startWebServer(config.webPort);
+        subscribeGuiTakeover();
     }
     process.stderr.write(`postino agent: ${config.agentName}\n`);
     const shutdown = async () => {
+        // If this instance had a GUI, notify others so they can take over the port
+        const state = getGuiState();
+        if (state.running && state.port !== null) {
+            try {
+                await valkey.publish(keys.guiTakeoverChannel(), JSON.stringify({ port: state.port }));
+            }
+            catch {
+                // Best-effort, connection may already be closing
+            }
+        }
         await deregisterAgent(config.agentName);
         await disconnect();
         process.exit(0);

package/dist/valkey.d.ts

@@ -9,6 +9,7 @@ export declare const keys: {
     broadcastCursor: (agent: string) => string;
     notifyChannel: (agent: string) => string;
     eventsChannel: () => string;
+    guiTakeoverChannel: () => string;
 };
 export declare function connect(): Promise<void>;
 export declare function disconnect(): Promise<void>;

package/dist/valkey.js

@@ -20,6 +20,7 @@ export const keys = {
     broadcastCursor: (agent) => `${prefix}bcursor:${agent}`,
     notifyChannel: (agent) => `${prefix}notify:${agent}`,
     eventsChannel: () => `${prefix}events`,
+    guiTakeoverChannel: () => `${prefix}gui:takeover`,
 };
 export async function connect() {
     await valkey.connect();

package/dist/web/api.js

@@ -101,7 +101,9 @@ function ensureEventSubscription() {
     valkeySub.subscribe(keys.eventsChannel()).catch(() => {
         subscribedToEvents = false;
     });
-    valkeySub.on("message", (_channel, message) => {
+    valkeySub.on("message", (channel, message) => {
+        if (channel !== keys.eventsChannel())
+            return;
         for (const client of sseClients) {
             try {
                 client.send(message);

package/dist/web/server.d.ts

@@ -1 +1,7 @@
+export interface GuiState {
+    running: boolean;
+    port: number | null;
+}
+export declare function getGuiState(): GuiState;
 export declare function startWebServer(port: number, attempt?: number): void;
+export declare function restartOnPort(port: number): Promise<boolean>;

package/dist/web/server.js

@@ -49,9 +49,16 @@ app.get("/", (c) => {
     return c.html(html);
 });
 const MAX_PORT_ATTEMPTS = 10;
+let currentServer = null;
+let currentPort = null;
+export function getGuiState() {
+    return { running: currentServer !== null, port: currentPort };
+}
 export function startWebServer(port, attempt = 0) {
     try {
         const server = serve({ fetch: app.fetch, port }, () => {
+            currentServer = server;
+            currentPort = port;
             process.stderr.write(`postino GUI: http://localhost:${port}\n`);
         });
         server.on("error", (err) => {
@@ -69,3 +76,45 @@ export function startWebServer(port, attempt = 0) {
         process.stderr.write(`postino GUI failed to start: ${err}\n`);
     }
 }
+export function restartOnPort(port) {
+    return new Promise((resolve) => {
+        const oldServer = currentServer;
+        const oldPort = currentPort;
+        const launchNew = () => {
+            try {
+                const server = serve({ fetch: app.fetch, port }, () => {
+                    currentServer = server;
+                    currentPort = port;
+                    process.stderr.write(`postino GUI: takeover http://localhost:${port}\n`);
+                    resolve(true);
+                });
+                server.on("error", (err) => {
+                    if (err.code === "EADDRINUSE") {
+                        process.stderr.write(`postino: takeover port ${port} already claimed\n`);
+                    }
+                    else {
+                        process.stderr.write(`postino: takeover failed: ${err.message}\n`);
+                    }
+                    // Restore old state if we had one
+                    currentServer = oldServer;
+                    currentPort = oldPort;
+                    resolve(false);
+                });
+            }
+            catch {
+                currentServer = oldServer;
+                currentPort = oldPort;
+                resolve(false);
+            }
+        };
+        if (oldServer) {
+            // Close existing server first, then start on the new port
+            currentServer = null;
+            currentPort = null;
+            oldServer.close(() => launchNew());
+        }
+        else {
+            launchNew();
+        }
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@manuelfedele/postino",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Inter-agent messaging and broadcast system for Claude Code",
   "type": "module",
   "main": "dist/index.js",