@ai-matrx/desktop-protocol 0.16.1 → 0.17.0

package/dist/index.cjs

@@ -39,6 +39,13 @@ __export(src_exports, {
   AppsProfilesRemoveResult: () => AppsProfilesRemoveResult,
   AppsProfilesSaveParams: () => AppsProfilesSaveParams,
   AppsProfilesSaveResult: () => AppsProfilesSaveResult,
+  AudioDevice: () => AudioDevice,
+  AudioDevicesParams: () => AudioDevicesParams,
+  AudioDevicesResult: () => AudioDevicesResult,
+  AudioPlayParams: () => AudioPlayParams,
+  AudioPlayResult: () => AudioPlayResult,
+  AudioRecordParams: () => AudioRecordParams,
+  AudioRecordResult: () => AudioRecordResult,
   BEARER_PREFIX: () => BEARER_PREFIX,
   BROADCAST_CID: () => BROADCAST_CID,
   CLOSE_RULES: () => CLOSE_RULES,
@@ -325,7 +332,7 @@ module.exports = __toCommonJS(src_exports);
 // src/schema/primitives.ts
 var import_zod = require("zod");
 var PROTOCOL_MAJOR = 1;
-var PROTOCOL_MINOR = 5;
+var PROTOCOL_MINOR = 6;
 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_-]+$/);
@@ -1595,91 +1602,121 @@ var ResourcesSnapshotResult = import_zod21.z.strictObject({
   uptime_seconds: nonNegInt
 });
 
-// src/schema/fs-watch.ts
+// src/schema/audio.ts
 var import_zod22 = require("zod");
-var FsWatchId = import_zod22.z.string().regex(/^fw_[A-Za-z0-9]{12,40}$/);
-var FsWatchStartParams = import_zod22.z.strictObject({
+var AudioDevice = import_zod22.z.strictObject({
+  /** The OS's name for it, as audio.record takes it. */
+  id: import_zod22.z.string().min(1).max(256),
+  name: import_zod22.z.string().max(256),
+  default: import_zod22.z.boolean()
+});
+var AudioDevicesParams = import_zod22.z.strictObject({});
+var AudioDevicesResult = import_zod22.z.strictObject({
+  inputs: import_zod22.z.array(AudioDevice).max(64),
+  outputs: import_zod22.z.array(AudioDevice).max(64)
+});
+var AudioRecordParams = import_zod22.z.strictObject({
+  seconds: import_zod22.z.number().min(0.5).max(600),
+  /** The microphone (from audio.devices); the default input when absent. */
+  device_id: import_zod22.z.string().min(1).max(256).optional(),
+  /** Where the WAV file goes; a new file in the temp folder when absent. */
+  path: AbsPath.optional()
+});
+var AudioRecordResult = import_zod22.z.strictObject({
   path: AbsPath,
-  recursive: import_zod22.z.boolean().default(true),
+  seconds: import_zod22.z.number().min(0),
+  bytes: nonNegInt,
+  /** Loudest sample, 0–1: 0 means the device gave silence. */
+  peak: import_zod22.z.number().min(0).max(1)
+});
+var AudioPlayParams = import_zod22.z.strictObject({ path: AbsPath });
+var AudioPlayResult = import_zod22.z.strictObject({ path: AbsPath, seconds: import_zod22.z.number().min(0) });
+
+// src/schema/fs-watch.ts
+var import_zod23 = require("zod");
+var FsWatchId = import_zod23.z.string().regex(/^fw_[A-Za-z0-9]{12,40}$/);
+var FsWatchStartParams = import_zod23.z.strictObject({
+  path: AbsPath,
+  recursive: import_zod23.z.boolean().default(true),
   /** Globs relative to `path` whose changes are not reported (".git/**", "node_modules/**"). */
-  ignore: import_zod22.z.array(import_zod22.z.string().max(256)).max(64).default([])
+  ignore: import_zod23.z.array(import_zod23.z.string().max(256)).max(64).default([])
 });
-var FsWatchStartResult = import_zod22.z.strictObject({
+var FsWatchStartResult = import_zod23.z.strictObject({
   watch_id: FsWatchId,
   path: AbsPath,
   /** The watch ends by itself if nobody reads it for 30 minutes. */
   expires_at_ms: epochMs
 });
-var FsWatchEventsParams = import_zod22.z.strictObject({
+var FsWatchEventsParams = import_zod23.z.strictObject({
   watch_id: FsWatchId,
   /** Wait up to this long for a first change when none is waiting (0 answers at once). */
-  wait_ms: import_zod22.z.int().min(0).max(25e3).default(0)
+  wait_ms: import_zod23.z.int().min(0).max(25e3).default(0)
 });
-var FsWatchEventsResult = import_zod22.z.strictObject({
+var FsWatchEventsResult = import_zod23.z.strictObject({
   /** What changed since the last read, oldest first; re-checked against the disk when read. */
-  changes: import_zod22.z.array(FsChange).max(1e3),
+  changes: import_zod23.z.array(FsChange).max(1e3),
   /** Changes were dropped (more than 1000 waited): list the folder again. */
-  overflow: import_zod22.z.boolean(),
+  overflow: import_zod23.z.boolean(),
   expires_at_ms: epochMs
 });
-var FsWatchStopParams = import_zod22.z.strictObject({ watch_id: FsWatchId });
-var FsWatchStopResult = import_zod22.z.strictObject({ watch_id: FsWatchId });
+var FsWatchStopParams = import_zod23.z.strictObject({ watch_id: FsWatchId });
+var FsWatchStopResult = import_zod23.z.strictObject({ watch_id: FsWatchId });
 
 // src/schema/exec-job.ts
-var import_zod23 = require("zod");
-var ExecJobId = import_zod23.z.string().regex(/^job_[A-Za-z0-9]{12,40}$/);
-var ExecJobStartParams = import_zod23.z.strictObject({
-  command: import_zod23.z.string().min(1).max(131072),
+var import_zod24 = require("zod");
+var ExecJobId = import_zod24.z.string().regex(/^job_[A-Za-z0-9]{12,40}$/);
+var ExecJobStartParams = import_zod24.z.strictObject({
+  command: import_zod24.z.string().min(1).max(131072),
   /** The folder it runs in; the home folder when absent. */
   cwd: AbsPath.optional(),
-  env: import_zod23.z.record(import_zod23.z.string().regex(/^[A-Za-z_][A-Za-z0-9_]*$/).max(128), import_zod23.z.string().max(32768)).optional()
+  env: import_zod24.z.record(import_zod24.z.string().regex(/^[A-Za-z_][A-Za-z0-9_]*$/).max(128), import_zod24.z.string().max(32768)).optional()
 });
-var ExecJobStartResult = import_zod23.z.strictObject({ job_id: ExecJobId, pid: import_zod23.z.int().min(1), cwd: AbsPath });
-var ExecJobOutputParams = import_zod23.z.strictObject({
+var ExecJobStartResult = import_zod24.z.strictObject({ job_id: ExecJobId, pid: import_zod24.z.int().min(1), cwd: AbsPath });
+var ExecJobOutputParams = import_zod24.z.strictObject({
   job_id: ExecJobId,
   /** Byte offset into the job's output to read from (next_offset of the last read; 0 = the start). */
   offset: nonNegInt.default(0),
   /** Wait up to this long for new output or the exit when none is waiting (0 answers at once). */
-  wait_ms: import_zod23.z.int().min(0).max(25e3).default(0),
-  max_bytes: import_zod23.z.int().min(1024).max(1048576).default(65536)
+  wait_ms: import_zod24.z.int().min(0).max(25e3).default(0),
+  max_bytes: import_zod24.z.int().min(1024).max(1048576).default(65536)
 });
-var ExecJobOutputResult = import_zod23.z.strictObject({
+var ExecJobOutputResult = import_zod24.z.strictObject({
   /** stdout and stderr interleaved as they arrived (UTF-8). */
-  output: import_zod23.z.string(),
+  output: import_zod24.z.string(),
   next_offset: nonNegInt,
   /** Bytes before `offset` that are gone (the job keeps its last 4 MiB). */
   dropped_bytes: nonNegInt,
-  running: import_zod23.z.boolean(),
-  exit_code: import_zod23.z.int().nullable()
+  running: import_zod24.z.boolean(),
+  exit_code: import_zod24.z.int().nullable()
 });
-var ExecJobStopParams = import_zod23.z.strictObject({
+var ExecJobStopParams = import_zod24.z.strictObject({
   job_id: ExecJobId,
   /** End it at once (SIGKILL; on Windows the whole tree with /F) instead of asking it to quit. */
-  force: import_zod23.z.boolean().default(false)
+  force: import_zod24.z.boolean().default(false)
 });
-var ExecJobStopResult = import_zod23.z.strictObject({ job_id: ExecJobId, exited: import_zod23.z.boolean(), exit_code: import_zod23.z.int().nullable() });
-var ExecJobInfo = import_zod23.z.strictObject({
+var ExecJobStopResult = import_zod24.z.strictObject({ job_id: ExecJobId, exited: import_zod24.z.boolean(), exit_code: import_zod24.z.int().nullable() });
+var ExecJobInfo = import_zod24.z.strictObject({
   job_id: ExecJobId,
-  command: import_zod23.z.string().max(1024),
-  pid: import_zod23.z.int().min(1),
+  command: import_zod24.z.string().max(1024),
+  pid: import_zod24.z.int().min(1),
   cwd: AbsPath,
-  running: import_zod23.z.boolean(),
-  exit_code: import_zod23.z.int().nullable(),
+  running: import_zod24.z.boolean(),
+  exit_code: import_zod24.z.int().nullable(),
   started_at_ms: epochMs,
   output_bytes: nonNegInt
 });
-var ExecJobListParams = import_zod23.z.strictObject({});
-var ExecJobListResult = import_zod23.z.strictObject({ jobs: import_zod23.z.array(ExecJobInfo).max(64) });
+var ExecJobListParams = import_zod24.z.strictObject({});
+var ExecJobListResult = import_zod24.z.strictObject({ jobs: import_zod24.z.array(ExecJobInfo).max(64) });
 
 // src/schema/coding.ts
-var import_zod24 = require("zod");
-var CodingServiceCredentials = import_zod24.z.strictObject({
-  access_token: import_zod24.z.string().min(16).max(16384),
-  user_id: import_zod24.z.string().regex(/^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/),
+var import_zod25 = require("zod");
+var CodingServiceCredentials = import_zod25.z.strictObject({
+  access_token: import_zod25.z.string().min(16).max(16384),
+  user_id: import_zod25.z.string().regex(/^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/),
   /** The AI Matrx server this app talks to (production, or a local server on the nightly copy). */
-  server_url: import_zod24.z.string().min(1).max(2048).regex(/^https?:\/\/[^\s/?#]+(\/[^\s?#]*)?$/)
+  server_url: import_zod25.z.string().min(1).max(2048).regex(/^https?:\/\/[^\s/?#]+(\/[^\s?#]*)?$/)
 });
-var CodingHistoryBlocked = import_zod24.z.enum([
+var CodingHistoryBlocked = import_zod25.z.enum([
   "signed_out",
   "offline",
   "organization_required",
@@ -1687,11 +1724,11 @@ var CodingHistoryBlocked = import_zod24.z.enum([
   "cloud_list_unavailable",
   "history_too_large"
 ]);
-var CodingHistoryFailure = import_zod24.z.strictObject({
-  session_id: import_zod24.z.string().max(64),
-  reason: import_zod24.z.string().max(300)
+var CodingHistoryFailure = import_zod25.z.strictObject({
+  session_id: import_zod25.z.string().max(64),
+  reason: import_zod25.z.string().max(300)
 });
-var CodingHistoryRun = import_zod24.z.strictObject({
+var CodingHistoryRun = import_zod25.z.strictObject({
   /** Claude Code sessions found on this computer. */
   local_sessions: nonNegInt,
   /** Of those, already complete in AI Matrx. */
@@ -1706,39 +1743,39 @@ var CodingHistoryRun = import_zod24.z.strictObject({
   /** Changed while being read; a later run takes them. */
   changed: nonNegInt,
   failed: nonNegInt,
-  failures: import_zod24.z.array(CodingHistoryFailure).max(20),
+  failures: import_zod25.z.array(CodingHistoryFailure).max(20),
   /** Candidates not reached yet. */
   remaining: nonNegInt,
   /** The one line a person reads, e.g. "Imported 12 of 14 sessions. 140 already in AI Matrx." */
-  summary: import_zod24.z.string().max(400)
+  summary: import_zod25.z.string().max(400)
 });
-var CodingHistoryStep = import_zod24.z.strictObject({
+var CodingHistoryStep = import_zod25.z.strictObject({
   /** Null when the run could not start (blocked before a plan existed). */
-  plan_id: import_zod24.z.string().regex(/^[0-9a-f]{32}$/).nullable(),
-  finished: import_zod24.z.boolean(),
+  plan_id: import_zod25.z.string().regex(/^[0-9a-f]{32}$/).nullable(),
+  finished: import_zod25.z.boolean(),
   blocked: CodingHistoryBlocked.nullable(),
   run: CodingHistoryRun
 });
-var CodingPlanMissingParams = import_zod24.z.strictObject({ credentials: CodingServiceCredentials.nullable() });
-var CodingImportNextParams = import_zod24.z.strictObject({
-  plan_id: import_zod24.z.string().regex(/^[0-9a-f]{32}$/),
+var CodingPlanMissingParams = import_zod25.z.strictObject({ credentials: CodingServiceCredentials.nullable() });
+var CodingImportNextParams = import_zod25.z.strictObject({
+  plan_id: import_zod25.z.string().regex(/^[0-9a-f]{32}$/),
   credentials: CodingServiceCredentials.nullable()
 });
-var CodingServiceProgress = import_zod24.z.strictObject({
-  phase: import_zod24.z.enum(["checking", "importing"]),
+var CodingServiceProgress = import_zod25.z.strictObject({
+  phase: import_zod25.z.enum(["checking", "importing"]),
   done: nonNegInt,
   total: nonNegInt
 });
-var CodingHistoryImportMissingParams = import_zod24.z.strictObject({});
-var CodingHistoryImportMissingResult = import_zod24.z.strictObject({
-  state: import_zod24.z.enum(["done", "blocked", "cancelled"]),
+var CodingHistoryImportMissingParams = import_zod25.z.strictObject({});
+var CodingHistoryImportMissingResult = import_zod25.z.strictObject({
+  state: import_zod25.z.enum(["done", "blocked", "cancelled"]),
   blocked: CodingHistoryBlocked.nullable(),
   run: CodingHistoryRun,
   elapsed_ms: nonNegInt
 });
-var CodingHistoryProgressEvent = import_zod24.z.strictObject({
+var CodingHistoryProgressEvent = import_zod25.z.strictObject({
   request_id: RequestId,
-  phase: import_zod24.z.enum(["checking", "importing"]),
+  phase: import_zod25.z.enum(["checking", "importing"]),
   /** Sessions settled so far, of `total` candidates (0 of 0 while checking). */
   done: nonNegInt,
   total: nonNegInt,
@@ -1811,6 +1848,9 @@ var OPS = {
   "power.status": { params: PowerStatusParams, result: PowerStatusResult, kind: "unary", since: "1.4", 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"] },
+  "audio.devices": { params: AudioDevicesParams, result: AudioDevicesResult, kind: "unary", since: "1.6", errors: ["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"] },
   // Claude Code history (SPEC §6 coding): served by the `coding` Python service through SERVICES below.
   "coding.history.import_missing": { params: CodingHistoryImportMissingParams, result: CodingHistoryImportMissingResult, kind: "unary", since: "1.5", errors: ["RESOURCE_BUSY", "RESOURCE_GONE", "CANCELLED", "INTERNAL"] }
 };
@@ -2033,6 +2073,13 @@ var NAMED_SCHEMAS = {
   ResourcesDisk,
   ResourcesSnapshotParams,
   ResourcesSnapshotResult,
+  AudioDevice,
+  AudioDevicesParams,
+  AudioDevicesResult,
+  AudioRecordParams,
+  AudioRecordResult,
+  AudioPlayParams,
+  AudioPlayResult,
   FsWatchId,
   FsWatchStartParams,
   FsWatchStartResult,
@@ -2155,7 +2202,7 @@ function forPeer(op, part, value, version) {
 var VERSIONED_RESULT_OPS = [...RESULT_PATH.keys()];
 
 // src/contract.ts
-var CONTRACT_SHA256 = "c49a85cdd157d6f50e0050e86d4ea789e916c05a0bf16c8002d833b57225548d";
+var CONTRACT_SHA256 = "2cbf3c7589a30141305f6f0f38c4d4a32bf9ef2a890f7572d9c7bd15c398d4b9";
 
 // src/close-policy.ts
 var CLOSE_RULES = {
@@ -2213,7 +2260,7 @@ var TOOL_CATALOG = [
   { 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: "planned", path: "device_op", ops: ["audio.devices", "audio.record", "audio.play"], platforms: ALL, summary: "Audio devices, record, play" },
+  { 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_resources", group: "os_control", state: "built", path: "device_op", ops: ["resources.snapshot"], platforms: ALL, summary: "CPU, memory and disk use" },
   { 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" },