@ai-matrx/desktop-protocol 0.17.12 → 0.18.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 0.18.0
+
+The three UUID-shaped ids (`DeviceId`, the desktop app profile id, a coding session's `user_id`) take their pattern from `@ai-matrx/kit/uuid`'s `UUID_SHAPE_PATTERN` instead of spelling the regex. The generated JSON Schema and Pydantic models are byte-identical (`generate --check` contract hash unchanged). New dependency: `@ai-matrx/kit`.
+
+**Consumer action:** none.
+
+## 0.17.13
+### Unreleased
+### (protocol 1.17)
+
+- **What is using the computer.** `resources.activity`: processes grouped into jobs (type-check, tests, build, lint, dev server, language server, search) with who started each, its project folder, duplicates, orphans and queued type-checks; the heaviest processes; the strain verdict; memory as Activity Monitor counts it (used, compressed, pressure); the last hour. `resources.stop_job` stops a listed job's whole tree (protected trees refused). `resources.incidents`: the slowdown log, newest first. `ResourcesDisk.name` (optional): the volume's name as the file manager shows it, stripped for peers below 1.17 (guard: versioning.test.ts "disk name 1.17").
+
+Consumer action: none for older peers.
+
 ## 0.17.12
 ### (protocol 1.16)
 

package/dist/client.cjs

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