@ai-matrx/desktop-protocol 0.6.0 → 0.10.0

package/dist/react.d.cts

@@ -7,7 +7,7 @@ import { z } from 'zod';
  * never drift (see the `_assert*` lines there).
  */
 type ErrorCodeName = "AUTH_REQUIRED" | "AUTH_INVALID" | "AUTH_EXPIRED" | "AUTH_FORBIDDEN" | "AUTH_DEVICE_REVOKED" | "PERMISSION_DENIED_OS" | "NOT_FOUND" | "CONFLICT" | "INVALID_PARAMS" | "RESOURCE_BUSY" | "RESOURCE_GONE" | "CANCELLED" | "TIMEOUT" | "PLATFORM_UNSUPPORTED" | "RATE_LIMITED" | "INTERNAL" | "PROTOCOL_VERSION_UNSUPPORTED" | "PROTOCOL_ERROR" | "UNKNOWN_OPERATION" | "DEVICE_OFFLINE" | "PAYLOAD_TOO_LARGE";
-type ErrorReasonName = "not_a_directory" | "is_a_directory" | "directory_not_empty" | "already_exists" | "stale_write" | "binary_content" | "not_utf8_boundary" | "patch_no_match" | "patch_ambiguous" | "resource_exited" | "resource_expired" | "control_taken" | "window_exhausted";
+type ErrorReasonName = "not_a_directory" | "is_a_directory" | "directory_not_empty" | "already_exists" | "stale_write" | "binary_content" | "not_utf8_boundary" | "patch_no_match" | "patch_ambiguous" | "resource_exited" | "resource_expired" | "control_taken" | "window_exhausted" | "runtime_not_installed" | "model_not_installed" | "unsupported_media" | "download_failed" | "service_starting" | "service_restarted" | "service_failed";
 interface ErrorData {
     reason?: ErrorReasonName | undefined;
     cap?: string | undefined;
@@ -23,6 +23,23 @@ interface ErrorData {
     } | undefined;
 }
 
+/**
+ * What a connecting side does after each WebSocket close — the ONE table every client reads (the
+ * package client, the desktop's relay transport, any other dialer). Never keep a local list of
+ * "terminal" codes: a code added to CloseCode without a rule here fails to compile.
+ *
+ *   reconnect_now  the far side went away on purpose or the socket died; dial again at once if the
+ *                  connection had opened, with backoff otherwise (a dead network never spins).
+ *   reconnect      transient refusal; dial again with backoff.
+ *   reauth         the token was refused; get a FRESH token and dial once more. A second refusal in
+ *                  a row (no successful open between) is terminal with outcome "signed_out".
+ *   stop           retrying cannot help: stop dialing until something changes (a new sign-in, a
+ *                  new device, an update) and show the outcome.
+ */
+
+/** The one state a person is shown when dialing stops. */
+type CloseOutcome = "signed_out" | "not_owned" | "removed" | "revoked" | "replaced" | "upgrade_required";
+
 /**
  * The one error type every package entry throws. It carries the wire ErrorCode (SPEC §5), so a
  * caller branches on `code`/`retryable`/`data.reason` and never parses a message. Zod-free on
@@ -755,6 +772,261 @@ declare const OPS: {
         readonly since: "1.0";
         readonly errors: readonly ["INTERNAL"];
     };
+    readonly "models.status": {
+        readonly params: z.ZodObject<{}, z.core.$strict>;
+        readonly result: z.ZodObject<{
+            service: z.ZodObject<{
+                state: z.ZodEnum<{
+                    starting: "starting";
+                    ready: "ready";
+                    restarting: "restarting";
+                    failed: "failed";
+                    stopped: "stopped";
+                }>;
+                pid: z.ZodNullable<z.ZodInt>;
+                restarts: z.ZodInt;
+                python: z.ZodNullable<z.ZodString>;
+                error: z.ZodNullable<z.ZodString>;
+            }, z.core.$strict>;
+            transcription: z.ZodNullable<z.ZodObject<{
+                runtime: z.ZodEnum<{
+                    failed: "failed";
+                    not_installed: "not_installed";
+                    installing: "installing";
+                    installed: "installed";
+                }>;
+                install: z.ZodNullable<z.ZodObject<{
+                    phase: z.ZodEnum<{
+                        model: "model";
+                        packages: "packages";
+                        verifying: "verifying";
+                    }>;
+                    item: z.ZodString;
+                    bytes_done: z.ZodInt;
+                    bytes_total: z.ZodNullable<z.ZodInt>;
+                }, z.core.$strict>>;
+                error: z.ZodNullable<z.ZodString>;
+                accelerator: z.ZodEnum<{
+                    cpu: "cpu";
+                    cuda: "cuda";
+                }>;
+                models: z.ZodArray<z.ZodObject<{
+                    id: z.ZodEnum<{
+                        base: "base";
+                        small: "small";
+                        tiny: "tiny";
+                        "large-v3-turbo": "large-v3-turbo";
+                    }>;
+                    size_bytes: z.ZodInt;
+                    multilingual: z.ZodBoolean;
+                    installed: z.ZodBoolean;
+                }, z.core.$strict>>;
+                default_model: z.ZodEnum<{
+                    base: "base";
+                    small: "small";
+                    tiny: "tiny";
+                    "large-v3-turbo": "large-v3-turbo";
+                }>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+        readonly kind: "unary";
+        readonly since: "1.2";
+        readonly errors: readonly ["INTERNAL"];
+    };
+    readonly "models.install": {
+        readonly params: z.ZodObject<{
+            model: z.ZodOptional<z.ZodEnum<{
+                base: "base";
+                small: "small";
+                tiny: "tiny";
+                "large-v3-turbo": "large-v3-turbo";
+            }>>;
+        }, z.core.$strict>;
+        readonly result: z.ZodObject<{
+            model: z.ZodEnum<{
+                base: "base";
+                small: "small";
+                tiny: "tiny";
+                "large-v3-turbo": "large-v3-turbo";
+            }>;
+            elapsed_ms: z.ZodInt;
+        }, z.core.$strict>;
+        readonly kind: "unary";
+        readonly since: "1.2";
+        readonly errors: readonly ["RESOURCE_BUSY", "RESOURCE_GONE", "TIMEOUT", "CANCELLED", "INTERNAL"];
+    };
+    readonly "models.transcribe": {
+        readonly params: z.ZodObject<{
+            path: z.ZodString;
+            model: z.ZodOptional<z.ZodEnum<{
+                base: "base";
+                small: "small";
+                tiny: "tiny";
+                "large-v3-turbo": "large-v3-turbo";
+            }>>;
+            language: z.ZodOptional<z.ZodString>;
+            task: z.ZodDefault<z.ZodEnum<{
+                transcribe: "transcribe";
+                translate: "translate";
+            }>>;
+        }, z.core.$strict>;
+        readonly result: z.ZodObject<{
+            text: z.ZodString;
+            language: z.ZodString;
+            language_probability: z.ZodNumber;
+            duration_s: z.ZodNumber;
+            model: z.ZodEnum<{
+                base: "base";
+                small: "small";
+                tiny: "tiny";
+                "large-v3-turbo": "large-v3-turbo";
+            }>;
+            segments: z.ZodArray<z.ZodObject<{
+                start_s: z.ZodNumber;
+                end_s: z.ZodNumber;
+                text: z.ZodString;
+            }, z.core.$strict>>;
+            elapsed_ms: z.ZodInt;
+        }, z.core.$strict>;
+        readonly kind: "unary";
+        readonly since: "1.2";
+        readonly errors: readonly ["NOT_FOUND", "INVALID_PARAMS", "PERMISSION_DENIED_OS", "RESOURCE_BUSY", "RESOURCE_GONE", "CANCELLED", "PAYLOAD_TOO_LARGE", "INTERNAL"];
+    };
+    readonly "apps.list": {
+        readonly params: z.ZodObject<{}, z.core.$strict>;
+        readonly result: z.ZodObject<{
+            apps: z.ZodArray<z.ZodObject<{
+                app_key: z.ZodString;
+                name: z.ZodString;
+                installed: z.ZodBoolean;
+                version: z.ZodNullable<z.ZodString>;
+                location: z.ZodNullable<z.ZodString>;
+                open: z.ZodObject<{
+                    status: z.ZodEnum<{
+                        supported: "supported";
+                        partial: "partial";
+                        unsupported: "unsupported";
+                    }>;
+                    reason: z.ZodNullable<z.ZodString>;
+                }, z.core.$strict>;
+                profiles: z.ZodObject<{
+                    status: z.ZodEnum<{
+                        supported: "supported";
+                        partial: "partial";
+                        unsupported: "unsupported";
+                    }>;
+                    reason: z.ZodNullable<z.ZodString>;
+                }, z.core.$strict>;
+                usage: z.ZodObject<{
+                    status: z.ZodEnum<{
+                        supported: "supported";
+                        partial: "partial";
+                        unsupported: "unsupported";
+                    }>;
+                    reason: z.ZodNullable<z.ZodString>;
+                }, z.core.$strict>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+        readonly kind: "unary";
+        readonly since: "1.2";
+        readonly errors: readonly ["INTERNAL"];
+    };
+    readonly "apps.profiles.list": {
+        readonly params: z.ZodObject<{
+            app_key: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        readonly result: z.ZodObject<{
+            profiles: z.ZodArray<z.ZodObject<{
+                id: z.ZodNullable<z.ZodString>;
+                app_key: z.ZodString;
+                display_name: z.ZodString;
+                account_identity: z.ZodNullable<z.ZodString>;
+                profile_locator: z.ZodNullable<z.ZodString>;
+                device_id: z.ZodNullable<z.ZodString>;
+                folder: z.ZodNullable<z.ZodString>;
+                on_disk: z.ZodBoolean;
+                running: z.ZodNullable<z.ZodBoolean>;
+                usage: z.ZodNullable<z.ZodArray<z.ZodObject<{
+                    window: z.ZodEnum<{
+                        five_hour: "five_hour";
+                        weekly: "weekly";
+                        extra: "extra";
+                    }>;
+                    percent: z.ZodNumber;
+                    sampled_at_ms: z.ZodInt;
+                    reset_since: z.ZodBoolean;
+                }, z.core.$strict>>>;
+                last_opened_ms: z.ZodNullable<z.ZodInt>;
+            }, z.core.$strict>>;
+            registry: z.ZodEnum<{
+                ok: "ok";
+                signed_out: "signed_out";
+                unavailable: "unavailable";
+            }>;
+        }, z.core.$strict>;
+        readonly kind: "unary";
+        readonly since: "1.2";
+        readonly errors: readonly ["NOT_FOUND", "INVALID_PARAMS", "INTERNAL"];
+    };
+    readonly "apps.profiles.save": {
+        readonly params: z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            app_key: z.ZodString;
+            display_name: z.ZodString;
+            account_identity: z.ZodNullable<z.ZodString>;
+            profile_locator: z.ZodNullable<z.ZodString>;
+            new_folder: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strict>;
+        readonly result: z.ZodObject<{
+            id: z.ZodNullable<z.ZodString>;
+            app_key: z.ZodString;
+            display_name: z.ZodString;
+            account_identity: z.ZodNullable<z.ZodString>;
+            profile_locator: z.ZodNullable<z.ZodString>;
+            device_id: z.ZodNullable<z.ZodString>;
+            folder: z.ZodNullable<z.ZodString>;
+            on_disk: z.ZodBoolean;
+            running: z.ZodNullable<z.ZodBoolean>;
+            usage: z.ZodNullable<z.ZodArray<z.ZodObject<{
+                window: z.ZodEnum<{
+                    five_hour: "five_hour";
+                    weekly: "weekly";
+                    extra: "extra";
+                }>;
+                percent: z.ZodNumber;
+                sampled_at_ms: z.ZodInt;
+                reset_since: z.ZodBoolean;
+            }, z.core.$strict>>>;
+            last_opened_ms: z.ZodNullable<z.ZodInt>;
+        }, z.core.$strict>;
+        readonly kind: "unary";
+        readonly since: "1.2";
+        readonly errors: readonly ["AUTH_REQUIRED", "AUTH_FORBIDDEN", "NOT_FOUND", "INVALID_PARAMS", "CONFLICT", "PLATFORM_UNSUPPORTED", "DEVICE_OFFLINE", "INTERNAL"];
+    };
+    readonly "apps.profiles.remove": {
+        readonly params: z.ZodObject<{
+            id: z.ZodString;
+        }, z.core.$strict>;
+        readonly result: z.ZodObject<{
+            removed: z.ZodBoolean;
+        }, z.core.$strict>;
+        readonly kind: "unary";
+        readonly since: "1.2";
+        readonly errors: readonly ["AUTH_REQUIRED", "AUTH_FORBIDDEN", "NOT_FOUND", "DEVICE_OFFLINE", "INTERNAL"];
+    };
+    readonly "apps.open": {
+        readonly params: z.ZodObject<{
+            app_key: z.ZodString;
+            profile_id: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        readonly result: z.ZodObject<{
+            already_running: z.ZodBoolean;
+            folder: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>;
+        readonly kind: "unary";
+        readonly since: "1.2";
+        readonly errors: readonly ["NOT_FOUND", "PLATFORM_UNSUPPORTED", "AUTH_REQUIRED", "DEVICE_OFFLINE", "INTERNAL"];
+    };
 };
 type OpName = keyof typeof OPS;
 type OpParams<N extends OpName> = z.input<(typeof OPS)[N]["params"]>;
@@ -806,6 +1078,31 @@ declare const EVENTS: {
             read_only: "read_only";
         }>;
     }, z.core.$strict>;
+    readonly "models.progress": z.ZodObject<{
+        request_id: z.ZodString;
+        progress: z.ZodObject<{
+            kind: z.ZodEnum<{
+                install: "install";
+                transcribe: "transcribe";
+            }>;
+            fraction: z.ZodNullable<z.ZodNumber>;
+            install: z.ZodNullable<z.ZodObject<{
+                phase: z.ZodEnum<{
+                    model: "model";
+                    packages: "packages";
+                    verifying: "verifying";
+                }>;
+                item: z.ZodString;
+                bytes_done: z.ZodInt;
+                bytes_total: z.ZodNullable<z.ZodInt>;
+            }, z.core.$strict>>;
+            segment: z.ZodNullable<z.ZodObject<{
+                start_s: z.ZodNumber;
+                end_s: z.ZodNumber;
+                text: z.ZodString;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
     readonly "relay.device_status": z.ZodObject<{
         online: z.ZodBoolean;
         since_ms: z.ZodNullable<z.ZodInt>;
@@ -839,10 +1136,17 @@ interface DesktopClientState {
     retryInMs: number | null;
     lastError: DesktopProtocolError | null;
     lastCloseCode: number | null;
+    /** Why dialing stopped, when the far side refused us for good (CLOSE_RULES); null otherwise. */
+    outcome: CloseOutcome | null;
 }
 interface RequestOptions {
     signal?: AbortSignal;
     timeoutMs?: number;
+    /**
+     * Called with the request's id before it is sent, so progress events for it (e.g.
+     * `models.progress`, whose payload carries `request_id`) can be matched to this call.
+     */
+    onRequestId?: (id: string) => void;
 }
 type StreamOpName = {
     [N in OpName]: (typeof OPS)[N]["kind"] extends "unary" ? never : N;

package/dist/react.d.ts

@@ -7,7 +7,7 @@ import { z } from 'zod';
  * never drift (see the `_assert*` lines there).
  */
 type ErrorCodeName = "AUTH_REQUIRED" | "AUTH_INVALID" | "AUTH_EXPIRED" | "AUTH_FORBIDDEN" | "AUTH_DEVICE_REVOKED" | "PERMISSION_DENIED_OS" | "NOT_FOUND" | "CONFLICT" | "INVALID_PARAMS" | "RESOURCE_BUSY" | "RESOURCE_GONE" | "CANCELLED" | "TIMEOUT" | "PLATFORM_UNSUPPORTED" | "RATE_LIMITED" | "INTERNAL" | "PROTOCOL_VERSION_UNSUPPORTED" | "PROTOCOL_ERROR" | "UNKNOWN_OPERATION" | "DEVICE_OFFLINE" | "PAYLOAD_TOO_LARGE";
-type ErrorReasonName = "not_a_directory" | "is_a_directory" | "directory_not_empty" | "already_exists" | "stale_write" | "binary_content" | "not_utf8_boundary" | "patch_no_match" | "patch_ambiguous" | "resource_exited" | "resource_expired" | "control_taken" | "window_exhausted";
+type ErrorReasonName = "not_a_directory" | "is_a_directory" | "directory_not_empty" | "already_exists" | "stale_write" | "binary_content" | "not_utf8_boundary" | "patch_no_match" | "patch_ambiguous" | "resource_exited" | "resource_expired" | "control_taken" | "window_exhausted" | "runtime_not_installed" | "model_not_installed" | "unsupported_media" | "download_failed" | "service_starting" | "service_restarted" | "service_failed";
 interface ErrorData {
     reason?: ErrorReasonName | undefined;
     cap?: string | undefined;
@@ -23,6 +23,23 @@ interface ErrorData {
     } | undefined;
 }
 
+/**
+ * What a connecting side does after each WebSocket close — the ONE table every client reads (the
+ * package client, the desktop's relay transport, any other dialer). Never keep a local list of
+ * "terminal" codes: a code added to CloseCode without a rule here fails to compile.
+ *
+ *   reconnect_now  the far side went away on purpose or the socket died; dial again at once if the
+ *                  connection had opened, with backoff otherwise (a dead network never spins).
+ *   reconnect      transient refusal; dial again with backoff.
+ *   reauth         the token was refused; get a FRESH token and dial once more. A second refusal in
+ *                  a row (no successful open between) is terminal with outcome "signed_out".
+ *   stop           retrying cannot help: stop dialing until something changes (a new sign-in, a
+ *                  new device, an update) and show the outcome.
+ */
+
+/** The one state a person is shown when dialing stops. */
+type CloseOutcome = "signed_out" | "not_owned" | "removed" | "revoked" | "replaced" | "upgrade_required";
+
 /**
  * The one error type every package entry throws. It carries the wire ErrorCode (SPEC §5), so a
  * caller branches on `code`/`retryable`/`data.reason` and never parses a message. Zod-free on
@@ -755,6 +772,261 @@ declare const OPS: {
         readonly since: "1.0";
         readonly errors: readonly ["INTERNAL"];
     };
+    readonly "models.status": {
+        readonly params: z.ZodObject<{}, z.core.$strict>;
+        readonly result: z.ZodObject<{
+            service: z.ZodObject<{
+                state: z.ZodEnum<{
+                    starting: "starting";
+                    ready: "ready";
+                    restarting: "restarting";
+                    failed: "failed";
+                    stopped: "stopped";
+                }>;
+                pid: z.ZodNullable<z.ZodInt>;
+                restarts: z.ZodInt;
+                python: z.ZodNullable<z.ZodString>;
+                error: z.ZodNullable<z.ZodString>;
+            }, z.core.$strict>;
+            transcription: z.ZodNullable<z.ZodObject<{
+                runtime: z.ZodEnum<{
+                    failed: "failed";
+                    not_installed: "not_installed";
+                    installing: "installing";
+                    installed: "installed";
+                }>;
+                install: z.ZodNullable<z.ZodObject<{
+                    phase: z.ZodEnum<{
+                        model: "model";
+                        packages: "packages";
+                        verifying: "verifying";
+                    }>;
+                    item: z.ZodString;
+                    bytes_done: z.ZodInt;
+                    bytes_total: z.ZodNullable<z.ZodInt>;
+                }, z.core.$strict>>;
+                error: z.ZodNullable<z.ZodString>;
+                accelerator: z.ZodEnum<{
+                    cpu: "cpu";
+                    cuda: "cuda";
+                }>;
+                models: z.ZodArray<z.ZodObject<{
+                    id: z.ZodEnum<{
+                        base: "base";
+                        small: "small";
+                        tiny: "tiny";
+                        "large-v3-turbo": "large-v3-turbo";
+                    }>;
+                    size_bytes: z.ZodInt;
+                    multilingual: z.ZodBoolean;
+                    installed: z.ZodBoolean;
+                }, z.core.$strict>>;
+                default_model: z.ZodEnum<{
+                    base: "base";
+                    small: "small";
+                    tiny: "tiny";
+                    "large-v3-turbo": "large-v3-turbo";
+                }>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+        readonly kind: "unary";
+        readonly since: "1.2";
+        readonly errors: readonly ["INTERNAL"];
+    };
+    readonly "models.install": {
+        readonly params: z.ZodObject<{
+            model: z.ZodOptional<z.ZodEnum<{
+                base: "base";
+                small: "small";
+                tiny: "tiny";
+                "large-v3-turbo": "large-v3-turbo";
+            }>>;
+        }, z.core.$strict>;
+        readonly result: z.ZodObject<{
+            model: z.ZodEnum<{
+                base: "base";
+                small: "small";
+                tiny: "tiny";
+                "large-v3-turbo": "large-v3-turbo";
+            }>;
+            elapsed_ms: z.ZodInt;
+        }, z.core.$strict>;
+        readonly kind: "unary";
+        readonly since: "1.2";
+        readonly errors: readonly ["RESOURCE_BUSY", "RESOURCE_GONE", "TIMEOUT", "CANCELLED", "INTERNAL"];
+    };
+    readonly "models.transcribe": {
+        readonly params: z.ZodObject<{
+            path: z.ZodString;
+            model: z.ZodOptional<z.ZodEnum<{
+                base: "base";
+                small: "small";
+                tiny: "tiny";
+                "large-v3-turbo": "large-v3-turbo";
+            }>>;
+            language: z.ZodOptional<z.ZodString>;
+            task: z.ZodDefault<z.ZodEnum<{
+                transcribe: "transcribe";
+                translate: "translate";
+            }>>;
+        }, z.core.$strict>;
+        readonly result: z.ZodObject<{
+            text: z.ZodString;
+            language: z.ZodString;
+            language_probability: z.ZodNumber;
+            duration_s: z.ZodNumber;
+            model: z.ZodEnum<{
+                base: "base";
+                small: "small";
+                tiny: "tiny";
+                "large-v3-turbo": "large-v3-turbo";
+            }>;
+            segments: z.ZodArray<z.ZodObject<{
+                start_s: z.ZodNumber;
+                end_s: z.ZodNumber;
+                text: z.ZodString;
+            }, z.core.$strict>>;
+            elapsed_ms: z.ZodInt;
+        }, z.core.$strict>;
+        readonly kind: "unary";
+        readonly since: "1.2";
+        readonly errors: readonly ["NOT_FOUND", "INVALID_PARAMS", "PERMISSION_DENIED_OS", "RESOURCE_BUSY", "RESOURCE_GONE", "CANCELLED", "PAYLOAD_TOO_LARGE", "INTERNAL"];
+    };
+    readonly "apps.list": {
+        readonly params: z.ZodObject<{}, z.core.$strict>;
+        readonly result: z.ZodObject<{
+            apps: z.ZodArray<z.ZodObject<{
+                app_key: z.ZodString;
+                name: z.ZodString;
+                installed: z.ZodBoolean;
+                version: z.ZodNullable<z.ZodString>;
+                location: z.ZodNullable<z.ZodString>;
+                open: z.ZodObject<{
+                    status: z.ZodEnum<{
+                        supported: "supported";
+                        partial: "partial";
+                        unsupported: "unsupported";
+                    }>;
+                    reason: z.ZodNullable<z.ZodString>;
+                }, z.core.$strict>;
+                profiles: z.ZodObject<{
+                    status: z.ZodEnum<{
+                        supported: "supported";
+                        partial: "partial";
+                        unsupported: "unsupported";
+                    }>;
+                    reason: z.ZodNullable<z.ZodString>;
+                }, z.core.$strict>;
+                usage: z.ZodObject<{
+                    status: z.ZodEnum<{
+                        supported: "supported";
+                        partial: "partial";
+                        unsupported: "unsupported";
+                    }>;
+                    reason: z.ZodNullable<z.ZodString>;
+                }, z.core.$strict>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+        readonly kind: "unary";
+        readonly since: "1.2";
+        readonly errors: readonly ["INTERNAL"];
+    };
+    readonly "apps.profiles.list": {
+        readonly params: z.ZodObject<{
+            app_key: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        readonly result: z.ZodObject<{
+            profiles: z.ZodArray<z.ZodObject<{
+                id: z.ZodNullable<z.ZodString>;
+                app_key: z.ZodString;
+                display_name: z.ZodString;
+                account_identity: z.ZodNullable<z.ZodString>;
+                profile_locator: z.ZodNullable<z.ZodString>;
+                device_id: z.ZodNullable<z.ZodString>;
+                folder: z.ZodNullable<z.ZodString>;
+                on_disk: z.ZodBoolean;
+                running: z.ZodNullable<z.ZodBoolean>;
+                usage: z.ZodNullable<z.ZodArray<z.ZodObject<{
+                    window: z.ZodEnum<{
+                        five_hour: "five_hour";
+                        weekly: "weekly";
+                        extra: "extra";
+                    }>;
+                    percent: z.ZodNumber;
+                    sampled_at_ms: z.ZodInt;
+                    reset_since: z.ZodBoolean;
+                }, z.core.$strict>>>;
+                last_opened_ms: z.ZodNullable<z.ZodInt>;
+            }, z.core.$strict>>;
+            registry: z.ZodEnum<{
+                ok: "ok";
+                signed_out: "signed_out";
+                unavailable: "unavailable";
+            }>;
+        }, z.core.$strict>;
+        readonly kind: "unary";
+        readonly since: "1.2";
+        readonly errors: readonly ["NOT_FOUND", "INVALID_PARAMS", "INTERNAL"];
+    };
+    readonly "apps.profiles.save": {
+        readonly params: z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            app_key: z.ZodString;
+            display_name: z.ZodString;
+            account_identity: z.ZodNullable<z.ZodString>;
+            profile_locator: z.ZodNullable<z.ZodString>;
+            new_folder: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strict>;
+        readonly result: z.ZodObject<{
+            id: z.ZodNullable<z.ZodString>;
+            app_key: z.ZodString;
+            display_name: z.ZodString;
+            account_identity: z.ZodNullable<z.ZodString>;
+            profile_locator: z.ZodNullable<z.ZodString>;
+            device_id: z.ZodNullable<z.ZodString>;
+            folder: z.ZodNullable<z.ZodString>;
+            on_disk: z.ZodBoolean;
+            running: z.ZodNullable<z.ZodBoolean>;
+            usage: z.ZodNullable<z.ZodArray<z.ZodObject<{
+                window: z.ZodEnum<{
+                    five_hour: "five_hour";
+                    weekly: "weekly";
+                    extra: "extra";
+                }>;
+                percent: z.ZodNumber;
+                sampled_at_ms: z.ZodInt;
+                reset_since: z.ZodBoolean;
+            }, z.core.$strict>>>;
+            last_opened_ms: z.ZodNullable<z.ZodInt>;
+        }, z.core.$strict>;
+        readonly kind: "unary";
+        readonly since: "1.2";
+        readonly errors: readonly ["AUTH_REQUIRED", "AUTH_FORBIDDEN", "NOT_FOUND", "INVALID_PARAMS", "CONFLICT", "PLATFORM_UNSUPPORTED", "DEVICE_OFFLINE", "INTERNAL"];
+    };
+    readonly "apps.profiles.remove": {
+        readonly params: z.ZodObject<{
+            id: z.ZodString;
+        }, z.core.$strict>;
+        readonly result: z.ZodObject<{
+            removed: z.ZodBoolean;
+        }, z.core.$strict>;
+        readonly kind: "unary";
+        readonly since: "1.2";
+        readonly errors: readonly ["AUTH_REQUIRED", "AUTH_FORBIDDEN", "NOT_FOUND", "DEVICE_OFFLINE", "INTERNAL"];
+    };
+    readonly "apps.open": {
+        readonly params: z.ZodObject<{
+            app_key: z.ZodString;
+            profile_id: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        readonly result: z.ZodObject<{
+            already_running: z.ZodBoolean;
+            folder: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>;
+        readonly kind: "unary";
+        readonly since: "1.2";
+        readonly errors: readonly ["NOT_FOUND", "PLATFORM_UNSUPPORTED", "AUTH_REQUIRED", "DEVICE_OFFLINE", "INTERNAL"];
+    };
 };
 type OpName = keyof typeof OPS;
 type OpParams<N extends OpName> = z.input<(typeof OPS)[N]["params"]>;
@@ -806,6 +1078,31 @@ declare const EVENTS: {
             read_only: "read_only";
         }>;
     }, z.core.$strict>;
+    readonly "models.progress": z.ZodObject<{
+        request_id: z.ZodString;
+        progress: z.ZodObject<{
+            kind: z.ZodEnum<{
+                install: "install";
+                transcribe: "transcribe";
+            }>;
+            fraction: z.ZodNullable<z.ZodNumber>;
+            install: z.ZodNullable<z.ZodObject<{
+                phase: z.ZodEnum<{
+                    model: "model";
+                    packages: "packages";
+                    verifying: "verifying";
+                }>;
+                item: z.ZodString;
+                bytes_done: z.ZodInt;
+                bytes_total: z.ZodNullable<z.ZodInt>;
+            }, z.core.$strict>>;
+            segment: z.ZodNullable<z.ZodObject<{
+                start_s: z.ZodNumber;
+                end_s: z.ZodNumber;
+                text: z.ZodString;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
     readonly "relay.device_status": z.ZodObject<{
         online: z.ZodBoolean;
         since_ms: z.ZodNullable<z.ZodInt>;
@@ -839,10 +1136,17 @@ interface DesktopClientState {
     retryInMs: number | null;
     lastError: DesktopProtocolError | null;
     lastCloseCode: number | null;
+    /** Why dialing stopped, when the far side refused us for good (CLOSE_RULES); null otherwise. */
+    outcome: CloseOutcome | null;
 }
 interface RequestOptions {
     signal?: AbortSignal;
     timeoutMs?: number;
+    /**
+     * Called with the request's id before it is sent, so progress events for it (e.g.
+     * `models.progress`, whose payload carries `request_id`) can be matched to this call.
+     */
+    onRequestId?: (id: string) => void;
 }
 type StreamOpName = {
     [N in OpName]: (typeof OPS)[N]["kind"] extends "unary" ? never : N;