@ai-matrx/desktop-protocol 0.17.3 → 0.17.5

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { O as OpName } from './models-BiquRLLO.cjs';
-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-BiquRLLO.cjs';
+import { O as OpName } from './models-Bb87iuvw.cjs';
+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-Bb87iuvw.cjs';
 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.cjs';
 
 /** @ai-matrx/desktop-protocol — version and primitive schemas. Schema source: lint-enforced rules in scripts/check-schema-source.mjs. */
@@ -20,10 +20,13 @@ declare const PROTOCOL_MAJOR: 1;
  *         `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.
+ *   1.9 — chats placed in windows / held, several filed at once, projects renamed / archived / copied;
+ *         the list says when it is a saved copy being re-read (`updating`) and when it is not live.
  */
-declare const PROTOCOL_MINOR: 7;
+declare const PROTOCOL_MINOR: 9;
 /** This package's version as the wire spells it ("major.minor"): hello, welcome, relay status. */
-declare const PROTOCOL_VERSION: "1.7";
+declare const PROTOCOL_VERSION: "1.9";
 /** Internal building blocks — deliberately unnamed in $defs (inlined wherever used). */
 declare const u32: z.ZodInt;
 declare const nonNegInt: z.ZodInt;
@@ -1280,6 +1283,501 @@ 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;
+    updating: z.ZodOptional<z.ZodBoolean>;
+    live: z.ZodOptional<z.ZodBoolean>;
+}, 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>;
+/** 1.9: the index's own state, to every watcher: live (changes arrive) or not, and why. */
+declare const AppsChatsWatchStateEvent: z.ZodObject<{
+    app_key: z.ZodString;
+    live: z.ZodBoolean;
+    updating: z.ZodBoolean;
+    reason: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+type AppsChatsWatchStateEvent = z.output<typeof AppsChatsWatchStateEvent>;
+/** 1.9: put a chat in a window, take it off one (never its last place), or keep it in the holder. */
+declare const AppsChatsPlaceParams: z.ZodObject<{
+    app_key: z.ZodString;
+    chat_id: z.ZodString;
+    action: z.ZodEnum<{
+        place: "place";
+        take_off: "take_off";
+        hold: "hold";
+    }>;
+    window: z.ZodOptional<z.ZodString>;
+    stop_if_open: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>;
+type AppsChatsPlaceParams = z.output<typeof AppsChatsPlaceParams>;
+declare const AppsChatsPlaceResult: 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>;
+    message: z.ZodString;
+}, z.core.$strict>;
+type AppsChatsPlaceResult = z.output<typeof AppsChatsPlaceResult>;
+/** 1.9: several chats into one project (or a new one by name). */
+declare const AppsProjectsFileManyParams: z.ZodObject<{
+    app_key: z.ZodString;
+    chat_ids: z.ZodArray<z.ZodString>;
+    project_id: z.ZodOptional<z.ZodString>;
+    new_project_name: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+type AppsProjectsFileManyParams = z.output<typeof AppsProjectsFileManyParams>;
+declare const AppsProjectsFileManyResult: z.ZodObject<{
+    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>>;
+    project: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        archived: z.ZodBoolean;
+        count: z.ZodInt;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+type AppsProjectsFileManyResult = z.output<typeof AppsProjectsFileManyResult>;
+/** 1.9: rename, archive or restore a project. */
+declare const AppsProjectsUpdateParams: z.ZodObject<{
+    app_key: z.ZodString;
+    project_id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    archived: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+type AppsProjectsUpdateParams = z.output<typeof AppsProjectsUpdateParams>;
+declare const AppsProjectsUpdateResult: z.ZodObject<{
+    project: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        archived: z.ZodBoolean;
+        count: z.ZodInt;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+type AppsProjectsUpdateResult = z.output<typeof AppsProjectsUpdateResult>;
+/** 1.9: save a copy of every chat in a project as another project (made if new). */
+declare const AppsProjectsCopyParams: z.ZodObject<{
+    app_key: z.ZodString;
+    project_id: z.ZodString;
+    new_project_name: z.ZodString;
+}, z.core.$strict>;
+type AppsProjectsCopyParams = z.output<typeof AppsProjectsCopyParams>;
+declare const AppsProjectsCopyResult: z.ZodObject<{
+    project: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        archived: z.ZodBoolean;
+        count: z.ZodInt;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+type AppsProjectsCopyResult = z.output<typeof AppsProjectsCopyResult>;
+
 /**
  * @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.
@@ -1558,9 +2056,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<{
@@ -1590,9 +2088,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";
@@ -1623,9 +2121,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";
@@ -2685,6 +3183,10 @@ declare const FIELDS_SINCE: {
         readonly app: "1.7";
         readonly pid: "1.7";
     };
+    readonly AppsChatsListResult: {
+        readonly updating: "1.9";
+        readonly live: "1.9";
+    };
 };
 type FieldsSincePath = keyof typeof FIELDS_SINCE;
 /**
@@ -2739,7 +3241,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: "5525674072a767340a8bd75a4e4b98c588577a866b4d381edeb377401729e14d";
+declare const CONTRACT_SHA256: "8a36e6b958c871853f0a9520e49c92dd30aa05442765c5a1f04c4caa71a35229";
 
 /**
  * The local tool catalog (SPEC §10): every tool a platform agent calls on a person's computer, the
@@ -2866,4 +3368,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, AppsChatsPlaceParams, AppsChatsPlaceResult, AppsChatsStarParams, AppsChatsStarResult, AppsChatsWatchParams, AppsChatsWatchResult, AppsChatsWatchStateEvent, AppsListParams, AppsListResult, AppsOpenParams, AppsOpenResult, AppsProfilesListParams, AppsProfilesListResult, AppsProfilesRemoveParams, AppsProfilesRemoveResult, AppsProfilesSaveParams, AppsProfilesSaveResult, AppsProjectsCopyParams, AppsProjectsCopyResult, AppsProjectsFileManyParams, AppsProjectsFileManyResult, AppsProjectsFileParams, AppsProjectsFileResult, AppsProjectsUnfileParams, AppsProjectsUnfileResult, AppsProjectsUpdateParams, AppsProjectsUpdateResult, 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 };