rivetkit 2.3.0-rc.5 → 2.3.0-rc.7

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

@@ -220,7 +220,7 @@ declare const RegistryConfigSchema: z.ZodPipe<z.ZodObject<{
         envoyKey: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
     shutdown: z.ZodDefault<z.ZodOptional<z.ZodObject<{
-        gracePeriodMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        gracePeriodMs: z.ZodOptional<z.ZodNumber>;
         disableSignalHandlers: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     }, z.core.$strip>>>;
 }, z.core.$strip>, z.ZodTransform<{
@@ -269,8 +269,8 @@ declare const RegistryConfigSchema: z.ZodPipe<z.ZodObject<{
         envoyKey?: string | undefined;
     };
     shutdown: {
-        gracePeriodMs: number;
         disableSignalHandlers: boolean;
+        gracePeriodMs?: number | undefined;
     };
     staticDir?: string | undefined;
     httpHost?: string | undefined;
@@ -326,8 +326,8 @@ declare const RegistryConfigSchema: z.ZodPipe<z.ZodObject<{
         envoyKey?: string | undefined;
     };
     shutdown: {
-        gracePeriodMs: number;
         disableSignalHandlers: boolean;
+        gracePeriodMs?: number | undefined;
     };
     staticDir?: string | undefined;
     httpHost?: string | undefined;
@@ -454,6 +454,7 @@ interface DeconstructedError {
     code: string;
     message: string;
     metadata?: unknown;
+    actor?: ActorSpecifier;
 }
 
 interface RivetErrorOptions extends ErrorOptions {
@@ -463,12 +464,21 @@ interface RivetErrorOptions extends ErrorOptions {
     metadata?: unknown;
     /** Explicit HTTP status override for router responses. */
     statusCode?: number;
+    /** Actor context associated with this error. */
+    actor?: ActorSpecifier;
+}
+/** Identifies the actor that was handling work when an error was produced. */
+interface ActorSpecifier {
+    actorId: string;
+    generation: number;
+    key?: string;
 }
 declare class RivetError extends Error {
     __type: "RivetError";
     public: boolean;
     metadata?: unknown;
     statusCode: number;
+    actor?: ActorSpecifier;
     readonly group: string;
     readonly code: string;
     static isRivetError(error: unknown): error is RivetError | DeconstructedError;
@@ -592,6 +602,25 @@ 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).
+     *
+     * @param opts.port      Port to listen on. Defaults to 3000.
+     * @param opts.publicDir If set, serves static files from this directory
+     *                       before falling through to the registry handler.
+     *
+     * @example
+     * ```ts
+     * await registry.listen();
+     * await registry.listen({ port: 8080, publicDir: "./public" });
+     * ```
+     */
+    listen(opts?: {
+        port?: number;
+        publicDir?: string;
+    }): Promise<void>;
     diagnostics(): Promise<RegistryDiagnostics>;
     startEnvoy(): void;
     /**
@@ -1088,6 +1117,7 @@ type Client<A extends Registry<any>> = ClientRaw & {
 };
 
 declare const ACTOR_CONTEXT_INTERNAL_SYMBOL: unique symbol;
+declare const RAW_STATE_SYMBOL: unique symbol;
 interface ActorLogger {
     level: any;
     fatal: any;
@@ -1207,6 +1237,8 @@ interface Conn<TState = unknown, TConnParams = unknown, TConnState = unknown, TV
 }
 interface ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider, TEvents extends EventSchemaConfig = Record<never, never>, TQueues extends QueueSchemaConfig = Record<never, never>> {
     [ACTOR_CONTEXT_INTERNAL_SYMBOL]?: unknown;
+    /** Returns the raw unwrapped state without the write-through proxy. */
+    [RAW_STATE_SYMBOL](): TState;
     state: TState;
     vars: TVars;
     readonly kv: ActorKv;

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

@@ -220,7 +220,7 @@ declare const RegistryConfigSchema: z.ZodPipe<z.ZodObject<{
         envoyKey: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
     shutdown: z.ZodDefault<z.ZodOptional<z.ZodObject<{
-        gracePeriodMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        gracePeriodMs: z.ZodOptional<z.ZodNumber>;
         disableSignalHandlers: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     }, z.core.$strip>>>;
 }, z.core.$strip>, z.ZodTransform<{
@@ -269,8 +269,8 @@ declare const RegistryConfigSchema: z.ZodPipe<z.ZodObject<{
         envoyKey?: string | undefined;
     };
     shutdown: {
-        gracePeriodMs: number;
         disableSignalHandlers: boolean;
+        gracePeriodMs?: number | undefined;
     };
     staticDir?: string | undefined;
     httpHost?: string | undefined;
@@ -326,8 +326,8 @@ declare const RegistryConfigSchema: z.ZodPipe<z.ZodObject<{
         envoyKey?: string | undefined;
     };
     shutdown: {
-        gracePeriodMs: number;
         disableSignalHandlers: boolean;
+        gracePeriodMs?: number | undefined;
     };
     staticDir?: string | undefined;
     httpHost?: string | undefined;
@@ -454,6 +454,7 @@ interface DeconstructedError {
     code: string;
     message: string;
     metadata?: unknown;
+    actor?: ActorSpecifier;
 }
 
 interface RivetErrorOptions extends ErrorOptions {
@@ -463,12 +464,21 @@ interface RivetErrorOptions extends ErrorOptions {
     metadata?: unknown;
     /** Explicit HTTP status override for router responses. */
     statusCode?: number;
+    /** Actor context associated with this error. */
+    actor?: ActorSpecifier;
+}
+/** Identifies the actor that was handling work when an error was produced. */
+interface ActorSpecifier {
+    actorId: string;
+    generation: number;
+    key?: string;
 }
 declare class RivetError extends Error {
     __type: "RivetError";
     public: boolean;
     metadata?: unknown;
     statusCode: number;
+    actor?: ActorSpecifier;
     readonly group: string;
     readonly code: string;
     static isRivetError(error: unknown): error is RivetError | DeconstructedError;
@@ -592,6 +602,25 @@ 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).
+     *
+     * @param opts.port      Port to listen on. Defaults to 3000.
+     * @param opts.publicDir If set, serves static files from this directory
+     *                       before falling through to the registry handler.
+     *
+     * @example
+     * ```ts
+     * await registry.listen();
+     * await registry.listen({ port: 8080, publicDir: "./public" });
+     * ```
+     */
+    listen(opts?: {
+        port?: number;
+        publicDir?: string;
+    }): Promise<void>;
     diagnostics(): Promise<RegistryDiagnostics>;
     startEnvoy(): void;
     /**
@@ -1088,6 +1117,7 @@ type Client<A extends Registry<any>> = ClientRaw & {
 };
 
 declare const ACTOR_CONTEXT_INTERNAL_SYMBOL: unique symbol;
+declare const RAW_STATE_SYMBOL: unique symbol;
 interface ActorLogger {
     level: any;
     fatal: any;
@@ -1207,6 +1237,8 @@ interface Conn<TState = unknown, TConnParams = unknown, TConnState = unknown, TV
 }
 interface ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider, TEvents extends EventSchemaConfig = Record<never, never>, TQueues extends QueueSchemaConfig = Record<never, never>> {
     [ACTOR_CONTEXT_INTERNAL_SYMBOL]?: unknown;
+    /** Returns the raw unwrapped state without the write-through proxy. */
+    [RAW_STATE_SYMBOL](): TState;
     state: TState;
     vars: TVars;
     readonly kv: ActorKv;

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

@@ -787,7 +787,7 @@ function isRivetErrorCode(error, group, code) {
 // package.json
 var package_default = {
   name: "rivetkit",
-  version: "2.3.0-rc.5",
+  version: "2.3.0-rc.7",
   description: "Lightweight libraries for building stateful actors on edge platforms",
   license: "Apache-2.0",
   keywords: [
@@ -955,13 +955,14 @@ var package_default = {
     "actor-config-schema-gen": "tsx scripts/actor-config-schema-gen.ts"
   },
   dependencies: {
-    "@rivet-dev/agent-os-core": "^0.1.1",
     "@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",
     "@rivetkit/engine-cli": "workspace:*",
     "@rivetkit/engine-envoy-protocol": "workspace:*",
+    "@rivetkit/on-change": "6.0.1",
     "@rivetkit/rivetkit-napi": "workspace:*",
     "@rivetkit/rivetkit-wasm": "workspace:*",
     "@rivetkit/traces": "workspace:*",
@@ -979,10 +980,10 @@ var package_default = {
     zod: "^4.1.0"
   },
   devDependencies: {
+    "@biomejs/biome": "^2.3",
     "@copilotkit/llmock": "^1.6.0",
     "@rivet-dev/agent-os-common": "*",
     "@rivet-dev/agent-os-pi": "^0.1.1",
-    "@biomejs/biome": "^2.3",
     "@standard-schema/spec": "^1.0.0",
     "@types/invariant": "^2",
     "@types/node": "^22.13.1",
@@ -1068,6 +1069,7 @@ function configureDefaultLogger(logLevel) {
       messageKey: "msg",
       // Do not include pid/hostname in output
       base: {},
+      errorKey: "error",
       // Keep the numeric level so the logfmt sink can match Pino's levels.
       formatters: {
         level(_label, number) {
@@ -1773,10 +1775,10 @@ function subscribeToSession(c, agentOs2, sessionId, parsedConfig) {
       JSON.parse(JSON.stringify({ sessionId, event: event2 }))
     );
     persistSessionEvent(c, sessionId, event2).catch(
-      (err) => c.log.error({
+      (error) => c.log.error({
         msg: "agent-os failed to persist session event",
         sessionId,
-        error: err
+        error
       })
     );
     if (parsedConfig.onSessionEvent) {