lumiverse-spindle-types 0.4.55 → 0.4.56

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lumiverse-spindle-types",
-  "version": "0.4.55",
+  "version": "0.4.56",
   "types": "./src/index.ts",
   "keywords": [
     "lumiverse",

package/src/api.ts

@@ -1593,6 +1593,14 @@ export interface TokenCountResultDTO {
   approximate: boolean;
 }
 
+/** Context delivered to an on-request shared RPC endpoint handler. */
+export interface SharedRpcRequestContextDTO {
+  /** Fully-qualified endpoint name (for example `weather_ext.status.current`). */
+  endpoint: string;
+  /** Identifier of the extension requesting the value. */
+  requesterExtensionId: string;
+}
+
 // ─── Worker → Host messages ──────────────────────────────────────────────
 
 export type WorkerToHost =
@@ -1675,6 +1683,16 @@ export type WorkerToHost =
       reservationId: string;
     }
   | { type: "permissions_get_granted"; requestId: string }
+  | { type: "rpc_pool_sync"; endpoint: string; value: unknown }
+  | { type: "rpc_pool_register_handler"; endpoint: string }
+  | { type: "rpc_pool_unregister"; endpoint: string }
+  | { type: "rpc_pool_read"; requestId: string; endpoint: string }
+  | {
+      type: "rpc_pool_handler_result";
+      requestId: string;
+      result?: unknown;
+      error?: string;
+    }
   | { type: "connections_list"; requestId: string; userId?: string }
   | { type: "connections_get"; requestId: string; connectionId: string; userId?: string }
   | { type: "chat_get_messages"; requestId: string; chatId: string }
@@ -2010,6 +2028,12 @@ export type WorkerToHost =
 export type HostToWorker =
   | { type: "init"; manifest: SpindleManifest; storagePath: string }
   | { type: "event"; event: string; payload: unknown; userId?: string }
+  | {
+      type: "rpc_pool_request";
+      requestId: string;
+      endpoint: string;
+      requesterExtensionId: string;
+    }
   | {
       type: "intercept_request";
       requestId: string;

package/src/index.ts

@@ -111,6 +111,7 @@ export type {
   TokenModelSourceDTO,
   TokenCountOptionsDTO,
   TokenCountResultDTO,
+  SharedRpcRequestContextDTO,
   MacroInterceptorPhase,
   MacroInterceptorEnvDTO,
   MacroInterceptorCtxDTO,

package/src/spindle-api.ts

@@ -83,6 +83,7 @@ import type {
   MacroInterceptorResultDTO,
   MessageContentProcessorCtxDTO,
   MessageContentProcessorResultDTO,
+  SharedRpcRequestContextDTO,
 } from "./api";
 
 export interface FrontendProcessHandle {
@@ -816,6 +817,37 @@ export interface SpindleAPI {
     onChanged(handler: (detail: PermissionChangedDetail) => void): () => void;
   };
 
+  /**
+   * Shared RPC pool (free tier).
+   *
+   * Use this to expose lightweight cross-extension state behind a stable
+   * `<extension_id>.<channel>` endpoint. Owner methods accept either the bare
+   * channel suffix (`status.current`) or the fully-qualified endpoint.
+   */
+  rpcPool: {
+    /**
+     * Publish the latest value for an endpoint. Replaces any previous on-demand
+     * handler for the same endpoint.
+     *
+     * Returns the fully-qualified endpoint name.
+     */
+    sync(endpoint: string, value: unknown): string;
+    /**
+     * Register an on-demand endpoint handler. Replaces any previously synced
+     * value or handler for the same endpoint.
+     *
+     * Returns the fully-qualified endpoint name.
+     */
+    handle(
+      endpoint: string,
+      handler: (ctx: SharedRpcRequestContextDTO) => unknown | Promise<unknown>
+    ): string;
+    /** Read the latest value from another extension's fully-qualified endpoint. */
+    read<T = unknown>(endpoint: string): Promise<T>;
+    /** Remove an endpoint owned by this extension. */
+    unregister(endpoint: string): void;
+  };
+
   /** Make a CORS-proxied HTTP request */
   cors(url: string, options?: RequestInitDTO): Promise<unknown>;