@ai-matrx/desktop-protocol 0.21.15 → 0.21.17

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { O as OpName } from './models-BFxuhPGw.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-BFxuhPGw.cjs';
+import { O as OpName } from './models-xHAz1vPQ.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-xHAz1vPQ.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. */
@@ -36,10 +36,17 @@ declare const PROTOCOL_MAJOR: 1;
  *   1.21 — apps.windows.shown: what a window's sidebar draws right now (read-only), e.g. a project's group.
  *   1.22 — git for agents (git.status/diff/log/add/commit/push/pull/branch/stash/clone, core `git`);
  *          the web from this computer (web.fetch/scrape/search/fetch_with_browser, the `tools` service).
+ *   1.23 — the signed-in person's own agents and Vault (account.agents.list, account.vault.list,
+ *          account.vault.copy: one field onto this computer's clipboard, never its value on the wire).
+ *   1.24 — the System Settings panes' own facts: sysinfo.hardware (model, chip, serial, the OS's
+ *          name), audio.levels/set_levels (volumes, Mute) and each device's kind, the displays'
+ *          rotation and refresh rate, power's energy settings and power.history, the keyboard's
+ *          repeat, fn key and input sources (input.keyboard_settings/set_keyboard_settings),
+ *          system.open_settings (the OS's own settings page), Spend's last 7 days.
  */
-declare const PROTOCOL_MINOR: 22;
+declare const PROTOCOL_MINOR: 24;
 /** This package's version as the wire spells it ("major.minor"): hello, welcome, relay status. */
-declare const PROTOCOL_VERSION: "1.22";
+declare const PROTOCOL_VERSION: "1.24";
 /** Internal building blocks — deliberately unnamed in $defs (inlined wherever used). */
 declare const u32: z.ZodInt;
 declare const nonNegInt: z.ZodInt;
@@ -190,6 +197,19 @@ declare const SysinfoGetResult: z.ZodObject<{
     }, z.core.$strict>>;
 }, z.core.$strict>;
 type SysinfoGetResult = z.output<typeof SysinfoGetResult>;
+declare const SysinfoHardwareParams: z.ZodObject<{}, z.core.$strict>;
+type SysinfoHardwareParams = z.output<typeof SysinfoHardwareParams>;
+declare const SysinfoHardwareResult: z.ZodObject<{
+    model_name: z.ZodNullable<z.ZodString>;
+    model_detail: z.ZodNullable<z.ZodString>;
+    model_identifier: z.ZodNullable<z.ZodString>;
+    chip: z.ZodNullable<z.ZodString>;
+    serial_number: z.ZodNullable<z.ZodString>;
+    os_name: z.ZodNullable<z.ZodString>;
+    os_version: z.ZodNullable<z.ZodString>;
+    os_build: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+type SysinfoHardwareResult = z.output<typeof SysinfoHardwareResult>;
 
 /** @ai-matrx/desktop-protocol — cap fs. Schema source: lint-enforced rules in scripts/check-schema-source.mjs. */
 
@@ -1064,6 +1084,160 @@ declare const RelayCallEnvelope: z.ZodObject<{
 }, z.core.$strict>;
 type RelayCallEnvelope = z.output<typeof RelayCallEnvelope>;
 
+/**
+ * @ai-matrx/desktop-protocol — cap account (SPEC §6): the signed-in person's own AI Matrx things the
+ * desktop app shows natively — their agents (Agents › Agents, a Shortcuts library) and their Vault
+ * (Passwords). Schema source: lint-enforced rules in scripts/check-schema-source.mjs.
+ *
+ * The desktop core reads them AS the signed-in person (their token, row-level security): it never
+ * holds anything the person could not read on the web. A secret's value never crosses this
+ * contract: `account.vault.copy` puts one field on THIS computer's clipboard and answers only when.
+ */
+
+/** A platform row id (agent, vault item). Plain pattern (see DeviceId for why not z.uuid()). */
+declare const AccountRowId: z.ZodString;
+type AccountRowId = z.output<typeof AccountRowId>;
+/** Whether the person's rows could be read: signed out, or AI Matrx could not be reached. */
+declare const AccountReadState: z.ZodEnum<{
+    ok: "ok";
+    signed_out: "signed_out";
+    unavailable: "unavailable";
+}>;
+type AccountReadState = z.output<typeof AccountReadState>;
+/** One of the person's agents, as the web's agent list names it (agx_get_list). */
+declare const AccountAgent: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodString;
+    category: z.ZodString;
+    agent_type: z.ZodString;
+    is_favorite: z.ZodBoolean;
+    is_owner: z.ZodBoolean;
+    shared_by: z.ZodNullable<z.ZodString>;
+    organization: z.ZodNullable<z.ZodString>;
+    updated_at_ms: z.ZodInt;
+}, z.core.$strict>;
+type AccountAgent = z.output<typeof AccountAgent>;
+declare const AccountAgentsListParams: z.ZodObject<{}, z.core.$strict>;
+type AccountAgentsListParams = z.output<typeof AccountAgentsListParams>;
+declare const AccountAgentsListResult: z.ZodObject<{
+    state: z.ZodEnum<{
+        ok: "ok";
+        signed_out: "signed_out";
+        unavailable: "unavailable";
+    }>;
+    problem: z.ZodNullable<z.ZodString>;
+    agents: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodString;
+        category: z.ZodString;
+        agent_type: z.ZodString;
+        is_favorite: z.ZodBoolean;
+        is_owner: z.ZodBoolean;
+        shared_by: z.ZodNullable<z.ZodString>;
+        organization: z.ZodNullable<z.ZodString>;
+        updated_at_ms: z.ZodInt;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+type AccountAgentsListResult = z.output<typeof AccountAgentsListResult>;
+/** Passwords' kinds: a website sign-in, a passkey, a key or token, anything else. */
+declare const VaultItemKind: z.ZodEnum<{
+    login: "login";
+    passkey: "passkey";
+    key: "key";
+    other: "other";
+}>;
+type VaultItemKind = z.output<typeof VaultItemKind>;
+/** One field of a vault item, masked: never its value. */
+declare const VaultFieldSummary: z.ZodObject<{
+    key: z.ZodString;
+    handling: z.ZodEnum<{
+        visible: "visible";
+        revealable: "revealable";
+        sealed: "sealed";
+    }>;
+    hint: z.ZodString;
+}, z.core.$strict>;
+type VaultFieldSummary = z.output<typeof VaultFieldSummary>;
+declare const VaultItemSummary: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    kind: z.ZodEnum<{
+        login: "login";
+        passkey: "passkey";
+        key: "key";
+        other: "other";
+    }>;
+    definition: z.ZodString;
+    username: z.ZodNullable<z.ZodString>;
+    urls: z.ZodArray<z.ZodString>;
+    notes: z.ZodNullable<z.ZodString>;
+    fields: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        handling: z.ZodEnum<{
+            visible: "visible";
+            revealable: "revealable";
+            sealed: "sealed";
+        }>;
+        hint: z.ZodString;
+    }, z.core.$strict>>;
+    shared: z.ZodBoolean;
+    status: z.ZodString;
+    created_at_ms: z.ZodInt;
+    updated_at_ms: z.ZodInt;
+}, z.core.$strict>;
+type VaultItemSummary = z.output<typeof VaultItemSummary>;
+declare const AccountVaultListParams: z.ZodObject<{}, z.core.$strict>;
+type AccountVaultListParams = z.output<typeof AccountVaultListParams>;
+declare const AccountVaultListResult: z.ZodObject<{
+    state: z.ZodEnum<{
+        ok: "ok";
+        signed_out: "signed_out";
+        unavailable: "unavailable";
+    }>;
+    problem: z.ZodNullable<z.ZodString>;
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        kind: z.ZodEnum<{
+            login: "login";
+            passkey: "passkey";
+            key: "key";
+            other: "other";
+        }>;
+        definition: z.ZodString;
+        username: z.ZodNullable<z.ZodString>;
+        urls: z.ZodArray<z.ZodString>;
+        notes: z.ZodNullable<z.ZodString>;
+        fields: z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            handling: z.ZodEnum<{
+                visible: "visible";
+                revealable: "revealable";
+                sealed: "sealed";
+            }>;
+            hint: z.ZodString;
+        }, z.core.$strict>>;
+        shared: z.ZodBoolean;
+        status: z.ZodString;
+        created_at_ms: z.ZodInt;
+        updated_at_ms: z.ZodInt;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+type AccountVaultListResult = z.output<typeof AccountVaultListResult>;
+/** Copy one field's value to this computer's clipboard (revealable or visible fields only). */
+declare const AccountVaultCopyParams: z.ZodObject<{
+    item_id: z.ZodString;
+    field_key: z.ZodString;
+}, z.core.$strict>;
+type AccountVaultCopyParams = z.output<typeof AccountVaultCopyParams>;
+declare const AccountVaultCopyResult: z.ZodObject<{
+    copied: z.ZodBoolean;
+    clears_at_ms: z.ZodInt;
+}, z.core.$strict>;
+type AccountVaultCopyResult = z.output<typeof AccountVaultCopyResult>;
+
 /**
  * @ai-matrx/desktop-protocol — cap apps (SPEC §6): the desktop apps a person uses (Claude, Codex,
  * Cursor, VS Code, Antigravity, and any app a later adapter adds), their profiles and usage.
@@ -2382,6 +2556,13 @@ declare const SpendStart: z.ZodObject<{
     alarm: z.ZodNullable<z.ZodString>;
 }, z.core.$strict>;
 type SpendStart = z.output<typeof SpendStart>;
+/** (1.24) One day's spend, for Screen Time's bar chart: the local date and its split. */
+declare const SpendDay: z.ZodObject<{
+    date: z.ZodString;
+    main: z.ZodNumber;
+    helpers: z.ZodNumber;
+}, z.core.$strict>;
+type SpendDay = z.output<typeof SpendDay>;
 declare const AppsSpendParams: z.ZodObject<{
     app_key: z.ZodString;
 }, z.core.$strict>;
@@ -2442,6 +2623,11 @@ declare const AppsSpendResult: z.ZodObject<{
             }, z.core.$strict>;
         }, z.core.$strict>;
     }, z.core.$strict>>;
+    days: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        date: z.ZodString;
+        main: z.ZodNumber;
+        helpers: z.ZodNumber;
+    }, z.core.$strict>>>;
     chats: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         title: z.ZodString;
@@ -3425,6 +3611,53 @@ type ToolsServiceProgress = z.output<typeof ToolsServiceProgress>;
  * scripts/check-schema-source.mjs. Added in protocol 1.4.
  */
 
+/** (1.24) An OS settings page Matrx 2 can open: the person's own place to change what Matrx 2 only shows. */
+declare const SystemSettingsPane: z.ZodEnum<{
+    displays: "displays";
+    night_shift: "night_shift";
+    sound: "sound";
+    keyboard: "keyboard";
+    keyboard_shortcuts: "keyboard_shortcuts";
+    text_input: "text_input";
+    dictation: "dictation";
+    energy: "energy";
+    about: "about";
+    storage: "storage";
+    system_report: "system_report";
+}>;
+type SystemSettingsPane = z.output<typeof SystemSettingsPane>;
+declare const SystemOpenSettingsParams: z.ZodObject<{
+    pane: z.ZodEnum<{
+        displays: "displays";
+        night_shift: "night_shift";
+        sound: "sound";
+        keyboard: "keyboard";
+        keyboard_shortcuts: "keyboard_shortcuts";
+        text_input: "text_input";
+        dictation: "dictation";
+        energy: "energy";
+        about: "about";
+        storage: "storage";
+        system_report: "system_report";
+    }>;
+}, z.core.$strict>;
+type SystemOpenSettingsParams = z.output<typeof SystemOpenSettingsParams>;
+declare const SystemOpenSettingsResult: z.ZodObject<{
+    pane: z.ZodEnum<{
+        displays: "displays";
+        night_shift: "night_shift";
+        sound: "sound";
+        keyboard: "keyboard";
+        keyboard_shortcuts: "keyboard_shortcuts";
+        text_input: "text_input";
+        dictation: "dictation";
+        energy: "energy";
+        about: "about";
+        storage: "storage";
+        system_report: "system_report";
+    }>;
+}, z.core.$strict>;
+type SystemOpenSettingsResult = z.output<typeof SystemOpenSettingsResult>;
 declare const SystemOpenUrlParams: z.ZodObject<{
     url: z.ZodString;
 }, z.core.$strict>;
@@ -3468,6 +3701,9 @@ declare const ScreenDisplay: z.ZodObject<{
     height: z.ZodInt;
     scale: z.ZodNumber;
     primary: z.ZodBoolean;
+    rotation: z.ZodOptional<z.ZodInt>;
+    refresh_hz: z.ZodOptional<z.ZodNumber>;
+    builtin: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;
 type ScreenDisplay = z.output<typeof ScreenDisplay>;
 declare const ScreenListResult: z.ZodObject<{
@@ -3480,6 +3716,9 @@ declare const ScreenListResult: z.ZodObject<{
         height: z.ZodInt;
         scale: z.ZodNumber;
         primary: z.ZodBoolean;
+        rotation: z.ZodOptional<z.ZodInt>;
+        refresh_hz: z.ZodOptional<z.ZodNumber>;
+        builtin: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>>;
 }, z.core.$strict>;
 type ScreenListResult = z.output<typeof ScreenListResult>;
@@ -3677,6 +3916,35 @@ declare const InputKey: z.ZodEnum<{
     grave: "grave";
 }>;
 type InputKey = z.output<typeof InputKey>;
+/**
+ * (1.24) The keyboard's own settings, as System Settings › Keyboard shows them. Times in ms; each
+ * field null where this OS does not say.
+ */
+declare const InputKeyboardSettingsParams: z.ZodObject<{}, z.core.$strict>;
+type InputKeyboardSettingsParams = z.output<typeof InputKeyboardSettingsParams>;
+declare const InputKeyboardSettingsResult: z.ZodObject<{
+    repeat_off: z.ZodNullable<z.ZodBoolean>;
+    repeat_interval_ms: z.ZodNullable<z.ZodInt>;
+    repeat_delay_ms: z.ZodNullable<z.ZodInt>;
+    fn_key: z.ZodNullable<z.ZodEnum<{
+        dictation: "dictation";
+        nothing: "nothing";
+        input_source: "input_source";
+        emoji: "emoji";
+    }>>;
+    keyboard_navigation: z.ZodNullable<z.ZodBoolean>;
+    input_sources: z.ZodArray<z.ZodString>;
+    applies_after_login: z.ZodBoolean;
+}, z.core.$strict>;
+type InputKeyboardSettingsResult = z.output<typeof InputKeyboardSettingsResult>;
+/** (1.24) Change the key repeat or keyboard navigation; the result is the settings read back. */
+declare const InputSetKeyboardSettingsParams: z.ZodObject<{
+    repeat_off: z.ZodOptional<z.ZodBoolean>;
+    repeat_interval_ms: z.ZodOptional<z.ZodInt>;
+    repeat_delay_ms: z.ZodOptional<z.ZodInt>;
+    keyboard_navigation: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+type InputSetKeyboardSettingsParams = z.output<typeof InputSetKeyboardSettingsParams>;
 declare const InputPoint: z.ZodObject<{
     x: z.ZodInt;
     y: z.ZodInt;
@@ -3906,8 +4174,44 @@ declare const PowerStatusResult: z.ZodObject<{
     plugged_in: z.ZodNullable<z.ZodBoolean>;
     minutes_left: z.ZodNullable<z.ZodInt>;
     awake_until_ms: z.ZodNullable<z.ZodInt>;
+    energy: z.ZodOptional<z.ZodObject<{
+        display_sleep_minutes: z.ZodNullable<z.ZodInt>;
+        sleep_minutes: z.ZodNullable<z.ZodInt>;
+        disk_sleep_minutes: z.ZodNullable<z.ZodInt>;
+        wake_for_network: z.ZodNullable<z.ZodBoolean>;
+        restart_after_power_failure: z.ZodNullable<z.ZodBoolean>;
+        low_power_mode: z.ZodNullable<z.ZodBoolean>;
+    }, z.core.$strict>>;
 }, z.core.$strict>;
 type PowerStatusResult = z.output<typeof PowerStatusResult>;
+/** (1.24) The OS's own energy settings, as Battery/Energy shows them. Minutes are null when that
+ *  sleep is never; each other field null where the OS does not say. */
+declare const PowerEnergy: z.ZodObject<{
+    display_sleep_minutes: z.ZodNullable<z.ZodInt>;
+    sleep_minutes: z.ZodNullable<z.ZodInt>;
+    disk_sleep_minutes: z.ZodNullable<z.ZodInt>;
+    wake_for_network: z.ZodNullable<z.ZodBoolean>;
+    restart_after_power_failure: z.ZodNullable<z.ZodBoolean>;
+    low_power_mode: z.ZodNullable<z.ZodBoolean>;
+}, z.core.$strict>;
+type PowerEnergy = z.output<typeof PowerEnergy>;
+/** (1.24) The battery's charge over the last ten days, from the OS's own power log. */
+declare const PowerHistoryParams: z.ZodObject<{}, z.core.$strict>;
+type PowerHistoryParams = z.output<typeof PowerHistoryParams>;
+declare const PowerHistoryPoint: z.ZodObject<{
+    at_ms: z.ZodInt;
+    percent: z.ZodNumber;
+    plugged_in: z.ZodBoolean;
+}, z.core.$strict>;
+type PowerHistoryPoint = z.output<typeof PowerHistoryPoint>;
+declare const PowerHistoryResult: z.ZodObject<{
+    points: z.ZodArray<z.ZodObject<{
+        at_ms: z.ZodInt;
+        percent: z.ZodNumber;
+        plugged_in: z.ZodBoolean;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+type PowerHistoryResult = z.output<typeof PowerHistoryResult>;
 declare const PowerPreventSleepParams: z.ZodObject<{
     seconds: z.ZodInt;
     reason: z.ZodDefault<z.ZodString>;
@@ -4532,18 +4836,39 @@ declare const AudioDevice: z.ZodObject<{
     id: z.ZodString;
     name: z.ZodString;
     default: z.ZodBoolean;
+    kind: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 type AudioDevice = z.output<typeof AudioDevice>;
+/** (1.24) The system's own levels, 0–100: what Sound's sliders and Mute show. Null where this OS does not say. */
+declare const AudioLevelsParams: z.ZodObject<{}, z.core.$strict>;
+type AudioLevelsParams = z.output<typeof AudioLevelsParams>;
+declare const AudioLevelsResult: z.ZodObject<{
+    output_volume: z.ZodNullable<z.ZodNumber>;
+    output_muted: z.ZodNullable<z.ZodBoolean>;
+    input_volume: z.ZodNullable<z.ZodNumber>;
+    alert_volume: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strict>;
+type AudioLevelsResult = z.output<typeof AudioLevelsResult>;
+/** (1.24) Change any of the levels; the result is the levels read back after the change. */
+declare const AudioSetLevelsParams: z.ZodObject<{
+    output_volume: z.ZodOptional<z.ZodNumber>;
+    output_muted: z.ZodOptional<z.ZodBoolean>;
+    input_volume: z.ZodOptional<z.ZodNumber>;
+    alert_volume: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+type AudioSetLevelsParams = z.output<typeof AudioSetLevelsParams>;
 declare const AudioDevicesResult: z.ZodObject<{
     inputs: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         name: z.ZodString;
         default: z.ZodBoolean;
+        kind: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>;
     outputs: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         name: z.ZodString;
         default: z.ZodBoolean;
+        kind: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>;
 }, z.core.$strict>;
 type AudioDevicesResult = z.output<typeof AudioDevicesResult>;
@@ -4934,6 +5259,20 @@ declare const FIELDS_SINCE: {
         readonly cpu_percent: "1.18";
         readonly memory_bytes: "1.18";
     };
+    readonly AudioDevice: {
+        readonly kind: "1.24";
+    };
+    readonly ScreenDisplay: {
+        readonly rotation: "1.24";
+        readonly refresh_hz: "1.24";
+        readonly builtin: "1.24";
+    };
+    readonly PowerStatusResult: {
+        readonly energy: "1.24";
+    };
+    readonly AppsSpendResult: {
+        readonly days: "1.24";
+    };
 };
 type FieldsSincePath = keyof typeof FIELDS_SINCE;
 /**
@@ -4988,7 +5327,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: "3649fe15a3400c32aa7a60712c93ebbefa639adc6218db849a13fa952e24bb04";
+declare const CONTRACT_SHA256: "89943d5297e89b0ae7433b24c3076be1f65ca39a5edc3f338620597b24009226";
 
 /**
  * The local tool catalog (SPEC §10): every tool a platform agent calls on a person's computer, the
@@ -5115,4 +5454,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, 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, AppsProjectsToWindowParams, AppsProjectsToWindowResult, AppsProjectsUnfileParams, AppsProjectsUnfileResult, AppsProjectsUpdateParams, AppsProjectsUpdateResult, AppsSpendParams, AppsSpendResult, AppsSyncRunParams, AppsSyncStatusParams, AppsSyncStatusResult, AppsWindowActionResult, AppsWindowsAddParams, AppsWindowsListParams, AppsWindowsListResult, AppsWindowsOpenParams, AppsWindowsProcessesParams, AppsWindowsProcessesResult, AppsWindowsRefreshUsageParams, AppsWindowsReloadParams, AppsWindowsRestartParams, AppsWindowsSaveNamesParams, AppsWindowsShownParams, AppsWindowsShownResult, AudioDevice, AudioDevicesParams, AudioDevicesResult, AudioPlayParams, AudioPlayResult, AudioRecordParams, AudioRecordResult, CONTRACT_SHA256, type CatalogTool, type CellState, ChatAppProject, 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, DiagErrorEntry, DiagErrorKind, DiagErrorStatus, DiagErrorsChangedEvent, DiagErrorsListParams, DiagErrorsListResult, DiagErrorsReportParams, DiagErrorsReportResult, DiagProcess, 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, GIT_MAX_OUTPUT_CHARS, GitAddParams, GitBranchParams, GitBranchResult, GitCloneParams, GitCommitParams, GitCommitResult, GitDiffParams, GitDiffResult, GitLogCommit, GitLogParams, GitLogResult, GitOutputResult, GitPullParams, GitPushParams, GitStashParams, GitStatusFile, GitStatusParams, GitStatusResult, 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, ProjectMoveChat, ProjectMoveGroup, ProjectMoveSkip, 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, ResourcesActivityParams, ResourcesActivityResult, ResourcesDisk, ResourcesIncident, ResourcesIncidentsParams, ResourcesIncidentsResult, ResourcesJob, ResourcesJobKind, ResourcesPressure, ResourcesProcess, ResourcesSample, ResourcesSnapshotParams, ResourcesSnapshotResult, ResourcesStopJobParams, ResourcesStopJobResult, ResourcesStrain, ResourcesVerdict, 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, ShownSection, Signal, SpendAccount, SpendChat, SpendHelper, SpendIdle, SpendIdleScope, SpendLive, SpendModel, SpendScopes, SpendSplit, SpendStart, StackErrorsParams, StackErrorsResult, StackEvent, StackLogsParams, StackLogsResult, StackRunResult, StackServer, StackServerActionParams, StackServerActionResult, StackServerName, StackStartParams, StackStateParams, StackStateResult, StackStopParams, StackTone, 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, ToolsServiceProgress, ToolsWebSearchParams, VERSIONED_RESULT_OPS, WEB_MAX_TEXT_CHARS, WebBrowserFetchParams, WebBrowserFetchResult, WebFetchParams, WebFetchResult, WebHeader, WebScrapePage, WebScrapeParams, WebScrapeResult, WebSearchHit, WebSearchParams, WebSearchQueryResult, WebSearchResult, WindowFocusParams, WindowFocusResult, WindowInfo, WindowListParams, WindowListResult, WindowMinimizeParams, WindowMinimizeResult, WindowMoveParams, WindowMoveResult, announcedVersion, buildToolStatus, builtOps, compareVersions, epochMs, forPeer, knows, negotiate, nonNegInt, renderToolStatusMarkdown, statusForPeer, u32, versionSubprotocol };
+export { AbsPath, AccountAgent, AccountAgentsListParams, AccountAgentsListResult, AccountReadState, AccountReset, AccountRowId, AccountUsage, AccountVaultCopyParams, AccountVaultCopyResult, AccountVaultListParams, AccountVaultListResult, 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, AppsProjectsToWindowParams, AppsProjectsToWindowResult, AppsProjectsUnfileParams, AppsProjectsUnfileResult, AppsProjectsUpdateParams, AppsProjectsUpdateResult, AppsSpendParams, AppsSpendResult, AppsSyncRunParams, AppsSyncStatusParams, AppsSyncStatusResult, AppsWindowActionResult, AppsWindowsAddParams, AppsWindowsListParams, AppsWindowsListResult, AppsWindowsOpenParams, AppsWindowsProcessesParams, AppsWindowsProcessesResult, AppsWindowsRefreshUsageParams, AppsWindowsReloadParams, AppsWindowsRestartParams, AppsWindowsSaveNamesParams, AppsWindowsShownParams, AppsWindowsShownResult, AudioDevice, AudioDevicesParams, AudioDevicesResult, AudioLevelsParams, AudioLevelsResult, AudioPlayParams, AudioPlayResult, AudioRecordParams, AudioRecordResult, AudioSetLevelsParams, CONTRACT_SHA256, type CatalogTool, type CellState, ChatAppProject, 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, DiagErrorEntry, DiagErrorKind, DiagErrorStatus, DiagErrorsChangedEvent, DiagErrorsListParams, DiagErrorsListResult, DiagErrorsReportParams, DiagErrorsReportResult, DiagProcess, 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, GIT_MAX_OUTPUT_CHARS, GitAddParams, GitBranchParams, GitBranchResult, GitCloneParams, GitCommitParams, GitCommitResult, GitDiffParams, GitDiffResult, GitLogCommit, GitLogParams, GitLogResult, GitOutputResult, GitPullParams, GitPushParams, GitStashParams, GitStatusFile, GitStatusParams, GitStatusResult, InputHotkeyParams, InputHotkeyResult, InputKey, InputKeyboardSettingsParams, InputKeyboardSettingsResult, InputMouseClickParams, InputMouseClickResult, InputMouseMoveParams, InputMouseMoveResult, InputPoint, InputSetKeyboardSettingsParams, InputTypeTextParams, InputTypeTextResult, LEGACY_ACTIONS, LEGACY_DISPATCHERS, type LegacyDisposition, NULL_SINCE, OpName, OsPermissionName, PROTOCOL_MAJOR, PROTOCOL_MINOR, PROTOCOL_VERSION, PowerEnergy, PowerHistoryParams, PowerHistoryPoint, PowerHistoryResult, PowerPreventSleepParams, PowerPreventSleepResult, PowerStatusParams, PowerStatusResult, ProcInfo, ProcKillParams, ProcKillResult, ProcListParams, ProcListResult, ProcPort, ProcPortsParams, ProcPortsResult, ProcSort, ProjectMoveChat, ProjectMoveGroup, ProjectMoveSkip, 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, ResourcesActivityParams, ResourcesActivityResult, ResourcesDisk, ResourcesIncident, ResourcesIncidentsParams, ResourcesIncidentsResult, ResourcesJob, ResourcesJobKind, ResourcesPressure, ResourcesProcess, ResourcesSample, ResourcesSnapshotParams, ResourcesSnapshotResult, ResourcesStopJobParams, ResourcesStopJobResult, ResourcesStrain, ResourcesVerdict, 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, ShownSection, Signal, SpendAccount, SpendChat, SpendDay, SpendHelper, SpendIdle, SpendIdleScope, SpendLive, SpendModel, SpendScopes, SpendSplit, SpendStart, StackErrorsParams, StackErrorsResult, StackEvent, StackLogsParams, StackLogsResult, StackRunResult, StackServer, StackServerActionParams, StackServerActionResult, StackServerName, StackStartParams, StackStateParams, StackStateResult, StackStopParams, StackTone, type StatusCell, type StatusEvidence, type StatusRow, SysinfoGetParams, SysinfoGetResult, SysinfoHardwareParams, SysinfoHardwareResult, SystemNotifyParams, SystemNotifyResult, SystemOpenPathParams, SystemOpenPathResult, SystemOpenSettingsParams, SystemOpenSettingsResult, SystemOpenUrlParams, SystemOpenUrlResult, SystemSettingsPane, 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, ToolsServiceProgress, ToolsWebSearchParams, VERSIONED_RESULT_OPS, VaultFieldSummary, VaultItemKind, VaultItemSummary, WEB_MAX_TEXT_CHARS, WebBrowserFetchParams, WebBrowserFetchResult, WebFetchParams, WebFetchResult, WebHeader, WebScrapePage, WebScrapeParams, WebScrapeResult, WebSearchHit, WebSearchParams, WebSearchQueryResult, WebSearchResult, WindowFocusParams, WindowFocusResult, WindowInfo, WindowListParams, WindowListResult, WindowMinimizeParams, WindowMinimizeResult, WindowMoveParams, WindowMoveResult, announcedVersion, buildToolStatus, builtOps, compareVersions, epochMs, forPeer, knows, negotiate, nonNegInt, renderToolStatusMarkdown, statusForPeer, u32, versionSubprotocol };