@ai-matrx/desktop-protocol 0.21.20 → 0.21.22

package/dist/client.d.cts

@@ -1,8 +1,8 @@
 import { BackoffOptions } from '@ai-matrx/realtime';
 export { RECONNECT_ALARM_ATTEMPTS } from '@ai-matrx/realtime';
 import { z } from 'zod';
-import { W as Welcome, D as DesktopProtocolError, C as CloseOutcome, O as OpName, a as OpParams, b as OpResult, c as OPS, S as StreamMeta, E as EndReason, d as EVENTS, e as ClientType, M as ModelsTranscribeResult, T as TranscriptionModelId, f as MlProgress } from './models-Cx6q_tRu.cjs';
-export { i as isDesktopProtocolError } from './models-Cx6q_tRu.cjs';
+import { W as Welcome, D as DesktopProtocolError, C as CloseOutcome, O as OpName, a as OpParams, b as OpResult, c as OPS, S as StreamMeta, E as EndReason, d as EVENTS, e as ClientType, M as ModelsTranscribeResult, T as TranscriptionModelId, f as MlProgress } from './models-qdApKBdY.cjs';
+export { i as isDesktopProtocolError } from './models-qdApKBdY.cjs';
 import { FrameHeader } from './frame.cjs';
 
 /** The subset of the WHATWG WebSocket the client uses — browser, React Native, `ws` and Workers all fit. */

package/dist/client.d.ts

@@ -1,8 +1,8 @@
 import { BackoffOptions } from '@ai-matrx/realtime';
 export { RECONNECT_ALARM_ATTEMPTS } from '@ai-matrx/realtime';
 import { z } from 'zod';
-import { W as Welcome, D as DesktopProtocolError, C as CloseOutcome, O as OpName, a as OpParams, b as OpResult, c as OPS, S as StreamMeta, E as EndReason, d as EVENTS, e as ClientType, M as ModelsTranscribeResult, T as TranscriptionModelId, f as MlProgress } from './models-Cx6q_tRu.js';
-export { i as isDesktopProtocolError } from './models-Cx6q_tRu.js';
+import { W as Welcome, D as DesktopProtocolError, C as CloseOutcome, O as OpName, a as OpParams, b as OpResult, c as OPS, S as StreamMeta, E as EndReason, d as EVENTS, e as ClientType, M as ModelsTranscribeResult, T as TranscriptionModelId, f as MlProgress } from './models-qdApKBdY.js';
+export { i as isDesktopProtocolError } from './models-qdApKBdY.js';
 import { FrameHeader } from './frame.js';
 
 /** The subset of the WHATWG WebSocket the client uses — browser, React Native, `ws` and Workers all fit. */

package/dist/client.js

@@ -112,7 +112,7 @@ import { z as z2 } from "zod";
 import { z } from "zod";
 import { UUID_SHAPE_PATTERN } from "@ai-matrx/kit/uuid";
 var PROTOCOL_MAJOR = 1;
-var PROTOCOL_MINOR = 26;
+var PROTOCOL_MINOR = 28;
 var PROTOCOL_VERSION = `${PROTOCOL_MAJOR}.${PROTOCOL_MINOR}`;
 var ProtocolVersion = z.string().regex(/^[1-9][0-9]{0,2}\.[0-9]{1,3}$/);
 var RequestId = z.string().min(1).max(64).regex(/^[A-Za-z0-9_-]+$/);
@@ -184,8 +184,19 @@ var ErrorReason = z2.enum([
   // RESOURCE_BUSY (retryable): the service is starting or restarting
   "service_restarted",
   // RESOURCE_GONE: the service died while this request ran
-  "service_failed"
+  "service_failed",
   // INTERNAL: the service could not be started (see models.status)
+  // 1.28 (REASONS_SINCE): the `browser` capability (the AI Matrx extension as Matrx 2's client)
+  "browser_not_connected",
+  // NOT_FOUND: no browser with the extension is connected (or none routable)
+  "browser_ambiguous",
+  // CONFLICT: several browsers are connected and none was named
+  "browser_account_mismatch",
+  // AUTH_FORBIDDEN: the named browser is signed in to another account
+  "browser_connection_off",
+  // AUTH_FORBIDDEN: the person turned Browser connection off
+  "awaiting_confirmation"
+  // TIMEOUT: the person did not answer the browser's confirmation in time
 ]);
 var FsPatchEditFailure = z2.strictObject({ edit_index: nonNegInt, reason: z2.string().max(300) });
 var ProtocolErrorBody = z2.strictObject({
@@ -2426,7 +2437,12 @@ var AppsWindowsUpdateStateResult = z30.strictObject({
   /** When the update became pending (the download's time), when known. */
   since_ms: epochMs.nullable(),
   /** Windows open when the update became pending (or last seen open) that are closed now. */
-  closed: z30.array(ChatPlace).max(200)
+  closed: z30.array(ChatPlace).max(200),
+  /**
+   * Since 1.27: the windows in `closed` that the update itself quit (the app's log records a quit for
+   * the update within a minute of when each was last seen running). Absent: not known.
+   */
+  closed_by_update: z30.array(ChatPlace).max(200).optional()
 });
 var AppsWindowsReopenParams = z30.strictObject({ app_key: AppKey, windows: z30.array(ChatPlace).min(1).max(200) });
 var AppsWindowsReopenResult = z30.strictObject({ message: z30.string().max(400), opened: z30.array(ChatPlace).max(200) });
@@ -2441,6 +2457,109 @@ var AppsWindowsUpdateAndReopenResult = z30.strictObject({
   installed_version: z30.string().max(64).nullable()
 });
 
+// src/schema/browser.ts
+import { z as z31 } from "zod";
+var BrowserClientInstance = z31.string().min(1).max(64).regex(/^[A-Za-z0-9_.:-]+$/);
+var BrowserKind = z31.enum(["chrome", "edge", "brave", "arc", "opera", "vivaldi", "chromium", "firefox", "other"]);
+var BrowserSessionState = z31.enum(["connected", "different_account", "extension_signed_out", "device_signed_out", "unverified"]);
+var BrowserSession = z31.strictObject({
+  client_instance: BrowserClientInstance,
+  /** What the person sees ("Chrome — Work"), set by the extension. */
+  client_label: z31.string().min(1).max(128),
+  browser: BrowserKind,
+  extension_version: z31.string().min(1).max(32),
+  state: BrowserSessionState,
+  /** True only for `connected`: an agent's call can reach this session. */
+  routable: z31.boolean(),
+  /** The extension's account email from its token (null when signed out or unknown). */
+  account_email: z31.string().max(320).nullable(),
+  connected_at_ms: epochMs,
+  last_call_at_ms: epochMs.nullable(),
+  calls: nonNegInt,
+  errors: nonNegInt,
+  /** Call latency over the last 200 calls; null before the first. */
+  p50_ms: nonNegInt.nullable(),
+  p95_ms: nonNegInt.nullable(),
+  /** A call is waiting for the person to confirm it in the browser. */
+  awaiting_confirmation: z31.boolean()
+});
+var BrowserRegisterParams = z31.strictObject({
+  client_instance: BrowserClientInstance,
+  client_label: z31.string().min(1).max(128),
+  browser: BrowserKind,
+  extension_version: z31.string().min(1).max(32),
+  /** The extension's current AI Matrx access token, checked against the device owner; null when signed out. */
+  account_token: z31.string().min(16).max(8192).nullable()
+});
+var BrowserRegisterResult = z31.strictObject({ session: BrowserSession });
+var BrowserCallError = z31.strictObject({
+  message: z31.string().max(1e3),
+  /** The extension's own error code, when it has one ("tool_not_found", "denied"). */
+  code: z31.string().max(64).nullable()
+});
+var BrowserResultParams = z31.strictObject({
+  call_id: z31.string().min(1).max(64),
+  ok: z31.boolean(),
+  /** The tool's result when ok (any JSON). */
+  result: z31.unknown(),
+  error: BrowserCallError.nullable()
+});
+var BrowserResultResult = z31.strictObject({ accepted: z31.boolean() });
+var BrowserCallPhase = z31.enum(["awaiting_confirmation", "running"]);
+var BrowserProgressParams = z31.strictObject({ call_id: z31.string().min(1).max(64), phase: BrowserCallPhase });
+var BrowserProgressResult = z31.strictObject({ accepted: z31.boolean() });
+var BrowserSessionsParams = z31.strictObject({});
+var BrowserSessionsResult = z31.strictObject({
+  /** The person's Browser connection switch. Off: no pairing, no extension sessions. */
+  enabled: z31.boolean(),
+  /** Whether Matrx 2 is signed in (without an owner no session is routable). */
+  owner_signed_in: z31.boolean(),
+  sessions: z31.array(BrowserSession).max(64)
+});
+var BrowserDisconnectParams = z31.strictObject({ client_instance: BrowserClientInstance });
+var BrowserDisconnectResult = z31.strictObject({ disconnected: z31.boolean() });
+var BrowserSetEnabledParams = z31.strictObject({ enabled: z31.boolean() });
+var BrowserSetEnabledResult = z31.strictObject({ enabled: z31.boolean() });
+var BrowserPairCodeParams = z31.strictObject({});
+var BrowserPairCodeResult = z31.strictObject({ code: z31.string().min(16).max(128) });
+var BrowserPairResetParams = z31.strictObject({});
+var BrowserCallParams = z31.strictObject({
+  tool: z31.string().min(1).max(96).regex(/^[a-z][a-z0-9_]*$/),
+  args: z31.record(z31.string(), z31.unknown()),
+  /** Which session; default: the most recently active routable one (BROWSER ambiguity → CONFLICT). */
+  client_instance: BrowserClientInstance.optional(),
+  /** How long to wait, including a person's confirmation; default 120 s. */
+  timeout_ms: z31.int().min(1e3).max(6e5).optional()
+});
+var BrowserCallResult = z31.strictObject({
+  client_instance: BrowserClientInstance,
+  result: z31.unknown(),
+  duration_ms: nonNegInt
+});
+var BrowserInvokeEvent = z31.strictObject({
+  call_id: z31.string().min(1).max(64),
+  tool: z31.string().min(1).max(96),
+  args: z31.record(z31.string(), z31.unknown()),
+  deadline_ms: epochMs
+});
+var BrowserSessionsChangedEvent = z31.strictObject({ count: nonNegInt, enabled: z31.boolean() });
+var BrowserProgressEvent = z31.strictObject({
+  call_id: z31.string().min(1).max(64),
+  client_instance: BrowserClientInstance,
+  phase: BrowserCallPhase
+});
+var DesktopHealth = z31.strictObject({
+  status: z31.literal("ok"),
+  service: z31.literal("matrx-desktop"),
+  version: z31.string().max(32),
+  protocol_version: z31.string().max(16),
+  ws_path: z31.literal("/v1/connect"),
+  device_id: z31.string().max(64),
+  browser_connection: z31.enum(["on", "off"])
+});
+var BrowserPairRequest = z31.strictObject({ client_instance: BrowserClientInstance });
+var BrowserPairResult = z31.strictObject({ pair_token: z31.string().min(16).max(128), ws_path: z31.literal("/v1/connect") });
+
 // src/schema/registry.ts
 var FS_ERR = ["NOT_FOUND", "PERMISSION_DENIED_OS", "INVALID_PARAMS", "RESOURCE_BUSY", "INTERNAL"];
 var OPS = {
@@ -2586,7 +2705,17 @@ var OPS = {
   // 1.26: the app's own update (it installs only once every window quit) and bringing the windows back.
   "apps.windows.update_state": { params: AppsWindowsUpdateStateParams, result: AppsWindowsUpdateStateResult, kind: "unary", since: "1.26", errors: ["NOT_FOUND", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "apps.windows.reopen": { params: AppsWindowsReopenParams, result: AppsWindowsReopenResult, kind: "unary", since: "1.26", errors: ["NOT_FOUND", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
-  "apps.windows.update_and_reopen": { params: AppsWindowsUpdateAndReopenParams, result: AppsWindowsUpdateAndReopenResult, kind: "unary", since: "1.26", errors: ["NOT_FOUND", "CONFLICT", "TIMEOUT", "PLATFORM_UNSUPPORTED", "INTERNAL"] }
+  "apps.windows.update_and_reopen": { params: AppsWindowsUpdateAndReopenParams, result: AppsWindowsUpdateAndReopenResult, kind: "unary", since: "1.26", errors: ["NOT_FOUND", "CONFLICT", "TIMEOUT", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  // 1.28: the AI Matrx extension as a client (register, result, progress), the Browsers screen, and agents' calls.
+  "browser.register": { params: BrowserRegisterParams, result: BrowserRegisterResult, kind: "unary", since: "1.28", errors: ["AUTH_FORBIDDEN", "INVALID_PARAMS", "INTERNAL"] },
+  "browser.result": { params: BrowserResultParams, result: BrowserResultResult, kind: "unary", since: "1.28", errors: ["AUTH_FORBIDDEN", "PAYLOAD_TOO_LARGE"] },
+  "browser.progress": { params: BrowserProgressParams, result: BrowserProgressResult, kind: "unary", since: "1.28", errors: ["AUTH_FORBIDDEN"] },
+  "browser.sessions": { params: BrowserSessionsParams, result: BrowserSessionsResult, kind: "unary", since: "1.28", errors: ["INTERNAL"] },
+  "browser.disconnect": { params: BrowserDisconnectParams, result: BrowserDisconnectResult, kind: "unary", since: "1.28", errors: ["NOT_FOUND", "AUTH_FORBIDDEN"] },
+  "browser.set_enabled": { params: BrowserSetEnabledParams, result: BrowserSetEnabledResult, kind: "unary", since: "1.28", errors: ["AUTH_FORBIDDEN", "INTERNAL"] },
+  "browser.pair_code": { params: BrowserPairCodeParams, result: BrowserPairCodeResult, kind: "unary", since: "1.28", errors: ["AUTH_FORBIDDEN", "INTERNAL"] },
+  "browser.pair_reset": { params: BrowserPairResetParams, result: BrowserPairCodeResult, kind: "unary", since: "1.28", errors: ["AUTH_FORBIDDEN", "INTERNAL"] },
+  "browser.call": { params: BrowserCallParams, result: BrowserCallResult, kind: "unary", since: "1.28", errors: ["NOT_FOUND", "CONFLICT", "AUTH_FORBIDDEN", "INVALID_PARAMS", "TIMEOUT", "CANCELLED", "RESOURCE_GONE", "PAYLOAD_TOO_LARGE", "INTERNAL"] }
 };
 var EVENTS = {
   "fs.changed": FsChangedEvent,
@@ -2600,7 +2729,10 @@ var EVENTS = {
   "coding.history.progress": CodingHistoryProgressEvent,
   "relay.device_status": RelayDeviceStatusEvent,
   "relay.auth_expiring": RelayAuthExpiringEvent,
-  "diag.errors.changed": DiagErrorsChangedEvent
+  "diag.errors.changed": DiagErrorsChangedEvent,
+  "browser.invoke": BrowserInvokeEvent,
+  "browser.sessions_changed": BrowserSessionsChangedEvent,
+  "browser.progress": BrowserProgressEvent
 };
 
 // src/client/client.ts