rivetkit 2.3.0 → 2.3.1

package/dist/tsup/agent-os/index.d.cts

@@ -755,6 +755,11 @@ interface RuntimeServeConfig {
     serverlessValidateEndpoint: boolean;
     serverlessMaxStartPayloadBytes: number;
 }
+interface RuntimeListenerConfig {
+    port: number;
+    host?: string;
+    publicDir?: string;
+}
 interface RuntimeServerlessRequest {
     method: string;
     url: string;
@@ -801,6 +806,7 @@ interface CoreRuntime {
     shutdownRegistry(registry: RegistryHandle): Promise<void>;
     registryActorStopThresholdMs?(registry: RegistryHandle): Promise<number | undefined>;
     handleServerlessRequest(registry: RegistryHandle, req: RuntimeServerlessRequest, onStreamEvent: RuntimeServerlessStreamCallback, cancelToken: CancellationTokenHandle, config: RuntimeServeConfig): Promise<RuntimeServerlessResponseHead>;
+    serveListener(registry: RegistryHandle, listener: RuntimeListenerConfig, config: RuntimeServeConfig): Promise<void>;
     registryHealth?(registry: RegistryHandle): Promise<RuntimeRegistryRouteResponse>;
     registryMetadata?(registry: RegistryHandle): Promise<RuntimeRegistryRouteResponse>;
     registryMetrics?(registry: RegistryHandle): Promise<RuntimeRegistryRouteResponse>;
@@ -933,13 +939,15 @@ declare class Registry<A extends RegistryActors> {
      */
     serve(): ServerlessHandler;
     /**
-     * Starts an HTTP server that dispatches every request through the
-     * serverless handler. Uses `crossPlatformServe` to pick the right
-     * runtime (Node, Bun, Deno).
+     * Bind an HTTP listener provided by the native (Rust) runtime and serve
+     * the registry's serverless endpoints over it. Resolves only after the
+     * registry is shut down (SIGINT/SIGTERM or `nativeRegistry.shutdown()`).
      *
-     * @param opts.port      Port to listen on. Defaults to 3000.
+     * @param opts.port      Port to listen on. Defaults to `process.env.RIVET_PORT`
+     *                       if set, otherwise 3000.
+     * @param opts.host      Address to bind. Defaults to `0.0.0.0`.
      * @param opts.publicDir If set, serves static files from this directory
-     *                       before falling through to the registry handler.
+     *                       as a fallback below the framework routes.
      *
      * @example
      * ```ts
@@ -949,6 +957,7 @@ declare class Registry<A extends RegistryActors> {
      */
     listen(opts?: {
         port?: number;
+        host?: string;
         publicDir?: string;
     }): Promise<void>;
     /**
@@ -976,6 +985,10 @@ declare class Registry<A extends RegistryActors> {
     /**
      * Starts the actor envoy for standalone server deployments.
      *
+     * Set `RIVETKIT_RUNTIME_MODE=serverless` to instead bind an HTTP listener
+     * via `listen()` (Mode B). Mode A (envoy) and Mode B (listener) are
+     * mutually exclusive per registry instance.
+     *
      * @example
      * ```ts
      * const registry = setup({ use: { counter } });

package/dist/tsup/agent-os/index.d.ts

@@ -755,6 +755,11 @@ interface RuntimeServeConfig {
     serverlessValidateEndpoint: boolean;
     serverlessMaxStartPayloadBytes: number;
 }
+interface RuntimeListenerConfig {
+    port: number;
+    host?: string;
+    publicDir?: string;
+}
 interface RuntimeServerlessRequest {
     method: string;
     url: string;
@@ -801,6 +806,7 @@ interface CoreRuntime {
     shutdownRegistry(registry: RegistryHandle): Promise<void>;
     registryActorStopThresholdMs?(registry: RegistryHandle): Promise<number | undefined>;
     handleServerlessRequest(registry: RegistryHandle, req: RuntimeServerlessRequest, onStreamEvent: RuntimeServerlessStreamCallback, cancelToken: CancellationTokenHandle, config: RuntimeServeConfig): Promise<RuntimeServerlessResponseHead>;
+    serveListener(registry: RegistryHandle, listener: RuntimeListenerConfig, config: RuntimeServeConfig): Promise<void>;
     registryHealth?(registry: RegistryHandle): Promise<RuntimeRegistryRouteResponse>;
     registryMetadata?(registry: RegistryHandle): Promise<RuntimeRegistryRouteResponse>;
     registryMetrics?(registry: RegistryHandle): Promise<RuntimeRegistryRouteResponse>;
@@ -933,13 +939,15 @@ declare class Registry<A extends RegistryActors> {
      */
     serve(): ServerlessHandler;
     /**
-     * Starts an HTTP server that dispatches every request through the
-     * serverless handler. Uses `crossPlatformServe` to pick the right
-     * runtime (Node, Bun, Deno).
+     * Bind an HTTP listener provided by the native (Rust) runtime and serve
+     * the registry's serverless endpoints over it. Resolves only after the
+     * registry is shut down (SIGINT/SIGTERM or `nativeRegistry.shutdown()`).
      *
-     * @param opts.port      Port to listen on. Defaults to 3000.
+     * @param opts.port      Port to listen on. Defaults to `process.env.RIVET_PORT`
+     *                       if set, otherwise 3000.
+     * @param opts.host      Address to bind. Defaults to `0.0.0.0`.
      * @param opts.publicDir If set, serves static files from this directory
-     *                       before falling through to the registry handler.
+     *                       as a fallback below the framework routes.
      *
      * @example
      * ```ts
@@ -949,6 +957,7 @@ declare class Registry<A extends RegistryActors> {
      */
     listen(opts?: {
         port?: number;
+        host?: string;
         publicDir?: string;
     }): Promise<void>;
     /**
@@ -976,6 +985,10 @@ declare class Registry<A extends RegistryActors> {
     /**
      * Starts the actor envoy for standalone server deployments.
      *
+     * Set `RIVETKIT_RUNTIME_MODE=serverless` to instead bind an HTTP listener
+     * via `listen()` (Mode B). Mode A (envoy) and Mode B (listener) are
+     * mutually exclusive per registry instance.
+     *
      * @example
      * ```ts
      * const registry = setup({ use: { counter } });

package/dist/tsup/agent-os/index.js

@@ -314,7 +314,7 @@ function isRivetErrorCode(error, group, code) {
 // package.json
 var package_default = {
   name: "rivetkit",
-  version: "2.3.0",
+  version: "2.3.1",
   description: "Lightweight libraries for building stateful actors on edge platforms",
   license: "Apache-2.0",
   keywords: [
@@ -502,8 +502,6 @@ var package_default = {
     "actor-config-schema-gen": "tsx scripts/actor-config-schema-gen.ts"
   },
   dependencies: {
-    "@hono/node-server": "^1.18.2",
-    "@hono/node-ws": "^1.1.1",
     "@hono/zod-openapi": "^1.1.5",
     "@rivet-dev/agent-os-core": "^0.1.1",
     "@rivetkit/bare-ts": "^0.6.2",
@@ -517,7 +515,6 @@ var package_default = {
     "@rivetkit/workflow-engine": "workspace:*",
     "cbor-x": "^1.6.0",
     "drizzle-orm": "^0.44.2",
-    "get-port": "^7.1.0",
     hono: "^4.7.0",
     invariant: "^2.2.4",
     "p-retry": "^6.2.1",
@@ -529,12 +526,15 @@ var package_default = {
   devDependencies: {
     "@biomejs/biome": "^2.3",
     "@copilotkit/llmock": "^1.6.0",
+    "@hono/node-server": "^1.18.2",
+    "@hono/node-ws": "^1.1.1",
     "@rivet-dev/agent-os-common": "*",
     "@rivet-dev/agent-os-pi": "^0.1.1",
     "@standard-schema/spec": "^1.0.0",
     "@types/invariant": "^2",
     "@types/node": "^22.13.1",
     eventsource: "^4.0.0",
+    "get-port": "^7.1.0",
     tsup: "^8.4.0",
     tsx: "^4.19.4",
     typescript: "^5.7.3",