@rainbow-robotics/plugin-ui 1.3.3 → 1.3.5

package/dist/manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"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"}

package/dist/manifest.js

@@ -13,6 +13,8 @@ function validateManifest(value) {
   const m = value;
   if (typeof m.id !== "string" || m.id.length === 0)
     errors.push("manifest.id is required (string)");
+  else if (!/^[a-z][a-z0-9]*(-[a-z0-9]+)*(\.[a-z][a-z0-9]*(-[a-z0-9]+)*)*$/.test(m.id))
+    errors.push('manifest.id must be "."-separated parts of lowercase letters/digits and single "-", each starting with a letter (e.g. com.example.my-plugin)');
   if (typeof m.name !== "string" || m.name.length === 0)
     errors.push("manifest.name is required (string)");
   if (typeof m.version !== "string" || m.version.length === 0)

package/dist/manifest.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/manifest.ts"],
-  "sourcesContent": ["/* eslint-disable @typescript-eslint/no-explicit-any */\n/**\n * Plugin manifest schema \u2014 the single source of truth shared by the front end\n * (nexus reads it) and the back end (rby2 mirrors it for validation).\n *\n * Evolve additively only.\n */\n\n/** Known contribution points the host understands. */\nexport const CONTRIBUTION_POINTS = [\n  \"toolbar\",\n  \"lnb\",\n  \"move.panel\",\n  \"program.panel\",\n] as const;\n\nexport type ContributionPoint = (typeof CONTRIBUTION_POINTS)[number];\n\n/** How a header.toolbar contribution opens when clicked. */\nexport type ContributionOpens = \"popover\" | \"panel\" | \"page\";\n\nexport interface PluginContribution {\n  /** Where this contribution mounts. */\n  point: ContributionPoint | (string & {});\n  /** UI entry name relative to ui/ (without extension). Defaults to \"content\". */\n  ui?: string;\n  /** Icon path relative to the plugin root (e.g. \"assets/icon.svg\"). */\n  icon?:\n    | string\n    | {\n        \"16\"?: string;\n        \"48\"?: string;\n        \"126\"?: string;\n      };\n  /** Display label. */\n  label?: string | Record<string, string>;\n  /** For header.toolbar: how the contribution surfaces. */\n  opens?: ContributionOpens;\n  commandInfo?: {\n    name: string;\n    icon: string;\n    funcName: string;\n    args?: Record<string, any>;\n  };\n}\n\nexport interface PluginAction {\n  /** Action id referenced by `rb.action(id, payload)`. */\n  id: string;\n  /** Transport topic (Zenoh / ROS2) the back end routes to. */\n  topic: string;\n  /** Optional payload schema hint (field \u2192 type name). */\n  schema?: Record<string, string>;\n}\n\n/** Allowed variable value types exposed to pyfm. */\nexport const VARIABLE_TYPES = [\"number\", \"string\", \"boolean\", \"array\"] as const;\n\nexport type PluginVariableType = (typeof VARIABLE_TYPES)[number];\n\n/** A variable the plugin pre-declares for use in pyfm programs. */\nexport interface PluginVariable {\n  /** Identifier, must start with \"RBP_\" (then letters, digits, underscore). Unique per plugin. */\n  name: `RBP_${string}`;\n  type: PluginVariableType;\n  /** Initial value \u2014 must match `type`. */\n  init: number | string | boolean | any[];\n  /** Optional. Without it the UI cannot explain what the variable is for. */\n  description?: string | Record<string, string>;\n}\n\nexport type PluginRuntime =\n  | { type: \"none\" }\n  | { type: \"python\"; entry: string }\n  | {\n      type: \"ros2\";\n      package: string;\n      launch: string;\n      rosClient: \"rclpy\" | \"rclcpp\";\n    };\n\nexport interface PluginManifest {\n  /** Reverse-DNS unique id, e.g. \"com.rainbow.gripper-tool\". */\n  id: string;\n  /** Human-readable name. */\n  name: string;\n  /** Plugin version (semver). */\n  version: string;\n  /** Minimum host (Muscat) version this plugin supports. */\n  minAppVersion?: string;\n  /** Icon path relative to plugin root. */\n  icons:\n    | string\n    | {\n        \"16\"?: string;\n        \"48\"?: string;\n        \"128\"?: string;\n      };\n  /** UI / chrome contributions. */\n  contributes?: PluginContribution[];\n  /** Host actions the plugin can invoke. */\n  actions?: PluginAction[];\n  /** Variables pre-declared for pyfm; the variable picker UI lists these. */\n  variables?: PluginVariable[];\n  /** Back-end runtime declaration. */\n  runtime?: PluginRuntime;\n}\n\n/**\n * Lightweight structural check. Returns the list of problems (empty = valid).\n * Kept dependency-free so both front and back ends can reuse it; richer\n * validation (zod) can layer on top later without breaking this contract.\n */\nexport function validateManifest(value: unknown): string[] {\n  const errors: string[] = [];\n  if (typeof value !== \"object\" || value === null) {\n    return [\"manifest must be an object\"];\n  }\n  const m = value as Record<string, unknown>;\n  if (typeof m.id !== \"string\" || m.id.length === 0)\n    errors.push(\"manifest.id is required (string)\");\n  if (typeof m.name !== \"string\" || m.name.length === 0)\n    errors.push(\"manifest.name is required (string)\");\n  if (typeof m.version !== \"string\" || m.version.length === 0)\n    errors.push(\"manifest.version is required (string)\");\n  if (m.contributes !== undefined && !Array.isArray(m.contributes))\n    errors.push(\"manifest.contributes must be an array\");\n  if (m.actions !== undefined && !Array.isArray(m.actions))\n    errors.push(\"manifest.actions must be an array\");\n  if (m.variables !== undefined && !Array.isArray(m.variables))\n    errors.push(\"manifest.variables must be an array\");\n  return errors;\n}\n"],
-  "mappings": "AASO,MAAM,sBAAsB;AAAA,EACjC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AA0CO,MAAM,iBAAiB,CAAC,UAAU,UAAU,WAAW,OAAO;AAyD9D,SAAS,iBAAiB,OAA0B;AACzD,QAAM,SAAmB,CAAC;AAC1B,MAAI,OAAO,UAAU,YAAY,UAAU,MAAM;AAC/C,WAAO,CAAC,4BAA4B;AAAA,EACtC;AACA,QAAM,IAAI;AACV,MAAI,OAAO,EAAE,OAAO,YAAY,EAAE,GAAG,WAAW;AAC9C,WAAO,KAAK,kCAAkC;AAChD,MAAI,OAAO,EAAE,SAAS,YAAY,EAAE,KAAK,WAAW;AAClD,WAAO,KAAK,oCAAoC;AAClD,MAAI,OAAO,EAAE,YAAY,YAAY,EAAE,QAAQ,WAAW;AACxD,WAAO,KAAK,uCAAuC;AACrD,MAAI,EAAE,gBAAgB,UAAa,CAAC,MAAM,QAAQ,EAAE,WAAW;AAC7D,WAAO,KAAK,uCAAuC;AACrD,MAAI,EAAE,YAAY,UAAa,CAAC,MAAM,QAAQ,EAAE,OAAO;AACrD,WAAO,KAAK,mCAAmC;AACjD,MAAI,EAAE,cAAc,UAAa,CAAC,MAAM,QAAQ,EAAE,SAAS;AACzD,WAAO,KAAK,qCAAqC;AACnD,SAAO;AACT;",
+  "sourcesContent": ["/* eslint-disable @typescript-eslint/no-explicit-any */\n/**\n * Plugin manifest schema \u2014 the single source of truth shared by the front end\n * (nexus reads it) and the back end (rby2 mirrors it for validation).\n *\n * Evolve additively only.\n */\n\n/** Known contribution points the host understands. */\nexport const CONTRIBUTION_POINTS = [\n  \"toolbar\",\n  \"lnb\",\n  \"move.panel\",\n  \"program.panel\",\n] as const;\n\nexport type ContributionPoint = (typeof CONTRIBUTION_POINTS)[number];\n\n/** How a header.toolbar contribution opens when clicked. */\nexport type ContributionOpens = \"popover\" | \"panel\" | \"page\";\n\nexport interface PluginContribution {\n  /** Where this contribution mounts. */\n  point: ContributionPoint | (string & {});\n  /** UI entry name relative to ui/ (without extension). Defaults to \"content\". */\n  ui?: string;\n  /** Icon path relative to the plugin root (e.g. \"assets/icon.svg\"). */\n  icon?:\n    | string\n    | {\n        \"16\"?: string;\n        \"48\"?: string;\n        \"126\"?: string;\n      };\n  /** Display label. */\n  label?: string | Record<string, string>;\n  /** For header.toolbar: how the contribution surfaces. */\n  opens?: ContributionOpens;\n  commandInfo?: {\n    name: string;\n    icon: string;\n    funcName: string;\n    args?: Record<string, any>;\n  };\n}\n\nexport interface PluginAction {\n  /** Action id referenced by `rb.action(id, payload)`. */\n  id: string;\n  /** Transport topic (Zenoh / ROS2) the back end routes to. */\n  topic: string;\n  /** Optional payload schema hint (field \u2192 type name). */\n  schema?: Record<string, string>;\n}\n\n/** Allowed variable value types exposed to pyfm. */\nexport const VARIABLE_TYPES = [\"number\", \"string\", \"boolean\", \"array\"] as const;\n\nexport type PluginVariableType = (typeof VARIABLE_TYPES)[number];\n\n/** A variable the plugin pre-declares for use in pyfm programs. */\nexport interface PluginVariable {\n  /** Identifier, must start with \"RBP_\" (then letters, digits, underscore). Unique per plugin. */\n  name: `RBP_${string}`;\n  type: PluginVariableType;\n  /** Initial value \u2014 must match `type`. */\n  init: number | string | boolean | any[];\n  /** Optional. Without it the UI cannot explain what the variable is for. */\n  description?: string | Record<string, string>;\n}\n\nexport type PluginRuntime =\n  | { type: \"none\" }\n  | { type: \"python\"; entry: string }\n  | {\n      type: \"ros2\";\n      package: string;\n      launch: string;\n      rosClient: \"rclpy\" | \"rclcpp\";\n    };\n\nexport interface PluginManifest {\n  /** Reverse-DNS unique id, e.g. \"com.rainbow.gripper-tool\". */\n  id: string;\n  /** Human-readable name. */\n  name: string;\n  /** Plugin version (semver). */\n  version: string;\n  /** Minimum host (Muscat) version this plugin supports. */\n  minAppVersion?: string;\n  /** Icon path relative to plugin root. */\n  icons:\n    | string\n    | {\n        \"16\"?: string;\n        \"48\"?: string;\n        \"128\"?: string;\n      };\n  /** UI / chrome contributions. */\n  contributes?: PluginContribution[];\n  /** Host actions the plugin can invoke. */\n  actions?: PluginAction[];\n  /** Variables pre-declared for pyfm; the variable picker UI lists these. */\n  variables?: PluginVariable[];\n  /** Back-end runtime declaration. */\n  runtime?: PluginRuntime;\n}\n\n/**\n * Lightweight structural check. Returns the list of problems (empty = valid).\n * Kept dependency-free so both front and back ends can reuse it; richer\n * validation (zod) can layer on top later without breaking this contract.\n */\nexport function validateManifest(value: unknown): string[] {\n  const errors: string[] = [];\n  if (typeof value !== \"object\" || value === null) {\n    return [\"manifest must be an object\"];\n  }\n  const m = value as Record<string, unknown>;\n  if (typeof m.id !== \"string\" || m.id.length === 0)\n    errors.push(\"manifest.id is required (string)\");\n  else if (!/^[a-z][a-z0-9]*(-[a-z0-9]+)*(\\.[a-z][a-z0-9]*(-[a-z0-9]+)*)*$/.test(m.id))\n    errors.push('manifest.id must be \".\"-separated parts of lowercase letters/digits and single \"-\", each starting with a letter (e.g. com.example.my-plugin)');\n  if (typeof m.name !== \"string\" || m.name.length === 0)\n    errors.push(\"manifest.name is required (string)\");\n  if (typeof m.version !== \"string\" || m.version.length === 0)\n    errors.push(\"manifest.version is required (string)\");\n  if (m.contributes !== undefined && !Array.isArray(m.contributes))\n    errors.push(\"manifest.contributes must be an array\");\n  if (m.actions !== undefined && !Array.isArray(m.actions))\n    errors.push(\"manifest.actions must be an array\");\n  if (m.variables !== undefined && !Array.isArray(m.variables))\n    errors.push(\"manifest.variables must be an array\");\n  return errors;\n}\n"],
+  "mappings": "AASO,MAAM,sBAAsB;AAAA,EACjC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AA0CO,MAAM,iBAAiB,CAAC,UAAU,UAAU,WAAW,OAAO;AAyD9D,SAAS,iBAAiB,OAA0B;AACzD,QAAM,SAAmB,CAAC;AAC1B,MAAI,OAAO,UAAU,YAAY,UAAU,MAAM;AAC/C,WAAO,CAAC,4BAA4B;AAAA,EACtC;AACA,QAAM,IAAI;AACV,MAAI,OAAO,EAAE,OAAO,YAAY,EAAE,GAAG,WAAW;AAC9C,WAAO,KAAK,kCAAkC;AAAA,WACvC,CAAC,gEAAgE,KAAK,EAAE,EAAE;AACjF,WAAO,KAAK,8IAA8I;AAC5J,MAAI,OAAO,EAAE,SAAS,YAAY,EAAE,KAAK,WAAW;AAClD,WAAO,KAAK,oCAAoC;AAClD,MAAI,OAAO,EAAE,YAAY,YAAY,EAAE,QAAQ,WAAW;AACxD,WAAO,KAAK,uCAAuC;AACrD,MAAI,EAAE,gBAAgB,UAAa,CAAC,MAAM,QAAQ,EAAE,WAAW;AAC7D,WAAO,KAAK,uCAAuC;AACrD,MAAI,EAAE,YAAY,UAAa,CAAC,MAAM,QAAQ,EAAE,OAAO;AACrD,WAAO,KAAK,mCAAmC;AACjD,MAAI,EAAE,cAAc,UAAa,CAAC,MAAM,QAAQ,EAAE,SAAS;AACzD,WAAO,KAAK,qCAAqC;AACnD,SAAO;AACT;",
   "names": []
 }

package/dist/react.d.ts

@@ -66,7 +66,7 @@ declare const labelButtonSizes: readonly ["3xs", "2xs", "xs", "xs2", "sm", "md"]
 type LabelButtonSizeType = (typeof labelButtonSizes)[number];
 declare const labelButtonVariants: (props?: {
     size?: "3xs" | "2xs" | "xs" | "xs2" | "sm" | "md";
-    variant?: "transparent" | "outlined" | "soft" | "solid" | "inverse" | "inverseSoft" | "brand" | "success" | "brandSoft" | "danger" | "dangerSoft" | "successSoft";
+    variant?: "transparent" | "outlined" | "soft" | "solid" | "inverse" | "inverseSoft" | "brand" | "brandSoft" | "danger" | "dangerSoft" | "success" | "successSoft";
     disabled?: boolean;
 } & class_variance_authority_types.ClassProp) => string;
 type LabelButtonVariantProps = VariantProps<typeof labelButtonVariants>;
@@ -448,7 +448,7 @@ declare const textInputVariantsList: readonly ["default", "success"];
 type TextInputVariant = (typeof textInputVariantsList)[number];
 declare const textInputVariants: (props?: {
     size?: "xs2" | "sm" | "md" | "lg";
-    variant?: "default" | "success";
+    variant?: "success" | "default";
     focus?: boolean;
     error?: boolean;
     readOnly?: boolean;
@@ -519,7 +519,7 @@ type TextAreaSize = (typeof textAreaSizes)[number];
 declare const textAreaSizes: readonly ["sm", "md", "lg"];
 declare const textAreaVariants: (props?: {
     size?: "sm" | "md" | "lg";
-    variant?: "default" | "success";
+    variant?: "success" | "default";
     focus?: boolean;
     error?: boolean;
     readOnly?: boolean;
@@ -984,6 +984,10 @@ interface PropsType$p extends Pick<InputHTMLAttributes<HTMLInputElement>, "name"
      * SelectBox의 크기
      */
     size?: SelectSize;
+    /**
+     * SelectBox DropBox의 최대 높이
+     */
+    maxDropBoxHeight?: number;
     /**
      * option list를 찾는 search 기능 활성화 여부
      */
@@ -1229,7 +1233,7 @@ declare const sideNumberInputVariantsList: readonly ["default", "success"];
 type SideNumberInputVariant = (typeof sideNumberInputVariantsList)[number];
 declare const sideNumberInputVariants: (props?: {
     size?: "xs2" | "sm" | "md" | "lg";
-    variant?: "default" | "success";
+    variant?: "success" | "default";
     focus?: boolean;
     error?: boolean;
     readOnly?: boolean;
@@ -2322,7 +2326,7 @@ interface PropsType$5 {
 declare function RBSwitchField({ children, className, controlPlacement, description, descriptionClassName, invalid, label, labelClassName, size, type, }: PropsType$5): react_jsx_runtime.JSX.Element;
 
 declare const toggleRootVariants: (props?: {
-    size?: "sm" | "lg" | "default";
+    size?: "sm" | "default" | "lg";
     variant?: "default" | "outline";
 } & class_variance_authority_types.ClassProp) => string;
 type ToggleVariantProps = VariantProps<typeof toggleRootVariants>;
@@ -3624,6 +3628,16 @@ interface RbSdk {
      * unregister fn. Prefer the `useRbSave()` hook.
      */
     onSave: (getPayload: () => unknown) => () => void;
+    /**
+     * PCs allowed to talk to this plugin's ROS 2 nodes. ROS discovery is robot-local
+     * (ROS_AUTOMATIC_DISCOVERY_RANGE=LOCALHOST); Muscat keeps this list per plugin, starts
+     * the plugin with ROS_STATIC_PEERS set to it, and restarts the plugin when it changes.
+     */
+    rosPeers: {
+        get: () => Promise<string[]>;
+        /** Saves the list and restarts the plugin backend. Rejects on an invalid IP. */
+        set: (peers: string[]) => Promise<string[]>;
+    };
 }
 /** Access the host SDK from within a plugin component. */
 declare function useRb(): RbSdk;

package/dist/sdk.d.ts

@@ -41,6 +41,16 @@ export interface RbSdk {
      * unregister fn. Prefer the `useRbSave()` hook.
      */
     onSave: (getPayload: () => unknown) => () => void;
+    /**
+     * PCs allowed to talk to this plugin's ROS 2 nodes. ROS discovery is robot-local
+     * (ROS_AUTOMATIC_DISCOVERY_RANGE=LOCALHOST); Muscat keeps this list per plugin, starts
+     * the plugin with ROS_STATIC_PEERS set to it, and restarts the plugin when it changes.
+     */
+    rosPeers: {
+        get: () => Promise<string[]>;
+        /** Saves the list and restarts the plugin backend. Rejects on an invalid IP. */
+        set: (peers: string[]) => Promise<string[]>;
+    };
 }
 export declare const RbContext: import("react").Context<RbSdk>;
 /** Access the host SDK from within a plugin component. */

package/dist/sdk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,YAAY,IAAI,UAAU,EAC1B,WAAW,IAAI,SAAS,EACzB,MAAM,MAAM,CAAC;AAGd,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAElD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAEpE,MAAM,WAAW,KAAK;IACpB;;;;OAIG;IACH,GAAG,EAAE,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3D,+DAA+D;IAC/D,GAAG,EAAE,CAAC,CAAC,GAAG,GAAG,EACX,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,KAC1B,OAAO,CAAC,UAAU,CAAC,CAAC;IAEzB;;;OAGG;IACH,MAAM,EAAE,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAErE;;;OAGG;IACH,KAAK,EAAE,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EACtB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,KACrC,OAAO,CAAC,SAAS,CAAC,CAAC;IAExB,qEAAqE;IACrE,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAEjC,gCAAgC;IAChC,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACjC,uDAAuD;IACvD,OAAO,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;IACrC,wFAAwF;IACxF,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAEnC;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;;;;OAKG;IACH,MAAM,EAAE,CAAC,UAAU,EAAE,MAAM,OAAO,KAAK,MAAM,IAAI,CAAC;CACnD;AAuCD,eAAO,MAAM,SAAS,gCAAgC,CAAC;AAEvD,0DAA0D;AAC1D,wBAAgB,KAAK,IAAI,KAAK,CAE7B;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,GAAG,OAAO,KAAK,CAAC,GAAG,SAAS,CAE1D;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,GAAG,IAAI,CAKhE"}
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,YAAY,IAAI,UAAU,EAC1B,WAAW,IAAI,SAAS,EACzB,MAAM,MAAM,CAAC;AAGd,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAElD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAEpE,MAAM,WAAW,KAAK;IACpB;;;;OAIG;IACH,GAAG,EAAE,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3D,+DAA+D;IAC/D,GAAG,EAAE,CAAC,CAAC,GAAG,GAAG,EACX,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,KAC1B,OAAO,CAAC,UAAU,CAAC,CAAC;IAEzB;;;OAGG;IACH,MAAM,EAAE,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAErE;;;OAGG;IACH,KAAK,EAAE,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EACtB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,KACrC,OAAO,CAAC,SAAS,CAAC,CAAC;IAExB,qEAAqE;IACrE,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAEjC,gCAAgC;IAChC,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACjC,uDAAuD;IACvD,OAAO,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;IACrC,wFAAwF;IACxF,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAEnC;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;;;;OAKG;IACH,MAAM,EAAE,CAAC,UAAU,EAAE,MAAM,OAAO,KAAK,MAAM,IAAI,CAAC;IAElD;;;;OAIG;IACH,QAAQ,EAAE;QACR,GAAG,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7B,gFAAgF;QAChF,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;KAC7C,CAAC;CACH;AAiDD,eAAO,MAAM,SAAS,gCAAgC,CAAC;AAEvD,0DAA0D;AAC1D,wBAAgB,KAAK,IAAI,KAAK,CAE7B;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,GAAG,OAAO,KAAK,CAAC,GAAG,SAAS,CAE1D;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,GAAG,IAAI,CAKhE"}

package/dist/sdk.js

@@ -33,6 +33,16 @@ const noopSdk = {
   },
   data: void 0,
   onSave: () => () => {
+  },
+  rosPeers: {
+    get: async () => {
+      console.warn("[plugin-ui] rb.rosPeers called outside of a host context");
+      return [];
+    },
+    set: async () => {
+      console.warn("[plugin-ui] rb.rosPeers called outside of a host context");
+      return [];
+    }
   }
 };
 const RbContext = createContext(noopSdk);

package/dist/sdk.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/sdk.ts"],
-  "sourcesContent": ["/* eslint-disable @typescript-eslint/no-explicit-any */\n/**\n * Plugin runtime SDK (`useRb()`).\n *\n * pub/sub/action/serve talk to the Zenoh router over WebSocket. Topics are\n * namespaced to {pluginId}/... ; a leading \"/\" makes the path absolute.\n * alert/confirm/prompt/toast delegate to the host.\n */\nimport { createContext, useContext, useEffect, useRef } from \"react\";\nimport type {\n  WsSubscriber as Subscriber,\n  WsQueryable as Queryable,\n} from \"./ws\";\n// Type-only import \u2014 no runtime coupling to host-ui.ts (which itself has no\n// dependency back on sdk.ts, so this stays one-directional).\nimport type { PluginUIServices } from \"./host-ui\";\n\nexport type RbNotifyType = \"info\" | \"success\" | \"warning\" | \"error\";\n\nexport interface RbSdk {\n  /**\n   * Publish JSON payload to a topic.\n   * \"sensor/data\" \u2192 {pluginId}/sensor/data\n   * \"/broadcast/x\" \u2192 broadcast/x  (absolute)\n   */\n  pub: <P = any>(topic: string, payload: P) => Promise<void>;\n\n  /** Subscribe to a topic. Returns a handle with undeclare(). */\n  sub: <P = any>(\n    topic: string,\n    handler: (payload: P) => void,\n  ) => Promise<Subscriber>;\n\n  /**\n   * Send a request and await the first reply (Zenoh query).\n   * Use this to call a backend handler registered with rb.serve() / ZenohRouter.\n   */\n  action: <R = any, P = any>(topic: string, payload?: P) => Promise<R>;\n\n  /**\n   * Register a queryable \u2014 the frontend responds to backend queries.\n   * Mirror of rb.action() on the other side.\n   */\n  serve: <P = any, R = any>(\n    topic: string,\n    handler: (payload?: P) => R | Promise<R>,\n  ) => Promise<Queryable>;\n\n  /** Show a transient notification through the host's toast system. */\n  toast: PluginUIServices[\"toast\"];\n\n  /** Show a host alert dialog. */\n  alert: PluginUIServices[\"alert\"];\n  /** Show a host confirm dialog. Resolves true/false. */\n  confirm: PluginUIServices[\"confirm\"];\n  /** Show a host prompt dialog. Resolves the entered value, or undefined if cancelled. */\n  prompt: PluginUIServices[\"prompt\"];\n\n  /**\n   * Host-provided initial data for this mount \u2014 e.g. the previously-saved\n   * values when the host re-opens a form. `undefined` for a fresh mount.\n   * Prefer the `useRbFormData()` hook over reading this directly.\n   */\n  data?: unknown;\n\n  /**\n   * Register a getter the host calls (synchronously) to collect this plugin's\n   * save payload \u2014 e.g. when the host's Save button is clicked. The returned\n   * value must be JSON-serialisable (the host persists it). Returns an\n   * unregister fn. Prefer the `useRbSave()` hook.\n   */\n  onSave: (getPayload: () => unknown) => () => void;\n}\n\nconst noopSdk: RbSdk = {\n  pub: async <P = any>(_topic?: string, _payload?: P) => {\n    console.warn(\"[plugin-ui] rb.pub called outside of a host context\");\n  },\n  sub: async <P = any>(_topic?: string, _handler?: (payload: P) => void) => {\n    console.warn(\"[plugin-ui] rb.sub called outside of a host context\");\n    return { undeclare: async () => {} } as unknown as Subscriber;\n  },\n  action: async <R = any, P = any>(_topic?: string, _payload?: P) => {\n    console.warn(\"[plugin-ui] rb.action called outside of a host context\");\n    return undefined as R;\n  },\n  serve: async <P = any, R = any>(\n    _topic?: string,\n    _handler?: (payload?: P) => R,\n  ) => {\n    console.warn(\"[plugin-ui] rb.serve called outside of a host context\");\n    return { undeclare: async () => {} } as unknown as Queryable;\n  },\n  toast: (params) => {\n    console.warn(\"[plugin-ui] rb.toast (no host):\", params);\n  },\n  alert: async (_) => {\n    console.warn(\"[plugin-ui] rb.alert called outside of a host context\");\n  },\n  confirm: async (_) => {\n    console.warn(\"[plugin-ui] rb.confirm called outside of a host context\");\n    return false;\n  },\n  prompt: async (_) => {\n    console.warn(\"[plugin-ui] rb.prompt called outside of a host context\");\n    return undefined;\n  },\n  data: undefined,\n  onSave: () => () => {},\n};\n\nexport const RbContext = createContext<RbSdk>(noopSdk);\n\n/** Access the host SDK from within a plugin component. */\nexport function useRb(): RbSdk {\n  return useContext(RbContext);\n}\n\n/**\n * Read the host-provided initial data for this mount (e.g. previously-saved\n * form values). `undefined` for a fresh mount.\n *\n *   const saved = useRbFormData<MyArgs>();\n *   const methods = useForm({ defaultValues: saved ?? DEFAULTS });\n */\nexport function useRbFormData<T = unknown>(): T | undefined {\n  return useRb().data as T | undefined;\n}\n\n/**\n * Register a getter the host calls to collect this plugin's save payload when\n * the host's Save is clicked. The latest `getPayload` is always used, so it can\n * close over current state. The returned value must be JSON-serialisable.\n *\n *   useRbSave(() => ({ args: getValues(), summary: buildSummary() }));\n */\nexport function useRbSave<T = unknown>(getPayload: () => T): void {\n  const rb = useRb();\n  const ref = useRef(getPayload);\n  ref.current = getPayload;\n  useEffect(() => rb.onSave(() => ref.current()), [rb]);\n}\n"],
-  "mappings": "AAQA,SAAS,eAAe,YAAY,WAAW,cAAc;AAkE7D,MAAM,UAAiB;AAAA,EACrB,KAAK,OAAgB,QAAiB,aAAiB;AACrD,YAAQ,KAAK,qDAAqD;AAAA,EACpE;AAAA,EACA,KAAK,OAAgB,QAAiB,aAAoC;AACxE,YAAQ,KAAK,qDAAqD;AAClE,WAAO,EAAE,WAAW,YAAY;AAAA,IAAC,EAAE;AAAA,EACrC;AAAA,EACA,QAAQ,OAAyB,QAAiB,aAAiB;AACjE,YAAQ,KAAK,wDAAwD;AACrE,WAAO;AAAA,EACT;AAAA,EACA,OAAO,OACL,QACA,aACG;AACH,YAAQ,KAAK,uDAAuD;AACpE,WAAO,EAAE,WAAW,YAAY;AAAA,IAAC,EAAE;AAAA,EACrC;AAAA,EACA,OAAO,CAAC,WAAW;AACjB,YAAQ,KAAK,mCAAmC,MAAM;AAAA,EACxD;AAAA,EACA,OAAO,OAAO,MAAM;AAClB,YAAQ,KAAK,uDAAuD;AAAA,EACtE;AAAA,EACA,SAAS,OAAO,MAAM;AACpB,YAAQ,KAAK,yDAAyD;AACtE,WAAO;AAAA,EACT;AAAA,EACA,QAAQ,OAAO,MAAM;AACnB,YAAQ,KAAK,wDAAwD;AACrE,WAAO;AAAA,EACT;AAAA,EACA,MAAM;AAAA,EACN,QAAQ,MAAM,MAAM;AAAA,EAAC;AACvB;AAEO,MAAM,YAAY,cAAqB,OAAO;AAG9C,SAAS,QAAe;AAC7B,SAAO,WAAW,SAAS;AAC7B;AASO,SAAS,gBAA4C;AAC1D,SAAO,MAAM,EAAE;AACjB;AASO,SAAS,UAAuB,YAA2B;AAChE,QAAM,KAAK,MAAM;AACjB,QAAM,MAAM,OAAO,UAAU;AAC7B,MAAI,UAAU;AACd,YAAU,MAAM,GAAG,OAAO,MAAM,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;AACtD;",
+  "sourcesContent": ["/* eslint-disable @typescript-eslint/no-explicit-any */\n/**\n * Plugin runtime SDK (`useRb()`).\n *\n * pub/sub/action/serve talk to the Zenoh router over WebSocket. Topics are\n * namespaced to {pluginId}/... ; a leading \"/\" makes the path absolute.\n * alert/confirm/prompt/toast delegate to the host.\n */\nimport { createContext, useContext, useEffect, useRef } from \"react\";\nimport type {\n  WsSubscriber as Subscriber,\n  WsQueryable as Queryable,\n} from \"./ws\";\n// Type-only import \u2014 no runtime coupling to host-ui.ts (which itself has no\n// dependency back on sdk.ts, so this stays one-directional).\nimport type { PluginUIServices } from \"./host-ui\";\n\nexport type RbNotifyType = \"info\" | \"success\" | \"warning\" | \"error\";\n\nexport interface RbSdk {\n  /**\n   * Publish JSON payload to a topic.\n   * \"sensor/data\" \u2192 {pluginId}/sensor/data\n   * \"/broadcast/x\" \u2192 broadcast/x  (absolute)\n   */\n  pub: <P = any>(topic: string, payload: P) => Promise<void>;\n\n  /** Subscribe to a topic. Returns a handle with undeclare(). */\n  sub: <P = any>(\n    topic: string,\n    handler: (payload: P) => void,\n  ) => Promise<Subscriber>;\n\n  /**\n   * Send a request and await the first reply (Zenoh query).\n   * Use this to call a backend handler registered with rb.serve() / ZenohRouter.\n   */\n  action: <R = any, P = any>(topic: string, payload?: P) => Promise<R>;\n\n  /**\n   * Register a queryable \u2014 the frontend responds to backend queries.\n   * Mirror of rb.action() on the other side.\n   */\n  serve: <P = any, R = any>(\n    topic: string,\n    handler: (payload?: P) => R | Promise<R>,\n  ) => Promise<Queryable>;\n\n  /** Show a transient notification through the host's toast system. */\n  toast: PluginUIServices[\"toast\"];\n\n  /** Show a host alert dialog. */\n  alert: PluginUIServices[\"alert\"];\n  /** Show a host confirm dialog. Resolves true/false. */\n  confirm: PluginUIServices[\"confirm\"];\n  /** Show a host prompt dialog. Resolves the entered value, or undefined if cancelled. */\n  prompt: PluginUIServices[\"prompt\"];\n\n  /**\n   * Host-provided initial data for this mount \u2014 e.g. the previously-saved\n   * values when the host re-opens a form. `undefined` for a fresh mount.\n   * Prefer the `useRbFormData()` hook over reading this directly.\n   */\n  data?: unknown;\n\n  /**\n   * Register a getter the host calls (synchronously) to collect this plugin's\n   * save payload \u2014 e.g. when the host's Save button is clicked. The returned\n   * value must be JSON-serialisable (the host persists it). Returns an\n   * unregister fn. Prefer the `useRbSave()` hook.\n   */\n  onSave: (getPayload: () => unknown) => () => void;\n\n  /**\n   * PCs allowed to talk to this plugin's ROS 2 nodes. ROS discovery is robot-local\n   * (ROS_AUTOMATIC_DISCOVERY_RANGE=LOCALHOST); Muscat keeps this list per plugin, starts\n   * the plugin with ROS_STATIC_PEERS set to it, and restarts the plugin when it changes.\n   */\n  rosPeers: {\n    get: () => Promise<string[]>;\n    /** Saves the list and restarts the plugin backend. Rejects on an invalid IP. */\n    set: (peers: string[]) => Promise<string[]>;\n  };\n}\n\nconst noopSdk: RbSdk = {\n  pub: async <P = any>(_topic?: string, _payload?: P) => {\n    console.warn(\"[plugin-ui] rb.pub called outside of a host context\");\n  },\n  sub: async <P = any>(_topic?: string, _handler?: (payload: P) => void) => {\n    console.warn(\"[plugin-ui] rb.sub called outside of a host context\");\n    return { undeclare: async () => {} } as unknown as Subscriber;\n  },\n  action: async <R = any, P = any>(_topic?: string, _payload?: P) => {\n    console.warn(\"[plugin-ui] rb.action called outside of a host context\");\n    return undefined as R;\n  },\n  serve: async <P = any, R = any>(\n    _topic?: string,\n    _handler?: (payload?: P) => R,\n  ) => {\n    console.warn(\"[plugin-ui] rb.serve called outside of a host context\");\n    return { undeclare: async () => {} } as unknown as Queryable;\n  },\n  toast: (params) => {\n    console.warn(\"[plugin-ui] rb.toast (no host):\", params);\n  },\n  alert: async (_) => {\n    console.warn(\"[plugin-ui] rb.alert called outside of a host context\");\n  },\n  confirm: async (_) => {\n    console.warn(\"[plugin-ui] rb.confirm called outside of a host context\");\n    return false;\n  },\n  prompt: async (_) => {\n    console.warn(\"[plugin-ui] rb.prompt called outside of a host context\");\n    return undefined;\n  },\n  data: undefined,\n  onSave: () => () => {},\n  rosPeers: {\n    get: async () => {\n      console.warn(\"[plugin-ui] rb.rosPeers called outside of a host context\");\n      return [];\n    },\n    set: async () => {\n      console.warn(\"[plugin-ui] rb.rosPeers called outside of a host context\");\n      return [];\n    },\n  },\n};\n\nexport const RbContext = createContext<RbSdk>(noopSdk);\n\n/** Access the host SDK from within a plugin component. */\nexport function useRb(): RbSdk {\n  return useContext(RbContext);\n}\n\n/**\n * Read the host-provided initial data for this mount (e.g. previously-saved\n * form values). `undefined` for a fresh mount.\n *\n *   const saved = useRbFormData<MyArgs>();\n *   const methods = useForm({ defaultValues: saved ?? DEFAULTS });\n */\nexport function useRbFormData<T = unknown>(): T | undefined {\n  return useRb().data as T | undefined;\n}\n\n/**\n * Register a getter the host calls to collect this plugin's save payload when\n * the host's Save is clicked. The latest `getPayload` is always used, so it can\n * close over current state. The returned value must be JSON-serialisable.\n *\n *   useRbSave(() => ({ args: getValues(), summary: buildSummary() }));\n */\nexport function useRbSave<T = unknown>(getPayload: () => T): void {\n  const rb = useRb();\n  const ref = useRef(getPayload);\n  ref.current = getPayload;\n  useEffect(() => rb.onSave(() => ref.current()), [rb]);\n}\n"],
+  "mappings": "AAQA,SAAS,eAAe,YAAY,WAAW,cAAc;AA6E7D,MAAM,UAAiB;AAAA,EACrB,KAAK,OAAgB,QAAiB,aAAiB;AACrD,YAAQ,KAAK,qDAAqD;AAAA,EACpE;AAAA,EACA,KAAK,OAAgB,QAAiB,aAAoC;AACxE,YAAQ,KAAK,qDAAqD;AAClE,WAAO,EAAE,WAAW,YAAY;AAAA,IAAC,EAAE;AAAA,EACrC;AAAA,EACA,QAAQ,OAAyB,QAAiB,aAAiB;AACjE,YAAQ,KAAK,wDAAwD;AACrE,WAAO;AAAA,EACT;AAAA,EACA,OAAO,OACL,QACA,aACG;AACH,YAAQ,KAAK,uDAAuD;AACpE,WAAO,EAAE,WAAW,YAAY;AAAA,IAAC,EAAE;AAAA,EACrC;AAAA,EACA,OAAO,CAAC,WAAW;AACjB,YAAQ,KAAK,mCAAmC,MAAM;AAAA,EACxD;AAAA,EACA,OAAO,OAAO,MAAM;AAClB,YAAQ,KAAK,uDAAuD;AAAA,EACtE;AAAA,EACA,SAAS,OAAO,MAAM;AACpB,YAAQ,KAAK,yDAAyD;AACtE,WAAO;AAAA,EACT;AAAA,EACA,QAAQ,OAAO,MAAM;AACnB,YAAQ,KAAK,wDAAwD;AACrE,WAAO;AAAA,EACT;AAAA,EACA,MAAM;AAAA,EACN,QAAQ,MAAM,MAAM;AAAA,EAAC;AAAA,EACrB,UAAU;AAAA,IACR,KAAK,YAAY;AACf,cAAQ,KAAK,0DAA0D;AACvE,aAAO,CAAC;AAAA,IACV;AAAA,IACA,KAAK,YAAY;AACf,cAAQ,KAAK,0DAA0D;AACvE,aAAO,CAAC;AAAA,IACV;AAAA,EACF;AACF;AAEO,MAAM,YAAY,cAAqB,OAAO;AAG9C,SAAS,QAAe;AAC7B,SAAO,WAAW,SAAS;AAC7B;AASO,SAAS,gBAA4C;AAC1D,SAAO,MAAM,EAAE;AACjB;AASO,SAAS,UAAuB,YAA2B;AAChE,QAAM,KAAK,MAAM;AACjB,QAAM,MAAM,OAAO,UAAU;AAC7B,MAAI,UAAU;AACd,YAAU,MAAM,GAAG,OAAO,MAAM,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;AACtD;",
   "names": []
 }

package/dist/ws.d.ts

@@ -10,6 +10,7 @@ export declare class RbWs {
     private readonly _subHandlers;
     private readonly _serveHandlers;
     private constructor();
+    get pluginId(): string;
     static connect(url: string, pluginId: string): Promise<RbWs>;
     private _key;
     pub<P = any>(topic: string, payload: P): Promise<void>;
@@ -69,5 +70,9 @@ export declare function createLazyRbSdk(wsPromise: Promise<RbWs>, services: Plug
     }) => Promise<string | undefined>;
     data: unknown;
     onSave: (getPayload: () => unknown) => () => void;
+    rosPeers: {
+        get: () => Promise<string[]>;
+        set: (peers: string[]) => Promise<string[]>;
+    };
 };
 //# sourceMappingURL=ws.d.ts.map

package/dist/ws.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ws.d.ts","sourceRoot":"","sources":["../src/ws.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAElD,MAAM,WAAW,QAAQ;IACvB,SAAS,IAAI,IAAI,CAAC;CACnB;AAED,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC;AACpC,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC;AAMnC,qBAAa,IAAI;IACf,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAGzB;IACJ,OAAO,CAAC,QAAQ,CAAC,cAAc,CAG3B;IAEJ,OAAO;IA+BP,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB5D,OAAO,CAAC,IAAI;IAKN,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAKtD,GAAG,CAAC,CAAC,GAAG,GAAG,EACf,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,GAC5B,OAAO,CAAC,YAAY,CAAC;IAsBlB,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAuChE,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAC1B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACvC,OAAO,CAAC,WAAW,CAAC;IAYvB,KAAK,IAAI,IAAI;CAGd;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,EACxB,QAAQ,EAAE,gBAAgB,EAI1B,KAAK,CAAC,EAAE;IACN,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,OAAO,KAAK,MAAM,IAAI,CAAC;CACpD;iBAIoB,MAAM,WAAW,GAAG;iBAG9B,MAAM,WAEJ,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI;oBAGX,MAAM,YAAY,GAAG;mBAGlC,MAAM,WAEJ,CAAC,OAAO,CAAC,EAAE,GAAG,KAAK,GAAG;;aA1MtB,CAAC;;YAIE,CAAC;mBAGF,CAAC;yBAA+B,CAAC;0BAC7B,CAAC;gBAAuB,CAAC;eAAqB,CAAC;;;aApB1B,CAAA;;kBAC9B,CAAC;;;aACgB,CAAC;;kBAExB,CAAC;;;;;;aAEF,CAAD;;aAED,CAAC;mBAAyB,CAAC;kBAC3B,CAAA;;;;;;yBA2LuB,MAAM,OAAO,KAAK,MAAM,IAAI;EA2BrD"}
+{"version":3,"file":"ws.d.ts","sourceRoot":"","sources":["../src/ws.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAElD,MAAM,WAAW,QAAQ;IACvB,SAAS,IAAI,IAAI,CAAC;CACnB;AAED,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC;AACpC,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC;AAMnC,qBAAa,IAAI;IACf,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAGzB;IACJ,OAAO,CAAC,QAAQ,CAAC,cAAc,CAG3B;IAEJ,OAAO;IAsCP,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB5D,OAAO,CAAC,IAAI;IAKN,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAKtD,GAAG,CAAC,CAAC,GAAG,GAAG,EACf,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,GAC5B,OAAO,CAAC,YAAY,CAAC;IAsBlB,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAuChE,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAC1B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACvC,OAAO,CAAC,WAAW,CAAC;IAYvB,KAAK,IAAI,IAAI;CAGd;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,EACxB,QAAQ,EAAE,gBAAgB,EAI1B,KAAK,CAAC,EAAE;IACN,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,OAAO,KAAK,MAAM,IAAI,CAAC;CACpD;iBAIoB,MAAM,WAAW,GAAG;iBAG9B,MAAM,WAEJ,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI;oBAGX,MAAM,YAAY,GAAG;mBAGlC,MAAM,WAEJ,CAAC,OAAO,CAAC,EAAE,GAAG,KAAK,GAAG;;aArNtB,CAAC;;YAIE,CAAC;mBAGF,CAAC;yBAA+B,CAAC;0BAC7B,CAAC;gBAAuB,CAAC;eAAqB,CAAC;;;aApB1B,CAAA;;kBAC9B,CAAC;;;aACgB,CAAC;;kBAExB,CAAC;;;;;;aAEF,CAAD;;aAED,CAAC;mBAAyB,CAAC;kBAC3B,CAAA;;;;;;yBAsMuB,MAAM,OAAO,KAAK,MAAM,IAAI;;mBAqCnC,OAAO,CAAC,MAAM,EAAE,CAAC;qBACb,MAAM,EAAE,KAAG,OAAO,CAAC,MAAM,EAAE,CAAC;;EAPlD"}

package/dist/ws.js

@@ -10,6 +10,10 @@ class RbWs {
   constructor(socket, pluginId) {
     this._socket = socket;
     this._pluginId = pluginId;
+    socket.io.on("reconnect", () => {
+      for (const topic of this._subHandlers.keys()) socket.emit("sub", { topic });
+      for (const topic of this._serveHandlers.keys()) socket.emit("serve_register", { topic });
+    });
     socket.on(
       "msg",
       ({ topic, payload }) => {
@@ -29,6 +33,9 @@ class RbWs {
       }
     );
   }
+  get pluginId() {
+    return this._pluginId;
+  }
   static connect(url, pluginId) {
     return new Promise((resolve, reject) => {
       const socket = io(url, { transports: ["websocket"] });
@@ -131,9 +138,23 @@ function createLazyRbSdk(wsPromise, services, mount) {
     prompt: services.prompt,
     data: mount?.data,
     onSave: mount?.onSave ?? (() => () => {
+    }),
+    rosPeers: rosPeersApi(async (op, payload) => {
+      const ws = await wsPromise;
+      return ws.action(`/muscat/plugin/${ws.pluginId}/ros_peers/${op}`, payload);
     })
   };
 }
+function rosPeersApi(call) {
+  return {
+    get: async () => (await call("get"))?.peers ?? [],
+    set: async (peers) => {
+      const r = await call("set", { peers });
+      if (!r?.ok) throw new Error(r?.error ?? "rb.rosPeers.set failed");
+      return r.peers;
+    }
+  };
+}
 export {
   RbWs,
   createLazyRbSdk

package/dist/ws.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/ws.ts"],
-  "sourcesContent": ["/**\n * Socket.IO communication client for plugin frontends.\n *\n * Topics are automatically namespaced to prevent cross-plugin collisions:\n *   \"sensor/data\"  \u2192  \"{pluginId}/sensor/data\"\n *   \"/broadcast/x\" \u2192  \"broadcast/x\"   (leading slash = absolute)\n *\n * Browser \u2190\u2192 Python backend protocol:\n *   browser emits : sub, unsub, pub, action (with ack), serve_reply\n *   server emits  : msg, serve_call\n */\nimport { io, type Socket } from \"socket.io-client\";\n// Type-only \u2014 no runtime coupling to host-ui.ts.\nimport type { PluginUIServices } from \"./host-ui\";\n\nexport interface WsHandle {\n  undeclare(): void;\n}\n\nexport type WsSubscriber = WsHandle;\nexport type WsQueryable = WsHandle;\n\nfunction resolveTopic(pluginId: string, topic: string): string {\n  return topic.startsWith(\"/\") ? topic.slice(1) : `${pluginId}/${topic}`;\n}\n\nexport class RbWs {\n  private readonly _socket: Socket;\n  private readonly _pluginId: string;\n  private readonly _subHandlers = new Map<\n    string,\n    Set<(payload: unknown) => void>\n  >();\n  private readonly _serveHandlers = new Map<\n    string,\n    (payload?: unknown) => unknown | Promise<unknown>\n  >();\n\n  private constructor(socket: Socket, pluginId: string) {\n    this._socket = socket;\n    this._pluginId = pluginId;\n\n    // Deliver incoming pub/sub messages to registered handlers\n    socket.on(\n      \"msg\",\n      ({ topic, payload }: { topic: string; payload: unknown }) => {\n        this._subHandlers.get(topic)?.forEach((h) => h(payload));\n      },\n    );\n\n    // Python calls a browser-side serve handler\n    socket.on(\n      \"serve_call\",\n      async ({\n        id,\n        topic,\n        payload,\n      }: {\n        id: string;\n        topic: string;\n        payload: unknown;\n      }) => {\n        const handler = this._serveHandlers.get(topic);\n        const result = handler ? await handler(payload) : undefined;\n        socket.emit(\"serve_reply\", { id, payload: result });\n      },\n    );\n  }\n\n  static connect(url: string, pluginId: string): Promise<RbWs> {\n    return new Promise((resolve, reject) => {\n      const socket = io(url, { transports: [\"websocket\"] });\n      const onConnect = () => {\n        cleanup();\n        resolve(new RbWs(socket, pluginId));\n      };\n      const onError = (err: Error) => {\n        cleanup();\n        reject(err);\n      };\n      const cleanup = () => {\n        socket.off(\"connect\", onConnect);\n        socket.off(\"connect_error\", onError);\n      };\n      socket.once(\"connect\", onConnect);\n      socket.once(\"connect_error\", onError);\n    });\n  }\n\n  private _key(topic: string): string {\n    return resolveTopic(this._pluginId, topic);\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  async pub<P = any>(topic: string, payload: P): Promise<void> {\n    this._socket.emit(\"pub\", { topic: this._key(topic), payload });\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  async sub<P = any>(\n    topic: string,\n    handler: (payload: P) => void,\n  ): Promise<WsSubscriber> {\n    const key = this._key(topic);\n    if (!this._subHandlers.has(key)) {\n      this._subHandlers.set(key, new Set());\n      this._socket.emit(\"sub\", { topic: key });\n    }\n    const h = handler as (payload: unknown) => void;\n    this._subHandlers.get(key)!.add(h);\n    return {\n      undeclare: () => {\n        const set = this._subHandlers.get(key);\n        if (!set) return;\n        set.delete(h);\n        if (set.size === 0) {\n          this._subHandlers.delete(key);\n          this._socket.emit(\"unsub\", { topic: key });\n        }\n      },\n    };\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  async action<R = any, P = any>(topic: string, payload?: P): Promise<R> {\n    const key = this._key(topic);\n    return new Promise((resolve, reject) => {\n      this._socket\n        .timeout(10_000)\n        .emit(\n          \"action\",\n          { topic: key, payload },\n          (err: Error | null, result: R) => {\n            if (err) {\n              // socket.io ack timeout \u2014 the bridge itself never answered.\n              reject(new Error(`action \"${key}\": no ack from bridge (${err.message})`));\n            } else if (\n              result &&\n              typeof result === \"object\" &&\n              \"error\" in result &&\n              typeof result.error === \"string\"\n            ) {\n              // Backend handler returned an error payload \u2014 surface it verbatim.\n              reject(new Error(result.error));\n            } else if (result === undefined || result === null) {\n              // The bridge acked but with no payload: the backend handler is\n              // registered yet didn't reply in time (hung inside the handler,\n              // e.g. a blocked SDK call) or returned nothing. Distinct from a\n              // \"No handler registered\" error, which comes back as result.error.\n              reject(\n                new Error(\n                  `action \"${key}\": no reply from plugin backend \u2014 the handler was reached but didn't return in time (check the backend's stdout on the robot).`,\n                ),\n              );\n            } else {\n              resolve(result);\n            }\n          },\n        );\n    });\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  async serve<P = any, R = any>(\n    topic: string,\n    handler: (payload?: P) => R | Promise<R>,\n  ): Promise<WsQueryable> {\n    const key = this._key(topic);\n    this._serveHandlers.set(key, handler as (payload?: unknown) => unknown);\n    this._socket.emit(\"serve_register\", { topic: key });\n    return {\n      undeclare: () => {\n        this._serveHandlers.delete(key);\n        this._socket.emit(\"serve_unregister\", { topic: key });\n      },\n    };\n  }\n\n  close(): void {\n    this._socket.disconnect();\n  }\n}\n\n/**\n * Builds an rb-sdk-shaped object (pub/sub/action/serve + the passed-through\n * toast/alert/confirm/prompt) that lazily awaits a not-yet-connected `RbWs` \u2014\n * so callers don't block their first render on the WebSocket handshake (there\n * may be no backend reachable yet). Shared by both host mount paths (see\n * ./host.tsx and muscat-plugin-kit's dev bootstrap), which otherwise\n * duplicate this wiring.\n */\nexport function createLazyRbSdk(\n  wsPromise: Promise<RbWs>,\n  services: PluginUIServices,\n  // Per-mount, host-provided (unlike `services`, which is a global singleton):\n  // initial `data` and the `onSave` registration the host reads back. Plain\n  // values/closures, so they cross the dev React-instance boundary safely.\n  mount?: {\n    data?: unknown;\n    onSave?: (getPayload: () => unknown) => () => void;\n  },\n) {\n  return {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    pub: async (topic: string, payload: any) =>\n      (await wsPromise).pub(topic, payload),\n    sub: async (\n      topic: string,\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      handler: (payload: any) => void,\n    ) => (await wsPromise).sub(topic, handler),\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    action: async (topic: string, payload?: any) =>\n      (await wsPromise).action(topic, payload),\n    serve: async (\n      topic: string,\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      handler: (payload?: any) => any,\n    ) => (await wsPromise).serve(topic, handler),\n    toast: services.toast,\n    alert: services.alert,\n    confirm: services.confirm,\n    prompt: services.prompt,\n    data: mount?.data,\n    onSave: mount?.onSave ?? (() => () => {}),\n  };\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * Socket.IO communication client for plugin frontends.\n *\n * Topics are automatically namespaced to prevent cross-plugin collisions:\n *   \"sensor/data\"  \u2192  \"{pluginId}/sensor/data\"\n *   \"/broadcast/x\" \u2192  \"broadcast/x\"   (leading slash = absolute)\n *\n * Browser \u2190\u2192 Python backend protocol:\n *   browser emits : sub, unsub, pub, action (with ack), serve_reply\n *   server emits  : msg, serve_call\n */\nimport { io, type Socket } from \"socket.io-client\";\n// Type-only \u2014 no runtime coupling to host-ui.ts.\nimport type { PluginUIServices } from \"./host-ui\";\n\nexport interface WsHandle {\n  undeclare(): void;\n}\n\nexport type WsSubscriber = WsHandle;\nexport type WsQueryable = WsHandle;\n\nfunction resolveTopic(pluginId: string, topic: string): string {\n  return topic.startsWith(\"/\") ? topic.slice(1) : `${pluginId}/${topic}`;\n}\n\nexport class RbWs {\n  private readonly _socket: Socket;\n  private readonly _pluginId: string;\n  private readonly _subHandlers = new Map<\n    string,\n    Set<(payload: unknown) => void>\n  >();\n  private readonly _serveHandlers = new Map<\n    string,\n    (payload?: unknown) => unknown | Promise<unknown>\n  >();\n\n  private constructor(socket: Socket, pluginId: string) {\n    this._socket = socket;\n    this._pluginId = pluginId;\n\n    // The gateway keeps subscriptions/serve registrations in memory \u2014 re-send them after\n    // a reconnect (e.g. the gateway restarted), or they silently stop working.\n    socket.io.on(\"reconnect\", () => {\n      for (const topic of this._subHandlers.keys()) socket.emit(\"sub\", { topic });\n      for (const topic of this._serveHandlers.keys()) socket.emit(\"serve_register\", { topic });\n    });\n\n    // Deliver incoming pub/sub messages to registered handlers\n    socket.on(\n      \"msg\",\n      ({ topic, payload }: { topic: string; payload: unknown }) => {\n        this._subHandlers.get(topic)?.forEach((h) => h(payload));\n      },\n    );\n\n    // Python calls a browser-side serve handler\n    socket.on(\n      \"serve_call\",\n      async ({\n        id,\n        topic,\n        payload,\n      }: {\n        id: string;\n        topic: string;\n        payload: unknown;\n      }) => {\n        const handler = this._serveHandlers.get(topic);\n        const result = handler ? await handler(payload) : undefined;\n        socket.emit(\"serve_reply\", { id, payload: result });\n      },\n    );\n  }\n\n  get pluginId(): string {\n    return this._pluginId;\n  }\n\n  static connect(url: string, pluginId: string): Promise<RbWs> {\n    return new Promise((resolve, reject) => {\n      const socket = io(url, { transports: [\"websocket\"] });\n      const onConnect = () => {\n        cleanup();\n        resolve(new RbWs(socket, pluginId));\n      };\n      const onError = (err: Error) => {\n        cleanup();\n        reject(err);\n      };\n      const cleanup = () => {\n        socket.off(\"connect\", onConnect);\n        socket.off(\"connect_error\", onError);\n      };\n      socket.once(\"connect\", onConnect);\n      socket.once(\"connect_error\", onError);\n    });\n  }\n\n  private _key(topic: string): string {\n    return resolveTopic(this._pluginId, topic);\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  async pub<P = any>(topic: string, payload: P): Promise<void> {\n    this._socket.emit(\"pub\", { topic: this._key(topic), payload });\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  async sub<P = any>(\n    topic: string,\n    handler: (payload: P) => void,\n  ): Promise<WsSubscriber> {\n    const key = this._key(topic);\n    if (!this._subHandlers.has(key)) {\n      this._subHandlers.set(key, new Set());\n      this._socket.emit(\"sub\", { topic: key });\n    }\n    const h = handler as (payload: unknown) => void;\n    this._subHandlers.get(key)!.add(h);\n    return {\n      undeclare: () => {\n        const set = this._subHandlers.get(key);\n        if (!set) return;\n        set.delete(h);\n        if (set.size === 0) {\n          this._subHandlers.delete(key);\n          this._socket.emit(\"unsub\", { topic: key });\n        }\n      },\n    };\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  async action<R = any, P = any>(topic: string, payload?: P): Promise<R> {\n    const key = this._key(topic);\n    return new Promise((resolve, reject) => {\n      this._socket\n        .timeout(10_000)\n        .emit(\n          \"action\",\n          { topic: key, payload },\n          (err: Error | null, result: R) => {\n            if (err) {\n              // socket.io ack timeout \u2014 the bridge itself never answered.\n              reject(new Error(`action \"${key}\": no ack from bridge (${err.message})`));\n            } else if (\n              result &&\n              typeof result === \"object\" &&\n              \"error\" in result &&\n              typeof result.error === \"string\"\n            ) {\n              // Backend handler returned an error payload \u2014 surface it verbatim.\n              reject(new Error(result.error));\n            } else if (result === undefined || result === null) {\n              // The bridge acked but with no payload: the backend handler is\n              // registered yet didn't reply in time (hung inside the handler,\n              // e.g. a blocked SDK call) or returned nothing. Distinct from a\n              // \"No handler registered\" error, which comes back as result.error.\n              reject(\n                new Error(\n                  `action \"${key}\": no reply from plugin backend \u2014 the handler was reached but didn't return in time (check the backend's stdout on the robot).`,\n                ),\n              );\n            } else {\n              resolve(result);\n            }\n          },\n        );\n    });\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  async serve<P = any, R = any>(\n    topic: string,\n    handler: (payload?: P) => R | Promise<R>,\n  ): Promise<WsQueryable> {\n    const key = this._key(topic);\n    this._serveHandlers.set(key, handler as (payload?: unknown) => unknown);\n    this._socket.emit(\"serve_register\", { topic: key });\n    return {\n      undeclare: () => {\n        this._serveHandlers.delete(key);\n        this._socket.emit(\"serve_unregister\", { topic: key });\n      },\n    };\n  }\n\n  close(): void {\n    this._socket.disconnect();\n  }\n}\n\n/**\n * Builds an rb-sdk-shaped object (pub/sub/action/serve + the passed-through\n * toast/alert/confirm/prompt) that lazily awaits a not-yet-connected `RbWs` \u2014\n * so callers don't block their first render on the WebSocket handshake (there\n * may be no backend reachable yet). Shared by both host mount paths (see\n * ./host.tsx and muscat-plugin-kit's dev bootstrap), which otherwise\n * duplicate this wiring.\n */\nexport function createLazyRbSdk(\n  wsPromise: Promise<RbWs>,\n  services: PluginUIServices,\n  // Per-mount, host-provided (unlike `services`, which is a global singleton):\n  // initial `data` and the `onSave` registration the host reads back. Plain\n  // values/closures, so they cross the dev React-instance boundary safely.\n  mount?: {\n    data?: unknown;\n    onSave?: (getPayload: () => unknown) => () => void;\n  },\n) {\n  return {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    pub: async (topic: string, payload: any) =>\n      (await wsPromise).pub(topic, payload),\n    sub: async (\n      topic: string,\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      handler: (payload: any) => void,\n    ) => (await wsPromise).sub(topic, handler),\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    action: async (topic: string, payload?: any) =>\n      (await wsPromise).action(topic, payload),\n    serve: async (\n      topic: string,\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      handler: (payload?: any) => any,\n    ) => (await wsPromise).serve(topic, handler),\n    toast: services.toast,\n    alert: services.alert,\n    confirm: services.confirm,\n    prompt: services.prompt,\n    data: mount?.data,\n    onSave: mount?.onSave ?? (() => () => {}),\n    rosPeers: rosPeersApi(async (op, payload) => {\n      const ws = await wsPromise;\n      return ws.action(`/muscat/plugin/${ws.pluginId}/ros_peers/${op}`, payload);\n    }),\n  };\n}\n\n// Answered by Muscat (common) on the robot and by `muscat-pk dev` locally.\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nfunction rosPeersApi(call: (op: \"get\" | \"set\", payload?: any) => Promise<any>) {\n  return {\n    get: async (): Promise<string[]> => (await call(\"get\"))?.peers ?? [],\n    set: async (peers: string[]): Promise<string[]> => {\n      const r = await call(\"set\", { peers });\n      if (!r?.ok) throw new Error(r?.error ?? \"rb.rosPeers.set failed\");\n      return r.peers;\n    },\n  };\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rainbow-robotics/plugin-ui",
-  "version": "1.3.3",
+  "version": "1.3.5",
   "type": "module",
   "engines": {
     "node": ">=20"

package/src/manifest.ts

@@ -119,6 +119,8 @@ export function validateManifest(value: unknown): string[] {
   const m = value as Record<string, unknown>;
   if (typeof m.id !== "string" || m.id.length === 0)
     errors.push("manifest.id is required (string)");
+  else if (!/^[a-z][a-z0-9]*(-[a-z0-9]+)*(\.[a-z][a-z0-9]*(-[a-z0-9]+)*)*$/.test(m.id))
+    errors.push('manifest.id must be "."-separated parts of lowercase letters/digits and single "-", each starting with a letter (e.g. com.example.my-plugin)');
   if (typeof m.name !== "string" || m.name.length === 0)
     errors.push("manifest.name is required (string)");
   if (typeof m.version !== "string" || m.version.length === 0)

package/src/sdk.ts

@@ -70,6 +70,17 @@ export interface RbSdk {
    * unregister fn. Prefer the `useRbSave()` hook.
    */
   onSave: (getPayload: () => unknown) => () => void;
+
+  /**
+   * PCs allowed to talk to this plugin's ROS 2 nodes. ROS discovery is robot-local
+   * (ROS_AUTOMATIC_DISCOVERY_RANGE=LOCALHOST); Muscat keeps this list per plugin, starts
+   * the plugin with ROS_STATIC_PEERS set to it, and restarts the plugin when it changes.
+   */
+  rosPeers: {
+    get: () => Promise<string[]>;
+    /** Saves the list and restarts the plugin backend. Rejects on an invalid IP. */
+    set: (peers: string[]) => Promise<string[]>;
+  };
 }
 
 const noopSdk: RbSdk = {
@@ -107,6 +118,16 @@ const noopSdk: RbSdk = {
   },
   data: undefined,
   onSave: () => () => {},
+  rosPeers: {
+    get: async () => {
+      console.warn("[plugin-ui] rb.rosPeers called outside of a host context");
+      return [];
+    },
+    set: async () => {
+      console.warn("[plugin-ui] rb.rosPeers called outside of a host context");
+      return [];
+    },
+  },
 };
 
 export const RbContext = createContext<RbSdk>(noopSdk);

package/src/ws.ts

@@ -40,6 +40,13 @@ export class RbWs {
     this._socket = socket;
     this._pluginId = pluginId;
 
+    // The gateway keeps subscriptions/serve registrations in memory — re-send them after
+    // a reconnect (e.g. the gateway restarted), or they silently stop working.
+    socket.io.on("reconnect", () => {
+      for (const topic of this._subHandlers.keys()) socket.emit("sub", { topic });
+      for (const topic of this._serveHandlers.keys()) socket.emit("serve_register", { topic });
+    });
+
     // Deliver incoming pub/sub messages to registered handlers
     socket.on(
       "msg",
@@ -67,6 +74,10 @@ export class RbWs {
     );
   }
 
+  get pluginId(): string {
+    return this._pluginId;
+  }
+
   static connect(url: string, pluginId: string): Promise<RbWs> {
     return new Promise((resolve, reject) => {
       const socket = io(url, { transports: ["websocket"] });
@@ -223,5 +234,22 @@ export function createLazyRbSdk(
     prompt: services.prompt,
     data: mount?.data,
     onSave: mount?.onSave ?? (() => () => {}),
+    rosPeers: rosPeersApi(async (op, payload) => {
+      const ws = await wsPromise;
+      return ws.action(`/muscat/plugin/${ws.pluginId}/ros_peers/${op}`, payload);
+    }),
+  };
+}
+
+// Answered by Muscat (common) on the robot and by `muscat-pk dev` locally.
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function rosPeersApi(call: (op: "get" | "set", payload?: any) => Promise<any>) {
+  return {
+    get: async (): Promise<string[]> => (await call("get"))?.peers ?? [],
+    set: async (peers: string[]): Promise<string[]> => {
+      const r = await call("set", { peers });
+      if (!r?.ok) throw new Error(r?.error ?? "rb.rosPeers.set failed");
+      return r.peers;
+    },
   };
 }