@ai-matrx/desktop-protocol 0.17.11 → 0.17.13

package/dist/index.js

@@ -1,7 +1,7 @@
 // src/schema/primitives.ts
 import { z } from "zod";
 var PROTOCOL_MAJOR = 1;
-var PROTOCOL_MINOR = 15;
+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_-]+$/);
@@ -1640,6 +1640,8 @@ import { z as z23 } from "zod";
 var ResourcesDisk = z23.strictObject({
   /** Where it is mounted ("/", "C:"). */
   mount: z23.string().max(512),
+  /** The volume's name as the file manager shows it ("Macintosh HD", "Local Disk (C:)"). Since 1.17. */
+  name: z23.string().max(256).optional(),
   /** The file system ("apfs", "NTFS", "ext4"). */
   fs: z23.string().max(64),
   size_bytes: nonNegInt,
@@ -1660,122 +1662,319 @@ var ResourcesSnapshotResult = z23.strictObject({
   disks: z23.array(ResourcesDisk).max(64),
   uptime_seconds: nonNegInt
 });
+var ResourcesJobKind = z23.enum(["type-check", "tests", "build", "lint", "dev server", "language server", "search"]);
+var ResourcesStrain = z23.enum(["good", "strain", "overloaded"]);
+var ResourcesPressure = z23.enum(["normal", "warning", "critical"]);
+var ResourcesJob = z23.strictObject({
+  /** The job's root process (Stop takes its whole tree). */
+  pid: z23.int().min(0),
+  kind: ResourcesJobKind,
+  /** Its heaviest process's command line, shortened ("…/lib/tsc --noEmit -p tsconfig.json"). */
+  command: z23.string().max(256),
+  /** Who started it: "Claude Code", "Codex", "Cursor", "VS Code", "Terminal", "local stack", "detached"; null when unknown. */
+  started_by: z23.string().max(64).nullable(),
+  /** Whatever started it is gone and nothing waits for it. */
+  orphan: z23.boolean(),
+  /** A type-check queued for its turn (no compiler running yet). */
+  waiting: z23.boolean(),
+  /** The project folder it runs in ("matrx-frontend"); null when not in one. */
+  folder: z23.string().max(256).nullable(),
+  /** The same command in the same folder, running this many times (1 = no duplicate). */
+  duplicates: z23.int().min(1),
+  processes: z23.int().min(1),
+  /** Sum over the tree, as `ps` reports it: 100 = one full core. */
+  cpu_percent: z23.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: z23.boolean()
+});
+var ResourcesProcess = z23.strictObject({
+  pid: z23.int().min(0),
+  /** The command line, shortened. */
+  name: z23.string().max(256),
+  cpu_percent: z23.number().min(0),
+  memory_bytes: nonNegInt,
+  started_by: z23.string().max(64).nullable(),
+  /** The job it belongs to ("type-check in aidream"); null when none. */
+  job: z23.string().max(256).nullable(),
+  started_at_ms: epochMs.nullable()
+});
+var ResourcesVerdict = z23.strictObject({
+  level: ResourcesStrain,
+  /** One sentence ("Your Mac is under strain. 3 type-checks are running at once."). */
+  text: z23.string().max(256),
+  /** The biggest jobs behind it; null when all is well. */
+  cause: z23.string().max(1024).nullable()
+});
+var ResourcesSample = z23.strictObject({
+  at_ms: epochMs,
+  /** The 1-minute load average. */
+  load: z23.number().min(0),
+  memory_used_bytes: nonNegInt,
+  typechecks: nonNegInt
+});
+var ResourcesActivityParams = z23.strictObject({});
+var ResourcesActivityResult = z23.strictObject({
+  /** False until the first reading (a second or two after start). */
+  ready: z23.boolean(),
+  sampled_at_ms: epochMs.nullable(),
+  cores: z23.int().min(1),
+  /** 1, 5 and 15 minute load averages. */
+  load: z23.array(z23.number().min(0)).length(3),
+  memory: z23.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: z23.strictObject({ running: nonNegInt, waiting: nonNegInt, comfort: nonNegInt }),
+  /** Heaviest first (1 GB weighs as much as 16 % of a core). */
+  jobs: z23.array(ResourcesJob).max(200),
+  /** The 15 heaviest by memory and the 15 busiest by CPU, together. */
+  top: z23.array(ResourcesProcess).max(30),
+  /** The last hour, oldest first. */
+  history: z23.array(ResourcesSample).max(1200)
+});
+var ResourcesStopJobParams = z23.strictObject({ pid: z23.int().min(1) });
+var ResourcesStopJobResult = z23.strictObject({
+  /** Processes signalled; whatever is still running 5 seconds later is force-stopped. */
+  processes: nonNegInt,
+  /** It had finished before the request arrived. */
+  already_finished: z23.boolean()
+});
+var ResourcesIncident = z23.strictObject({
+  at_ms: epochMs,
+  verdict: ResourcesVerdict,
+  load: z23.number().min(0),
+  memory_used_bytes: nonNegInt,
+  compressed_bytes: nonNegInt,
+  pressure: ResourcesPressure.nullable(),
+  jobs: z23.array(
+    z23.strictObject({
+      kind: ResourcesJobKind,
+      started_by: z23.string().max(64).nullable(),
+      folder: z23.string().max(256).nullable(),
+      command: z23.string().max(256),
+      cpu_percent: z23.number().min(0),
+      memory_bytes: nonNegInt,
+      duplicates: z23.int().min(1)
+    })
+  ).max(8)
+});
+var ResourcesIncidentsParams = z23.strictObject({ limit: z23.int().min(1).max(200).default(50) });
+var ResourcesIncidentsResult = z23.strictObject({
+  /** Newest first; at most one a minute is written. */
+  incidents: z23.array(ResourcesIncident).max(200)
+});
 
-// src/schema/audio.ts
+// src/schema/stack.ts
 import { z as z24 } from "zod";
-var AudioDevice = z24.strictObject({
+var StackServerName = z24.string().regex(/^[a-z0-9_-]{1,64}$/);
+var StackTone = z24.enum(["good", "wait", "bad", "off"]);
+var StackServer = z24.strictObject({
+  name: StackServerName,
+  /** One word: Healthy, Starting, Unhealthy, Restarting, Stopping, Waiting, Stopped, Crashed, Off. */
+  label: z24.string().max(32),
+  tone: StackTone,
+  /** What is going on, in one or two plain sentences. */
+  sentence: z24.string().max(2e3),
+  /** The config's own description of the server. */
+  description: z24.string().max(512),
+  /** Where the server answers, when its description names an address. */
+  open_url: z24.string().max(2048).nullable(),
+  log_file: z24.string().max(4096),
+  /** When its log file was last written. */
+  last_output_at_ms: epochMs.nullable(),
+  started_at_ms: epochMs.nullable(),
+  restarts: nonNegInt,
+  exit_code: z24.int().nullable(),
+  pid: z24.int().nullable()
+});
+var StackEvent = z24.strictObject({
+  at_ms: epochMs,
+  /** A server name, or "stack" for the stack as a whole. */
+  server: z24.string().max(64),
+  /** started · stopped · healthy · unhealthy · crashed · exited · restarting · stopping · action · action-done · action-failed · setup · error */
+  kind: z24.string().max(32),
+  text: z24.string().max(4e3)
+});
+var StackStateParams = z24.strictObject({});
+var StackStateResult = z24.strictObject({
+  /** The stack's config file, when found. */
+  config_path: z24.string().max(4096).nullable(),
+  /** Why the stack cannot be run from here (no config, no process-compose), else null. */
+  problem: z24.string().max(1e3).nullable(),
+  stack_up: z24.boolean(),
+  stack_started_at_ms: epochMs.nullable(),
+  servers: z24.array(StackServer).max(64),
+  /** One line about the one-shot setup steps ("Docker Desktop: running."), or null. */
+  setup_note: z24.string().max(500).nullable(),
+  /** Start everything / Stop everything in flight. */
+  pending: z24.strictObject({ verb: z24.enum(["start", "stop"]), label: z24.string().max(64), since_ms: epochMs }).nullable(),
+  /** The newest entries last. */
+  events: z24.array(StackEvent).max(300)
+});
+var StackStartParams = z24.strictObject({});
+var StackStopParams = z24.strictObject({});
+var StackRunResult = z24.strictObject({ accepted: z24.boolean() });
+var StackServerActionParams = z24.strictObject({
+  name: StackServerName,
+  verb: z24.enum(["start", "stop", "restart"])
+});
+var StackServerActionResult = z24.strictObject({ message: z24.string().max(1e3) });
+var StackLogsParams = z24.strictObject({
+  name: StackServerName,
+  /** Without `offset`: the last this-many complete lines. With it: new lines after it, at most this many. */
+  lines: z24.int().min(1).max(2e5).default(2e3),
+  /** Byte offset the last read ended at: answer only what was written after it (follow). */
+  offset: nonNegInt.optional(),
+  /** A "Clear" point: the lines written after this byte offset (no `offset`). */
+  since: nonNegInt.optional(),
+  /** With `offset`: wait up to this long for a new line when none is waiting (0 answers at once). */
+  wait_ms: z24.int().min(0).max(25e3).default(0)
+});
+var StackLogsResult = z24.strictObject({
+  /** Complete lines, colour codes removed. */
+  lines: z24.array(z24.string().max(65536)).max(2e5),
+  /** Where these lines end: pass it back as `offset` to follow. */
+  offset: nonNegInt,
+  /** False when `since` no longer exists (the log rotated): the lines are the plain tail instead. */
+  since_valid: z24.boolean(),
+  /** The log was rotated or truncated since `offset`: these lines start the file again. */
+  reset: z24.boolean(),
+  log_file: z24.string().max(4096)
+});
+var StackErrorsParams = z24.strictObject({
+  window_minutes: z24.int().min(1).max(1440).default(60)
+});
+var StackErrorsResult = z24.strictObject({
+  /** Per server: a heading line ("=== aidream — errors in the last 60 minutes (<file>) ===") and each error with the 10 lines after it. */
+  sections: z24.array(z24.strictObject({ name: StackServerName, heading: z24.string().max(4096), lines: z24.array(z24.string().max(65536)).max(5e3) })).max(64),
+  window_minutes: z24.int().min(1).max(1440)
+});
+
+// src/schema/audio.ts
+import { z as z25 } from "zod";
+var AudioDevice = z25.strictObject({
   /** The OS's name for it, as audio.record takes it. */
-  id: z24.string().min(1).max(256),
-  name: z24.string().max(256),
-  default: z24.boolean()
+  id: z25.string().min(1).max(256),
+  name: z25.string().max(256),
+  default: z25.boolean()
 });
-var AudioDevicesParams = z24.strictObject({});
-var AudioDevicesResult = z24.strictObject({
-  inputs: z24.array(AudioDevice).max(64),
-  outputs: z24.array(AudioDevice).max(64)
+var AudioDevicesParams = z25.strictObject({});
+var AudioDevicesResult = z25.strictObject({
+  inputs: z25.array(AudioDevice).max(64),
+  outputs: z25.array(AudioDevice).max(64)
 });
-var AudioRecordParams = z24.strictObject({
-  seconds: z24.number().min(0.5).max(600),
+var AudioRecordParams = z25.strictObject({
+  seconds: z25.number().min(0.5).max(600),
   /** The microphone (from audio.devices); the default input when absent. */
-  device_id: z24.string().min(1).max(256).optional(),
+  device_id: z25.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 = z24.strictObject({
+var AudioRecordResult = z25.strictObject({
   path: AbsPath,
-  seconds: z24.number().min(0),
+  seconds: z25.number().min(0),
   bytes: nonNegInt,
   /** Loudest sample, 0–1: 0 means the device gave silence. */
-  peak: z24.number().min(0).max(1)
+  peak: z25.number().min(0).max(1)
 });
-var AudioPlayParams = z24.strictObject({ path: AbsPath });
-var AudioPlayResult = z24.strictObject({ path: AbsPath, seconds: z24.number().min(0) });
+var AudioPlayParams = z25.strictObject({ path: AbsPath });
+var AudioPlayResult = z25.strictObject({ path: AbsPath, seconds: z25.number().min(0) });
 
 // src/schema/fs-watch.ts
-import { z as z25 } from "zod";
-var FsWatchId = z25.string().regex(/^fw_[A-Za-z0-9]{12,40}$/);
-var FsWatchStartParams = z25.strictObject({
+import { z as z26 } from "zod";
+var FsWatchId = z26.string().regex(/^fw_[A-Za-z0-9]{12,40}$/);
+var FsWatchStartParams = z26.strictObject({
   path: AbsPath,
-  recursive: z25.boolean().default(true),
+  recursive: z26.boolean().default(true),
   /** Globs relative to `path` whose changes are not reported (".git/**", "node_modules/**"). */
-  ignore: z25.array(z25.string().max(256)).max(64).default([])
+  ignore: z26.array(z26.string().max(256)).max(64).default([])
 });
-var FsWatchStartResult = z25.strictObject({
+var FsWatchStartResult = z26.strictObject({
   watch_id: FsWatchId,
   path: AbsPath,
   /** The watch ends by itself if nobody reads it for 30 minutes. */
   expires_at_ms: epochMs
 });
-var FsWatchEventsParams = z25.strictObject({
+var FsWatchEventsParams = z26.strictObject({
   watch_id: FsWatchId,
   /** Wait up to this long for a first change when none is waiting (0 answers at once). */
-  wait_ms: z25.int().min(0).max(25e3).default(0)
+  wait_ms: z26.int().min(0).max(25e3).default(0)
 });
-var FsWatchEventsResult = z25.strictObject({
+var FsWatchEventsResult = z26.strictObject({
   /** What changed since the last read, oldest first; re-checked against the disk when read. */
-  changes: z25.array(FsChange).max(1e3),
+  changes: z26.array(FsChange).max(1e3),
   /** Changes were dropped (more than 1000 waited): list the folder again. */
-  overflow: z25.boolean(),
+  overflow: z26.boolean(),
   expires_at_ms: epochMs
 });
-var FsWatchStopParams = z25.strictObject({ watch_id: FsWatchId });
-var FsWatchStopResult = z25.strictObject({ watch_id: FsWatchId });
+var FsWatchStopParams = z26.strictObject({ watch_id: FsWatchId });
+var FsWatchStopResult = z26.strictObject({ watch_id: FsWatchId });
 
 // src/schema/exec-job.ts
-import { z as z26 } from "zod";
-var ExecJobId = z26.string().regex(/^job_[A-Za-z0-9]{12,40}$/);
-var ExecJobStartParams = z26.strictObject({
-  command: z26.string().min(1).max(131072),
+import { z as z27 } from "zod";
+var ExecJobId = z27.string().regex(/^job_[A-Za-z0-9]{12,40}$/);
+var ExecJobStartParams = z27.strictObject({
+  command: z27.string().min(1).max(131072),
   /** The folder it runs in; the home folder when absent. */
   cwd: AbsPath.optional(),
-  env: z26.record(z26.string().regex(/^[A-Za-z_][A-Za-z0-9_]*$/).max(128), z26.string().max(32768)).optional()
+  env: z27.record(z27.string().regex(/^[A-Za-z_][A-Za-z0-9_]*$/).max(128), z27.string().max(32768)).optional()
 });
-var ExecJobStartResult = z26.strictObject({ job_id: ExecJobId, pid: z26.int().min(1), cwd: AbsPath });
-var ExecJobOutputParams = z26.strictObject({
+var ExecJobStartResult = z27.strictObject({ job_id: ExecJobId, pid: z27.int().min(1), cwd: AbsPath });
+var ExecJobOutputParams = z27.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: z26.int().min(0).max(25e3).default(0),
-  max_bytes: z26.int().min(1024).max(1048576).default(65536)
+  wait_ms: z27.int().min(0).max(25e3).default(0),
+  max_bytes: z27.int().min(1024).max(1048576).default(65536)
 });
-var ExecJobOutputResult = z26.strictObject({
+var ExecJobOutputResult = z27.strictObject({
   /** stdout and stderr interleaved as they arrived (UTF-8). */
-  output: z26.string(),
+  output: z27.string(),
   next_offset: nonNegInt,
   /** Bytes before `offset` that are gone (the job keeps its last 4 MiB). */
   dropped_bytes: nonNegInt,
-  running: z26.boolean(),
-  exit_code: z26.int().nullable()
+  running: z27.boolean(),
+  exit_code: z27.int().nullable()
 });
-var ExecJobStopParams = z26.strictObject({
+var ExecJobStopParams = z27.strictObject({
   job_id: ExecJobId,
   /** End it at once (SIGKILL; on Windows the whole tree with /F) instead of asking it to quit. */
-  force: z26.boolean().default(false)
+  force: z27.boolean().default(false)
 });
-var ExecJobStopResult = z26.strictObject({ job_id: ExecJobId, exited: z26.boolean(), exit_code: z26.int().nullable() });
-var ExecJobInfo = z26.strictObject({
+var ExecJobStopResult = z27.strictObject({ job_id: ExecJobId, exited: z27.boolean(), exit_code: z27.int().nullable() });
+var ExecJobInfo = z27.strictObject({
   job_id: ExecJobId,
-  command: z26.string().max(1024),
-  pid: z26.int().min(1),
+  command: z27.string().max(1024),
+  pid: z27.int().min(1),
   cwd: AbsPath,
-  running: z26.boolean(),
-  exit_code: z26.int().nullable(),
+  running: z27.boolean(),
+  exit_code: z27.int().nullable(),
   started_at_ms: epochMs,
   output_bytes: nonNegInt
 });
-var ExecJobListParams = z26.strictObject({});
-var ExecJobListResult = z26.strictObject({ jobs: z26.array(ExecJobInfo).max(64) });
+var ExecJobListParams = z27.strictObject({});
+var ExecJobListResult = z27.strictObject({ jobs: z27.array(ExecJobInfo).max(64) });
 
 // src/schema/coding.ts
-import { z as z27 } from "zod";
-var CodingServiceCredentials = z27.strictObject({
-  access_token: z27.string().min(16).max(16384),
-  user_id: z27.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}$/),
+import { z as z28 } from "zod";
+var CodingServiceCredentials = z28.strictObject({
+  access_token: z28.string().min(16).max(16384),
+  user_id: z28.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: z27.string().min(1).max(2048).regex(/^https?:\/\/[^\s/?#]+(\/[^\s?#]*)?$/)
+  server_url: z28.string().min(1).max(2048).regex(/^https?:\/\/[^\s/?#]+(\/[^\s?#]*)?$/)
 });
-var CodingHistoryBlocked = z27.enum([
+var CodingHistoryBlocked = z28.enum([
   "signed_out",
   "offline",
   "organization_required",
@@ -1783,11 +1982,11 @@ var CodingHistoryBlocked = z27.enum([
   "cloud_list_unavailable",
   "history_too_large"
 ]);
-var CodingHistoryFailure = z27.strictObject({
-  session_id: z27.string().max(64),
-  reason: z27.string().max(300)
+var CodingHistoryFailure = z28.strictObject({
+  session_id: z28.string().max(64),
+  reason: z28.string().max(300)
 });
-var CodingHistoryRun = z27.strictObject({
+var CodingHistoryRun = z28.strictObject({
   /** Claude Code sessions found on this computer. */
   local_sessions: nonNegInt,
   /** Of those, already complete in AI Matrx. */
@@ -1802,39 +2001,39 @@ var CodingHistoryRun = z27.strictObject({
   /** Changed while being read; a later run takes them. */
   changed: nonNegInt,
   failed: nonNegInt,
-  failures: z27.array(CodingHistoryFailure).max(20),
+  failures: z28.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: z27.string().max(400)
+  summary: z28.string().max(400)
 });
-var CodingHistoryStep = z27.strictObject({
+var CodingHistoryStep = z28.strictObject({
   /** Null when the run could not start (blocked before a plan existed). */
-  plan_id: z27.string().regex(/^[0-9a-f]{32}$/).nullable(),
-  finished: z27.boolean(),
+  plan_id: z28.string().regex(/^[0-9a-f]{32}$/).nullable(),
+  finished: z28.boolean(),
   blocked: CodingHistoryBlocked.nullable(),
   run: CodingHistoryRun
 });
-var CodingPlanMissingParams = z27.strictObject({ credentials: CodingServiceCredentials.nullable() });
-var CodingImportNextParams = z27.strictObject({
-  plan_id: z27.string().regex(/^[0-9a-f]{32}$/),
+var CodingPlanMissingParams = z28.strictObject({ credentials: CodingServiceCredentials.nullable() });
+var CodingImportNextParams = z28.strictObject({
+  plan_id: z28.string().regex(/^[0-9a-f]{32}$/),
   credentials: CodingServiceCredentials.nullable()
 });
-var CodingServiceProgress = z27.strictObject({
-  phase: z27.enum(["checking", "importing"]),
+var CodingServiceProgress = z28.strictObject({
+  phase: z28.enum(["checking", "importing"]),
   done: nonNegInt,
   total: nonNegInt
 });
-var CodingHistoryImportMissingParams = z27.strictObject({});
-var CodingHistoryImportMissingResult = z27.strictObject({
-  state: z27.enum(["done", "blocked", "cancelled"]),
+var CodingHistoryImportMissingParams = z28.strictObject({});
+var CodingHistoryImportMissingResult = z28.strictObject({
+  state: z28.enum(["done", "blocked", "cancelled"]),
   blocked: CodingHistoryBlocked.nullable(),
   run: CodingHistoryRun,
   elapsed_ms: nonNegInt
 });
-var CodingHistoryProgressEvent = z27.strictObject({
+var CodingHistoryProgressEvent = z28.strictObject({
   request_id: RequestId,
-  phase: z27.enum(["checking", "importing"]),
+  phase: z28.enum(["checking", "importing"]),
   /** Sessions settled so far, of `total` candidates (0 of 0 while checking). */
   done: nonNegInt,
   total: nonNegInt,
@@ -1936,9 +2135,19 @@ 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"] },
+  // The local AI Matrx servers (aidream's process-compose stack), supervised from Matrx 2's core.
+  "stack.state": { params: StackStateParams, result: StackStateResult, kind: "unary", since: "1.16", errors: ["INTERNAL"] },
+  "stack.start": { params: StackStartParams, result: StackRunResult, kind: "unary", since: "1.16", errors: ["RESOURCE_BUSY", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "stack.stop": { params: StackStopParams, result: StackRunResult, kind: "unary", since: "1.16", errors: ["RESOURCE_BUSY", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "stack.server.action": { params: StackServerActionParams, result: StackServerActionResult, kind: "unary", since: "1.16", errors: ["NOT_FOUND", "CONFLICT", "INTERNAL"] },
+  "stack.logs": { params: StackLogsParams, result: StackLogsResult, kind: "unary", since: "1.16", errors: ["NOT_FOUND", "INTERNAL"] },
+  "stack.errors": { params: StackErrorsParams, result: StackErrorsResult, kind: "unary", since: "1.16", errors: ["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"] }
 };
@@ -2163,6 +2372,20 @@ var NAMED_SCHEMAS = {
   ResourcesDisk,
   ResourcesSnapshotParams,
   ResourcesSnapshotResult,
+  ResourcesJobKind,
+  ResourcesStrain,
+  ResourcesPressure,
+  ResourcesVerdict,
+  ResourcesSample,
+  ResourcesJob,
+  ResourcesProcess,
+  ResourcesActivityParams,
+  ResourcesActivityResult,
+  ResourcesStopJobParams,
+  ResourcesStopJobResult,
+  ResourcesIncident,
+  ResourcesIncidentsParams,
+  ResourcesIncidentsResult,
   AudioDevice,
   AudioDevicesParams,
   AudioDevicesResult,
@@ -2170,6 +2393,21 @@ var NAMED_SCHEMAS = {
   AudioRecordResult,
   AudioPlayParams,
   AudioPlayResult,
+  StackServerName,
+  StackTone,
+  StackServer,
+  StackEvent,
+  StackStateParams,
+  StackStateResult,
+  StackStartParams,
+  StackStopParams,
+  StackRunResult,
+  StackServerActionParams,
+  StackServerActionResult,
+  StackLogsParams,
+  StackLogsResult,
+  StackErrorsParams,
+  StackErrorsResult,
   FsWatchId,
   FsWatchStartParams,
   FsWatchStartResult,
@@ -2299,7 +2537,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 }
@@ -2366,7 +2605,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;
@@ -2427,7 +2667,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 = "91060640a08d25f693f4d90384da7225299ab8fd287b665ca7d36f226d641267";
+var CONTRACT_SHA256 = "cdfad283c689005856b4161f28a37892d1c3356db077f685a4a659fc2c8fc657";
 
 // src/close-policy.ts
 var CLOSE_RULES = {
@@ -2487,7 +2727,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" },
@@ -3045,9 +3285,23 @@ export {
   RequestMsg,
   ResourceId,
   ResourceInfo,
+  ResourcesActivityParams,
+  ResourcesActivityResult,
   ResourcesDisk,
+  ResourcesIncident,
+  ResourcesIncidentsParams,
+  ResourcesIncidentsResult,
+  ResourcesJob,
+  ResourcesJobKind,
+  ResourcesPressure,
+  ResourcesProcess,
+  ResourcesSample,
   ResourcesSnapshotParams,
   ResourcesSnapshotResult,
+  ResourcesStopJobParams,
+  ResourcesStopJobResult,
+  ResourcesStrain,
+  ResourcesVerdict,
   ResponseMsg,
   SERVICES,
   SERVICE_MAX_FRAME_BYTES,
@@ -3090,6 +3344,21 @@ export {
   SpendScopes,
   SpendSplit,
   SpendStart,
+  StackErrorsParams,
+  StackErrorsResult,
+  StackEvent,
+  StackLogsParams,
+  StackLogsResult,
+  StackRunResult,
+  StackServer,
+  StackServerActionParams,
+  StackServerActionResult,
+  StackServerName,
+  StackStartParams,
+  StackStateParams,
+  StackStateResult,
+  StackStopParams,
+  StackTone,
   StreamMeta,
   StreamMsg,
   SysinfoGetParams,