@velum-labs/routekit-daemon 0.18.0 → 0.18.2

package/README.md

@@ -2,12 +2,17 @@
 
 Composition root for RouteKit's singleton daemon.
 
-One process owns the authenticated private control listener and a stable
-OpenAI-compatible data listener. Router generations run behind the stable
-front door: config/account changes build a complete candidate, atomically
-switch new requests, then drain the old generation. The daemon is the sole
-writer for canonical config, account enrollment, revisions, catalog/health
-snapshots, and telemetry state.
+A stable cluster primary owns singleton authority, service records, the shared
+control/data listener handles, Portless registration, and the managed
+CLIProxyAPI sidecar. One active worker owns the RouteKit control plane, router
+generations, account state, and telemetry. Config/account changes replace the
+inner router generation; restart and upgrade replace the worker while the
+primary and public ports remain stable. Failed candidates leave the active
+worker serving traffic.
+
+`startRouteKitDaemon` remains the standalone composition root for embedders and
+tests. Production `routekit daemon run` uses `startRouteKitDaemonHost` in the
+primary and `runRouteKitDaemonWorker` in cluster workers.
 
 Applications normally use it through `@velum-labs/routekit`; embedders should keep
 using `@velum-labs/routekit-router` instead of claiming the singleton service record.

package/dist/host-protocol.d.ts

@@ -0,0 +1,88 @@
+import type { RouteKitControlParams, RouteKitControlResults } from "@velum-labs/routekit-control";
+export declare const DAEMON_HOST_PROTOCOL_VERSION = 1;
+export declare const ROUTEKIT_DAEMON_WORKER_ENV = "ROUTEKIT_DAEMON_WORKER";
+export declare const ROUTEKIT_DAEMON_GENERATION_ENV = "ROUTEKIT_DAEMON_GENERATION";
+export declare const ROUTEKIT_DAEMON_CONTROL_TOKEN_ENV = "ROUTEKIT_DAEMON_CONTROL_TOKEN";
+export declare const ROUTEKIT_DAEMON_DATA_URL_ENV = "ROUTEKIT_DAEMON_DATA_URL";
+export declare const ROUTEKIT_DAEMON_DATA_PORT_ENV = "ROUTEKIT_DAEMON_DATA_PORT";
+export declare const ROUTEKIT_DAEMON_CONTROL_PORT_ENV = "ROUTEKIT_DAEMON_CONTROL_PORT";
+export declare const ROUTEKIT_DAEMON_HOST_PID_ENV = "ROUTEKIT_DAEMON_HOST_PID";
+export declare const ROUTEKIT_DAEMON_HOST_STARTED_AT_ENV = "ROUTEKIT_DAEMON_HOST_STARTED_AT";
+export declare const ROUTEKIT_DAEMON_INITIAL_PAUSED_ENV = "ROUTEKIT_DAEMON_INITIAL_PAUSED";
+export type WorkerSnapshot = {
+    generation: number;
+    configRevision: number;
+    accountRevision: number;
+    configHash: string;
+};
+export type WorkerReady = WorkerSnapshot & {
+    type: "worker.ready";
+    protocolVersion: number;
+    workerPid: number;
+    workerProcessIdentity?: string;
+    workerStartedAt: string;
+    packageVersion: string;
+    controlUrl: string;
+    controlPort: number;
+    dataUrl: string;
+    dataPort: number;
+    binPath?: string;
+};
+export type WorkerRequest = {
+    type: "worker.pause";
+    requestId: string;
+} | {
+    type: "worker.resume";
+    requestId: string;
+} | {
+    type: "worker.retire";
+    requestId: string;
+    graceMs: number;
+} | {
+    type: "worker.shutdown";
+    requestId: string;
+} | {
+    type: "worker.hostState";
+    requestId: string;
+    dataUrl: string;
+    hostPid: number;
+    hostStartedAt: string;
+    rolling: boolean;
+};
+export type WorkerResponse = {
+    type: "worker.response";
+    requestId: string;
+    ok: true;
+    result?: unknown;
+} | {
+    type: "worker.response";
+    requestId: string;
+    ok: false;
+    error: string;
+};
+export type WorkerToHostRequest = {
+    type: "host.roll";
+    requestId: string;
+    params: RouteKitControlParams["daemon.roll"];
+} | {
+    type: "host.shutdown";
+    reason: "stop" | "restart" | "upgrade";
+} | {
+    type: "host.sidecar";
+    requestId: string;
+    operation: "reconcile" | "refresh" | "reachable" | "status";
+    wanted?: boolean;
+    timeoutMs?: number;
+};
+export type HostToWorkerResponse = {
+    type: "host.response";
+    requestId: string;
+    ok: true;
+    result?: RouteKitControlResults["daemon.roll"] | unknown;
+} | {
+    type: "host.response";
+    requestId: string;
+    ok: false;
+    error: string;
+};
+export type HostWorkerMessage = WorkerReady | WorkerRequest | WorkerResponse | WorkerToHostRequest | HostToWorkerResponse;

package/dist/host-protocol.js

@@ -0,0 +1,10 @@
+export const DAEMON_HOST_PROTOCOL_VERSION = 1;
+export const ROUTEKIT_DAEMON_WORKER_ENV = "ROUTEKIT_DAEMON_WORKER";
+export const ROUTEKIT_DAEMON_GENERATION_ENV = "ROUTEKIT_DAEMON_GENERATION";
+export const ROUTEKIT_DAEMON_CONTROL_TOKEN_ENV = "ROUTEKIT_DAEMON_CONTROL_TOKEN";
+export const ROUTEKIT_DAEMON_DATA_URL_ENV = "ROUTEKIT_DAEMON_DATA_URL";
+export const ROUTEKIT_DAEMON_DATA_PORT_ENV = "ROUTEKIT_DAEMON_DATA_PORT";
+export const ROUTEKIT_DAEMON_CONTROL_PORT_ENV = "ROUTEKIT_DAEMON_CONTROL_PORT";
+export const ROUTEKIT_DAEMON_HOST_PID_ENV = "ROUTEKIT_DAEMON_HOST_PID";
+export const ROUTEKIT_DAEMON_HOST_STARTED_AT_ENV = "ROUTEKIT_DAEMON_HOST_STARTED_AT";
+export const ROUTEKIT_DAEMON_INITIAL_PAUSED_ENV = "ROUTEKIT_DAEMON_INITIAL_PAUSED";

package/dist/host.d.ts

@@ -0,0 +1,11 @@
+import type { ServiceRecord } from "@velum-labs/routekit-runtime";
+import type { RouteKitDaemonOptions } from "./index.js";
+export type RunningRouteKitDaemonHost = {
+    record: ServiceRecord;
+    dataUrl: string;
+    controlUrl: string;
+    close(): Promise<void>;
+};
+export declare function startRouteKitDaemonHost(options: RouteKitDaemonOptions & {
+    entryPath: string;
+}): Promise<RunningRouteKitDaemonHost>;