desktop

Create a controller class extending ControllerModule with a static groupName and methods decorated with @IpcMethod, then register it in the controllers registry. Define matching TypeScript types in the electron-client-ipc package and expose a renderer service via ensureElectronIpc.

Define a tool manifest with API names and JSON parameters, add IPC types, implement a store action handling loading and error states, create a renderer service, and write a main-process controller using fs operations. Finally document the tool in the agent's system role.

Save the window's position and size on the close event when it is neither minimized nor maximized, storing bounds in a settings store. On startup, restore those bounds with setBounds before showing the window.

Enable contextIsolation, disable nodeIntegration, and load a preload script to expose only validated APIs to the renderer. Validate all IPC inputs in main-process controllers and limit the surface of exposed methods.

Build menu templates with Menu.buildFromTemplate using roles like copy and paste for native behavior, then attach them via tray.setContextMenu or menu.popup for right-click menus. Use CmdOrCtrl accelerators and handle platform differences with process.platform checks.