@ai-matrx/desktop-protocol 0.17.5 → 0.17.6

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-B9tM6Hnx.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-B9tM6Hnx.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: 10;
 /** 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.10";
 /** 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,237 @@ 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>;
+
 /**
  * @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 +3429,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 +3485,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: "f1891d7e5c64c11112bb7baf5db06bd293daccff85a7f5adcdf760b2bbb92bda";
 
 /**
  * The local tool catalog (SPEC §10): every tool a platform agent calls on a person's computer, the
@@ -3368,4 +3612,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, AppsChatsListParams, AppsChatsListResult, 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, AppsWindowActionResult, AppsWindowsListParams, AppsWindowsListResult, AppsWindowsOpenParams, AppsWindowsRefreshUsageParams, AppsWindowsReloadParams, AppsWindowsRestartParams, 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, 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 };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { O as OpName } from './models-Bb87iuvw.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-Bb87iuvw.js';
+import { O as OpName } from './models-B9tM6Hnx.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-B9tM6Hnx.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. */
@@ -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: 10;
 /** 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.10";
 /** 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,237 @@ 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>;
+
 /**
  * @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 +3429,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 +3485,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: "f1891d7e5c64c11112bb7baf5db06bd293daccff85a7f5adcdf760b2bbb92bda";
 
 /**
  * The local tool catalog (SPEC §10): every tool a platform agent calls on a person's computer, the
@@ -3368,4 +3612,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, AppsChatsListParams, AppsChatsListResult, 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, AppsWindowActionResult, AppsWindowsListParams, AppsWindowsListResult, AppsWindowsOpenParams, AppsWindowsRefreshUsageParams, AppsWindowsReloadParams, AppsWindowsRestartParams, 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, 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 };