rivetkit 2.3.0-rc.8 → 2.3.0

package/dist/tsup/inspector-tab/mod.d.cts

@@ -0,0 +1,250 @@
+import { z } from 'zod';
+import { a0 as CustomInspectorTabEntrySchema, ae as HideInspectorTabEntrySchema, af as InspectorTabEntrySchema } from '../config-CZQQ-mso.cjs';
+export { s as ActorInspectorConfig, t as ActorInspectorConfigSchema, U as BUILTIN_INSPECTOR_TAB_IDS, X as BuiltinInspectorTabIdSchema } from '../config-CZQQ-mso.cjs';
+import 'zod/v4';
+import '../config-D49x8NpL.cjs';
+import '@rivetkit/rivetkit-wasm';
+import 'pino';
+import '@rivetkit/virtual-websocket';
+import '@standard-schema/spec';
+import 'hono';
+import '../utils.cjs';
+import '../utils-DQosb24I.cjs';
+import 'hono/utils/http-status';
+
+/**
+ * Type and schema declarations for custom Rivet inspector tabs.
+ *
+ * Everything here is **derived from runtime Zod schemas** that the
+ * dashboard and rivetkit itself use, so the published types cannot
+ * drift from the wire format. There are three sources of truth:
+ *
+ *   1. The `inspector.tabs[]` actor-config Zod schemas in
+ *      `../actor/config.ts` — re-exported below. These validate the
+ *      authoring surface (`defineActor({ inspector: { tabs: [...] } })`).
+ *   2. The dashboard ↔ tab postMessage envelopes defined in this file.
+ *      The inspector-ui SPA (`frontend/apps/inspector-ui/src/bridge.ts`)
+ *      imports the same schemas to validate messages at runtime, so any
+ *      change here lands on both ends in lockstep.
+ *   3. The inspector HTTP endpoint response schemas defined in this
+ *      file. The dashboard parses every response through them; if the
+ *      Rust handler ever emits a different shape, the dashboard fails
+ *      loudly at the parse step instead of silently casting `unknown`.
+ *
+ * Tab bundles import these types for autocomplete and compile-time
+ * safety:
+ *
+ * ```ts
+ * import type {
+ *   ShellToTabMessage,
+ *   TabToShellMessage,
+ *   V1Init,
+ *   InspectorStateResponse,
+ * } from "rivetkit/inspector-tab";
+ * ```
+ */
+
+/** One entry in the actor's `inspector.tabs[]` declaration. */
+type ActorInspectorTabEntry = z.input<typeof InspectorTabEntrySchema>;
+/** A custom-tab entry — adds a new tab to the dashboard strip. */
+type ActorCustomInspectorTabEntry = z.input<typeof CustomInspectorTabEntrySchema>;
+/** A hide modifier — removes a built-in tab from the strip. */
+type ActorHideInspectorTabEntry = z.input<typeof HideInspectorTabEntrySchema>;
+/** Union of the six built-in inspector tab ids. */
+type BuiltinInspectorTabId = "workflow" | "database" | "state" | "queue" | "connections" | "console";
+/** Public tab descriptor that crosses the dashboard ↔ inspector-ui bridge. */
+declare const InspectorTabDescriptorSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    icon: z.ZodString;
+    isCustom: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Initial handshake from the dashboard. Sent on first mount and again on
+ * every token refresh. Tabs MUST accept late `init` messages and replace
+ * the cached token.
+ */
+declare const V1InitSchema: z.ZodObject<{
+    type: z.ZodLiteral<"init">;
+    v: z.ZodLiteral<1>;
+    actorId: z.ZodString;
+    authToken: z.ZodString;
+    rivetToken: z.ZodOptional<z.ZodString>;
+    activeTab: z.ZodOptional<z.ZodString>;
+    theme: z.ZodOptional<z.ZodEnum<{
+        light: "light";
+        dark: "dark";
+    }>>;
+}, z.core.$strip>;
+/**
+ * Dashboard tells the inspector-ui SPA which built-in tab to render. Not
+ * sent to custom tabs — when the user activates a custom tab the
+ * dashboard navigates the outer iframe to a different `src`.
+ */
+declare const V1SetActiveTabSchema: z.ZodObject<{
+    type: z.ZodLiteral<"set-active-tab">;
+    v: z.ZodLiteral<1>;
+    tab: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Tab → dashboard. Sent once after the message listener is registered.
+ * The dashboard hides the "Connecting to inspector…" overlay on receipt;
+ * if it never arrives the overlay times out after 8 s.
+ */
+declare const V1ReadySchema: z.ZodObject<{
+    type: z.ZodLiteral<"ready">;
+    v: z.ZodLiteral<1>;
+}, z.core.$strip>;
+/**
+ * Tab → dashboard. Sent when the tab gets a 401 on an inspector data
+ * call. The dashboard refreshes the token and re-issues `v1Init`.
+ */
+declare const V1TokenRefreshNeededSchema: z.ZodObject<{
+    type: z.ZodLiteral<"token-refresh-needed">;
+    v: z.ZodLiteral<1>;
+}, z.core.$strip>;
+/**
+ * Emitted by the inspector-ui SPA to tell the dashboard which tabs to
+ * render in the strip. Custom tab bundles do NOT emit this — only the
+ * SPA does.
+ */
+declare const V1TabsAvailableSchema: z.ZodObject<{
+    type: z.ZodLiteral<"tabs-available">;
+    v: z.ZodLiteral<1>;
+    tabs: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        icon: z.ZodString;
+        isCustom: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** Discriminated union of messages a tab can RECEIVE from the dashboard. */
+declare const ShellToTabMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"init">;
+    v: z.ZodLiteral<1>;
+    actorId: z.ZodString;
+    authToken: z.ZodString;
+    rivetToken: z.ZodOptional<z.ZodString>;
+    activeTab: z.ZodOptional<z.ZodString>;
+    theme: z.ZodOptional<z.ZodEnum<{
+        light: "light";
+        dark: "dark";
+    }>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"set-active-tab">;
+    v: z.ZodLiteral<1>;
+    tab: z.ZodString;
+}, z.core.$strip>], "type">;
+/** Discriminated union of messages a tab can SEND to the dashboard. */
+declare const TabToShellMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"ready">;
+    v: z.ZodLiteral<1>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"tabs-available">;
+    v: z.ZodLiteral<1>;
+    tabs: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        icon: z.ZodString;
+        isCustom: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"token-refresh-needed">;
+    v: z.ZodLiteral<1>;
+}, z.core.$strip>], "type">;
+type InspectorTabDescriptor = z.infer<typeof InspectorTabDescriptorSchema>;
+type V1Init = z.infer<typeof V1InitSchema>;
+type V1SetActiveTab = z.infer<typeof V1SetActiveTabSchema>;
+type V1Ready = z.infer<typeof V1ReadySchema>;
+type V1TokenRefreshNeeded = z.infer<typeof V1TokenRefreshNeededSchema>;
+type V1TabsAvailable = z.infer<typeof V1TabsAvailableSchema>;
+type ShellToTabMessage = z.infer<typeof ShellToTabMessageSchema>;
+type TabToShellMessage = z.infer<typeof TabToShellMessageSchema>;
+/** Stable envelope protocol version. Bump only when introducing a v2 shape. */
+declare const POSTMESSAGE_PROTOCOL_VERSION = 1;
+/** URL query parameters the dashboard sets on the tab iframe `src`. */
+declare const SHELL_ORIGIN_PARAM = "shellOrigin";
+declare const ACTOR_ID_PARAM = "actorId";
+/** `GET /inspector/state` response shape. */
+declare const InspectorStateResponseSchema: z.ZodObject<{
+    state: z.ZodUnknown;
+    isStateEnabled: z.ZodBoolean;
+}, z.core.$strip>;
+/** `POST /inspector/action/<name>` request body. */
+declare const InspectorActionRequestSchema: z.ZodObject<{
+    args: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+/** `POST /inspector/action/<name>` response shape. */
+declare const InspectorActionResponseSchema: z.ZodObject<{
+    output: z.ZodUnknown;
+}, z.core.$strip>;
+/** `GET /inspector/rpcs` response shape — the list of action names. */
+declare const InspectorRpcsResponseSchema: z.ZodObject<{
+    rpcs: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+/** One connection record in `GET /inspector/connections`. */
+declare const InspectorConnectionSchema: z.ZodObject<{
+    connectionType: z.ZodNullable<z.ZodString>;
+    id: z.ZodString;
+    details: z.ZodObject<{
+        connectionType: z.ZodNullable<z.ZodString>;
+        params: z.ZodUnknown;
+        stateEnabled: z.ZodBoolean;
+        state: z.ZodUnknown;
+        subscriptions: z.ZodNumber;
+        isHibernatable: z.ZodBoolean;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/** `GET /inspector/connections` response shape. */
+declare const InspectorConnectionsResponseSchema: z.ZodObject<{
+    connections: z.ZodArray<z.ZodObject<{
+        connectionType: z.ZodNullable<z.ZodString>;
+        id: z.ZodString;
+        details: z.ZodObject<{
+            connectionType: z.ZodNullable<z.ZodString>;
+            params: z.ZodUnknown;
+            stateEnabled: z.ZodBoolean;
+            state: z.ZodUnknown;
+            subscriptions: z.ZodNumber;
+            isHibernatable: z.ZodBoolean;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** One queued message in `GET /inspector/queue`. */
+declare const InspectorQueueMessageSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    createdAtMs: z.ZodNumber;
+}, z.core.$strip>;
+/** `GET /inspector/queue` response shape. */
+declare const InspectorQueueResponseSchema: z.ZodObject<{
+    size: z.ZodNumber;
+    maxSize: z.ZodNumber;
+    truncated: z.ZodBoolean;
+    messages: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        createdAtMs: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** `GET /inspector/tab-config` response shape. */
+declare const InspectorTabConfigResponseSchema: z.ZodObject<{
+    tabs: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        icon: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        hidden: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type InspectorStateResponse = z.infer<typeof InspectorStateResponseSchema>;
+type InspectorActionRequest = z.infer<typeof InspectorActionRequestSchema>;
+type InspectorActionResponse = z.infer<typeof InspectorActionResponseSchema>;
+type InspectorRpcsResponse = z.infer<typeof InspectorRpcsResponseSchema>;
+type InspectorConnection = z.infer<typeof InspectorConnectionSchema>;
+type InspectorConnectionsResponse = z.infer<typeof InspectorConnectionsResponseSchema>;
+type InspectorQueueMessage = z.infer<typeof InspectorQueueMessageSchema>;
+type InspectorQueueResponse = z.infer<typeof InspectorQueueResponseSchema>;
+type InspectorTabConfigResponse = z.infer<typeof InspectorTabConfigResponseSchema>;
+
+export { ACTOR_ID_PARAM, type ActorCustomInspectorTabEntry, type ActorHideInspectorTabEntry, type ActorInspectorTabEntry, type BuiltinInspectorTabId, CustomInspectorTabEntrySchema, HideInspectorTabEntrySchema, type InspectorActionRequest, InspectorActionRequestSchema, type InspectorActionResponse, InspectorActionResponseSchema, type InspectorConnection, InspectorConnectionSchema, type InspectorConnectionsResponse, InspectorConnectionsResponseSchema, type InspectorQueueMessage, InspectorQueueMessageSchema, type InspectorQueueResponse, InspectorQueueResponseSchema, type InspectorRpcsResponse, InspectorRpcsResponseSchema, type InspectorStateResponse, InspectorStateResponseSchema, type InspectorTabConfigResponse, InspectorTabConfigResponseSchema, type InspectorTabDescriptor, InspectorTabDescriptorSchema, InspectorTabEntrySchema, POSTMESSAGE_PROTOCOL_VERSION, SHELL_ORIGIN_PARAM, type ShellToTabMessage, ShellToTabMessageSchema, type TabToShellMessage, TabToShellMessageSchema, type V1Init, V1InitSchema, type V1Ready, V1ReadySchema, type V1SetActiveTab, V1SetActiveTabSchema, type V1TabsAvailable, V1TabsAvailableSchema, type V1TokenRefreshNeeded, V1TokenRefreshNeededSchema };

package/dist/tsup/inspector-tab/mod.d.ts

@@ -0,0 +1,250 @@
+import { z } from 'zod';
+import { a0 as CustomInspectorTabEntrySchema, ae as HideInspectorTabEntrySchema, af as InspectorTabEntrySchema } from '../config-BxWAw3iH.js';
+export { s as ActorInspectorConfig, t as ActorInspectorConfigSchema, U as BUILTIN_INSPECTOR_TAB_IDS, X as BuiltinInspectorTabIdSchema } from '../config-BxWAw3iH.js';
+import 'zod/v4';
+import '../config-D49x8NpL.js';
+import '@rivetkit/rivetkit-wasm';
+import 'pino';
+import '@rivetkit/virtual-websocket';
+import '@standard-schema/spec';
+import 'hono';
+import '../utils.js';
+import '../utils-DQosb24I.js';
+import 'hono/utils/http-status';
+
+/**
+ * Type and schema declarations for custom Rivet inspector tabs.
+ *
+ * Everything here is **derived from runtime Zod schemas** that the
+ * dashboard and rivetkit itself use, so the published types cannot
+ * drift from the wire format. There are three sources of truth:
+ *
+ *   1. The `inspector.tabs[]` actor-config Zod schemas in
+ *      `../actor/config.ts` — re-exported below. These validate the
+ *      authoring surface (`defineActor({ inspector: { tabs: [...] } })`).
+ *   2. The dashboard ↔ tab postMessage envelopes defined in this file.
+ *      The inspector-ui SPA (`frontend/apps/inspector-ui/src/bridge.ts`)
+ *      imports the same schemas to validate messages at runtime, so any
+ *      change here lands on both ends in lockstep.
+ *   3. The inspector HTTP endpoint response schemas defined in this
+ *      file. The dashboard parses every response through them; if the
+ *      Rust handler ever emits a different shape, the dashboard fails
+ *      loudly at the parse step instead of silently casting `unknown`.
+ *
+ * Tab bundles import these types for autocomplete and compile-time
+ * safety:
+ *
+ * ```ts
+ * import type {
+ *   ShellToTabMessage,
+ *   TabToShellMessage,
+ *   V1Init,
+ *   InspectorStateResponse,
+ * } from "rivetkit/inspector-tab";
+ * ```
+ */
+
+/** One entry in the actor's `inspector.tabs[]` declaration. */
+type ActorInspectorTabEntry = z.input<typeof InspectorTabEntrySchema>;
+/** A custom-tab entry — adds a new tab to the dashboard strip. */
+type ActorCustomInspectorTabEntry = z.input<typeof CustomInspectorTabEntrySchema>;
+/** A hide modifier — removes a built-in tab from the strip. */
+type ActorHideInspectorTabEntry = z.input<typeof HideInspectorTabEntrySchema>;
+/** Union of the six built-in inspector tab ids. */
+type BuiltinInspectorTabId = "workflow" | "database" | "state" | "queue" | "connections" | "console";
+/** Public tab descriptor that crosses the dashboard ↔ inspector-ui bridge. */
+declare const InspectorTabDescriptorSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    icon: z.ZodString;
+    isCustom: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Initial handshake from the dashboard. Sent on first mount and again on
+ * every token refresh. Tabs MUST accept late `init` messages and replace
+ * the cached token.
+ */
+declare const V1InitSchema: z.ZodObject<{
+    type: z.ZodLiteral<"init">;
+    v: z.ZodLiteral<1>;
+    actorId: z.ZodString;
+    authToken: z.ZodString;
+    rivetToken: z.ZodOptional<z.ZodString>;
+    activeTab: z.ZodOptional<z.ZodString>;
+    theme: z.ZodOptional<z.ZodEnum<{
+        light: "light";
+        dark: "dark";
+    }>>;
+}, z.core.$strip>;
+/**
+ * Dashboard tells the inspector-ui SPA which built-in tab to render. Not
+ * sent to custom tabs — when the user activates a custom tab the
+ * dashboard navigates the outer iframe to a different `src`.
+ */
+declare const V1SetActiveTabSchema: z.ZodObject<{
+    type: z.ZodLiteral<"set-active-tab">;
+    v: z.ZodLiteral<1>;
+    tab: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Tab → dashboard. Sent once after the message listener is registered.
+ * The dashboard hides the "Connecting to inspector…" overlay on receipt;
+ * if it never arrives the overlay times out after 8 s.
+ */
+declare const V1ReadySchema: z.ZodObject<{
+    type: z.ZodLiteral<"ready">;
+    v: z.ZodLiteral<1>;
+}, z.core.$strip>;
+/**
+ * Tab → dashboard. Sent when the tab gets a 401 on an inspector data
+ * call. The dashboard refreshes the token and re-issues `v1Init`.
+ */
+declare const V1TokenRefreshNeededSchema: z.ZodObject<{
+    type: z.ZodLiteral<"token-refresh-needed">;
+    v: z.ZodLiteral<1>;
+}, z.core.$strip>;
+/**
+ * Emitted by the inspector-ui SPA to tell the dashboard which tabs to
+ * render in the strip. Custom tab bundles do NOT emit this — only the
+ * SPA does.
+ */
+declare const V1TabsAvailableSchema: z.ZodObject<{
+    type: z.ZodLiteral<"tabs-available">;
+    v: z.ZodLiteral<1>;
+    tabs: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        icon: z.ZodString;
+        isCustom: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** Discriminated union of messages a tab can RECEIVE from the dashboard. */
+declare const ShellToTabMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"init">;
+    v: z.ZodLiteral<1>;
+    actorId: z.ZodString;
+    authToken: z.ZodString;
+    rivetToken: z.ZodOptional<z.ZodString>;
+    activeTab: z.ZodOptional<z.ZodString>;
+    theme: z.ZodOptional<z.ZodEnum<{
+        light: "light";
+        dark: "dark";
+    }>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"set-active-tab">;
+    v: z.ZodLiteral<1>;
+    tab: z.ZodString;
+}, z.core.$strip>], "type">;
+/** Discriminated union of messages a tab can SEND to the dashboard. */
+declare const TabToShellMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"ready">;
+    v: z.ZodLiteral<1>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"tabs-available">;
+    v: z.ZodLiteral<1>;
+    tabs: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        icon: z.ZodString;
+        isCustom: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"token-refresh-needed">;
+    v: z.ZodLiteral<1>;
+}, z.core.$strip>], "type">;
+type InspectorTabDescriptor = z.infer<typeof InspectorTabDescriptorSchema>;
+type V1Init = z.infer<typeof V1InitSchema>;
+type V1SetActiveTab = z.infer<typeof V1SetActiveTabSchema>;
+type V1Ready = z.infer<typeof V1ReadySchema>;
+type V1TokenRefreshNeeded = z.infer<typeof V1TokenRefreshNeededSchema>;
+type V1TabsAvailable = z.infer<typeof V1TabsAvailableSchema>;
+type ShellToTabMessage = z.infer<typeof ShellToTabMessageSchema>;
+type TabToShellMessage = z.infer<typeof TabToShellMessageSchema>;
+/** Stable envelope protocol version. Bump only when introducing a v2 shape. */
+declare const POSTMESSAGE_PROTOCOL_VERSION = 1;
+/** URL query parameters the dashboard sets on the tab iframe `src`. */
+declare const SHELL_ORIGIN_PARAM = "shellOrigin";
+declare const ACTOR_ID_PARAM = "actorId";
+/** `GET /inspector/state` response shape. */
+declare const InspectorStateResponseSchema: z.ZodObject<{
+    state: z.ZodUnknown;
+    isStateEnabled: z.ZodBoolean;
+}, z.core.$strip>;
+/** `POST /inspector/action/<name>` request body. */
+declare const InspectorActionRequestSchema: z.ZodObject<{
+    args: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+/** `POST /inspector/action/<name>` response shape. */
+declare const InspectorActionResponseSchema: z.ZodObject<{
+    output: z.ZodUnknown;
+}, z.core.$strip>;
+/** `GET /inspector/rpcs` response shape — the list of action names. */
+declare const InspectorRpcsResponseSchema: z.ZodObject<{
+    rpcs: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+/** One connection record in `GET /inspector/connections`. */
+declare const InspectorConnectionSchema: z.ZodObject<{
+    connectionType: z.ZodNullable<z.ZodString>;
+    id: z.ZodString;
+    details: z.ZodObject<{
+        connectionType: z.ZodNullable<z.ZodString>;
+        params: z.ZodUnknown;
+        stateEnabled: z.ZodBoolean;
+        state: z.ZodUnknown;
+        subscriptions: z.ZodNumber;
+        isHibernatable: z.ZodBoolean;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/** `GET /inspector/connections` response shape. */
+declare const InspectorConnectionsResponseSchema: z.ZodObject<{
+    connections: z.ZodArray<z.ZodObject<{
+        connectionType: z.ZodNullable<z.ZodString>;
+        id: z.ZodString;
+        details: z.ZodObject<{
+            connectionType: z.ZodNullable<z.ZodString>;
+            params: z.ZodUnknown;
+            stateEnabled: z.ZodBoolean;
+            state: z.ZodUnknown;
+            subscriptions: z.ZodNumber;
+            isHibernatable: z.ZodBoolean;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** One queued message in `GET /inspector/queue`. */
+declare const InspectorQueueMessageSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    createdAtMs: z.ZodNumber;
+}, z.core.$strip>;
+/** `GET /inspector/queue` response shape. */
+declare const InspectorQueueResponseSchema: z.ZodObject<{
+    size: z.ZodNumber;
+    maxSize: z.ZodNumber;
+    truncated: z.ZodBoolean;
+    messages: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        createdAtMs: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** `GET /inspector/tab-config` response shape. */
+declare const InspectorTabConfigResponseSchema: z.ZodObject<{
+    tabs: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        icon: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        hidden: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type InspectorStateResponse = z.infer<typeof InspectorStateResponseSchema>;
+type InspectorActionRequest = z.infer<typeof InspectorActionRequestSchema>;
+type InspectorActionResponse = z.infer<typeof InspectorActionResponseSchema>;
+type InspectorRpcsResponse = z.infer<typeof InspectorRpcsResponseSchema>;
+type InspectorConnection = z.infer<typeof InspectorConnectionSchema>;
+type InspectorConnectionsResponse = z.infer<typeof InspectorConnectionsResponseSchema>;
+type InspectorQueueMessage = z.infer<typeof InspectorQueueMessageSchema>;
+type InspectorQueueResponse = z.infer<typeof InspectorQueueResponseSchema>;
+type InspectorTabConfigResponse = z.infer<typeof InspectorTabConfigResponseSchema>;
+
+export { ACTOR_ID_PARAM, type ActorCustomInspectorTabEntry, type ActorHideInspectorTabEntry, type ActorInspectorTabEntry, type BuiltinInspectorTabId, CustomInspectorTabEntrySchema, HideInspectorTabEntrySchema, type InspectorActionRequest, InspectorActionRequestSchema, type InspectorActionResponse, InspectorActionResponseSchema, type InspectorConnection, InspectorConnectionSchema, type InspectorConnectionsResponse, InspectorConnectionsResponseSchema, type InspectorQueueMessage, InspectorQueueMessageSchema, type InspectorQueueResponse, InspectorQueueResponseSchema, type InspectorRpcsResponse, InspectorRpcsResponseSchema, type InspectorStateResponse, InspectorStateResponseSchema, type InspectorTabConfigResponse, InspectorTabConfigResponseSchema, type InspectorTabDescriptor, InspectorTabDescriptorSchema, InspectorTabEntrySchema, POSTMESSAGE_PROTOCOL_VERSION, SHELL_ORIGIN_PARAM, type ShellToTabMessage, ShellToTabMessageSchema, type TabToShellMessage, TabToShellMessageSchema, type V1Init, V1InitSchema, type V1Ready, V1ReadySchema, type V1SetActiveTab, V1SetActiveTabSchema, type V1TabsAvailable, V1TabsAvailableSchema, type V1TokenRefreshNeeded, V1TokenRefreshNeededSchema };

package/dist/tsup/inspector-tab/mod.js

@@ -0,0 +1,173 @@
+import {
+  ActorInspectorConfigSchema,
+  BUILTIN_INSPECTOR_TAB_IDS,
+  BuiltinInspectorTabIdSchema,
+  CustomInspectorTabEntrySchema,
+  HideInspectorTabEntrySchema,
+  InspectorTabEntrySchema
+} from "../chunk-DPIMKYNB.js";
+
+// src/inspector-tab/mod.ts
+import { z } from "zod";
+var InspectorTabDescriptorSchema = z.object({
+  id: z.string(),
+  label: z.string(),
+  icon: z.string(),
+  /**
+   * `true` for author-shipped custom tabs; absent or `false` for
+   * built-in tabs the SPA renders. Lets the dashboard route the
+   * iframe `src` to `/inspector/custom-tabs/<id>/` for custom tabs and
+   * `/inspector/ui/` for built-ins without the dashboard needing to
+   * know which ids are built-in.
+   */
+  isCustom: z.boolean().optional()
+});
+var V1InitSchema = z.object({
+  type: z.literal("init"),
+  v: z.literal(1),
+  /** The actor this tab is mounted for. */
+  actorId: z.string(),
+  /**
+   * Per-actor inspector bearer token. Tabs include it as
+   * `Authorization: Bearer ${authToken}` on every authenticated fetch.
+   */
+  authToken: z.string(),
+  /**
+   * Outer Rivet API token. Optional; not required for inspector HTTP
+   * routes but available to tabs that want to call the engine REST API.
+   */
+  rivetToken: z.string().optional(),
+  /**
+   * The tab id the dashboard wants active at mount time. Multi-view
+   * tabs may read this to seed their initial route; most tabs ignore it.
+   */
+  activeTab: z.string().optional(),
+  /**
+   * Dashboard's currently active theme. Tabs that use the shared
+   * stylesheet (`/inspector/tab.css`) mirror it by toggling the `dark`
+   * class on `<html>`. Optional for backwards compatibility — tabs
+   * should default to `"dark"` if absent (the dashboard pinned dark
+   * mode before this field was added).
+   */
+  theme: z.enum(["light", "dark"]).optional()
+});
+var V1SetActiveTabSchema = z.object({
+  type: z.literal("set-active-tab"),
+  v: z.literal(1),
+  tab: z.string()
+});
+var V1ReadySchema = z.object({
+  type: z.literal("ready"),
+  v: z.literal(1)
+});
+var V1TokenRefreshNeededSchema = z.object({
+  type: z.literal("token-refresh-needed"),
+  v: z.literal(1)
+});
+var V1TabsAvailableSchema = z.object({
+  type: z.literal("tabs-available"),
+  v: z.literal(1),
+  tabs: z.array(InspectorTabDescriptorSchema)
+});
+var ShellToTabMessageSchema = z.discriminatedUnion("type", [
+  V1InitSchema,
+  V1SetActiveTabSchema
+]);
+var TabToShellMessageSchema = z.discriminatedUnion("type", [
+  V1ReadySchema,
+  V1TabsAvailableSchema,
+  V1TokenRefreshNeededSchema
+]);
+var POSTMESSAGE_PROTOCOL_VERSION = 1;
+var SHELL_ORIGIN_PARAM = "shellOrigin";
+var ACTOR_ID_PARAM = "actorId";
+var InspectorStateResponseSchema = z.object({
+  /** Current actor state (whatever shape the actor declared). */
+  state: z.unknown(),
+  /**
+   * `false` when the actor did not declare any state — `state` is then
+   * `null` and `PATCH /inspector/state` returns an error.
+   */
+  isStateEnabled: z.boolean()
+});
+var InspectorActionRequestSchema = z.object({
+  /** Positional arguments. Mutually exclusive with `properties`. */
+  args: z.array(z.unknown()).optional(),
+  /** Keyed arguments. Mutually exclusive with `args`. */
+  properties: z.record(z.string(), z.unknown()).optional()
+}).refine(
+  (body) => !(body.args !== void 0 && body.properties !== void 0),
+  "Use either `args` or `properties`, not both"
+);
+var InspectorActionResponseSchema = z.object({
+  output: z.unknown()
+});
+var InspectorRpcsResponseSchema = z.object({
+  rpcs: z.array(z.string())
+});
+var InspectorConnectionSchema = z.object({
+  connectionType: z.string().nullable(),
+  id: z.string(),
+  details: z.object({
+    connectionType: z.string().nullable(),
+    params: z.unknown(),
+    stateEnabled: z.boolean(),
+    state: z.unknown(),
+    subscriptions: z.number(),
+    isHibernatable: z.boolean()
+  })
+});
+var InspectorConnectionsResponseSchema = z.object({
+  connections: z.array(InspectorConnectionSchema)
+});
+var InspectorQueueMessageSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  createdAtMs: z.number()
+});
+var InspectorQueueResponseSchema = z.object({
+  size: z.number(),
+  maxSize: z.number(),
+  /** `true` if `?limit=N` truncated the message list below `size`. */
+  truncated: z.boolean(),
+  messages: z.array(InspectorQueueMessageSchema)
+});
+var InspectorTabConfigResponseSchema = z.object({
+  tabs: z.array(
+    z.object({
+      id: z.string(),
+      label: z.string().optional(),
+      icon: z.string().nullable().optional(),
+      hidden: z.boolean().optional()
+    })
+  )
+});
+export {
+  ACTOR_ID_PARAM,
+  ActorInspectorConfigSchema,
+  BUILTIN_INSPECTOR_TAB_IDS,
+  BuiltinInspectorTabIdSchema,
+  CustomInspectorTabEntrySchema,
+  HideInspectorTabEntrySchema,
+  InspectorActionRequestSchema,
+  InspectorActionResponseSchema,
+  InspectorConnectionSchema,
+  InspectorConnectionsResponseSchema,
+  InspectorQueueMessageSchema,
+  InspectorQueueResponseSchema,
+  InspectorRpcsResponseSchema,
+  InspectorStateResponseSchema,
+  InspectorTabConfigResponseSchema,
+  InspectorTabDescriptorSchema,
+  InspectorTabEntrySchema,
+  POSTMESSAGE_PROTOCOL_VERSION,
+  SHELL_ORIGIN_PARAM,
+  ShellToTabMessageSchema,
+  TabToShellMessageSchema,
+  V1InitSchema,
+  V1ReadySchema,
+  V1SetActiveTabSchema,
+  V1TabsAvailableSchema,
+  V1TokenRefreshNeededSchema
+};
+//# sourceMappingURL=mod.js.map