@openvcs/sdk 0.2.13 → 0.2.15

package/lib/runtime/menu.d.ts

@@ -6,7 +6,7 @@ type MenubarMenuOptions = {
     after?: string;
 };
 /** Runs a registered action handler by id. */
-export declare function runRegisteredAction(actionId: string, ...args: unknown[]): Promise<boolean>;
+export declare function runRegisteredAction(actionId: string, ...args: unknown[]): Promise<unknown>;
 export interface MenuHandle {
     id: string;
     addItem(item: MenubarItem): void;

package/lib/runtime/menu.js

@@ -159,12 +159,11 @@ function serializeMenus() {
 async function runRegisteredAction(actionId, ...args) {
     const id = String(actionId || '').trim();
     if (!id)
-        return false;
+        return null;
     const handler = actionHandlers.get(id);
     if (!handler)
-        return false;
-    await handler(...args);
-    return true;
+        return null;
+    return await handler(...args);
 }
 /** Creates a stable handle for one stored menu. */
 function createMenuHandle(menuId) {
@@ -289,9 +288,9 @@ function createMenuPluginDelegates() {
             return serializeMenus();
         },
         async 'plugin.handle_action'(params) {
-            const actionId = String(params?.action_id || '').trim();
+            const actionId = String(params?.action_id || params?.id || '').trim();
             if (actionId) {
-                await runRegisteredAction(actionId, params?.payload);
+                return await runRegisteredAction(actionId, params?.payload);
             }
             return null;
         },

package/lib/runtime/modal.d.ts

@@ -69,6 +69,6 @@ export declare class ModalBuilder {
     list(id: string, options: ModalBuilderListOptions): this;
     /** Returns the serialized modal payload. */
     build(): PluginModalDefinition;
-    /** Requests the host to open the modal with the current definition. */
-    open(): Promise<void>;
+    /** Returns the serialized modal payload for a host request. */
+    open(): Promise<PluginModalDefinition>;
 }

package/lib/runtime/modal.js

@@ -3,7 +3,6 @@
 // SPDX-License-Identifier: GPL-3.0-or-later
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ModalBuilder = void 0;
-const menu_js_1 = require("./menu.js");
 /** Builds a structured modal definition with a fluent class API. */
 class ModalBuilder {
     definition;
@@ -87,9 +86,9 @@ class ModalBuilder {
             content: this.definition.content.map((item) => ({ ...item })),
         };
     }
-    /** Requests the host to open the modal with the current definition. */
+    /** Returns the serialized modal payload for a host request. */
     async open() {
-        await (0, menu_js_1.invoke)('open_plugin_modal', { modal: this.build() });
+        return this.build();
     }
 }
 exports.ModalBuilder = ModalBuilder;

package/lib/runtime/registration.js

@@ -27,8 +27,11 @@ function createRegisteredPluginRuntime(definition = {}) {
             },
             'plugin.handle_action': async (params, ctx) => {
                 const actionId = String(params?.action_id || '').trim();
-                if (actionId && (await (0, menu_1.runRegisteredAction)(actionId))) {
-                    return null;
+                if (actionId) {
+                    const result = await (0, menu_1.runRegisteredAction)(actionId, params?.payload);
+                    if (result !== null && result !== undefined) {
+                        return result;
+                    }
                 }
                 if (explicitHandleAction) {
                     return explicitHandleAction(params, ctx);

package/lib/types/plugin.d.ts

@@ -21,6 +21,8 @@ export type PluginMenuDefinition = Record<string, unknown>;
 export type PluginSettingsValue = Record<string, unknown>;
 /** Describes the params shape for plugin action handling. */
 export interface PluginHandleActionParams extends RequestParams {
+    /** Stores the action id selected by the user when provided by the transport. */
+    id?: string;
     /** Stores the action id selected by the user. */
     action_id?: string;
     /** Stores an optional payload supplied by the triggering UI. */
@@ -44,7 +46,7 @@ export interface PluginDelegates<TContext = unknown> {
     /** Returns plugin-contributed menus. */
     'plugin.get_menus'?: RpcMethodHandler<RequestParams, PluginMenuDefinition[], TContext>;
     /** Handles a contributed plugin action. */
-    'plugin.handle_action'?: RpcMethodHandler<PluginHandleActionParams, null, TContext>;
+    'plugin.handle_action'?: RpcMethodHandler<PluginHandleActionParams, unknown, TContext>;
     /** Returns the default settings values for the plugin. */
     'plugin.settings.defaults'?: RpcMethodHandler<RequestParams, PluginSettingsValue[], TContext>;
     /** Transforms settings values when they are loaded. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openvcs/sdk",
-  "version": "0.2.13",
+  "version": "0.2.15",
   "description": "OpenVCS SDK CLI for plugin scaffolding and .ovcsp tar.gz packaging",
   "license": "GPL-3.0-or-later",
   "homepage": "https://openvcs.app/",

package/src/lib/runtime/dispatcher.ts

@@ -48,7 +48,7 @@ export function createDefaultPluginDelegates<
     async 'plugin.get_menus'(): Promise<[]> {
       return [];
     },
-    async 'plugin.handle_action'(): Promise<null> {
+    async 'plugin.handle_action'(): Promise<unknown> {
       return null;
     },
     async 'plugin.settings.defaults'(): Promise<[]> {

package/src/lib/runtime/menu.ts

@@ -216,15 +216,14 @@ function serializeMenus(): SerializedMenuDefinition[] {
 }
 
 /** Runs a registered action handler by id. */
-export async function runRegisteredAction(actionId: string, ...args: unknown[]): Promise<boolean> {
+export async function runRegisteredAction(actionId: string, ...args: unknown[]): Promise<unknown> {
   const id = String(actionId || '').trim();
-  if (!id) return false;
+  if (!id) return null;
 
   const handler = actionHandlers.get(id);
-  if (!handler) return false;
+  if (!handler) return null;
 
-  await handler(...args);
-  return true;
+  return await handler(...args);
 }
 
 export interface MenuHandle {
@@ -362,10 +361,10 @@ export function createMenuPluginDelegates(): PluginDelegates<PluginRuntimeContex
     async 'plugin.get_menus'(): Promise<PluginMenuDefinition[]> {
       return serializeMenus() as unknown as PluginMenuDefinition[];
     },
-    async 'plugin.handle_action'(params: PluginHandleActionParams): Promise<null> {
-      const actionId = String(params?.action_id || '').trim();
+    async 'plugin.handle_action'(params: PluginHandleActionParams): Promise<unknown> {
+      const actionId = String(params?.action_id || params?.id || '').trim();
       if (actionId) {
-        await runRegisteredAction(actionId, params?.payload);
+        return await runRegisteredAction(actionId, params?.payload);
       }
       return null;
     },

package/src/lib/runtime/modal.ts

@@ -15,8 +15,6 @@ import type {
   PluginModalDefinition,
 } from '../types/modal.js';
 
-import { invoke } from './menu.js';
-
 /** Describes the options accepted by `ModalBuilder.button()`. */
 export interface ModalBuilderButtonOptions {
   /** Stores the optional tooltip text. */
@@ -165,8 +163,8 @@ export class ModalBuilder {
     };
   }
 
-  /** Requests the host to open the modal with the current definition. */
-  async open(): Promise<void> {
-    await invoke('open_plugin_modal', { modal: this.build() });
+  /** Returns the serialized modal payload for a host request. */
+  async open(): Promise<PluginModalDefinition> {
+    return this.build();
   }
 }

package/src/lib/runtime/registration.ts

@@ -80,8 +80,11 @@ export function createRegisteredPluginRuntime(
       },
       'plugin.handle_action': async (params, ctx) => {
         const actionId = String(params?.action_id || '').trim();
-        if (actionId && (await runRegisteredAction(actionId))) {
-          return null;
+        if (actionId) {
+          const result = await runRegisteredAction(actionId, params?.payload);
+          if (result !== null && result !== undefined) {
+            return result;
+          }
         }
         if (explicitHandleAction) {
           return explicitHandleAction(params, ctx);

package/src/lib/types/plugin.ts

@@ -30,6 +30,8 @@ export type PluginSettingsValue = Record<string, unknown>;
 
 /** Describes the params shape for plugin action handling. */
 export interface PluginHandleActionParams extends RequestParams {
+  /** Stores the action id selected by the user when provided by the transport. */
+  id?: string;
   /** Stores the action id selected by the user. */
   action_id?: string;
   /** Stores an optional payload supplied by the triggering UI. */
@@ -76,7 +78,7 @@ export interface PluginDelegates<TContext = unknown> {
   /** Handles a contributed plugin action. */
   'plugin.handle_action'?: RpcMethodHandler<
     PluginHandleActionParams,
-    null,
+    unknown,
     TContext
   >;
   /** Returns the default settings values for the plugin. */