@ai-matrx/desktop-protocol 0.6.0 → 0.10.0

package/dist/{registry-jTmq1CsI.d.ts → registry-B3NqARgh.d.ts}

@@ -6,7 +6,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;
@@ -22,6 +22,96 @@ 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.
+ */
+
+type CloseAction = "reconnect_now" | "reconnect" | "reauth" | "stop";
+/** The one state a person is shown when dialing stops. */
+type CloseOutcome = "signed_out" | "not_owned" | "removed" | "revoked" | "replaced" | "upgrade_required";
+interface CloseRule {
+    readonly action: CloseAction;
+    /** Set for `stop` and `reauth` (the outcome when the fresh token is refused too). */
+    readonly outcome?: CloseOutcome;
+    /** The error a caller's pending work is failed with. */
+    readonly error: readonly [ErrorCodeName, string];
+}
+declare const CLOSE_RULES: {
+    readonly 1000: {
+        readonly action: "reconnect";
+        readonly error: readonly ["DEVICE_OFFLINE", "Connection closed"];
+    };
+    readonly 1001: {
+        readonly action: "reconnect_now";
+        readonly error: readonly ["DEVICE_OFFLINE", "Connection lost"];
+    };
+    readonly 1006: {
+        readonly action: "reconnect_now";
+        readonly error: readonly ["DEVICE_OFFLINE", "Connection lost"];
+    };
+    readonly 1012: {
+        readonly action: "reconnect_now";
+        readonly error: readonly ["DEVICE_OFFLINE", "Device reconnected"];
+    };
+    readonly 1013: {
+        readonly action: "reconnect";
+        readonly error: readonly ["DEVICE_OFFLINE", "Relay busy; retrying"];
+    };
+    readonly 4001: {
+        readonly action: "reauth";
+        readonly outcome: "signed_out";
+        readonly error: readonly ["AUTH_INVALID", "Sign-in was not accepted"];
+    };
+    readonly 4003: {
+        readonly action: "stop";
+        readonly outcome: "not_owned";
+        readonly error: readonly ["AUTH_FORBIDDEN", "Not this device's owner"];
+    };
+    readonly 4004: {
+        readonly action: "stop";
+        readonly outcome: "removed";
+        readonly error: readonly ["NOT_FOUND", "Device not found"];
+    };
+    readonly 4008: {
+        readonly action: "reauth";
+        readonly outcome: "signed_out";
+        readonly error: readonly ["AUTH_EXPIRED", "Sign-in expired"];
+    };
+    readonly 4009: {
+        readonly action: "stop";
+        readonly outcome: "replaced";
+        readonly error: readonly ["CONFLICT", "Replaced by a newer connection"];
+    };
+    readonly 4010: {
+        readonly action: "stop";
+        readonly outcome: "revoked";
+        readonly error: readonly ["AUTH_DEVICE_REVOKED", "This device was revoked"];
+    };
+    readonly 4400: {
+        readonly action: "reconnect";
+        readonly error: readonly ["PROTOCOL_ERROR", "Connection reset by the relay"];
+    };
+    readonly 4426: {
+        readonly action: "stop";
+        readonly outcome: "upgrade_required";
+        readonly error: readonly ["PROTOCOL_VERSION_UNSUPPORTED", "Protocol upgrade required"];
+    };
+};
+/** The rule for any close code; one this table does not know (or null: no close frame) reconnects with backoff. */
+declare function closeRule(code: number | null | undefined): CloseRule;
+/** True when dialing must stop after this close (no retry will help). */
+declare function isTerminalClose(code: number | null | undefined): boolean;
+
 /**
  * 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
@@ -205,6 +295,13 @@ declare const ErrorMsg: z.ZodObject<{
                 resource_expired: "resource_expired";
                 control_taken: "control_taken";
                 window_exhausted: "window_exhausted";
+                runtime_not_installed: "runtime_not_installed";
+                model_not_installed: "model_not_installed";
+                unsupported_media: "unsupported_media";
+                download_failed: "download_failed";
+                service_starting: "service_starting";
+                service_restarted: "service_restarted";
+                service_failed: "service_failed";
             }>>;
             cap: z.ZodOptional<z.ZodString>;
             op: z.ZodOptional<z.ZodString>;
@@ -383,6 +480,13 @@ declare const CoreToClientMsg: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 resource_expired: "resource_expired";
                 control_taken: "control_taken";
                 window_exhausted: "window_exhausted";
+                runtime_not_installed: "runtime_not_installed";
+                model_not_installed: "model_not_installed";
+                unsupported_media: "unsupported_media";
+                download_failed: "download_failed";
+                service_starting: "service_starting";
+                service_restarted: "service_restarted";
+                service_failed: "service_failed";
             }>>;
             cap: z.ZodOptional<z.ZodString>;
             op: z.ZodOptional<z.ZodString>;
@@ -484,6 +588,13 @@ declare const ErrorReason: z.ZodEnum<{
     resource_expired: "resource_expired";
     control_taken: "control_taken";
     window_exhausted: "window_exhausted";
+    runtime_not_installed: "runtime_not_installed";
+    model_not_installed: "model_not_installed";
+    unsupported_media: "unsupported_media";
+    download_failed: "download_failed";
+    service_starting: "service_starting";
+    service_restarted: "service_restarted";
+    service_failed: "service_failed";
 }>;
 type ErrorReason = z.output<typeof ErrorReason>;
 declare const ProtocolErrorBody: z.ZodObject<{
@@ -527,6 +638,13 @@ declare const ProtocolErrorBody: z.ZodObject<{
             resource_expired: "resource_expired";
             control_taken: "control_taken";
             window_exhausted: "window_exhausted";
+            runtime_not_installed: "runtime_not_installed";
+            model_not_installed: "model_not_installed";
+            unsupported_media: "unsupported_media";
+            download_failed: "download_failed";
+            service_starting: "service_starting";
+            service_restarted: "service_restarted";
+            service_failed: "service_failed";
         }>>;
         cap: z.ZodOptional<z.ZodString>;
         op: z.ZodOptional<z.ZodString>;
@@ -563,7 +681,7 @@ type OpSpec = {
     readonly params: z.ZodType;
     readonly result: z.ZodType;
     readonly kind: "unary" | "stream" | "resource";
-    readonly since: "1.0";
+    readonly since: "1.0" | "1.2";
     readonly errors: readonly z.infer<typeof ErrorCode>[];
 };
 declare const OPS: {
@@ -1194,6 +1312,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<{
+                    failed: "failed";
+                    starting: "starting";
+                    ready: "ready";
+                    restarting: "restarting";
+                    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<{
+                    not_installed: "not_installed";
+                    installing: "installing";
+                    installed: "installed";
+                    failed: "failed";
+                }>;
+                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<{
+                        tiny: "tiny";
+                        base: "base";
+                        small: "small";
+                        "large-v3-turbo": "large-v3-turbo";
+                    }>;
+                    size_bytes: z.ZodInt;
+                    multilingual: z.ZodBoolean;
+                    installed: z.ZodBoolean;
+                }, z.core.$strict>>;
+                default_model: z.ZodEnum<{
+                    tiny: "tiny";
+                    base: "base";
+                    small: "small";
+                    "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<{
+                tiny: "tiny";
+                base: "base";
+                small: "small";
+                "large-v3-turbo": "large-v3-turbo";
+            }>>;
+        }, z.core.$strict>;
+        readonly result: z.ZodObject<{
+            model: z.ZodEnum<{
+                tiny: "tiny";
+                base: "base";
+                small: "small";
+                "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<{
+                tiny: "tiny";
+                base: "base";
+                small: "small";
+                "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<{
+                tiny: "tiny";
+                base: "base";
+                small: "small";
+                "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"]>;
@@ -1245,6 +1618,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>;
@@ -1256,6 +1654,146 @@ declare const EVENTS: {
     }, z.core.$strict>;
 };
 type EventName = keyof typeof EVENTS;
+/**
+ * Supervised Python services (SPEC §3.10) and the ops each serves over its local socket
+ * (src/schema/service.ts). The Python side's handler protocol, op table and models are generated
+ * from this table (scripts/gen_pydantic.py); the core's service client is typed by it. A Router
+ * op that a capability owner forwards uses the same params/result schemas as its service op.
+ */
+type ServiceOpSpec = {
+    readonly params: z.ZodType;
+    readonly result: z.ZodType;
+};
+type ServiceSpec = {
+    readonly progress: z.ZodType;
+    readonly ops: Readonly<Record<string, ServiceOpSpec>>;
+};
+declare const SERVICES: {
+    readonly ml: {
+        readonly 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>;
+        readonly ops: {
+            readonly "ml.status": {
+                readonly params: z.ZodObject<{}, z.core.$strict>;
+                readonly result: z.ZodObject<{
+                    runtime: z.ZodEnum<{
+                        not_installed: "not_installed";
+                        installing: "installing";
+                        installed: "installed";
+                        failed: "failed";
+                    }>;
+                    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<{
+                            tiny: "tiny";
+                            base: "base";
+                            small: "small";
+                            "large-v3-turbo": "large-v3-turbo";
+                        }>;
+                        size_bytes: z.ZodInt;
+                        multilingual: z.ZodBoolean;
+                        installed: z.ZodBoolean;
+                    }, z.core.$strict>>;
+                    default_model: z.ZodEnum<{
+                        tiny: "tiny";
+                        base: "base";
+                        small: "small";
+                        "large-v3-turbo": "large-v3-turbo";
+                    }>;
+                }, z.core.$strict>;
+            };
+            readonly "ml.install": {
+                readonly params: z.ZodObject<{
+                    model: z.ZodOptional<z.ZodEnum<{
+                        tiny: "tiny";
+                        base: "base";
+                        small: "small";
+                        "large-v3-turbo": "large-v3-turbo";
+                    }>>;
+                }, z.core.$strict>;
+                readonly result: z.ZodObject<{
+                    model: z.ZodEnum<{
+                        tiny: "tiny";
+                        base: "base";
+                        small: "small";
+                        "large-v3-turbo": "large-v3-turbo";
+                    }>;
+                    elapsed_ms: z.ZodInt;
+                }, z.core.$strict>;
+            };
+            readonly "ml.transcribe": {
+                readonly params: z.ZodObject<{
+                    path: z.ZodString;
+                    model: z.ZodOptional<z.ZodEnum<{
+                        tiny: "tiny";
+                        base: "base";
+                        small: "small";
+                        "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<{
+                        tiny: "tiny";
+                        base: "base";
+                        small: "small";
+                        "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>;
+            };
+        };
+    };
+};
+type ServiceId = keyof typeof SERVICES;
+type ServiceOpName<S extends ServiceId> = keyof (typeof SERVICES)[S]["ops"] & string;
 /**
  * Every schema that lands in the generated JSON Schema `$defs` under a stable name (and so becomes a
  * named Pydantic model). Order is the emission order. A test asserts every exported schema of
@@ -1306,6 +1844,13 @@ declare const NAMED_SCHEMAS: {
         resource_expired: "resource_expired";
         control_taken: "control_taken";
         window_exhausted: "window_exhausted";
+        runtime_not_installed: "runtime_not_installed";
+        model_not_installed: "model_not_installed";
+        unsupported_media: "unsupported_media";
+        download_failed: "download_failed";
+        service_starting: "service_starting";
+        service_restarted: "service_restarted";
+        service_failed: "service_failed";
     }>;
     readonly FsPatchEditFailure: z.ZodObject<{
         edit_index: z.ZodInt;
@@ -1352,6 +1897,13 @@ declare const NAMED_SCHEMAS: {
                 resource_expired: "resource_expired";
                 control_taken: "control_taken";
                 window_exhausted: "window_exhausted";
+                runtime_not_installed: "runtime_not_installed";
+                model_not_installed: "model_not_installed";
+                unsupported_media: "unsupported_media";
+                download_failed: "download_failed";
+                service_starting: "service_starting";
+                service_restarted: "service_restarted";
+                service_failed: "service_failed";
             }>>;
             cap: z.ZodOptional<z.ZodString>;
             op: z.ZodOptional<z.ZodString>;
@@ -1492,6 +2044,13 @@ declare const NAMED_SCHEMAS: {
                     resource_expired: "resource_expired";
                     control_taken: "control_taken";
                     window_exhausted: "window_exhausted";
+                    runtime_not_installed: "runtime_not_installed";
+                    model_not_installed: "model_not_installed";
+                    unsupported_media: "unsupported_media";
+                    download_failed: "download_failed";
+                    service_starting: "service_starting";
+                    service_restarted: "service_restarted";
+                    service_failed: "service_failed";
                 }>>;
                 cap: z.ZodOptional<z.ZodString>;
                 op: z.ZodOptional<z.ZodString>;
@@ -1658,6 +2217,13 @@ declare const NAMED_SCHEMAS: {
                     resource_expired: "resource_expired";
                     control_taken: "control_taken";
                     window_exhausted: "window_exhausted";
+                    runtime_not_installed: "runtime_not_installed";
+                    model_not_installed: "model_not_installed";
+                    unsupported_media: "unsupported_media";
+                    download_failed: "download_failed";
+                    service_starting: "service_starting";
+                    service_restarted: "service_restarted";
+                    service_failed: "service_failed";
                 }>>;
                 cap: z.ZodOptional<z.ZodString>;
                 op: z.ZodOptional<z.ZodString>;
@@ -2329,6 +2895,493 @@ declare const NAMED_SCHEMAS: {
             read_only: "read_only";
         }>;
     }, z.core.$strict>;
+    readonly TranscriptionModelId: z.ZodEnum<{
+        tiny: "tiny";
+        base: "base";
+        small: "small";
+        "large-v3-turbo": "large-v3-turbo";
+    }>;
+    readonly MlRuntimeState: z.ZodEnum<{
+        not_installed: "not_installed";
+        installing: "installing";
+        installed: "installed";
+        failed: "failed";
+    }>;
+    readonly MlInstallPhase: z.ZodEnum<{
+        model: "model";
+        packages: "packages";
+        verifying: "verifying";
+    }>;
+    readonly MlInstallProgress: 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>;
+    readonly TranscriptionModelInfo: z.ZodObject<{
+        id: z.ZodEnum<{
+            tiny: "tiny";
+            base: "base";
+            small: "small";
+            "large-v3-turbo": "large-v3-turbo";
+        }>;
+        size_bytes: z.ZodInt;
+        multilingual: z.ZodBoolean;
+        installed: z.ZodBoolean;
+    }, z.core.$strict>;
+    readonly TranscriptSegment: z.ZodObject<{
+        start_s: z.ZodNumber;
+        end_s: z.ZodNumber;
+        text: z.ZodString;
+    }, z.core.$strict>;
+    readonly MlStatusParams: z.ZodObject<{}, z.core.$strict>;
+    readonly MlStatusResult: z.ZodObject<{
+        runtime: z.ZodEnum<{
+            not_installed: "not_installed";
+            installing: "installing";
+            installed: "installed";
+            failed: "failed";
+        }>;
+        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<{
+                tiny: "tiny";
+                base: "base";
+                small: "small";
+                "large-v3-turbo": "large-v3-turbo";
+            }>;
+            size_bytes: z.ZodInt;
+            multilingual: z.ZodBoolean;
+            installed: z.ZodBoolean;
+        }, z.core.$strict>>;
+        default_model: z.ZodEnum<{
+            tiny: "tiny";
+            base: "base";
+            small: "small";
+            "large-v3-turbo": "large-v3-turbo";
+        }>;
+    }, z.core.$strict>;
+    readonly ModelsInstallParams: z.ZodObject<{
+        model: z.ZodOptional<z.ZodEnum<{
+            tiny: "tiny";
+            base: "base";
+            small: "small";
+            "large-v3-turbo": "large-v3-turbo";
+        }>>;
+    }, z.core.$strict>;
+    readonly ModelsInstallResult: z.ZodObject<{
+        model: z.ZodEnum<{
+            tiny: "tiny";
+            base: "base";
+            small: "small";
+            "large-v3-turbo": "large-v3-turbo";
+        }>;
+        elapsed_ms: z.ZodInt;
+    }, z.core.$strict>;
+    readonly ModelsTranscribeParams: z.ZodObject<{
+        path: z.ZodString;
+        model: z.ZodOptional<z.ZodEnum<{
+            tiny: "tiny";
+            base: "base";
+            small: "small";
+            "large-v3-turbo": "large-v3-turbo";
+        }>>;
+        language: z.ZodOptional<z.ZodString>;
+        task: z.ZodDefault<z.ZodEnum<{
+            transcribe: "transcribe";
+            translate: "translate";
+        }>>;
+    }, z.core.$strict>;
+    readonly ModelsTranscribeResult: z.ZodObject<{
+        text: z.ZodString;
+        language: z.ZodString;
+        language_probability: z.ZodNumber;
+        duration_s: z.ZodNumber;
+        model: z.ZodEnum<{
+            tiny: "tiny";
+            base: "base";
+            small: "small";
+            "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 MlProgress: 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>;
+    readonly MlServiceState: z.ZodEnum<{
+        failed: "failed";
+        starting: "starting";
+        ready: "ready";
+        restarting: "restarting";
+        stopped: "stopped";
+    }>;
+    readonly MlServiceStatus: z.ZodObject<{
+        state: z.ZodEnum<{
+            failed: "failed";
+            starting: "starting";
+            ready: "ready";
+            restarting: "restarting";
+            stopped: "stopped";
+        }>;
+        pid: z.ZodNullable<z.ZodInt>;
+        restarts: z.ZodInt;
+        python: z.ZodNullable<z.ZodString>;
+        error: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
+    readonly ModelsStatusParams: z.ZodObject<{}, z.core.$strict>;
+    readonly ModelsStatusResult: z.ZodObject<{
+        service: z.ZodObject<{
+            state: z.ZodEnum<{
+                failed: "failed";
+                starting: "starting";
+                ready: "ready";
+                restarting: "restarting";
+                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<{
+                not_installed: "not_installed";
+                installing: "installing";
+                installed: "installed";
+                failed: "failed";
+            }>;
+            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<{
+                    tiny: "tiny";
+                    base: "base";
+                    small: "small";
+                    "large-v3-turbo": "large-v3-turbo";
+                }>;
+                size_bytes: z.ZodInt;
+                multilingual: z.ZodBoolean;
+                installed: z.ZodBoolean;
+            }, z.core.$strict>>;
+            default_model: z.ZodEnum<{
+                tiny: "tiny";
+                base: "base";
+                small: "small";
+                "large-v3-turbo": "large-v3-turbo";
+            }>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    readonly ModelsProgressEvent: 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 ServiceName: z.ZodEnum<{
+        ml: "ml";
+    }>;
+    readonly ContractHash: z.ZodString;
+    readonly ServiceToken: z.ZodString;
+    readonly ServiceHello: z.ZodObject<{
+        type: z.ZodLiteral<"hello">;
+        token: z.ZodString;
+        contract: z.ZodString;
+    }, z.core.$strict>;
+    readonly ServiceWelcome: z.ZodObject<{
+        type: z.ZodLiteral<"welcome">;
+        service: z.ZodEnum<{
+            ml: "ml";
+        }>;
+        contract: z.ZodString;
+        pid: z.ZodInt;
+        python: z.ZodString;
+        ops: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+    readonly ServiceRequest: z.ZodObject<{
+        type: z.ZodLiteral<"request">;
+        id: z.ZodInt;
+        op: z.ZodString;
+        params: z.ZodUnknown;
+    }, z.core.$strict>;
+    readonly ServiceResponse: z.ZodObject<{
+        type: z.ZodLiteral<"response">;
+        id: z.ZodInt;
+        result: z.ZodUnknown;
+    }, z.core.$strict>;
+    readonly ServiceErrorMsg: z.ZodObject<{
+        type: z.ZodLiteral<"error">;
+        id: z.ZodInt;
+        error: z.ZodObject<{
+            code: z.ZodEnum<{
+                AUTH_REQUIRED: "AUTH_REQUIRED";
+                AUTH_INVALID: "AUTH_INVALID";
+                AUTH_EXPIRED: "AUTH_EXPIRED";
+                AUTH_FORBIDDEN: "AUTH_FORBIDDEN";
+                AUTH_DEVICE_REVOKED: "AUTH_DEVICE_REVOKED";
+                PERMISSION_DENIED_OS: "PERMISSION_DENIED_OS";
+                NOT_FOUND: "NOT_FOUND";
+                CONFLICT: "CONFLICT";
+                INVALID_PARAMS: "INVALID_PARAMS";
+                RESOURCE_BUSY: "RESOURCE_BUSY";
+                RESOURCE_GONE: "RESOURCE_GONE";
+                CANCELLED: "CANCELLED";
+                TIMEOUT: "TIMEOUT";
+                PLATFORM_UNSUPPORTED: "PLATFORM_UNSUPPORTED";
+                RATE_LIMITED: "RATE_LIMITED";
+                INTERNAL: "INTERNAL";
+                PROTOCOL_VERSION_UNSUPPORTED: "PROTOCOL_VERSION_UNSUPPORTED";
+                PROTOCOL_ERROR: "PROTOCOL_ERROR";
+                UNKNOWN_OPERATION: "UNKNOWN_OPERATION";
+                DEVICE_OFFLINE: "DEVICE_OFFLINE";
+                PAYLOAD_TOO_LARGE: "PAYLOAD_TOO_LARGE";
+            }>;
+            message: z.ZodString;
+            retryable: z.ZodBoolean;
+            data: z.ZodOptional<z.ZodObject<{
+                reason: z.ZodOptional<z.ZodEnum<{
+                    not_a_directory: "not_a_directory";
+                    is_a_directory: "is_a_directory";
+                    directory_not_empty: "directory_not_empty";
+                    already_exists: "already_exists";
+                    stale_write: "stale_write";
+                    binary_content: "binary_content";
+                    not_utf8_boundary: "not_utf8_boundary";
+                    patch_no_match: "patch_no_match";
+                    patch_ambiguous: "patch_ambiguous";
+                    resource_exited: "resource_exited";
+                    resource_expired: "resource_expired";
+                    control_taken: "control_taken";
+                    window_exhausted: "window_exhausted";
+                    runtime_not_installed: "runtime_not_installed";
+                    model_not_installed: "model_not_installed";
+                    unsupported_media: "unsupported_media";
+                    download_failed: "download_failed";
+                    service_starting: "service_starting";
+                    service_restarted: "service_restarted";
+                    service_failed: "service_failed";
+                }>>;
+                cap: z.ZodOptional<z.ZodString>;
+                op: z.ZodOptional<z.ZodString>;
+                path: z.ZodOptional<z.ZodString>;
+                settings_url: z.ZodOptional<z.ZodString>;
+                retry_after_ms: z.ZodOptional<z.ZodInt>;
+                limit_bytes: z.ZodOptional<z.ZodInt>;
+                edits_failed: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    edit_index: z.ZodInt;
+                    reason: z.ZodString;
+                }, z.core.$strict>>>;
+                upgrade: z.ZodOptional<z.ZodObject<{
+                    min_version: z.ZodString;
+                    max_version: z.ZodString;
+                    download_url: z.ZodOptional<z.ZodURL>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    readonly ServiceProgressMsg: z.ZodObject<{
+        type: z.ZodLiteral<"progress">;
+        id: z.ZodInt;
+        progress: z.ZodUnknown;
+    }, z.core.$strict>;
+    readonly ServiceCancel: z.ZodObject<{
+        type: z.ZodLiteral<"cancel">;
+        id: z.ZodInt;
+    }, z.core.$strict>;
+    readonly ServicePing: z.ZodObject<{
+        type: z.ZodLiteral<"ping">;
+        id: z.ZodInt;
+    }, z.core.$strict>;
+    readonly ServicePong: z.ZodObject<{
+        type: z.ZodLiteral<"pong">;
+        id: z.ZodInt;
+        busy: z.ZodInt;
+    }, z.core.$strict>;
+    readonly ServiceShutdown: z.ZodObject<{
+        type: z.ZodLiteral<"shutdown">;
+    }, z.core.$strict>;
+    readonly CoreToServiceMsg: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"hello">;
+        token: z.ZodString;
+        contract: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"request">;
+        id: z.ZodInt;
+        op: z.ZodString;
+        params: z.ZodUnknown;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"cancel">;
+        id: z.ZodInt;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"ping">;
+        id: z.ZodInt;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"shutdown">;
+    }, z.core.$strict>], "type">;
+    readonly ServiceToCoreMsg: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"welcome">;
+        service: z.ZodEnum<{
+            ml: "ml";
+        }>;
+        contract: z.ZodString;
+        pid: z.ZodInt;
+        python: z.ZodString;
+        ops: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"response">;
+        id: z.ZodInt;
+        result: z.ZodUnknown;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"error">;
+        id: z.ZodInt;
+        error: z.ZodObject<{
+            code: z.ZodEnum<{
+                AUTH_REQUIRED: "AUTH_REQUIRED";
+                AUTH_INVALID: "AUTH_INVALID";
+                AUTH_EXPIRED: "AUTH_EXPIRED";
+                AUTH_FORBIDDEN: "AUTH_FORBIDDEN";
+                AUTH_DEVICE_REVOKED: "AUTH_DEVICE_REVOKED";
+                PERMISSION_DENIED_OS: "PERMISSION_DENIED_OS";
+                NOT_FOUND: "NOT_FOUND";
+                CONFLICT: "CONFLICT";
+                INVALID_PARAMS: "INVALID_PARAMS";
+                RESOURCE_BUSY: "RESOURCE_BUSY";
+                RESOURCE_GONE: "RESOURCE_GONE";
+                CANCELLED: "CANCELLED";
+                TIMEOUT: "TIMEOUT";
+                PLATFORM_UNSUPPORTED: "PLATFORM_UNSUPPORTED";
+                RATE_LIMITED: "RATE_LIMITED";
+                INTERNAL: "INTERNAL";
+                PROTOCOL_VERSION_UNSUPPORTED: "PROTOCOL_VERSION_UNSUPPORTED";
+                PROTOCOL_ERROR: "PROTOCOL_ERROR";
+                UNKNOWN_OPERATION: "UNKNOWN_OPERATION";
+                DEVICE_OFFLINE: "DEVICE_OFFLINE";
+                PAYLOAD_TOO_LARGE: "PAYLOAD_TOO_LARGE";
+            }>;
+            message: z.ZodString;
+            retryable: z.ZodBoolean;
+            data: z.ZodOptional<z.ZodObject<{
+                reason: z.ZodOptional<z.ZodEnum<{
+                    not_a_directory: "not_a_directory";
+                    is_a_directory: "is_a_directory";
+                    directory_not_empty: "directory_not_empty";
+                    already_exists: "already_exists";
+                    stale_write: "stale_write";
+                    binary_content: "binary_content";
+                    not_utf8_boundary: "not_utf8_boundary";
+                    patch_no_match: "patch_no_match";
+                    patch_ambiguous: "patch_ambiguous";
+                    resource_exited: "resource_exited";
+                    resource_expired: "resource_expired";
+                    control_taken: "control_taken";
+                    window_exhausted: "window_exhausted";
+                    runtime_not_installed: "runtime_not_installed";
+                    model_not_installed: "model_not_installed";
+                    unsupported_media: "unsupported_media";
+                    download_failed: "download_failed";
+                    service_starting: "service_starting";
+                    service_restarted: "service_restarted";
+                    service_failed: "service_failed";
+                }>>;
+                cap: z.ZodOptional<z.ZodString>;
+                op: z.ZodOptional<z.ZodString>;
+                path: z.ZodOptional<z.ZodString>;
+                settings_url: z.ZodOptional<z.ZodString>;
+                retry_after_ms: z.ZodOptional<z.ZodInt>;
+                limit_bytes: z.ZodOptional<z.ZodInt>;
+                edits_failed: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    edit_index: z.ZodInt;
+                    reason: z.ZodString;
+                }, z.core.$strict>>>;
+                upgrade: z.ZodOptional<z.ZodObject<{
+                    min_version: z.ZodString;
+                    max_version: z.ZodString;
+                    download_url: z.ZodOptional<z.ZodURL>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"progress">;
+        id: z.ZodInt;
+        progress: z.ZodUnknown;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"pong">;
+        id: z.ZodInt;
+        busy: z.ZodInt;
+    }, z.core.$strict>], "type">;
     readonly RelayDeviceStatusEvent: z.ZodObject<{
         online: z.ZodBoolean;
         since_ms: z.ZodNullable<z.ZodInt>;
@@ -2391,6 +3444,13 @@ declare const NAMED_SCHEMAS: {
                     resource_expired: "resource_expired";
                     control_taken: "control_taken";
                     window_exhausted: "window_exhausted";
+                    runtime_not_installed: "runtime_not_installed";
+                    model_not_installed: "model_not_installed";
+                    unsupported_media: "unsupported_media";
+                    download_failed: "download_failed";
+                    service_starting: "service_starting";
+                    service_restarted: "service_restarted";
+                    service_failed: "service_failed";
                 }>>;
                 cap: z.ZodOptional<z.ZodString>;
                 op: z.ZodOptional<z.ZodString>;
@@ -2442,7 +3502,258 @@ declare const NAMED_SCHEMAS: {
         seq: z.ZodLiteral<0>;
     }, z.core.$strict>;
     readonly CloseCodeValue: z.ZodLiteral<1000 | 1001 | 1006 | 1012 | 1013 | 4001 | 4003 | 4004 | 4008 | 4009 | 4010 | 4400 | 4426>;
+    readonly ToolLevel: z.ZodEnum<{
+        programmatic: "programmatic";
+        protocol: "protocol";
+        chat: "chat";
+    }>;
+    readonly ToolOutcome: z.ZodEnum<{
+        pass: "pass";
+        fail: "fail";
+        skip: "skip";
+    }>;
+    readonly ToolPlatform: z.ZodEnum<{
+        darwin: "darwin";
+        win32: "win32";
+        linux: "linux";
+    }>;
+    readonly ToolTransport: z.ZodEnum<{
+        relay: "relay";
+        in_process: "in_process";
+        localhost: "localhost";
+        agent: "agent";
+    }>;
+    readonly ToolName: z.ZodString;
+    readonly ToolLevelResult: z.ZodObject<{
+        tool: z.ZodString;
+        level: z.ZodEnum<{
+            programmatic: "programmatic";
+            protocol: "protocol";
+            chat: "chat";
+        }>;
+        platform: z.ZodEnum<{
+            darwin: "darwin";
+            win32: "win32";
+            linux: "linux";
+        }>;
+        transport: z.ZodEnum<{
+            relay: "relay";
+            in_process: "in_process";
+            localhost: "localhost";
+            agent: "agent";
+        }>;
+        outcome: z.ZodEnum<{
+            pass: "pass";
+            fail: "fail";
+            skip: "skip";
+        }>;
+        remote_network: z.ZodBoolean;
+        detail: z.ZodString;
+        suite: z.ZodString;
+        test: z.ZodString;
+        run_at_ms: z.ZodInt;
+    }, z.core.$strict>;
+    readonly ToolResultsFile: z.ZodObject<{
+        schema: z.ZodLiteral<"matrx.tool-results.v1">;
+        commit: z.ZodString;
+        results: z.ZodArray<z.ZodObject<{
+            tool: z.ZodString;
+            level: z.ZodEnum<{
+                programmatic: "programmatic";
+                protocol: "protocol";
+                chat: "chat";
+            }>;
+            platform: z.ZodEnum<{
+                darwin: "darwin";
+                win32: "win32";
+                linux: "linux";
+            }>;
+            transport: z.ZodEnum<{
+                relay: "relay";
+                in_process: "in_process";
+                localhost: "localhost";
+                agent: "agent";
+            }>;
+            outcome: z.ZodEnum<{
+                pass: "pass";
+                fail: "fail";
+                skip: "skip";
+            }>;
+            remote_network: z.ZodBoolean;
+            detail: z.ZodString;
+            suite: z.ZodString;
+            test: z.ZodString;
+            run_at_ms: z.ZodInt;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    readonly AppKey: z.ZodString;
+    readonly AppProfileId: z.ZodString;
+    readonly AppProfileLocator: z.ZodString;
+    readonly AppSupport: z.ZodEnum<{
+        supported: "supported";
+        partial: "partial";
+        unsupported: "unsupported";
+    }>;
+    readonly AppFeatureStatus: z.ZodObject<{
+        status: z.ZodEnum<{
+            supported: "supported";
+            partial: "partial";
+            unsupported: "unsupported";
+        }>;
+        reason: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
+    readonly AppInfo: 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>;
+    readonly AppUsageReading: 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>;
+    readonly AppProfile: 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 AppsListParams: z.ZodObject<{}, z.core.$strict>;
+    readonly AppsListResult: 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 AppsProfilesListParams: z.ZodObject<{
+        app_key: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly AppsProfilesListResult: 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 AppsProfilesSaveParams: 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 AppsProfilesRemoveParams: z.ZodObject<{
+        id: z.ZodString;
+    }, z.core.$strict>;
+    readonly AppsProfilesRemoveResult: z.ZodObject<{
+        removed: z.ZodBoolean;
+    }, z.core.$strict>;
+    readonly AppsOpenParams: z.ZodObject<{
+        app_key: z.ZodString;
+        profile_id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly AppsOpenResult: z.ZodObject<{
+        already_running: z.ZodBoolean;
+        folder: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
 };
 type NamedSchemaId = keyof typeof NAMED_SCHEMAS;
 
-export { ResponseMsg as A, BEARER_PREFIX as B, ClientType as C, DesktopProtocolError as D, EndReason as E, FsPatchEditFailure as F, SUBPROTOCOL as G, HelloMsg as H, StreamMsg as I, Limits as L, NAMED_SCHEMAS as N, type OpName as O, PING_TEXT as P, RelayMsg as R, StreamMeta as S, Welcome as W, type OpParams as a, type OpResult as b, OPS as c, EVENTS as d, CancelMsg as e, ClientToCoreMsg as f, CloseCode as g, CloseCodeValue as h, isDesktopProtocolError as i, CoreToClientMsg as j, CreditMsg as k, EndMsg as l, ErrorCode as m, type ErrorCodeName as n, type ErrorData as o, ErrorMsg as p, ErrorReason as q, type ErrorReasonName as r, EventMsg as s, type EventName as t, type NamedSchemaId as u, OpDescriptor as v, type OpSpec as w, PONG_TEXT as x, ProtocolErrorBody as y, RequestMsg as z };
+export { type OpSpec as A, BEARER_PREFIX as B, type CloseOutcome as C, DesktopProtocolError as D, EndReason as E, FsPatchEditFailure as F, PONG_TEXT as G, HelloMsg as H, ProtocolErrorBody as I, RequestMsg as J, ResponseMsg as K, Limits as L, SERVICES as M, NAMED_SCHEMAS as N, type OpName as O, PING_TEXT as P, SUBPROTOCOL as Q, RelayMsg as R, StreamMeta as S, type ServiceId as T, type ServiceOpName as U, type ServiceOpSpec as V, Welcome as W, type ServiceSpec as X, StreamMsg as Y, closeRule as Z, isTerminalClose as _, type OpParams as a, type OpResult as b, OPS as c, EVENTS as d, ClientType as e, CLOSE_RULES as f, CancelMsg as g, ClientToCoreMsg as h, isDesktopProtocolError as i, type CloseAction as j, CloseCode as k, CloseCodeValue as l, type CloseRule as m, CoreToClientMsg as n, CreditMsg as o, EndMsg as p, ErrorCode as q, type ErrorCodeName as r, type ErrorData as s, ErrorMsg as t, ErrorReason as u, type ErrorReasonName as v, EventMsg as w, type EventName as x, type NamedSchemaId as y, OpDescriptor as z };