@ai-matrx/desktop-protocol 0.21.21 → 0.21.22

package/dist/index.js

@@ -2,7 +2,7 @@
 import { z } from "zod";
 import { UUID_SHAPE_PATTERN } from "@ai-matrx/kit/uuid";
 var PROTOCOL_MAJOR = 1;
-var PROTOCOL_MINOR = 27;
+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_-]+$/);
@@ -75,8 +75,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({
@@ -2522,6 +2533,114 @@ var CodingHistoryProgressEvent = z32.strictObject({
   failed: nonNegInt
 });
 
+// src/schema/browser.ts
+import { z as z33 } from "zod";
+var BrowserClientInstance = z33.string().min(1).max(64).regex(/^[A-Za-z0-9_.:-]+$/);
+var BrowserKind = z33.enum(["chrome", "edge", "brave", "arc", "opera", "vivaldi", "chromium", "firefox", "other"]);
+var BrowserSessionState = z33.enum(["connected", "different_account", "extension_signed_out", "device_signed_out", "unverified"]);
+var BrowserSession = z33.strictObject({
+  client_instance: BrowserClientInstance,
+  /** What the person sees ("Chrome — Work"), set by the extension. */
+  client_label: z33.string().min(1).max(128),
+  browser: BrowserKind,
+  extension_version: z33.string().min(1).max(32),
+  state: BrowserSessionState,
+  /** True only for `connected`: an agent's call can reach this session. */
+  routable: z33.boolean(),
+  /** The extension's account email from its token (null when signed out or unknown). */
+  account_email: z33.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: z33.boolean()
+});
+var BrowserRegisterParams = z33.strictObject({
+  client_instance: BrowserClientInstance,
+  client_label: z33.string().min(1).max(128),
+  browser: BrowserKind,
+  extension_version: z33.string().min(1).max(32),
+  /** The extension's current AI Matrx access token, checked against the device owner; null when signed out. */
+  account_token: z33.string().min(16).max(8192).nullable()
+});
+var BrowserRegisterResult = z33.strictObject({ session: BrowserSession });
+var BrowserCallError = z33.strictObject({
+  message: z33.string().max(1e3),
+  /** The extension's own error code, when it has one ("tool_not_found", "denied"). */
+  code: z33.string().max(64).nullable()
+});
+var BrowserResultParams = z33.strictObject({
+  call_id: z33.string().min(1).max(64),
+  ok: z33.boolean(),
+  /** The tool's result when ok (any JSON). */
+  result: z33.unknown(),
+  error: BrowserCallError.nullable()
+});
+var BrowserResultResult = z33.strictObject({ accepted: z33.boolean() });
+var BrowserCallPhase = z33.enum(["awaiting_confirmation", "running"]);
+var BrowserProgressParams = z33.strictObject({ call_id: z33.string().min(1).max(64), phase: BrowserCallPhase });
+var BrowserProgressResult = z33.strictObject({ accepted: z33.boolean() });
+var BrowserSessionsParams = z33.strictObject({});
+var BrowserSessionsResult = z33.strictObject({
+  /** The person's Browser connection switch. Off: no pairing, no extension sessions. */
+  enabled: z33.boolean(),
+  /** Whether Matrx 2 is signed in (without an owner no session is routable). */
+  owner_signed_in: z33.boolean(),
+  sessions: z33.array(BrowserSession).max(64)
+});
+var BrowserDisconnectParams = z33.strictObject({ client_instance: BrowserClientInstance });
+var BrowserDisconnectResult = z33.strictObject({ disconnected: z33.boolean() });
+var BrowserSetEnabledParams = z33.strictObject({ enabled: z33.boolean() });
+var BrowserSetEnabledResult = z33.strictObject({ enabled: z33.boolean() });
+var BrowserPairCodeParams = z33.strictObject({});
+var BrowserPairCodeResult = z33.strictObject({ code: z33.string().min(16).max(128) });
+var BrowserPairResetParams = z33.strictObject({});
+var BrowserCallParams = z33.strictObject({
+  tool: z33.string().min(1).max(96).regex(/^[a-z][a-z0-9_]*$/),
+  args: z33.record(z33.string(), z33.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: z33.int().min(1e3).max(6e5).optional()
+});
+var BrowserCallResult = z33.strictObject({
+  client_instance: BrowserClientInstance,
+  result: z33.unknown(),
+  duration_ms: nonNegInt
+});
+var BrowserInvokeEvent = z33.strictObject({
+  call_id: z33.string().min(1).max(64),
+  tool: z33.string().min(1).max(96),
+  args: z33.record(z33.string(), z33.unknown()),
+  deadline_ms: epochMs
+});
+var BrowserSessionsChangedEvent = z33.strictObject({ count: nonNegInt, enabled: z33.boolean() });
+var BrowserProgressEvent = z33.strictObject({
+  call_id: z33.string().min(1).max(64),
+  client_instance: BrowserClientInstance,
+  phase: BrowserCallPhase
+});
+var DesktopHealth = z33.strictObject({
+  status: z33.literal("ok"),
+  service: z33.literal("matrx-desktop"),
+  version: z33.string().max(32),
+  protocol_version: z33.string().max(16),
+  ws_path: z33.literal("/v1/connect"),
+  device_id: z33.string().max(64),
+  browser_connection: z33.enum(["on", "off"])
+});
+var BrowserPairRequest = z33.strictObject({ client_instance: BrowserClientInstance });
+var BrowserPairResult = z33.strictObject({ pair_token: z33.string().min(16).max(128), ws_path: z33.literal("/v1/connect") });
+var MATRX_EXTENSION_IDS = {
+  store: "hnfolienncfklkgmdjjmhhegglimlamg",
+  development: "cihdmkcdjjckfhjpgoedmgfpoljebaml"
+};
+var DISCOVERY_FILE = { live: "matrx2.json", development: "matrx2-dev.json" };
+
 // src/schema/registry.ts
 var FS_ERR = ["NOT_FOUND", "PERMISSION_DENIED_OS", "INVALID_PARAMS", "RESOURCE_BUSY", "INTERNAL"];
 var OPS = {
@@ -2667,7 +2786,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,
@@ -2681,7 +2810,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
 };
 var SERVICES = {
   ml: {
@@ -3134,7 +3266,36 @@ var NAMED_SCHEMAS = {
   AppsWindowsReopenParams,
   AppsWindowsReopenResult,
   AppsWindowsUpdateAndReopenParams,
-  AppsWindowsUpdateAndReopenResult
+  AppsWindowsUpdateAndReopenResult,
+  BrowserClientInstance,
+  BrowserKind,
+  BrowserSessionState,
+  BrowserSession,
+  BrowserRegisterParams,
+  BrowserRegisterResult,
+  BrowserCallError,
+  BrowserResultParams,
+  BrowserResultResult,
+  BrowserCallPhase,
+  BrowserProgressParams,
+  BrowserProgressResult,
+  BrowserSessionsParams,
+  BrowserSessionsResult,
+  BrowserDisconnectParams,
+  BrowserDisconnectResult,
+  BrowserSetEnabledParams,
+  BrowserSetEnabledResult,
+  BrowserPairCodeParams,
+  BrowserPairCodeResult,
+  BrowserPairResetParams,
+  BrowserCallParams,
+  BrowserCallResult,
+  BrowserInvokeEvent,
+  BrowserSessionsChangedEvent,
+  BrowserProgressEvent,
+  DesktopHealth,
+  BrowserPairRequest,
+  BrowserPairResult
 };
 
 // src/versioning.ts
@@ -3167,7 +3328,12 @@ var REASONS_SINCE = {
   download_failed: "1.2",
   service_starting: "1.2",
   service_restarted: "1.2",
-  service_failed: "1.2"
+  service_failed: "1.2",
+  browser_not_connected: "1.28",
+  browser_ambiguous: "1.28",
+  browser_account_mismatch: "1.28",
+  browser_connection_off: "1.28",
+  awaiting_confirmation: "1.28"
 };
 function statusForPeer(status, version) {
   const rule = NULL_SINCE["RelayDeviceStatusEvent.since_ms"];
@@ -3286,7 +3452,7 @@ function forPeer(op, part, value, version) {
 var VERSIONED_RESULT_OPS = [.../* @__PURE__ */ new Set([...RESULT_PATH.keys(), ...WINDOW_RESULTS.keys(), ...NESTED_RESULTS.keys()])];
 
 // src/contract.ts
-var CONTRACT_SHA256 = "eece2e5eba3e6e33126a0fda2fad8c91abe9c878fbfdc98bd049ff5af126cb09";
+var CONTRACT_SHA256 = "d328d624d1de854696a07e9fb8f1e85894047e5c41164647944db79b3c1a638d";
 
 // src/close-policy.ts
 var CLOSE_RULES = {
@@ -3731,6 +3897,34 @@ export {
   AudioSetLevelsParams,
   BEARER_PREFIX,
   BROADCAST_CID,
+  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,
   CLOSE_RULES,
   CONTRACT_SHA256,
   CancelMsg,
@@ -3773,6 +3967,8 @@ export {
   DEFAULT_MAX_FRAME_PAYLOAD_BYTES,
   DEFAULT_MAX_MESSAGE_BYTES,
   DEFAULT_WINDOW_BYTES,
+  DISCOVERY_FILE,
+  DesktopHealth,
   DesktopProtocolError,
   DeviceId,
   DiagErrorEntry,
@@ -3900,6 +4096,7 @@ export {
   LEGACY_ACTIONS,
   LEGACY_DISPATCHERS,
   Limits,
+  MATRX_EXTENSION_IDS,
   MlInstallPhase,
   MlInstallProgress,
   MlProgress,