@ai-matrx/desktop-protocol 0.17.12 → 0.18.0

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-A0PWllJz.cjs';
-export { i as isDesktopProtocolError } from './models-A0PWllJz.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-BOPMXUz-.cjs';
+export { i as isDesktopProtocolError } from './models-BOPMXUz-.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-A0PWllJz.js';
-export { i as isDesktopProtocolError } from './models-A0PWllJz.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-BOPMXUz-.js';
+export { i as isDesktopProtocolError } from './models-BOPMXUz-.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

@@ -110,13 +110,14 @@ import { z as z2 } from "zod";
 
 // src/schema/primitives.ts
 import { z } from "zod";
+import { UUID_SHAPE_PATTERN } from "@ai-matrx/kit/uuid";
 var PROTOCOL_MAJOR = 1;
-var PROTOCOL_MINOR = 16;
+var PROTOCOL_MINOR = 17;
 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_-]+$/);
 var ResourceId = z.string().regex(/^(pty|watch)_[A-Za-z0-9]{16,40}$/);
-var DeviceId = 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 DeviceId = z.string().regex(UUID_SHAPE_PATTERN);
 var AbsPath = z.string().min(1).max(4096).regex(/^(\/|[A-Za-z]:\/)[^\\\u0000]*$/);
 var u32 = z.int().min(0).max(4294967295);
 var nonNegInt = z.int().min(0);
@@ -1137,6 +1138,8 @@ import { z as z19 } from "zod";
 var ResourcesDisk = z19.strictObject({
   /** Where it is mounted ("/", "C:"). */
   mount: z19.string().max(512),
+  /** The volume's name as the file manager shows it ("Macintosh HD", "Local Disk (C:)"). Since 1.17. */
+  name: z19.string().max(256).optional(),
   /** The file system ("apfs", "NTFS", "ext4"). */
   fs: z19.string().max(64),
   size_bytes: nonNegInt,
@@ -1157,6 +1160,117 @@ var ResourcesSnapshotResult = z19.strictObject({
   disks: z19.array(ResourcesDisk).max(64),
   uptime_seconds: nonNegInt
 });
+var ResourcesJobKind = z19.enum(["type-check", "tests", "build", "lint", "dev server", "language server", "search"]);
+var ResourcesStrain = z19.enum(["good", "strain", "overloaded"]);
+var ResourcesPressure = z19.enum(["normal", "warning", "critical"]);
+var ResourcesJob = z19.strictObject({
+  /** The job's root process (Stop takes its whole tree). */
+  pid: z19.int().min(0),
+  kind: ResourcesJobKind,
+  /** Its heaviest process's command line, shortened ("…/lib/tsc --noEmit -p tsconfig.json"). */
+  command: z19.string().max(256),
+  /** Who started it: "Claude Code", "Codex", "Cursor", "VS Code", "Terminal", "local stack", "detached"; null when unknown. */
+  started_by: z19.string().max(64).nullable(),
+  /** Whatever started it is gone and nothing waits for it. */
+  orphan: z19.boolean(),
+  /** A type-check queued for its turn (no compiler running yet). */
+  waiting: z19.boolean(),
+  /** The project folder it runs in ("matrx-frontend"); null when not in one. */
+  folder: z19.string().max(256).nullable(),
+  /** The same command in the same folder, running this many times (1 = no duplicate). */
+  duplicates: z19.int().min(1),
+  processes: z19.int().min(1),
+  /** Sum over the tree, as `ps` reports it: 100 = one full core. */
+  cpu_percent: z19.number().min(0),
+  /** Real memory (macOS: the physical footprint Activity Monitor shows, compressed included). */
+  memory_bytes: nonNegInt,
+  started_at_ms: epochMs.nullable(),
+  /** False for an app, an agent session, a terminal, a system process, the local stack or Matrx 2 itself. */
+  stoppable: z19.boolean()
+});
+var ResourcesProcess = z19.strictObject({
+  pid: z19.int().min(0),
+  /** The command line, shortened. */
+  name: z19.string().max(256),
+  cpu_percent: z19.number().min(0),
+  memory_bytes: nonNegInt,
+  started_by: z19.string().max(64).nullable(),
+  /** The job it belongs to ("type-check in aidream"); null when none. */
+  job: z19.string().max(256).nullable(),
+  started_at_ms: epochMs.nullable()
+});
+var ResourcesVerdict = z19.strictObject({
+  level: ResourcesStrain,
+  /** One sentence ("Your Mac is under strain. 3 type-checks are running at once."). */
+  text: z19.string().max(256),
+  /** The biggest jobs behind it; null when all is well. */
+  cause: z19.string().max(1024).nullable()
+});
+var ResourcesSample = z19.strictObject({
+  at_ms: epochMs,
+  /** The 1-minute load average. */
+  load: z19.number().min(0),
+  memory_used_bytes: nonNegInt,
+  typechecks: nonNegInt
+});
+var ResourcesActivityParams = z19.strictObject({});
+var ResourcesActivityResult = z19.strictObject({
+  /** False until the first reading (a second or two after start). */
+  ready: z19.boolean(),
+  sampled_at_ms: epochMs.nullable(),
+  cores: z19.int().min(1),
+  /** 1, 5 and 15 minute load averages. */
+  load: z19.array(z19.number().min(0)).length(3),
+  memory: z19.strictObject({
+    total_bytes: nonNegInt,
+    /** Activity Monitor's Memory Used: app memory + wired + compressed. */
+    used_bytes: nonNegInt,
+    /** Data held compressed, and the memory the compressor takes to hold it. */
+    compressed_bytes: nonNegInt,
+    compressor_bytes: nonNegInt,
+    swap_used_bytes: nonNegInt,
+    pressure: ResourcesPressure.nullable()
+  }),
+  verdict: ResourcesVerdict,
+  typechecks: z19.strictObject({ running: nonNegInt, waiting: nonNegInt, comfort: nonNegInt }),
+  /** Heaviest first (1 GB weighs as much as 16 % of a core). */
+  jobs: z19.array(ResourcesJob).max(200),
+  /** The 15 heaviest by memory and the 15 busiest by CPU, together. */
+  top: z19.array(ResourcesProcess).max(30),
+  /** The last hour, oldest first. */
+  history: z19.array(ResourcesSample).max(1200)
+});
+var ResourcesStopJobParams = z19.strictObject({ pid: z19.int().min(1) });
+var ResourcesStopJobResult = z19.strictObject({
+  /** Processes signalled; whatever is still running 5 seconds later is force-stopped. */
+  processes: nonNegInt,
+  /** It had finished before the request arrived. */
+  already_finished: z19.boolean()
+});
+var ResourcesIncident = z19.strictObject({
+  at_ms: epochMs,
+  verdict: ResourcesVerdict,
+  load: z19.number().min(0),
+  memory_used_bytes: nonNegInt,
+  compressed_bytes: nonNegInt,
+  pressure: ResourcesPressure.nullable(),
+  jobs: z19.array(
+    z19.strictObject({
+      kind: ResourcesJobKind,
+      started_by: z19.string().max(64).nullable(),
+      folder: z19.string().max(256).nullable(),
+      command: z19.string().max(256),
+      cpu_percent: z19.number().min(0),
+      memory_bytes: nonNegInt,
+      duplicates: z19.int().min(1)
+    })
+  ).max(8)
+});
+var ResourcesIncidentsParams = z19.strictObject({ limit: z19.int().min(1).max(200).default(50) });
+var ResourcesIncidentsResult = z19.strictObject({
+  /** Newest first; at most one a minute is written. */
+  incidents: z19.array(ResourcesIncident).max(200)
+});
 
 // src/schema/stack.ts
 import { z as z20 } from "zod";
@@ -1322,9 +1436,10 @@ var ExecJobListResult = z22.strictObject({ jobs: z22.array(ExecJobInfo).max(64)
 
 // src/schema/coding.ts
 import { z as z23 } from "zod";
+import { UUID_SHAPE_PATTERN as UUID_SHAPE_PATTERN2 } from "@ai-matrx/kit/uuid";
 var CodingServiceCredentials = z23.strictObject({
   access_token: z23.string().min(16).max(16384),
-  user_id: z23.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}$/),
+  user_id: z23.string().regex(UUID_SHAPE_PATTERN2),
   /** The AI Matrx server this app talks to (production, or a local server on the nightly copy). */
   server_url: z23.string().min(1).max(2048).regex(/^https?:\/\/[^\s/?#]+(\/[^\s?#]*)?$/)
 });
@@ -1397,8 +1512,9 @@ var CodingHistoryProgressEvent = z23.strictObject({
 
 // src/schema/apps.ts
 import { z as z24 } from "zod";
+import { UUID_SHAPE_PATTERN as UUID_SHAPE_PATTERN3 } from "@ai-matrx/kit/uuid";
 var AppKey = z24.string().regex(/^[a-z][a-z0-9_-]{0,39}$/);
-var AppProfileId = z24.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 AppProfileId = z24.string().regex(UUID_SHAPE_PATTERN3);
 var AppProfileLocator = z24.string().min(1).max(512).regex(/^[A-Za-z0-9 _()+@,-][A-Za-z0-9 ._()+@,-]{0,127}(\/[A-Za-z0-9 _()+@,-][A-Za-z0-9 ._()+@,-]{0,127}){0,7}$/);
 var AppSupport = z24.enum(["supported", "partial", "unsupported"]);
 var AppFeatureStatus = z24.strictObject({
@@ -1946,6 +2062,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"] },
+  "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.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"] },