@ai-matrx/desktop-protocol 0.17.2 → 0.17.4

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## 0.17.4
+### (protocol 1.8)
+
+- **A coding app's chats, live.** New ops `apps.chats.list` (windows, projects, chat rows with
+  places, pins, hidden-in reasons, running, last use and cache warmth; all or only `ids`),
+  `apps.chats.watch` (resource; event `apps.chats.changed {app_key, version, ids, all}`),
+  `apps.chats.star`, `apps.projects.file` (a project or a new one by name) and
+  `apps.projects.unfile`. Generic per `app_key`; Claude is the first adapter. New ops only, so
+  older peers are unaffected.
+
+Consumer action: none (Matrx 2 core serves the ops; its Code › Chats and Projects screens read them).
+
+## 0.17.3
+### (protocol 1.7)
+
+- **A window names the application that owns it.** `WindowInfo` gains `app` (the owning
+  application's display name, absent when the OS does not say) and `pid` (absent when unknown), on
+  `window.list`, `window.focus` and `window.move`. Both are optional on read (an older app omits
+  them) and `forPeer` strips them for a peer that negotiated below 1.7. Guard:
+  `src/versioning.test.ts` ("a window names its app from 1.7 …").
+
+Consumer action: none (new optional fields; Matrx 2 core and its Windows screen read them).
+
 ## 0.17.2
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see

package/dist/client.cjs

@@ -143,7 +143,7 @@ var import_zod2 = require("zod");
 // src/schema/primitives.ts
 var import_zod = require("zod");
 var PROTOCOL_MAJOR = 1;
-var PROTOCOL_MINOR = 6;
+var PROTOCOL_MINOR = 8;
 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_-]+$/);
@@ -961,7 +961,15 @@ var WindowInfo = import_zod15.z.strictObject({
   x: import_zod15.z.int(),
   y: import_zod15.z.int(),
   width: import_zod15.z.int().min(0),
-  height: import_zod15.z.int().min(0)
+  height: import_zod15.z.int().min(0),
+  /**
+   * The application that owns the window, by the name the OS shows people; absent when the OS does
+   * not say. Optional (never null, the schema rule) because it was added in protocol 1.7: an older
+   * app's answer has no such field (FIELDS_SINCE).
+   */
+  app: import_zod15.z.string().max(256).optional(),
+  /** The owning process id; absent when the OS does not say. Added in protocol 1.7. */
+  pid: import_zod15.z.int().min(0).optional()
 });
 var WindowListParams = import_zod15.z.strictObject({
   /** Case-insensitive substring of the window title. */
@@ -1425,6 +1433,114 @@ var AppsOpenResult = import_zod23.z.strictObject({
   folder: AbsPath.nullable()
 });
 
+// src/schema/apps-chats.ts
+var import_zod24 = require("zod");
+var ChatId = import_zod24.z.string().regex(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/);
+var ChatPlace = import_zod24.z.string().regex(/^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/);
+var ChatProjectId = import_zod24.z.string().regex(/^[a-z0-9][a-z0-9-]{0,63}$/);
+var ChatWindow = import_zod24.z.strictObject({
+  key: ChatPlace,
+  /** The app's default profile (Claude: the main window, which lists every account's chats). */
+  main: import_zod24.z.boolean(),
+  /** The account the window is signed into, when known. */
+  account: import_zod24.z.string().max(320).nullable()
+});
+var ChatProject = import_zod24.z.strictObject({
+  id: ChatProjectId,
+  name: import_zod24.z.string().min(1).max(200),
+  archived: import_zod24.z.boolean(),
+  /** Chats in it. */
+  count: nonNegInt
+});
+var ChatPin = import_zod24.z.strictObject({
+  /** The window whose account pins it; an account with no window of its own is named by its email. */
+  window: import_zod24.z.string().min(1).max(320),
+  /** When that account's pin list was last read; null when the reading has no time. */
+  observed_at_ms: epochMs.nullable()
+});
+var ChatRunning = import_zod24.z.strictObject({
+  window: ChatPlace,
+  /** process: a live process resumed this chat there (exact); activity: that window's own record moved in the last 3 minutes. */
+  how: import_zod24.z.enum(["process", "activity"])
+});
+var ChatHidden = import_zod24.z.strictObject({
+  window: ChatPlace,
+  reason: import_zod24.z.string().max(200)
+});
+var ChatLastUse = import_zod24.z.strictObject({
+  /** The conversation's last reply. */
+  at_ms: epochMs,
+  window: ChatPlace.nullable(),
+  account: import_zod24.z.string().max(320).nullable(),
+  /** How the window was decided (one short line). */
+  how: import_zod24.z.string().max(120).nullable(),
+  /** The account's 1-hour prompt cache is still warm. */
+  cache_warm: import_zod24.z.boolean(),
+  cache_minutes_left: nonNegInt
+});
+var ChatRow = import_zod24.z.strictObject({
+  id: ChatId,
+  /** The short id people see (the listing's first 8 characters). */
+  short_id: import_zod24.z.string().max(16),
+  /** The listing's own name (Claude: local_<id>), null for a chat only in the holder. */
+  record: import_zod24.z.string().max(160).nullable(),
+  title: import_zod24.z.string().max(1e3),
+  last_active_ms: epochMs.nullable(),
+  created_ms: epochMs.nullable(),
+  projects: import_zod24.z.array(ChatProjectId).max(500),
+  starred: import_zod24.z.boolean(),
+  pinned_in: import_zod24.z.array(ChatPin).max(200),
+  /** Every place it is listed now: window keys, plus "holder". */
+  places: import_zod24.z.array(ChatPlace).max(200),
+  held: import_zod24.z.boolean(),
+  running: import_zod24.z.array(ChatRunning).max(200),
+  hidden_in: import_zod24.z.array(ChatHidden).max(200),
+  /** Kept out of the main window on purpose. */
+  hidden_from_main: import_zod24.z.boolean(),
+  /** Listed in a side window and not yet copied into main. */
+  main_pending: import_zod24.z.boolean(),
+  /** A scheduled routine's run (its task id). */
+  scheduled: import_zod24.z.string().max(200).nullable(),
+  /** Created recently and in no project: offered for filing. */
+  new_unfiled: import_zod24.z.boolean(),
+  warnings: import_zod24.z.array(import_zod24.z.string().max(400)).max(20),
+  last_use: ChatLastUse.nullable()
+});
+var AppsChatsListParams = import_zod24.z.strictObject({
+  app_key: AppKey,
+  /** Only these chats (a live update re-reads just what changed). */
+  ids: import_zod24.z.array(ChatId).max(500).optional()
+});
+var AppsChatsListResult = import_zod24.z.strictObject({
+  app_key: AppKey,
+  /** Bumps on every change the index sees; `apps.chats.changed` carries the same number. */
+  version: nonNegInt,
+  windows: import_zod24.z.array(ChatWindow).max(200),
+  projects: import_zod24.z.array(ChatProject).max(5e3),
+  chats: import_zod24.z.array(ChatRow).max(2e4),
+  /** How long a chat in no project counts as new. */
+  new_window_ms: nonNegInt
+});
+var AppsChatsWatchParams = import_zod24.z.strictObject({ app_key: AppKey });
+var AppsChatsWatchResult = import_zod24.z.strictObject({ resource_id: ResourceId, version: nonNegInt });
+var AppsChatsChangedEvent = import_zod24.z.strictObject({
+  app_key: AppKey,
+  version: nonNegInt,
+  ids: import_zod24.z.array(ChatId).max(1e3),
+  all: import_zod24.z.boolean()
+});
+var AppsProjectsFileParams = import_zod24.z.strictObject({
+  app_key: AppKey,
+  chat_id: ChatId,
+  project_id: ChatProjectId.optional(),
+  new_project_name: import_zod24.z.string().min(1).max(200).optional()
+});
+var AppsProjectsFileResult = import_zod24.z.strictObject({ chat: ChatRow, project: ChatProject });
+var AppsProjectsUnfileParams = import_zod24.z.strictObject({ app_key: AppKey, chat_id: ChatId, project_id: ChatProjectId });
+var AppsProjectsUnfileResult = import_zod24.z.strictObject({ chat: ChatRow });
+var AppsChatsStarParams = import_zod24.z.strictObject({ app_key: AppKey, chat_id: ChatId, starred: import_zod24.z.boolean() });
+var AppsChatsStarResult = import_zod24.z.strictObject({ chat: ChatRow });
+
 // src/schema/registry.ts
 var FS_ERR = ["NOT_FOUND", "PERMISSION_DENIED_OS", "INVALID_PARAMS", "RESOURCE_BUSY", "INTERNAL"];
 var OPS = {
@@ -1462,6 +1578,11 @@ var OPS = {
   "apps.profiles.save": { params: AppsProfilesSaveParams, result: AppsProfilesSaveResult, kind: "unary", since: "1.2", errors: ["AUTH_REQUIRED", "AUTH_FORBIDDEN", "NOT_FOUND", "INVALID_PARAMS", "CONFLICT", "PLATFORM_UNSUPPORTED", "DEVICE_OFFLINE", "INTERNAL"] },
   "apps.profiles.remove": { params: AppsProfilesRemoveParams, result: AppsProfilesRemoveResult, kind: "unary", since: "1.2", errors: ["AUTH_REQUIRED", "AUTH_FORBIDDEN", "NOT_FOUND", "DEVICE_OFFLINE", "INTERNAL"] },
   "apps.open": { params: AppsOpenParams, result: AppsOpenResult, kind: "unary", since: "1.2", errors: ["NOT_FOUND", "PLATFORM_UNSUPPORTED", "AUTH_REQUIRED", "DEVICE_OFFLINE", "INTERNAL"] },
+  "apps.chats.list": { params: AppsChatsListParams, result: AppsChatsListResult, kind: "unary", since: "1.8", errors: ["NOT_FOUND", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "apps.chats.watch": { params: AppsChatsWatchParams, result: AppsChatsWatchResult, kind: "resource", since: "1.8", errors: ["NOT_FOUND", "PLATFORM_UNSUPPORTED", "RESOURCE_BUSY", "INTERNAL"] },
+  "apps.chats.star": { params: AppsChatsStarParams, result: AppsChatsStarResult, kind: "unary", since: "1.8", errors: ["NOT_FOUND", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "apps.projects.file": { params: AppsProjectsFileParams, result: AppsProjectsFileResult, kind: "unary", since: "1.8", errors: ["NOT_FOUND", "INVALID_PARAMS", "CONFLICT", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "apps.projects.unfile": { params: AppsProjectsUnfileParams, result: AppsProjectsUnfileResult, kind: "unary", since: "1.8", errors: ["NOT_FOUND", "CONFLICT", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "proc.list": { params: ProcListParams, result: ProcListResult, kind: "unary", since: "1.3", errors: ["INVALID_PARAMS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "proc.ports": { params: ProcPortsParams, result: ProcPortsResult, kind: "unary", since: "1.3", errors: ["INVALID_PARAMS", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "proc.kill": { params: ProcKillParams, result: ProcKillResult, kind: "unary", since: "1.3", errors: ["NOT_FOUND", "AUTH_FORBIDDEN", "PERMISSION_DENIED_OS", "INVALID_PARAMS", "INTERNAL"] },
@@ -1498,6 +1619,7 @@ var OPS = {
 };
 var EVENTS = {
   "fs.changed": FsChangedEvent,
+  "apps.chats.changed": AppsChatsChangedEvent,
   "exec.exited": ExecExitedEvent,
   "exec.title": ExecTitleEvent,
   "exec.cwd": ExecCwdEvent,