@ai-matrx/desktop-protocol 0.21.16 → 0.21.18

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.21.18
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/desktop-protocol/v0.21.17..npm/desktop-protocol/v0.21.18 -- apps/shared/desktop-protocol`).
+No source changes intended and no consumer action required.
+
+## 0.21.17
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/desktop-protocol/v0.21.16..npm/desktop-protocol/v0.21.17 -- apps/shared/desktop-protocol`).
+No source changes intended and no consumer action required.
+
 ## 0.21.16
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see

package/dist/client.cjs

@@ -144,7 +144,7 @@ var import_zod2 = require("zod");
 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_-]+$/);
@@ -448,6 +448,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");
@@ -1125,6 +1142,21 @@ var SystemNotifyResult = import_zod16.z.strictObject({
   /** False when this computer has no notification service to show it (a bare Linux box). */
   shown: import_zod16.z.boolean()
 });
+var SystemSettingsPane = import_zod16.z.enum([
+  "displays",
+  "night_shift",
+  "sound",
+  "keyboard",
+  "keyboard_shortcuts",
+  "text_input",
+  "dictation",
+  "energy",
+  "about",
+  "storage",
+  "system_report"
+]);
+var SystemOpenSettingsParams = import_zod16.z.strictObject({ pane: SystemSettingsPane });
+var SystemOpenSettingsResult = import_zod16.z.strictObject({ pane: SystemSettingsPane });
 
 // src/schema/screen.ts
 var import_zod17 = require("zod");
@@ -1139,7 +1171,13 @@ var ScreenDisplay = import_zod17.z.strictObject({
   height: import_zod17.z.int().min(1),
   /** Pixels per point (2 on a Retina display). */
   scale: import_zod17.z.number().min(0.1).max(8),
-  primary: import_zod17.z.boolean()
+  primary: import_zod17.z.boolean(),
+  /** (1.24) Clockwise rotation in degrees (Displays' Rotation: 0 is Standard). */
+  rotation: import_zod17.z.int().min(0).max(359).optional(),
+  /** (1.24) Refresh rate in hertz; absent where the OS does not say. */
+  refresh_hz: import_zod17.z.number().min(0).max(1e3).optional(),
+  /** (1.24) The computer's own screen (a laptop's), not one plugged in. */
+  builtin: import_zod17.z.boolean().optional()
 });
 var ScreenListParams = import_zod17.z.strictObject({});
 var ScreenListResult = import_zod17.z.strictObject({ displays: import_zod17.z.array(ScreenDisplay).max(32) });
@@ -1318,9 +1356,43 @@ var InputMouseClickResult = import_zod19.z.strictObject({
   button: import_zod19.z.enum(["left", "right", "middle"]),
   double: import_zod19.z.boolean()
 });
+var InputKeyboardSettingsParams = import_zod19.z.strictObject({});
+var InputKeyboardSettingsResult = import_zod19.z.strictObject({
+  /** Key repeat is off (a held key types once). */
+  repeat_off: import_zod19.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_zod19.z.enum(["nothing", "input_source", "emoji", "dictation"]).nullable(),
+  /** Tab moves focus between every control. */
+  keyboard_navigation: import_zod19.z.boolean().nullable(),
+  /** The enabled input sources by name ("U.S.", "ABC – Extended"). */
+  input_sources: import_zod19.z.array(import_zod19.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_zod19.z.boolean()
+});
+var InputSetKeyboardSettingsParams = import_zod19.z.strictObject({
+  repeat_off: import_zod19.z.boolean().optional(),
+  repeat_interval_ms: import_zod19.z.int().min(15).max(2e3).optional(),
+  repeat_delay_ms: import_zod19.z.int().min(150).max(2e3).optional(),
+  keyboard_navigation: import_zod19.z.boolean().optional()
+});
 
 // src/schema/power.ts
 var import_zod20 = require("zod");
+var PowerEnergy = import_zod20.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_zod20.z.boolean().nullable(),
+  restart_after_power_failure: import_zod20.z.boolean().nullable(),
+  /** Low Power Mode (Energy Mode "Low Power"). */
+  low_power_mode: import_zod20.z.boolean().nullable()
+});
 var PowerStatusParams = import_zod20.z.strictObject({});
 var PowerStatusResult = import_zod20.z.strictObject({
   has_battery: import_zod20.z.boolean(),
@@ -1332,7 +1404,15 @@ var PowerStatusResult = import_zod20.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_zod20.z.strictObject({});
+var PowerHistoryPoint = import_zod20.z.strictObject({ at_ms: epochMs, percent: import_zod20.z.number().min(0).max(100), plugged_in: import_zod20.z.boolean() });
+var PowerHistoryResult = import_zod20.z.strictObject({
+  /** Oldest first; empty without a battery or where the OS keeps no log. */
+  points: import_zod20.z.array(PowerHistoryPoint).max(5e3)
 });
 var PowerPreventSleepParams = import_zod20.z.strictObject({
   /** Keep the computer awake this long; 0 lets it sleep again now. */
@@ -1351,7 +1431,10 @@ var AudioDevice = import_zod21.z.strictObject({
   /** The OS's name for it, as audio.record takes it. */
   id: import_zod21.z.string().min(1).max(256),
   name: import_zod21.z.string().max(256),
-  default: import_zod21.z.boolean()
+  default: import_zod21.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_zod21.z.string().max(64).optional()
 });
 var AudioDevicesParams = import_zod21.z.strictObject({});
 var AudioDevicesResult = import_zod21.z.strictObject({
@@ -1374,6 +1457,20 @@ var AudioRecordResult = import_zod21.z.strictObject({
 });
 var AudioPlayParams = import_zod21.z.strictObject({ path: AbsPath });
 var AudioPlayResult = import_zod21.z.strictObject({ path: AbsPath, seconds: import_zod21.z.number().min(0) });
+var AudioLevelsParams = import_zod21.z.strictObject({});
+var AudioLevelsResult = import_zod21.z.strictObject({
+  output_volume: import_zod21.z.number().min(0).max(100).nullable(),
+  output_muted: import_zod21.z.boolean().nullable(),
+  input_volume: import_zod21.z.number().min(0).max(100).nullable(),
+  /** The alert (beep) volume, a share of the output volume. */
+  alert_volume: import_zod21.z.number().min(0).max(100).nullable()
+});
+var AudioSetLevelsParams = import_zod21.z.strictObject({
+  output_volume: import_zod21.z.number().min(0).max(100).optional(),
+  output_muted: import_zod21.z.boolean().optional(),
+  input_volume: import_zod21.z.number().min(0).max(100).optional(),
+  alert_volume: import_zod21.z.number().min(0).max(100).optional()
+});
 
 // src/schema/resources.ts
 var import_zod22 = require("zod");
@@ -2307,6 +2404,7 @@ var SpendLive = import_zod30.z.strictObject({ id: ChatId, title: import_zod30.z.
 var SpendIdleScope = import_zod30.z.strictObject({ count: nonNegInt, tokens: nonNegInt, cost: import_zod30.z.number(), avoidable: import_zod30.z.number() });
 var SpendIdle = import_zod30.z.strictObject({ id: ChatId, chat: import_zod30.z.string().max(1e3), who: import_zod30.z.string().max(400), today: SpendIdleScope, week: SpendIdleScope, last_ms: epochMs });
 var SpendStart = import_zod30.z.strictObject({ repo: import_zod30.z.string().max(200), count: nonNegInt, median: nonNegInt, latest: import_zod30.z.array(nonNegInt).max(20), alarm: import_zod30.z.string().max(400).nullable() });
+var SpendDay = import_zod30.z.strictObject({ date: import_zod30.z.string().regex(/^\d{4}-\d{2}-\d{2}$/), main: import_zod30.z.number(), helpers: import_zod30.z.number() });
 var AppsSpendParams = import_zod30.z.strictObject({ app_key: AppKey });
 var AppsSpendResult = import_zod30.z.strictObject({
   app_key: AppKey,
@@ -2323,6 +2421,8 @@ var AppsSpendResult = import_zod30.z.strictObject({
   live: import_zod30.z.array(SpendLive).max(200),
   accounts: import_zod30.z.array(SpendAccount).max(200),
   models: import_zod30.z.array(SpendModel).max(100),
+  /** (1.24) The last 7 days, oldest first (today last). */
+  days: import_zod30.z.array(SpendDay).max(14).optional(),
   chats: import_zod30.z.array(SpendChat).max(500),
   idle: import_zod30.z.array(SpendIdle).max(500),
   starts: import_zod30.z.array(SpendStart).max(200)
@@ -2348,6 +2448,7 @@ var AppsWindowsSaveNamesParams = import_zod30.z.strictObject({ app_key: AppKey }
 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"] },
@@ -2424,6 +2525,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"] },
@@ -2433,16 +2535,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.