@ai-matrx/desktop-protocol 0.13.0 → 0.15.0

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { O as OpName } from './models-CxAHZMAM.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-CxAHZMAM.js';
+import { O as OpName } from './models-iOvmEOHd.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-iOvmEOHd.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. */
@@ -13,10 +13,13 @@ declare const PROTOCOL_MAJOR: 1;
  *         device status since_ms is null for a device that never connected.
  *   1.2 — the `models` capability (local transcription) and its error reasons (REASONS_SINCE);
  *         the `apps` capability (desktop apps, their profiles and usage).
+ *   1.3 — the `proc` capability (processes, listening ports, stopping one) and `clipboard`.
+ *   1.4 — computer control: `system`, `screen`, `window`, `input`, `power`, `resources`; polled
+ *         folder watches (fs.watch.start/events/stop) and background jobs (exec.job.*).
  */
-declare const PROTOCOL_MINOR: 2;
+declare const PROTOCOL_MINOR: 4;
 /** This package's version as the wire spells it ("major.minor"): hello, welcome, relay status. */
-declare const PROTOCOL_VERSION: "1.2";
+declare const PROTOCOL_VERSION: "1.4";
 /** Internal building blocks — deliberately unnamed in $defs (inlined wherever used). */
 declare const u32: z.ZodInt;
 declare const nonNegInt: z.ZodInt;
@@ -1642,6 +1645,776 @@ declare const ToolResultsFile: z.ZodObject<{
 }, z.core.$strict>;
 type ToolResultsFile = z.output<typeof ToolResultsFile>;
 
+/**
+ * @ai-matrx/desktop-protocol — cap proc (SPEC §6): the processes running on the person's computer,
+ * the ports they listen on, and stopping one. Schema source: lint-enforced rules in
+ * scripts/check-schema-source.mjs. Added in protocol 1.3.
+ */
+
+declare const ProcSort: z.ZodEnum<{
+    name: "name";
+    cpu: "cpu";
+    memory: "memory";
+    pid: "pid";
+}>;
+declare const ProcListParams: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    sort: z.ZodDefault<z.ZodEnum<{
+        name: "name";
+        cpu: "cpu";
+        memory: "memory";
+        pid: "pid";
+    }>>;
+    limit: z.ZodDefault<z.ZodInt>;
+}, z.core.$strict>;
+type ProcListParams = z.output<typeof ProcListParams>;
+declare const ProcListResult: z.ZodObject<{
+    processes: z.ZodArray<z.ZodObject<{
+        pid: z.ZodInt;
+        ppid: z.ZodNullable<z.ZodInt>;
+        name: z.ZodString;
+        command: z.ZodString;
+        cpu_percent: z.ZodNullable<z.ZodNumber>;
+        memory_bytes: z.ZodNullable<z.ZodInt>;
+        user: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+    total: z.ZodInt;
+    truncated: z.ZodBoolean;
+}, z.core.$strict>;
+type ProcListResult = z.output<typeof ProcListResult>;
+declare const ProcInfo: z.ZodObject<{
+    pid: z.ZodInt;
+    ppid: z.ZodNullable<z.ZodInt>;
+    name: z.ZodString;
+    command: z.ZodString;
+    cpu_percent: z.ZodNullable<z.ZodNumber>;
+    memory_bytes: z.ZodNullable<z.ZodInt>;
+    user: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+type ProcInfo = z.output<typeof ProcInfo>;
+declare const ProcPortsParams: z.ZodObject<{
+    port: z.ZodOptional<z.ZodInt>;
+}, z.core.$strict>;
+type ProcPortsParams = z.output<typeof ProcPortsParams>;
+declare const ProcPortsResult: z.ZodObject<{
+    ports: z.ZodArray<z.ZodObject<{
+        port: z.ZodInt;
+        protocol: z.ZodEnum<{
+            tcp: "tcp";
+            udp: "udp";
+        }>;
+        address: z.ZodString;
+        pid: z.ZodNullable<z.ZodInt>;
+        process: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+type ProcPortsResult = z.output<typeof ProcPortsResult>;
+declare const ProcPort: z.ZodObject<{
+    port: z.ZodInt;
+    protocol: z.ZodEnum<{
+        tcp: "tcp";
+        udp: "udp";
+    }>;
+    address: z.ZodString;
+    pid: z.ZodNullable<z.ZodInt>;
+    process: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+type ProcPort = z.output<typeof ProcPort>;
+declare const ProcKillParams: z.ZodObject<{
+    pid: z.ZodInt;
+    force: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>;
+type ProcKillParams = z.output<typeof ProcKillParams>;
+declare const ProcKillResult: z.ZodObject<{
+    pid: z.ZodInt;
+    signal: z.ZodEnum<{
+        SIGTERM: "SIGTERM";
+        SIGKILL: "SIGKILL";
+    }>;
+    exited: z.ZodBoolean;
+}, z.core.$strict>;
+type ProcKillResult = z.output<typeof ProcKillResult>;
+
+/**
+ * @ai-matrx/desktop-protocol — cap clipboard (SPEC §6): the system clipboard's text. Schema source:
+ * lint-enforced rules in scripts/check-schema-source.mjs. Added in protocol 1.3.
+ */
+
+declare const ClipboardReadParams: z.ZodObject<{}, z.core.$strict>;
+declare const ClipboardReadResult: z.ZodObject<{
+    text: z.ZodString;
+    truncated: z.ZodBoolean;
+}, z.core.$strict>;
+type ClipboardReadResult = z.output<typeof ClipboardReadResult>;
+declare const ClipboardWriteParams: z.ZodObject<{
+    text: z.ZodString;
+}, z.core.$strict>;
+type ClipboardWriteParams = z.output<typeof ClipboardWriteParams>;
+declare const ClipboardWriteResult: z.ZodObject<{
+    bytes: z.ZodInt;
+}, z.core.$strict>;
+type ClipboardWriteResult = z.output<typeof ClipboardWriteResult>;
+
+/**
+ * @ai-matrx/desktop-protocol — cap system (SPEC §6): open a link or a file the way the person's
+ * computer would, and show a notification. Schema source: lint-enforced rules in
+ * scripts/check-schema-source.mjs. Added in protocol 1.4.
+ */
+
+declare const SystemOpenUrlParams: z.ZodObject<{
+    url: z.ZodString;
+}, z.core.$strict>;
+type SystemOpenUrlParams = z.output<typeof SystemOpenUrlParams>;
+declare const SystemOpenUrlResult: z.ZodObject<{
+    url: z.ZodString;
+}, z.core.$strict>;
+type SystemOpenUrlResult = z.output<typeof SystemOpenUrlResult>;
+declare const SystemOpenPathParams: z.ZodObject<{
+    path: z.ZodString;
+    reveal: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>;
+type SystemOpenPathParams = z.output<typeof SystemOpenPathParams>;
+declare const SystemOpenPathResult: z.ZodObject<{
+    path: z.ZodString;
+    revealed: z.ZodBoolean;
+}, z.core.$strict>;
+type SystemOpenPathResult = z.output<typeof SystemOpenPathResult>;
+declare const SystemNotifyParams: z.ZodObject<{
+    title: z.ZodString;
+    body: z.ZodDefault<z.ZodString>;
+}, z.core.$strict>;
+type SystemNotifyParams = z.output<typeof SystemNotifyParams>;
+declare const SystemNotifyResult: z.ZodObject<{
+    shown: z.ZodBoolean;
+}, z.core.$strict>;
+type SystemNotifyResult = z.output<typeof SystemNotifyResult>;
+
+/**
+ * @ai-matrx/desktop-protocol — cap screen (SPEC §6): the person's displays and a picture of one.
+ * Schema source: lint-enforced rules in scripts/check-schema-source.mjs. Added in protocol 1.4.
+ */
+
+declare const ScreenListParams: z.ZodObject<{}, z.core.$strict>;
+declare const ScreenDisplay: z.ZodObject<{
+    id: z.ZodInt;
+    name: z.ZodString;
+    x: z.ZodInt;
+    y: z.ZodInt;
+    width: z.ZodInt;
+    height: z.ZodInt;
+    scale: z.ZodNumber;
+    primary: z.ZodBoolean;
+}, z.core.$strict>;
+type ScreenDisplay = z.output<typeof ScreenDisplay>;
+declare const ScreenListResult: z.ZodObject<{
+    displays: z.ZodArray<z.ZodObject<{
+        id: z.ZodInt;
+        name: z.ZodString;
+        x: z.ZodInt;
+        y: z.ZodInt;
+        width: z.ZodInt;
+        height: z.ZodInt;
+        scale: z.ZodNumber;
+        primary: z.ZodBoolean;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+type ScreenListResult = z.output<typeof ScreenListResult>;
+declare const ScreenCaptureParams: z.ZodObject<{
+    display_id: z.ZodOptional<z.ZodInt>;
+    format: z.ZodDefault<z.ZodEnum<{
+        jpeg: "jpeg";
+        png: "png";
+    }>>;
+    max_width: z.ZodDefault<z.ZodInt>;
+}, z.core.$strict>;
+type ScreenCaptureParams = z.output<typeof ScreenCaptureParams>;
+declare const ScreenCaptureResult: z.ZodObject<{
+    display_id: z.ZodInt;
+    mime_type: z.ZodEnum<{
+        "image/jpeg": "image/jpeg";
+        "image/png": "image/png";
+    }>;
+    width: z.ZodInt;
+    height: z.ZodInt;
+    source_width: z.ZodInt;
+    source_height: z.ZodInt;
+    data_base64: z.ZodString;
+}, z.core.$strict>;
+type ScreenCaptureResult = z.output<typeof ScreenCaptureResult>;
+
+/**
+ * @ai-matrx/desktop-protocol — cap window (SPEC §6): the windows on the person's screen; focus,
+ * move or resize, and minimize one. Schema source: lint-enforced rules in
+ * scripts/check-schema-source.mjs. Added in protocol 1.4.
+ */
+
+declare const WindowInfo: z.ZodObject<{
+    id: z.ZodInt;
+    title: z.ZodString;
+    x: z.ZodInt;
+    y: z.ZodInt;
+    width: z.ZodInt;
+    height: z.ZodInt;
+}, z.core.$strict>;
+type WindowInfo = z.output<typeof WindowInfo>;
+declare const WindowListParams: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodInt>;
+}, z.core.$strict>;
+type WindowListParams = z.output<typeof WindowListParams>;
+declare const WindowListResult: z.ZodObject<{
+    windows: z.ZodArray<z.ZodObject<{
+        id: z.ZodInt;
+        title: z.ZodString;
+        x: z.ZodInt;
+        y: z.ZodInt;
+        width: z.ZodInt;
+        height: z.ZodInt;
+    }, z.core.$strict>>;
+    total: z.ZodInt;
+    truncated: z.ZodBoolean;
+}, z.core.$strict>;
+type WindowListResult = z.output<typeof WindowListResult>;
+declare const WindowFocusParams: z.ZodObject<{
+    id: z.ZodInt;
+}, z.core.$strict>;
+type WindowFocusParams = z.output<typeof WindowFocusParams>;
+declare const WindowFocusResult: z.ZodObject<{
+    window: z.ZodObject<{
+        id: z.ZodInt;
+        title: z.ZodString;
+        x: z.ZodInt;
+        y: z.ZodInt;
+        width: z.ZodInt;
+        height: z.ZodInt;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+type WindowFocusResult = z.output<typeof WindowFocusResult>;
+declare const WindowMoveParams: z.ZodObject<{
+    id: z.ZodInt;
+    x: z.ZodOptional<z.ZodInt>;
+    y: z.ZodOptional<z.ZodInt>;
+    width: z.ZodOptional<z.ZodInt>;
+    height: z.ZodOptional<z.ZodInt>;
+}, z.core.$strict>;
+type WindowMoveParams = z.output<typeof WindowMoveParams>;
+declare const WindowMoveResult: z.ZodObject<{
+    window: z.ZodObject<{
+        id: z.ZodInt;
+        title: z.ZodString;
+        x: z.ZodInt;
+        y: z.ZodInt;
+        width: z.ZodInt;
+        height: z.ZodInt;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+type WindowMoveResult = z.output<typeof WindowMoveResult>;
+declare const WindowMinimizeParams: z.ZodObject<{
+    id: z.ZodInt;
+}, z.core.$strict>;
+type WindowMinimizeParams = z.output<typeof WindowMinimizeParams>;
+declare const WindowMinimizeResult: z.ZodObject<{
+    id: z.ZodInt;
+}, z.core.$strict>;
+type WindowMinimizeResult = z.output<typeof WindowMinimizeResult>;
+
+/**
+ * @ai-matrx/desktop-protocol — cap input (SPEC §6): the keyboard and mouse, as if the person used
+ * them. Schema source: lint-enforced rules in scripts/check-schema-source.mjs. Added in protocol 1.4.
+ */
+
+/** Key names for input.hotkey. `cmd` is Command on a Mac and Ctrl elsewhere; `meta` is the Windows/Super key. */
+declare const InputKey: z.ZodEnum<{
+    0: "0";
+    1: "1";
+    2: "2";
+    3: "3";
+    4: "4";
+    5: "5";
+    6: "6";
+    7: "7";
+    8: "8";
+    9: "9";
+    meta: "meta";
+    end: "end";
+    n: "n";
+    home: "home";
+    x: "x";
+    y: "y";
+    cmd: "cmd";
+    ctrl: "ctrl";
+    alt: "alt";
+    shift: "shift";
+    a: "a";
+    b: "b";
+    c: "c";
+    d: "d";
+    e: "e";
+    f: "f";
+    g: "g";
+    h: "h";
+    i: "i";
+    j: "j";
+    k: "k";
+    l: "l";
+    m: "m";
+    o: "o";
+    p: "p";
+    q: "q";
+    r: "r";
+    s: "s";
+    t: "t";
+    u: "u";
+    v: "v";
+    w: "w";
+    z: "z";
+    f1: "f1";
+    f2: "f2";
+    f3: "f3";
+    f4: "f4";
+    f5: "f5";
+    f6: "f6";
+    f7: "f7";
+    f8: "f8";
+    f9: "f9";
+    f10: "f10";
+    f11: "f11";
+    f12: "f12";
+    enter: "enter";
+    tab: "tab";
+    escape: "escape";
+    space: "space";
+    backspace: "backspace";
+    delete: "delete";
+    up: "up";
+    down: "down";
+    left: "left";
+    right: "right";
+    pageup: "pageup";
+    pagedown: "pagedown";
+    minus: "minus";
+    equal: "equal";
+    comma: "comma";
+    period: "period";
+    slash: "slash";
+    semicolon: "semicolon";
+    quote: "quote";
+    bracketleft: "bracketleft";
+    bracketright: "bracketright";
+    backslash: "backslash";
+    grave: "grave";
+}>;
+type InputKey = z.output<typeof InputKey>;
+declare const InputPoint: z.ZodObject<{
+    x: z.ZodInt;
+    y: z.ZodInt;
+}, z.core.$strict>;
+type InputPoint = z.output<typeof InputPoint>;
+declare const InputTypeTextParams: z.ZodObject<{
+    text: z.ZodString;
+}, z.core.$strict>;
+type InputTypeTextParams = z.output<typeof InputTypeTextParams>;
+declare const InputTypeTextResult: z.ZodObject<{
+    characters: z.ZodInt;
+}, z.core.$strict>;
+type InputTypeTextResult = z.output<typeof InputTypeTextResult>;
+declare const InputHotkeyParams: z.ZodObject<{
+    keys: z.ZodArray<z.ZodEnum<{
+        0: "0";
+        1: "1";
+        2: "2";
+        3: "3";
+        4: "4";
+        5: "5";
+        6: "6";
+        7: "7";
+        8: "8";
+        9: "9";
+        meta: "meta";
+        end: "end";
+        n: "n";
+        home: "home";
+        x: "x";
+        y: "y";
+        cmd: "cmd";
+        ctrl: "ctrl";
+        alt: "alt";
+        shift: "shift";
+        a: "a";
+        b: "b";
+        c: "c";
+        d: "d";
+        e: "e";
+        f: "f";
+        g: "g";
+        h: "h";
+        i: "i";
+        j: "j";
+        k: "k";
+        l: "l";
+        m: "m";
+        o: "o";
+        p: "p";
+        q: "q";
+        r: "r";
+        s: "s";
+        t: "t";
+        u: "u";
+        v: "v";
+        w: "w";
+        z: "z";
+        f1: "f1";
+        f2: "f2";
+        f3: "f3";
+        f4: "f4";
+        f5: "f5";
+        f6: "f6";
+        f7: "f7";
+        f8: "f8";
+        f9: "f9";
+        f10: "f10";
+        f11: "f11";
+        f12: "f12";
+        enter: "enter";
+        tab: "tab";
+        escape: "escape";
+        space: "space";
+        backspace: "backspace";
+        delete: "delete";
+        up: "up";
+        down: "down";
+        left: "left";
+        right: "right";
+        pageup: "pageup";
+        pagedown: "pagedown";
+        minus: "minus";
+        equal: "equal";
+        comma: "comma";
+        period: "period";
+        slash: "slash";
+        semicolon: "semicolon";
+        quote: "quote";
+        bracketleft: "bracketleft";
+        bracketright: "bracketright";
+        backslash: "backslash";
+        grave: "grave";
+    }>>;
+}, z.core.$strict>;
+type InputHotkeyParams = z.output<typeof InputHotkeyParams>;
+declare const InputHotkeyResult: z.ZodObject<{
+    keys: z.ZodArray<z.ZodEnum<{
+        0: "0";
+        1: "1";
+        2: "2";
+        3: "3";
+        4: "4";
+        5: "5";
+        6: "6";
+        7: "7";
+        8: "8";
+        9: "9";
+        meta: "meta";
+        end: "end";
+        n: "n";
+        home: "home";
+        x: "x";
+        y: "y";
+        cmd: "cmd";
+        ctrl: "ctrl";
+        alt: "alt";
+        shift: "shift";
+        a: "a";
+        b: "b";
+        c: "c";
+        d: "d";
+        e: "e";
+        f: "f";
+        g: "g";
+        h: "h";
+        i: "i";
+        j: "j";
+        k: "k";
+        l: "l";
+        m: "m";
+        o: "o";
+        p: "p";
+        q: "q";
+        r: "r";
+        s: "s";
+        t: "t";
+        u: "u";
+        v: "v";
+        w: "w";
+        z: "z";
+        f1: "f1";
+        f2: "f2";
+        f3: "f3";
+        f4: "f4";
+        f5: "f5";
+        f6: "f6";
+        f7: "f7";
+        f8: "f8";
+        f9: "f9";
+        f10: "f10";
+        f11: "f11";
+        f12: "f12";
+        enter: "enter";
+        tab: "tab";
+        escape: "escape";
+        space: "space";
+        backspace: "backspace";
+        delete: "delete";
+        up: "up";
+        down: "down";
+        left: "left";
+        right: "right";
+        pageup: "pageup";
+        pagedown: "pagedown";
+        minus: "minus";
+        equal: "equal";
+        comma: "comma";
+        period: "period";
+        slash: "slash";
+        semicolon: "semicolon";
+        quote: "quote";
+        bracketleft: "bracketleft";
+        bracketright: "bracketright";
+        backslash: "backslash";
+        grave: "grave";
+    }>>;
+}, z.core.$strict>;
+type InputHotkeyResult = z.output<typeof InputHotkeyResult>;
+declare const InputMouseMoveParams: z.ZodObject<{
+    x: z.ZodInt;
+    y: z.ZodInt;
+}, z.core.$strict>;
+type InputMouseMoveParams = z.output<typeof InputMouseMoveParams>;
+declare const InputMouseMoveResult: z.ZodObject<{
+    position: z.ZodObject<{
+        x: z.ZodInt;
+        y: z.ZodInt;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+type InputMouseMoveResult = z.output<typeof InputMouseMoveResult>;
+declare const InputMouseClickParams: z.ZodObject<{
+    x: z.ZodOptional<z.ZodInt>;
+    y: z.ZodOptional<z.ZodInt>;
+    button: z.ZodDefault<z.ZodEnum<{
+        left: "left";
+        right: "right";
+        middle: "middle";
+    }>>;
+    double: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>;
+type InputMouseClickParams = z.output<typeof InputMouseClickParams>;
+declare const InputMouseClickResult: z.ZodObject<{
+    position: z.ZodObject<{
+        x: z.ZodInt;
+        y: z.ZodInt;
+    }, z.core.$strict>;
+    button: z.ZodEnum<{
+        left: "left";
+        right: "right";
+        middle: "middle";
+    }>;
+    double: z.ZodBoolean;
+}, z.core.$strict>;
+type InputMouseClickResult = z.output<typeof InputMouseClickResult>;
+
+/**
+ * @ai-matrx/desktop-protocol — cap power (SPEC §6): the battery and keeping the computer awake.
+ * Schema source: lint-enforced rules in scripts/check-schema-source.mjs. Added in protocol 1.4.
+ */
+
+declare const PowerStatusParams: z.ZodObject<{}, z.core.$strict>;
+declare const PowerStatusResult: z.ZodObject<{
+    has_battery: z.ZodBoolean;
+    percent: z.ZodNullable<z.ZodNumber>;
+    charging: z.ZodNullable<z.ZodBoolean>;
+    plugged_in: z.ZodNullable<z.ZodBoolean>;
+    minutes_left: z.ZodNullable<z.ZodInt>;
+    awake_until_ms: z.ZodNullable<z.ZodInt>;
+}, z.core.$strict>;
+type PowerStatusResult = z.output<typeof PowerStatusResult>;
+declare const PowerPreventSleepParams: z.ZodObject<{
+    seconds: z.ZodInt;
+    reason: z.ZodDefault<z.ZodString>;
+}, z.core.$strict>;
+type PowerPreventSleepParams = z.output<typeof PowerPreventSleepParams>;
+declare const PowerPreventSleepResult: z.ZodObject<{
+    awake_until_ms: z.ZodNullable<z.ZodInt>;
+}, z.core.$strict>;
+type PowerPreventSleepResult = z.output<typeof PowerPreventSleepResult>;
+
+/**
+ * @ai-matrx/desktop-protocol — cap resources (SPEC §6): how busy the computer is — CPU, memory and
+ * disks. The busiest processes are proc.list. Schema source: lint-enforced rules in
+ * scripts/check-schema-source.mjs. Added in protocol 1.4.
+ */
+
+declare const ResourcesSnapshotParams: z.ZodObject<{}, z.core.$strict>;
+declare const ResourcesDisk: z.ZodObject<{
+    mount: z.ZodString;
+    fs: z.ZodString;
+    size_bytes: z.ZodInt;
+    used_bytes: z.ZodInt;
+    available_bytes: z.ZodInt;
+}, z.core.$strict>;
+type ResourcesDisk = z.output<typeof ResourcesDisk>;
+declare const ResourcesSnapshotResult: z.ZodObject<{
+    cpu: z.ZodObject<{
+        percent: z.ZodNumber;
+        cores: z.ZodInt;
+        load: z.ZodNullable<z.ZodArray<z.ZodNumber>>;
+    }, z.core.$strict>;
+    memory: z.ZodObject<{
+        total_bytes: z.ZodInt;
+        used_bytes: z.ZodInt;
+        available_bytes: z.ZodInt;
+    }, z.core.$strict>;
+    swap: z.ZodObject<{
+        total_bytes: z.ZodInt;
+        used_bytes: z.ZodInt;
+    }, z.core.$strict>;
+    disks: z.ZodArray<z.ZodObject<{
+        mount: z.ZodString;
+        fs: z.ZodString;
+        size_bytes: z.ZodInt;
+        used_bytes: z.ZodInt;
+        available_bytes: z.ZodInt;
+    }, z.core.$strict>>;
+    uptime_seconds: z.ZodInt;
+}, z.core.$strict>;
+type ResourcesSnapshotResult = z.output<typeof ResourcesSnapshotResult>;
+
+/**
+ * @ai-matrx/desktop-protocol — cap fs, polled watches (SPEC §6): watch a folder and read what
+ * changed since the last read, for callers that ask rather than hold a stream (an agent's tool
+ * call through the relay's /call). The streamed `fs.watch` resource stays for live clients. Schema
+ * source: lint-enforced rules in scripts/check-schema-source.mjs. Added in protocol 1.4.
+ */
+
+declare const FsWatchId: z.ZodString;
+type FsWatchId = z.output<typeof FsWatchId>;
+declare const FsWatchStartParams: z.ZodObject<{
+    path: z.ZodString;
+    recursive: z.ZodDefault<z.ZodBoolean>;
+    ignore: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+type FsWatchStartParams = z.output<typeof FsWatchStartParams>;
+declare const FsWatchStartResult: z.ZodObject<{
+    watch_id: z.ZodString;
+    path: z.ZodString;
+    expires_at_ms: z.ZodInt;
+}, z.core.$strict>;
+type FsWatchStartResult = z.output<typeof FsWatchStartResult>;
+declare const FsWatchEventsParams: z.ZodObject<{
+    watch_id: z.ZodString;
+    wait_ms: z.ZodDefault<z.ZodInt>;
+}, z.core.$strict>;
+type FsWatchEventsParams = z.output<typeof FsWatchEventsParams>;
+declare const FsWatchEventsResult: z.ZodObject<{
+    changes: z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<{
+            created: "created";
+            deleted: "deleted";
+            modified: "modified";
+            moved: "moved";
+        }>;
+        path: z.ZodString;
+        to_path: z.ZodOptional<z.ZodString>;
+        kind: z.ZodEnum<{
+            unknown: "unknown";
+            file: "file";
+            dir: "dir";
+            symlink: "symlink";
+        }>;
+    }, z.core.$strict>>;
+    overflow: z.ZodBoolean;
+    expires_at_ms: z.ZodInt;
+}, z.core.$strict>;
+type FsWatchEventsResult = z.output<typeof FsWatchEventsResult>;
+declare const FsWatchStopParams: z.ZodObject<{
+    watch_id: z.ZodString;
+}, z.core.$strict>;
+type FsWatchStopParams = z.output<typeof FsWatchStopParams>;
+declare const FsWatchStopResult: z.ZodObject<{
+    watch_id: z.ZodString;
+}, z.core.$strict>;
+type FsWatchStopResult = z.output<typeof FsWatchStopResult>;
+
+/**
+ * @ai-matrx/desktop-protocol — cap exec, background jobs (SPEC §6): start a command that keeps
+ * running (a dev server, a long build), read its output later, stop it. Schema source:
+ * lint-enforced rules in scripts/check-schema-source.mjs. Added in protocol 1.4.
+ */
+
+declare const ExecJobListParams: z.ZodObject<{}, z.core.$strict>;
+declare const ExecJobId: z.ZodString;
+type ExecJobId = z.output<typeof ExecJobId>;
+declare const ExecJobStartParams: z.ZodObject<{
+    command: z.ZodString;
+    cwd: z.ZodOptional<z.ZodString>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strict>;
+type ExecJobStartParams = z.output<typeof ExecJobStartParams>;
+declare const ExecJobStartResult: z.ZodObject<{
+    job_id: z.ZodString;
+    pid: z.ZodInt;
+    cwd: z.ZodString;
+}, z.core.$strict>;
+type ExecJobStartResult = z.output<typeof ExecJobStartResult>;
+declare const ExecJobOutputParams: z.ZodObject<{
+    job_id: z.ZodString;
+    offset: z.ZodDefault<z.ZodInt>;
+    wait_ms: z.ZodDefault<z.ZodInt>;
+    max_bytes: z.ZodDefault<z.ZodInt>;
+}, z.core.$strict>;
+type ExecJobOutputParams = z.output<typeof ExecJobOutputParams>;
+declare const ExecJobOutputResult: z.ZodObject<{
+    output: z.ZodString;
+    next_offset: z.ZodInt;
+    dropped_bytes: z.ZodInt;
+    running: z.ZodBoolean;
+    exit_code: z.ZodNullable<z.ZodInt>;
+}, z.core.$strict>;
+type ExecJobOutputResult = z.output<typeof ExecJobOutputResult>;
+declare const ExecJobStopParams: z.ZodObject<{
+    job_id: z.ZodString;
+    force: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>;
+type ExecJobStopParams = z.output<typeof ExecJobStopParams>;
+declare const ExecJobStopResult: z.ZodObject<{
+    job_id: z.ZodString;
+    exited: z.ZodBoolean;
+    exit_code: z.ZodNullable<z.ZodInt>;
+}, z.core.$strict>;
+type ExecJobStopResult = z.output<typeof ExecJobStopResult>;
+declare const ExecJobInfo: z.ZodObject<{
+    job_id: z.ZodString;
+    command: z.ZodString;
+    pid: z.ZodInt;
+    cwd: z.ZodString;
+    running: z.ZodBoolean;
+    exit_code: z.ZodNullable<z.ZodInt>;
+    started_at_ms: z.ZodInt;
+    output_bytes: z.ZodInt;
+}, z.core.$strict>;
+type ExecJobInfo = z.output<typeof ExecJobInfo>;
+declare const ExecJobListResult: z.ZodObject<{
+    jobs: z.ZodArray<z.ZodObject<{
+        job_id: z.ZodString;
+        command: z.ZodString;
+        pid: z.ZodInt;
+        cwd: z.ZodString;
+        running: z.ZodBoolean;
+        exit_code: z.ZodNullable<z.ZodInt>;
+        started_at_ms: z.ZodInt;
+        output_bytes: z.ZodInt;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+type ExecJobListResult = z.output<typeof ExecJobListResult>;
+
 /**
  * Version skew is the normal state: a phone, the server and a desktop app in the field run
  * different package versions, and a minor protocol bump must never make any of them fail.
@@ -1728,7 +2501,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: "ef9fd8c8ab611bf450730452a6cf48a4ebd566218b6e17e2834ef030fc2044cb";
+declare const CONTRACT_SHA256: "a5378bb523cbf52619f16e2accc788931ffb443e762052db4ca42c598792c181";
 
 /**
  * The local tool catalog (SPEC §10): every tool a platform agent calls on a person's computer, the
@@ -1860,4 +2633,4 @@ declare function buildToolStatus(files: readonly unknown[], opts: {
 /** The committed text form. Columns: per platform, the three levels (P = programmatic, R = protocol, C = chat). */
 declare function renderToolStatusMarkdown(status: ToolStatus): string;
 
-export { AbsPath, AppFeatureStatus, AppInfo, AppKey, AppProfile, AppProfileId, AppProfileLocator, AppSupport, AppUsageReading, AppsListParams, AppsListResult, AppsOpenParams, AppsOpenResult, AppsProfilesListParams, AppsProfilesListResult, AppsProfilesRemoveParams, AppsProfilesRemoveResult, AppsProfilesSaveParams, AppsProfilesSaveResult, CONTRACT_SHA256, type CatalogTool, type CellState, ContractHash, CoreToServiceMsg, DEFAULT_MAX_FRAME_PAYLOAD_BYTES, DEFAULT_MAX_MESSAGE_BYTES, DEFAULT_WINDOW_BYTES, DeviceId, EXCLUDED_TOOLS, ExecCwdEvent, ExecExitedEvent, 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, FsWatchParams, FsWatchResult, FsWriteParams, FsWriteResult, LEGACY_ACTIONS, LEGACY_DISPATCHERS, type LegacyDisposition, NULL_SINCE, OpName, OsPermissionName, PROTOCOL_MAJOR, PROTOCOL_MINOR, PROTOCOL_VERSION, 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, SERVICE_MAX_FRAME_BYTES, 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, 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, announcedVersion, buildToolStatus, builtOps, compareVersions, epochMs, forPeer, knows, negotiate, nonNegInt, renderToolStatusMarkdown, statusForPeer, u32, versionSubprotocol };
+export { AbsPath, AppFeatureStatus, AppInfo, AppKey, AppProfile, AppProfileId, AppProfileLocator, AppSupport, AppUsageReading, AppsListParams, AppsListResult, AppsOpenParams, AppsOpenResult, AppsProfilesListParams, AppsProfilesListResult, AppsProfilesRemoveParams, AppsProfilesRemoveResult, AppsProfilesSaveParams, AppsProfilesSaveResult, CONTRACT_SHA256, type CatalogTool, type CellState, ClipboardReadParams, ClipboardReadResult, ClipboardWriteParams, ClipboardWriteResult, 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 };