@ai-matrx/desktop-protocol 0.21.16 → 0.21.18

package/dist/index.cjs

@@ -107,10 +107,13 @@ __export(src_exports, {
   AudioDevice: () => AudioDevice,
   AudioDevicesParams: () => AudioDevicesParams,
   AudioDevicesResult: () => AudioDevicesResult,
+  AudioLevelsParams: () => AudioLevelsParams,
+  AudioLevelsResult: () => AudioLevelsResult,
   AudioPlayParams: () => AudioPlayParams,
   AudioPlayResult: () => AudioPlayResult,
   AudioRecordParams: () => AudioRecordParams,
   AudioRecordResult: () => AudioRecordResult,
+  AudioSetLevelsParams: () => AudioSetLevelsParams,
   BEARER_PREFIX: () => BEARER_PREFIX,
   BROADCAST_CID: () => BROADCAST_CID,
   CLOSE_RULES: () => CLOSE_RULES,
@@ -269,11 +272,14 @@ __export(src_exports, {
   InputHotkeyParams: () => InputHotkeyParams,
   InputHotkeyResult: () => InputHotkeyResult,
   InputKey: () => InputKey,
+  InputKeyboardSettingsParams: () => InputKeyboardSettingsParams,
+  InputKeyboardSettingsResult: () => InputKeyboardSettingsResult,
   InputMouseClickParams: () => InputMouseClickParams,
   InputMouseClickResult: () => InputMouseClickResult,
   InputMouseMoveParams: () => InputMouseMoveParams,
   InputMouseMoveResult: () => InputMouseMoveResult,
   InputPoint: () => InputPoint,
+  InputSetKeyboardSettingsParams: () => InputSetKeyboardSettingsParams,
   InputTypeTextParams: () => InputTypeTextParams,
   InputTypeTextResult: () => InputTypeTextResult,
   LEGACY_ACTIONS: () => LEGACY_ACTIONS,
@@ -304,6 +310,10 @@ __export(src_exports, {
   PROTOCOL_MAJOR: () => PROTOCOL_MAJOR,
   PROTOCOL_MINOR: () => PROTOCOL_MINOR,
   PROTOCOL_VERSION: () => PROTOCOL_VERSION,
+  PowerEnergy: () => PowerEnergy,
+  PowerHistoryParams: () => PowerHistoryParams,
+  PowerHistoryPoint: () => PowerHistoryPoint,
+  PowerHistoryResult: () => PowerHistoryResult,
   PowerPreventSleepParams: () => PowerPreventSleepParams,
   PowerPreventSleepResult: () => PowerPreventSleepResult,
   PowerStatusParams: () => PowerStatusParams,
@@ -393,6 +403,7 @@ __export(src_exports, {
   Signal: () => Signal,
   SpendAccount: () => SpendAccount,
   SpendChat: () => SpendChat,
+  SpendDay: () => SpendDay,
   SpendHelper: () => SpendHelper,
   SpendIdle: () => SpendIdle,
   SpendIdleScope: () => SpendIdleScope,
@@ -420,12 +431,17 @@ __export(src_exports, {
   StreamMsg: () => StreamMsg,
   SysinfoGetParams: () => SysinfoGetParams,
   SysinfoGetResult: () => SysinfoGetResult,
+  SysinfoHardwareParams: () => SysinfoHardwareParams,
+  SysinfoHardwareResult: () => SysinfoHardwareResult,
   SystemNotifyParams: () => SystemNotifyParams,
   SystemNotifyResult: () => SystemNotifyResult,
   SystemOpenPathParams: () => SystemOpenPathParams,
   SystemOpenPathResult: () => SystemOpenPathResult,
+  SystemOpenSettingsParams: () => SystemOpenSettingsParams,
+  SystemOpenSettingsResult: () => SystemOpenSettingsResult,
   SystemOpenUrlParams: () => SystemOpenUrlParams,
   SystemOpenUrlResult: () => SystemOpenUrlResult,
+  SystemSettingsPane: () => SystemSettingsPane,
   TOOL_CATALOG: () => TOOL_CATALOG,
   TOOL_GROUPS: () => TOOL_GROUPS,
   TOOL_LEVELS: () => TOOL_LEVELS,
@@ -500,7 +516,7 @@ module.exports = __toCommonJS(src_exports);
 var import_zod = require("zod");
 var import_uuid = require("@ai-matrx/kit/uuid");
 var PROTOCOL_MAJOR = 1;
-var PROTOCOL_MINOR = 23;
+var PROTOCOL_MINOR = 24;
 var PROTOCOL_VERSION = `${PROTOCOL_MAJOR}.${PROTOCOL_MINOR}`;
 var ProtocolVersion = import_zod.z.string().regex(/^[1-9][0-9]{0,2}\.[0-9]{1,3}$/);
 var RequestId = import_zod.z.string().min(1).max(64).regex(/^[A-Za-z0-9_-]+$/);
@@ -913,6 +929,23 @@ var SysinfoGetResult = import_zod5.z.strictObject({
     })
   )
 });
+var SysinfoHardwareParams = import_zod5.z.strictObject({});
+var SysinfoHardwareResult = import_zod5.z.strictObject({
+  /** "Mac Studio", "MacBook Pro", "ThinkPad X1 Carbon". */
+  model_name: import_zod5.z.string().max(128).nullable(),
+  /** What tells two of that model apart: "M3 Ultra, 2025", "14-inch, Nov 2023". */
+  model_detail: import_zod5.z.string().max(128).nullable(),
+  /** "Mac15,14", the vendor's model number. */
+  model_identifier: import_zod5.z.string().max(128).nullable(),
+  /** "Apple M3 Ultra", "Intel Core i7-1185G7". */
+  chip: import_zod5.z.string().max(128).nullable(),
+  serial_number: import_zod5.z.string().max(128).nullable(),
+  /** The OS's own name with its release name: "macOS Tahoe", "Windows 11 Pro", "Ubuntu". */
+  os_name: import_zod5.z.string().max(64).nullable(),
+  /** "26.6.2". */
+  os_version: import_zod5.z.string().max(64).nullable(),
+  os_build: import_zod5.z.string().max(64).nullable()
+});
 
 // src/schema/fs.ts
 var import_zod6 = require("zod");
@@ -1841,6 +1874,7 @@ var SpendLive = import_zod14.z.strictObject({ id: ChatId, title: import_zod14.z.
 var SpendIdleScope = import_zod14.z.strictObject({ count: nonNegInt, tokens: nonNegInt, cost: import_zod14.z.number(), avoidable: import_zod14.z.number() });
 var SpendIdle = import_zod14.z.strictObject({ id: ChatId, chat: import_zod14.z.string().max(1e3), who: import_zod14.z.string().max(400), today: SpendIdleScope, week: SpendIdleScope, last_ms: epochMs });
 var SpendStart = import_zod14.z.strictObject({ repo: import_zod14.z.string().max(200), count: nonNegInt, median: nonNegInt, latest: import_zod14.z.array(nonNegInt).max(20), alarm: import_zod14.z.string().max(400).nullable() });
+var SpendDay = import_zod14.z.strictObject({ date: import_zod14.z.string().regex(/^\d{4}-\d{2}-\d{2}$/), main: import_zod14.z.number(), helpers: import_zod14.z.number() });
 var AppsSpendParams = import_zod14.z.strictObject({ app_key: AppKey });
 var AppsSpendResult = import_zod14.z.strictObject({
   app_key: AppKey,
@@ -1857,6 +1891,8 @@ var AppsSpendResult = import_zod14.z.strictObject({
   live: import_zod14.z.array(SpendLive).max(200),
   accounts: import_zod14.z.array(SpendAccount).max(200),
   models: import_zod14.z.array(SpendModel).max(100),
+  /** (1.24) The last 7 days, oldest first (today last). */
+  days: import_zod14.z.array(SpendDay).max(14).optional(),
   chats: import_zod14.z.array(SpendChat).max(500),
   idle: import_zod14.z.array(SpendIdle).max(500),
   starts: import_zod14.z.array(SpendStart).max(200)
@@ -2175,6 +2211,21 @@ var SystemNotifyResult = import_zod21.z.strictObject({
   /** False when this computer has no notification service to show it (a bare Linux box). */
   shown: import_zod21.z.boolean()
 });
+var SystemSettingsPane = import_zod21.z.enum([
+  "displays",
+  "night_shift",
+  "sound",
+  "keyboard",
+  "keyboard_shortcuts",
+  "text_input",
+  "dictation",
+  "energy",
+  "about",
+  "storage",
+  "system_report"
+]);
+var SystemOpenSettingsParams = import_zod21.z.strictObject({ pane: SystemSettingsPane });
+var SystemOpenSettingsResult = import_zod21.z.strictObject({ pane: SystemSettingsPane });
 
 // src/schema/screen.ts
 var import_zod22 = require("zod");
@@ -2189,7 +2240,13 @@ var ScreenDisplay = import_zod22.z.strictObject({
   height: import_zod22.z.int().min(1),
   /** Pixels per point (2 on a Retina display). */
   scale: import_zod22.z.number().min(0.1).max(8),
-  primary: import_zod22.z.boolean()
+  primary: import_zod22.z.boolean(),
+  /** (1.24) Clockwise rotation in degrees (Displays' Rotation: 0 is Standard). */
+  rotation: import_zod22.z.int().min(0).max(359).optional(),
+  /** (1.24) Refresh rate in hertz; absent where the OS does not say. */
+  refresh_hz: import_zod22.z.number().min(0).max(1e3).optional(),
+  /** (1.24) The computer's own screen (a laptop's), not one plugged in. */
+  builtin: import_zod22.z.boolean().optional()
 });
 var ScreenListParams = import_zod22.z.strictObject({});
 var ScreenListResult = import_zod22.z.strictObject({ displays: import_zod22.z.array(ScreenDisplay).max(32) });
@@ -2368,9 +2425,43 @@ var InputMouseClickResult = import_zod24.z.strictObject({
   button: import_zod24.z.enum(["left", "right", "middle"]),
   double: import_zod24.z.boolean()
 });
+var InputKeyboardSettingsParams = import_zod24.z.strictObject({});
+var InputKeyboardSettingsResult = import_zod24.z.strictObject({
+  /** Key repeat is off (a held key types once). */
+  repeat_off: import_zod24.z.boolean().nullable(),
+  /** Time between repeats while a key is held (Key repeat rate: shorter is faster). */
+  repeat_interval_ms: nonNegInt.nullable(),
+  /** Time a key is held before it starts repeating (Delay until repeat). */
+  repeat_delay_ms: nonNegInt.nullable(),
+  /** What the fn / globe key does alone. */
+  fn_key: import_zod24.z.enum(["nothing", "input_source", "emoji", "dictation"]).nullable(),
+  /** Tab moves focus between every control. */
+  keyboard_navigation: import_zod24.z.boolean().nullable(),
+  /** The enabled input sources by name ("U.S.", "ABC – Extended"). */
+  input_sources: import_zod24.z.array(import_zod24.z.string().max(128)).max(64),
+  /** A key repeat change takes effect only after the person logs out and in again (macOS). */
+  applies_after_login: import_zod24.z.boolean()
+});
+var InputSetKeyboardSettingsParams = import_zod24.z.strictObject({
+  repeat_off: import_zod24.z.boolean().optional(),
+  repeat_interval_ms: import_zod24.z.int().min(15).max(2e3).optional(),
+  repeat_delay_ms: import_zod24.z.int().min(150).max(2e3).optional(),
+  keyboard_navigation: import_zod24.z.boolean().optional()
+});
 
 // src/schema/power.ts
 var import_zod25 = require("zod");
+var PowerEnergy = import_zod25.z.strictObject({
+  display_sleep_minutes: nonNegInt.nullable(),
+  /** The computer itself sleeps after this long idle; null = never (Prevent automatic sleeping). */
+  sleep_minutes: nonNegInt.nullable(),
+  /** Hard disks sleep after this long; null = never. */
+  disk_sleep_minutes: nonNegInt.nullable(),
+  wake_for_network: import_zod25.z.boolean().nullable(),
+  restart_after_power_failure: import_zod25.z.boolean().nullable(),
+  /** Low Power Mode (Energy Mode "Low Power"). */
+  low_power_mode: import_zod25.z.boolean().nullable()
+});
 var PowerStatusParams = import_zod25.z.strictObject({});
 var PowerStatusResult = import_zod25.z.strictObject({
   has_battery: import_zod25.z.boolean(),
@@ -2382,7 +2473,15 @@ var PowerStatusResult = import_zod25.z.strictObject({
   /** Minutes of battery left; null when charging, unknown or without a battery. */
   minutes_left: nonNegInt.nullable(),
   /** Matrx 2 is keeping the computer awake (power.prevent_sleep) until this time; null when it is not. */
-  awake_until_ms: epochMs.nullable()
+  awake_until_ms: epochMs.nullable(),
+  /** (1.24) The OS's own energy settings; absent where it keeps none Matrx 2 can read. */
+  energy: PowerEnergy.optional()
+});
+var PowerHistoryParams = import_zod25.z.strictObject({});
+var PowerHistoryPoint = import_zod25.z.strictObject({ at_ms: epochMs, percent: import_zod25.z.number().min(0).max(100), plugged_in: import_zod25.z.boolean() });
+var PowerHistoryResult = import_zod25.z.strictObject({
+  /** Oldest first; empty without a battery or where the OS keeps no log. */
+  points: import_zod25.z.array(PowerHistoryPoint).max(5e3)
 });
 var PowerPreventSleepParams = import_zod25.z.strictObject({
   /** Keep the computer awake this long; 0 lets it sleep again now. */
@@ -2710,7 +2809,10 @@ var AudioDevice = import_zod29.z.strictObject({
   /** The OS's name for it, as audio.record takes it. */
   id: import_zod29.z.string().min(1).max(256),
   name: import_zod29.z.string().max(256),
-  default: import_zod29.z.boolean()
+  default: import_zod29.z.boolean(),
+  /** (1.24) How it is connected, as Sound's Type column says it: "Built-in", "USB", "Bluetooth",
+   *  "DisplayPort", "HDMI", "AirPlay", "Virtual". Absent where the OS does not say. */
+  kind: import_zod29.z.string().max(64).optional()
 });
 var AudioDevicesParams = import_zod29.z.strictObject({});
 var AudioDevicesResult = import_zod29.z.strictObject({
@@ -2733,6 +2835,20 @@ var AudioRecordResult = import_zod29.z.strictObject({
 });
 var AudioPlayParams = import_zod29.z.strictObject({ path: AbsPath });
 var AudioPlayResult = import_zod29.z.strictObject({ path: AbsPath, seconds: import_zod29.z.number().min(0) });
+var AudioLevelsParams = import_zod29.z.strictObject({});
+var AudioLevelsResult = import_zod29.z.strictObject({
+  output_volume: import_zod29.z.number().min(0).max(100).nullable(),
+  output_muted: import_zod29.z.boolean().nullable(),
+  input_volume: import_zod29.z.number().min(0).max(100).nullable(),
+  /** The alert (beep) volume, a share of the output volume. */
+  alert_volume: import_zod29.z.number().min(0).max(100).nullable()
+});
+var AudioSetLevelsParams = import_zod29.z.strictObject({
+  output_volume: import_zod29.z.number().min(0).max(100).optional(),
+  output_muted: import_zod29.z.boolean().optional(),
+  input_volume: import_zod29.z.number().min(0).max(100).optional(),
+  alert_volume: import_zod29.z.number().min(0).max(100).optional()
+});
 
 // src/schema/fs-watch.ts
 var import_zod30 = require("zod");
@@ -2890,6 +3006,7 @@ var CodingHistoryProgressEvent = import_zod32.z.strictObject({
 var FS_ERR = ["NOT_FOUND", "PERMISSION_DENIED_OS", "INVALID_PARAMS", "RESOURCE_BUSY", "INTERNAL"];
 var OPS = {
   "sysinfo.get": { params: SysinfoGetParams, result: SysinfoGetResult, kind: "unary", since: "1.0", errors: ["INTERNAL"] },
+  "sysinfo.hardware": { params: SysinfoHardwareParams, result: SysinfoHardwareResult, kind: "unary", since: "1.24", errors: ["INTERNAL"] },
   "fs.list": { params: FsListParams, result: FsListResult, kind: "unary", since: "1.0", errors: FS_ERR },
   "fs.stat": { params: FsStatParams, result: FsStatResult, kind: "unary", since: "1.0", errors: FS_ERR },
   "fs.read": { params: FsReadParams, result: FsReadResult, kind: "unary", since: "1.0", errors: [...FS_ERR, "PAYLOAD_TOO_LARGE"] },
@@ -2966,6 +3083,7 @@ var OPS = {
   "exec.job.stop": { params: ExecJobStopParams, result: ExecJobStopResult, kind: "unary", since: "1.4", errors: ["RESOURCE_GONE", "INVALID_PARAMS", "INTERNAL"] },
   "exec.job.list": { params: ExecJobListParams, result: ExecJobListResult, kind: "unary", since: "1.4", errors: ["INTERNAL"] },
   "system.open_url": { params: SystemOpenUrlParams, result: SystemOpenUrlResult, kind: "unary", since: "1.4", errors: ["INVALID_PARAMS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "system.open_settings": { params: SystemOpenSettingsParams, result: SystemOpenSettingsResult, kind: "unary", since: "1.24", errors: ["PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "system.open_path": { params: SystemOpenPathParams, result: SystemOpenPathResult, kind: "unary", since: "1.4", errors: ["NOT_FOUND", "INVALID_PARAMS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "system.notify": { params: SystemNotifyParams, result: SystemNotifyResult, kind: "unary", since: "1.4", errors: ["PERMISSION_DENIED_OS", "INTERNAL"] },
   "screen.list": { params: ScreenListParams, result: ScreenListResult, kind: "unary", since: "1.4", errors: ["PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
@@ -2975,16 +3093,21 @@ var OPS = {
   "window.move": { params: WindowMoveParams, result: WindowMoveResult, kind: "unary", since: "1.4", errors: ["NOT_FOUND", "INVALID_PARAMS", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "window.minimize": { params: WindowMinimizeParams, result: WindowMinimizeResult, kind: "unary", since: "1.4", errors: ["NOT_FOUND", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "input.type_text": { params: InputTypeTextParams, result: InputTypeTextResult, kind: "unary", since: "1.4", errors: ["PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "input.keyboard_settings": { params: InputKeyboardSettingsParams, result: InputKeyboardSettingsResult, kind: "unary", since: "1.24", errors: ["PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "input.set_keyboard_settings": { params: InputSetKeyboardSettingsParams, result: InputKeyboardSettingsResult, kind: "unary", since: "1.24", errors: ["INVALID_PARAMS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "input.hotkey": { params: InputHotkeyParams, result: InputHotkeyResult, kind: "unary", since: "1.4", errors: ["INVALID_PARAMS", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "input.mouse_move": { params: InputMouseMoveParams, result: InputMouseMoveResult, kind: "unary", since: "1.4", errors: ["PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "input.mouse_click": { params: InputMouseClickParams, result: InputMouseClickResult, kind: "unary", since: "1.4", errors: ["INVALID_PARAMS", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "power.status": { params: PowerStatusParams, result: PowerStatusResult, kind: "unary", since: "1.4", errors: ["INTERNAL"] },
+  "power.history": { params: PowerHistoryParams, result: PowerHistoryResult, kind: "unary", since: "1.24", errors: ["INTERNAL"] },
   "power.prevent_sleep": { params: PowerPreventSleepParams, result: PowerPreventSleepResult, kind: "unary", since: "1.4", errors: ["PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "resources.snapshot": { params: ResourcesSnapshotParams, result: ResourcesSnapshotResult, kind: "unary", since: "1.4", errors: ["INTERNAL"] },
   "resources.activity": { params: ResourcesActivityParams, result: ResourcesActivityResult, kind: "unary", since: "1.17", errors: ["PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "resources.stop_job": { params: ResourcesStopJobParams, result: ResourcesStopJobResult, kind: "unary", since: "1.17", errors: ["NOT_FOUND", "CONFLICT", "AUTH_FORBIDDEN", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "resources.incidents": { params: ResourcesIncidentsParams, result: ResourcesIncidentsResult, kind: "unary", since: "1.17", errors: ["INTERNAL"] },
   "audio.devices": { params: AudioDevicesParams, result: AudioDevicesResult, kind: "unary", since: "1.6", errors: ["PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "audio.levels": { params: AudioLevelsParams, result: AudioLevelsResult, kind: "unary", since: "1.24", errors: ["PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "audio.set_levels": { params: AudioSetLevelsParams, result: AudioLevelsResult, kind: "unary", since: "1.24", errors: ["INVALID_PARAMS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "audio.record": { params: AudioRecordParams, result: AudioRecordResult, kind: "unary", since: "1.6", errors: ["NOT_FOUND", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "RESOURCE_BUSY", "INTERNAL"] },
   "audio.play": { params: AudioPlayParams, result: AudioPlayResult, kind: "unary", since: "1.6", errors: ["NOT_FOUND", "INVALID_PARAMS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   // The local AI Matrx servers (aidream's process-compose stack), supervised from Matrx 2's core.
@@ -3094,6 +3217,8 @@ var NAMED_SCHEMAS = {
   OsPermissionName,
   SysinfoGetParams,
   SysinfoGetResult,
+  SysinfoHardwareParams,
+  SysinfoHardwareResult,
   FsKind,
   FsEntry,
   FsListParams,
@@ -3220,6 +3345,9 @@ var NAMED_SCHEMAS = {
   SystemOpenUrlResult,
   SystemOpenPathParams,
   SystemOpenPathResult,
+  SystemSettingsPane,
+  SystemOpenSettingsParams,
+  SystemOpenSettingsResult,
   SystemNotifyParams,
   SystemNotifyResult,
   ScreenDisplay,
@@ -3237,6 +3365,9 @@ var NAMED_SCHEMAS = {
   WindowMinimizeParams,
   WindowMinimizeResult,
   InputKey,
+  InputKeyboardSettingsParams,
+  InputKeyboardSettingsResult,
+  InputSetKeyboardSettingsParams,
   InputPoint,
   InputTypeTextParams,
   InputTypeTextResult,
@@ -3250,6 +3381,10 @@ var NAMED_SCHEMAS = {
   PowerStatusResult,
   PowerPreventSleepParams,
   PowerPreventSleepResult,
+  PowerEnergy,
+  PowerHistoryParams,
+  PowerHistoryPoint,
+  PowerHistoryResult,
   ResourcesDisk,
   ResourcesSnapshotParams,
   ResourcesSnapshotResult,
@@ -3274,6 +3409,9 @@ var NAMED_SCHEMAS = {
   AudioRecordResult,
   AudioPlayParams,
   AudioPlayResult,
+  AudioLevelsParams,
+  AudioLevelsResult,
+  AudioSetLevelsParams,
   StackServerName,
   StackTone,
   StackServer,
@@ -3413,6 +3551,7 @@ var NAMED_SCHEMAS = {
   SpendIdleScope,
   SpendIdle,
   SpendStart,
+  SpendDay,
   AppsSpendParams,
   AppsSpendResult,
   AppsSyncStatusParams,
@@ -3481,7 +3620,11 @@ var FIELDS_SINCE = {
   ChatRow: { app_project: "1.13", tokens: "1.13", original_title: "1.14", title_source: "1.14", title_override: "1.14", archived: "1.15" },
   AccountUsage: { plan: "1.13", credits: "1.13" },
   ResourcesDisk: { name: "1.17" },
-  StackServer: { cpu_percent: "1.18", memory_bytes: "1.18" }
+  StackServer: { cpu_percent: "1.18", memory_bytes: "1.18" },
+  AudioDevice: { kind: "1.24" },
+  ScreenDisplay: { rotation: "1.24", refresh_hz: "1.24", builtin: "1.24" },
+  PowerStatusResult: { energy: "1.24" },
+  AppsSpendResult: { days: "1.24" }
 };
 var NULL_SINCE = {
   "RelayDeviceStatusEvent.since_ms": { since: "1.1", olderPeersGet: 0 }
@@ -3611,7 +3754,7 @@ function forPeer(op, part, value, version) {
 var VERSIONED_RESULT_OPS = [.../* @__PURE__ */ new Set([...RESULT_PATH.keys(), ...WINDOW_RESULTS.keys(), ...NESTED_RESULTS.keys()])];
 
 // src/contract.ts
-var CONTRACT_SHA256 = "764fdad5d8851da877e508f4aad2853aaa8fc3b057291488523ef2dd35615208";
+var CONTRACT_SHA256 = "89943d5297e89b0ae7433b24c3076be1f65ca39a5edc3f338620597b24009226";
 
 // src/close-policy.ts
 var CLOSE_RULES = {
@@ -3665,13 +3808,13 @@ var TOOL_CATALOG = [
   // ── 2. Computer control (TS owners) ──────────────────────────────────────────────────────────
   { name: "desktop_process", group: "os_control", state: "built", path: "device_op", ops: ["proc.list", "proc.ports", "proc.kill"], platforms: ALL, summary: "Running processes and ports; stop one" },
   { name: "desktop_apps", group: "os_control", state: "built", path: "device_op", ops: ["apps.list", "apps.open"], platforms: ALL, summary: "Installed apps; open or bring one forward" },
-  { name: "desktop_system", group: "os_control", state: "built", path: "device_op", ops: ["sysinfo.get", "system.open_url", "system.open_path", "system.notify"], platforms: ALL, summary: "System facts, open, notify" },
+  { name: "desktop_system", group: "os_control", state: "built", path: "device_op", ops: ["sysinfo.get", "sysinfo.hardware", "system.open_url", "system.open_path", "system.open_settings", "system.notify"], platforms: ALL, summary: "System facts, open, notify" },
   { name: "desktop_clipboard", group: "os_control", state: "built", path: "device_op", ops: ["clipboard.read", "clipboard.write"], platforms: ALL, summary: "Read and write the clipboard's text" },
   { name: "desktop_screen", group: "os_control", state: "built", path: "device_op", ops: ["screen.list", "screen.capture"], platforms: ALL, summary: "Displays and screenshots" },
   { name: "desktop_window", group: "os_control", state: "built", path: "device_op", ops: ["window.list", "window.focus", "window.move", "window.minimize"], platforms: ALL, summary: "Find, focus and arrange windows" },
-  { name: "desktop_input", group: "os_control", state: "built", path: "device_op", ops: ["input.type_text", "input.hotkey", "input.mouse_click", "input.mouse_move"], platforms: ALL, summary: "Keyboard and mouse" },
-  { name: "desktop_audio", group: "os_control", state: "built", path: "device_op", ops: ["audio.devices", "audio.record", "audio.play"], platforms: ALL, summary: "Audio devices, record, play" },
-  { name: "desktop_power", group: "os_control", state: "built", path: "device_op", ops: ["power.status", "power.prevent_sleep"], platforms: ALL, summary: "Battery and keep awake" },
+  { name: "desktop_input", group: "os_control", state: "built", path: "device_op", ops: ["input.type_text", "input.hotkey", "input.mouse_click", "input.mouse_move", "input.keyboard_settings", "input.set_keyboard_settings"], platforms: ALL, summary: "Keyboard and mouse" },
+  { name: "desktop_audio", group: "os_control", state: "built", path: "device_op", ops: ["audio.devices", "audio.levels", "audio.set_levels", "audio.record", "audio.play"], platforms: ALL, summary: "Audio devices, record, play" },
+  { name: "desktop_power", group: "os_control", state: "built", path: "device_op", ops: ["power.status", "power.history", "power.prevent_sleep"], platforms: ALL, summary: "Battery and keep awake" },
   { name: "desktop_resources", group: "os_control", state: "built", path: "device_op", ops: ["resources.snapshot", "resources.activity", "resources.stop_job", "resources.incidents"], platforms: ALL, summary: "CPU, memory and disk use; what is using them, grouped into jobs; stop a job; the slowdown log" },
   { name: "fs_watch", group: "os_control", state: "built", path: "device_op", ops: ["fs.watch.start", "fs.watch.events", "fs.watch.stop"], platforms: ALL, summary: "Watch a folder; read what changed" },
   // ── 3. Personal apps and automation ──────────────────────────────────────────────────────────