@exaudeus/workrail 3.20.0 → 3.20.1

package/dist/di/container.js

@@ -362,8 +362,14 @@ async function startAsyncServices() {
         const flags = tsyringe_1.container.resolve(tokens_js_1.DI.Infra.FeatureFlags);
         if (flags.isEnabled('sessionTools')) {
             const server = tsyringe_1.container.resolve(tokens_js_1.DI.Infra.HttpServer);
-            await server.start();
-            console.error('[DI] HTTP server started');
+            try {
+                await server.start();
+                console.error('[DI] HTTP server started');
+            }
+            catch (httpError) {
+                const message = httpError instanceof Error ? httpError.message : String(httpError);
+                console.error(`[DI] Dashboard HTTP server unavailable: ${message}. MCP tools will still work.`);
+            }
         }
         asyncInitialized = true;
     }

package/dist/infrastructure/session/HttpServer.d.ts

@@ -33,6 +33,7 @@ export declare class HttpServer {
     private isPrimary;
     private lockFile;
     private heartbeat;
+    private _stopPromise;
     constructor(sessionManager: SessionManager, processLifecyclePolicy: ProcessLifecyclePolicy, processSignals: ProcessSignals, shutdownEvents: ShutdownEvents, dashboardMode: DashboardMode, browserBehavior: BrowserBehavior);
     private config;
     setConfig(config: ServerConfig): this;
@@ -48,6 +49,7 @@ export declare class HttpServer {
     private printBanner;
     openDashboard(sessionId?: string): Promise<string>;
     stop(): Promise<void>;
+    private _runStop;
     mountRoutes(installer: (app: Application) => (() => void) | void): void;
     private readonly _routeDisposers;
     finalize(): void;

package/dist/infrastructure/session/HttpServer.js

@@ -42,6 +42,7 @@ let HttpServer = class HttpServer {
         this.server = null;
         this.baseUrl = '';
         this.isPrimary = false;
+        this._stopPromise = null;
         this.config = {};
         this._routeDisposers = [];
         this.port = 3456;
@@ -331,6 +332,7 @@ let HttpServer = class HttpServer {
         });
     }
     async start() {
+        this._stopPromise = null;
         const mode = this.config.dashboardMode ?? this.dashboardMode;
         if (mode.kind === 'legacy') {
             console.error('[Dashboard] Unified dashboard disabled, using legacy mode');
@@ -556,6 +558,7 @@ let HttpServer = class HttpServer {
                 throw error;
             }
         }
+        this.server = null;
         throw new Error('No available ports in range 3457-3499');
     }
     printBanner() {
@@ -570,6 +573,10 @@ let HttpServer = class HttpServer {
         console.error();
     }
     async openDashboard(sessionId) {
+        if (!this.baseUrl) {
+            throw new Error('Dashboard is unavailable -- the HTTP server did not start successfully ' +
+                '(likely due to port exhaustion). MCP tools still work normally.');
+        }
         let url = this.baseUrl;
         if (sessionId) {
             url += `?session=${sessionId}`;
@@ -587,6 +594,14 @@ let HttpServer = class HttpServer {
         return url;
     }
     async stop() {
+        if (this._stopPromise !== null)
+            return this._stopPromise;
+        if (this.server === null)
+            return Promise.resolve();
+        this._stopPromise = this._runStop();
+        return this._stopPromise;
+    }
+    async _runStop() {
         this.heartbeat.stop();
         this.sessionManager.unwatchAll();
         for (const dispose of this._routeDisposers) {

package/dist/manifest.json

@@ -394,8 +394,8 @@
       "bytes": 620
     },
     "di/container.js": {
-      "sha256": "6b5ca3f79bff1d6e3bbf9d19d76574611460d6a5f908ebe83fe202706fe4ae2c",
-      "bytes": 21727
+      "sha256": "7956cb925d40f61746ccdcec245c5ee40d7d317893eff240a10cff595304d467",
+      "bytes": 22026
     },
     "di/tokens.d.ts": {
       "sha256": "04db6db34348aa36d897c85ab07eb1a386cb04e3595dbcb33525bd33974111ef",
@@ -542,12 +542,12 @@
       "bytes": 818
     },
     "infrastructure/session/HttpServer.d.ts": {
-      "sha256": "e2676f55158fb35249fc6b8d8ae051e6b043f6445e153f1f20fe837acc2ab65c",
-      "bytes": 1977
+      "sha256": "79c0d8855d9437084756186f5e115aab82c829f48bafc1a5742903a1e7d808b6",
+      "bytes": 2025
     },
     "infrastructure/session/HttpServer.js": {
-      "sha256": "92c00fa2f82a503bdd35ce0b1d3665cc63a261d16be53ff82a7007a55b08994e",
-      "bytes": 30162
+      "sha256": "3f2bc1fb56b8191da261567eb7fb8e78f4c3e33b54c71da361aeea51d047ccd8",
+      "bytes": 30743
     },
     "infrastructure/session/SessionDataNormalizer.d.ts": {
       "sha256": "c89bb5e00d7d01fb4aa6d0095602541de53c425c6b99b67fa8367eb29cb63e9e",
@@ -1102,12 +1102,12 @@
       "bytes": 3534
     },
     "mcp/transports/shutdown-hooks.d.ts": {
-      "sha256": "0a0e638aa9b1ca714e9c9efe9bcb9b147ef802f05c71ba6be481d59d3c45c800",
-      "bytes": 502
+      "sha256": "abf3799e44183c8a7e3614e2f14c1d7c8c4bb4ce0b720d3005ee165e4dd6f211",
+      "bytes": 547
     },
     "mcp/transports/shutdown-hooks.js": {
-      "sha256": "1bbf5e8203adc7172cb8a3a4cf987ded4e747a993cc6c9346651ff5f192b1abb",
-      "bytes": 2582
+      "sha256": "b44d0daaabfc4a896a910691637473d238127157f762743fec35625b6d12d4eb",
+      "bytes": 2701
     },
     "mcp/transports/stdio-entry.d.ts": {
       "sha256": "4ced3c9e00ef67555781dea74315290eea8a9dbffd38155bc00c3fb07b0c1794",

package/dist/mcp/transports/shutdown-hooks.d.ts

@@ -1,5 +1,6 @@
 export interface ShutdownHookOptions {
     readonly onBeforeTerminate: () => Promise<void>;
+    readonly stdout?: NodeJS.WritableStream;
 }
 export declare function wireShutdownHooks(opts: ShutdownHookOptions): void;
 export interface StdoutShutdownOptions {

package/dist/mcp/transports/shutdown-hooks.js

@@ -9,6 +9,10 @@ function wireShutdownHooks(opts) {
     const shutdownEvents = container_js_1.container.resolve(tokens_js_1.DI.Runtime.ShutdownEvents);
     const processSignals = container_js_1.container.resolve(tokens_js_1.DI.Runtime.ProcessSignals);
     const terminator = container_js_1.container.resolve(tokens_js_1.DI.Runtime.ProcessTerminator);
+    const stdout = opts.stdout ?? process.stdout;
+    stdout.on('error', () => {
+        stdout.emit('drain');
+    });
     processSignals.on('SIGINT', () => shutdownEvents.emit({ kind: 'shutdown_requested', signal: 'SIGINT' }));
     processSignals.on('SIGTERM', () => shutdownEvents.emit({ kind: 'shutdown_requested', signal: 'SIGTERM' }));
     processSignals.on('SIGHUP', () => shutdownEvents.emit({ kind: 'shutdown_requested', signal: 'SIGHUP' }));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exaudeus/workrail",
-  "version": "3.20.0",
+  "version": "3.20.1",
   "description": "Step-by-step workflow enforcement for AI agents via MCP",
   "license": "MIT",
   "repository": {