@velum-labs/routekit-gateway 1.3.0 → 1.3.2

package/dist/http/app.js

@@ -5,6 +5,7 @@ import * as HttpEffect from "effect/unstable/http/HttpEffect";
 import { HttpServerError } from "effect/unstable/http/HttpServerError";
 import { parsePrincipalHeader, ROUTEKIT_PRINCIPAL_HEADER } from "./auth.js";
 import { gatewayErrorResponse } from "./errors.js";
+import { gatewayHealth, RUNNING_GATEWAY_VERSION } from "./health.js";
 import { NO_BODY, readJson } from "./request.js";
 import { handleModelCall, streamFetchResponse } from "../model-call-service.js";
 function jsonResponse(status, value, headers = {}) {
@@ -114,9 +115,8 @@ export function buildGatewayHttpEffect(state) {
             const request = yield* HttpServerRequest.HttpServerRequest;
             const url = new URL(request.url, "http://localhost");
             if (url.pathname === "/health") {
-                return jsonResponse(state.draining() ? 503 : 200, {
-                    status: state.draining() ? "draining" : "ok"
-                });
+                const draining = state.draining();
+                return jsonResponse(draining ? 503 : 200, gatewayHealth(draining ? "draining" : "ok", RUNNING_GATEWAY_VERSION));
             }
             if (state.draining()) {
                 return jsonResponse(503, {

package/dist/http/health.d.ts

@@ -0,0 +1,12 @@
+export type GatewayHealth = {
+    status: "ok" | "draining";
+    version: string;
+    pid?: number;
+};
+type ProcessIdentity = {
+    readonly pid: number;
+};
+/** Captured when this module loads, so later PATH or on-disk installs cannot change it. */
+export declare const RUNNING_GATEWAY_VERSION: string;
+export declare function gatewayHealth(status: GatewayHealth["status"], version: string, runningProcess?: ProcessIdentity): GatewayHealth;
+export {};

package/dist/http/health.js

@@ -0,0 +1,24 @@
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+function readRunningPackageVersion() {
+    try {
+        const manifest = JSON.parse(readFileSync(fileURLToPath(new URL("../../package.json", import.meta.url)), "utf8"));
+        return typeof manifest.version === "string" && manifest.version.length > 0
+            ? manifest.version
+            : "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+}
+/** Captured when this module loads, so later PATH or on-disk installs cannot change it. */
+export const RUNNING_GATEWAY_VERSION = readRunningPackageVersion();
+export function gatewayHealth(status, version, runningProcess = process) {
+    try {
+        const pid = runningProcess.pid;
+        return Number.isSafeInteger(pid) && pid > 0 ? { status, version, pid } : { status, version };
+    }
+    catch {
+        return { status, version };
+    }
+}

package/dist/switching-proxy.d.ts

@@ -22,6 +22,8 @@ export type SwitchingGatewayProxy = {
 };
 export type SwitchingGatewayProxyOptions = {
     target: string;
+    /** Running daemon package version captured by its loaded module. */
+    packageVersion?: string;
     host?: string;
     port?: number;
     authToken?: string;

package/dist/switching-proxy.js

@@ -16,6 +16,7 @@ import { HttpClient, HttpRouter, HttpServerRequest, HttpServerResponse } from "e
 import * as HttpEffect from "effect/unstable/http/HttpEffect";
 import { authorizedRequest, ROUTEKIT_PRINCIPAL_HEADER, resolvePrincipal } from "./http/auth.js";
 import { gatewayTryPromise } from "./effect/gateway.js";
+import { gatewayHealth, RUNNING_GATEWAY_VERSION } from "./http/health.js";
 const MAX_BODY_BYTES = 16 * 1024 * 1024;
 const DEFAULT_UPSTREAM_HEADERS_TIMEOUT_MS = 10 * 60 * 1000;
 const HOP_BY_HOP = new Set([
@@ -182,6 +183,7 @@ const startSwitchingGatewayProxyOperation = Effect.fn("SwitchingGatewayProxy.sta
     let draining = false;
     let retiring = false;
     let inflight = 0;
+    const healthVersion = input.packageVersion ?? RUNNING_GATEWAY_VERSION;
     const httpEffect = yield* Effect.gen(function* () {
         const router = yield* HttpRouter.make;
         const httpClient = yield* HttpClient.HttpClient;
@@ -243,9 +245,7 @@ const startSwitchingGatewayProxyOperation = Effect.fn("SwitchingGatewayProxy.sta
             const request = yield* HttpServerRequest.HttpServerRequest;
             const path = new URL(request.url, "http://localhost").pathname;
             if (path === "/health") {
-                return jsonResponse(draining ? 503 : 200, {
-                    status: draining ? "draining" : "ok"
-                });
+                return jsonResponse(draining ? 503 : 200, gatewayHealth(draining ? "draining" : "ok", healthVersion));
             }
             if (draining) {
                 return jsonResponse(503, {

package/dist/test/drain.test.js

@@ -4,6 +4,7 @@ import { RouteKitFailure, runRouteKitEffect } from "@velum-labs/routekit-runtime
 import { Effect } from "effect";
 import { borrowedBackendPorts, staticBackendModelPort } from "../providers/backend.js";
 import { startGateway } from "../gateway-service.js";
+import { RUNNING_GATEWAY_VERSION } from "../http/health.js";
 /**
  * Graceful drain: a draining gateway must report unhealthy and reject new
  * model calls while letting in-flight requests (long-lived LLM streams)
@@ -50,7 +51,11 @@ test("drain finishes in-flight streams, rejects new work, and flips /health to 5
         // Health flips to 503 so probes stop routing new work here.
         const health = await fetch(`${gateway.url()}/health`);
         assert.equal(health.status, 503);
-        assert.deepEqual(await health.json(), { status: "draining" });
+        assert.deepEqual(await health.json(), {
+            status: "draining",
+            version: RUNNING_GATEWAY_VERSION,
+            pid: process.pid
+        });
         // New model calls are rejected while draining.
         const rejected = await fetch(`${gateway.url()}/v1/chat/completions`, {
             method: "POST",

package/dist/test/health.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/health.test.js

@@ -0,0 +1,14 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { gatewayHealth } from "../http/health.js";
+test("health keeps version and omits pid when process identity lookup fails", () => {
+    const unavailablePid = {
+        get pid() {
+            throw new Error("pid unavailable");
+        }
+    };
+    assert.deepEqual(gatewayHealth("ok", "1.2.3", unavailablePid), {
+        status: "ok",
+        version: "1.2.3"
+    });
+});

package/dist/test/server-resilience.test.js

@@ -9,6 +9,7 @@ import { borrowedBackendPorts } from "../providers/backend.js";
 import { OpenAiBackend } from "../providers/openai-backend.js";
 import { startGateway } from "../gateway-service.js";
 import { startSwitchingGatewayProxy } from "../switching-proxy.js";
+import { RUNNING_GATEWAY_VERSION } from "../http/health.js";
 /**
  * Crash resilience: an upstream stream that dies mid-response (the shape of a
  * local model server being OOM-killed during a turn) must fail only that one
@@ -90,6 +91,11 @@ test("a mid-stream upstream failure does not kill the gateway process", async ()
         // The gateway (and its hosting process) is still alive and serving.
         const health = await fetch(`${gateway.url()}/health`);
         assert.equal(health.status, 200);
+        assert.deepEqual(await health.json(), {
+            status: "ok",
+            version: RUNNING_GATEWAY_VERSION,
+            pid: process.pid
+        });
         const models = await fetch(`${gateway.url()}/v1/models`);
         assert.equal(models.status, 200);
     }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@velum-labs/routekit-gateway",
   "private": false,
-  "version": "1.3.0",
+  "version": "1.3.2",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/velum-labs/routekit.git",
@@ -45,12 +45,12 @@
     "@aws-sdk/client-bedrock": "3.1095.0",
     "@aws-sdk/client-bedrock-runtime": "3.1095.0",
     "effect": "4.0.0-rc.108",
-    "@velum-labs/routekit-config-core": "1.3.0",
-    "@velum-labs/routekit-contracts": "1.3.0",
-    "@velum-labs/routekit-eval-contracts": "1.3.0",
-    "@velum-labs/routekit-eval-core": "1.3.0",
-    "@velum-labs/routekit-registry": "1.3.0",
-    "@velum-labs/routekit-runtime": "1.3.0"
+    "@velum-labs/routekit-config-core": "1.3.2",
+    "@velum-labs/routekit-contracts": "1.3.2",
+    "@velum-labs/routekit-eval-contracts": "1.3.2",
+    "@velum-labs/routekit-eval-core": "1.3.2",
+    "@velum-labs/routekit-registry": "1.3.2",
+    "@velum-labs/routekit-runtime": "1.3.2"
   },
   "keywords": [
     "routekit",