@dyrra/protocol 0.1.1

package/dist/rpc.d.ts

@@ -0,0 +1,433 @@
+import { z } from "zod";
+import { Scope } from "./common.js";
+/**
+ * Протокол gateway ↔ Dyrra Agent.app поверх исходящего WSS (ТЗ 7.9, 7.10).
+ * JSON-фреймы для управления, бинарные — для данных.
+ */
+export declare const RpcMethod: z.ZodEnum<{
+    "actions.perform": "actions.perform";
+    "apps.activate": "apps.activate";
+    "apps.list": "apps.list";
+    "apps.open": "apps.open";
+    "clipboard.get": "clipboard.get";
+    "clipboard.set": "clipboard.set";
+    "connection.grant": "connection.grant";
+    "connection.revoke": "connection.revoke";
+    "cursor.position": "cursor.position";
+    "display.info": "display.info";
+    "files.download": "files.download";
+    "files.upload.begin": "files.upload.begin";
+    "files.upload.chunk": "files.upload.chunk";
+    "files.upload.end": "files.upload.end";
+    heartbeat: "heartbeat";
+    hello: "hello";
+    "permissions.get": "permissions.get";
+    "queue.offer": "queue.offer";
+    screenshot: "screenshot";
+    "shell.run": "shell.run";
+    "system.reboot": "system.reboot";
+    "ui.tree": "ui.tree";
+    "urls.open": "urls.open";
+    "vnc.close": "vnc.close";
+    "vnc.open": "vnc.open";
+    "windows.list": "windows.list";
+}>;
+export type RpcMethod = z.infer<typeof RpcMethod>;
+/** Методы, доступные только на облачных Mac (ТЗ 7.10). */
+export declare const CLOUD_ONLY_METHODS: RpcMethod[];
+/** Право, необходимое для каждого метода. Приложение проверяет это локально (ТЗ 3.4). */
+export declare const METHOD_SCOPE: Partial<Record<RpcMethod, Scope>>;
+export declare const RpcRequest: z.ZodObject<{
+    id: z.ZodString;
+    method: z.ZodEnum<{
+        "actions.perform": "actions.perform";
+        "apps.activate": "apps.activate";
+        "apps.list": "apps.list";
+        "apps.open": "apps.open";
+        "clipboard.get": "clipboard.get";
+        "clipboard.set": "clipboard.set";
+        "connection.grant": "connection.grant";
+        "connection.revoke": "connection.revoke";
+        "cursor.position": "cursor.position";
+        "display.info": "display.info";
+        "files.download": "files.download";
+        "files.upload.begin": "files.upload.begin";
+        "files.upload.chunk": "files.upload.chunk";
+        "files.upload.end": "files.upload.end";
+        heartbeat: "heartbeat";
+        hello: "hello";
+        "permissions.get": "permissions.get";
+        "queue.offer": "queue.offer";
+        screenshot: "screenshot";
+        "shell.run": "shell.run";
+        "system.reboot": "system.reboot";
+        "ui.tree": "ui.tree";
+        "urls.open": "urls.open";
+        "vnc.close": "vnc.close";
+        "vnc.open": "vnc.open";
+        "windows.list": "windows.list";
+    }>;
+    connectionId: z.ZodOptional<z.ZodString>;
+    params: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+export type RpcRequest = z.infer<typeof RpcRequest>;
+export declare const RpcErrorBody: z.ZodObject<{
+    code: z.ZodString;
+    message: z.ZodString;
+    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export declare const RpcResponse: z.ZodObject<{
+    id: z.ZodString;
+    result: z.ZodOptional<z.ZodUnknown>;
+    error: z.ZodOptional<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type RpcResponse = z.infer<typeof RpcResponse>;
+/** События от приложения к gateway (без id, ответа не ждут). */
+export declare const MachineEventType: z.ZodEnum<{
+    availability_changed: "availability_changed";
+    connection_revoked: "connection_revoked";
+    paused: "paused";
+    permissions_changed: "permissions_changed";
+    queued_commands_ack: "queued_commands_ack";
+    recording_ready: "recording_ready";
+    resumed: "resumed";
+}>;
+export type MachineEventType = z.infer<typeof MachineEventType>;
+export declare const MachineEvent: z.ZodObject<{
+    event: z.ZodEnum<{
+        availability_changed: "availability_changed";
+        connection_revoked: "connection_revoked";
+        paused: "paused";
+        permissions_changed: "permissions_changed";
+        queued_commands_ack: "queued_commands_ack";
+        recording_ready: "recording_ready";
+        resumed: "resumed";
+    }>;
+    connectionId: z.ZodOptional<z.ZodString>;
+    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type MachineEvent = z.infer<typeof MachineEvent>;
+/**
+ * Команды, дождавшиеся пробуждения Mac (ТЗ 7.16).
+ *
+ * Gateway предлагает их приложению, а приложение по настройке человека
+ * отвечает событием queued_commands_ack. Текст, который агент собирается
+ * ввести, в описание не попадает.
+ */
+export declare const QueueOffer: z.ZodObject<{
+    connectionId: z.ZodString;
+    platformName: z.ZodString;
+    commands: z.ZodArray<z.ZodObject<{
+        commandId: z.ZodString;
+        type: z.ZodString;
+        summary: z.ZodString;
+        expiresAt: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type QueueOffer = z.infer<typeof QueueOffer>;
+/** Решение приложения по предложенным командам. */
+export declare const QueueAck: z.ZodObject<{
+    accepted: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    declined: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type QueueAck = z.infer<typeof QueueAck>;
+export declare const Heartbeat: z.ZodObject<{
+    appVersion: z.ZodString;
+    macosVersion: z.ZodString;
+    mode: z.ZodEnum<{
+        cloud: "cloud";
+        connected: "connected";
+        vm: "vm";
+    }>;
+    permissions: z.ZodObject<{
+        screenRecording: z.ZodBoolean;
+        accessibility: z.ZodBoolean;
+    }, z.core.$strip>;
+    display: z.ZodNullable<z.ZodObject<{
+        widthPoints: z.ZodNumber;
+        heightPoints: z.ZodNumber;
+        scaleFactor: z.ZodNumber;
+        displayId: z.ZodNumber;
+    }, z.core.$strip>>;
+    paused: z.ZodBoolean;
+    availability: z.ZodEnum<{
+        asleep: "asleep";
+        no_gui_session: "no_gui_session";
+        ready: "ready";
+        screen_locked: "screen_locked";
+    }>;
+    cpu: z.ZodOptional<z.ZodNumber>;
+    memUsedMb: z.ZodOptional<z.ZodNumber>;
+    diskFreeGb: z.ZodOptional<z.ZodNumber>;
+    hiddenAppCount: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type Heartbeat = z.infer<typeof Heartbeat>;
+export declare const HelloParams: z.ZodObject<{
+    appVersion: z.ZodString;
+    macosVersion: z.ZodString;
+    mode: z.ZodEnum<{
+        cloud: "cloud";
+        connected: "connected";
+        vm: "vm";
+    }>;
+}, z.core.$strip>;
+export declare const ConnectionGrant: z.ZodObject<{
+    connectionId: z.ZodString;
+    platformName: z.ZodString;
+    scopes: z.ZodArray<z.ZodEnum<{
+        clipboard: "clipboard";
+        files: "files";
+        input: "input";
+        record: "record";
+        screen: "screen";
+        shell: "shell";
+    }>>;
+}, z.core.$strip>;
+export type ConnectionGrant = z.infer<typeof ConnectionGrant>;
+/** Параметры и результаты по методам — используются роутером на обеих сторонах. */
+export declare const RPC_PARAMS: {
+    readonly hello: z.ZodObject<{
+        appVersion: z.ZodString;
+        macosVersion: z.ZodString;
+        mode: z.ZodEnum<{
+            cloud: "cloud";
+            connected: "connected";
+            vm: "vm";
+        }>;
+    }, z.core.$strip>;
+    readonly heartbeat: z.ZodObject<{
+        appVersion: z.ZodString;
+        macosVersion: z.ZodString;
+        mode: z.ZodEnum<{
+            cloud: "cloud";
+            connected: "connected";
+            vm: "vm";
+        }>;
+        permissions: z.ZodObject<{
+            screenRecording: z.ZodBoolean;
+            accessibility: z.ZodBoolean;
+        }, z.core.$strip>;
+        display: z.ZodNullable<z.ZodObject<{
+            widthPoints: z.ZodNumber;
+            heightPoints: z.ZodNumber;
+            scaleFactor: z.ZodNumber;
+            displayId: z.ZodNumber;
+        }, z.core.$strip>>;
+        paused: z.ZodBoolean;
+        availability: z.ZodEnum<{
+            asleep: "asleep";
+            no_gui_session: "no_gui_session";
+            ready: "ready";
+            screen_locked: "screen_locked";
+        }>;
+        cpu: z.ZodOptional<z.ZodNumber>;
+        memUsedMb: z.ZodOptional<z.ZodNumber>;
+        diskFreeGb: z.ZodOptional<z.ZodNumber>;
+        hiddenAppCount: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+    readonly screenshot: z.ZodObject<{
+        format: z.ZodDefault<z.ZodEnum<{
+            jpeg: "jpeg";
+            png: "png";
+        }>>;
+        quality: z.ZodDefault<z.ZodNumber>;
+        maxWidth: z.ZodOptional<z.ZodNumber>;
+        response: z.ZodDefault<z.ZodEnum<{
+            base64: "base64";
+            binary: "binary";
+        }>>;
+    }, z.core.$strip>;
+    readonly "actions.perform": z.ZodObject<{
+        actions: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"move">;
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"click">;
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            button: z.ZodDefault<z.ZodEnum<{
+                left: "left";
+                middle: "middle";
+                right: "right";
+            }>>;
+            count: z.ZodDefault<z.ZodNumber>;
+            modifiers: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                alt: "alt";
+                cmd: "cmd";
+                ctrl: "ctrl";
+                fn: "fn";
+                shift: "shift";
+            }>>>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"mouse_down">;
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            button: z.ZodDefault<z.ZodEnum<{
+                left: "left";
+                middle: "middle";
+                right: "right";
+            }>>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"mouse_up">;
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            button: z.ZodDefault<z.ZodEnum<{
+                left: "left";
+                middle: "middle";
+                right: "right";
+            }>>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"drag">;
+            from: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strip>;
+            to: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strip>;
+            button: z.ZodDefault<z.ZodEnum<{
+                left: "left";
+                middle: "middle";
+                right: "right";
+            }>>;
+            durationMs: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"scroll">;
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            dx: z.ZodDefault<z.ZodNumber>;
+            dy: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"type">;
+            text: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"key">;
+            keys: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"wait">;
+            ms: z.ZodNumber;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"click_element">;
+            snapshotId: z.ZodString;
+            elementId: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"set_value">;
+            snapshotId: z.ZodString;
+            elementId: z.ZodString;
+            text: z.ZodString;
+        }, z.core.$strip>], "type">>;
+        expectBundleId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly "ui.tree": z.ZodObject<{
+        scope: z.ZodDefault<z.ZodEnum<{
+            all_windows: "all_windows";
+            frontmost: "frontmost";
+            menu_bar: "menu_bar";
+        }>>;
+        interactiveOnly: z.ZodDefault<z.ZodBoolean>;
+        format: z.ZodDefault<z.ZodEnum<{
+            compact: "compact";
+            json: "json";
+        }>>;
+    }, z.core.$strip>;
+    readonly "shell.run": z.ZodObject<{
+        command: z.ZodString;
+        cwd: z.ZodOptional<z.ZodString>;
+        timeoutMs: z.ZodDefault<z.ZodNumber>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strip>;
+    readonly "files.upload.begin": z.ZodObject<{
+        path: z.ZodString;
+        sizeBytes: z.ZodNumber;
+        sha256: z.ZodString;
+    }, z.core.$strip>;
+    readonly "urls.open": z.ZodObject<{
+        url: z.ZodString;
+    }, z.core.$strip>;
+    readonly "clipboard.set": z.ZodObject<{
+        text: z.ZodString;
+    }, z.core.$strip>;
+    readonly "connection.grant": z.ZodObject<{
+        connectionId: z.ZodString;
+        platformName: z.ZodString;
+        scopes: z.ZodArray<z.ZodEnum<{
+            clipboard: "clipboard";
+            files: "files";
+            input: "input";
+            record: "record";
+            screen: "screen";
+            shell: "shell";
+        }>>;
+    }, z.core.$strip>;
+    readonly "connection.revoke": z.ZodObject<{
+        connectionId: z.ZodString;
+    }, z.core.$strip>;
+};
+export declare const RPC_RESULTS: {
+    readonly screenshot: z.ZodObject<{
+        mime: z.ZodString;
+        data: z.ZodString;
+        imageWidth: z.ZodNumber;
+        imageHeight: z.ZodNumber;
+        widthPoints: z.ZodNumber;
+        heightPoints: z.ZodNumber;
+        scale: z.ZodNumber;
+    }, z.core.$strip>;
+    readonly "display.info": z.ZodObject<{
+        widthPoints: z.ZodNumber;
+        heightPoints: z.ZodNumber;
+        scaleFactor: z.ZodNumber;
+        displayId: z.ZodNumber;
+    }, z.core.$strip>;
+    readonly "permissions.get": z.ZodObject<{
+        screenRecording: z.ZodBoolean;
+        accessibility: z.ZodBoolean;
+    }, z.core.$strip>;
+    readonly "ui.tree": z.ZodObject<{
+        snapshotId: z.ZodString;
+        app: z.ZodNullable<z.ZodObject<{
+            bundleId: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>>;
+        elements: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            role: z.ZodString;
+            subrole: z.ZodOptional<z.ZodString>;
+            title: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            value: z.ZodOptional<z.ZodString>;
+            identifier: z.ZodOptional<z.ZodString>;
+            frame: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                w: z.ZodNumber;
+                h: z.ZodNumber;
+            }, z.core.$strip>;
+            enabled: z.ZodBoolean;
+            focused: z.ZodBoolean;
+            actions: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+        compact: z.ZodOptional<z.ZodString>;
+        truncated: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>;
+    readonly "shell.run": z.ZodObject<{
+        exitCode: z.ZodNumber;
+        stdout: z.ZodString;
+        stderr: z.ZodString;
+        durationMs: z.ZodNumber;
+        truncated: z.ZodBoolean;
+        timedOut: z.ZodBoolean;
+    }, z.core.$strip>;
+    readonly "clipboard.get": z.ZodObject<{
+        text: z.ZodString;
+    }, z.core.$strip>;
+};
+export declare const HEARTBEAT_INTERVAL_MS = 15000;
+export declare const OFFLINE_AFTER_MS = 45000;
+//# sourceMappingURL=rpc.d.ts.map

package/dist/rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../src/rpc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAA0C,KAAK,EAAE,MAAM,aAAa,CAAC;AAU5E;;;GAGG;AAEH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6BM,CAAC;AAC7B,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAElD,0DAA0D;AAC1D,eAAO,MAAM,kBAAkB,EAAE,SAAS,EAA+C,CAAC;AAE1F,yFAAyF;AACzF,eAAO,MAAM,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,CAiB1D,CAAC;AAEF,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAQM,CAAC;AAC9B,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,eAAO,MAAM,YAAY;;;;iBAMM,CAAC;AAEhC,eAAO,MAAM,WAAW;;;;;;;;iBAMM,CAAC;AAC/B,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,gEAAgE;AAChE,eAAO,MAAM,gBAAgB;;;;;;;;EAUM,CAAC;AACpC,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE,eAAO,MAAM,YAAY;;;;;;;;;;;;iBAMM,CAAC;AAChC,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD;;;;;;GAMG;AACH,eAAO,MAAM,UAAU;;;;;;;;;iBAaM,CAAC;AAC9B,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,mDAAmD;AACnD,eAAO,MAAM,QAAQ;;;iBAKM,CAAC;AAC5B,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAcM,CAAC;AAC7B,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAElD,eAAO,MAAM,WAAW;;;;;;;;iBAMM,CAAC;AAE/B,eAAO,MAAM,eAAe;;;;;;;;;;;iBAMM,CAAC;AACnC,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,mFAAmF;AACnF,eAAO,MAAM,UAAU;aACrB,KAAK;;;;;;;;;aACL,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aACT,UAAU;;;;;;;;;;;;aACV,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAIjB,SAAS;;;;;;;;;;;;aACT,WAAW;;;;;;aACX,oBAAoB;;;;;aACpB,WAAW;;;aACX,eAAe;;;aACf,kBAAkB;;;;;;;;;;;;aAClB,mBAAmB;;;CACX,CAAC;AAEX,eAAO,MAAM,WAAW;aACtB,UAAU;;;;;;;;;aACV,cAAc;;;;;;aACd,iBAAiB;;;;aACjB,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;aACT,WAAW;;;;;;;;aACX,eAAe;;;CACP,CAAC;AAEX,eAAO,MAAM,qBAAqB,QAAS,CAAC;AAC5C,eAAO,MAAM,gBAAgB,QAAS,CAAC"}

package/dist/rpc.js

@@ -0,0 +1,185 @@
+import { z } from "zod";
+import { Action } from "./actions.js";
+import { Availability, DisplayInfo, Permissions, Scope } from "./common.js";
+import { ClipboardText, FileUploadBegin, OpenUrlRequest, ShellRequest, ShellResult, } from "./system.js";
+import { Screenshot, ScreenshotRequest, UiTree, UiTreeRequest } from "./screen.js";
+/**
+ * Протокол gateway ↔ Dyrra Agent.app поверх исходящего WSS (ТЗ 7.9, 7.10).
+ * JSON-фреймы для управления, бинарные — для данных.
+ */
+export const RpcMethod = z
+    .enum([
+    "hello",
+    "heartbeat",
+    "display.info",
+    "permissions.get",
+    "screenshot",
+    "actions.perform",
+    "cursor.position",
+    "ui.tree",
+    "shell.run",
+    "files.upload.begin",
+    "files.upload.chunk",
+    "files.upload.end",
+    "files.download",
+    "apps.open",
+    "apps.activate",
+    "apps.list",
+    "windows.list",
+    "urls.open",
+    "clipboard.get",
+    "clipboard.set",
+    "connection.grant",
+    "connection.revoke",
+    "queue.offer",
+    "vnc.open",
+    "vnc.close",
+    "system.reboot",
+])
+    .meta({ id: "RpcMethod" });
+/** Методы, доступные только на облачных Mac (ТЗ 7.10). */
+export const CLOUD_ONLY_METHODS = ["vnc.open", "vnc.close", "system.reboot"];
+/** Право, необходимое для каждого метода. Приложение проверяет это локально (ТЗ 3.4). */
+export const METHOD_SCOPE = {
+    screenshot: "screen",
+    "ui.tree": "screen",
+    "windows.list": "screen",
+    "actions.perform": "input",
+    "cursor.position": "screen",
+    "apps.open": "input",
+    "apps.activate": "input",
+    "apps.list": "screen",
+    "urls.open": "input",
+    "shell.run": "shell",
+    "files.upload.begin": "files",
+    "files.upload.chunk": "files",
+    "files.upload.end": "files",
+    "files.download": "files",
+    "clipboard.get": "clipboard",
+    "clipboard.set": "clipboard",
+};
+export const RpcRequest = z
+    .object({
+    id: z.string(),
+    method: RpcMethod,
+    /** Подключение, от имени которого идёт вызов. Приложение сверяет его права. */
+    connectionId: z.string().optional(),
+    params: z.unknown().optional(),
+})
+    .meta({ id: "RpcRequest" });
+export const RpcErrorBody = z
+    .object({
+    code: z.string(),
+    message: z.string(),
+    details: z.record(z.string(), z.unknown()).optional(),
+})
+    .meta({ id: "RpcErrorBody" });
+export const RpcResponse = z
+    .object({
+    id: z.string(),
+    result: z.unknown().optional(),
+    error: RpcErrorBody.optional(),
+})
+    .meta({ id: "RpcResponse" });
+/** События от приложения к gateway (без id, ответа не ждут). */
+export const MachineEventType = z
+    .enum([
+    "paused",
+    "resumed",
+    "permissions_changed",
+    "availability_changed",
+    "connection_revoked",
+    "recording_ready",
+    "queued_commands_ack",
+])
+    .meta({ id: "MachineEventType" });
+export const MachineEvent = z
+    .object({
+    event: MachineEventType,
+    connectionId: z.string().optional(),
+    data: z.record(z.string(), z.unknown()).optional(),
+})
+    .meta({ id: "MachineEvent" });
+/**
+ * Команды, дождавшиеся пробуждения Mac (ТЗ 7.16).
+ *
+ * Gateway предлагает их приложению, а приложение по настройке человека
+ * отвечает событием queued_commands_ack. Текст, который агент собирается
+ * ввести, в описание не попадает.
+ */
+export const QueueOffer = z
+    .object({
+    connectionId: z.string(),
+    platformName: z.string(),
+    commands: z.array(z.object({
+        commandId: z.string(),
+        type: z.string(),
+        summary: z.string(),
+        expiresAt: z.string(),
+    })),
+})
+    .meta({ id: "QueueOffer" });
+/** Решение приложения по предложенным командам. */
+export const QueueAck = z
+    .object({
+    accepted: z.array(z.string()).default([]),
+    declined: z.array(z.string()).default([]),
+})
+    .meta({ id: "QueueAck" });
+export const Heartbeat = z
+    .object({
+    appVersion: z.string(),
+    macosVersion: z.string(),
+    mode: z.enum(["connected", "cloud", "vm"]),
+    permissions: Permissions,
+    display: DisplayInfo.nullable(),
+    paused: z.boolean(),
+    availability: Availability,
+    cpu: z.number().min(0).max(100).optional(),
+    memUsedMb: z.number().int().nonnegative().optional(),
+    diskFreeGb: z.number().nonnegative().optional(),
+    hiddenAppCount: z.number().int().nonnegative().default(0),
+})
+    .meta({ id: "Heartbeat" });
+export const HelloParams = z
+    .object({
+    appVersion: z.string(),
+    macosVersion: z.string(),
+    mode: z.enum(["connected", "cloud", "vm"]),
+})
+    .meta({ id: "HelloParams" });
+export const ConnectionGrant = z
+    .object({
+    connectionId: z.string(),
+    platformName: z.string(),
+    scopes: z.array(Scope),
+})
+    .meta({ id: "ConnectionGrant" });
+/** Параметры и результаты по методам — используются роутером на обеих сторонах. */
+export const RPC_PARAMS = {
+    hello: HelloParams,
+    heartbeat: Heartbeat,
+    screenshot: ScreenshotRequest,
+    "actions.perform": z.object({
+        actions: z.array(Action).min(1).max(50),
+        expectBundleId: z.string().min(1).max(255).optional(),
+    }),
+    "ui.tree": UiTreeRequest,
+    "shell.run": ShellRequest,
+    "files.upload.begin": FileUploadBegin,
+    "urls.open": OpenUrlRequest,
+    "clipboard.set": ClipboardText,
+    "connection.grant": ConnectionGrant,
+    "connection.revoke": z.object({ connectionId: z.string() }),
+};
+export const RPC_RESULTS = {
+    screenshot: Screenshot,
+    "display.info": DisplayInfo,
+    "permissions.get": Permissions,
+    "ui.tree": UiTree,
+    "shell.run": ShellResult,
+    "clipboard.get": ClipboardText,
+};
+export const HEARTBEAT_INTERVAL_MS = 15_000;
+export const OFFLINE_AFTER_MS = 45_000;
+//# sourceMappingURL=rpc.js.map

package/dist/rpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.js","sourceRoot":"","sources":["../src/rpc.ts"],"names":[],"mappings":"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"}