@ai-matrx/desktop-protocol 0.21.16 → 0.21.18

package/dist/client.d.cts

@@ -1,8 +1,8 @@
 import { BackoffOptions } from '@ai-matrx/realtime';
 export { RECONNECT_ALARM_ATTEMPTS } from '@ai-matrx/realtime';
 import { z } from 'zod';
-import { W as Welcome, D as DesktopProtocolError, C as CloseOutcome, O as OpName, a as OpParams, b as OpResult, c as OPS, S as StreamMeta, E as EndReason, d as EVENTS, e as ClientType, M as ModelsTranscribeResult, T as TranscriptionModelId, f as MlProgress } from './models-BpZriuN2.cjs';
-export { i as isDesktopProtocolError } from './models-BpZriuN2.cjs';
+import { W as Welcome, D as DesktopProtocolError, C as CloseOutcome, O as OpName, a as OpParams, b as OpResult, c as OPS, S as StreamMeta, E as EndReason, d as EVENTS, e as ClientType, M as ModelsTranscribeResult, T as TranscriptionModelId, f as MlProgress } from './models-xHAz1vPQ.cjs';
+export { i as isDesktopProtocolError } from './models-xHAz1vPQ.cjs';
 import { FrameHeader } from './frame.cjs';
 
 /** The subset of the WHATWG WebSocket the client uses — browser, React Native, `ws` and Workers all fit. */

package/dist/client.d.ts

@@ -1,8 +1,8 @@
 import { BackoffOptions } from '@ai-matrx/realtime';
 export { RECONNECT_ALARM_ATTEMPTS } from '@ai-matrx/realtime';
 import { z } from 'zod';
-import { W as Welcome, D as DesktopProtocolError, C as CloseOutcome, O as OpName, a as OpParams, b as OpResult, c as OPS, S as StreamMeta, E as EndReason, d as EVENTS, e as ClientType, M as ModelsTranscribeResult, T as TranscriptionModelId, f as MlProgress } from './models-BpZriuN2.js';
-export { i as isDesktopProtocolError } from './models-BpZriuN2.js';
+import { W as Welcome, D as DesktopProtocolError, C as CloseOutcome, O as OpName, a as OpParams, b as OpResult, c as OPS, S as StreamMeta, E as EndReason, d as EVENTS, e as ClientType, M as ModelsTranscribeResult, T as TranscriptionModelId, f as MlProgress } from './models-xHAz1vPQ.js';
+export { i as isDesktopProtocolError } from './models-xHAz1vPQ.js';
 import { FrameHeader } from './frame.js';
 
 /** The subset of the WHATWG WebSocket the client uses — browser, React Native, `ws` and Workers all fit. */

package/dist/client.js

@@ -112,7 +112,7 @@ import { z as z2 } from "zod";
 import { z } from "zod";
 import { UUID_SHAPE_PATTERN } from "@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 = z.string().regex(/^[1-9][0-9]{0,2}\.[0-9]{1,3}$/);
 var RequestId = z.string().min(1).max(64).regex(/^[A-Za-z0-9_-]+$/);
@@ -416,6 +416,23 @@ var SysinfoGetResult = z5.strictObject({
     })
   )
 });
+var SysinfoHardwareParams = z5.strictObject({});
+var SysinfoHardwareResult = z5.strictObject({
+  /** "Mac Studio", "MacBook Pro", "ThinkPad X1 Carbon". */
+  model_name: z5.string().max(128).nullable(),
+  /** What tells two of that model apart: "M3 Ultra, 2025", "14-inch, Nov 2023". */
+  model_detail: z5.string().max(128).nullable(),
+  /** "Mac15,14", the vendor's model number. */
+  model_identifier: z5.string().max(128).nullable(),
+  /** "Apple M3 Ultra", "Intel Core i7-1185G7". */
+  chip: z5.string().max(128).nullable(),
+  serial_number: z5.string().max(128).nullable(),
+  /** The OS's own name with its release name: "macOS Tahoe", "Windows 11 Pro", "Ubuntu". */
+  os_name: z5.string().max(64).nullable(),
+  /** "26.6.2". */
+  os_version: z5.string().max(64).nullable(),
+  os_build: z5.string().max(64).nullable()
+});
 
 // src/schema/fs.ts
 import { z as z6 } from "zod";
@@ -1093,6 +1110,21 @@ var SystemNotifyResult = z16.strictObject({
   /** False when this computer has no notification service to show it (a bare Linux box). */
   shown: z16.boolean()
 });
+var SystemSettingsPane = z16.enum([
+  "displays",
+  "night_shift",
+  "sound",
+  "keyboard",
+  "keyboard_shortcuts",
+  "text_input",
+  "dictation",
+  "energy",
+  "about",
+  "storage",
+  "system_report"
+]);
+var SystemOpenSettingsParams = z16.strictObject({ pane: SystemSettingsPane });
+var SystemOpenSettingsResult = z16.strictObject({ pane: SystemSettingsPane });
 
 // src/schema/screen.ts
 import { z as z17 } from "zod";
@@ -1107,7 +1139,13 @@ var ScreenDisplay = z17.strictObject({
   height: z17.int().min(1),
   /** Pixels per point (2 on a Retina display). */
   scale: z17.number().min(0.1).max(8),
-  primary: z17.boolean()
+  primary: z17.boolean(),
+  /** (1.24) Clockwise rotation in degrees (Displays' Rotation: 0 is Standard). */
+  rotation: z17.int().min(0).max(359).optional(),
+  /** (1.24) Refresh rate in hertz; absent where the OS does not say. */
+  refresh_hz: z17.number().min(0).max(1e3).optional(),
+  /** (1.24) The computer's own screen (a laptop's), not one plugged in. */
+  builtin: z17.boolean().optional()
 });
 var ScreenListParams = z17.strictObject({});
 var ScreenListResult = z17.strictObject({ displays: z17.array(ScreenDisplay).max(32) });
@@ -1286,9 +1324,43 @@ var InputMouseClickResult = z19.strictObject({
   button: z19.enum(["left", "right", "middle"]),
   double: z19.boolean()
 });
+var InputKeyboardSettingsParams = z19.strictObject({});
+var InputKeyboardSettingsResult = z19.strictObject({
+  /** Key repeat is off (a held key types once). */
+  repeat_off: z19.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: z19.enum(["nothing", "input_source", "emoji", "dictation"]).nullable(),
+  /** Tab moves focus between every control. */
+  keyboard_navigation: z19.boolean().nullable(),
+  /** The enabled input sources by name ("U.S.", "ABC – Extended"). */
+  input_sources: z19.array(z19.string().max(128)).max(64),
+  /** A key repeat change takes effect only after the person logs out and in again (macOS). */
+  applies_after_login: z19.boolean()
+});
+var InputSetKeyboardSettingsParams = z19.strictObject({
+  repeat_off: z19.boolean().optional(),
+  repeat_interval_ms: z19.int().min(15).max(2e3).optional(),
+  repeat_delay_ms: z19.int().min(150).max(2e3).optional(),
+  keyboard_navigation: z19.boolean().optional()
+});
 
 // src/schema/power.ts
 import { z as z20 } from "zod";
+var PowerEnergy = z20.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: z20.boolean().nullable(),
+  restart_after_power_failure: z20.boolean().nullable(),
+  /** Low Power Mode (Energy Mode "Low Power"). */
+  low_power_mode: z20.boolean().nullable()
+});
 var PowerStatusParams = z20.strictObject({});
 var PowerStatusResult = z20.strictObject({
   has_battery: z20.boolean(),
@@ -1300,7 +1372,15 @@ var PowerStatusResult = z20.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 = z20.strictObject({});
+var PowerHistoryPoint = z20.strictObject({ at_ms: epochMs, percent: z20.number().min(0).max(100), plugged_in: z20.boolean() });
+var PowerHistoryResult = z20.strictObject({
+  /** Oldest first; empty without a battery or where the OS keeps no log. */
+  points: z20.array(PowerHistoryPoint).max(5e3)
 });
 var PowerPreventSleepParams = z20.strictObject({
   /** Keep the computer awake this long; 0 lets it sleep again now. */
@@ -1319,7 +1399,10 @@ var AudioDevice = z21.strictObject({
   /** The OS's name for it, as audio.record takes it. */
   id: z21.string().min(1).max(256),
   name: z21.string().max(256),
-  default: z21.boolean()
+  default: z21.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: z21.string().max(64).optional()
 });
 var AudioDevicesParams = z21.strictObject({});
 var AudioDevicesResult = z21.strictObject({
@@ -1342,6 +1425,20 @@ var AudioRecordResult = z21.strictObject({
 });
 var AudioPlayParams = z21.strictObject({ path: AbsPath });
 var AudioPlayResult = z21.strictObject({ path: AbsPath, seconds: z21.number().min(0) });
+var AudioLevelsParams = z21.strictObject({});
+var AudioLevelsResult = z21.strictObject({
+  output_volume: z21.number().min(0).max(100).nullable(),
+  output_muted: z21.boolean().nullable(),
+  input_volume: z21.number().min(0).max(100).nullable(),
+  /** The alert (beep) volume, a share of the output volume. */
+  alert_volume: z21.number().min(0).max(100).nullable()
+});
+var AudioSetLevelsParams = z21.strictObject({
+  output_volume: z21.number().min(0).max(100).optional(),
+  output_muted: z21.boolean().optional(),
+  input_volume: z21.number().min(0).max(100).optional(),
+  alert_volume: z21.number().min(0).max(100).optional()
+});
 
 // src/schema/resources.ts
 import { z as z22 } from "zod";
@@ -2275,6 +2372,7 @@ var SpendLive = z30.strictObject({ id: ChatId, title: z30.string().max(1e3), win
 var SpendIdleScope = z30.strictObject({ count: nonNegInt, tokens: nonNegInt, cost: z30.number(), avoidable: z30.number() });
 var SpendIdle = z30.strictObject({ id: ChatId, chat: z30.string().max(1e3), who: z30.string().max(400), today: SpendIdleScope, week: SpendIdleScope, last_ms: epochMs });
 var SpendStart = z30.strictObject({ repo: z30.string().max(200), count: nonNegInt, median: nonNegInt, latest: z30.array(nonNegInt).max(20), alarm: z30.string().max(400).nullable() });
+var SpendDay = z30.strictObject({ date: z30.string().regex(/^\d{4}-\d{2}-\d{2}$/), main: z30.number(), helpers: z30.number() });
 var AppsSpendParams = z30.strictObject({ app_key: AppKey });
 var AppsSpendResult = z30.strictObject({
   app_key: AppKey,
@@ -2291,6 +2389,8 @@ var AppsSpendResult = z30.strictObject({
   live: z30.array(SpendLive).max(200),
   accounts: z30.array(SpendAccount).max(200),
   models: z30.array(SpendModel).max(100),
+  /** (1.24) The last 7 days, oldest first (today last). */
+  days: z30.array(SpendDay).max(14).optional(),
   chats: z30.array(SpendChat).max(500),
   idle: z30.array(SpendIdle).max(500),
   starts: z30.array(SpendStart).max(200)
@@ -2316,6 +2416,7 @@ var AppsWindowsSaveNamesParams = z30.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"] },
@@ -2392,6 +2493,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"] },
@@ -2401,16 +2503,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.