@qping/plugin-bus 0.4.0 → 0.7.0

package/dist/actions.d.ts

@@ -151,6 +151,8 @@ export type DetailRequest = {
     page?: string;
     title?: string;
     initialState?: unknown;
+    /** Restricts the action bar for this detail page. Omit to expose every registered action. */
+    actions?: string[];
 };
 export type ActionTarget = 
 /** Run one privileged host-side action (clipboard, process launch, browser, ...). */
@@ -210,6 +212,8 @@ export type ActionDefinition<TItem = any> = {
     title: LocalizedText;
     description?: LocalizedText;
     hotkey?: Hotkey;
+    /** Keep this action visible in the host action bar instead of the overflow menu. */
+    pinned?: boolean;
     execute: (context: ActionContext<TItem>) => ActionOutcome | void | Promise<ActionOutcome | void>;
 };
 /** The registry shape sent to the host in the initialize response (no `execute`). */
@@ -218,6 +222,7 @@ export type ActionManifestEntry = {
     title: LocalizedText;
     description?: LocalizedText;
     hotkey?: Hotkey;
+    pinned?: boolean;
 };
 export declare function toActionManifest(definition: ActionDefinition): ActionManifestEntry;
 export {};

package/dist/bootstrap.d.ts

@@ -26,11 +26,10 @@ export interface PluginRuntime {
 export declare function runPlugin(handlers: PluginHandlers): Promise<PluginRuntime>;
 /**
  * Sends bus.handshake with the bootstrap token and waits for the host response that binds
- * plugin/entry/session/endpoint identity. Rejects on HandshakeFailed / ProtocolMismatch / timeout.
+ * plugin/session/endpoint identity. Rejects on HandshakeFailed / ProtocolMismatch / timeout.
  */
 export declare function completeHandshake(transport: NodeTransport, token: string, timeoutMs?: number): Promise<{
     pluginId: string;
-    entryId: string;
     sessionId: string;
     endpointId: string;
 }>;

package/dist/bootstrap.mjs

@@ -295,7 +295,6 @@ var HandlerRouter = class {
   handlers = /* @__PURE__ */ new Map();
   pendingHostCalls = /* @__PURE__ */ new Map();
   pluginId = "p";
-  entryId = "e";
   sessionId = "s";
   endpointId = EndpointIds.NodeMain;
   /** Injected transport send fn; tests can override `router.send` directly. */
@@ -306,7 +305,6 @@ var HandlerRouter = class {
   /** Sets the bound identity stamped on outbound messages (after handshake). */
   setIdentity(ids) {
     this.pluginId = ids.pluginId;
-    this.entryId = ids.entryId;
     this.sessionId = ids.sessionId;
     this.endpointId = ids.endpointId;
   }
@@ -355,7 +353,6 @@ var HandlerRouter = class {
         traceId: id,
         sessionId: this.sessionId,
         pluginId: this.pluginId,
-        entryId: this.entryId,
         endpointId: this.endpointId,
         kind: MessageKind.Request,
         route,
@@ -402,7 +399,6 @@ var HandlerRouter = class {
       traceId: req.traceId,
       sessionId: req.sessionId,
       pluginId: req.pluginId,
-      entryId: req.entryId,
       endpointId: this.endpointId,
       kind: MessageKind.Response,
       route: req.route,
@@ -483,7 +479,6 @@ async function completeHandshake(transport, token, timeoutMs = 1e4) {
     traceId: id,
     sessionId: "",
     pluginId: "",
-    entryId: "",
     endpointId: EndpointIds.NodeMain,
     kind: MessageKind.Request,
     route: Routes.Bus.Handshake,
@@ -509,14 +504,13 @@ async function completeHandshake(transport, token, timeoutMs = 1e4) {
       }
       const p = env.payload ?? {};
       const pluginId = String(p.pluginId ?? "");
-      const entryId = String(p.entryId ?? "");
       const sessionId = String(p.sessionId ?? "");
       const endpointId = String(p.endpointId ?? EndpointIds.NodeMain);
-      if (!pluginId || !entryId || !sessionId) {
+      if (!pluginId || !sessionId) {
         reject(new Error("bus.handshake success response missing bound identity"));
         return;
       }
-      resolve({ pluginId, entryId, sessionId, endpointId });
+      resolve({ pluginId, sessionId, endpointId });
     });
     transport.send(req);
   });

package/dist/i18n.mjs

@@ -1,4 +1,4 @@
-// ../node_modules/i18next/dist/esm/i18next.js
+// node_modules/i18next/dist/esm/i18next.js
 var isString = (obj) => typeof obj === "string";
 var defer = () => {
   let res;

package/dist/node.mjs

@@ -304,7 +304,6 @@ var HandlerRouter = class {
   handlers = /* @__PURE__ */ new Map();
   pendingHostCalls = /* @__PURE__ */ new Map();
   pluginId = "p";
-  entryId = "e";
   sessionId = "s";
   endpointId = EndpointIds.NodeMain;
   /** Injected transport send fn; tests can override `router.send` directly. */
@@ -315,7 +314,6 @@ var HandlerRouter = class {
   /** Sets the bound identity stamped on outbound messages (after handshake). */
   setIdentity(ids) {
     this.pluginId = ids.pluginId;
-    this.entryId = ids.entryId;
     this.sessionId = ids.sessionId;
     this.endpointId = ids.endpointId;
   }
@@ -364,7 +362,6 @@ var HandlerRouter = class {
         traceId: id,
         sessionId: this.sessionId,
         pluginId: this.pluginId,
-        entryId: this.entryId,
         endpointId: this.endpointId,
         kind: MessageKind.Request,
         route,
@@ -411,7 +408,6 @@ var HandlerRouter = class {
       traceId: req.traceId,
       sessionId: req.sessionId,
       pluginId: req.pluginId,
-      entryId: req.entryId,
       endpointId: this.endpointId,
       kind: MessageKind.Response,
       route: req.route,
@@ -492,7 +488,6 @@ async function completeHandshake(transport, token, timeoutMs = 1e4) {
     traceId: id,
     sessionId: "",
     pluginId: "",
-    entryId: "",
     endpointId: EndpointIds.NodeMain,
     kind: MessageKind.Request,
     route: Routes.Bus.Handshake,
@@ -518,14 +513,13 @@ async function completeHandshake(transport, token, timeoutMs = 1e4) {
       }
       const p = env.payload ?? {};
       const pluginId = String(p.pluginId ?? "");
-      const entryId = String(p.entryId ?? "");
       const sessionId = String(p.sessionId ?? "");
       const endpointId = String(p.endpointId ?? EndpointIds.NodeMain);
-      if (!pluginId || !entryId || !sessionId) {
+      if (!pluginId || !sessionId) {
         reject(new Error("bus.handshake success response missing bound identity"));
         return;
       }
-      resolve({ pluginId, entryId, sessionId, endpointId });
+      resolve({ pluginId, sessionId, endpointId });
     });
     transport.send(req);
   });
@@ -632,6 +626,7 @@ function toActionManifest(definition) {
   };
   if (definition.description) entry.description = definition.description;
   if (definition.hotkey) entry.hotkey = definition.hotkey;
+  if (definition.pinned) entry.pinned = true;
   return entry;
 }
 
@@ -696,7 +691,6 @@ var Plugin = class {
       traceId: crypto.randomUUID().replace(/-/g, "").slice(0, 32),
       sessionId: "",
       pluginId: "",
-      entryId: "",
       endpointId: EndpointIds.NodeMain,
       kind: MessageKind.Event,
       route,

package/dist/protocol.d.ts

@@ -88,7 +88,6 @@ export interface Envelope {
     traceId: string;
     sessionId: string;
     pluginId: string;
-    entryId: string;
     endpointId: string;
     kind: MessageKind;
     route: string;

package/dist/router.d.ts

@@ -16,7 +16,6 @@ export declare class HandlerRouter {
     private handlers;
     private pendingHostCalls;
     private pluginId;
-    private entryId;
     private sessionId;
     private endpointId;
     /** Injected transport send fn; tests can override `router.send` directly. */
@@ -27,7 +26,6 @@ export declare class HandlerRouter {
     /** Sets the bound identity stamped on outbound messages (after handshake). */
     setIdentity(ids: {
         pluginId: string;
-        entryId: string;
         sessionId: string;
         endpointId: string;
     }): void;

package/dist/webClient.mjs

@@ -1,4 +1,4 @@
-// ../node_modules/i18next/dist/esm/i18next.js
+// node_modules/i18next/dist/esm/i18next.js
 var isString = (obj) => typeof obj === "string";
 var defer = () => {
   let res;
@@ -2545,7 +2545,6 @@ function createWebBusClient(options) {
           traceId: id,
           sessionId: "",
           pluginId: "",
-          entryId: "",
           endpointId: "",
           kind: MessageKind.Request,
           route,
@@ -2607,7 +2606,6 @@ function handshake(timeoutMs) {
       traceId: id,
       sessionId: "",
       pluginId: "",
-      entryId: "",
       endpointId: "web",
       kind: MessageKind.Request,
       route: Routes.Bus.Handshake,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qping/plugin-bus",
-  "version": "0.4.0",
+  "version": "0.7.0",
   "description": "v3 message-bus runtime for MyTools plugins (named-pipe transport).",
   "type": "module",
   "files": [

package/src/actions.ts

@@ -89,37 +89,39 @@ export type HostActionRequest =
   | { kind: typeof HostAction.Run; command: RunSpec }
   | { kind: typeof HostAction.Kill; pid: number };
 
-/** Opens a web detail page. `page` defaults to the entry declared in plugin.json. */
-export type DetailRequest = {
-  page?: string;
-  title?: string;
-  initialState?: unknown;
-};
-
-export type ActionTarget =
-  /** Run one privileged host-side action (clipboard, process launch, browser, ...). */
-  | { kind: "host"; action: HostActionRequest }
-  /** Hand off to the currently active detail page as host.event.detailAction. */
-  | { kind: "web"; payload?: unknown }
-  /** Open a new web detail page. */
-  | ({ kind: "detail" } & DetailRequest);
-
-export type ActionAfter = "keep" | "close" | "refresh";
-
-type ActionOutcomeBase = {
-  /** Status bar text. */
-  message?: LocalizedText;
-};
-
-/**
- * The result of running an action. An action selects at most one execution target. Host targets
- * may choose a follow-up lifecycle action; web and detail targets keep their current surface alive.
- */
-export type ActionOutcome = ActionOutcomeBase & (
-  | { target?: undefined; after?: ActionAfter }
-  | { target: Extract<ActionTarget, { kind: "host" }>; after?: ActionAfter }
-  | { target: Exclude<ActionTarget, { kind: "host" }>; after?: "keep" }
-);
+/** Opens a web detail page. `page` defaults to the entry declared in plugin.json. */
+export type DetailRequest = {
+  page?: string;
+  title?: string;
+  initialState?: unknown;
+  /** Restricts the action bar for this detail page. Omit to expose every registered action. */
+  actions?: string[];
+};
+
+export type ActionTarget =
+  /** Run one privileged host-side action (clipboard, process launch, browser, ...). */
+  | { kind: "host"; action: HostActionRequest }
+  /** Hand off to the currently active detail page as host.event.detailAction. */
+  | { kind: "web"; payload?: unknown }
+  /** Open a new web detail page. */
+  | ({ kind: "detail" } & DetailRequest);
+
+export type ActionAfter = "keep" | "close" | "refresh";
+
+type ActionOutcomeBase = {
+  /** Status bar text. */
+  message?: LocalizedText;
+};
+
+/**
+ * The result of running an action. An action selects at most one execution target. Host targets
+ * may choose a follow-up lifecycle action; web and detail targets keep their current surface alive.
+ */
+export type ActionOutcome = ActionOutcomeBase & (
+  | { target?: undefined; after?: ActionAfter }
+  | { target: Extract<ActionTarget, { kind: "host" }>; after?: ActionAfter }
+  | { target: Exclude<ActionTarget, { kind: "host" }>; after?: "keep" }
+);
 
 /**
  * What an action sees when it runs. `item` is the original object returned by `search()`,
@@ -142,6 +144,8 @@ export type ActionDefinition<TItem = any> = {
   title: LocalizedText;
   description?: LocalizedText;
   hotkey?: Hotkey;
+  /** Keep this action visible in the host action bar instead of the overflow menu. */
+  pinned?: boolean;
   execute: (context: ActionContext<TItem>) => ActionOutcome | void | Promise<ActionOutcome | void>;
 };
 
@@ -151,6 +155,7 @@ export type ActionManifestEntry = {
   title: LocalizedText;
   description?: LocalizedText;
   hotkey?: Hotkey;
+  pinned?: boolean;
 };
 
 export function toActionManifest(definition: ActionDefinition): ActionManifestEntry {
@@ -160,5 +165,6 @@ export function toActionManifest(definition: ActionDefinition): ActionManifestEn
   };
   if (definition.description) entry.description = definition.description;
   if (definition.hotkey) entry.hotkey = definition.hotkey;
+  if (definition.pinned) entry.pinned = true;
   return entry;
 }

package/src/bootstrap.ts

@@ -102,13 +102,13 @@ async function readBootstrapLine(): Promise<{ pipePath: string; token: string }>
 
 /**
  * Sends bus.handshake with the bootstrap token and waits for the host response that binds
- * plugin/entry/session/endpoint identity. Rejects on HandshakeFailed / ProtocolMismatch / timeout.
+ * plugin/session/endpoint identity. Rejects on HandshakeFailed / ProtocolMismatch / timeout.
  */
 export async function completeHandshake(
   transport: NodeTransport,
   token: string,
   timeoutMs = 10000,
-): Promise<{ pluginId: string; entryId: string; sessionId: string; endpointId: string }> {
+): Promise<{ pluginId: string; sessionId: string; endpointId: string }> {
   const id = randomBytes(16).toString("hex");
   const req: Envelope = {
     version: ProtocolVersion,
@@ -116,7 +116,6 @@ export async function completeHandshake(
     traceId: id,
     sessionId: "",
     pluginId: "",
-    entryId: "",
     endpointId: EndpointIds.NodeMain,
     kind: MessageKind.Request,
     route: Routes.Bus.Handshake,
@@ -144,14 +143,13 @@ export async function completeHandshake(
       }
       const p = (env.payload ?? {}) as Record<string, unknown>;
       const pluginId = String(p.pluginId ?? "");
-      const entryId = String(p.entryId ?? "");
       const sessionId = String(p.sessionId ?? "");
       const endpointId = String(p.endpointId ?? EndpointIds.NodeMain);
-      if (!pluginId || !entryId || !sessionId) {
+      if (!pluginId || !sessionId) {
         reject(new Error("bus.handshake success response missing bound identity"));
         return;
       }
-      resolve({ pluginId, entryId, sessionId, endpointId });
+      resolve({ pluginId, sessionId, endpointId });
     });
 
     transport.send(req);

package/src/node.ts

@@ -153,7 +153,6 @@ export class Plugin {
       traceId: crypto.randomUUID().replace(/-/g, "").slice(0, 32),
       sessionId: "",
       pluginId: "",
-      entryId: "",
       endpointId: EndpointIds.NodeMain,
       kind: MessageKind.Event,
       route,

package/src/protocol.ts

@@ -110,7 +110,6 @@ export interface Envelope {
   traceId: string;
   sessionId: string;
   pluginId: string;
-  entryId: string;
   endpointId: string;
   kind: MessageKind;
   route: string;

package/src/router.ts

@@ -62,7 +62,6 @@ export class HandlerRouter {
   private handlers = new Map<string, Handler>();
   private pendingHostCalls = new Map<string, PendingHostCall>();
   private pluginId = "p";
-  private entryId = "e";
   private sessionId = "s";
   private endpointId: string = EndpointIds.NodeMain;
 
@@ -74,9 +73,8 @@ export class HandlerRouter {
   }
 
   /** Sets the bound identity stamped on outbound messages (after handshake). */
-  setIdentity(ids: { pluginId: string; entryId: string; sessionId: string; endpointId: string }): void {
+  setIdentity(ids: { pluginId: string; sessionId: string; endpointId: string }): void {
     this.pluginId = ids.pluginId;
-    this.entryId = ids.entryId;
     this.sessionId = ids.sessionId;
     this.endpointId = ids.endpointId;
   }
@@ -133,7 +131,6 @@ export class HandlerRouter {
         traceId: id,
         sessionId: this.sessionId,
         pluginId: this.pluginId,
-        entryId: this.entryId,
         endpointId: this.endpointId,
         kind: MessageKind.Request,
         route,
@@ -176,7 +173,6 @@ export class HandlerRouter {
       traceId: req.traceId,
       sessionId: req.sessionId,
       pluginId: req.pluginId,
-      entryId: req.entryId,
       endpointId: this.endpointId,
       kind: MessageKind.Response,
       route: req.route,

package/src/webClient.ts

@@ -208,7 +208,6 @@ export function createWebBusClient(options?: {
             traceId: id,
             sessionId: "",
             pluginId: "",
-            entryId: "",
             endpointId: "",
             kind: MessageKind.Request,
             route,
@@ -277,7 +276,6 @@ function handshake(timeoutMs: number): Promise<string> {
       traceId: id,
       sessionId: "",
       pluginId: "",
-      entryId: "",
       endpointId: "web",
       kind: MessageKind.Request,
       route: Routes.Bus.Handshake,