@ai-matrx/desktop-protocol 0.17.12 → 0.18.0

package/dist/index.cjs

@@ -297,9 +297,23 @@ __export(src_exports, {
   RequestMsg: () => RequestMsg,
   ResourceId: () => ResourceId,
   ResourceInfo: () => ResourceInfo,
+  ResourcesActivityParams: () => ResourcesActivityParams,
+  ResourcesActivityResult: () => ResourcesActivityResult,
   ResourcesDisk: () => ResourcesDisk,
+  ResourcesIncident: () => ResourcesIncident,
+  ResourcesIncidentsParams: () => ResourcesIncidentsParams,
+  ResourcesIncidentsResult: () => ResourcesIncidentsResult,
+  ResourcesJob: () => ResourcesJob,
+  ResourcesJobKind: () => ResourcesJobKind,
+  ResourcesPressure: () => ResourcesPressure,
+  ResourcesProcess: () => ResourcesProcess,
+  ResourcesSample: () => ResourcesSample,
   ResourcesSnapshotParams: () => ResourcesSnapshotParams,
   ResourcesSnapshotResult: () => ResourcesSnapshotResult,
+  ResourcesStopJobParams: () => ResourcesStopJobParams,
+  ResourcesStopJobResult: () => ResourcesStopJobResult,
+  ResourcesStrain: () => ResourcesStrain,
+  ResourcesVerdict: () => ResourcesVerdict,
   ResponseMsg: () => ResponseMsg,
   SERVICES: () => SERVICES,
   SERVICE_MAX_FRAME_BYTES: () => SERVICE_MAX_FRAME_BYTES,
@@ -421,13 +435,14 @@ module.exports = __toCommonJS(src_exports);
 
 // 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);
@@ -1222,8 +1237,9 @@ var ModelsProgressEvent = import_zod10.z.strictObject({ request_id: RequestId, p
 
 // src/schema/apps.ts
 var import_zod11 = require("zod");
+var import_uuid2 = require("@ai-matrx/kit/uuid");
 var AppKey = import_zod11.z.string().regex(/^[a-z][a-z0-9_-]{0,39}$/);
-var AppProfileId = import_zod11.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_zod11.z.string().regex(import_uuid2.UUID_SHAPE_PATTERN);
 var AppProfileLocator = import_zod11.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_zod11.z.enum(["supported", "partial", "unsupported"]);
 var AppFeatureStatus = import_zod11.z.strictObject({
@@ -2061,6 +2077,8 @@ var import_zod23 = require("zod");
 var ResourcesDisk = import_zod23.z.strictObject({
   /** Where it is mounted ("/", "C:"). */
   mount: import_zod23.z.string().max(512),
+  /** The volume's name as the file manager shows it ("Macintosh HD", "Local Disk (C:)"). Since 1.17. */
+  name: import_zod23.z.string().max(256).optional(),
   /** The file system ("apfs", "NTFS", "ext4"). */
   fs: import_zod23.z.string().max(64),
   size_bytes: nonNegInt,
@@ -2081,6 +2099,117 @@ var ResourcesSnapshotResult = import_zod23.z.strictObject({
   disks: import_zod23.z.array(ResourcesDisk).max(64),
   uptime_seconds: nonNegInt
 });
+var ResourcesJobKind = import_zod23.z.enum(["type-check", "tests", "build", "lint", "dev server", "language server", "search"]);
+var ResourcesStrain = import_zod23.z.enum(["good", "strain", "overloaded"]);
+var ResourcesPressure = import_zod23.z.enum(["normal", "warning", "critical"]);
+var ResourcesJob = import_zod23.z.strictObject({
+  /** The job's root process (Stop takes its whole tree). */
+  pid: import_zod23.z.int().min(0),
+  kind: ResourcesJobKind,
+  /** Its heaviest process's command line, shortened ("…/lib/tsc --noEmit -p tsconfig.json"). */
+  command: import_zod23.z.string().max(256),
+  /** Who started it: "Claude Code", "Codex", "Cursor", "VS Code", "Terminal", "local stack", "detached"; null when unknown. */
+  started_by: import_zod23.z.string().max(64).nullable(),
+  /** Whatever started it is gone and nothing waits for it. */
+  orphan: import_zod23.z.boolean(),
+  /** A type-check queued for its turn (no compiler running yet). */
+  waiting: import_zod23.z.boolean(),
+  /** The project folder it runs in ("matrx-frontend"); null when not in one. */
+  folder: import_zod23.z.string().max(256).nullable(),
+  /** The same command in the same folder, running this many times (1 = no duplicate). */
+  duplicates: import_zod23.z.int().min(1),
+  processes: import_zod23.z.int().min(1),
+  /** Sum over the tree, as `ps` reports it: 100 = one full core. */
+  cpu_percent: import_zod23.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_zod23.z.boolean()
+});
+var ResourcesProcess = import_zod23.z.strictObject({
+  pid: import_zod23.z.int().min(0),
+  /** The command line, shortened. */
+  name: import_zod23.z.string().max(256),
+  cpu_percent: import_zod23.z.number().min(0),
+  memory_bytes: nonNegInt,
+  started_by: import_zod23.z.string().max(64).nullable(),
+  /** The job it belongs to ("type-check in aidream"); null when none. */
+  job: import_zod23.z.string().max(256).nullable(),
+  started_at_ms: epochMs.nullable()
+});
+var ResourcesVerdict = import_zod23.z.strictObject({
+  level: ResourcesStrain,
+  /** One sentence ("Your Mac is under strain. 3 type-checks are running at once."). */
+  text: import_zod23.z.string().max(256),
+  /** The biggest jobs behind it; null when all is well. */
+  cause: import_zod23.z.string().max(1024).nullable()
+});
+var ResourcesSample = import_zod23.z.strictObject({
+  at_ms: epochMs,
+  /** The 1-minute load average. */
+  load: import_zod23.z.number().min(0),
+  memory_used_bytes: nonNegInt,
+  typechecks: nonNegInt
+});
+var ResourcesActivityParams = import_zod23.z.strictObject({});
+var ResourcesActivityResult = import_zod23.z.strictObject({
+  /** False until the first reading (a second or two after start). */
+  ready: import_zod23.z.boolean(),
+  sampled_at_ms: epochMs.nullable(),
+  cores: import_zod23.z.int().min(1),
+  /** 1, 5 and 15 minute load averages. */
+  load: import_zod23.z.array(import_zod23.z.number().min(0)).length(3),
+  memory: import_zod23.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_zod23.z.strictObject({ running: nonNegInt, waiting: nonNegInt, comfort: nonNegInt }),
+  /** Heaviest first (1 GB weighs as much as 16 % of a core). */
+  jobs: import_zod23.z.array(ResourcesJob).max(200),
+  /** The 15 heaviest by memory and the 15 busiest by CPU, together. */
+  top: import_zod23.z.array(ResourcesProcess).max(30),
+  /** The last hour, oldest first. */
+  history: import_zod23.z.array(ResourcesSample).max(1200)
+});
+var ResourcesStopJobParams = import_zod23.z.strictObject({ pid: import_zod23.z.int().min(1) });
+var ResourcesStopJobResult = import_zod23.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_zod23.z.boolean()
+});
+var ResourcesIncident = import_zod23.z.strictObject({
+  at_ms: epochMs,
+  verdict: ResourcesVerdict,
+  load: import_zod23.z.number().min(0),
+  memory_used_bytes: nonNegInt,
+  compressed_bytes: nonNegInt,
+  pressure: ResourcesPressure.nullable(),
+  jobs: import_zod23.z.array(
+    import_zod23.z.strictObject({
+      kind: ResourcesJobKind,
+      started_by: import_zod23.z.string().max(64).nullable(),
+      folder: import_zod23.z.string().max(256).nullable(),
+      command: import_zod23.z.string().max(256),
+      cpu_percent: import_zod23.z.number().min(0),
+      memory_bytes: nonNegInt,
+      duplicates: import_zod23.z.int().min(1)
+    })
+  ).max(8)
+});
+var ResourcesIncidentsParams = import_zod23.z.strictObject({ limit: import_zod23.z.int().min(1).max(200).default(50) });
+var ResourcesIncidentsResult = import_zod23.z.strictObject({
+  /** Newest first; at most one a minute is written. */
+  incidents: import_zod23.z.array(ResourcesIncident).max(200)
+});
 
 // src/schema/stack.ts
 var import_zod24 = require("zod");
@@ -2276,9 +2405,10 @@ var ExecJobListResult = import_zod27.z.strictObject({ jobs: import_zod27.z.array
 
 // src/schema/coding.ts
 var import_zod28 = require("zod");
+var import_uuid3 = require("@ai-matrx/kit/uuid");
 var CodingServiceCredentials = import_zod28.z.strictObject({
   access_token: import_zod28.z.string().min(16).max(16384),
-  user_id: import_zod28.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_zod28.z.string().regex(import_uuid3.UUID_SHAPE_PATTERN),
   /** The AI Matrx server this app talks to (production, or a local server on the nightly copy). */
   server_url: import_zod28.z.string().min(1).max(2048).regex(/^https?:\/\/[^\s/?#]+(\/[^\s?#]*)?$/)
 });
@@ -2443,6 +2573,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"] },
@@ -2677,6 +2810,20 @@ var NAMED_SCHEMAS = {
   ResourcesDisk,
   ResourcesSnapshotParams,
   ResourcesSnapshotResult,
+  ResourcesJobKind,
+  ResourcesStrain,
+  ResourcesPressure,
+  ResourcesVerdict,
+  ResourcesSample,
+  ResourcesJob,
+  ResourcesProcess,
+  ResourcesActivityParams,
+  ResourcesActivityResult,
+  ResourcesStopJobParams,
+  ResourcesStopJobResult,
+  ResourcesIncident,
+  ResourcesIncidentsParams,
+  ResourcesIncidentsResult,
   AudioDevice,
   AudioDevicesParams,
   AudioDevicesResult,
@@ -2828,7 +2975,8 @@ var FIELDS_SINCE = {
   AppsAccountsUsageResult: { problem: "1.12" },
   AppsAccountsResetsResult: { problem: "1.12" },
   ChatRow: { app_project: "1.13", tokens: "1.13", original_title: "1.14", title_source: "1.14", title_override: "1.14", archived: "1.15" },
-  AccountUsage: { plan: "1.13", credits: "1.13" }
+  AccountUsage: { plan: "1.13", credits: "1.13" },
+  ResourcesDisk: { name: "1.17" }
 };
 var NULL_SINCE = {
   "RelayDeviceStatusEvent.since_ms": { since: "1.1", olderPeersGet: 0 }
@@ -2895,7 +3043,8 @@ var NESTED_RESULTS = /* @__PURE__ */ new Map([
   ["apps.projects.move", [["chat", "ChatRow"]]],
   ["apps.chats.star", [["chat", "ChatRow"]]],
   ["apps.chats.place", [["chat", "ChatRow"]]],
-  ["apps.accounts.usage", [["accounts", "AccountUsage"]]]
+  ["apps.accounts.usage", [["accounts", "AccountUsage"]]],
+  ["resources.snapshot", [["disks", "ResourcesDisk"]]]
 ]);
 function stripNested(value, nested, version) {
   if (value === null || typeof value !== "object" || Array.isArray(value)) return value;
@@ -2956,7 +3105,7 @@ function forPeer(op, part, value, version) {
 var VERSIONED_RESULT_OPS = [.../* @__PURE__ */ new Set([...RESULT_PATH.keys(), ...WINDOW_RESULTS.keys(), ...NESTED_RESULTS.keys()])];
 
 // src/contract.ts
-var CONTRACT_SHA256 = "ee6873cbbdcba3960248ff0c5c71fe47c663b54c6e657d62d1ed5e04e51f17e2";
+var CONTRACT_SHA256 = "cdfad283c689005856b4161f28a37892d1c3356db077f685a4a659fc2c8fc657";
 
 // src/close-policy.ts
 var CLOSE_RULES = {
@@ -3016,7 +3165,7 @@ var TOOL_CATALOG = [
   { 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: "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: "desktop_resources", group: "os_control", state: "built", path: "device_op", ops: ["resources.snapshot", "resources.activity", "resources.stop_job", "resources.incidents"], platforms: ALL, summary: "CPU, memory and disk use; what is using them, grouped into jobs; stop a job; the slowdown log" },
   { 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" },
   // ── 3. Personal apps and automation ──────────────────────────────────────────────────────────
   { name: "desktop_automation", group: "personal_automation", state: "planned", path: "device_op", ops: ["automation.script"], platforms: ["darwin", "win32"], summary: "AppleScript on a Mac, PowerShell on Windows" },