@ai-matrx/desktop-protocol 0.19.0 → 0.20.0

package/dist/index.cjs

@@ -146,6 +146,15 @@ __export(src_exports, {
   DEFAULT_WINDOW_BYTES: () => DEFAULT_WINDOW_BYTES,
   DesktopProtocolError: () => DesktopProtocolError,
   DeviceId: () => DeviceId,
+  DiagErrorEntry: () => DiagErrorEntry,
+  DiagErrorKind: () => DiagErrorKind,
+  DiagErrorStatus: () => DiagErrorStatus,
+  DiagErrorsChangedEvent: () => DiagErrorsChangedEvent,
+  DiagErrorsListParams: () => DiagErrorsListParams,
+  DiagErrorsListResult: () => DiagErrorsListResult,
+  DiagErrorsReportParams: () => DiagErrorsReportParams,
+  DiagErrorsReportResult: () => DiagErrorsReportResult,
+  DiagProcess: () => DiagProcess,
   EVENTS: () => EVENTS,
   EXCLUDED_TOOLS: () => EXCLUDED_TOOLS,
   EndMsg: () => EndMsg,
@@ -442,7 +451,7 @@ module.exports = __toCommonJS(src_exports);
 var import_zod = require("zod");
 var import_uuid = require("@ai-matrx/kit/uuid");
 var PROTOCOL_MAJOR = 1;
-var PROTOCOL_MINOR = 19;
+var PROTOCOL_MINOR = 20;
 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_-]+$/);
@@ -2114,95 +2123,175 @@ var PowerPreventSleepResult = import_zod22.z.strictObject({
   awake_until_ms: epochMs.nullable()
 });
 
-// src/schema/resources.ts
+// src/schema/diag.ts
 var import_zod23 = require("zod");
-var ResourcesDisk = import_zod23.z.strictObject({
+var DiagProcess = import_zod23.z.enum([
+  "main",
+  "renderer",
+  "hosted_page",
+  "core",
+  "pty_host",
+  "python_ml",
+  "python_coding",
+  "python_tools",
+  "relay",
+  "coding_sessions",
+  "claude_accounts"
+]);
+var DiagErrorKind = import_zod23.z.enum([
+  "uncaught_exception",
+  "unhandled_rejection",
+  "renderer_crash",
+  "native_crash",
+  "console_error",
+  "load_failed",
+  "op_failed",
+  "child_exit",
+  "banner",
+  "logged_error"
+]);
+var DiagErrorStatus = import_zod23.z.enum(["waiting", "sent", "resolved"]);
+var DiagErrorEntry = import_zod23.z.strictObject({
+  /** sha256 prefix over process, kind, source, code and the normalized message. */
+  signature: import_zod23.z.string().regex(/^[0-9a-f]{32}$/),
+  process: DiagProcess,
+  kind: DiagErrorKind,
+  /** Where: a cap.op, a log event, a screen or page name. */
+  source: import_zod23.z.string().min(1).max(128),
+  /** An ErrorCode, an exit code or signal, an error class; null when there is none. */
+  code: import_zod23.z.string().max(64).nullable(),
+  /** The first occurrence's message, personal data removed. */
+  message: import_zod23.z.string().max(500),
+  count: nonNegInt,
+  first_seen_ms: epochMs,
+  last_seen_ms: epochMs,
+  status: DiagErrorStatus,
+  /** What the agent who resolved it wrote; null until resolved. */
+  resolution_note: import_zod23.z.string().max(500).nullable(),
+  app_version: import_zod23.z.string().max(64)
+});
+var DiagErrorsListParams = import_zod23.z.strictObject({
+  /** open = waiting or sent; all includes resolved. */
+  status: import_zod23.z.enum(["open", "all"]).default("open"),
+  limit: import_zod23.z.int().min(1).max(500).default(200)
+});
+var DiagErrorsListResult = import_zod23.z.strictObject({
+  /** Newest last_seen first. */
+  entries: import_zod23.z.array(DiagErrorEntry).max(500),
+  total_signatures: nonNegInt,
+  total_occurrences: nonNegInt,
+  /** Signatures with occurrences not yet delivered. */
+  waiting: nonNegInt,
+  /** signed_out = kept until sign-in; ok = the last delivery worked; failing = the last delivery failed (kept, retried). */
+  delivery: import_zod23.z.enum(["signed_out", "ok", "failing"]),
+  last_delivery_ms: epochMs.nullable()
+});
+var DiagErrorsReportParams = import_zod23.z.strictObject({
+  process: import_zod23.z.enum(["renderer", "hosted_page"]),
+  kind: import_zod23.z.enum(["uncaught_exception", "unhandled_rejection", "console_error", "banner"]),
+  /** The screen or page, e.g. "code.chats". */
+  source: import_zod23.z.string().min(1).max(128),
+  message: import_zod23.z.string().min(1).max(2e3),
+  code: import_zod23.z.string().max(64).optional(),
+  stack: import_zod23.z.string().max(8e3).optional()
+});
+var DiagErrorsReportResult = import_zod23.z.strictObject({
+  signature: import_zod23.z.string().regex(/^[0-9a-f]{32}$/)
+});
+var DiagErrorsChangedEvent = import_zod23.z.strictObject({
+  total_signatures: nonNegInt,
+  waiting: nonNegInt
+});
+
+// src/schema/resources.ts
+var import_zod24 = require("zod");
+var ResourcesDisk = import_zod24.z.strictObject({
   /** Where it is mounted ("/", "C:"). */
-  mount: import_zod23.z.string().max(512),
+  mount: import_zod24.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(),
+  name: import_zod24.z.string().max(256).optional(),
   /** The file system ("apfs", "NTFS", "ext4"). */
-  fs: import_zod23.z.string().max(64),
+  fs: import_zod24.z.string().max(64),
   size_bytes: nonNegInt,
   used_bytes: nonNegInt,
   available_bytes: nonNegInt
 });
-var ResourcesSnapshotParams = import_zod23.z.strictObject({});
-var ResourcesSnapshotResult = import_zod23.z.strictObject({
-  cpu: import_zod23.z.strictObject({
+var ResourcesSnapshotParams = import_zod24.z.strictObject({});
+var ResourcesSnapshotResult = import_zod24.z.strictObject({
+  cpu: import_zod24.z.strictObject({
     /** Busy share of all cores, 0–100, measured now. */
-    percent: import_zod23.z.number().min(0).max(100),
-    cores: import_zod23.z.int().min(1),
+    percent: import_zod24.z.number().min(0).max(100),
+    cores: import_zod24.z.int().min(1),
     /** 1, 5 and 15 minute load averages; null on Windows. */
-    load: import_zod23.z.array(import_zod23.z.number().min(0)).length(3).nullable()
+    load: import_zod24.z.array(import_zod24.z.number().min(0)).length(3).nullable()
   }),
-  memory: import_zod23.z.strictObject({ total_bytes: nonNegInt, used_bytes: nonNegInt, available_bytes: nonNegInt }),
-  swap: import_zod23.z.strictObject({ total_bytes: nonNegInt, used_bytes: nonNegInt }),
-  disks: import_zod23.z.array(ResourcesDisk).max(64),
+  memory: import_zod24.z.strictObject({ total_bytes: nonNegInt, used_bytes: nonNegInt, available_bytes: nonNegInt }),
+  swap: import_zod24.z.strictObject({ total_bytes: nonNegInt, used_bytes: nonNegInt }),
+  disks: import_zod24.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({
+var ResourcesJobKind = import_zod24.z.enum(["type-check", "tests", "build", "lint", "dev server", "language server", "search"]);
+var ResourcesStrain = import_zod24.z.enum(["good", "strain", "overloaded"]);
+var ResourcesPressure = import_zod24.z.enum(["normal", "warning", "critical"]);
+var ResourcesJob = import_zod24.z.strictObject({
   /** The job's root process (Stop takes its whole tree). */
-  pid: import_zod23.z.int().min(0),
+  pid: import_zod24.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),
+  command: import_zod24.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(),
+  started_by: import_zod24.z.string().max(64).nullable(),
   /** Whatever started it is gone and nothing waits for it. */
-  orphan: import_zod23.z.boolean(),
+  orphan: import_zod24.z.boolean(),
   /** A type-check queued for its turn (no compiler running yet). */
-  waiting: import_zod23.z.boolean(),
+  waiting: import_zod24.z.boolean(),
   /** The project folder it runs in ("matrx-frontend"); null when not in one. */
-  folder: import_zod23.z.string().max(256).nullable(),
+  folder: import_zod24.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),
+  duplicates: import_zod24.z.int().min(1),
+  processes: import_zod24.z.int().min(1),
   /** Sum over the tree, as `ps` reports it: 100 = one full core. */
-  cpu_percent: import_zod23.z.number().min(0),
+  cpu_percent: import_zod24.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()
+  stoppable: import_zod24.z.boolean()
 });
-var ResourcesProcess = import_zod23.z.strictObject({
-  pid: import_zod23.z.int().min(0),
+var ResourcesProcess = import_zod24.z.strictObject({
+  pid: import_zod24.z.int().min(0),
   /** The command line, shortened. */
-  name: import_zod23.z.string().max(256),
-  cpu_percent: import_zod23.z.number().min(0),
+  name: import_zod24.z.string().max(256),
+  cpu_percent: import_zod24.z.number().min(0),
   memory_bytes: nonNegInt,
-  started_by: import_zod23.z.string().max(64).nullable(),
+  started_by: import_zod24.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(),
+  job: import_zod24.z.string().max(256).nullable(),
   started_at_ms: epochMs.nullable()
 });
-var ResourcesVerdict = import_zod23.z.strictObject({
+var ResourcesVerdict = import_zod24.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),
+  text: import_zod24.z.string().max(256),
   /** The biggest jobs behind it; null when all is well. */
-  cause: import_zod23.z.string().max(1024).nullable()
+  cause: import_zod24.z.string().max(1024).nullable()
 });
-var ResourcesSample = import_zod23.z.strictObject({
+var ResourcesSample = import_zod24.z.strictObject({
   at_ms: epochMs,
   /** The 1-minute load average. */
-  load: import_zod23.z.number().min(0),
+  load: import_zod24.z.number().min(0),
   memory_used_bytes: nonNegInt,
   typechecks: nonNegInt
 });
-var ResourcesActivityParams = import_zod23.z.strictObject({});
-var ResourcesActivityResult = import_zod23.z.strictObject({
+var ResourcesActivityParams = import_zod24.z.strictObject({});
+var ResourcesActivityResult = import_zod24.z.strictObject({
   /** False until the first reading (a second or two after start). */
-  ready: import_zod23.z.boolean(),
+  ready: import_zod24.z.boolean(),
   sampled_at_ms: epochMs.nullable(),
-  cores: import_zod23.z.int().min(1),
+  cores: import_zod24.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({
+  load: import_zod24.z.array(import_zod24.z.number().min(0)).length(3),
+  memory: import_zod24.z.strictObject({
     total_bytes: nonNegInt,
     /** Activity Monitor's Memory Used: app memory + wired + compressed. */
     used_bytes: nonNegInt,
@@ -2213,252 +2302,252 @@ var ResourcesActivityResult = import_zod23.z.strictObject({
     pressure: ResourcesPressure.nullable()
   }),
   verdict: ResourcesVerdict,
-  typechecks: import_zod23.z.strictObject({ running: nonNegInt, waiting: nonNegInt, comfort: nonNegInt }),
+  typechecks: import_zod24.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),
+  jobs: import_zod24.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),
+  top: import_zod24.z.array(ResourcesProcess).max(30),
   /** The last hour, oldest first. */
-  history: import_zod23.z.array(ResourcesSample).max(1200)
+  history: import_zod24.z.array(ResourcesSample).max(1200)
 });
-var ResourcesStopJobParams = import_zod23.z.strictObject({ pid: import_zod23.z.int().min(1) });
-var ResourcesStopJobResult = import_zod23.z.strictObject({
+var ResourcesStopJobParams = import_zod24.z.strictObject({ pid: import_zod24.z.int().min(1) });
+var ResourcesStopJobResult = import_zod24.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()
+  already_finished: import_zod24.z.boolean()
 });
-var ResourcesIncident = import_zod23.z.strictObject({
+var ResourcesIncident = import_zod24.z.strictObject({
   at_ms: epochMs,
   verdict: ResourcesVerdict,
-  load: import_zod23.z.number().min(0),
+  load: import_zod24.z.number().min(0),
   memory_used_bytes: nonNegInt,
   compressed_bytes: nonNegInt,
   pressure: ResourcesPressure.nullable(),
-  jobs: import_zod23.z.array(
-    import_zod23.z.strictObject({
+  jobs: import_zod24.z.array(
+    import_zod24.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),
+      started_by: import_zod24.z.string().max(64).nullable(),
+      folder: import_zod24.z.string().max(256).nullable(),
+      command: import_zod24.z.string().max(256),
+      cpu_percent: import_zod24.z.number().min(0),
       memory_bytes: nonNegInt,
-      duplicates: import_zod23.z.int().min(1)
+      duplicates: import_zod24.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({
+var ResourcesIncidentsParams = import_zod24.z.strictObject({ limit: import_zod24.z.int().min(1).max(200).default(50) });
+var ResourcesIncidentsResult = import_zod24.z.strictObject({
   /** Newest first; at most one a minute is written. */
-  incidents: import_zod23.z.array(ResourcesIncident).max(200)
+  incidents: import_zod24.z.array(ResourcesIncident).max(200)
 });
 
 // src/schema/stack.ts
-var import_zod24 = require("zod");
-var StackServerName = import_zod24.z.string().regex(/^[a-z0-9_-]{1,64}$/);
-var StackTone = import_zod24.z.enum(["good", "wait", "bad", "off"]);
-var StackServer = import_zod24.z.strictObject({
+var import_zod25 = require("zod");
+var StackServerName = import_zod25.z.string().regex(/^[a-z0-9_-]{1,64}$/);
+var StackTone = import_zod25.z.enum(["good", "wait", "bad", "off"]);
+var StackServer = import_zod25.z.strictObject({
   name: StackServerName,
   /** One word: Healthy, Starting, Unhealthy, Restarting, Stopping, Waiting, Stopped, Crashed, Off. */
-  label: import_zod24.z.string().max(32),
+  label: import_zod25.z.string().max(32),
   tone: StackTone,
   /** What is going on, in one or two plain sentences. */
-  sentence: import_zod24.z.string().max(2e3),
+  sentence: import_zod25.z.string().max(2e3),
   /** The config's own description of the server. */
-  description: import_zod24.z.string().max(512),
+  description: import_zod25.z.string().max(512),
   /** Where the server answers, when its description names an address. */
-  open_url: import_zod24.z.string().max(2048).nullable(),
-  log_file: import_zod24.z.string().max(4096),
+  open_url: import_zod25.z.string().max(2048).nullable(),
+  log_file: import_zod25.z.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: import_zod24.z.int().nullable(),
-  pid: import_zod24.z.int().nullable(),
+  exit_code: import_zod25.z.int().nullable(),
+  pid: import_zod25.z.int().nullable(),
   /** (1.18) CPU of the server's process and everything under it, in percent of one core; absent when it is not running. */
-  cpu_percent: import_zod24.z.number().min(0).optional(),
+  cpu_percent: import_zod25.z.number().min(0).optional(),
   /** (1.18) Memory of the same processes: the physical footprint (Activity Monitor's Memory) summed; absent when it is not running. */
   memory_bytes: nonNegInt.optional()
 });
-var StackEvent = import_zod24.z.strictObject({
+var StackEvent = import_zod25.z.strictObject({
   at_ms: epochMs,
   /** A server name, or "stack" for the stack as a whole. */
-  server: import_zod24.z.string().max(64),
+  server: import_zod25.z.string().max(64),
   /** started · stopped · healthy · unhealthy · crashed · exited · restarting · stopping · action · action-done · action-failed · setup · error */
-  kind: import_zod24.z.string().max(32),
-  text: import_zod24.z.string().max(4e3)
+  kind: import_zod25.z.string().max(32),
+  text: import_zod25.z.string().max(4e3)
 });
-var StackStateParams = import_zod24.z.strictObject({});
-var StackStateResult = import_zod24.z.strictObject({
+var StackStateParams = import_zod25.z.strictObject({});
+var StackStateResult = import_zod25.z.strictObject({
   /** The stack's config file, when found. */
-  config_path: import_zod24.z.string().max(4096).nullable(),
+  config_path: import_zod25.z.string().max(4096).nullable(),
   /** Why the stack cannot be run from here (no config, no process-compose), else null. */
-  problem: import_zod24.z.string().max(1e3).nullable(),
-  stack_up: import_zod24.z.boolean(),
+  problem: import_zod25.z.string().max(1e3).nullable(),
+  stack_up: import_zod25.z.boolean(),
   stack_started_at_ms: epochMs.nullable(),
-  servers: import_zod24.z.array(StackServer).max(64),
+  servers: import_zod25.z.array(StackServer).max(64),
   /** One line about the one-shot setup steps ("Docker Desktop: running."), or null. */
-  setup_note: import_zod24.z.string().max(500).nullable(),
+  setup_note: import_zod25.z.string().max(500).nullable(),
   /** Start everything / Stop everything in flight. */
-  pending: import_zod24.z.strictObject({ verb: import_zod24.z.enum(["start", "stop"]), label: import_zod24.z.string().max(64), since_ms: epochMs }).nullable(),
+  pending: import_zod25.z.strictObject({ verb: import_zod25.z.enum(["start", "stop"]), label: import_zod25.z.string().max(64), since_ms: epochMs }).nullable(),
   /** The newest entries last. */
-  events: import_zod24.z.array(StackEvent).max(300)
+  events: import_zod25.z.array(StackEvent).max(300)
 });
-var StackStartParams = import_zod24.z.strictObject({});
-var StackStopParams = import_zod24.z.strictObject({});
-var StackRunResult = import_zod24.z.strictObject({ accepted: import_zod24.z.boolean() });
-var StackServerActionParams = import_zod24.z.strictObject({
+var StackStartParams = import_zod25.z.strictObject({});
+var StackStopParams = import_zod25.z.strictObject({});
+var StackRunResult = import_zod25.z.strictObject({ accepted: import_zod25.z.boolean() });
+var StackServerActionParams = import_zod25.z.strictObject({
   name: StackServerName,
-  verb: import_zod24.z.enum(["start", "stop", "restart"])
+  verb: import_zod25.z.enum(["start", "stop", "restart"])
 });
-var StackServerActionResult = import_zod24.z.strictObject({ message: import_zod24.z.string().max(1e3) });
-var StackLogsParams = import_zod24.z.strictObject({
+var StackServerActionResult = import_zod25.z.strictObject({ message: import_zod25.z.string().max(1e3) });
+var StackLogsParams = import_zod25.z.strictObject({
   name: StackServerName,
   /** Without `offset`: the last this-many complete lines. With it: new lines after it, at most this many. */
-  lines: import_zod24.z.int().min(1).max(2e5).default(2e3),
+  lines: import_zod25.z.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: import_zod24.z.int().min(0).max(25e3).default(0)
+  wait_ms: import_zod25.z.int().min(0).max(25e3).default(0)
 });
-var StackLogsResult = import_zod24.z.strictObject({
+var StackLogsResult = import_zod25.z.strictObject({
   /** Complete lines, colour codes removed. */
-  lines: import_zod24.z.array(import_zod24.z.string().max(65536)).max(2e5),
+  lines: import_zod25.z.array(import_zod25.z.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: import_zod24.z.boolean(),
+  since_valid: import_zod25.z.boolean(),
   /** The log was rotated or truncated since `offset`: these lines start the file again. */
-  reset: import_zod24.z.boolean(),
-  log_file: import_zod24.z.string().max(4096)
+  reset: import_zod25.z.boolean(),
+  log_file: import_zod25.z.string().max(4096)
 });
-var StackErrorsParams = import_zod24.z.strictObject({
-  window_minutes: import_zod24.z.int().min(1).max(1440).default(60)
+var StackErrorsParams = import_zod25.z.strictObject({
+  window_minutes: import_zod25.z.int().min(1).max(1440).default(60)
 });
-var StackErrorsResult = import_zod24.z.strictObject({
+var StackErrorsResult = import_zod25.z.strictObject({
   /** Per server: a heading line ("=== aidream — errors in the last 60 minutes (<file>) ===") and each error with the 10 lines after it. */
-  sections: import_zod24.z.array(import_zod24.z.strictObject({ name: StackServerName, heading: import_zod24.z.string().max(4096), lines: import_zod24.z.array(import_zod24.z.string().max(65536)).max(5e3) })).max(64),
-  window_minutes: import_zod24.z.int().min(1).max(1440)
+  sections: import_zod25.z.array(import_zod25.z.strictObject({ name: StackServerName, heading: import_zod25.z.string().max(4096), lines: import_zod25.z.array(import_zod25.z.string().max(65536)).max(5e3) })).max(64),
+  window_minutes: import_zod25.z.int().min(1).max(1440)
 });
 
 // src/schema/audio.ts
-var import_zod25 = require("zod");
-var AudioDevice = import_zod25.z.strictObject({
+var import_zod26 = require("zod");
+var AudioDevice = import_zod26.z.strictObject({
   /** The OS's name for it, as audio.record takes it. */
-  id: import_zod25.z.string().min(1).max(256),
-  name: import_zod25.z.string().max(256),
-  default: import_zod25.z.boolean()
+  id: import_zod26.z.string().min(1).max(256),
+  name: import_zod26.z.string().max(256),
+  default: import_zod26.z.boolean()
 });
-var AudioDevicesParams = import_zod25.z.strictObject({});
-var AudioDevicesResult = import_zod25.z.strictObject({
-  inputs: import_zod25.z.array(AudioDevice).max(64),
-  outputs: import_zod25.z.array(AudioDevice).max(64)
+var AudioDevicesParams = import_zod26.z.strictObject({});
+var AudioDevicesResult = import_zod26.z.strictObject({
+  inputs: import_zod26.z.array(AudioDevice).max(64),
+  outputs: import_zod26.z.array(AudioDevice).max(64)
 });
-var AudioRecordParams = import_zod25.z.strictObject({
-  seconds: import_zod25.z.number().min(0.5).max(600),
+var AudioRecordParams = import_zod26.z.strictObject({
+  seconds: import_zod26.z.number().min(0.5).max(600),
   /** The microphone (from audio.devices); the default input when absent. */
-  device_id: import_zod25.z.string().min(1).max(256).optional(),
+  device_id: import_zod26.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_zod25.z.strictObject({
+var AudioRecordResult = import_zod26.z.strictObject({
   path: AbsPath,
-  seconds: import_zod25.z.number().min(0),
+  seconds: import_zod26.z.number().min(0),
   bytes: nonNegInt,
   /** Loudest sample, 0–1: 0 means the device gave silence. */
-  peak: import_zod25.z.number().min(0).max(1)
+  peak: import_zod26.z.number().min(0).max(1)
 });
-var AudioPlayParams = import_zod25.z.strictObject({ path: AbsPath });
-var AudioPlayResult = import_zod25.z.strictObject({ path: AbsPath, seconds: import_zod25.z.number().min(0) });
+var AudioPlayParams = import_zod26.z.strictObject({ path: AbsPath });
+var AudioPlayResult = import_zod26.z.strictObject({ path: AbsPath, seconds: import_zod26.z.number().min(0) });
 
 // src/schema/fs-watch.ts
-var import_zod26 = require("zod");
-var FsWatchId = import_zod26.z.string().regex(/^fw_[A-Za-z0-9]{12,40}$/);
-var FsWatchStartParams = import_zod26.z.strictObject({
+var import_zod27 = require("zod");
+var FsWatchId = import_zod27.z.string().regex(/^fw_[A-Za-z0-9]{12,40}$/);
+var FsWatchStartParams = import_zod27.z.strictObject({
   path: AbsPath,
-  recursive: import_zod26.z.boolean().default(true),
+  recursive: import_zod27.z.boolean().default(true),
   /** Globs relative to `path` whose changes are not reported (".git/**", "node_modules/**"). */
-  ignore: import_zod26.z.array(import_zod26.z.string().max(256)).max(64).default([])
+  ignore: import_zod27.z.array(import_zod27.z.string().max(256)).max(64).default([])
 });
-var FsWatchStartResult = import_zod26.z.strictObject({
+var FsWatchStartResult = import_zod27.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_zod26.z.strictObject({
+var FsWatchEventsParams = import_zod27.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_zod26.z.int().min(0).max(25e3).default(0)
+  wait_ms: import_zod27.z.int().min(0).max(25e3).default(0)
 });
-var FsWatchEventsResult = import_zod26.z.strictObject({
+var FsWatchEventsResult = import_zod27.z.strictObject({
   /** What changed since the last read, oldest first; re-checked against the disk when read. */
-  changes: import_zod26.z.array(FsChange).max(1e3),
+  changes: import_zod27.z.array(FsChange).max(1e3),
   /** Changes were dropped (more than 1000 waited): list the folder again. */
-  overflow: import_zod26.z.boolean(),
+  overflow: import_zod27.z.boolean(),
   expires_at_ms: epochMs
 });
-var FsWatchStopParams = import_zod26.z.strictObject({ watch_id: FsWatchId });
-var FsWatchStopResult = import_zod26.z.strictObject({ watch_id: FsWatchId });
+var FsWatchStopParams = import_zod27.z.strictObject({ watch_id: FsWatchId });
+var FsWatchStopResult = import_zod27.z.strictObject({ watch_id: FsWatchId });
 
 // src/schema/exec-job.ts
-var import_zod27 = require("zod");
-var ExecJobId = import_zod27.z.string().regex(/^job_[A-Za-z0-9]{12,40}$/);
-var ExecJobStartParams = import_zod27.z.strictObject({
-  command: import_zod27.z.string().min(1).max(131072),
+var import_zod28 = require("zod");
+var ExecJobId = import_zod28.z.string().regex(/^job_[A-Za-z0-9]{12,40}$/);
+var ExecJobStartParams = import_zod28.z.strictObject({
+  command: import_zod28.z.string().min(1).max(131072),
   /** The folder it runs in; the home folder when absent. */
   cwd: AbsPath.optional(),
-  env: import_zod27.z.record(import_zod27.z.string().regex(/^[A-Za-z_][A-Za-z0-9_]*$/).max(128), import_zod27.z.string().max(32768)).optional()
+  env: import_zod28.z.record(import_zod28.z.string().regex(/^[A-Za-z_][A-Za-z0-9_]*$/).max(128), import_zod28.z.string().max(32768)).optional()
 });
-var ExecJobStartResult = import_zod27.z.strictObject({ job_id: ExecJobId, pid: import_zod27.z.int().min(1), cwd: AbsPath });
-var ExecJobOutputParams = import_zod27.z.strictObject({
+var ExecJobStartResult = import_zod28.z.strictObject({ job_id: ExecJobId, pid: import_zod28.z.int().min(1), cwd: AbsPath });
+var ExecJobOutputParams = import_zod28.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_zod27.z.int().min(0).max(25e3).default(0),
-  max_bytes: import_zod27.z.int().min(1024).max(1048576).default(65536)
+  wait_ms: import_zod28.z.int().min(0).max(25e3).default(0),
+  max_bytes: import_zod28.z.int().min(1024).max(1048576).default(65536)
 });
-var ExecJobOutputResult = import_zod27.z.strictObject({
+var ExecJobOutputResult = import_zod28.z.strictObject({
   /** stdout and stderr interleaved as they arrived (UTF-8). */
-  output: import_zod27.z.string(),
+  output: import_zod28.z.string(),
   next_offset: nonNegInt,
   /** Bytes before `offset` that are gone (the job keeps its last 4 MiB). */
   dropped_bytes: nonNegInt,
-  running: import_zod27.z.boolean(),
-  exit_code: import_zod27.z.int().nullable()
+  running: import_zod28.z.boolean(),
+  exit_code: import_zod28.z.int().nullable()
 });
-var ExecJobStopParams = import_zod27.z.strictObject({
+var ExecJobStopParams = import_zod28.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_zod27.z.boolean().default(false)
+  force: import_zod28.z.boolean().default(false)
 });
-var ExecJobStopResult = import_zod27.z.strictObject({ job_id: ExecJobId, exited: import_zod27.z.boolean(), exit_code: import_zod27.z.int().nullable() });
-var ExecJobInfo = import_zod27.z.strictObject({
+var ExecJobStopResult = import_zod28.z.strictObject({ job_id: ExecJobId, exited: import_zod28.z.boolean(), exit_code: import_zod28.z.int().nullable() });
+var ExecJobInfo = import_zod28.z.strictObject({
   job_id: ExecJobId,
-  command: import_zod27.z.string().max(1024),
-  pid: import_zod27.z.int().min(1),
+  command: import_zod28.z.string().max(1024),
+  pid: import_zod28.z.int().min(1),
   cwd: AbsPath,
-  running: import_zod27.z.boolean(),
-  exit_code: import_zod27.z.int().nullable(),
+  running: import_zod28.z.boolean(),
+  exit_code: import_zod28.z.int().nullable(),
   started_at_ms: epochMs,
   output_bytes: nonNegInt
 });
-var ExecJobListParams = import_zod27.z.strictObject({});
-var ExecJobListResult = import_zod27.z.strictObject({ jobs: import_zod27.z.array(ExecJobInfo).max(64) });
+var ExecJobListParams = import_zod28.z.strictObject({});
+var ExecJobListResult = import_zod28.z.strictObject({ jobs: import_zod28.z.array(ExecJobInfo).max(64) });
 
 // src/schema/coding.ts
-var import_zod28 = require("zod");
+var import_zod29 = 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(import_uuid3.UUID_SHAPE_PATTERN),
+var CodingServiceCredentials = import_zod29.z.strictObject({
+  access_token: import_zod29.z.string().min(16).max(16384),
+  user_id: import_zod29.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?#]*)?$/)
+  server_url: import_zod29.z.string().min(1).max(2048).regex(/^https?:\/\/[^\s/?#]+(\/[^\s?#]*)?$/)
 });
-var CodingHistoryBlocked = import_zod28.z.enum([
+var CodingHistoryBlocked = import_zod29.z.enum([
   "signed_out",
   "offline",
   "organization_required",
@@ -2466,11 +2555,11 @@ var CodingHistoryBlocked = import_zod28.z.enum([
   "cloud_list_unavailable",
   "history_too_large"
 ]);
-var CodingHistoryFailure = import_zod28.z.strictObject({
-  session_id: import_zod28.z.string().max(64),
-  reason: import_zod28.z.string().max(300)
+var CodingHistoryFailure = import_zod29.z.strictObject({
+  session_id: import_zod29.z.string().max(64),
+  reason: import_zod29.z.string().max(300)
 });
-var CodingHistoryRun = import_zod28.z.strictObject({
+var CodingHistoryRun = import_zod29.z.strictObject({
   /** Claude Code sessions found on this computer. */
   local_sessions: nonNegInt,
   /** Of those, already complete in AI Matrx. */
@@ -2485,39 +2574,39 @@ var CodingHistoryRun = import_zod28.z.strictObject({
   /** Changed while being read; a later run takes them. */
   changed: nonNegInt,
   failed: nonNegInt,
-  failures: import_zod28.z.array(CodingHistoryFailure).max(20),
+  failures: import_zod29.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_zod28.z.string().max(400)
+  summary: import_zod29.z.string().max(400)
 });
-var CodingHistoryStep = import_zod28.z.strictObject({
+var CodingHistoryStep = import_zod29.z.strictObject({
   /** Null when the run could not start (blocked before a plan existed). */
-  plan_id: import_zod28.z.string().regex(/^[0-9a-f]{32}$/).nullable(),
-  finished: import_zod28.z.boolean(),
+  plan_id: import_zod29.z.string().regex(/^[0-9a-f]{32}$/).nullable(),
+  finished: import_zod29.z.boolean(),
   blocked: CodingHistoryBlocked.nullable(),
   run: CodingHistoryRun
 });
-var CodingPlanMissingParams = import_zod28.z.strictObject({ credentials: CodingServiceCredentials.nullable() });
-var CodingImportNextParams = import_zod28.z.strictObject({
-  plan_id: import_zod28.z.string().regex(/^[0-9a-f]{32}$/),
+var CodingPlanMissingParams = import_zod29.z.strictObject({ credentials: CodingServiceCredentials.nullable() });
+var CodingImportNextParams = import_zod29.z.strictObject({
+  plan_id: import_zod29.z.string().regex(/^[0-9a-f]{32}$/),
   credentials: CodingServiceCredentials.nullable()
 });
-var CodingServiceProgress = import_zod28.z.strictObject({
-  phase: import_zod28.z.enum(["checking", "importing"]),
+var CodingServiceProgress = import_zod29.z.strictObject({
+  phase: import_zod29.z.enum(["checking", "importing"]),
   done: nonNegInt,
   total: nonNegInt
 });
-var CodingHistoryImportMissingParams = import_zod28.z.strictObject({});
-var CodingHistoryImportMissingResult = import_zod28.z.strictObject({
-  state: import_zod28.z.enum(["done", "blocked", "cancelled"]),
+var CodingHistoryImportMissingParams = import_zod29.z.strictObject({});
+var CodingHistoryImportMissingResult = import_zod29.z.strictObject({
+  state: import_zod29.z.enum(["done", "blocked", "cancelled"]),
   blocked: CodingHistoryBlocked.nullable(),
   run: CodingHistoryRun,
   elapsed_ms: nonNegInt
 });
-var CodingHistoryProgressEvent = import_zod28.z.strictObject({
+var CodingHistoryProgressEvent = import_zod29.z.strictObject({
   request_id: RequestId,
-  phase: import_zod28.z.enum(["checking", "importing"]),
+  phase: import_zod29.z.enum(["checking", "importing"]),
   /** Sessions settled so far, of `total` candidates (0 of 0 while checking). */
   done: nonNegInt,
   total: nonNegInt,
@@ -2633,6 +2722,9 @@ var OPS = {
   "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"] },
+  // The device's error ledger (SPEC §3.12): every process's errors, grouped, delivered to ops.system_error.
+  "diag.errors.list": { params: DiagErrorsListParams, result: DiagErrorsListResult, kind: "unary", since: "1.20", errors: ["INTERNAL"] },
+  "diag.errors.report": { params: DiagErrorsReportParams, result: DiagErrorsReportResult, kind: "unary", since: "1.20", 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"] }
 };
@@ -2647,7 +2739,8 @@ var EVENTS = {
   "models.progress": ModelsProgressEvent,
   "coding.history.progress": CodingHistoryProgressEvent,
   "relay.device_status": RelayDeviceStatusEvent,
-  "relay.auth_expiring": RelayAuthExpiringEvent
+  "relay.auth_expiring": RelayAuthExpiringEvent,
+  "diag.errors.changed": DiagErrorsChangedEvent
 };
 var SERVICES = {
   ml: {
@@ -2893,6 +2986,15 @@ var NAMED_SCHEMAS = {
   StackLogsResult,
   StackErrorsParams,
   StackErrorsResult,
+  DiagProcess,
+  DiagErrorKind,
+  DiagErrorStatus,
+  DiagErrorEntry,
+  DiagErrorsListParams,
+  DiagErrorsListResult,
+  DiagErrorsReportParams,
+  DiagErrorsReportResult,
+  DiagErrorsChangedEvent,
   FsWatchId,
   FsWatchStartParams,
   FsWatchStartResult,
@@ -3159,7 +3261,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 = "4fc16cc5bdaf7d666d5a0916ad3cd362df192d0238655ea288e7ffe15e54f246";
+var CONTRACT_SHA256 = "ef1f01f6b4e81ce7a56192d56c5765d182a53aaf9224ef20ce764cd25c20e229";
 
 // src/close-policy.ts
 var CLOSE_RULES = {