rivetkit 2.3.19 → 2.3.20

package/dist/tsup/test/mod.cjs

@@ -1,13 +1,13 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
-var _chunk7A5EIXJJcjs = require('../chunk-7A5EIXJJ.cjs');
+var _chunkRSIOGT2Ucjs = require('../chunk-RSIOGT2U.cjs');
 
 
-var _chunkIJUXBWH4cjs = require('../chunk-IJUXBWH4.cjs');
+var _chunkA36FMKOVcjs = require('../chunk-A36FMKOV.cjs');
 require('../chunk-MYWZCDML.cjs');
-require('../chunk-OGPFN6BT.cjs');
+require('../chunk-3WS7Z64U.cjs');
 require('../chunk-KVFIONKQ.cjs');
-require('../chunk-RJC5O2SD.cjs');
+require('../chunk-2CE5UNWK.cjs');
 require('../chunk-JX2ITWAV.cjs');
 
 // src/test/ready.ts
@@ -36,8 +36,8 @@ async function setupTest(c, registry) {
   registry.config.noWelcome = true;
   registry.start();
   await waitForRegistryReady(registry);
-  const client = _chunk7A5EIXJJcjs.createClient.call(void 0, {
-    ..._chunkIJUXBWH4cjs.convertRegistryConfigToClientConfig.call(void 0, registry.parseConfig()),
+  const client = _chunkRSIOGT2Ucjs.createClient.call(void 0, {
+    ..._chunkA36FMKOVcjs.convertRegistryConfigToClientConfig.call(void 0, registry.parseConfig()),
     disableMetadataLookup: false
   });
   c.onTestFinished(async () => {

package/dist/tsup/test/mod.d.cts

@@ -1,5 +1,5 @@
 import { TestContext } from 'vitest';
-import { aF as Registry, a3 as Client } from '../config-8n2AOhXK.cjs';
+import { aI as Registry, a6 as Client } from '../config-Ct5uXxXk.cjs';
 import 'zod/v4';
 import '../config-ey2I2zz5.cjs';
 import '@rivetkit/rivetkit-wasm';

package/dist/tsup/test/mod.d.ts

@@ -1,5 +1,5 @@
 import { TestContext } from 'vitest';
-import { aF as Registry, a3 as Client } from '../config-DEm0yIVV.js';
+import { aI as Registry, a6 as Client } from '../config-Be-VOHaX.js';
 import 'zod/v4';
 import '../config-ey2I2zz5.js';
 import '@rivetkit/rivetkit-wasm';

package/dist/tsup/test/mod.js

@@ -1,13 +1,13 @@
 import {
   createClient
-} from "../chunk-7HTST3NX.js";
+} from "../chunk-2NXLTFWI.js";
 import {
   convertRegistryConfigToClientConfig
-} from "../chunk-BKX7UDTA.js";
+} from "../chunk-5G2J26VM.js";
 import "../chunk-JI6GZ2C2.js";
-import "../chunk-X7RMJQGY.js";
+import "../chunk-553CIQJY.js";
 import "../chunk-JTHHCZCZ.js";
-import "../chunk-DN6MD3KK.js";
+import "../chunk-DHWZTUKA.js";
 import "../chunk-P2OFXH4G.js";
 
 // src/test/ready.ts

package/dist/tsup/utils.cjs

@@ -19,7 +19,7 @@
 
 
 
-var _chunkRJC5O2SDcjs = require('./chunk-RJC5O2SD.cjs');
+var _chunk2CE5UNWKcjs = require('./chunk-2CE5UNWK.cjs');
 require('./chunk-JX2ITWAV.cjs');
 
 
@@ -42,5 +42,5 @@ require('./chunk-JX2ITWAV.cjs');
 
 
 
-exports.EXTRA_ERROR_LOG = _chunkRJC5O2SDcjs.EXTRA_ERROR_LOG; exports.SinglePromiseQueue = _chunkRJC5O2SDcjs.SinglePromiseQueue; exports.VERSION = _chunkRJC5O2SDcjs.VERSION; exports.arrayBuffersEqual = _chunkRJC5O2SDcjs.arrayBuffersEqual; exports.assertUnreachable = _chunkRJC5O2SDcjs.assertUnreachable; exports.bufferToArrayBuffer = _chunkRJC5O2SDcjs.bufferToArrayBuffer; exports.combineUrlPath = _chunkRJC5O2SDcjs.combineUrlPath; exports.dbg = _chunkRJC5O2SDcjs.dbg; exports.detectRuntime = _chunkRJC5O2SDcjs.detectRuntime; exports.getEnvUniversal = _chunkRJC5O2SDcjs.getEnvUniversal; exports.httpUserAgent = _chunkRJC5O2SDcjs.httpUserAgent; exports.interval = _chunkRJC5O2SDcjs.interval; exports.joinSignals = _chunkRJC5O2SDcjs.joinSignals; exports.jsonParseCompat = _chunkRJC5O2SDcjs.jsonParseCompat; exports.jsonStringifyCompat = _chunkRJC5O2SDcjs.jsonStringifyCompat; exports.promiseWithResolvers = _chunkRJC5O2SDcjs.promiseWithResolvers; exports.setLongTimeout = _chunkRJC5O2SDcjs.setLongTimeout; exports.sleep = _chunkRJC5O2SDcjs.sleep; exports.stringifyError = _chunkRJC5O2SDcjs.stringifyError; exports.toUint8Array = _chunkRJC5O2SDcjs.toUint8Array;
+exports.EXTRA_ERROR_LOG = _chunk2CE5UNWKcjs.EXTRA_ERROR_LOG; exports.SinglePromiseQueue = _chunk2CE5UNWKcjs.SinglePromiseQueue; exports.VERSION = _chunk2CE5UNWKcjs.VERSION; exports.arrayBuffersEqual = _chunk2CE5UNWKcjs.arrayBuffersEqual; exports.assertUnreachable = _chunk2CE5UNWKcjs.assertUnreachable; exports.bufferToArrayBuffer = _chunk2CE5UNWKcjs.bufferToArrayBuffer; exports.combineUrlPath = _chunk2CE5UNWKcjs.combineUrlPath; exports.dbg = _chunk2CE5UNWKcjs.dbg; exports.detectRuntime = _chunk2CE5UNWKcjs.detectRuntime; exports.getEnvUniversal = _chunk2CE5UNWKcjs.getEnvUniversal; exports.httpUserAgent = _chunk2CE5UNWKcjs.httpUserAgent; exports.interval = _chunk2CE5UNWKcjs.interval; exports.joinSignals = _chunk2CE5UNWKcjs.joinSignals; exports.jsonParseCompat = _chunk2CE5UNWKcjs.jsonParseCompat; exports.jsonStringifyCompat = _chunk2CE5UNWKcjs.jsonStringifyCompat; exports.promiseWithResolvers = _chunk2CE5UNWKcjs.promiseWithResolvers; exports.setLongTimeout = _chunk2CE5UNWKcjs.setLongTimeout; exports.sleep = _chunk2CE5UNWKcjs.sleep; exports.stringifyError = _chunk2CE5UNWKcjs.stringifyError; exports.toUint8Array = _chunk2CE5UNWKcjs.toUint8Array;
 //# sourceMappingURL=utils.cjs.map

package/dist/tsup/utils.js

@@ -19,7 +19,7 @@ import {
   sleep,
   stringifyError,
   toUint8Array
-} from "./chunk-DN6MD3KK.js";
+} from "./chunk-DHWZTUKA.js";
 import "./chunk-P2OFXH4G.js";
 export {
   EXTRA_ERROR_LOG,

package/dist/tsup/workflow/mod.cjs

@@ -1,19 +1,19 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } async function _asyncNullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return await rhsFn(); } } var _class; var _class2;
 
-var _chunk7BRRGBRYcjs = require('../chunk-7BRRGBRY.cjs');
-require('../chunk-G4U5L6AX.cjs');
+var _chunkWAISW7KRcjs = require('../chunk-WAISW7KR.cjs');
+require('../chunk-IHKDFKM4.cjs');
 
 
 
-var _chunkEO5UOXXYcjs = require('../chunk-EO5UOXXY.cjs');
-require('../chunk-PPEIPCW4.cjs');
+var _chunkNWCAIWHLcjs = require('../chunk-NWCAIWHL.cjs');
+require('../chunk-76YTS32R.cjs');
 
 
 
 var _chunkMYWZCDMLcjs = require('../chunk-MYWZCDML.cjs');
 
 
-var _chunkRJC5O2SDcjs = require('../chunk-RJC5O2SD.cjs');
+var _chunk2CE5UNWKcjs = require('../chunk-2CE5UNWK.cjs');
 
 
 
@@ -743,13 +743,13 @@ function workflow(fn, options = {}) {
   function getWorkflowInspector(actorId) {
     let workflowInspector = workflowInspectors.get(actorId);
     if (!workflowInspector) {
-      workflowInspector = _chunk7BRRGBRYcjs.createWorkflowInspectorAdapter.call(void 0, );
+      workflowInspector = _chunkWAISW7KRcjs.createWorkflowInspectorAdapter.call(void 0, );
       workflowInspectors.set(actorId, workflowInspector);
     }
     return workflowInspector;
   }
   async function run(runCtx) {
-    const actor = runCtx[_chunkEO5UOXXYcjs.ACTOR_CONTEXT_INTERNAL_SYMBOL];
+    const actor = runCtx[_chunkNWCAIWHLcjs.ACTOR_CONTEXT_INTERNAL_SYMBOL];
     _invariant2.default.call(void 0, actor, "workflow() requires an actor instance");
     const workflowInspector = getWorkflowInspector(actor.id);
     const driver = new ActorWorkflowDriver(actor, runCtx);
@@ -816,19 +816,19 @@ function workflow(fn, options = {}) {
       if (shouldRethrowWorkflowError(error)) {
         runCtx.log.error({
           msg: "workflow run failed",
-          error: _chunkRJC5O2SDcjs.stringifyError.call(void 0, error)
+          error: _chunk2CE5UNWKcjs.stringifyError.call(void 0, error)
         });
         throw error;
       }
       runCtx.log.warn({
         msg: "workflow failed and will sleep until woken",
-        error: _chunkRJC5O2SDcjs.stringifyError.call(void 0, error)
+        error: _chunk2CE5UNWKcjs.stringifyError.call(void 0, error)
       });
     } finally {
       runCtx.abortSignal.removeEventListener("abort", onAbort);
     }
   }
-  return _chunkEO5UOXXYcjs.defineRunHandler.call(void 0, run, {
+  return _chunkNWCAIWHLcjs.defineRunHandler.call(void 0, run, {
     icon: "diagram-project",
     inspectorKind: "workflow",
     createInspector: ({ actorId, control }) => {

package/dist/tsup/workflow/mod.d.cts

@@ -1,9 +1,9 @@
 import { WorkflowErrorEvent } from '@rivetkit/workflow-engine';
 export { Loop, TryBlockCatchKind, TryBlockConfig, TryBlockFailure, TryBlockResult, TryStepCatchKind, TryStepConfig, TryStepFailure, TryStepResult, WorkflowError, WorkflowErrorEvent } from '@rivetkit/workflow-engine';
-import { E as EventSchemaConfig, Q as QueueSchemaConfig, h as RunContext } from '../config-8n2AOhXK.cjs';
+import { E as EventSchemaConfig, Q as QueueSchemaConfig, h as RunContext } from '../config-Ct5uXxXk.cjs';
 import { A as AnyDatabaseProvider } from '../config-ey2I2zz5.cjs';
-import { d as WorkflowContext } from '../context-DwjOVvlE.cjs';
-export { e as WorkflowBranchConfig, W as WorkflowBranchContextOf, a as WorkflowContextOf, f as WorkflowLoopConfig, b as WorkflowLoopContextOf, g as WorkflowStepConfig, h as WorkflowStepContext, c as WorkflowStepContextOf, i as WorkflowTryConfig, j as WorkflowTryStepConfig } from '../context-DwjOVvlE.cjs';
+import { d as WorkflowContext } from '../context-Cw-11Q-B.cjs';
+export { e as WorkflowBranchConfig, W as WorkflowBranchContextOf, a as WorkflowContextOf, f as WorkflowLoopConfig, b as WorkflowLoopContextOf, g as WorkflowStepConfig, h as WorkflowStepContext, c as WorkflowStepContextOf, i as WorkflowTryConfig, j as WorkflowTryStepConfig } from '../context-Cw-11Q-B.cjs';
 import 'zod/v4';
 import '@rivetkit/rivetkit-wasm';
 import 'zod';

package/dist/tsup/workflow/mod.d.ts

@@ -1,9 +1,9 @@
 import { WorkflowErrorEvent } from '@rivetkit/workflow-engine';
 export { Loop, TryBlockCatchKind, TryBlockConfig, TryBlockFailure, TryBlockResult, TryStepCatchKind, TryStepConfig, TryStepFailure, TryStepResult, WorkflowError, WorkflowErrorEvent } from '@rivetkit/workflow-engine';
-import { E as EventSchemaConfig, Q as QueueSchemaConfig, h as RunContext } from '../config-DEm0yIVV.js';
+import { E as EventSchemaConfig, Q as QueueSchemaConfig, h as RunContext } from '../config-Be-VOHaX.js';
 import { A as AnyDatabaseProvider } from '../config-ey2I2zz5.js';
-import { d as WorkflowContext } from '../context-DGg2-IOm.js';
-export { e as WorkflowBranchConfig, W as WorkflowBranchContextOf, a as WorkflowContextOf, f as WorkflowLoopConfig, b as WorkflowLoopContextOf, g as WorkflowStepConfig, h as WorkflowStepContext, c as WorkflowStepContextOf, i as WorkflowTryConfig, j as WorkflowTryStepConfig } from '../context-DGg2-IOm.js';
+import { d as WorkflowContext } from '../context-CXLa0BIM.js';
+export { e as WorkflowBranchConfig, W as WorkflowBranchContextOf, a as WorkflowContextOf, f as WorkflowLoopConfig, b as WorkflowLoopContextOf, g as WorkflowStepConfig, h as WorkflowStepContext, c as WorkflowStepContextOf, i as WorkflowTryConfig, j as WorkflowTryStepConfig } from '../context-CXLa0BIM.js';
 import 'zod/v4';
 import '@rivetkit/rivetkit-wasm';
 import 'zod';

package/dist/tsup/workflow/mod.js

@@ -1,19 +1,19 @@
 import {
   createWorkflowInspectorAdapter
-} from "../chunk-DK3L22R6.js";
-import "../chunk-464WE4RF.js";
+} from "../chunk-TZVAVPGJ.js";
+import "../chunk-DMQUERRN.js";
 import {
   ACTOR_CONTEXT_INTERNAL_SYMBOL,
   defineRunHandler
-} from "../chunk-EB77NZL4.js";
-import "../chunk-4SC2NSAV.js";
+} from "../chunk-CSOHAAZK.js";
+import "../chunk-SNNVRHLX.js";
 import {
   makeWorkflowKey,
   workflowStoragePrefix
 } from "../chunk-JI6GZ2C2.js";
 import {
   stringifyError
-} from "../chunk-DN6MD3KK.js";
+} from "../chunk-DHWZTUKA.js";
 import {
   RivetError,
   isActorAbortedError

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "rivetkit",
-	"version": "2.3.19",
+	"version": "2.3.20",
 	"description": "Lightweight libraries for building stateful actors on edge platforms",
 	"license": "Apache-2.0",
 	"keywords": [
@@ -213,14 +213,14 @@
 		"@rivet-dev/agent-os-core": "^0.1.1",
 		"@rivet-dev/services": "^0.1.5",
 		"@rivetkit/bare-ts": "^0.6.2",
-		"@rivetkit/engine-cli": "2.3.19",
-		"@rivetkit/engine-envoy-protocol": "2.3.19",
+		"@rivetkit/engine-cli": "2.3.20",
+		"@rivetkit/engine-envoy-protocol": "2.3.20",
 		"@rivetkit/on-change": "6.0.1",
-		"@rivetkit/rivetkit-napi": "2.3.19",
-		"@rivetkit/rivetkit-wasm": "2.3.19",
-		"@rivetkit/traces": "2.3.19",
-		"@rivetkit/virtual-websocket": "2.3.19",
-		"@rivetkit/workflow-engine": "2.3.19",
+		"@rivetkit/rivetkit-napi": "2.3.20",
+		"@rivetkit/rivetkit-wasm": "2.3.20",
+		"@rivetkit/traces": "2.3.20",
+		"@rivetkit/virtual-websocket": "2.3.20",
+		"@rivetkit/workflow-engine": "2.3.20",
 		"cbor-x": "^1.6.0",
 		"drizzle-orm": "0.45.2",
 		"hono": "^4.7.0",

package/src/actor/actions.ts

@@ -1,4 +1,5 @@
 import type { PrimitiveSchema } from "./schema";
+import type { ActionSampleRates } from "./tracing";
 
 export type RuntimeActionHandler = (...args: any[]) => any;
 
@@ -46,6 +47,41 @@ export function flattenActionInputSchemas(
 	return flattened;
 }
 
+/**
+ * Flatten per-action sample rates into dot-separated action names.
+ *
+ * @throws TypeError when a rate names something that is not an action.
+ */
+export function flattenActionTraceSamplers(
+	actions: unknown,
+	rates: ActionSampleRates = {},
+): Record<string, number> {
+	const handlers = flattenActionHandlers(actions);
+	const flattened = Object.fromEntries(flattenSampleRates(rates, []));
+	for (const name of Object.keys(flattened)) {
+		if (!Object.hasOwn(handlers, name)) {
+			throw new TypeError(
+				`tracing.actions.${name} does not name an action`,
+			);
+		}
+	}
+	return flattened;
+}
+
+function flattenSampleRates(
+	rates: ActionSampleRates,
+	path: readonly string[],
+): Array<[name: string, rate: number]> {
+	return Object.entries(rates).flatMap(
+		([segment, rate]): Array<[name: string, rate: number]> => {
+			const childPath = [...path, segment];
+			return typeof rate === "number"
+				? [[childPath.join("."), rate]]
+				: flattenSampleRates(rate, childPath);
+		},
+	);
+}
+
 interface ActionEntry {
 	name: string;
 	path: string[];

package/src/actor/config.ts

@@ -16,6 +16,7 @@ import type {
 	PrimitiveSchema,
 	QueueSchemaConfig,
 } from "./schema";
+import type { ActionSampleRates, ActorTracingOptions } from "./tracing";
 
 export const DEFAULT_SLEEP_GRACE_PERIOD = 15_000;
 
@@ -1342,6 +1343,12 @@ export const ActorOptionsSchema = GlobalActorOptionsBaseSchema.extend(
 export type ActorOptions = z.infer<typeof ActorOptionsSchema>;
 export type ActorOptionsInput = z.input<typeof ActorOptionsSchema>;
 
+const zSampleRate = z.number().min(0).max(1);
+
+const zActionSampleRates: z.ZodType<ActionSampleRates> = z.lazy(() =>
+	z.record(z.string(), z.union([zSampleRate, zActionSampleRates])),
+);
+
 export const ActorConfigSchema = z
 	.object({
 		onCreate: zFunction().optional(),
@@ -1359,6 +1366,13 @@ export const ActorConfigSchema = z
 		onWebSocket: zFunction().optional(),
 		actions: zActionTree.default(() => ({})),
 		actionInputSchemas: z.record(z.string(), z.any()).optional(),
+		tracing: z
+			.object({
+				sampler: zSampleRate.optional(),
+				actions: zActionSampleRates.optional(),
+			})
+			.strict()
+			.optional(),
 		connParamsSchema: z.any().optional(),
 		events: z.record(z.string(), z.any()).optional(),
 		queues: z.record(z.string(), z.any()).optional(),
@@ -1904,6 +1918,12 @@ interface BaseActorConfig<
 	 */
 	actionInputSchemas?: ActionInputSchemas;
 
+	/**
+	 * How much of this actor's work is recorded in traces. Defaults to the
+	 * process sampler from `OTEL_TRACES_SAMPLER`.
+	 */
+	tracing?: ActorTracingOptions<TActions>;
+
 	/**
 	 * Optional schema for validating connection params in native runtimes.
 	 */
@@ -2061,6 +2081,7 @@ export type ActorConfigInput<
 } & Omit<
 	z.input<typeof ActorConfigSchema>,
 	| "actions"
+	| "tracing"
 	| "events"
 	| "queues"
 	| "onCreate"
@@ -2437,6 +2458,12 @@ export const DocActorConfigSchema = z
 			.describe(
 				"Optional schemas for validating action argument tuples in native runtimes. May mirror nested action groups or use dot-separated low-level action names.",
 			),
+		tracing: z
+			.unknown()
+			.optional()
+			.describe(
+				"Trace sampling for this actor: `sampler` is the share of its invocations that are recorded, from 0 to 1, with optional per-action rates under `actions`. A rate lowers what is recorded and never raises it. Defaults to the process sampler from OTEL_TRACES_SAMPLER.",
+			),
 		connParamsSchema: z
 			.unknown()
 			.optional()

package/src/actor/definition.ts

@@ -1,6 +1,10 @@
 import type { AnyDatabaseProvider } from "@/common/database/config";
 import type { RegistryConfig } from "@/registry/config";
-import { flattenActionHandlers, flattenActionInputSchemas } from "./actions";
+import {
+	flattenActionHandlers,
+	flattenActionInputSchemas,
+	flattenActionTraceSamplers,
+} from "./actions";
 import {
 	type Actions,
 	type ActorConfig,
@@ -209,6 +213,7 @@ export function actor<
 	>;
 	flattenActionHandlers(config.actions);
 	flattenActionInputSchemas(config.actions, config.actionInputSchemas);
+	flattenActionTraceSamplers(config.actions, config.tracing?.actions);
 	return new ActorDefinition(config);
 }
 

package/src/actor/mod.ts

@@ -67,3 +67,8 @@ export {
 	queue,
 	type Type,
 } from "./schema";
+export type {
+	ActionSampleRates,
+	ActionTraceSamplers,
+	ActorTracingOptions,
+} from "./tracing";

package/src/actor/tracing.ts

@@ -0,0 +1,28 @@
+/** Sample rates keyed by action name, nested like the actor's action groups. */
+export interface ActionSampleRates {
+	readonly [name: string]: number | ActionSampleRates;
+}
+
+/**
+ * {@link ActionSampleRates} limited to the actions of one actor, so a rate for
+ * an action that does not exist is a compile error.
+ */
+export type ActionTraceSamplers<TActions> = {
+	readonly [K in keyof TActions]?: TActions[K] extends (
+		...args: never[]
+	) => unknown
+		? number
+		: ActionTraceSamplers<TActions[K]>;
+};
+
+/** Trace sampling for one actor definition. */
+export interface ActorTracingOptions<TActions> {
+	/**
+	 * Share of this actor's invocations that are recorded, from 0 to 1. A rate
+	 * lowers what is recorded and never raises it, so an invocation inside a
+	 * trace the caller did not record is not recorded at any rate.
+	 */
+	readonly sampler?: number;
+	/** Rates that replace `sampler` for single actions. */
+	readonly actions?: ActionTraceSamplers<TActions>;
+}

package/src/registry/native.ts

@@ -2,6 +2,7 @@ import { VirtualWebSocket } from "@rivetkit/virtual-websocket";
 import {
 	flattenActionHandlers,
 	flattenActionInputSchemas,
+	flattenActionTraceSamplers,
 } from "@/actor/actions";
 import {
 	ACTOR_CONTEXT_INTERNAL_SYMBOL,
@@ -41,6 +42,7 @@ import {
 	getQueueCanPublish,
 	hasSchemaConfigKey,
 } from "@/actor/schema";
+import type { ActionSampleRates } from "@/actor/tracing";
 import {
 	type AnyClient,
 	type Client,
@@ -112,6 +114,7 @@ import type {
 	CoreRuntime,
 	RegistryHandle,
 	RuntimeActorConfig,
+	RuntimeActorTracingConfig,
 	RuntimeBytes,
 	RuntimeCronFire,
 	RuntimeCronJobInfo,
@@ -3854,6 +3857,17 @@ function withConnContext(
 	});
 }
 
+function buildActorTracingConfig(
+	actions: unknown,
+	tracing: { sampler?: number; actions?: ActionSampleRates } | undefined,
+): RuntimeActorTracingConfig | undefined {
+	if (tracing === undefined) return undefined;
+	return {
+		sampler: tracing.sampler,
+		actions: flattenActionTraceSamplers(actions, tracing.actions),
+	};
+}
+
 function buildActorConfig(
 	definition: AnyActorDefinition,
 	registryConfig: RegistryConfig,
@@ -3874,6 +3888,10 @@ function buildActorConfig(
 		hasDatabase: true,
 		remoteSqlite: usesRemoteSqlite,
 		sqliteProfiling,
+		tracing: buildActorTracingConfig(
+			definition.config.actions,
+			definition.config.tracing,
+		),
 		enableActorRuntimeSocket: options.enableActorRuntimeSocket === true,
 		hasState:
 			config.state !== undefined ||

package/src/registry/runtime.ts

@@ -318,12 +318,20 @@ export interface RuntimeSqlTransactionDatabase {
 	rollback(): Promise<void>;
 }
 
+/** Sample rates for the traces an actor starts, in the shape core takes. */
+export interface RuntimeActorTracingConfig {
+	sampler?: number;
+	/** Keyed by flattened, dot-separated action name. */
+	actions?: Record<string, number>;
+}
+
 export interface RuntimeActorConfig {
 	name?: string;
 	icon?: string;
 	hasDatabase?: boolean;
 	remoteSqlite?: boolean;
 	sqliteProfiling?: SqliteProfilingOptions;
+	tracing?: RuntimeActorTracingConfig;
 	enableActorRuntimeSocket?: boolean;
 	hasState?: boolean;
 	canHibernateWebsocket?: boolean;