@ai-matrx/desktop-protocol 0.21.21 → 0.21.23

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { O as OpName } from './models-ZQtKshfc.cjs';
-export { B as BEARER_PREFIX, g as CLOSE_RULES, h as CancelMsg, j as ClientToCoreMsg, e as ClientType, k as CloseAction, l as CloseCode, m as CloseCodeValue, C as CloseOutcome, n as CloseRule, o as CoreToClientMsg, p as CreditMsg, D as DesktopProtocolError, d as EVENTS, q as EndMsg, E as EndReason, r as ErrorCode, s as ErrorCodeName, t as ErrorData, u as ErrorMsg, v as ErrorReason, w as ErrorReasonName, x as EventMsg, y as EventName, F as FsPatchEditFailure, H as HelloMsg, L as Limits, z as MlInstallPhase, A as MlInstallProgress, f as MlProgress, G as MlRuntimeState, I as MlServiceState, J as MlServiceStatus, K as MlStatusParams, N as MlStatusResult, P as ModelsInstallParams, Q as ModelsInstallResult, R as ModelsProgressEvent, U as ModelsStatusParams, V as ModelsStatusResult, X as ModelsTranscribeParams, M as ModelsTranscribeResult, Y as NAMED_SCHEMAS, Z as NamedSchemaId, c as OPS, _ as OpDescriptor, a as OpParams, b as OpResult, $ as OpSpec, a0 as PING_TEXT, a1 as PONG_TEXT, a2 as ProtocolErrorBody, a3 as RelayMsg, a4 as RequestMsg, a5 as ResponseMsg, a6 as SERVICES, a7 as SUBPROTOCOL, a8 as ServiceId, a9 as ServiceOpName, aa as ServiceOpSpec, ab as ServiceSpec, S as StreamMeta, ac as StreamMsg, ad as TranscriptSegment, T as TranscriptionModelId, ae as TranscriptionModelInfo, W as Welcome, af as closeRule, i as isDesktopProtocolError, ag as isTerminalClose } from './models-ZQtKshfc.cjs';
+import { O as OpName } from './models-CXjW101n.cjs';
+export { B as BEARER_PREFIX, g as CLOSE_RULES, h as CancelMsg, j as ClientToCoreMsg, e as ClientType, k as CloseAction, l as CloseCode, m as CloseCodeValue, C as CloseOutcome, n as CloseRule, o as CoreToClientMsg, p as CreditMsg, D as DesktopProtocolError, d as EVENTS, q as EndMsg, E as EndReason, r as ErrorCode, s as ErrorCodeName, t as ErrorData, u as ErrorMsg, v as ErrorReason, w as ErrorReasonName, x as EventMsg, y as EventName, F as FsPatchEditFailure, H as HelloMsg, L as Limits, z as MlInstallPhase, A as MlInstallProgress, f as MlProgress, G as MlRuntimeState, I as MlServiceState, J as MlServiceStatus, K as MlStatusParams, N as MlStatusResult, P as ModelsInstallParams, Q as ModelsInstallResult, R as ModelsProgressEvent, U as ModelsStatusParams, V as ModelsStatusResult, X as ModelsTranscribeParams, M as ModelsTranscribeResult, Y as NAMED_SCHEMAS, Z as NamedSchemaId, c as OPS, _ as OpDescriptor, a as OpParams, b as OpResult, $ as OpSpec, a0 as PING_TEXT, a1 as PONG_TEXT, a2 as ProtocolErrorBody, a3 as RelayMsg, a4 as RequestMsg, a5 as ResponseMsg, a6 as SERVICES, a7 as SUBPROTOCOL, a8 as ServiceId, a9 as ServiceOpName, aa as ServiceOpSpec, ab as ServiceSpec, S as StreamMeta, ac as StreamMsg, ad as TranscriptSegment, T as TranscriptionModelId, ae as TranscriptionModelInfo, W as Welcome, af as closeRule, i as isDesktopProtocolError, ag as isTerminalClose } from './models-CXjW101n.cjs';
 export { BROADCAST_CID, DecodedFrame, FRAME_HEADER_BYTES, FRAME_STRUCT_FORMAT, FRAME_VERSION, FrameChannel, FrameChannelValue, FrameFlag, assertFrameHeader, connectionEndFrame, decodeFrame, encodeFrame, hasFlag, isConnectionEnd, readCid, stampCid } from './frame.cjs';
 
 /** @ai-matrx/desktop-protocol — version and primitive schemas. Schema source: lint-enforced rules in scripts/check-schema-source.mjs. */
@@ -49,10 +49,16 @@ declare const PROTOCOL_MAJOR: 1;
  *          apps.windows.reopen and apps.windows.update_and_reopen (quit all, install, reopen all).
  *   1.27 — AppsWindowsUpdateStateResult.closed_by_update: the closed windows the update itself quit
  *          (the app's log says it went down for the update), apart from ones a person closed.
+ *   1.28 — the `browser` capability: the AI Matrx extension as a client (browser.register, result,
+ *          progress), the Browsers screen (browser.sessions, disconnect, set_enabled, pair_code,
+ *          pair_reset), agents' browser.call, events browser.invoke / sessions_changed / progress,
+ *          and the browser_* / awaiting_confirmation error reasons (REASONS_SINCE).
+ *   1.29 — one name per chat in every window: apps.chats.titles_check (each chat's right name and
+ *          the windows where it differs) and apps.chats.titles_push (write it into every copy).
  */
-declare const PROTOCOL_MINOR: 27;
+declare const PROTOCOL_MINOR: 29;
 /** This package's version as the wire spells it ("major.minor"): hello, welcome, relay status. */
-declare const PROTOCOL_VERSION: "1.27";
+declare const PROTOCOL_VERSION: "1.29";
 /** Internal building blocks — deliberately unnamed in $defs (inlined wherever used). */
 declare const u32: z.ZodInt;
 declare const nonNegInt: z.ZodInt;
@@ -1044,6 +1050,11 @@ declare const RelayCallResponse: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 service_starting: "service_starting";
                 service_restarted: "service_restarted";
                 service_failed: "service_failed";
+                browser_not_connected: "browser_not_connected";
+                browser_ambiguous: "browser_ambiguous";
+                browser_account_mismatch: "browser_account_mismatch";
+                browser_connection_off: "browser_connection_off";
+                awaiting_confirmation: "awaiting_confirmation";
             }>>;
             cap: z.ZodOptional<z.ZodString>;
             op: z.ZodOptional<z.ZodString>;
@@ -2436,6 +2447,93 @@ declare const AppsChatsOpenParams: z.ZodObject<{
     window: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 type AppsChatsOpenParams = z.output<typeof AppsChatsOpenParams>;
+/** One window's copies of a chat whose name differs from the chat's right name. */
+declare const TitleCopies: z.ZodObject<{
+    window: z.ZodString;
+    copies: z.ZodInt;
+    titles: z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        source: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+type TitleCopies = z.output<typeof TitleCopies>;
+/** A chat that does not have one name everywhere: the right name, and where it differs. */
+declare const TitleMismatch: z.ZodObject<{
+    chat_id: z.ZodString;
+    title: z.ZodString;
+    title_source: z.ZodEnum<{
+        user: "user";
+        auto: "auto";
+    }>;
+    decided_from: z.ZodString;
+    kind: z.ZodEnum<{
+        user_vs_auto: "user_vs_auto";
+        user_vs_user: "user_vs_user";
+        auto_vs_auto: "auto_vs_auto";
+        source_only: "source_only";
+    }>;
+    windows: z.ZodArray<z.ZodString>;
+    differs_in: z.ZodArray<z.ZodObject<{
+        window: z.ZodString;
+        copies: z.ZodInt;
+        titles: z.ZodArray<z.ZodObject<{
+            title: z.ZodString;
+            source: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+type TitleMismatch = z.output<typeof TitleMismatch>;
+declare const AppsChatsTitlesCheckParams: z.ZodObject<{
+    app_key: z.ZodString;
+}, z.core.$strict>;
+type AppsChatsTitlesCheckParams = z.output<typeof AppsChatsTitlesCheckParams>;
+declare const AppsChatsTitlesCheckResult: z.ZodObject<{
+    app_key: z.ZodString;
+    chats_total: z.ZodInt;
+    chats_in_several_windows: z.ZodInt;
+    chats_with_a_different_name: z.ZodInt;
+    copies_to_write: z.ZodInt;
+    chats: z.ZodArray<z.ZodObject<{
+        chat_id: z.ZodString;
+        title: z.ZodString;
+        title_source: z.ZodEnum<{
+            user: "user";
+            auto: "auto";
+        }>;
+        decided_from: z.ZodString;
+        kind: z.ZodEnum<{
+            user_vs_auto: "user_vs_auto";
+            user_vs_user: "user_vs_user";
+            auto_vs_auto: "auto_vs_auto";
+            source_only: "source_only";
+        }>;
+        windows: z.ZodArray<z.ZodString>;
+        differs_in: z.ZodArray<z.ZodObject<{
+            window: z.ZodString;
+            copies: z.ZodInt;
+            titles: z.ZodArray<z.ZodObject<{
+                title: z.ZodString;
+                source: z.ZodString;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+type AppsChatsTitlesCheckResult = z.output<typeof AppsChatsTitlesCheckResult>;
+/** Write each chat's right name into every copy in every window (one chat with chat_id). */
+declare const AppsChatsTitlesPushParams: z.ZodObject<{
+    app_key: z.ZodString;
+    chat_id: z.ZodOptional<z.ZodString>;
+    dry_run: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+type AppsChatsTitlesPushParams = z.output<typeof AppsChatsTitlesPushParams>;
+declare const AppsChatsTitlesPushResult: z.ZodObject<{
+    app_key: z.ZodString;
+    written: z.ZodInt;
+    chats_fixed: z.ZodInt;
+    failed: z.ZodInt;
+    chats_with_a_different_name: z.ZodInt;
+}, z.core.$strict>;
+type AppsChatsTitlesPushResult = z.output<typeof AppsChatsTitlesPushResult>;
 /** Main conversation and helpers, USD at API list prices. */
 declare const SpendSplit: z.ZodObject<{
     main: z.ZodNumber;
@@ -2954,6 +3052,11 @@ declare const ServiceErrorMsg: z.ZodObject<{
                 service_starting: "service_starting";
                 service_restarted: "service_restarted";
                 service_failed: "service_failed";
+                browser_not_connected: "browser_not_connected";
+                browser_ambiguous: "browser_ambiguous";
+                browser_account_mismatch: "browser_account_mismatch";
+                browser_connection_off: "browser_connection_off";
+                awaiting_confirmation: "awaiting_confirmation";
             }>>;
             cap: z.ZodOptional<z.ZodString>;
             op: z.ZodOptional<z.ZodString>;
@@ -3089,6 +3192,11 @@ declare const ServiceToCoreMsg: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 service_starting: "service_starting";
                 service_restarted: "service_restarted";
                 service_failed: "service_failed";
+                browser_not_connected: "browser_not_connected";
+                browser_ambiguous: "browser_ambiguous";
+                browser_account_mismatch: "browser_account_mismatch";
+                browser_connection_off: "browser_connection_off";
+                awaiting_confirmation: "awaiting_confirmation";
             }>>;
             cap: z.ZodOptional<z.ZodString>;
             op: z.ZodOptional<z.ZodString>;
@@ -5248,6 +5356,305 @@ declare const CodingHistoryProgressEvent: z.ZodObject<{
 }, z.core.$strict>;
 type CodingHistoryProgressEvent = z.output<typeof CodingHistoryProgressEvent>;
 
+/**
+ * @ai-matrx/desktop-protocol — cap browser (protocol 1.28): the AI Matrx browser extension as a
+ * client of Matrx 2, and Matrx 2's agents driving it. Schema source: lint-enforced rules in
+ * scripts/check-schema-source.mjs.
+ *
+ * The extension finds Matrx 2 with `GET /v1/health` (DesktopHealth, public, no token), pairs once
+ * with `POST /v1/pair` (BrowserPairRequest → BrowserPairResult, loopback + an allowed extension
+ * Origin), connects to `/v1/connect` as clientType "extension" with `bearer.<pair token>`, says
+ * hello as usual (the envelope is unchanged) and then `browser.register` — once the welcome lists
+ * it. Matrx 2 checks the extension's account against the device owner; only a session of the same
+ * account is ever driven. An agent's call (`browser.call`) reaches exactly one session as the event
+ * `browser.invoke`; the extension answers with `browser.result` (accepted only from that session)
+ * and may say `browser.progress` while a person confirms the action in Chrome.
+ */
+
+/** Stable per Chrome profile (the extension mints it once): one session per instance. */
+declare const BrowserClientInstance: z.ZodString;
+declare const BrowserRegisterResult: z.ZodObject<{
+    session: z.ZodObject<{
+        client_instance: z.ZodString;
+        client_label: z.ZodString;
+        browser: z.ZodEnum<{
+            other: "other";
+            chrome: "chrome";
+            edge: "edge";
+            brave: "brave";
+            arc: "arc";
+            opera: "opera";
+            vivaldi: "vivaldi";
+            chromium: "chromium";
+            firefox: "firefox";
+        }>;
+        extension_version: z.ZodString;
+        state: z.ZodEnum<{
+            connected: "connected";
+            different_account: "different_account";
+            extension_signed_out: "extension_signed_out";
+            device_signed_out: "device_signed_out";
+            unverified: "unverified";
+        }>;
+        routable: z.ZodBoolean;
+        account_email: z.ZodNullable<z.ZodString>;
+        connected_at_ms: z.ZodInt;
+        last_call_at_ms: z.ZodNullable<z.ZodInt>;
+        calls: z.ZodInt;
+        errors: z.ZodInt;
+        p50_ms: z.ZodNullable<z.ZodInt>;
+        p95_ms: z.ZodNullable<z.ZodInt>;
+        awaiting_confirmation: z.ZodBoolean;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+declare const BrowserCallError: z.ZodObject<{
+    message: z.ZodString;
+    code: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+declare const BrowserResultResult: z.ZodObject<{
+    accepted: z.ZodBoolean;
+}, z.core.$strict>;
+/** The extension says where a call stands (the person is being asked to confirm it). */
+declare const BrowserProgressParams: z.ZodObject<{
+    call_id: z.ZodString;
+    phase: z.ZodEnum<{
+        awaiting_confirmation: "awaiting_confirmation";
+        running: "running";
+    }>;
+}, z.core.$strict>;
+declare const BrowserProgressResult: z.ZodObject<{
+    accepted: z.ZodBoolean;
+}, z.core.$strict>;
+declare const BrowserSessionsParams: z.ZodObject<{}, z.core.$strict>;
+declare const BrowserDisconnectParams: z.ZodObject<{
+    client_instance: z.ZodString;
+}, z.core.$strict>;
+declare const BrowserDisconnectResult: z.ZodObject<{
+    disconnected: z.ZodBoolean;
+}, z.core.$strict>;
+declare const BrowserSetEnabledParams: z.ZodObject<{
+    enabled: z.ZodBoolean;
+}, z.core.$strict>;
+declare const BrowserSetEnabledResult: z.ZodObject<{
+    enabled: z.ZodBoolean;
+}, z.core.$strict>;
+/** The pairing code a browser on another computer types in (screen clients on this computer only). */
+declare const BrowserPairCodeParams: z.ZodObject<{}, z.core.$strict>;
+declare const BrowserPairCodeResult: z.ZodObject<{
+    code: z.ZodString;
+}, z.core.$strict>;
+declare const BrowserPairResetParams: z.ZodObject<{}, z.core.$strict>;
+/** Core → the app's screens: the session list changed (re-read browser.sessions). */
+declare const BrowserSessionsChangedEvent: z.ZodObject<{
+    count: z.ZodInt;
+    enabled: z.ZodBoolean;
+}, z.core.$strict>;
+/** Core → the caller of a browser.call: where it stands. */
+declare const BrowserProgressEvent: z.ZodObject<{
+    call_id: z.ZodString;
+    client_instance: z.ZodString;
+    phase: z.ZodEnum<{
+        awaiting_confirmation: "awaiting_confirmation";
+        running: "running";
+    }>;
+}, z.core.$strict>;
+/** `POST /v1/pair` body. */
+declare const BrowserPairRequest: z.ZodObject<{
+    client_instance: z.ZodString;
+}, z.core.$strict>;
+/**
+ * The extension IDs allowed to pair (Origin `chrome-extension://<id>`): the Chrome Web Store build
+ * and the keyed development build. matrx-extend's src/config/identity.ts names the same IDs; this
+ * constant is the one both sides read. The development ID is accepted only by development builds.
+ */
+declare const MATRX_EXTENSION_IDS: {
+    readonly store: "hnfolienncfklkgmdjjmhhegglimlamg";
+    readonly development: "cihdmkcdjjckfhjpgoedmgfpoljebaml";
+};
+/** The discovery file Matrx 2 writes under ~/.matrx (Matrx Local keeps local.json). */
+declare const DISCOVERY_FILE: {
+    readonly live: "matrx2.json";
+    readonly development: "matrx2-dev.json";
+};
+/** The browser the extension runs in, as the extension reports it. */
+declare const BrowserKind: z.ZodEnum<{
+    other: "other";
+    chrome: "chrome";
+    edge: "edge";
+    brave: "brave";
+    arc: "arc";
+    opera: "opera";
+    vivaldi: "vivaldi";
+    chromium: "chromium";
+    firefox: "firefox";
+}>;
+type BrowserKind = z.output<typeof BrowserKind>;
+/**
+ * Whether this computer's agents may drive the session:
+ * - `connected` — same account as the device owner: routable;
+ * - `different_account` — the extension is signed in to another AI Matrx account: listed, never driven;
+ * - `extension_signed_out` — the extension is signed out of AI Matrx: listed, never driven;
+ * - `device_signed_out` — Matrx 2 itself is signed out, so there is no owner to match: listed, never driven;
+ * - `unverified` — the account could not be checked (no network, keys unavailable): retried on the next register.
+ */
+declare const BrowserSessionState: z.ZodEnum<{
+    connected: "connected";
+    different_account: "different_account";
+    extension_signed_out: "extension_signed_out";
+    device_signed_out: "device_signed_out";
+    unverified: "unverified";
+}>;
+type BrowserSessionState = z.output<typeof BrowserSessionState>;
+declare const BrowserSession: z.ZodObject<{
+    client_instance: z.ZodString;
+    client_label: z.ZodString;
+    browser: z.ZodEnum<{
+        other: "other";
+        chrome: "chrome";
+        edge: "edge";
+        brave: "brave";
+        arc: "arc";
+        opera: "opera";
+        vivaldi: "vivaldi";
+        chromium: "chromium";
+        firefox: "firefox";
+    }>;
+    extension_version: z.ZodString;
+    state: z.ZodEnum<{
+        connected: "connected";
+        different_account: "different_account";
+        extension_signed_out: "extension_signed_out";
+        device_signed_out: "device_signed_out";
+        unverified: "unverified";
+    }>;
+    routable: z.ZodBoolean;
+    account_email: z.ZodNullable<z.ZodString>;
+    connected_at_ms: z.ZodInt;
+    last_call_at_ms: z.ZodNullable<z.ZodInt>;
+    calls: z.ZodInt;
+    errors: z.ZodInt;
+    p50_ms: z.ZodNullable<z.ZodInt>;
+    p95_ms: z.ZodNullable<z.ZodInt>;
+    awaiting_confirmation: z.ZodBoolean;
+}, z.core.$strict>;
+type BrowserSession = z.output<typeof BrowserSession>;
+declare const BrowserRegisterParams: z.ZodObject<{
+    client_instance: z.ZodString;
+    client_label: z.ZodString;
+    browser: z.ZodEnum<{
+        other: "other";
+        chrome: "chrome";
+        edge: "edge";
+        brave: "brave";
+        arc: "arc";
+        opera: "opera";
+        vivaldi: "vivaldi";
+        chromium: "chromium";
+        firefox: "firefox";
+    }>;
+    extension_version: z.ZodString;
+    account_token: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+type BrowserRegisterParams = z.output<typeof BrowserRegisterParams>;
+/** The extension's answer to one `browser.invoke`. */
+declare const BrowserResultParams: z.ZodObject<{
+    call_id: z.ZodString;
+    ok: z.ZodBoolean;
+    result: z.ZodUnknown;
+    error: z.ZodNullable<z.ZodObject<{
+        message: z.ZodString;
+        code: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+type BrowserResultParams = z.output<typeof BrowserResultParams>;
+declare const BrowserCallPhase: z.ZodEnum<{
+    awaiting_confirmation: "awaiting_confirmation";
+    running: "running";
+}>;
+type BrowserCallPhase = z.output<typeof BrowserCallPhase>;
+declare const BrowserSessionsResult: z.ZodObject<{
+    enabled: z.ZodBoolean;
+    owner_signed_in: z.ZodBoolean;
+    sessions: z.ZodArray<z.ZodObject<{
+        client_instance: z.ZodString;
+        client_label: z.ZodString;
+        browser: z.ZodEnum<{
+            other: "other";
+            chrome: "chrome";
+            edge: "edge";
+            brave: "brave";
+            arc: "arc";
+            opera: "opera";
+            vivaldi: "vivaldi";
+            chromium: "chromium";
+            firefox: "firefox";
+        }>;
+        extension_version: z.ZodString;
+        state: z.ZodEnum<{
+            connected: "connected";
+            different_account: "different_account";
+            extension_signed_out: "extension_signed_out";
+            device_signed_out: "device_signed_out";
+            unverified: "unverified";
+        }>;
+        routable: z.ZodBoolean;
+        account_email: z.ZodNullable<z.ZodString>;
+        connected_at_ms: z.ZodInt;
+        last_call_at_ms: z.ZodNullable<z.ZodInt>;
+        calls: z.ZodInt;
+        errors: z.ZodInt;
+        p50_ms: z.ZodNullable<z.ZodInt>;
+        p95_ms: z.ZodNullable<z.ZodInt>;
+        awaiting_confirmation: z.ZodBoolean;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+type BrowserSessionsResult = z.output<typeof BrowserSessionsResult>;
+/**
+ * Run one of the extension's own tools (any `chrome-extension` tool_def row) in one session. The
+ * server validates `args` against that row's parameters; here they are opaque and size-capped.
+ */
+declare const BrowserCallParams: z.ZodObject<{
+    tool: z.ZodString;
+    args: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    client_instance: z.ZodOptional<z.ZodString>;
+    timeout_ms: z.ZodOptional<z.ZodInt>;
+}, z.core.$strict>;
+type BrowserCallParams = z.output<typeof BrowserCallParams>;
+declare const BrowserCallResult: z.ZodObject<{
+    client_instance: z.ZodString;
+    result: z.ZodUnknown;
+    duration_ms: z.ZodInt;
+}, z.core.$strict>;
+type BrowserCallResult = z.output<typeof BrowserCallResult>;
+/** Core → one extension session: run this tool and answer with browser.result. */
+declare const BrowserInvokeEvent: z.ZodObject<{
+    call_id: z.ZodString;
+    tool: z.ZodString;
+    args: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    deadline_ms: z.ZodInt;
+}, z.core.$strict>;
+type BrowserInvokeEvent = z.output<typeof BrowserInvokeEvent>;
+/** `GET /v1/health`: public, no token, no user id. Matrx 2 never serves `/health` (Matrx Local's). */
+declare const DesktopHealth: z.ZodObject<{
+    status: z.ZodLiteral<"ok">;
+    service: z.ZodLiteral<"matrx-desktop">;
+    version: z.ZodString;
+    protocol_version: z.ZodString;
+    ws_path: z.ZodLiteral<"/v1/connect">;
+    device_id: z.ZodString;
+    browser_connection: z.ZodEnum<{
+        off: "off";
+        on: "on";
+    }>;
+}, z.core.$strict>;
+type DesktopHealth = z.output<typeof DesktopHealth>;
+/** `POST /v1/pair` answer: the token rides `bearer.<pair_token>` on /v1/connect. */
+declare const BrowserPairResult: z.ZodObject<{
+    pair_token: z.ZodString;
+    ws_path: z.ZodLiteral<"/v1/connect">;
+}, z.core.$strict>;
+type BrowserPairResult = z.output<typeof BrowserPairResult>;
+
 /**
  * Version skew is the normal state: a phone, the server and a desktop app in the field run
  * different package versions, and a minor protocol bump must never make any of them fail.
@@ -5357,6 +5764,11 @@ declare const REASONS_SINCE: {
     readonly service_starting: "1.2";
     readonly service_restarted: "1.2";
     readonly service_failed: "1.2";
+    readonly browser_not_connected: "1.28";
+    readonly browser_ambiguous: "1.28";
+    readonly browser_account_mismatch: "1.28";
+    readonly browser_connection_off: "1.28";
+    readonly awaiting_confirmation: "1.28";
 };
 /** A device status for a reader at `version`: `since_ms` null ("never") becomes 0 before 1.1. */
 declare function statusForPeer<T extends {
@@ -5386,7 +5798,7 @@ declare function forPeer(op: OpName | null, part: "error", value: unknown, versi
 declare const VERSIONED_RESULT_OPS: readonly OpName[];
 
 /** SHA-256 of generated/desktop-protocol.schema.json: the contract both sides of a service connection were built from. */
-declare const CONTRACT_SHA256: "eece2e5eba3e6e33126a0fda2fad8c91abe9c878fbfdc98bd049ff5af126cb09";
+declare const CONTRACT_SHA256: "5994ab9f6c2dba636a90e18c99bd3a90736f23782b3f8df9e0d2d7234b8e2b1b";
 
 /**
  * The local tool catalog (SPEC §10): every tool a platform agent calls on a person's computer, the
@@ -5513,4 +5925,4 @@ declare function buildToolStatus(files: readonly unknown[], opts: {
 /** The committed text form. Columns: per platform, the three levels (P = programmatic, R = protocol, C = chat). */
 declare function renderToolStatusMarkdown(status: ToolStatus): string;
 
-export { AbsPath, AccountAgent, AccountAgentsListParams, AccountAgentsListResult, AccountReadState, AccountReset, AccountRowId, AccountUsage, AccountVaultCopyParams, AccountVaultCopyResult, AccountVaultListParams, AccountVaultListResult, AppFeatureStatus, AppInfo, AppKey, AppProfile, AppProfileId, AppProfileLocator, AppSupport, AppUsageReading, AppWindowInfo, AppsAccountsResetsParams, AppsAccountsResetsResult, AppsAccountsUsageParams, AppsAccountsUsageResult, AppsChatsChangedEvent, AppsChatsColdParams, AppsChatsColdResult, AppsChatsListParams, AppsChatsListResult, AppsChatsOpenParams, AppsChatsPlaceParams, AppsChatsPlaceResult, AppsChatsStarParams, AppsChatsStarResult, AppsChatsWatchParams, AppsChatsWatchResult, AppsChatsWatchStateEvent, AppsListParams, AppsListResult, AppsOpenParams, AppsOpenResult, AppsProfilesListParams, AppsProfilesListResult, AppsProfilesRemoveParams, AppsProfilesRemoveResult, AppsProfilesSaveParams, AppsProfilesSaveResult, AppsProjectsCopyParams, AppsProjectsCopyResult, AppsProjectsCreateParams, AppsProjectsCreateResult, AppsProjectsFileManyParams, AppsProjectsFileManyResult, AppsProjectsFileParams, AppsProjectsFileResult, AppsProjectsImportPinsParams, AppsProjectsImportPinsResult, AppsProjectsMoveParams, AppsProjectsMoveResult, AppsProjectsToWindowParams, AppsProjectsToWindowResult, AppsProjectsUnfileParams, AppsProjectsUnfileResult, AppsProjectsUpdateParams, AppsProjectsUpdateResult, AppsSpendParams, AppsSpendResult, AppsSyncRunParams, AppsSyncStatusParams, AppsSyncStatusResult, AppsWindowActionResult, AppsWindowsAddParams, AppsWindowsListParams, AppsWindowsListResult, AppsWindowsOpenParams, AppsWindowsProcessesParams, AppsWindowsProcessesResult, AppsWindowsRefreshUsageParams, AppsWindowsReloadParams, AppsWindowsReopenParams, AppsWindowsReopenResult, AppsWindowsRestartParams, AppsWindowsSaveNamesParams, AppsWindowsShownParams, AppsWindowsShownResult, AppsWindowsUpdateAndReopenParams, AppsWindowsUpdateAndReopenResult, AppsWindowsUpdateStateParams, AppsWindowsUpdateStateResult, AudioDevice, AudioDevicesParams, AudioDevicesResult, AudioLevelsParams, AudioLevelsResult, AudioPlayParams, AudioPlayResult, AudioRecordParams, AudioRecordResult, AudioSetLevelsParams, CONTRACT_SHA256, type CatalogTool, type CellState, ChatAppProject, ChatFamily, ChatHidden, ChatId, ChatLastUse, ChatPin, ChatPlace, ChatProject, ChatProjectId, ChatRow, ChatRunning, ChatWindow, ClipboardReadParams, ClipboardReadResult, ClipboardWriteParams, ClipboardWriteResult, CodingHistoryBlocked, CodingHistoryFailure, CodingHistoryImportMissingParams, CodingHistoryImportMissingResult, CodingHistoryProgressEvent, CodingHistoryRun, CodingHistoryStep, CodingImportNextParams, CodingPlanMissingParams, CodingServiceCredentials, CodingServiceProgress, ColdChat, ContractHash, CoreToServiceMsg, DEFAULT_MAX_FRAME_PAYLOAD_BYTES, DEFAULT_MAX_MESSAGE_BYTES, DEFAULT_WINDOW_BYTES, DeviceId, DiagErrorEntry, DiagErrorKind, DiagErrorStatus, DiagErrorsChangedEvent, DiagErrorsListParams, DiagErrorsListResult, DiagErrorsReportParams, DiagErrorsReportResult, DiagProcess, EXCLUDED_TOOLS, ExecCwdEvent, ExecExitedEvent, ExecJobId, ExecJobInfo, ExecJobListParams, ExecJobListResult, ExecJobOutputParams, ExecJobOutputResult, ExecJobStartParams, ExecJobStartResult, ExecJobStopParams, ExecJobStopResult, ExecListParams, ExecListResult, ExecPtyKillParams, ExecPtyKillResult, ExecPtyResizeParams, ExecPtyResizeResult, ExecPtySignalParams, ExecPtySignalResult, ExecPtyStartParams, ExecPtyStartResult, ExecPtyWriteParams, ExecPtyWriteResult, ExecRunParams, ExecRunResult, ExecTitleEvent, FIELDS_SINCE, type FieldsSincePath, FrameHeader, FsChange, FsChangedEvent, FsDeleteParams, FsDeleteResult, FsEncoding, FsEntry, FsKind, FsListParams, FsListResult, FsMkdirParams, FsMkdirResult, FsMoveParams, FsMoveResult, FsPatchEditApplied, FsPatchParams, FsPatchResult, FsReadParams, FsReadResult, FsReadStreamParams, FsReadStreamResult, FsSearchContentParams, FsSearchContentResult, FsSearchPathsParams, FsSearchPathsResult, FsStatParams, FsStatResult, FsWatchEventsParams, FsWatchEventsResult, FsWatchId, FsWatchParams, FsWatchResult, FsWatchStartParams, FsWatchStartResult, FsWatchStopParams, FsWatchStopResult, FsWriteParams, FsWriteResult, GIT_MAX_OUTPUT_CHARS, GitAddParams, GitBranchParams, GitBranchResult, GitCloneParams, GitCommitParams, GitCommitResult, GitDiffParams, GitDiffResult, GitLogCommit, GitLogParams, GitLogResult, GitOutputResult, GitPullParams, GitPushParams, GitStashParams, GitStatusFile, GitStatusParams, GitStatusResult, InputHotkeyParams, InputHotkeyResult, InputKey, InputKeyboardSettingsParams, InputKeyboardSettingsResult, InputMouseClickParams, InputMouseClickResult, InputMouseMoveParams, InputMouseMoveResult, InputPoint, InputSetKeyboardSettingsParams, InputTypeTextParams, InputTypeTextResult, LEGACY_ACTIONS, LEGACY_DISPATCHERS, type LegacyDisposition, NULL_SINCE, OpName, OsPermissionName, PROTOCOL_MAJOR, PROTOCOL_MINOR, PROTOCOL_VERSION, PowerEnergy, PowerHistoryParams, PowerHistoryPoint, PowerHistoryResult, PowerPreventSleepParams, PowerPreventSleepResult, PowerStatusParams, PowerStatusResult, ProcInfo, ProcKillParams, ProcKillResult, ProcListParams, ProcListResult, ProcPort, ProcPortsParams, ProcPortsResult, ProcSort, ProjectMoveChat, ProjectMoveGroup, ProjectMoveSkip, ProtocolVersion, PtyInfo, REASONS_SINCE, RELAY_CALL_HELLO_ID, RELAY_CALL_REQUEST_ID, RELAY_CALL_VERSION_HEADER, RelayAuthExpiringEvent, RelayCallEnvelope, RelayCallHello, RelayCallRequest, RelayCallResponse, RelayDeviceStatusEvent, RelayHopConnectionEnd, RelayHopEnvelopeHeader, RelayStatusResponse, RequestId, ResourceId, ResourceInfo, ResourcesActivityParams, ResourcesActivityResult, ResourcesDisk, ResourcesIncident, ResourcesIncidentsParams, ResourcesIncidentsResult, ResourcesJob, ResourcesJobKind, ResourcesPressure, ResourcesProcess, ResourcesSample, ResourcesSnapshotParams, ResourcesSnapshotResult, ResourcesStopJobParams, ResourcesStopJobResult, ResourcesStrain, ResourcesVerdict, SERVICE_MAX_FRAME_BYTES, ScreenCaptureParams, ScreenCaptureResult, ScreenDisplay, ScreenListParams, ScreenListResult, ServiceCancel, ServiceErrorMsg, ServiceHello, ServiceName, ServicePing, ServicePong, ServiceProgressMsg, ServiceRequest, ServiceResponse, ServiceShutdown, ServiceToCoreMsg, ServiceToken, ServiceWelcome, SessionAttachParams, SessionAttachResult, SessionControlChangedEvent, SessionDetachParams, SessionDetachResult, SessionListParams, SessionListResult, SessionReleaseParams, SessionReleaseResult, ShownSection, Signal, SpendAccount, SpendChat, SpendDay, SpendHelper, SpendIdle, SpendIdleScope, SpendLive, SpendModel, SpendScopes, SpendSplit, SpendStart, StackErrorsParams, StackErrorsResult, StackEvent, StackLogsParams, StackLogsResult, StackRunResult, StackServer, StackServerActionParams, StackServerActionResult, StackServerName, StackStartParams, StackStateParams, StackStateResult, StackStopParams, StackTone, type StatusCell, type StatusEvidence, type StatusRow, SysinfoGetParams, SysinfoGetResult, SysinfoHardwareParams, SysinfoHardwareResult, SystemNotifyParams, SystemNotifyResult, SystemOpenPathParams, SystemOpenPathResult, SystemOpenSettingsParams, SystemOpenSettingsResult, SystemOpenUrlParams, SystemOpenUrlResult, SystemSettingsPane, TOOL_CATALOG, TOOL_GROUPS, TOOL_LEVELS, TOOL_PLATFORMS, type ToolGroup, type ToolGroupId, ToolLevel, ToolLevelResult, ToolName, ToolOutcome, type ToolPath, ToolPlatform, ToolResultsFile, type ToolState, type ToolStatus, ToolTransport, ToolsServiceProgress, ToolsWebSearchParams, VERSIONED_RESULT_OPS, VaultFieldSummary, VaultItemKind, VaultItemSummary, WEB_MAX_TEXT_CHARS, WebBrowserFetchParams, WebBrowserFetchResult, WebFetchParams, WebFetchResult, WebHeader, WebScrapePage, WebScrapeParams, WebScrapeResult, WebSearchHit, WebSearchParams, WebSearchQueryResult, WebSearchResult, WindowFocusParams, WindowFocusResult, WindowInfo, WindowListParams, WindowListResult, WindowMinimizeParams, WindowMinimizeResult, WindowMoveParams, WindowMoveResult, announcedVersion, buildToolStatus, builtOps, compareVersions, epochMs, forPeer, knows, negotiate, nonNegInt, renderToolStatusMarkdown, statusForPeer, u32, versionSubprotocol };
+export { AbsPath, AccountAgent, AccountAgentsListParams, AccountAgentsListResult, AccountReadState, AccountReset, AccountRowId, AccountUsage, AccountVaultCopyParams, AccountVaultCopyResult, AccountVaultListParams, AccountVaultListResult, AppFeatureStatus, AppInfo, AppKey, AppProfile, AppProfileId, AppProfileLocator, AppSupport, AppUsageReading, AppWindowInfo, AppsAccountsResetsParams, AppsAccountsResetsResult, AppsAccountsUsageParams, AppsAccountsUsageResult, AppsChatsChangedEvent, AppsChatsColdParams, AppsChatsColdResult, AppsChatsListParams, AppsChatsListResult, AppsChatsOpenParams, AppsChatsPlaceParams, AppsChatsPlaceResult, AppsChatsStarParams, AppsChatsStarResult, AppsChatsTitlesCheckParams, AppsChatsTitlesCheckResult, AppsChatsTitlesPushParams, AppsChatsTitlesPushResult, AppsChatsWatchParams, AppsChatsWatchResult, AppsChatsWatchStateEvent, AppsListParams, AppsListResult, AppsOpenParams, AppsOpenResult, AppsProfilesListParams, AppsProfilesListResult, AppsProfilesRemoveParams, AppsProfilesRemoveResult, AppsProfilesSaveParams, AppsProfilesSaveResult, AppsProjectsCopyParams, AppsProjectsCopyResult, AppsProjectsCreateParams, AppsProjectsCreateResult, AppsProjectsFileManyParams, AppsProjectsFileManyResult, AppsProjectsFileParams, AppsProjectsFileResult, AppsProjectsImportPinsParams, AppsProjectsImportPinsResult, AppsProjectsMoveParams, AppsProjectsMoveResult, AppsProjectsToWindowParams, AppsProjectsToWindowResult, AppsProjectsUnfileParams, AppsProjectsUnfileResult, AppsProjectsUpdateParams, AppsProjectsUpdateResult, AppsSpendParams, AppsSpendResult, AppsSyncRunParams, AppsSyncStatusParams, AppsSyncStatusResult, AppsWindowActionResult, AppsWindowsAddParams, AppsWindowsListParams, AppsWindowsListResult, AppsWindowsOpenParams, AppsWindowsProcessesParams, AppsWindowsProcessesResult, AppsWindowsRefreshUsageParams, AppsWindowsReloadParams, AppsWindowsReopenParams, AppsWindowsReopenResult, AppsWindowsRestartParams, AppsWindowsSaveNamesParams, AppsWindowsShownParams, AppsWindowsShownResult, AppsWindowsUpdateAndReopenParams, AppsWindowsUpdateAndReopenResult, AppsWindowsUpdateStateParams, AppsWindowsUpdateStateResult, AudioDevice, AudioDevicesParams, AudioDevicesResult, AudioLevelsParams, AudioLevelsResult, AudioPlayParams, AudioPlayResult, AudioRecordParams, AudioRecordResult, AudioSetLevelsParams, BrowserCallError, BrowserCallParams, BrowserCallPhase, BrowserCallResult, BrowserClientInstance, BrowserDisconnectParams, BrowserDisconnectResult, BrowserInvokeEvent, BrowserKind, BrowserPairCodeParams, BrowserPairCodeResult, BrowserPairRequest, BrowserPairResetParams, BrowserPairResult, BrowserProgressEvent, BrowserProgressParams, BrowserProgressResult, BrowserRegisterParams, BrowserRegisterResult, BrowserResultParams, BrowserResultResult, BrowserSession, BrowserSessionState, BrowserSessionsChangedEvent, BrowserSessionsParams, BrowserSessionsResult, BrowserSetEnabledParams, BrowserSetEnabledResult, CONTRACT_SHA256, type CatalogTool, type CellState, ChatAppProject, ChatFamily, ChatHidden, ChatId, ChatLastUse, ChatPin, ChatPlace, ChatProject, ChatProjectId, ChatRow, ChatRunning, ChatWindow, ClipboardReadParams, ClipboardReadResult, ClipboardWriteParams, ClipboardWriteResult, CodingHistoryBlocked, CodingHistoryFailure, CodingHistoryImportMissingParams, CodingHistoryImportMissingResult, CodingHistoryProgressEvent, CodingHistoryRun, CodingHistoryStep, CodingImportNextParams, CodingPlanMissingParams, CodingServiceCredentials, CodingServiceProgress, ColdChat, ContractHash, CoreToServiceMsg, DEFAULT_MAX_FRAME_PAYLOAD_BYTES, DEFAULT_MAX_MESSAGE_BYTES, DEFAULT_WINDOW_BYTES, DISCOVERY_FILE, DesktopHealth, DeviceId, DiagErrorEntry, DiagErrorKind, DiagErrorStatus, DiagErrorsChangedEvent, DiagErrorsListParams, DiagErrorsListResult, DiagErrorsReportParams, DiagErrorsReportResult, DiagProcess, EXCLUDED_TOOLS, ExecCwdEvent, ExecExitedEvent, ExecJobId, ExecJobInfo, ExecJobListParams, ExecJobListResult, ExecJobOutputParams, ExecJobOutputResult, ExecJobStartParams, ExecJobStartResult, ExecJobStopParams, ExecJobStopResult, ExecListParams, ExecListResult, ExecPtyKillParams, ExecPtyKillResult, ExecPtyResizeParams, ExecPtyResizeResult, ExecPtySignalParams, ExecPtySignalResult, ExecPtyStartParams, ExecPtyStartResult, ExecPtyWriteParams, ExecPtyWriteResult, ExecRunParams, ExecRunResult, ExecTitleEvent, FIELDS_SINCE, type FieldsSincePath, FrameHeader, FsChange, FsChangedEvent, FsDeleteParams, FsDeleteResult, FsEncoding, FsEntry, FsKind, FsListParams, FsListResult, FsMkdirParams, FsMkdirResult, FsMoveParams, FsMoveResult, FsPatchEditApplied, FsPatchParams, FsPatchResult, FsReadParams, FsReadResult, FsReadStreamParams, FsReadStreamResult, FsSearchContentParams, FsSearchContentResult, FsSearchPathsParams, FsSearchPathsResult, FsStatParams, FsStatResult, FsWatchEventsParams, FsWatchEventsResult, FsWatchId, FsWatchParams, FsWatchResult, FsWatchStartParams, FsWatchStartResult, FsWatchStopParams, FsWatchStopResult, FsWriteParams, FsWriteResult, GIT_MAX_OUTPUT_CHARS, GitAddParams, GitBranchParams, GitBranchResult, GitCloneParams, GitCommitParams, GitCommitResult, GitDiffParams, GitDiffResult, GitLogCommit, GitLogParams, GitLogResult, GitOutputResult, GitPullParams, GitPushParams, GitStashParams, GitStatusFile, GitStatusParams, GitStatusResult, InputHotkeyParams, InputHotkeyResult, InputKey, InputKeyboardSettingsParams, InputKeyboardSettingsResult, InputMouseClickParams, InputMouseClickResult, InputMouseMoveParams, InputMouseMoveResult, InputPoint, InputSetKeyboardSettingsParams, InputTypeTextParams, InputTypeTextResult, LEGACY_ACTIONS, LEGACY_DISPATCHERS, type LegacyDisposition, MATRX_EXTENSION_IDS, NULL_SINCE, OpName, OsPermissionName, PROTOCOL_MAJOR, PROTOCOL_MINOR, PROTOCOL_VERSION, PowerEnergy, PowerHistoryParams, PowerHistoryPoint, PowerHistoryResult, PowerPreventSleepParams, PowerPreventSleepResult, PowerStatusParams, PowerStatusResult, ProcInfo, ProcKillParams, ProcKillResult, ProcListParams, ProcListResult, ProcPort, ProcPortsParams, ProcPortsResult, ProcSort, ProjectMoveChat, ProjectMoveGroup, ProjectMoveSkip, ProtocolVersion, PtyInfo, REASONS_SINCE, RELAY_CALL_HELLO_ID, RELAY_CALL_REQUEST_ID, RELAY_CALL_VERSION_HEADER, RelayAuthExpiringEvent, RelayCallEnvelope, RelayCallHello, RelayCallRequest, RelayCallResponse, RelayDeviceStatusEvent, RelayHopConnectionEnd, RelayHopEnvelopeHeader, RelayStatusResponse, RequestId, ResourceId, ResourceInfo, ResourcesActivityParams, ResourcesActivityResult, ResourcesDisk, ResourcesIncident, ResourcesIncidentsParams, ResourcesIncidentsResult, ResourcesJob, ResourcesJobKind, ResourcesPressure, ResourcesProcess, ResourcesSample, ResourcesSnapshotParams, ResourcesSnapshotResult, ResourcesStopJobParams, ResourcesStopJobResult, ResourcesStrain, ResourcesVerdict, SERVICE_MAX_FRAME_BYTES, ScreenCaptureParams, ScreenCaptureResult, ScreenDisplay, ScreenListParams, ScreenListResult, ServiceCancel, ServiceErrorMsg, ServiceHello, ServiceName, ServicePing, ServicePong, ServiceProgressMsg, ServiceRequest, ServiceResponse, ServiceShutdown, ServiceToCoreMsg, ServiceToken, ServiceWelcome, SessionAttachParams, SessionAttachResult, SessionControlChangedEvent, SessionDetachParams, SessionDetachResult, SessionListParams, SessionListResult, SessionReleaseParams, SessionReleaseResult, ShownSection, Signal, SpendAccount, SpendChat, SpendDay, SpendHelper, SpendIdle, SpendIdleScope, SpendLive, SpendModel, SpendScopes, SpendSplit, SpendStart, StackErrorsParams, StackErrorsResult, StackEvent, StackLogsParams, StackLogsResult, StackRunResult, StackServer, StackServerActionParams, StackServerActionResult, StackServerName, StackStartParams, StackStateParams, StackStateResult, StackStopParams, StackTone, type StatusCell, type StatusEvidence, type StatusRow, SysinfoGetParams, SysinfoGetResult, SysinfoHardwareParams, SysinfoHardwareResult, SystemNotifyParams, SystemNotifyResult, SystemOpenPathParams, SystemOpenPathResult, SystemOpenSettingsParams, SystemOpenSettingsResult, SystemOpenUrlParams, SystemOpenUrlResult, SystemSettingsPane, TOOL_CATALOG, TOOL_GROUPS, TOOL_LEVELS, TOOL_PLATFORMS, TitleCopies, TitleMismatch, type ToolGroup, type ToolGroupId, ToolLevel, ToolLevelResult, ToolName, ToolOutcome, type ToolPath, ToolPlatform, ToolResultsFile, type ToolState, type ToolStatus, ToolTransport, ToolsServiceProgress, ToolsWebSearchParams, VERSIONED_RESULT_OPS, VaultFieldSummary, VaultItemKind, VaultItemSummary, WEB_MAX_TEXT_CHARS, WebBrowserFetchParams, WebBrowserFetchResult, WebFetchParams, WebFetchResult, WebHeader, WebScrapePage, WebScrapeParams, WebScrapeResult, WebSearchHit, WebSearchParams, WebSearchQueryResult, WebSearchResult, WindowFocusParams, WindowFocusResult, WindowInfo, WindowListParams, WindowListResult, WindowMinimizeParams, WindowMinimizeResult, WindowMoveParams, WindowMoveResult, announcedVersion, buildToolStatus, builtOps, compareVersions, epochMs, forPeer, knows, negotiate, nonNegInt, renderToolStatusMarkdown, statusForPeer, u32, versionSubprotocol };