@ai-matrx/desktop-protocol 0.21.16 → 0.21.18

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.js CHANGED
@@ -2,7 +2,7 @@
2
2
  import { z } from "zod";
3
3
  import { UUID_SHAPE_PATTERN } from "@ai-matrx/kit/uuid";
4
4
  var PROTOCOL_MAJOR = 1;
5
- var PROTOCOL_MINOR = 23;
5
+ var PROTOCOL_MINOR = 24;
6
6
  var PROTOCOL_VERSION = `${PROTOCOL_MAJOR}.${PROTOCOL_MINOR}`;
7
7
  var ProtocolVersion = z.string().regex(/^[1-9][0-9]{0,2}\.[0-9]{1,3}$/);
8
8
  var RequestId = z.string().min(1).max(64).regex(/^[A-Za-z0-9_-]+$/);
@@ -415,6 +415,23 @@ var SysinfoGetResult = z5.strictObject({
415
415
  })
416
416
  )
417
417
  });
418
+ var SysinfoHardwareParams = z5.strictObject({});
419
+ var SysinfoHardwareResult = z5.strictObject({
420
+ /** "Mac Studio", "MacBook Pro", "ThinkPad X1 Carbon". */
421
+ model_name: z5.string().max(128).nullable(),
422
+ /** What tells two of that model apart: "M3 Ultra, 2025", "14-inch, Nov 2023". */
423
+ model_detail: z5.string().max(128).nullable(),
424
+ /** "Mac15,14", the vendor's model number. */
425
+ model_identifier: z5.string().max(128).nullable(),
426
+ /** "Apple M3 Ultra", "Intel Core i7-1185G7". */
427
+ chip: z5.string().max(128).nullable(),
428
+ serial_number: z5.string().max(128).nullable(),
429
+ /** The OS's own name with its release name: "macOS Tahoe", "Windows 11 Pro", "Ubuntu". */
430
+ os_name: z5.string().max(64).nullable(),
431
+ /** "26.6.2". */
432
+ os_version: z5.string().max(64).nullable(),
433
+ os_build: z5.string().max(64).nullable()
434
+ });
418
435
 
419
436
  // src/schema/fs.ts
420
437
  import { z as z6 } from "zod";
@@ -1343,6 +1360,7 @@ var SpendLive = z14.strictObject({ id: ChatId, title: z14.string().max(1e3), win
1343
1360
  var SpendIdleScope = z14.strictObject({ count: nonNegInt, tokens: nonNegInt, cost: z14.number(), avoidable: z14.number() });
1344
1361
  var SpendIdle = z14.strictObject({ id: ChatId, chat: z14.string().max(1e3), who: z14.string().max(400), today: SpendIdleScope, week: SpendIdleScope, last_ms: epochMs });
1345
1362
  var SpendStart = z14.strictObject({ repo: z14.string().max(200), count: nonNegInt, median: nonNegInt, latest: z14.array(nonNegInt).max(20), alarm: z14.string().max(400).nullable() });
1363
+ var SpendDay = z14.strictObject({ date: z14.string().regex(/^\d{4}-\d{2}-\d{2}$/), main: z14.number(), helpers: z14.number() });
1346
1364
  var AppsSpendParams = z14.strictObject({ app_key: AppKey });
1347
1365
  var AppsSpendResult = z14.strictObject({
1348
1366
  app_key: AppKey,
@@ -1359,6 +1377,8 @@ var AppsSpendResult = z14.strictObject({
1359
1377
  live: z14.array(SpendLive).max(200),
1360
1378
  accounts: z14.array(SpendAccount).max(200),
1361
1379
  models: z14.array(SpendModel).max(100),
1380
+ /** (1.24) The last 7 days, oldest first (today last). */
1381
+ days: z14.array(SpendDay).max(14).optional(),
1362
1382
  chats: z14.array(SpendChat).max(500),
1363
1383
  idle: z14.array(SpendIdle).max(500),
1364
1384
  starts: z14.array(SpendStart).max(200)
@@ -1677,6 +1697,21 @@ var SystemNotifyResult = z21.strictObject({
1677
1697
  /** False when this computer has no notification service to show it (a bare Linux box). */
1678
1698
  shown: z21.boolean()
1679
1699
  });
1700
+ var SystemSettingsPane = z21.enum([
1701
+ "displays",
1702
+ "night_shift",
1703
+ "sound",
1704
+ "keyboard",
1705
+ "keyboard_shortcuts",
1706
+ "text_input",
1707
+ "dictation",
1708
+ "energy",
1709
+ "about",
1710
+ "storage",
1711
+ "system_report"
1712
+ ]);
1713
+ var SystemOpenSettingsParams = z21.strictObject({ pane: SystemSettingsPane });
1714
+ var SystemOpenSettingsResult = z21.strictObject({ pane: SystemSettingsPane });
1680
1715
 
1681
1716
  // src/schema/screen.ts
1682
1717
  import { z as z22 } from "zod";
@@ -1691,7 +1726,13 @@ var ScreenDisplay = z22.strictObject({
1691
1726
  height: z22.int().min(1),
1692
1727
  /** Pixels per point (2 on a Retina display). */
1693
1728
  scale: z22.number().min(0.1).max(8),
1694
- primary: z22.boolean()
1729
+ primary: z22.boolean(),
1730
+ /** (1.24) Clockwise rotation in degrees (Displays' Rotation: 0 is Standard). */
1731
+ rotation: z22.int().min(0).max(359).optional(),
1732
+ /** (1.24) Refresh rate in hertz; absent where the OS does not say. */
1733
+ refresh_hz: z22.number().min(0).max(1e3).optional(),
1734
+ /** (1.24) The computer's own screen (a laptop's), not one plugged in. */
1735
+ builtin: z22.boolean().optional()
1695
1736
  });
1696
1737
  var ScreenListParams = z22.strictObject({});
1697
1738
  var ScreenListResult = z22.strictObject({ displays: z22.array(ScreenDisplay).max(32) });
@@ -1870,9 +1911,43 @@ var InputMouseClickResult = z24.strictObject({
1870
1911
  button: z24.enum(["left", "right", "middle"]),
1871
1912
  double: z24.boolean()
1872
1913
  });
1914
+ var InputKeyboardSettingsParams = z24.strictObject({});
1915
+ var InputKeyboardSettingsResult = z24.strictObject({
1916
+ /** Key repeat is off (a held key types once). */
1917
+ repeat_off: z24.boolean().nullable(),
1918
+ /** Time between repeats while a key is held (Key repeat rate: shorter is faster). */
1919
+ repeat_interval_ms: nonNegInt.nullable(),
1920
+ /** Time a key is held before it starts repeating (Delay until repeat). */
1921
+ repeat_delay_ms: nonNegInt.nullable(),
1922
+ /** What the fn / globe key does alone. */
1923
+ fn_key: z24.enum(["nothing", "input_source", "emoji", "dictation"]).nullable(),
1924
+ /** Tab moves focus between every control. */
1925
+ keyboard_navigation: z24.boolean().nullable(),
1926
+ /** The enabled input sources by name ("U.S.", "ABC – Extended"). */
1927
+ input_sources: z24.array(z24.string().max(128)).max(64),
1928
+ /** A key repeat change takes effect only after the person logs out and in again (macOS). */
1929
+ applies_after_login: z24.boolean()
1930
+ });
1931
+ var InputSetKeyboardSettingsParams = z24.strictObject({
1932
+ repeat_off: z24.boolean().optional(),
1933
+ repeat_interval_ms: z24.int().min(15).max(2e3).optional(),
1934
+ repeat_delay_ms: z24.int().min(150).max(2e3).optional(),
1935
+ keyboard_navigation: z24.boolean().optional()
1936
+ });
1873
1937
 
1874
1938
  // src/schema/power.ts
1875
1939
  import { z as z25 } from "zod";
1940
+ var PowerEnergy = z25.strictObject({
1941
+ display_sleep_minutes: nonNegInt.nullable(),
1942
+ /** The computer itself sleeps after this long idle; null = never (Prevent automatic sleeping). */
1943
+ sleep_minutes: nonNegInt.nullable(),
1944
+ /** Hard disks sleep after this long; null = never. */
1945
+ disk_sleep_minutes: nonNegInt.nullable(),
1946
+ wake_for_network: z25.boolean().nullable(),
1947
+ restart_after_power_failure: z25.boolean().nullable(),
1948
+ /** Low Power Mode (Energy Mode "Low Power"). */
1949
+ low_power_mode: z25.boolean().nullable()
1950
+ });
1876
1951
  var PowerStatusParams = z25.strictObject({});
1877
1952
  var PowerStatusResult = z25.strictObject({
1878
1953
  has_battery: z25.boolean(),
@@ -1884,7 +1959,15 @@ var PowerStatusResult = z25.strictObject({
1884
1959
  /** Minutes of battery left; null when charging, unknown or without a battery. */
1885
1960
  minutes_left: nonNegInt.nullable(),
1886
1961
  /** Matrx 2 is keeping the computer awake (power.prevent_sleep) until this time; null when it is not. */
1887
- awake_until_ms: epochMs.nullable()
1962
+ awake_until_ms: epochMs.nullable(),
1963
+ /** (1.24) The OS's own energy settings; absent where it keeps none Matrx 2 can read. */
1964
+ energy: PowerEnergy.optional()
1965
+ });
1966
+ var PowerHistoryParams = z25.strictObject({});
1967
+ var PowerHistoryPoint = z25.strictObject({ at_ms: epochMs, percent: z25.number().min(0).max(100), plugged_in: z25.boolean() });
1968
+ var PowerHistoryResult = z25.strictObject({
1969
+ /** Oldest first; empty without a battery or where the OS keeps no log. */
1970
+ points: z25.array(PowerHistoryPoint).max(5e3)
1888
1971
  });
1889
1972
  var PowerPreventSleepParams = z25.strictObject({
1890
1973
  /** Keep the computer awake this long; 0 lets it sleep again now. */
@@ -2212,7 +2295,10 @@ var AudioDevice = z29.strictObject({
2212
2295
  /** The OS's name for it, as audio.record takes it. */
2213
2296
  id: z29.string().min(1).max(256),
2214
2297
  name: z29.string().max(256),
2215
- default: z29.boolean()
2298
+ default: z29.boolean(),
2299
+ /** (1.24) How it is connected, as Sound's Type column says it: "Built-in", "USB", "Bluetooth",
2300
+ * "DisplayPort", "HDMI", "AirPlay", "Virtual". Absent where the OS does not say. */
2301
+ kind: z29.string().max(64).optional()
2216
2302
  });
2217
2303
  var AudioDevicesParams = z29.strictObject({});
2218
2304
  var AudioDevicesResult = z29.strictObject({
@@ -2235,6 +2321,20 @@ var AudioRecordResult = z29.strictObject({
2235
2321
  });
2236
2322
  var AudioPlayParams = z29.strictObject({ path: AbsPath });
2237
2323
  var AudioPlayResult = z29.strictObject({ path: AbsPath, seconds: z29.number().min(0) });
2324
+ var AudioLevelsParams = z29.strictObject({});
2325
+ var AudioLevelsResult = z29.strictObject({
2326
+ output_volume: z29.number().min(0).max(100).nullable(),
2327
+ output_muted: z29.boolean().nullable(),
2328
+ input_volume: z29.number().min(0).max(100).nullable(),
2329
+ /** The alert (beep) volume, a share of the output volume. */
2330
+ alert_volume: z29.number().min(0).max(100).nullable()
2331
+ });
2332
+ var AudioSetLevelsParams = z29.strictObject({
2333
+ output_volume: z29.number().min(0).max(100).optional(),
2334
+ output_muted: z29.boolean().optional(),
2335
+ input_volume: z29.number().min(0).max(100).optional(),
2336
+ alert_volume: z29.number().min(0).max(100).optional()
2337
+ });
2238
2338
 
2239
2339
  // src/schema/fs-watch.ts
2240
2340
  import { z as z30 } from "zod";
@@ -2392,6 +2492,7 @@ var CodingHistoryProgressEvent = z32.strictObject({
2392
2492
  var FS_ERR = ["NOT_FOUND", "PERMISSION_DENIED_OS", "INVALID_PARAMS", "RESOURCE_BUSY", "INTERNAL"];
2393
2493
  var OPS = {
2394
2494
  "sysinfo.get": { params: SysinfoGetParams, result: SysinfoGetResult, kind: "unary", since: "1.0", errors: ["INTERNAL"] },
2495
+ "sysinfo.hardware": { params: SysinfoHardwareParams, result: SysinfoHardwareResult, kind: "unary", since: "1.24", errors: ["INTERNAL"] },
2395
2496
  "fs.list": { params: FsListParams, result: FsListResult, kind: "unary", since: "1.0", errors: FS_ERR },
2396
2497
  "fs.stat": { params: FsStatParams, result: FsStatResult, kind: "unary", since: "1.0", errors: FS_ERR },
2397
2498
  "fs.read": { params: FsReadParams, result: FsReadResult, kind: "unary", since: "1.0", errors: [...FS_ERR, "PAYLOAD_TOO_LARGE"] },
@@ -2468,6 +2569,7 @@ var OPS = {
2468
2569
  "exec.job.stop": { params: ExecJobStopParams, result: ExecJobStopResult, kind: "unary", since: "1.4", errors: ["RESOURCE_GONE", "INVALID_PARAMS", "INTERNAL"] },
2469
2570
  "exec.job.list": { params: ExecJobListParams, result: ExecJobListResult, kind: "unary", since: "1.4", errors: ["INTERNAL"] },
2470
2571
  "system.open_url": { params: SystemOpenUrlParams, result: SystemOpenUrlResult, kind: "unary", since: "1.4", errors: ["INVALID_PARAMS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
2572
+ "system.open_settings": { params: SystemOpenSettingsParams, result: SystemOpenSettingsResult, kind: "unary", since: "1.24", errors: ["PLATFORM_UNSUPPORTED", "INTERNAL"] },
2471
2573
  "system.open_path": { params: SystemOpenPathParams, result: SystemOpenPathResult, kind: "unary", since: "1.4", errors: ["NOT_FOUND", "INVALID_PARAMS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
2472
2574
  "system.notify": { params: SystemNotifyParams, result: SystemNotifyResult, kind: "unary", since: "1.4", errors: ["PERMISSION_DENIED_OS", "INTERNAL"] },
2473
2575
  "screen.list": { params: ScreenListParams, result: ScreenListResult, kind: "unary", since: "1.4", errors: ["PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
@@ -2477,16 +2579,21 @@ var OPS = {
2477
2579
  "window.move": { params: WindowMoveParams, result: WindowMoveResult, kind: "unary", since: "1.4", errors: ["NOT_FOUND", "INVALID_PARAMS", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
2478
2580
  "window.minimize": { params: WindowMinimizeParams, result: WindowMinimizeResult, kind: "unary", since: "1.4", errors: ["NOT_FOUND", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
2479
2581
  "input.type_text": { params: InputTypeTextParams, result: InputTypeTextResult, kind: "unary", since: "1.4", errors: ["PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
2582
+ "input.keyboard_settings": { params: InputKeyboardSettingsParams, result: InputKeyboardSettingsResult, kind: "unary", since: "1.24", errors: ["PLATFORM_UNSUPPORTED", "INTERNAL"] },
2583
+ "input.set_keyboard_settings": { params: InputSetKeyboardSettingsParams, result: InputKeyboardSettingsResult, kind: "unary", since: "1.24", errors: ["INVALID_PARAMS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
2480
2584
  "input.hotkey": { params: InputHotkeyParams, result: InputHotkeyResult, kind: "unary", since: "1.4", errors: ["INVALID_PARAMS", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
2481
2585
  "input.mouse_move": { params: InputMouseMoveParams, result: InputMouseMoveResult, kind: "unary", since: "1.4", errors: ["PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
2482
2586
  "input.mouse_click": { params: InputMouseClickParams, result: InputMouseClickResult, kind: "unary", since: "1.4", errors: ["INVALID_PARAMS", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
2483
2587
  "power.status": { params: PowerStatusParams, result: PowerStatusResult, kind: "unary", since: "1.4", errors: ["INTERNAL"] },
2588
+ "power.history": { params: PowerHistoryParams, result: PowerHistoryResult, kind: "unary", since: "1.24", errors: ["INTERNAL"] },
2484
2589
  "power.prevent_sleep": { params: PowerPreventSleepParams, result: PowerPreventSleepResult, kind: "unary", since: "1.4", errors: ["PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
2485
2590
  "resources.snapshot": { params: ResourcesSnapshotParams, result: ResourcesSnapshotResult, kind: "unary", since: "1.4", errors: ["INTERNAL"] },
2486
2591
  "resources.activity": { params: ResourcesActivityParams, result: ResourcesActivityResult, kind: "unary", since: "1.17", errors: ["PLATFORM_UNSUPPORTED", "INTERNAL"] },
2487
2592
  "resources.stop_job": { params: ResourcesStopJobParams, result: ResourcesStopJobResult, kind: "unary", since: "1.17", errors: ["NOT_FOUND", "CONFLICT", "AUTH_FORBIDDEN", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
2488
2593
  "resources.incidents": { params: ResourcesIncidentsParams, result: ResourcesIncidentsResult, kind: "unary", since: "1.17", errors: ["INTERNAL"] },
2489
2594
  "audio.devices": { params: AudioDevicesParams, result: AudioDevicesResult, kind: "unary", since: "1.6", errors: ["PLATFORM_UNSUPPORTED", "INTERNAL"] },
2595
+ "audio.levels": { params: AudioLevelsParams, result: AudioLevelsResult, kind: "unary", since: "1.24", errors: ["PLATFORM_UNSUPPORTED", "INTERNAL"] },
2596
+ "audio.set_levels": { params: AudioSetLevelsParams, result: AudioLevelsResult, kind: "unary", since: "1.24", errors: ["INVALID_PARAMS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
2490
2597
  "audio.record": { params: AudioRecordParams, result: AudioRecordResult, kind: "unary", since: "1.6", errors: ["NOT_FOUND", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "RESOURCE_BUSY", "INTERNAL"] },
2491
2598
  "audio.play": { params: AudioPlayParams, result: AudioPlayResult, kind: "unary", since: "1.6", errors: ["NOT_FOUND", "INVALID_PARAMS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
2492
2599
  // The local AI Matrx servers (aidream's process-compose stack), supervised from Matrx 2's core.
@@ -2596,6 +2703,8 @@ var NAMED_SCHEMAS = {
2596
2703
  OsPermissionName,
2597
2704
  SysinfoGetParams,
2598
2705
  SysinfoGetResult,
2706
+ SysinfoHardwareParams,
2707
+ SysinfoHardwareResult,
2599
2708
  FsKind,
2600
2709
  FsEntry,
2601
2710
  FsListParams,
@@ -2722,6 +2831,9 @@ var NAMED_SCHEMAS = {
2722
2831
  SystemOpenUrlResult,
2723
2832
  SystemOpenPathParams,
2724
2833
  SystemOpenPathResult,
2834
+ SystemSettingsPane,
2835
+ SystemOpenSettingsParams,
2836
+ SystemOpenSettingsResult,
2725
2837
  SystemNotifyParams,
2726
2838
  SystemNotifyResult,
2727
2839
  ScreenDisplay,
@@ -2739,6 +2851,9 @@ var NAMED_SCHEMAS = {
2739
2851
  WindowMinimizeParams,
2740
2852
  WindowMinimizeResult,
2741
2853
  InputKey,
2854
+ InputKeyboardSettingsParams,
2855
+ InputKeyboardSettingsResult,
2856
+ InputSetKeyboardSettingsParams,
2742
2857
  InputPoint,
2743
2858
  InputTypeTextParams,
2744
2859
  InputTypeTextResult,
@@ -2752,6 +2867,10 @@ var NAMED_SCHEMAS = {
2752
2867
  PowerStatusResult,
2753
2868
  PowerPreventSleepParams,
2754
2869
  PowerPreventSleepResult,
2870
+ PowerEnergy,
2871
+ PowerHistoryParams,
2872
+ PowerHistoryPoint,
2873
+ PowerHistoryResult,
2755
2874
  ResourcesDisk,
2756
2875
  ResourcesSnapshotParams,
2757
2876
  ResourcesSnapshotResult,
@@ -2776,6 +2895,9 @@ var NAMED_SCHEMAS = {
2776
2895
  AudioRecordResult,
2777
2896
  AudioPlayParams,
2778
2897
  AudioPlayResult,
2898
+ AudioLevelsParams,
2899
+ AudioLevelsResult,
2900
+ AudioSetLevelsParams,
2779
2901
  StackServerName,
2780
2902
  StackTone,
2781
2903
  StackServer,
@@ -2915,6 +3037,7 @@ var NAMED_SCHEMAS = {
2915
3037
  SpendIdleScope,
2916
3038
  SpendIdle,
2917
3039
  SpendStart,
3040
+ SpendDay,
2918
3041
  AppsSpendParams,
2919
3042
  AppsSpendResult,
2920
3043
  AppsSyncStatusParams,
@@ -2983,7 +3106,11 @@ var FIELDS_SINCE = {
2983
3106
  ChatRow: { app_project: "1.13", tokens: "1.13", original_title: "1.14", title_source: "1.14", title_override: "1.14", archived: "1.15" },
2984
3107
  AccountUsage: { plan: "1.13", credits: "1.13" },
2985
3108
  ResourcesDisk: { name: "1.17" },
2986
- StackServer: { cpu_percent: "1.18", memory_bytes: "1.18" }
3109
+ StackServer: { cpu_percent: "1.18", memory_bytes: "1.18" },
3110
+ AudioDevice: { kind: "1.24" },
3111
+ ScreenDisplay: { rotation: "1.24", refresh_hz: "1.24", builtin: "1.24" },
3112
+ PowerStatusResult: { energy: "1.24" },
3113
+ AppsSpendResult: { days: "1.24" }
2987
3114
  };
2988
3115
  var NULL_SINCE = {
2989
3116
  "RelayDeviceStatusEvent.since_ms": { since: "1.1", olderPeersGet: 0 }
@@ -3113,7 +3240,7 @@ function forPeer(op, part, value, version) {
3113
3240
  var VERSIONED_RESULT_OPS = [.../* @__PURE__ */ new Set([...RESULT_PATH.keys(), ...WINDOW_RESULTS.keys(), ...NESTED_RESULTS.keys()])];
3114
3241
 
3115
3242
  // src/contract.ts
3116
- var CONTRACT_SHA256 = "764fdad5d8851da877e508f4aad2853aaa8fc3b057291488523ef2dd35615208";
3243
+ var CONTRACT_SHA256 = "89943d5297e89b0ae7433b24c3076be1f65ca39a5edc3f338620597b24009226";
3117
3244
 
3118
3245
  // src/close-policy.ts
3119
3246
  var CLOSE_RULES = {
@@ -3167,13 +3294,13 @@ var TOOL_CATALOG = [
3167
3294
  // ── 2. Computer control (TS owners) ──────────────────────────────────────────────────────────
3168
3295
  { 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" },
3169
3296
  { 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" },
3170
- { 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" },
3297
+ { 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" },
3171
3298
  { 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" },
3172
3299
  { name: "desktop_screen", group: "os_control", state: "built", path: "device_op", ops: ["screen.list", "screen.capture"], platforms: ALL, summary: "Displays and screenshots" },
3173
3300
  { 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" },
3174
- { 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" },
3175
- { 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" },
3176
- { name: "desktop_power", group: "os_control", state: "built", path: "device_op", ops: ["power.status", "power.prevent_sleep"], platforms: ALL, summary: "Battery and keep awake" },
3301
+ { 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" },
3302
+ { 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" },
3303
+ { 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" },
3177
3304
  { 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" },
3178
3305
  { 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" },
3179
3306
  // ── 3. Personal apps and automation ──────────────────────────────────────────────────────────
@@ -3543,10 +3670,13 @@ export {
3543
3670
  AudioDevice,
3544
3671
  AudioDevicesParams,
3545
3672
  AudioDevicesResult,
3673
+ AudioLevelsParams,
3674
+ AudioLevelsResult,
3546
3675
  AudioPlayParams,
3547
3676
  AudioPlayResult,
3548
3677
  AudioRecordParams,
3549
3678
  AudioRecordResult,
3679
+ AudioSetLevelsParams,
3550
3680
  BEARER_PREFIX,
3551
3681
  BROADCAST_CID,
3552
3682
  CLOSE_RULES,
@@ -3705,11 +3835,14 @@ export {
3705
3835
  InputHotkeyParams,
3706
3836
  InputHotkeyResult,
3707
3837
  InputKey,
3838
+ InputKeyboardSettingsParams,
3839
+ InputKeyboardSettingsResult,
3708
3840
  InputMouseClickParams,
3709
3841
  InputMouseClickResult,
3710
3842
  InputMouseMoveParams,
3711
3843
  InputMouseMoveResult,
3712
3844
  InputPoint,
3845
+ InputSetKeyboardSettingsParams,
3713
3846
  InputTypeTextParams,
3714
3847
  InputTypeTextResult,
3715
3848
  LEGACY_ACTIONS,
@@ -3740,6 +3873,10 @@ export {
3740
3873
  PROTOCOL_MAJOR,
3741
3874
  PROTOCOL_MINOR,
3742
3875
  PROTOCOL_VERSION,
3876
+ PowerEnergy,
3877
+ PowerHistoryParams,
3878
+ PowerHistoryPoint,
3879
+ PowerHistoryResult,
3743
3880
  PowerPreventSleepParams,
3744
3881
  PowerPreventSleepResult,
3745
3882
  PowerStatusParams,
@@ -3829,6 +3966,7 @@ export {
3829
3966
  Signal,
3830
3967
  SpendAccount,
3831
3968
  SpendChat,
3969
+ SpendDay,
3832
3970
  SpendHelper,
3833
3971
  SpendIdle,
3834
3972
  SpendIdleScope,
@@ -3856,12 +3994,17 @@ export {
3856
3994
  StreamMsg,
3857
3995
  SysinfoGetParams,
3858
3996
  SysinfoGetResult,
3997
+ SysinfoHardwareParams,
3998
+ SysinfoHardwareResult,
3859
3999
  SystemNotifyParams,
3860
4000
  SystemNotifyResult,
3861
4001
  SystemOpenPathParams,
3862
4002
  SystemOpenPathResult,
4003
+ SystemOpenSettingsParams,
4004
+ SystemOpenSettingsResult,
3863
4005
  SystemOpenUrlParams,
3864
4006
  SystemOpenUrlResult,
4007
+ SystemSettingsPane,
3865
4008
  TOOL_CATALOG,
3866
4009
  TOOL_GROUPS,
3867
4010
  TOOL_LEVELS,