@jdg-keyforge/protocol 0.11.0 → 0.12.1

package/dist/common.d.ts

@@ -24,6 +24,17 @@ export type InputKind = "key" | "encoder";
  * via the `definition` "InputAction".
  */
 export type InputAction = "press" | "release" | "rotate_cw" | "rotate_ccw" | "click";
+/**
+ * RGB color as a '#RRGGBB' hex string. Accepted in any case; the daemon stores and returns it lowercase, so clients can compare colors as strings. '#000000' turns the LED off. Hardware-agnostic: the daemon translates it to whatever the device understands (e.g. switching the device to a per-key lighting mode first).
+ *
+ * This interface was referenced by `CommonTypes`'s JSON-Schema
+ * via the `definition` "Color".
+ */
+export type Color = string;
+/**
+ * RGB color as a '#RRGGBB' hex string. Accepted in any case; the daemon stores and returns it lowercase, so clients can compare colors as strings. '#000000' turns the LED off. Hardware-agnostic: the daemon translates it to whatever the device understands (e.g. switching the device to a per-key lighting mode first).
+ */
+export type Color1 = string;
 /**
  * Globally unique plugin identifier in reverse-DNS form (e.g. 'dev.jonidg.spotify'). Lowercase, at least two dot-separated segments, each starting with a letter. Used as the install folder name and as <plugin_id> in Action.type.
  *
@@ -163,6 +174,24 @@ export interface Profile {
      * Bindings that belong to this profile.
      */
     bindings: Binding[];
+    /**
+     * LED colors this profile paints on RGB-capable inputs, applied by the daemon whenever the profile becomes active. An RGB input with no entry here is turned off. At most one entry per (device_id, input_id); the daemon enforces uniqueness. Absent means no colors.
+     */
+    colors?: InputColor[];
+}
+/**
+ * LED color assigned to one input of a device.
+ *
+ * This interface was referenced by `CommonTypes`'s JSON-Schema
+ * via the `definition` "InputColor".
+ */
+export interface InputColor {
+    device_id: DeviceID;
+    /**
+     * Logical identifier of the input within the device. Matches Device.inputs[].id.
+     */
+    input_id: string;
+    color: Color;
 }
 /**
  * Portable, on-disk representation of a profile, written by export_profile and read by import_profile. Carries no server-local id: the id is meaningless outside the originating installation, so import always assigns a fresh one. The 'version' field lets readers detect and adapt to format changes.
@@ -187,6 +216,10 @@ export interface ExportedProfile {
      * Bindings that belong to the exported profile.
      */
     bindings: Binding[];
+    /**
+     * LED colors of the exported profile. Same semantics as Profile.colors.
+     */
+    colors?: InputColor[];
 }
 /**
  * A single physical input exposed by a device (a key or an encoder).
@@ -204,6 +237,11 @@ export interface Input {
      * Human-friendly label for the input (e.g. 'Key 1', 'Encoder'). Optional; clients fall back to id.
      */
     label?: string;
+    /**
+     * Whether the input has an RGB LED the daemon can drive through set_input_color. Absent means false.
+     */
+    rgb?: boolean;
+    color?: Color1;
 }
 /**
  * A HID device known to the daemon. Returned by list_devices.
@@ -254,7 +292,7 @@ export interface AutoSwitchRule {
      */
     app: string;
     /**
-     * Identifier of the profile to activate when this app is frontmost.
+     * Identifier of the profile to activate when this app is frontmost. Must reference an existing profile: set_auto_switch rejects unknown ids with PROFILE_NOT_FOUND, and delete_profile removes the rules pointing to the deleted profile.
      */
     profile_id: string;
 }

package/dist/index.d.ts

@@ -18,6 +18,7 @@ export type { MethodRenameProfile } from './methods/rename_profile.js';
 export type { MethodSetActiveProfile } from './methods/set_active_profile.js';
 export type { MethodSetAutoSwitch } from './methods/set_auto_switch.js';
 export type { MethodSetBinding } from './methods/set_binding.js';
+export type { MethodSetInputColor } from './methods/set_input_color.js';
 export type { MethodUninstallPlugin } from './methods/uninstall_plugin.js';
 export type { EventActionInvoked } from './events/action_invoked.js';
 export type { EventActiveProfileChanged } from './events/active_profile_changed.js';

package/dist/methods/create_profile.d.ts

@@ -11,6 +11,10 @@ export type DeviceID = string;
  * What happened on the input.
  */
 export type InputAction = "press" | "release" | "rotate_cw" | "rotate_ccw" | "click";
+/**
+ * RGB color as a '#RRGGBB' hex string. Accepted in any case; the daemon stores and returns it lowercase, so clients can compare colors as strings. '#000000' turns the LED off. Hardware-agnostic: the daemon translates it to whatever the device understands (e.g. switching the device to a per-key lighting mode first).
+ */
+export type Color = string;
 /**
  * Creates a new profile. The server generates the id and returns the profile with an empty bindings array.
  */
@@ -41,6 +45,10 @@ export interface Profile {
      * Bindings that belong to this profile.
      */
     bindings: Binding[];
+    /**
+     * LED colors this profile paints on RGB-capable inputs, applied by the daemon whenever the profile becomes active. An RGB input with no entry here is turned off. At most one entry per (device_id, input_id); the daemon enforces uniqueness. Absent means no colors.
+     */
+    colors?: InputColor[];
 }
 /**
  * Maps an input on a specific device to an action.
@@ -66,3 +74,14 @@ export interface Action {
         [k: string]: unknown;
     };
 }
+/**
+ * LED color assigned to one input of a device.
+ */
+export interface InputColor {
+    device_id: DeviceID;
+    /**
+     * Logical identifier of the input within the device. Matches Device.inputs[].id.
+     */
+    input_id: string;
+    color: Color;
+}

package/dist/methods/delete_profile.d.ts

@@ -4,7 +4,7 @@
  * and run json-schema-to-typescript to regenerate this file.
  */
 /**
- * Deletes a profile. The daemon never deletes the last remaining profile. Deleting the active profile reassigns the active one, so the resulting active profile id is always returned.
+ * Deletes a profile. The daemon never deletes the last remaining profile. Deleting the active profile reassigns the active one, so the resulting active profile id is always returned. Auto-switch rules whose profile_id points to the deleted profile are deleted with it, so the stored rule set never references a missing profile.
  */
 export interface MethodDeleteProfile {
     params: {

package/dist/methods/duplicate_profile.d.ts

@@ -11,6 +11,10 @@ export type DeviceID = string;
  * What happened on the input.
  */
 export type InputAction = "press" | "release" | "rotate_cw" | "rotate_ccw" | "click";
+/**
+ * RGB color as a '#RRGGBB' hex string. Accepted in any case; the daemon stores and returns it lowercase, so clients can compare colors as strings. '#000000' turns the LED off. Hardware-agnostic: the daemon translates it to whatever the device understands (e.g. switching the device to a per-key lighting mode first).
+ */
+export type Color = string;
 /**
  * Creates a copy of an existing profile under a new name. The server generates a new id and copies the source profile's bindings. Does not change the active profile.
  */
@@ -45,6 +49,10 @@ export interface Profile {
      * Bindings that belong to this profile.
      */
     bindings: Binding[];
+    /**
+     * LED colors this profile paints on RGB-capable inputs, applied by the daemon whenever the profile becomes active. An RGB input with no entry here is turned off. At most one entry per (device_id, input_id); the daemon enforces uniqueness. Absent means no colors.
+     */
+    colors?: InputColor[];
 }
 /**
  * Maps an input on a specific device to an action.
@@ -70,3 +78,14 @@ export interface Action {
         [k: string]: unknown;
     };
 }
+/**
+ * LED color assigned to one input of a device.
+ */
+export interface InputColor {
+    device_id: DeviceID;
+    /**
+     * Logical identifier of the input within the device. Matches Device.inputs[].id.
+     */
+    input_id: string;
+    color: Color;
+}

package/dist/methods/get_auto_switch.d.ts

@@ -31,7 +31,7 @@ export interface AutoSwitchRule {
      */
     app: string;
     /**
-     * Identifier of the profile to activate when this app is frontmost.
+     * Identifier of the profile to activate when this app is frontmost. Must reference an existing profile: set_auto_switch rejects unknown ids with PROFILE_NOT_FOUND, and delete_profile removes the rules pointing to the deleted profile.
      */
     profile_id: string;
 }

package/dist/methods/import_profile.d.ts

@@ -11,6 +11,10 @@ export type DeviceID = string;
  * What happened on the input.
  */
 export type InputAction = "press" | "release" | "rotate_cw" | "rotate_ccw" | "click";
+/**
+ * RGB color as a '#RRGGBB' hex string. Accepted in any case; the daemon stores and returns it lowercase, so clients can compare colors as strings. '#000000' turns the LED off. Hardware-agnostic: the daemon translates it to whatever the device understands (e.g. switching the device to a per-key lighting mode first).
+ */
+export type Color = string;
 /**
  * Reads an ExportedProfile document from 'path' on the daemon host's filesystem, validates it, and creates a new profile from it. The server generates a fresh id; any id in the file is ignored. Does not change the active profile. Returns the created profile.
  */
@@ -41,6 +45,10 @@ export interface Profile {
      * Bindings that belong to this profile.
      */
     bindings: Binding[];
+    /**
+     * LED colors this profile paints on RGB-capable inputs, applied by the daemon whenever the profile becomes active. An RGB input with no entry here is turned off. At most one entry per (device_id, input_id); the daemon enforces uniqueness. Absent means no colors.
+     */
+    colors?: InputColor[];
 }
 /**
  * Maps an input on a specific device to an action.
@@ -66,3 +74,14 @@ export interface Action {
         [k: string]: unknown;
     };
 }
+/**
+ * LED color assigned to one input of a device.
+ */
+export interface InputColor {
+    device_id: DeviceID;
+    /**
+     * Logical identifier of the input within the device. Matches Device.inputs[].id.
+     */
+    input_id: string;
+    color: Color;
+}

package/dist/methods/list_devices.d.ts

@@ -11,6 +11,10 @@ export type DeviceID = string;
  * Kind of physical input.
  */
 export type InputKind = "key" | "encoder";
+/**
+ * Color the active profile paints on this input. Only set on RGB inputs that have a color in the active profile; absent means the LED is off.
+ */
+export type Color = string;
 /**
  * Returns the HID devices currently known to the daemon. No filters in v1; clients filter client-side if needed.
  */
@@ -73,4 +77,9 @@ export interface Input {
      * Human-friendly label for the input (e.g. 'Key 1', 'Encoder'). Optional; clients fall back to id.
      */
     label?: string;
+    /**
+     * Whether the input has an RGB LED the daemon can drive through set_input_color. Absent means false.
+     */
+    rgb?: boolean;
+    color?: Color;
 }

package/dist/methods/list_profiles.d.ts

@@ -11,6 +11,10 @@ export type DeviceID = string;
  * What happened on the input.
  */
 export type InputAction = "press" | "release" | "rotate_cw" | "rotate_ccw" | "click";
+/**
+ * RGB color as a '#RRGGBB' hex string. Accepted in any case; the daemon stores and returns it lowercase, so clients can compare colors as strings. '#000000' turns the LED off. Hardware-agnostic: the daemon translates it to whatever the device understands (e.g. switching the device to a per-key lighting mode first).
+ */
+export type Color = string;
 /**
  * Returns all profiles the daemon currently has, along with the id of the active one. The active profile id is tracked at the daemon level and only exposed here.
  */
@@ -46,6 +50,10 @@ export interface Profile {
      * Bindings that belong to this profile.
      */
     bindings: Binding[];
+    /**
+     * LED colors this profile paints on RGB-capable inputs, applied by the daemon whenever the profile becomes active. An RGB input with no entry here is turned off. At most one entry per (device_id, input_id); the daemon enforces uniqueness. Absent means no colors.
+     */
+    colors?: InputColor[];
 }
 /**
  * Maps an input on a specific device to an action.
@@ -71,3 +79,14 @@ export interface Action {
         [k: string]: unknown;
     };
 }
+/**
+ * LED color assigned to one input of a device.
+ */
+export interface InputColor {
+    device_id: DeviceID;
+    /**
+     * Logical identifier of the input within the device. Matches Device.inputs[].id.
+     */
+    input_id: string;
+    color: Color;
+}

package/dist/methods/set_auto_switch.d.ts

@@ -4,7 +4,7 @@
  * and run json-schema-to-typescript to regenerate this file.
  */
 /**
- * Replaces the entire auto-switch configuration in one shot (bulk set, not per-rule CRUD): the master toggle and the full rule set. The result echoes the persisted state.
+ * Replaces the entire auto-switch configuration in one shot (bulk set, not per-rule CRUD): the master toggle and the full rule set. The result echoes the persisted state. The daemon rejects the whole request with error code PROFILE_NOT_FOUND if any rule's profile_id does not exist; nothing is persisted in that case.
  */
 export interface MethodSetAutoSwitch {
     params: {
@@ -37,7 +37,7 @@ export interface AutoSwitchRule {
      */
     app: string;
     /**
-     * Identifier of the profile to activate when this app is frontmost.
+     * Identifier of the profile to activate when this app is frontmost. Must reference an existing profile: set_auto_switch rejects unknown ids with PROFILE_NOT_FOUND, and delete_profile removes the rules pointing to the deleted profile.
      */
     profile_id: string;
 }

package/dist/methods/set_input_color.d.ts

@@ -0,0 +1,30 @@
+/**
+ * This file was automatically generated by json-schema-to-typescript.
+ * DO NOT MODIFY IT BY HAND. Instead, modify the source JSONSchema file,
+ * and run json-schema-to-typescript to regenerate this file.
+ */
+/**
+ * Stable identifier for a HID device. Format: VID_<hex>_PID_<hex>[_<serial>].
+ */
+export type DeviceID = string;
+/**
+ * RGB color as a '#RRGGBB' hex string. Accepted in any case; the daemon stores and returns it lowercase, so clients can compare colors as strings. '#000000' turns the LED off. Hardware-agnostic: the daemon translates it to whatever the device understands (e.g. switching the device to a per-key lighting mode first).
+ */
+export type Color = string;
+/**
+ * Sets the LED color of an RGB-capable input in the active profile and paints it on the device. The pair (device_id, input_id) is the unique key; calling this method again replaces the previous color, and '#000000' turns the LED off. Colors belong to the profile: switching profiles repaints every RGB input with the new profile's colors. The daemon rejects inputs that are unknown or have no RGB LED (Input.rgb is not true).
+ */
+export interface MethodSetInputColor {
+    params: {
+        device_id: DeviceID;
+        /**
+         * Logical identifier of the input within the device. Matches Device.inputs[].id.
+         */
+        input_id: string;
+        color: Color;
+    };
+    /**
+     * Empty acknowledgement object.
+     */
+    result: {};
+}

package/dist/methods/set_input_color.js

@@ -0,0 +1,7 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated by json-schema-to-typescript.
+ * DO NOT MODIFY IT BY HAND. Instead, modify the source JSONSchema file,
+ * and run json-schema-to-typescript to regenerate this file.
+ */
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jdg-keyforge/protocol",
-  "version": "0.11.0",
+  "version": "0.12.1",
   "description": "TypeScript types for the KeyForge WebSocket protocol, generated from the canonical JSON Schema contracts.",
   "keywords": ["keyforge", "protocol", "types", "json-schema", "websocket"],
   "license": "Apache-2.0",

package/src/common.ts

@@ -26,6 +26,17 @@ export type InputKind = "key" | "encoder";
  * via the `definition` "InputAction".
  */
 export type InputAction = "press" | "release" | "rotate_cw" | "rotate_ccw" | "click";
+/**
+ * RGB color as a '#RRGGBB' hex string. Accepted in any case; the daemon stores and returns it lowercase, so clients can compare colors as strings. '#000000' turns the LED off. Hardware-agnostic: the daemon translates it to whatever the device understands (e.g. switching the device to a per-key lighting mode first).
+ *
+ * This interface was referenced by `CommonTypes`'s JSON-Schema
+ * via the `definition` "Color".
+ */
+export type Color = string;
+/**
+ * RGB color as a '#RRGGBB' hex string. Accepted in any case; the daemon stores and returns it lowercase, so clients can compare colors as strings. '#000000' turns the LED off. Hardware-agnostic: the daemon translates it to whatever the device understands (e.g. switching the device to a per-key lighting mode first).
+ */
+export type Color1 = string;
 /**
  * Globally unique plugin identifier in reverse-DNS form (e.g. 'dev.jonidg.spotify'). Lowercase, at least two dot-separated segments, each starting with a letter. Used as the install folder name and as <plugin_id> in Action.type.
  *
@@ -166,6 +177,24 @@ export interface Profile {
    * Bindings that belong to this profile.
    */
   bindings: Binding[];
+  /**
+   * LED colors this profile paints on RGB-capable inputs, applied by the daemon whenever the profile becomes active. An RGB input with no entry here is turned off. At most one entry per (device_id, input_id); the daemon enforces uniqueness. Absent means no colors.
+   */
+  colors?: InputColor[];
+}
+/**
+ * LED color assigned to one input of a device.
+ *
+ * This interface was referenced by `CommonTypes`'s JSON-Schema
+ * via the `definition` "InputColor".
+ */
+export interface InputColor {
+  device_id: DeviceID;
+  /**
+   * Logical identifier of the input within the device. Matches Device.inputs[].id.
+   */
+  input_id: string;
+  color: Color;
 }
 /**
  * Portable, on-disk representation of a profile, written by export_profile and read by import_profile. Carries no server-local id: the id is meaningless outside the originating installation, so import always assigns a fresh one. The 'version' field lets readers detect and adapt to format changes.
@@ -190,6 +219,10 @@ export interface ExportedProfile {
    * Bindings that belong to the exported profile.
    */
   bindings: Binding[];
+  /**
+   * LED colors of the exported profile. Same semantics as Profile.colors.
+   */
+  colors?: InputColor[];
 }
 /**
  * A single physical input exposed by a device (a key or an encoder).
@@ -207,6 +240,11 @@ export interface Input {
    * Human-friendly label for the input (e.g. 'Key 1', 'Encoder'). Optional; clients fall back to id.
    */
   label?: string;
+  /**
+   * Whether the input has an RGB LED the daemon can drive through set_input_color. Absent means false.
+   */
+  rgb?: boolean;
+  color?: Color1;
 }
 /**
  * A HID device known to the daemon. Returned by list_devices.
@@ -257,7 +295,7 @@ export interface AutoSwitchRule {
    */
   app: string;
   /**
-   * Identifier of the profile to activate when this app is frontmost.
+   * Identifier of the profile to activate when this app is frontmost. Must reference an existing profile: set_auto_switch rejects unknown ids with PROFILE_NOT_FOUND, and delete_profile removes the rules pointing to the deleted profile.
    */
   profile_id: string;
 }

package/src/index.ts

@@ -21,6 +21,7 @@ export type { MethodRenameProfile } from './methods/rename_profile.js';
 export type { MethodSetActiveProfile } from './methods/set_active_profile.js';
 export type { MethodSetAutoSwitch } from './methods/set_auto_switch.js';
 export type { MethodSetBinding } from './methods/set_binding.js';
+export type { MethodSetInputColor } from './methods/set_input_color.js';
 export type { MethodUninstallPlugin } from './methods/uninstall_plugin.js';
 
 export type { EventActionInvoked } from './events/action_invoked.js';

package/src/methods/create_profile.ts

@@ -13,6 +13,10 @@ export type DeviceID = string;
  * What happened on the input.
  */
 export type InputAction = "press" | "release" | "rotate_cw" | "rotate_ccw" | "click";
+/**
+ * RGB color as a '#RRGGBB' hex string. Accepted in any case; the daemon stores and returns it lowercase, so clients can compare colors as strings. '#000000' turns the LED off. Hardware-agnostic: the daemon translates it to whatever the device understands (e.g. switching the device to a per-key lighting mode first).
+ */
+export type Color = string;
 
 /**
  * Creates a new profile. The server generates the id and returns the profile with an empty bindings array.
@@ -44,6 +48,10 @@ export interface Profile {
    * Bindings that belong to this profile.
    */
   bindings: Binding[];
+  /**
+   * LED colors this profile paints on RGB-capable inputs, applied by the daemon whenever the profile becomes active. An RGB input with no entry here is turned off. At most one entry per (device_id, input_id); the daemon enforces uniqueness. Absent means no colors.
+   */
+  colors?: InputColor[];
 }
 /**
  * Maps an input on a specific device to an action.
@@ -69,3 +77,14 @@ export interface Action {
     [k: string]: unknown;
   };
 }
+/**
+ * LED color assigned to one input of a device.
+ */
+export interface InputColor {
+  device_id: DeviceID;
+  /**
+   * Logical identifier of the input within the device. Matches Device.inputs[].id.
+   */
+  input_id: string;
+  color: Color;
+}

package/src/methods/delete_profile.ts

@@ -6,7 +6,7 @@
  */
 
 /**
- * Deletes a profile. The daemon never deletes the last remaining profile. Deleting the active profile reassigns the active one, so the resulting active profile id is always returned.
+ * Deletes a profile. The daemon never deletes the last remaining profile. Deleting the active profile reassigns the active one, so the resulting active profile id is always returned. Auto-switch rules whose profile_id points to the deleted profile are deleted with it, so the stored rule set never references a missing profile.
  */
 export interface MethodDeleteProfile {
   params: {

package/src/methods/duplicate_profile.ts

@@ -13,6 +13,10 @@ export type DeviceID = string;
  * What happened on the input.
  */
 export type InputAction = "press" | "release" | "rotate_cw" | "rotate_ccw" | "click";
+/**
+ * RGB color as a '#RRGGBB' hex string. Accepted in any case; the daemon stores and returns it lowercase, so clients can compare colors as strings. '#000000' turns the LED off. Hardware-agnostic: the daemon translates it to whatever the device understands (e.g. switching the device to a per-key lighting mode first).
+ */
+export type Color = string;
 
 /**
  * Creates a copy of an existing profile under a new name. The server generates a new id and copies the source profile's bindings. Does not change the active profile.
@@ -48,6 +52,10 @@ export interface Profile {
    * Bindings that belong to this profile.
    */
   bindings: Binding[];
+  /**
+   * LED colors this profile paints on RGB-capable inputs, applied by the daemon whenever the profile becomes active. An RGB input with no entry here is turned off. At most one entry per (device_id, input_id); the daemon enforces uniqueness. Absent means no colors.
+   */
+  colors?: InputColor[];
 }
 /**
  * Maps an input on a specific device to an action.
@@ -73,3 +81,14 @@ export interface Action {
     [k: string]: unknown;
   };
 }
+/**
+ * LED color assigned to one input of a device.
+ */
+export interface InputColor {
+  device_id: DeviceID;
+  /**
+   * Logical identifier of the input within the device. Matches Device.inputs[].id.
+   */
+  input_id: string;
+  color: Color;
+}

package/src/methods/get_auto_switch.ts

@@ -33,7 +33,7 @@ export interface AutoSwitchRule {
    */
   app: string;
   /**
-   * Identifier of the profile to activate when this app is frontmost.
+   * Identifier of the profile to activate when this app is frontmost. Must reference an existing profile: set_auto_switch rejects unknown ids with PROFILE_NOT_FOUND, and delete_profile removes the rules pointing to the deleted profile.
    */
   profile_id: string;
 }

package/src/methods/import_profile.ts

@@ -13,6 +13,10 @@ export type DeviceID = string;
  * What happened on the input.
  */
 export type InputAction = "press" | "release" | "rotate_cw" | "rotate_ccw" | "click";
+/**
+ * RGB color as a '#RRGGBB' hex string. Accepted in any case; the daemon stores and returns it lowercase, so clients can compare colors as strings. '#000000' turns the LED off. Hardware-agnostic: the daemon translates it to whatever the device understands (e.g. switching the device to a per-key lighting mode first).
+ */
+export type Color = string;
 
 /**
  * Reads an ExportedProfile document from 'path' on the daemon host's filesystem, validates it, and creates a new profile from it. The server generates a fresh id; any id in the file is ignored. Does not change the active profile. Returns the created profile.
@@ -44,6 +48,10 @@ export interface Profile {
    * Bindings that belong to this profile.
    */
   bindings: Binding[];
+  /**
+   * LED colors this profile paints on RGB-capable inputs, applied by the daemon whenever the profile becomes active. An RGB input with no entry here is turned off. At most one entry per (device_id, input_id); the daemon enforces uniqueness. Absent means no colors.
+   */
+  colors?: InputColor[];
 }
 /**
  * Maps an input on a specific device to an action.
@@ -69,3 +77,14 @@ export interface Action {
     [k: string]: unknown;
   };
 }
+/**
+ * LED color assigned to one input of a device.
+ */
+export interface InputColor {
+  device_id: DeviceID;
+  /**
+   * Logical identifier of the input within the device. Matches Device.inputs[].id.
+   */
+  input_id: string;
+  color: Color;
+}

package/src/methods/list_devices.ts

@@ -13,6 +13,10 @@ export type DeviceID = string;
  * Kind of physical input.
  */
 export type InputKind = "key" | "encoder";
+/**
+ * Color the active profile paints on this input. Only set on RGB inputs that have a color in the active profile; absent means the LED is off.
+ */
+export type Color = string;
 
 /**
  * Returns the HID devices currently known to the daemon. No filters in v1; clients filter client-side if needed.
@@ -76,4 +80,9 @@ export interface Input {
    * Human-friendly label for the input (e.g. 'Key 1', 'Encoder'). Optional; clients fall back to id.
    */
   label?: string;
+  /**
+   * Whether the input has an RGB LED the daemon can drive through set_input_color. Absent means false.
+   */
+  rgb?: boolean;
+  color?: Color;
 }

package/src/methods/list_profiles.ts

@@ -13,6 +13,10 @@ export type DeviceID = string;
  * What happened on the input.
  */
 export type InputAction = "press" | "release" | "rotate_cw" | "rotate_ccw" | "click";
+/**
+ * RGB color as a '#RRGGBB' hex string. Accepted in any case; the daemon stores and returns it lowercase, so clients can compare colors as strings. '#000000' turns the LED off. Hardware-agnostic: the daemon translates it to whatever the device understands (e.g. switching the device to a per-key lighting mode first).
+ */
+export type Color = string;
 
 /**
  * Returns all profiles the daemon currently has, along with the id of the active one. The active profile id is tracked at the daemon level and only exposed here.
@@ -49,6 +53,10 @@ export interface Profile {
    * Bindings that belong to this profile.
    */
   bindings: Binding[];
+  /**
+   * LED colors this profile paints on RGB-capable inputs, applied by the daemon whenever the profile becomes active. An RGB input with no entry here is turned off. At most one entry per (device_id, input_id); the daemon enforces uniqueness. Absent means no colors.
+   */
+  colors?: InputColor[];
 }
 /**
  * Maps an input on a specific device to an action.
@@ -74,3 +82,14 @@ export interface Action {
     [k: string]: unknown;
   };
 }
+/**
+ * LED color assigned to one input of a device.
+ */
+export interface InputColor {
+  device_id: DeviceID;
+  /**
+   * Logical identifier of the input within the device. Matches Device.inputs[].id.
+   */
+  input_id: string;
+  color: Color;
+}

package/src/methods/set_auto_switch.ts

@@ -6,7 +6,7 @@
  */
 
 /**
- * Replaces the entire auto-switch configuration in one shot (bulk set, not per-rule CRUD): the master toggle and the full rule set. The result echoes the persisted state.
+ * Replaces the entire auto-switch configuration in one shot (bulk set, not per-rule CRUD): the master toggle and the full rule set. The result echoes the persisted state. The daemon rejects the whole request with error code PROFILE_NOT_FOUND if any rule's profile_id does not exist; nothing is persisted in that case.
  */
 export interface MethodSetAutoSwitch {
   params: {
@@ -39,7 +39,7 @@ export interface AutoSwitchRule {
    */
   app: string;
   /**
-   * Identifier of the profile to activate when this app is frontmost.
+   * Identifier of the profile to activate when this app is frontmost. Must reference an existing profile: set_auto_switch rejects unknown ids with PROFILE_NOT_FOUND, and delete_profile removes the rules pointing to the deleted profile.
    */
   profile_id: string;
 }

package/src/methods/set_input_color.ts

@@ -0,0 +1,33 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated by json-schema-to-typescript.
+ * DO NOT MODIFY IT BY HAND. Instead, modify the source JSONSchema file,
+ * and run json-schema-to-typescript to regenerate this file.
+ */
+
+/**
+ * Stable identifier for a HID device. Format: VID_<hex>_PID_<hex>[_<serial>].
+ */
+export type DeviceID = string;
+/**
+ * RGB color as a '#RRGGBB' hex string. Accepted in any case; the daemon stores and returns it lowercase, so clients can compare colors as strings. '#000000' turns the LED off. Hardware-agnostic: the daemon translates it to whatever the device understands (e.g. switching the device to a per-key lighting mode first).
+ */
+export type Color = string;
+
+/**
+ * Sets the LED color of an RGB-capable input in the active profile and paints it on the device. The pair (device_id, input_id) is the unique key; calling this method again replaces the previous color, and '#000000' turns the LED off. Colors belong to the profile: switching profiles repaints every RGB input with the new profile's colors. The daemon rejects inputs that are unknown or have no RGB LED (Input.rgb is not true).
+ */
+export interface MethodSetInputColor {
+  params: {
+    device_id: DeviceID;
+    /**
+     * Logical identifier of the input within the device. Matches Device.inputs[].id.
+     */
+    input_id: string;
+    color: Color;
+  };
+  /**
+   * Empty acknowledgement object.
+   */
+  result: {};
+}