@ai-matrx/desktop-protocol 0.14.0 → 0.16.0

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { O as OpName } from './models-DqFPqtNS.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-DqFPqtNS.js';
+import { O as OpName } from './models-k4pDkXUe.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-k4pDkXUe.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. */
@@ -14,10 +14,14 @@ declare const PROTOCOL_MAJOR: 1;
  *   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.*).
+ *   1.5 — `coding.history.import_missing`: Claude Code history the platform lacks, imported by the
+ *         `coding` Python service.
  */
-declare const PROTOCOL_MINOR: 3;
+declare const PROTOCOL_MINOR: 5;
 /** This package's version as the wire spells it ("major.minor"): hello, welcome, relay status. */
-declare const PROTOCOL_VERSION: "1.3";
+declare const PROTOCOL_VERSION: "1.5";
 /** Internal building blocks — deliberately unnamed in $defs (inlined wherever used). */
 declare const u32: z.ZodInt;
 declare const nonNegInt: z.ZodInt;
@@ -1408,6 +1412,7 @@ declare const ServiceShutdown: z.ZodObject<{
 /** Supervised Python services. `tools` joins when it is built. */
 declare const ServiceName: z.ZodEnum<{
     ml: "ml";
+    coding: "coding";
 }>;
 type ServiceName = z.output<typeof ServiceName>;
 declare const CoreToServiceMsg: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -1433,6 +1438,7 @@ declare const ServiceToCoreMsg: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"welcome">;
     service: z.ZodEnum<{
         ml: "ml";
+        coding: "coding";
     }>;
     contract: z.ZodString;
     pid: z.ZodInt;
@@ -1525,6 +1531,7 @@ declare const ServiceWelcome: z.ZodObject<{
     type: z.ZodLiteral<"welcome">;
     service: z.ZodEnum<{
         ml: "ml";
+        coding: "coding";
     }>;
     contract: z.ZodString;
     pid: z.ZodInt;
@@ -1753,6 +1760,832 @@ declare const ClipboardWriteResult: z.ZodObject<{
 }, 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>;
+
+/**
+ * @ai-matrx/desktop-protocol — the `coding` capability's Claude Code history (SPEC §6 `coding`):
+ * "Import missing history" — every Claude Code session on this computer that AI Matrx lacks, or is
+ * behind on, imported through the shared importer (matrx-coding-history, the same code Matrx Local
+ * runs) in Matrx 2's `coding` Python service (SPEC §3.10). Schema source: lint-enforced rules in
+ * scripts/check-schema-source.mjs.
+ *
+ * Two contracts, both generated from this file (SPEC P11):
+ *   - the Router op `coding.history.import_missing` (every transport) and its progress event;
+ *   - the internal service ops `coding.plan_missing` / `coding.import_next` between the core and
+ *     the Python service. The core runs the loop: each service call is one bounded batch carrying
+ *     a fresh access token, so a long run never outlives its credential.
+ */
+
+declare const CodingHistoryFailure: z.ZodObject<{
+    session_id: z.ZodString;
+    reason: z.ZodString;
+}, z.core.$strict>;
+/** Service op `coding.plan_missing`: read the cloud's list and this computer's history (stat only). */
+declare const CodingPlanMissingParams: z.ZodObject<{
+    credentials: z.ZodObject<{
+        access_token: z.ZodString;
+        user_id: z.ZodString;
+        server_url: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+/** Service op `coding.import_next`: import the plan's next bounded batch. */
+declare const CodingImportNextParams: z.ZodObject<{
+    plan_id: z.ZodString;
+    credentials: z.ZodObject<{
+        access_token: z.ZodString;
+        user_id: z.ZodString;
+        server_url: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+declare const CodingHistoryImportMissingParams: z.ZodObject<{}, z.core.$strict>;
+/** What the core adds to every coding service op from its own sign-in (never sent by a client). */
+declare const CodingServiceCredentials: z.ZodObject<{
+    access_token: z.ZodString;
+    user_id: z.ZodString;
+    server_url: z.ZodString;
+}, z.core.$strict>;
+type CodingServiceCredentials = z.output<typeof CodingServiceCredentials>;
+/**
+ * Why a run stopped before it was done, as a state the screen can name:
+ *   signed_out — no usable AI Matrx sign-in (or it expired mid-run);
+ *   offline — the AI Matrx server did not answer;
+ *   organization_required — AI Matrx needs to know which organization files coding sessions;
+ *   claude_unavailable — Claude Code's account on this computer cannot be read;
+ *   cloud_list_unavailable — the server's list of sessions could not be proven complete;
+ *   history_too_large — more local sessions than the importer reads in one run.
+ */
+declare const CodingHistoryBlocked: z.ZodEnum<{
+    signed_out: "signed_out";
+    offline: "offline";
+    organization_required: "organization_required";
+    claude_unavailable: "claude_unavailable";
+    cloud_list_unavailable: "cloud_list_unavailable";
+    history_too_large: "history_too_large";
+}>;
+type CodingHistoryBlocked = z.output<typeof CodingHistoryBlocked>;
+/** A run's counts so far, and its one honest line. */
+declare const CodingHistoryRun: z.ZodObject<{
+    local_sessions: z.ZodInt;
+    in_cloud: z.ZodInt;
+    missing: z.ZodInt;
+    behind: z.ZodInt;
+    too_large: z.ZodInt;
+    imported: z.ZodInt;
+    changed: z.ZodInt;
+    failed: z.ZodInt;
+    failures: z.ZodArray<z.ZodObject<{
+        session_id: z.ZodString;
+        reason: z.ZodString;
+    }, z.core.$strict>>;
+    remaining: z.ZodInt;
+    summary: z.ZodString;
+}, z.core.$strict>;
+type CodingHistoryRun = z.output<typeof CodingHistoryRun>;
+/** The answer to each service op: where the run stands. */
+declare const CodingHistoryStep: z.ZodObject<{
+    plan_id: z.ZodNullable<z.ZodString>;
+    finished: z.ZodBoolean;
+    blocked: z.ZodNullable<z.ZodEnum<{
+        signed_out: "signed_out";
+        offline: "offline";
+        organization_required: "organization_required";
+        claude_unavailable: "claude_unavailable";
+        cloud_list_unavailable: "cloud_list_unavailable";
+        history_too_large: "history_too_large";
+    }>>;
+    run: z.ZodObject<{
+        local_sessions: z.ZodInt;
+        in_cloud: z.ZodInt;
+        missing: z.ZodInt;
+        behind: z.ZodInt;
+        too_large: z.ZodInt;
+        imported: z.ZodInt;
+        changed: z.ZodInt;
+        failed: z.ZodInt;
+        failures: z.ZodArray<z.ZodObject<{
+            session_id: z.ZodString;
+            reason: z.ZodString;
+        }, z.core.$strict>>;
+        remaining: z.ZodInt;
+        summary: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+type CodingHistoryStep = z.output<typeof CodingHistoryStep>;
+/** The coding service's progress messages (sent while it reads a large history). */
+declare const CodingServiceProgress: z.ZodObject<{
+    phase: z.ZodEnum<{
+        checking: "checking";
+        importing: "importing";
+    }>;
+    done: z.ZodInt;
+    total: z.ZodInt;
+}, z.core.$strict>;
+type CodingServiceProgress = z.output<typeof CodingServiceProgress>;
+declare const CodingHistoryImportMissingResult: z.ZodObject<{
+    state: z.ZodEnum<{
+        cancelled: "cancelled";
+        blocked: "blocked";
+        done: "done";
+    }>;
+    blocked: z.ZodNullable<z.ZodEnum<{
+        signed_out: "signed_out";
+        offline: "offline";
+        organization_required: "organization_required";
+        claude_unavailable: "claude_unavailable";
+        cloud_list_unavailable: "cloud_list_unavailable";
+        history_too_large: "history_too_large";
+    }>>;
+    run: z.ZodObject<{
+        local_sessions: z.ZodInt;
+        in_cloud: z.ZodInt;
+        missing: z.ZodInt;
+        behind: z.ZodInt;
+        too_large: z.ZodInt;
+        imported: z.ZodInt;
+        changed: z.ZodInt;
+        failed: z.ZodInt;
+        failures: z.ZodArray<z.ZodObject<{
+            session_id: z.ZodString;
+            reason: z.ZodString;
+        }, z.core.$strict>>;
+        remaining: z.ZodInt;
+        summary: z.ZodString;
+    }, z.core.$strict>;
+    elapsed_ms: z.ZodInt;
+}, z.core.$strict>;
+type CodingHistoryImportMissingResult = z.output<typeof CodingHistoryImportMissingResult>;
+/** Sent to the client that started `coding.history.import_missing`, for that request. */
+declare const CodingHistoryProgressEvent: z.ZodObject<{
+    request_id: z.ZodString;
+    phase: z.ZodEnum<{
+        checking: "checking";
+        importing: "importing";
+    }>;
+    done: z.ZodInt;
+    total: z.ZodInt;
+    imported: z.ZodInt;
+    failed: z.ZodInt;
+}, z.core.$strict>;
+type CodingHistoryProgressEvent = z.output<typeof CodingHistoryProgressEvent>;
+
 /**
  * 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.
@@ -1839,7 +2672,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: "0354e634fd50ffdc4c83b7ede7f9c31f3b2c877c4574557a6b264d2998470fd6";
+declare const CONTRACT_SHA256: "c536cb055d02ce0704cee4693f08b4af9e83a38e00e6879160037c1006f2e72e";
 
 /**
  * The local tool catalog (SPEC §10): every tool a platform agent calls on a person's computer, the
@@ -1971,4 +2804,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, ClipboardReadParams, ClipboardReadResult, ClipboardWriteParams, ClipboardWriteResult, 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, 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, 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, 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 };