@ai-matrx/desktop-protocol 0.17.5 → 0.17.7

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-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';
+import { O as OpName } from './models-Os6toG3X.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-Os6toG3X.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. */
@@ -24,9 +24,9 @@ declare const PROTOCOL_MAJOR: 1;
  *   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: 9;
+declare const PROTOCOL_MINOR: 11;
 /** This package's version as the wire spells it ("major.minor"): hello, welcome, relay status. */
-declare const PROTOCOL_VERSION: "1.9";
+declare const PROTOCOL_VERSION: "1.11";
 /** Internal building blocks — deliberately unnamed in $defs (inlined wherever used). */
 declare const u32: z.ZodInt;
 declare const nonNegInt: z.ZodInt;
@@ -1386,6 +1386,13 @@ declare const ChatRow: z.ZodObject<{
     }, z.core.$strict>>;
 }, z.core.$strict>;
 type ChatRow = z.output<typeof ChatRow>;
+/** 1.10: a chat's family: the conversation it was forked from, or the original it is a copy of. */
+declare const ChatFamily: z.ZodObject<{
+    id: z.ZodString;
+    fork_of: z.ZodNullable<z.ZodString>;
+    copy_of: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+type ChatFamily = z.output<typeof ChatFamily>;
 declare const AppsChatsListParams: z.ZodObject<{
     app_key: z.ZodString;
     ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -1448,6 +1455,11 @@ declare const AppsChatsListResult: z.ZodObject<{
     new_window_ms: z.ZodInt;
     updating: z.ZodOptional<z.ZodBoolean>;
     live: z.ZodOptional<z.ZodBoolean>;
+    families: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        fork_of: z.ZodNullable<z.ZodString>;
+        copy_of: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>>;
 }, z.core.$strict>;
 type AppsChatsListResult = z.output<typeof AppsChatsListResult>;
 declare const AppsChatsWatchParams: z.ZodObject<{
@@ -1778,6 +1790,575 @@ declare const AppsProjectsCopyResult: z.ZodObject<{
 }, z.core.$strict>;
 type AppsProjectsCopyResult = z.output<typeof AppsProjectsCopyResult>;
 
+/**
+ * @ai-matrx/desktop-protocol — cap apps, a coding app's windows and the accounts behind them
+ * (SPEC §6 `apps`, §6.2, plan `apps-chats` phase 2): each window (profile) with the account it is
+ * meant for and the one signed in, open or closed; each account's plan usage (5-hour, weekly,
+ * extra) as the app records it; each account's weekly reset; and the window actions (bring to
+ * front or open, reload its list, restart, open briefly for a fresh usage reading). Claude is the
+ * first adapter. Added in protocol 1.10. Schema source: lint-enforced rules in
+ * scripts/check-schema-source.mjs.
+ */
+
+/** One window (profile) of the app on this device. */
+declare const AppWindowInfo: z.ZodObject<{
+    key: z.ZodString;
+    main: z.ZodBoolean;
+    account: z.ZodNullable<z.ZodString>;
+    signed_in: z.ZodNullable<z.ZodString>;
+    signed_in_is_email: z.ZodBoolean;
+    mismatch: z.ZodBoolean;
+    created: z.ZodBoolean;
+    running: z.ZodBoolean;
+    open_chats: z.ZodInt;
+}, z.core.$strict>;
+type AppWindowInfo = z.output<typeof AppWindowInfo>;
+/** One account's plan usage, newest reading from any window (an account is matched to an org by vote). */
+declare const AccountUsage: z.ZodObject<{
+    account: z.ZodString;
+    org: z.ZodNullable<z.ZodString>;
+    account_certain: z.ZodBoolean;
+    five_hour: z.ZodNullable<z.ZodNumber>;
+    five_hour_reset_since: z.ZodBoolean;
+    weekly: z.ZodNullable<z.ZodNumber>;
+    weekly_reset_since: z.ZodBoolean;
+    extra_usage: z.ZodNullable<z.ZodNumber>;
+    extra_usage_as_of_ms: z.ZodNullable<z.ZodInt>;
+    as_of_ms: z.ZodInt;
+    windows: z.ZodArray<z.ZodString>;
+    live: z.ZodBoolean;
+    weekly_resets_at_ms: z.ZodNullable<z.ZodInt>;
+    weekly_reset_official: z.ZodNullable<z.ZodBoolean>;
+}, z.core.$strict>;
+type AccountUsage = z.output<typeof AccountUsage>;
+/** One window's account's next weekly reset and where the time came from. */
+declare const AccountReset: z.ZodObject<{
+    window: z.ZodString;
+    account: z.ZodNullable<z.ZodString>;
+    next_reset_ms: z.ZodNullable<z.ZodInt>;
+    source: z.ZodNullable<z.ZodEnum<{
+        claude: "claude";
+        usage_history: "usage_history";
+        your_list: "your_list";
+    }>>;
+    official: z.ZodBoolean;
+    note: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+type AccountReset = z.output<typeof AccountReset>;
+declare const AppsWindowsListParams: z.ZodObject<{
+    app_key: z.ZodString;
+}, z.core.$strict>;
+type AppsWindowsListParams = z.output<typeof AppsWindowsListParams>;
+declare const AppsWindowsListResult: z.ZodObject<{
+    app_key: z.ZodString;
+    windows: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        main: z.ZodBoolean;
+        account: z.ZodNullable<z.ZodString>;
+        signed_in: z.ZodNullable<z.ZodString>;
+        signed_in_is_email: z.ZodBoolean;
+        mismatch: z.ZodBoolean;
+        created: z.ZodBoolean;
+        running: z.ZodBoolean;
+        open_chats: z.ZodInt;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+type AppsWindowsListResult = z.output<typeof AppsWindowsListResult>;
+declare const AppsAccountsUsageParams: z.ZodObject<{
+    app_key: z.ZodString;
+}, z.core.$strict>;
+type AppsAccountsUsageParams = z.output<typeof AppsAccountsUsageParams>;
+declare const AppsAccountsUsageResult: z.ZodObject<{
+    app_key: z.ZodString;
+    accounts: z.ZodArray<z.ZodObject<{
+        account: z.ZodString;
+        org: z.ZodNullable<z.ZodString>;
+        account_certain: z.ZodBoolean;
+        five_hour: z.ZodNullable<z.ZodNumber>;
+        five_hour_reset_since: z.ZodBoolean;
+        weekly: z.ZodNullable<z.ZodNumber>;
+        weekly_reset_since: z.ZodBoolean;
+        extra_usage: z.ZodNullable<z.ZodNumber>;
+        extra_usage_as_of_ms: z.ZodNullable<z.ZodInt>;
+        as_of_ms: z.ZodInt;
+        windows: z.ZodArray<z.ZodString>;
+        live: z.ZodBoolean;
+        weekly_resets_at_ms: z.ZodNullable<z.ZodInt>;
+        weekly_reset_official: z.ZodNullable<z.ZodBoolean>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+type AppsAccountsUsageResult = z.output<typeof AppsAccountsUsageResult>;
+declare const AppsAccountsResetsParams: z.ZodObject<{
+    app_key: z.ZodString;
+}, z.core.$strict>;
+type AppsAccountsResetsParams = z.output<typeof AppsAccountsResetsParams>;
+declare const AppsAccountsResetsResult: z.ZodObject<{
+    app_key: z.ZodString;
+    resets: z.ZodArray<z.ZodObject<{
+        window: z.ZodString;
+        account: z.ZodNullable<z.ZodString>;
+        next_reset_ms: z.ZodNullable<z.ZodInt>;
+        source: z.ZodNullable<z.ZodEnum<{
+            claude: "claude";
+            usage_history: "usage_history";
+            your_list: "your_list";
+        }>>;
+        official: z.ZodBoolean;
+        note: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+type AppsAccountsResetsResult = z.output<typeof AppsAccountsResetsResult>;
+/** A window action's answer: what happened, in one line. */
+declare const AppsWindowActionResult: z.ZodObject<{
+    message: z.ZodString;
+}, z.core.$strict>;
+type AppsWindowActionResult = z.output<typeof AppsWindowActionResult>;
+/** Bring the window to the front if it is open (never a second copy), else open it. */
+declare const AppsWindowsOpenParams: z.ZodObject<{
+    app_key: z.ZodString;
+    window: z.ZodString;
+}, z.core.$strict>;
+type AppsWindowsOpenParams = z.output<typeof AppsWindowsOpenParams>;
+/** Reload an open window's page (⌘R) so it re-reads its chat list; its chats keep running. */
+declare const AppsWindowsReloadParams: z.ZodObject<{
+    app_key: z.ZodString;
+    window: z.ZodString;
+}, z.core.$strict>;
+type AppsWindowsReloadParams = z.output<typeof AppsWindowsReloadParams>;
+/** Quit and reopen a window; refused (CONFLICT) while chats are open in it unless `force`. */
+declare const AppsWindowsRestartParams: z.ZodObject<{
+    app_key: z.ZodString;
+    window: z.ZodString;
+    force: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>;
+type AppsWindowsRestartParams = z.output<typeof AppsWindowsRestartParams>;
+/** Open a closed window in the background until it records a fresh usage reading, then close it. */
+declare const AppsWindowsRefreshUsageParams: z.ZodObject<{
+    app_key: z.ZodString;
+    window: z.ZodString;
+}, z.core.$strict>;
+type AppsWindowsRefreshUsageParams = z.output<typeof AppsWindowsRefreshUsageParams>;
+/** Move a chat from one project to another (made if new by name). */
+declare const AppsProjectsMoveParams: z.ZodObject<{
+    app_key: z.ZodString;
+    chat_id: z.ZodString;
+    from_project_id: z.ZodString;
+    to_project_id: z.ZodOptional<z.ZodString>;
+    new_project_name: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+type AppsProjectsMoveParams = z.output<typeof AppsProjectsMoveParams>;
+declare const AppsProjectsMoveResult: 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 AppsProjectsMoveResult = z.output<typeof AppsProjectsMoveResult>;
+/** A new, empty project. */
+declare const AppsProjectsCreateParams: z.ZodObject<{
+    app_key: z.ZodString;
+    name: z.ZodString;
+}, z.core.$strict>;
+type AppsProjectsCreateParams = z.output<typeof AppsProjectsCreateParams>;
+declare const AppsProjectsCreateResult: z.ZodObject<{
+    project: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        archived: z.ZodBoolean;
+        count: z.ZodInt;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+type AppsProjectsCreateResult = z.output<typeof AppsProjectsCreateResult>;
+/** Refresh pins: the Unsorted project becomes every pinned chat in no other project (never touches the app's pins). */
+declare const AppsProjectsImportPinsParams: z.ZodObject<{
+    app_key: z.ZodString;
+}, z.core.$strict>;
+type AppsProjectsImportPinsParams = z.output<typeof AppsProjectsImportPinsParams>;
+declare const AppsProjectsImportPinsResult: z.ZodObject<{
+    message: z.ZodString;
+}, z.core.$strict>;
+type AppsProjectsImportPinsResult = z.output<typeof AppsProjectsImportPinsResult>;
+/** A chat waiting for the person, with when its prompt cache goes cold and what waking it costs (API list prices, USD). */
+declare const ColdChat: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    repo: z.ZodNullable<z.ZodString>;
+    window: z.ZodNullable<z.ZodString>;
+    account: z.ZodNullable<z.ZodString>;
+    model_name: z.ZodNullable<z.ZodString>;
+    context_tokens: z.ZodInt;
+    cold_at_ms: z.ZodInt;
+    cold_cost: z.ZodNullable<z.ZodNumber>;
+    warm_cost: z.ZodNullable<z.ZodNumber>;
+    extra_usage: z.ZodBoolean;
+    scheduled: z.ZodBoolean;
+    openable: z.ZodBoolean;
+    how: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+type ColdChat = z.output<typeof ColdChat>;
+declare const AppsChatsColdParams: z.ZodObject<{
+    app_key: z.ZodString;
+}, z.core.$strict>;
+type AppsChatsColdParams = z.output<typeof AppsChatsColdParams>;
+declare const AppsChatsColdResult: z.ZodObject<{
+    app_key: z.ZodString;
+    waiting: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        repo: z.ZodNullable<z.ZodString>;
+        window: z.ZodNullable<z.ZodString>;
+        account: z.ZodNullable<z.ZodString>;
+        model_name: z.ZodNullable<z.ZodString>;
+        context_tokens: z.ZodInt;
+        cold_at_ms: z.ZodInt;
+        cold_cost: z.ZodNullable<z.ZodNumber>;
+        warm_cost: z.ZodNullable<z.ZodNumber>;
+        extra_usage: z.ZodBoolean;
+        scheduled: z.ZodBoolean;
+        openable: z.ZodBoolean;
+        how: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+    recently_cold: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        repo: z.ZodNullable<z.ZodString>;
+        window: z.ZodNullable<z.ZodString>;
+        account: z.ZodNullable<z.ZodString>;
+        model_name: z.ZodNullable<z.ZodString>;
+        context_tokens: z.ZodInt;
+        cold_at_ms: z.ZodInt;
+        cold_cost: z.ZodNullable<z.ZodNumber>;
+        warm_cost: z.ZodNullable<z.ZodNumber>;
+        extra_usage: z.ZodBoolean;
+        scheduled: z.ZodBoolean;
+        openable: z.ZodBoolean;
+        how: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+    working: z.ZodInt;
+}, z.core.$strict>;
+type AppsChatsColdResult = z.output<typeof AppsChatsColdResult>;
+/** Show one chat in its window (Claude's own "Continue session" link, sent to that window only); never sends it anything. */
+declare const AppsChatsOpenParams: z.ZodObject<{
+    app_key: z.ZodString;
+    chat_id: z.ZodString;
+    window: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+type AppsChatsOpenParams = z.output<typeof AppsChatsOpenParams>;
+/** Main conversation and helpers, USD at API list prices. */
+declare const SpendSplit: z.ZodObject<{
+    main: z.ZodNumber;
+    helpers: z.ZodNumber;
+}, z.core.$strict>;
+type SpendSplit = z.output<typeof SpendSplit>;
+declare const SpendScopes: z.ZodObject<{
+    today: z.ZodObject<{
+        main: z.ZodNumber;
+        helpers: z.ZodNumber;
+    }, z.core.$strict>;
+    week: z.ZodObject<{
+        main: z.ZodNumber;
+        helpers: z.ZodNumber;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+type SpendScopes = z.output<typeof SpendScopes>;
+declare const SpendAccount: z.ZodObject<{
+    account: z.ZodString;
+    spend: z.ZodObject<{
+        today: z.ZodObject<{
+            main: z.ZodNumber;
+            helpers: z.ZodNumber;
+        }, z.core.$strict>;
+        week: z.ZodObject<{
+            main: z.ZodNumber;
+            helpers: z.ZodNumber;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    last_hour: z.ZodNullable<z.ZodNumber>;
+    last_5h: z.ZodNullable<z.ZodNumber>;
+    five_hour: z.ZodNullable<z.ZodNumber>;
+    weekly: z.ZodNullable<z.ZodNumber>;
+    as_of_ms: z.ZodNullable<z.ZodInt>;
+    weekly_resets_at_ms: z.ZodNullable<z.ZodInt>;
+    five_hour_full_at_ms: z.ZodNullable<z.ZodInt>;
+    weekly_full_at_ms: z.ZodNullable<z.ZodInt>;
+    stale: z.ZodBoolean;
+}, z.core.$strict>;
+type SpendAccount = z.output<typeof SpendAccount>;
+declare const SpendModel: z.ZodObject<{
+    model: z.ZodString;
+    name: z.ZodString;
+    spend: z.ZodObject<{
+        today: z.ZodObject<{
+            main: z.ZodNumber;
+            helpers: z.ZodNumber;
+        }, z.core.$strict>;
+        week: z.ZodObject<{
+            main: z.ZodNumber;
+            helpers: z.ZodNumber;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+type SpendModel = z.output<typeof SpendModel>;
+declare const SpendChat: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    repo: z.ZodNullable<z.ZodString>;
+    window: z.ZodNullable<z.ZodString>;
+    spend: z.ZodObject<{
+        today: z.ZodObject<{
+            main: z.ZodNumber;
+            helpers: z.ZodNumber;
+        }, z.core.$strict>;
+        week: z.ZodObject<{
+            main: z.ZodNumber;
+            helpers: z.ZodNumber;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    helpers: z.ZodInt;
+}, z.core.$strict>;
+type SpendChat = z.output<typeof SpendChat>;
+declare const SpendHelper: z.ZodObject<{
+    model: z.ZodString;
+    steps: z.ZodInt;
+    over_steps: z.ZodBoolean;
+    description: z.ZodString;
+}, z.core.$strict>;
+type SpendHelper = z.output<typeof SpendHelper>;
+declare const SpendLive: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    window: z.ZodNullable<z.ZodString>;
+    helpers: z.ZodArray<z.ZodObject<{
+        model: z.ZodString;
+        steps: z.ZodInt;
+        over_steps: z.ZodBoolean;
+        description: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+type SpendLive = z.output<typeof SpendLive>;
+declare const SpendIdleScope: z.ZodObject<{
+    count: z.ZodInt;
+    tokens: z.ZodInt;
+    cost: z.ZodNumber;
+    avoidable: z.ZodNumber;
+}, z.core.$strict>;
+type SpendIdleScope = z.output<typeof SpendIdleScope>;
+/** Idle cache re-saves, grouped by chat and by who re-saved (the chat itself or one helper). */
+declare const SpendIdle: z.ZodObject<{
+    id: z.ZodString;
+    chat: z.ZodString;
+    who: z.ZodString;
+    today: z.ZodObject<{
+        count: z.ZodInt;
+        tokens: z.ZodInt;
+        cost: z.ZodNumber;
+        avoidable: z.ZodNumber;
+    }, z.core.$strict>;
+    week: z.ZodObject<{
+        count: z.ZodInt;
+        tokens: z.ZodInt;
+        cost: z.ZodNumber;
+        avoidable: z.ZodNumber;
+    }, z.core.$strict>;
+    last_ms: z.ZodInt;
+}, z.core.$strict>;
+type SpendIdle = z.output<typeof SpendIdle>;
+/** How big each repo's helpers start (their first request's tokens). */
+declare const SpendStart: z.ZodObject<{
+    repo: z.ZodString;
+    count: z.ZodInt;
+    median: z.ZodInt;
+    latest: z.ZodArray<z.ZodInt>;
+    alarm: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+type SpendStart = z.output<typeof SpendStart>;
+declare const AppsSpendParams: z.ZodObject<{
+    app_key: z.ZodString;
+}, z.core.$strict>;
+type AppsSpendParams = z.output<typeof AppsSpendParams>;
+declare const AppsSpendResult: z.ZodObject<{
+    app_key: z.ZodString;
+    complete: z.ZodBoolean;
+    today_total: z.ZodNumber;
+    week_total: z.ZodNumber;
+    idle_today: z.ZodNumber;
+    idle_week: z.ZodNumber;
+    unpriced: z.ZodArray<z.ZodString>;
+    alarms: z.ZodArray<z.ZodString>;
+    live: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        window: z.ZodNullable<z.ZodString>;
+        helpers: z.ZodArray<z.ZodObject<{
+            model: z.ZodString;
+            steps: z.ZodInt;
+            over_steps: z.ZodBoolean;
+            description: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    accounts: z.ZodArray<z.ZodObject<{
+        account: z.ZodString;
+        spend: z.ZodObject<{
+            today: z.ZodObject<{
+                main: z.ZodNumber;
+                helpers: z.ZodNumber;
+            }, z.core.$strict>;
+            week: z.ZodObject<{
+                main: z.ZodNumber;
+                helpers: z.ZodNumber;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+        last_hour: z.ZodNullable<z.ZodNumber>;
+        last_5h: z.ZodNullable<z.ZodNumber>;
+        five_hour: z.ZodNullable<z.ZodNumber>;
+        weekly: z.ZodNullable<z.ZodNumber>;
+        as_of_ms: z.ZodNullable<z.ZodInt>;
+        weekly_resets_at_ms: z.ZodNullable<z.ZodInt>;
+        five_hour_full_at_ms: z.ZodNullable<z.ZodInt>;
+        weekly_full_at_ms: z.ZodNullable<z.ZodInt>;
+        stale: z.ZodBoolean;
+    }, z.core.$strict>>;
+    models: z.ZodArray<z.ZodObject<{
+        model: z.ZodString;
+        name: z.ZodString;
+        spend: z.ZodObject<{
+            today: z.ZodObject<{
+                main: z.ZodNumber;
+                helpers: z.ZodNumber;
+            }, z.core.$strict>;
+            week: z.ZodObject<{
+                main: z.ZodNumber;
+                helpers: z.ZodNumber;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
+    chats: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        repo: z.ZodNullable<z.ZodString>;
+        window: z.ZodNullable<z.ZodString>;
+        spend: z.ZodObject<{
+            today: z.ZodObject<{
+                main: z.ZodNumber;
+                helpers: z.ZodNumber;
+            }, z.core.$strict>;
+            week: z.ZodObject<{
+                main: z.ZodNumber;
+                helpers: z.ZodNumber;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+        helpers: z.ZodInt;
+    }, z.core.$strict>>;
+    idle: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        chat: z.ZodString;
+        who: z.ZodString;
+        today: z.ZodObject<{
+            count: z.ZodInt;
+            tokens: z.ZodInt;
+            cost: z.ZodNumber;
+            avoidable: z.ZodNumber;
+        }, z.core.$strict>;
+        week: z.ZodObject<{
+            count: z.ZodInt;
+            tokens: z.ZodInt;
+            cost: z.ZodNumber;
+            avoidable: z.ZodNumber;
+        }, z.core.$strict>;
+        last_ms: z.ZodInt;
+    }, z.core.$strict>>;
+    starts: z.ZodArray<z.ZodObject<{
+        repo: z.ZodString;
+        count: z.ZodInt;
+        median: z.ZodInt;
+        latest: z.ZodArray<z.ZodInt>;
+        alarm: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+type AppsSpendResult = z.output<typeof AppsSpendResult>;
+/** The chat sync's own read-only health check (is every chat reaching main?). */
+declare const AppsSyncStatusParams: z.ZodObject<{
+    app_key: z.ZodString;
+}, z.core.$strict>;
+type AppsSyncStatusParams = z.output<typeof AppsSyncStatusParams>;
+declare const AppsSyncStatusResult: z.ZodObject<{
+    healthy: z.ZodBoolean;
+    summary: z.ZodString;
+    problems: z.ZodArray<z.ZodString>;
+    warnings: z.ZodArray<z.ZodString>;
+    unnamed_accounts: z.ZodArray<z.ZodString>;
+    output: z.ZodString;
+}, z.core.$strict>;
+type AppsSyncStatusResult = z.output<typeof AppsSyncStatusResult>;
+/** Run the chat sync now (main shows the result within a minute). */
+declare const AppsSyncRunParams: z.ZodObject<{
+    app_key: z.ZodString;
+}, z.core.$strict>;
+type AppsSyncRunParams = z.output<typeof AppsSyncRunParams>;
+/** The app's processes still running (an app update installs only when there are none). */
+declare const AppsWindowsProcessesParams: z.ZodObject<{
+    app_key: z.ZodString;
+}, z.core.$strict>;
+type AppsWindowsProcessesParams = z.output<typeof AppsWindowsProcessesParams>;
+declare const AppsWindowsProcessesResult: z.ZodObject<{
+    processes: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+type AppsWindowsProcessesResult = z.output<typeof AppsWindowsProcessesResult>;
+/** A window for another account: a short lowercase name and the account's email. */
+declare const AppsWindowsAddParams: z.ZodObject<{
+    app_key: z.ZodString;
+    window: z.ZodString;
+    email: z.ZodString;
+}, z.core.$strict>;
+type AppsWindowsAddParams = z.output<typeof AppsWindowsAddParams>;
+/** Save each window's signed-in account id → its email, so every list shows names. */
+declare const AppsWindowsSaveNamesParams: z.ZodObject<{
+    app_key: z.ZodString;
+}, z.core.$strict>;
+type AppsWindowsSaveNamesParams = z.output<typeof AppsWindowsSaveNamesParams>;
+
 /**
  * @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.
@@ -3186,6 +3767,7 @@ declare const FIELDS_SINCE: {
     readonly AppsChatsListResult: {
         readonly updating: "1.9";
         readonly live: "1.9";
+        readonly families: "1.10";
     };
 };
 type FieldsSincePath = keyof typeof FIELDS_SINCE;
@@ -3241,7 +3823,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: "8a36e6b958c871853f0a9520e49c92dd30aa05442765c5a1f04c4caa71a35229";
+declare const CONTRACT_SHA256: "de809e319141925b0d86c5acbfe2493f3a85cad7c668c3e20b082e9319f5199b";
 
 /**
  * The local tool catalog (SPEC §10): every tool a platform agent calls on a person's computer, the
@@ -3368,4 +3950,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, 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 };
+export { AbsPath, AccountReset, AccountUsage, AppFeatureStatus, AppInfo, AppKey, AppProfile, AppProfileId, AppProfileLocator, AppSupport, AppUsageReading, AppWindowInfo, AppsAccountsResetsParams, AppsAccountsResetsResult, AppsAccountsUsageParams, AppsAccountsUsageResult, AppsChatsChangedEvent, AppsChatsColdParams, AppsChatsColdResult, AppsChatsListParams, AppsChatsListResult, AppsChatsOpenParams, AppsChatsPlaceParams, AppsChatsPlaceResult, AppsChatsStarParams, AppsChatsStarResult, AppsChatsWatchParams, AppsChatsWatchResult, AppsChatsWatchStateEvent, AppsListParams, AppsListResult, AppsOpenParams, AppsOpenResult, AppsProfilesListParams, AppsProfilesListResult, AppsProfilesRemoveParams, AppsProfilesRemoveResult, AppsProfilesSaveParams, AppsProfilesSaveResult, AppsProjectsCopyParams, AppsProjectsCopyResult, AppsProjectsCreateParams, AppsProjectsCreateResult, AppsProjectsFileManyParams, AppsProjectsFileManyResult, AppsProjectsFileParams, AppsProjectsFileResult, AppsProjectsImportPinsParams, AppsProjectsImportPinsResult, AppsProjectsMoveParams, AppsProjectsMoveResult, AppsProjectsUnfileParams, AppsProjectsUnfileResult, AppsProjectsUpdateParams, AppsProjectsUpdateResult, AppsSpendParams, AppsSpendResult, AppsSyncRunParams, AppsSyncStatusParams, AppsSyncStatusResult, AppsWindowActionResult, AppsWindowsAddParams, AppsWindowsListParams, AppsWindowsListResult, AppsWindowsOpenParams, AppsWindowsProcessesParams, AppsWindowsProcessesResult, AppsWindowsRefreshUsageParams, AppsWindowsReloadParams, AppsWindowsRestartParams, AppsWindowsSaveNamesParams, AudioDevice, AudioDevicesParams, AudioDevicesResult, AudioPlayParams, AudioPlayResult, AudioRecordParams, AudioRecordResult, CONTRACT_SHA256, type CatalogTool, type CellState, ChatFamily, 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, ColdChat, 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, SpendAccount, SpendChat, SpendHelper, SpendIdle, SpendIdleScope, SpendLive, SpendModel, SpendScopes, SpendSplit, SpendStart, 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 };