@rivetkit/rivetkit-napi 0.0.0-counter-latency-current-actor-metrics.6d50b18 → 0.0.0-feat-dylib-actor-plugin.5d959bc

package/index.d.ts

@@ -47,6 +47,26 @@ export interface JsQueueSendResult {
 export interface JsActionDefinition {
   name: string
 }
+/**
+ * One entry in the actor's `inspector.tabs[]` declaration. Either a
+ * custom-tab descriptor (id + label + source dir) or a built-in modifier
+ * (id + hidden=true). Validation already happened on the TS side; the
+ * runtime just splits the discriminator.
+ */
+export interface JsInspectorTabEntry {
+  id: string
+  /** Required for custom entries; omitted for HideBuiltin. */
+  label?: string
+  /** Required for custom entries — absolute path to the source directory. */
+  source?: string
+  /**
+   * Optional icon id for custom entries. Dashboard maps strings to
+   * glyphs; unknown ids fall back to a generic icon.
+   */
+  icon?: string
+  /** Set to true for HideBuiltin entries. */
+  hidden?: boolean
+}
 export interface JsActorConfig {
   name?: string
   icon?: string
@@ -78,6 +98,13 @@ export interface JsActorConfig {
   preloadMaxWorkflowBytes?: number
   preloadMaxConnectionsBytes?: number
   actions?: Array<JsActionDefinition>
+  inspectorTabs?: Array<JsInspectorTabEntry>
+}
+/** Options for loading a native actor plugin (`cdylib`) by path. */
+export interface NapiNativePluginOptions {
+  pluginPath: string
+  configJson?: string
+  sidecarPath?: string
 }
 export interface JsBindParam {
   kind: string
@@ -155,6 +182,8 @@ export interface JsServeConfig {
   namespace: string
   poolName: string
   engineBinaryPath?: string
+  engineHost?: string
+  enginePort?: number
   handleInspectorHttpInRuntime?: boolean
   serverlessBasePath?: string
   serverlessPackageVersion: string
@@ -242,12 +271,20 @@ export declare class ActorContext {
   broadcast(name: string, args: Buffer): void
   waitUntil(promise: Promise<any>): void
   waitForTrackedShutdownWork(): Promise<boolean>
+  waitForTrackedShutdownWorkUnbounded(): Promise<void>
   registerTask(promise: Promise<any>): void
   runtimeState(): object
   clearRuntimeState(): void
 }
 export declare class NapiActorFactory {
   constructor(callbacks: object, config?: JsActorConfig | undefined | null)
+  /**
+   * Static constructor that loads a native actor plugin (`cdylib`) by path and
+   * adapts it through the generic `rivet-actor-plugin-abi`. RivetKit holds no
+   * plugin-specific knowledge: `config_json` is an opaque envelope the plugin
+   * parses itself, and `sidecar_path` is forwarded verbatim.
+   */
+  static fromNativePlugin(options: NapiNativePluginOptions): NapiActorFactory
 }
 export declare class CancellationToken {
   constructor()
@@ -289,7 +326,7 @@ export declare class Queue {
   next(options?: JsQueueNextOptions | undefined | null, signal?: CancellationToken | undefined | null): Promise<QueueMessage | null>
   nextBatch(options?: JsQueueNextBatchOptions | undefined | null, signal?: CancellationToken | undefined | null): Promise<Array<QueueMessage>>
   waitForNames(names: Array<string>, options?: JsQueueWaitOptions | undefined | null, signal?: CancellationToken | undefined | null): Promise<QueueMessage>
-  waitForNamesAvailable(names: Array<string>, options?: JsQueueWaitOptions | undefined | null): Promise<void>
+  waitForNamesAvailable(names: Array<string>, options?: JsQueueWaitOptions | undefined | null, signal?: CancellationToken | undefined | null): Promise<void>
   enqueueAndWait(name: string, body: Buffer, options?: JsQueueEnqueueAndWaitOptions | undefined | null, signal?: CancellationToken | undefined | null): Promise<Buffer | null>
   tryNext(options?: JsQueueTryNextOptions | undefined | null): QueueMessage | null
   tryNextBatch(options?: JsQueueTryNextBatchOptions | undefined | null): Array<QueueMessage>
@@ -316,6 +353,7 @@ export declare class CoreRegistry {
    * separately to avoid re-entrancy.
    */
   shutdown(): Promise<void>
+  actorStopThresholdMs(): Promise<number | null>
   health(): Promise<JsRegistryRouteResponse>
   metadata(): JsRegistryRouteResponse
   metrics(): JsRegistryRouteResponse

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@rivetkit/rivetkit-napi",
-	"version": "0.0.0-counter-latency-current-actor-metrics.6d50b18",
+	"version": "0.0.0-feat-dylib-actor-plugin.5d959bc",
 	"description": "Native N-API addon for RivetKit providing envoy client and SQLite access",
 	"license": "Apache-2.0",
 	"main": "index.js",
@@ -43,15 +43,15 @@
 	},
 	"dependencies": {
 		"@napi-rs/cli": "^2.18.4",
-		"@rivetkit/engine-envoy-protocol": "0.0.0-counter-latency-current-actor-metrics.6d50b18"
+		"@rivetkit/engine-envoy-protocol": "0.0.0-feat-dylib-actor-plugin.5d959bc"
 	},
 	"optionalDependencies": {
-		"@rivetkit/rivetkit-napi-darwin-arm64": "0.0.0-counter-latency-current-actor-metrics.6d50b18",
-		"@rivetkit/rivetkit-napi-darwin-x64": "0.0.0-counter-latency-current-actor-metrics.6d50b18",
-		"@rivetkit/rivetkit-napi-linux-arm64-gnu": "0.0.0-counter-latency-current-actor-metrics.6d50b18",
-		"@rivetkit/rivetkit-napi-linux-arm64-musl": "0.0.0-counter-latency-current-actor-metrics.6d50b18",
-		"@rivetkit/rivetkit-napi-linux-x64-gnu": "0.0.0-counter-latency-current-actor-metrics.6d50b18",
-		"@rivetkit/rivetkit-napi-linux-x64-musl": "0.0.0-counter-latency-current-actor-metrics.6d50b18",
-		"@rivetkit/rivetkit-napi-win32-x64-msvc": "0.0.0-counter-latency-current-actor-metrics.6d50b18"
+		"@rivetkit/rivetkit-napi-darwin-arm64": "0.0.0-feat-dylib-actor-plugin.5d959bc",
+		"@rivetkit/rivetkit-napi-darwin-x64": "0.0.0-feat-dylib-actor-plugin.5d959bc",
+		"@rivetkit/rivetkit-napi-linux-arm64-gnu": "0.0.0-feat-dylib-actor-plugin.5d959bc",
+		"@rivetkit/rivetkit-napi-linux-arm64-musl": "0.0.0-feat-dylib-actor-plugin.5d959bc",
+		"@rivetkit/rivetkit-napi-linux-x64-gnu": "0.0.0-feat-dylib-actor-plugin.5d959bc",
+		"@rivetkit/rivetkit-napi-linux-x64-musl": "0.0.0-feat-dylib-actor-plugin.5d959bc",
+		"@rivetkit/rivetkit-napi-win32-x64-msvc": "0.0.0-feat-dylib-actor-plugin.5d959bc"
 	}
 }