@ai-matrx/desktop-protocol 0.17.2 → 0.17.4

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { O as OpName } from './models-QWCUcQuU.js';
-export { B as BEARER_PREFIX, g as CLOSE_RULES, h as CancelMsg, j as ClientToCoreMsg, e as ClientType, k as CloseAction, l as CloseCode, m as CloseCodeValue, C as CloseOutcome, n as CloseRule, o as CoreToClientMsg, p as CreditMsg, D as DesktopProtocolError, d as EVENTS, q as EndMsg, E as EndReason, r as ErrorCode, s as ErrorCodeName, t as ErrorData, u as ErrorMsg, v as ErrorReason, w as ErrorReasonName, x as EventMsg, y as EventName, F as FsPatchEditFailure, H as HelloMsg, L as Limits, z as MlInstallPhase, A as MlInstallProgress, f as MlProgress, G as MlRuntimeState, I as MlServiceState, J as MlServiceStatus, K as MlStatusParams, N as MlStatusResult, P as ModelsInstallParams, Q as ModelsInstallResult, R as ModelsProgressEvent, U as ModelsStatusParams, V as ModelsStatusResult, X as ModelsTranscribeParams, M as ModelsTranscribeResult, Y as NAMED_SCHEMAS, Z as NamedSchemaId, c as OPS, _ as OpDescriptor, a as OpParams, b as OpResult, $ as OpSpec, a0 as PING_TEXT, a1 as PONG_TEXT, a2 as ProtocolErrorBody, a3 as RelayMsg, a4 as RequestMsg, a5 as ResponseMsg, a6 as SERVICES, a7 as SUBPROTOCOL, a8 as ServiceId, a9 as ServiceOpName, aa as ServiceOpSpec, ab as ServiceSpec, S as StreamMeta, ac as StreamMsg, ad as TranscriptSegment, T as TranscriptionModelId, ae as TranscriptionModelInfo, W as Welcome, af as closeRule, i as isDesktopProtocolError, ag as isTerminalClose } from './models-QWCUcQuU.js';
+import { O as OpName } from './models-9j0ncAJj.js';
+export { B as BEARER_PREFIX, g as CLOSE_RULES, h as CancelMsg, j as ClientToCoreMsg, e as ClientType, k as CloseAction, l as CloseCode, m as CloseCodeValue, C as CloseOutcome, n as CloseRule, o as CoreToClientMsg, p as CreditMsg, D as DesktopProtocolError, d as EVENTS, q as EndMsg, E as EndReason, r as ErrorCode, s as ErrorCodeName, t as ErrorData, u as ErrorMsg, v as ErrorReason, w as ErrorReasonName, x as EventMsg, y as EventName, F as FsPatchEditFailure, H as HelloMsg, L as Limits, z as MlInstallPhase, A as MlInstallProgress, f as MlProgress, G as MlRuntimeState, I as MlServiceState, J as MlServiceStatus, K as MlStatusParams, N as MlStatusResult, P as ModelsInstallParams, Q as ModelsInstallResult, R as ModelsProgressEvent, U as ModelsStatusParams, V as ModelsStatusResult, X as ModelsTranscribeParams, M as ModelsTranscribeResult, Y as NAMED_SCHEMAS, Z as NamedSchemaId, c as OPS, _ as OpDescriptor, a as OpParams, b as OpResult, $ as OpSpec, a0 as PING_TEXT, a1 as PONG_TEXT, a2 as ProtocolErrorBody, a3 as RelayMsg, a4 as RequestMsg, a5 as ResponseMsg, a6 as SERVICES, a7 as SUBPROTOCOL, a8 as ServiceId, a9 as ServiceOpName, aa as ServiceOpSpec, ab as ServiceSpec, S as StreamMeta, ac as StreamMsg, ad as TranscriptSegment, T as TranscriptionModelId, ae as TranscriptionModelInfo, W as Welcome, af as closeRule, i as isDesktopProtocolError, ag as isTerminalClose } from './models-9j0ncAJj.js';
 export { BROADCAST_CID, DecodedFrame, FRAME_HEADER_BYTES, FRAME_STRUCT_FORMAT, FRAME_VERSION, FrameChannel, FrameChannelValue, FrameFlag, assertFrameHeader, connectionEndFrame, decodeFrame, encodeFrame, hasFlag, isConnectionEnd, readCid, stampCid } from './frame.js';
 
 /** @ai-matrx/desktop-protocol — version and primitive schemas. Schema source: lint-enforced rules in scripts/check-schema-source.mjs. */
@@ -19,10 +19,12 @@ declare const PROTOCOL_MAJOR: 1;
  *   1.5 — `coding.history.import_missing`: Claude Code history the platform lacks, imported by the
  *         `coding` Python service.
  *   1.6 — the `audio` capability: devices, record a clip to a WAV file, play a file.
+ *   1.7 — a window names its owning application and process (WindowInfo `app`, `pid`).
+ *   1.8 — `apps.chats.*` / `apps.projects.*`: a coding app's chats, windows, pins and projects, live.
  */
-declare const PROTOCOL_MINOR: 6;
+declare const PROTOCOL_MINOR: 8;
 /** This package's version as the wire spells it ("major.minor"): hello, welcome, relay status. */
-declare const PROTOCOL_VERSION: "1.6";
+declare const PROTOCOL_VERSION: "1.8";
 /** Internal building blocks — deliberately unnamed in $defs (inlined wherever used). */
 declare const u32: z.ZodInt;
 declare const nonNegInt: z.ZodInt;
@@ -1279,6 +1281,344 @@ declare const AppsOpenResult: z.ZodObject<{
 }, z.core.$strict>;
 type AppsOpenResult = z.output<typeof AppsOpenResult>;
 
+/**
+ * @ai-matrx/desktop-protocol — cap apps, chats and projects (SPEC §6 `apps`, §6.2): the
+ * conversations a coding app (Claude first; Codex, Cursor, VS Code through the same shape) keeps
+ * on this device, which of the app's windows (profiles) list each one, and the person's own
+ * groupings of them. Schema source: lint-enforced rules in scripts/check-schema-source.mjs.
+ *
+ * A chat is one conversation, keyed by its transcript id, never by one window's listing of it. A
+ * window is one profile of the app. A pin is the app's own (read only, never written); a star and
+ * a project are ours. Added in protocol 1.8.
+ */
+
+/** A conversation id (Claude: the transcript's cliSessionId). */
+declare const ChatId: z.ZodString;
+type ChatId = z.output<typeof ChatId>;
+/** A window (profile) key, e.g. "main", "emily"; "holder" is our vault, not a window. */
+declare const ChatPlace: z.ZodString;
+type ChatPlace = z.output<typeof ChatPlace>;
+/** A project id (a slug made from its first name). */
+declare const ChatProjectId: z.ZodString;
+type ChatProjectId = z.output<typeof ChatProjectId>;
+declare const ChatWindow: z.ZodObject<{
+    key: z.ZodString;
+    main: z.ZodBoolean;
+    account: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+type ChatWindow = z.output<typeof ChatWindow>;
+declare const ChatProject: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    archived: z.ZodBoolean;
+    count: z.ZodInt;
+}, z.core.$strict>;
+type ChatProject = z.output<typeof ChatProject>;
+/** The app's own pin, read from one window's account. */
+declare const ChatPin: z.ZodObject<{
+    window: z.ZodString;
+    observed_at_ms: z.ZodNullable<z.ZodInt>;
+}, z.core.$strict>;
+type ChatPin = z.output<typeof ChatPin>;
+declare const ChatRunning: z.ZodObject<{
+    window: z.ZodString;
+    how: z.ZodEnum<{
+        process: "process";
+        activity: "activity";
+    }>;
+}, z.core.$strict>;
+type ChatRunning = z.output<typeof ChatRunning>;
+/** A window that holds a listing of the chat but whose sidebar does not show it, and why. */
+declare const ChatHidden: z.ZodObject<{
+    window: z.ZodString;
+    reason: z.ZodString;
+}, z.core.$strict>;
+type ChatHidden = z.output<typeof ChatHidden>;
+declare const ChatLastUse: z.ZodObject<{
+    at_ms: z.ZodInt;
+    window: z.ZodNullable<z.ZodString>;
+    account: z.ZodNullable<z.ZodString>;
+    how: z.ZodNullable<z.ZodString>;
+    cache_warm: z.ZodBoolean;
+    cache_minutes_left: z.ZodInt;
+}, z.core.$strict>;
+type ChatLastUse = z.output<typeof ChatLastUse>;
+declare const ChatRow: z.ZodObject<{
+    id: z.ZodString;
+    short_id: z.ZodString;
+    record: z.ZodNullable<z.ZodString>;
+    title: z.ZodString;
+    last_active_ms: z.ZodNullable<z.ZodInt>;
+    created_ms: z.ZodNullable<z.ZodInt>;
+    projects: z.ZodArray<z.ZodString>;
+    starred: z.ZodBoolean;
+    pinned_in: z.ZodArray<z.ZodObject<{
+        window: z.ZodString;
+        observed_at_ms: z.ZodNullable<z.ZodInt>;
+    }, z.core.$strict>>;
+    places: z.ZodArray<z.ZodString>;
+    held: z.ZodBoolean;
+    running: z.ZodArray<z.ZodObject<{
+        window: z.ZodString;
+        how: z.ZodEnum<{
+            process: "process";
+            activity: "activity";
+        }>;
+    }, z.core.$strict>>;
+    hidden_in: z.ZodArray<z.ZodObject<{
+        window: z.ZodString;
+        reason: z.ZodString;
+    }, z.core.$strict>>;
+    hidden_from_main: z.ZodBoolean;
+    main_pending: z.ZodBoolean;
+    scheduled: z.ZodNullable<z.ZodString>;
+    new_unfiled: z.ZodBoolean;
+    warnings: z.ZodArray<z.ZodString>;
+    last_use: z.ZodNullable<z.ZodObject<{
+        at_ms: z.ZodInt;
+        window: z.ZodNullable<z.ZodString>;
+        account: z.ZodNullable<z.ZodString>;
+        how: z.ZodNullable<z.ZodString>;
+        cache_warm: z.ZodBoolean;
+        cache_minutes_left: z.ZodInt;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+type ChatRow = z.output<typeof ChatRow>;
+declare const AppsChatsListParams: z.ZodObject<{
+    app_key: z.ZodString;
+    ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+type AppsChatsListParams = z.output<typeof AppsChatsListParams>;
+declare const AppsChatsListResult: z.ZodObject<{
+    app_key: z.ZodString;
+    version: z.ZodInt;
+    windows: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        main: z.ZodBoolean;
+        account: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+    projects: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        archived: z.ZodBoolean;
+        count: z.ZodInt;
+    }, z.core.$strict>>;
+    chats: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        short_id: z.ZodString;
+        record: z.ZodNullable<z.ZodString>;
+        title: z.ZodString;
+        last_active_ms: z.ZodNullable<z.ZodInt>;
+        created_ms: z.ZodNullable<z.ZodInt>;
+        projects: z.ZodArray<z.ZodString>;
+        starred: z.ZodBoolean;
+        pinned_in: z.ZodArray<z.ZodObject<{
+            window: z.ZodString;
+            observed_at_ms: z.ZodNullable<z.ZodInt>;
+        }, z.core.$strict>>;
+        places: z.ZodArray<z.ZodString>;
+        held: z.ZodBoolean;
+        running: z.ZodArray<z.ZodObject<{
+            window: z.ZodString;
+            how: z.ZodEnum<{
+                process: "process";
+                activity: "activity";
+            }>;
+        }, z.core.$strict>>;
+        hidden_in: z.ZodArray<z.ZodObject<{
+            window: z.ZodString;
+            reason: z.ZodString;
+        }, z.core.$strict>>;
+        hidden_from_main: z.ZodBoolean;
+        main_pending: z.ZodBoolean;
+        scheduled: z.ZodNullable<z.ZodString>;
+        new_unfiled: z.ZodBoolean;
+        warnings: z.ZodArray<z.ZodString>;
+        last_use: z.ZodNullable<z.ZodObject<{
+            at_ms: z.ZodInt;
+            window: z.ZodNullable<z.ZodString>;
+            account: z.ZodNullable<z.ZodString>;
+            how: z.ZodNullable<z.ZodString>;
+            cache_warm: z.ZodBoolean;
+            cache_minutes_left: z.ZodInt;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    new_window_ms: z.ZodInt;
+}, z.core.$strict>;
+type AppsChatsListResult = z.output<typeof AppsChatsListResult>;
+declare const AppsChatsWatchParams: z.ZodObject<{
+    app_key: z.ZodString;
+}, z.core.$strict>;
+type AppsChatsWatchParams = z.output<typeof AppsChatsWatchParams>;
+declare const AppsChatsWatchResult: z.ZodObject<{
+    resource_id: z.ZodString;
+    version: z.ZodInt;
+}, z.core.$strict>;
+type AppsChatsWatchResult = z.output<typeof AppsChatsWatchResult>;
+/** Event to every holder of an `apps.chats.watch`: these chats changed (all: re-read the list). */
+declare const AppsChatsChangedEvent: z.ZodObject<{
+    app_key: z.ZodString;
+    version: z.ZodInt;
+    ids: z.ZodArray<z.ZodString>;
+    all: z.ZodBoolean;
+}, z.core.$strict>;
+type AppsChatsChangedEvent = z.output<typeof AppsChatsChangedEvent>;
+/** File a chat in a project: `project_id`, or `new_project_name` to make one (exactly one). */
+declare const AppsProjectsFileParams: z.ZodObject<{
+    app_key: z.ZodString;
+    chat_id: z.ZodString;
+    project_id: z.ZodOptional<z.ZodString>;
+    new_project_name: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+type AppsProjectsFileParams = z.output<typeof AppsProjectsFileParams>;
+declare const AppsProjectsFileResult: z.ZodObject<{
+    chat: z.ZodObject<{
+        id: z.ZodString;
+        short_id: z.ZodString;
+        record: z.ZodNullable<z.ZodString>;
+        title: z.ZodString;
+        last_active_ms: z.ZodNullable<z.ZodInt>;
+        created_ms: z.ZodNullable<z.ZodInt>;
+        projects: z.ZodArray<z.ZodString>;
+        starred: z.ZodBoolean;
+        pinned_in: z.ZodArray<z.ZodObject<{
+            window: z.ZodString;
+            observed_at_ms: z.ZodNullable<z.ZodInt>;
+        }, z.core.$strict>>;
+        places: z.ZodArray<z.ZodString>;
+        held: z.ZodBoolean;
+        running: z.ZodArray<z.ZodObject<{
+            window: z.ZodString;
+            how: z.ZodEnum<{
+                process: "process";
+                activity: "activity";
+            }>;
+        }, z.core.$strict>>;
+        hidden_in: z.ZodArray<z.ZodObject<{
+            window: z.ZodString;
+            reason: z.ZodString;
+        }, z.core.$strict>>;
+        hidden_from_main: z.ZodBoolean;
+        main_pending: z.ZodBoolean;
+        scheduled: z.ZodNullable<z.ZodString>;
+        new_unfiled: z.ZodBoolean;
+        warnings: z.ZodArray<z.ZodString>;
+        last_use: z.ZodNullable<z.ZodObject<{
+            at_ms: z.ZodInt;
+            window: z.ZodNullable<z.ZodString>;
+            account: z.ZodNullable<z.ZodString>;
+            how: z.ZodNullable<z.ZodString>;
+            cache_warm: z.ZodBoolean;
+            cache_minutes_left: z.ZodInt;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    project: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        archived: z.ZodBoolean;
+        count: z.ZodInt;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+type AppsProjectsFileResult = z.output<typeof AppsProjectsFileResult>;
+declare const AppsProjectsUnfileParams: z.ZodObject<{
+    app_key: z.ZodString;
+    chat_id: z.ZodString;
+    project_id: z.ZodString;
+}, z.core.$strict>;
+type AppsProjectsUnfileParams = z.output<typeof AppsProjectsUnfileParams>;
+declare const AppsProjectsUnfileResult: z.ZodObject<{
+    chat: z.ZodObject<{
+        id: z.ZodString;
+        short_id: z.ZodString;
+        record: z.ZodNullable<z.ZodString>;
+        title: z.ZodString;
+        last_active_ms: z.ZodNullable<z.ZodInt>;
+        created_ms: z.ZodNullable<z.ZodInt>;
+        projects: z.ZodArray<z.ZodString>;
+        starred: z.ZodBoolean;
+        pinned_in: z.ZodArray<z.ZodObject<{
+            window: z.ZodString;
+            observed_at_ms: z.ZodNullable<z.ZodInt>;
+        }, z.core.$strict>>;
+        places: z.ZodArray<z.ZodString>;
+        held: z.ZodBoolean;
+        running: z.ZodArray<z.ZodObject<{
+            window: z.ZodString;
+            how: z.ZodEnum<{
+                process: "process";
+                activity: "activity";
+            }>;
+        }, z.core.$strict>>;
+        hidden_in: z.ZodArray<z.ZodObject<{
+            window: z.ZodString;
+            reason: z.ZodString;
+        }, z.core.$strict>>;
+        hidden_from_main: z.ZodBoolean;
+        main_pending: z.ZodBoolean;
+        scheduled: z.ZodNullable<z.ZodString>;
+        new_unfiled: z.ZodBoolean;
+        warnings: z.ZodArray<z.ZodString>;
+        last_use: z.ZodNullable<z.ZodObject<{
+            at_ms: z.ZodInt;
+            window: z.ZodNullable<z.ZodString>;
+            account: z.ZodNullable<z.ZodString>;
+            how: z.ZodNullable<z.ZodString>;
+            cache_warm: z.ZodBoolean;
+            cache_minutes_left: z.ZodInt;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+type AppsProjectsUnfileResult = z.output<typeof AppsProjectsUnfileResult>;
+declare const AppsChatsStarParams: z.ZodObject<{
+    app_key: z.ZodString;
+    chat_id: z.ZodString;
+    starred: z.ZodBoolean;
+}, z.core.$strict>;
+type AppsChatsStarParams = z.output<typeof AppsChatsStarParams>;
+declare const AppsChatsStarResult: z.ZodObject<{
+    chat: z.ZodObject<{
+        id: z.ZodString;
+        short_id: z.ZodString;
+        record: z.ZodNullable<z.ZodString>;
+        title: z.ZodString;
+        last_active_ms: z.ZodNullable<z.ZodInt>;
+        created_ms: z.ZodNullable<z.ZodInt>;
+        projects: z.ZodArray<z.ZodString>;
+        starred: z.ZodBoolean;
+        pinned_in: z.ZodArray<z.ZodObject<{
+            window: z.ZodString;
+            observed_at_ms: z.ZodNullable<z.ZodInt>;
+        }, z.core.$strict>>;
+        places: z.ZodArray<z.ZodString>;
+        held: z.ZodBoolean;
+        running: z.ZodArray<z.ZodObject<{
+            window: z.ZodString;
+            how: z.ZodEnum<{
+                process: "process";
+                activity: "activity";
+            }>;
+        }, z.core.$strict>>;
+        hidden_in: z.ZodArray<z.ZodObject<{
+            window: z.ZodString;
+            reason: z.ZodString;
+        }, z.core.$strict>>;
+        hidden_from_main: z.ZodBoolean;
+        main_pending: z.ZodBoolean;
+        scheduled: z.ZodNullable<z.ZodString>;
+        new_unfiled: z.ZodBoolean;
+        warnings: z.ZodArray<z.ZodString>;
+        last_use: z.ZodNullable<z.ZodObject<{
+            at_ms: z.ZodInt;
+            window: z.ZodNullable<z.ZodString>;
+            account: z.ZodNullable<z.ZodString>;
+            how: z.ZodNullable<z.ZodString>;
+            cache_warm: z.ZodBoolean;
+            cache_minutes_left: z.ZodInt;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+type AppsChatsStarResult = z.output<typeof AppsChatsStarResult>;
+
 /**
  * @ai-matrx/desktop-protocol — the internal envelope between Matrx 2's core and its supervised
  * Python services (SPEC §3.10). Schema source: lint-enforced rules in scripts/check-schema-source.mjs.
@@ -1557,9 +1897,9 @@ type ServiceWelcome = z.output<typeof ServiceWelcome>;
 /** Tool names are the platform registry's (`tool.definition.name`): `fs_read`, `shell_execute`… */
 declare const ToolName: z.ZodString;
 declare const ToolLevel: z.ZodEnum<{
+    chat: "chat";
     programmatic: "programmatic";
     protocol: "protocol";
-    chat: "chat";
 }>;
 type ToolLevel = z.output<typeof ToolLevel>;
 declare const ToolOutcome: z.ZodEnum<{
@@ -1589,9 +1929,9 @@ type ToolTransport = z.output<typeof ToolTransport>;
 declare const ToolLevelResult: z.ZodObject<{
     tool: z.ZodString;
     level: z.ZodEnum<{
+        chat: "chat";
         programmatic: "programmatic";
         protocol: "protocol";
-        chat: "chat";
     }>;
     platform: z.ZodEnum<{
         darwin: "darwin";
@@ -1622,9 +1962,9 @@ declare const ToolResultsFile: z.ZodObject<{
     results: z.ZodArray<z.ZodObject<{
         tool: z.ZodString;
         level: z.ZodEnum<{
+            chat: "chat";
             programmatic: "programmatic";
             protocol: "protocol";
-            chat: "chat";
         }>;
         platform: z.ZodEnum<{
             darwin: "darwin";
@@ -1861,6 +2201,8 @@ declare const WindowInfo: z.ZodObject<{
     y: z.ZodInt;
     width: z.ZodInt;
     height: z.ZodInt;
+    app: z.ZodOptional<z.ZodString>;
+    pid: z.ZodOptional<z.ZodInt>;
 }, z.core.$strict>;
 type WindowInfo = z.output<typeof WindowInfo>;
 declare const WindowListParams: z.ZodObject<{
@@ -1876,6 +2218,8 @@ declare const WindowListResult: z.ZodObject<{
         y: z.ZodInt;
         width: z.ZodInt;
         height: z.ZodInt;
+        app: z.ZodOptional<z.ZodString>;
+        pid: z.ZodOptional<z.ZodInt>;
     }, z.core.$strict>>;
     total: z.ZodInt;
     truncated: z.ZodBoolean;
@@ -1893,6 +2237,8 @@ declare const WindowFocusResult: z.ZodObject<{
         y: z.ZodInt;
         width: z.ZodInt;
         height: z.ZodInt;
+        app: z.ZodOptional<z.ZodString>;
+        pid: z.ZodOptional<z.ZodInt>;
     }, z.core.$strict>;
 }, z.core.$strict>;
 type WindowFocusResult = z.output<typeof WindowFocusResult>;
@@ -1912,6 +2258,8 @@ declare const WindowMoveResult: z.ZodObject<{
         y: z.ZodInt;
         width: z.ZodInt;
         height: z.ZodInt;
+        app: z.ZodOptional<z.ZodString>;
+        pid: z.ZodOptional<z.ZodInt>;
     }, z.core.$strict>;
 }, z.core.$strict>;
 type WindowMoveResult = z.output<typeof WindowMoveResult>;
@@ -2672,6 +3020,10 @@ declare const FIELDS_SINCE: {
     readonly "RelayCallResponse|1": {
         readonly protocol_version: "1.1";
     };
+    readonly WindowInfo: {
+        readonly app: "1.7";
+        readonly pid: "1.7";
+    };
 };
 type FieldsSincePath = keyof typeof FIELDS_SINCE;
 /**
@@ -2726,7 +3078,7 @@ declare function forPeer(op: OpName | null, part: "error", value: unknown, versi
 declare const VERSIONED_RESULT_OPS: readonly OpName[];
 
 /** SHA-256 of generated/desktop-protocol.schema.json: the contract both sides of a service connection were built from. */
-declare const CONTRACT_SHA256: "2cbf3c7589a30141305f6f0f38c4d4a32bf9ef2a890f7572d9c7bd15c398d4b9";
+declare const CONTRACT_SHA256: "7a5b3712fe3200b8f1051edb1cc9702e696a8d24b2033f9ea73e1a422f52dd33";
 
 /**
  * The local tool catalog (SPEC §10): every tool a platform agent calls on a person's computer, the
@@ -2853,4 +3205,4 @@ declare function buildToolStatus(files: readonly unknown[], opts: {
 /** The committed text form. Columns: per platform, the three levels (P = programmatic, R = protocol, C = chat). */
 declare function renderToolStatusMarkdown(status: ToolStatus): string;
 
-export { AbsPath, AppFeatureStatus, AppInfo, AppKey, AppProfile, AppProfileId, AppProfileLocator, AppSupport, AppUsageReading, AppsListParams, AppsListResult, AppsOpenParams, AppsOpenResult, AppsProfilesListParams, AppsProfilesListResult, AppsProfilesRemoveParams, AppsProfilesRemoveResult, AppsProfilesSaveParams, AppsProfilesSaveResult, AudioDevice, AudioDevicesParams, AudioDevicesResult, AudioPlayParams, AudioPlayResult, AudioRecordParams, AudioRecordResult, CONTRACT_SHA256, type CatalogTool, type CellState, ClipboardReadParams, ClipboardReadResult, ClipboardWriteParams, ClipboardWriteResult, CodingHistoryBlocked, CodingHistoryFailure, CodingHistoryImportMissingParams, CodingHistoryImportMissingResult, CodingHistoryProgressEvent, CodingHistoryRun, CodingHistoryStep, CodingImportNextParams, CodingPlanMissingParams, CodingServiceCredentials, CodingServiceProgress, ContractHash, CoreToServiceMsg, DEFAULT_MAX_FRAME_PAYLOAD_BYTES, DEFAULT_MAX_MESSAGE_BYTES, DEFAULT_WINDOW_BYTES, DeviceId, EXCLUDED_TOOLS, ExecCwdEvent, ExecExitedEvent, ExecJobId, ExecJobInfo, ExecJobListParams, ExecJobListResult, ExecJobOutputParams, ExecJobOutputResult, ExecJobStartParams, ExecJobStartResult, ExecJobStopParams, ExecJobStopResult, ExecListParams, ExecListResult, ExecPtyKillParams, ExecPtyKillResult, ExecPtyResizeParams, ExecPtyResizeResult, ExecPtySignalParams, ExecPtySignalResult, ExecPtyStartParams, ExecPtyStartResult, ExecPtyWriteParams, ExecPtyWriteResult, ExecRunParams, ExecRunResult, ExecTitleEvent, FIELDS_SINCE, type FieldsSincePath, FrameHeader, FsChange, FsChangedEvent, FsDeleteParams, FsDeleteResult, FsEncoding, FsEntry, FsKind, FsListParams, FsListResult, FsMkdirParams, FsMkdirResult, FsMoveParams, FsMoveResult, FsPatchEditApplied, FsPatchParams, FsPatchResult, FsReadParams, FsReadResult, FsReadStreamParams, FsReadStreamResult, FsSearchContentParams, FsSearchContentResult, FsSearchPathsParams, FsSearchPathsResult, FsStatParams, FsStatResult, FsWatchEventsParams, FsWatchEventsResult, FsWatchId, FsWatchParams, FsWatchResult, FsWatchStartParams, FsWatchStartResult, FsWatchStopParams, FsWatchStopResult, FsWriteParams, FsWriteResult, InputHotkeyParams, InputHotkeyResult, InputKey, InputMouseClickParams, InputMouseClickResult, InputMouseMoveParams, InputMouseMoveResult, InputPoint, InputTypeTextParams, InputTypeTextResult, LEGACY_ACTIONS, LEGACY_DISPATCHERS, type LegacyDisposition, NULL_SINCE, OpName, OsPermissionName, PROTOCOL_MAJOR, PROTOCOL_MINOR, PROTOCOL_VERSION, PowerPreventSleepParams, PowerPreventSleepResult, PowerStatusParams, PowerStatusResult, ProcInfo, ProcKillParams, ProcKillResult, ProcListParams, ProcListResult, ProcPort, ProcPortsParams, ProcPortsResult, ProcSort, ProtocolVersion, PtyInfo, REASONS_SINCE, RELAY_CALL_HELLO_ID, RELAY_CALL_REQUEST_ID, RELAY_CALL_VERSION_HEADER, RelayAuthExpiringEvent, RelayCallEnvelope, RelayCallHello, RelayCallRequest, RelayCallResponse, RelayDeviceStatusEvent, RelayHopConnectionEnd, RelayHopEnvelopeHeader, RelayStatusResponse, RequestId, ResourceId, ResourceInfo, ResourcesDisk, ResourcesSnapshotParams, ResourcesSnapshotResult, SERVICE_MAX_FRAME_BYTES, ScreenCaptureParams, ScreenCaptureResult, ScreenDisplay, ScreenListParams, ScreenListResult, ServiceCancel, ServiceErrorMsg, ServiceHello, ServiceName, ServicePing, ServicePong, ServiceProgressMsg, ServiceRequest, ServiceResponse, ServiceShutdown, ServiceToCoreMsg, ServiceToken, ServiceWelcome, SessionAttachParams, SessionAttachResult, SessionControlChangedEvent, SessionDetachParams, SessionDetachResult, SessionListParams, SessionListResult, SessionReleaseParams, SessionReleaseResult, Signal, type StatusCell, type StatusEvidence, type StatusRow, SysinfoGetParams, SysinfoGetResult, SystemNotifyParams, SystemNotifyResult, SystemOpenPathParams, SystemOpenPathResult, SystemOpenUrlParams, SystemOpenUrlResult, TOOL_CATALOG, TOOL_GROUPS, TOOL_LEVELS, TOOL_PLATFORMS, type ToolGroup, type ToolGroupId, ToolLevel, ToolLevelResult, ToolName, ToolOutcome, type ToolPath, ToolPlatform, ToolResultsFile, type ToolState, type ToolStatus, ToolTransport, VERSIONED_RESULT_OPS, WindowFocusParams, WindowFocusResult, WindowInfo, WindowListParams, WindowListResult, WindowMinimizeParams, WindowMinimizeResult, WindowMoveParams, WindowMoveResult, announcedVersion, buildToolStatus, builtOps, compareVersions, epochMs, forPeer, knows, negotiate, nonNegInt, renderToolStatusMarkdown, statusForPeer, u32, versionSubprotocol };
+export { AbsPath, AppFeatureStatus, AppInfo, AppKey, AppProfile, AppProfileId, AppProfileLocator, AppSupport, AppUsageReading, AppsChatsChangedEvent, AppsChatsListParams, AppsChatsListResult, AppsChatsStarParams, AppsChatsStarResult, AppsChatsWatchParams, AppsChatsWatchResult, AppsListParams, AppsListResult, AppsOpenParams, AppsOpenResult, AppsProfilesListParams, AppsProfilesListResult, AppsProfilesRemoveParams, AppsProfilesRemoveResult, AppsProfilesSaveParams, AppsProfilesSaveResult, AppsProjectsFileParams, AppsProjectsFileResult, AppsProjectsUnfileParams, AppsProjectsUnfileResult, AudioDevice, AudioDevicesParams, AudioDevicesResult, AudioPlayParams, AudioPlayResult, AudioRecordParams, AudioRecordResult, CONTRACT_SHA256, type CatalogTool, type CellState, ChatHidden, ChatId, ChatLastUse, ChatPin, ChatPlace, ChatProject, ChatProjectId, ChatRow, ChatRunning, ChatWindow, ClipboardReadParams, ClipboardReadResult, ClipboardWriteParams, ClipboardWriteResult, CodingHistoryBlocked, CodingHistoryFailure, CodingHistoryImportMissingParams, CodingHistoryImportMissingResult, CodingHistoryProgressEvent, CodingHistoryRun, CodingHistoryStep, CodingImportNextParams, CodingPlanMissingParams, CodingServiceCredentials, CodingServiceProgress, ContractHash, CoreToServiceMsg, DEFAULT_MAX_FRAME_PAYLOAD_BYTES, DEFAULT_MAX_MESSAGE_BYTES, DEFAULT_WINDOW_BYTES, DeviceId, EXCLUDED_TOOLS, ExecCwdEvent, ExecExitedEvent, ExecJobId, ExecJobInfo, ExecJobListParams, ExecJobListResult, ExecJobOutputParams, ExecJobOutputResult, ExecJobStartParams, ExecJobStartResult, ExecJobStopParams, ExecJobStopResult, ExecListParams, ExecListResult, ExecPtyKillParams, ExecPtyKillResult, ExecPtyResizeParams, ExecPtyResizeResult, ExecPtySignalParams, ExecPtySignalResult, ExecPtyStartParams, ExecPtyStartResult, ExecPtyWriteParams, ExecPtyWriteResult, ExecRunParams, ExecRunResult, ExecTitleEvent, FIELDS_SINCE, type FieldsSincePath, FrameHeader, FsChange, FsChangedEvent, FsDeleteParams, FsDeleteResult, FsEncoding, FsEntry, FsKind, FsListParams, FsListResult, FsMkdirParams, FsMkdirResult, FsMoveParams, FsMoveResult, FsPatchEditApplied, FsPatchParams, FsPatchResult, FsReadParams, FsReadResult, FsReadStreamParams, FsReadStreamResult, FsSearchContentParams, FsSearchContentResult, FsSearchPathsParams, FsSearchPathsResult, FsStatParams, FsStatResult, FsWatchEventsParams, FsWatchEventsResult, FsWatchId, FsWatchParams, FsWatchResult, FsWatchStartParams, FsWatchStartResult, FsWatchStopParams, FsWatchStopResult, FsWriteParams, FsWriteResult, InputHotkeyParams, InputHotkeyResult, InputKey, InputMouseClickParams, InputMouseClickResult, InputMouseMoveParams, InputMouseMoveResult, InputPoint, InputTypeTextParams, InputTypeTextResult, LEGACY_ACTIONS, LEGACY_DISPATCHERS, type LegacyDisposition, NULL_SINCE, OpName, OsPermissionName, PROTOCOL_MAJOR, PROTOCOL_MINOR, PROTOCOL_VERSION, PowerPreventSleepParams, PowerPreventSleepResult, PowerStatusParams, PowerStatusResult, ProcInfo, ProcKillParams, ProcKillResult, ProcListParams, ProcListResult, ProcPort, ProcPortsParams, ProcPortsResult, ProcSort, ProtocolVersion, PtyInfo, REASONS_SINCE, RELAY_CALL_HELLO_ID, RELAY_CALL_REQUEST_ID, RELAY_CALL_VERSION_HEADER, RelayAuthExpiringEvent, RelayCallEnvelope, RelayCallHello, RelayCallRequest, RelayCallResponse, RelayDeviceStatusEvent, RelayHopConnectionEnd, RelayHopEnvelopeHeader, RelayStatusResponse, RequestId, ResourceId, ResourceInfo, ResourcesDisk, ResourcesSnapshotParams, ResourcesSnapshotResult, SERVICE_MAX_FRAME_BYTES, ScreenCaptureParams, ScreenCaptureResult, ScreenDisplay, ScreenListParams, ScreenListResult, ServiceCancel, ServiceErrorMsg, ServiceHello, ServiceName, ServicePing, ServicePong, ServiceProgressMsg, ServiceRequest, ServiceResponse, ServiceShutdown, ServiceToCoreMsg, ServiceToken, ServiceWelcome, SessionAttachParams, SessionAttachResult, SessionControlChangedEvent, SessionDetachParams, SessionDetachResult, SessionListParams, SessionListResult, SessionReleaseParams, SessionReleaseResult, Signal, type StatusCell, type StatusEvidence, type StatusRow, SysinfoGetParams, SysinfoGetResult, SystemNotifyParams, SystemNotifyResult, SystemOpenPathParams, SystemOpenPathResult, SystemOpenUrlParams, SystemOpenUrlResult, TOOL_CATALOG, TOOL_GROUPS, TOOL_LEVELS, TOOL_PLATFORMS, type ToolGroup, type ToolGroupId, ToolLevel, ToolLevelResult, ToolName, ToolOutcome, type ToolPath, ToolPlatform, ToolResultsFile, type ToolState, type ToolStatus, ToolTransport, VERSIONED_RESULT_OPS, WindowFocusParams, WindowFocusResult, WindowInfo, WindowListParams, WindowListResult, WindowMinimizeParams, WindowMinimizeResult, WindowMoveParams, WindowMoveResult, announcedVersion, buildToolStatus, builtOps, compareVersions, epochMs, forPeer, knows, negotiate, nonNegInt, renderToolStatusMarkdown, statusForPeer, u32, versionSubprotocol };