@ai-matrx/desktop-protocol 0.21.21 → 0.21.22

package/dist/index.cjs

@@ -122,6 +122,34 @@ __export(src_exports, {
   AudioSetLevelsParams: () => AudioSetLevelsParams,
   BEARER_PREFIX: () => BEARER_PREFIX,
   BROADCAST_CID: () => BROADCAST_CID,
+  BrowserCallError: () => BrowserCallError,
+  BrowserCallParams: () => BrowserCallParams,
+  BrowserCallPhase: () => BrowserCallPhase,
+  BrowserCallResult: () => BrowserCallResult,
+  BrowserClientInstance: () => BrowserClientInstance,
+  BrowserDisconnectParams: () => BrowserDisconnectParams,
+  BrowserDisconnectResult: () => BrowserDisconnectResult,
+  BrowserInvokeEvent: () => BrowserInvokeEvent,
+  BrowserKind: () => BrowserKind,
+  BrowserPairCodeParams: () => BrowserPairCodeParams,
+  BrowserPairCodeResult: () => BrowserPairCodeResult,
+  BrowserPairRequest: () => BrowserPairRequest,
+  BrowserPairResetParams: () => BrowserPairResetParams,
+  BrowserPairResult: () => BrowserPairResult,
+  BrowserProgressEvent: () => BrowserProgressEvent,
+  BrowserProgressParams: () => BrowserProgressParams,
+  BrowserProgressResult: () => BrowserProgressResult,
+  BrowserRegisterParams: () => BrowserRegisterParams,
+  BrowserRegisterResult: () => BrowserRegisterResult,
+  BrowserResultParams: () => BrowserResultParams,
+  BrowserResultResult: () => BrowserResultResult,
+  BrowserSession: () => BrowserSession,
+  BrowserSessionState: () => BrowserSessionState,
+  BrowserSessionsChangedEvent: () => BrowserSessionsChangedEvent,
+  BrowserSessionsParams: () => BrowserSessionsParams,
+  BrowserSessionsResult: () => BrowserSessionsResult,
+  BrowserSetEnabledParams: () => BrowserSetEnabledParams,
+  BrowserSetEnabledResult: () => BrowserSetEnabledResult,
   CLOSE_RULES: () => CLOSE_RULES,
   CONTRACT_SHA256: () => CONTRACT_SHA256,
   CancelMsg: () => CancelMsg,
@@ -164,6 +192,8 @@ __export(src_exports, {
   DEFAULT_MAX_FRAME_PAYLOAD_BYTES: () => DEFAULT_MAX_FRAME_PAYLOAD_BYTES,
   DEFAULT_MAX_MESSAGE_BYTES: () => DEFAULT_MAX_MESSAGE_BYTES,
   DEFAULT_WINDOW_BYTES: () => DEFAULT_WINDOW_BYTES,
+  DISCOVERY_FILE: () => DISCOVERY_FILE,
+  DesktopHealth: () => DesktopHealth,
   DesktopProtocolError: () => DesktopProtocolError,
   DeviceId: () => DeviceId,
   DiagErrorEntry: () => DiagErrorEntry,
@@ -291,6 +321,7 @@ __export(src_exports, {
   LEGACY_ACTIONS: () => LEGACY_ACTIONS,
   LEGACY_DISPATCHERS: () => LEGACY_DISPATCHERS,
   Limits: () => Limits,
+  MATRX_EXTENSION_IDS: () => MATRX_EXTENSION_IDS,
   MlInstallPhase: () => MlInstallPhase,
   MlInstallProgress: () => MlInstallProgress,
   MlProgress: () => MlProgress,
@@ -522,7 +553,7 @@ module.exports = __toCommonJS(src_exports);
 var import_zod = require("zod");
 var import_uuid = require("@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 = import_zod.z.string().regex(/^[1-9][0-9]{0,2}\.[0-9]{1,3}$/);
 var RequestId = import_zod.z.string().min(1).max(64).regex(/^[A-Za-z0-9_-]+$/);
@@ -595,8 +626,19 @@ var ErrorReason = import_zod2.z.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 = import_zod2.z.strictObject({ edit_index: nonNegInt, reason: import_zod2.z.string().max(300) });
 var ProtocolErrorBody = import_zod2.z.strictObject({
@@ -3042,6 +3084,114 @@ var CodingHistoryProgressEvent = import_zod32.z.strictObject({
   failed: nonNegInt
 });
 
+// src/schema/browser.ts
+var import_zod33 = require("zod");
+var BrowserClientInstance = import_zod33.z.string().min(1).max(64).regex(/^[A-Za-z0-9_.:-]+$/);
+var BrowserKind = import_zod33.z.enum(["chrome", "edge", "brave", "arc", "opera", "vivaldi", "chromium", "firefox", "other"]);
+var BrowserSessionState = import_zod33.z.enum(["connected", "different_account", "extension_signed_out", "device_signed_out", "unverified"]);
+var BrowserSession = import_zod33.z.strictObject({
+  client_instance: BrowserClientInstance,
+  /** What the person sees ("Chrome — Work"), set by the extension. */
+  client_label: import_zod33.z.string().min(1).max(128),
+  browser: BrowserKind,
+  extension_version: import_zod33.z.string().min(1).max(32),
+  state: BrowserSessionState,
+  /** True only for `connected`: an agent's call can reach this session. */
+  routable: import_zod33.z.boolean(),
+  /** The extension's account email from its token (null when signed out or unknown). */
+  account_email: import_zod33.z.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: import_zod33.z.boolean()
+});
+var BrowserRegisterParams = import_zod33.z.strictObject({
+  client_instance: BrowserClientInstance,
+  client_label: import_zod33.z.string().min(1).max(128),
+  browser: BrowserKind,
+  extension_version: import_zod33.z.string().min(1).max(32),
+  /** The extension's current AI Matrx access token, checked against the device owner; null when signed out. */
+  account_token: import_zod33.z.string().min(16).max(8192).nullable()
+});
+var BrowserRegisterResult = import_zod33.z.strictObject({ session: BrowserSession });
+var BrowserCallError = import_zod33.z.strictObject({
+  message: import_zod33.z.string().max(1e3),
+  /** The extension's own error code, when it has one ("tool_not_found", "denied"). */
+  code: import_zod33.z.string().max(64).nullable()
+});
+var BrowserResultParams = import_zod33.z.strictObject({
+  call_id: import_zod33.z.string().min(1).max(64),
+  ok: import_zod33.z.boolean(),
+  /** The tool's result when ok (any JSON). */
+  result: import_zod33.z.unknown(),
+  error: BrowserCallError.nullable()
+});
+var BrowserResultResult = import_zod33.z.strictObject({ accepted: import_zod33.z.boolean() });
+var BrowserCallPhase = import_zod33.z.enum(["awaiting_confirmation", "running"]);
+var BrowserProgressParams = import_zod33.z.strictObject({ call_id: import_zod33.z.string().min(1).max(64), phase: BrowserCallPhase });
+var BrowserProgressResult = import_zod33.z.strictObject({ accepted: import_zod33.z.boolean() });
+var BrowserSessionsParams = import_zod33.z.strictObject({});
+var BrowserSessionsResult = import_zod33.z.strictObject({
+  /** The person's Browser connection switch. Off: no pairing, no extension sessions. */
+  enabled: import_zod33.z.boolean(),
+  /** Whether Matrx 2 is signed in (without an owner no session is routable). */
+  owner_signed_in: import_zod33.z.boolean(),
+  sessions: import_zod33.z.array(BrowserSession).max(64)
+});
+var BrowserDisconnectParams = import_zod33.z.strictObject({ client_instance: BrowserClientInstance });
+var BrowserDisconnectResult = import_zod33.z.strictObject({ disconnected: import_zod33.z.boolean() });
+var BrowserSetEnabledParams = import_zod33.z.strictObject({ enabled: import_zod33.z.boolean() });
+var BrowserSetEnabledResult = import_zod33.z.strictObject({ enabled: import_zod33.z.boolean() });
+var BrowserPairCodeParams = import_zod33.z.strictObject({});
+var BrowserPairCodeResult = import_zod33.z.strictObject({ code: import_zod33.z.string().min(16).max(128) });
+var BrowserPairResetParams = import_zod33.z.strictObject({});
+var BrowserCallParams = import_zod33.z.strictObject({
+  tool: import_zod33.z.string().min(1).max(96).regex(/^[a-z][a-z0-9_]*$/),
+  args: import_zod33.z.record(import_zod33.z.string(), import_zod33.z.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: import_zod33.z.int().min(1e3).max(6e5).optional()
+});
+var BrowserCallResult = import_zod33.z.strictObject({
+  client_instance: BrowserClientInstance,
+  result: import_zod33.z.unknown(),
+  duration_ms: nonNegInt
+});
+var BrowserInvokeEvent = import_zod33.z.strictObject({
+  call_id: import_zod33.z.string().min(1).max(64),
+  tool: import_zod33.z.string().min(1).max(96),
+  args: import_zod33.z.record(import_zod33.z.string(), import_zod33.z.unknown()),
+  deadline_ms: epochMs
+});
+var BrowserSessionsChangedEvent = import_zod33.z.strictObject({ count: nonNegInt, enabled: import_zod33.z.boolean() });
+var BrowserProgressEvent = import_zod33.z.strictObject({
+  call_id: import_zod33.z.string().min(1).max(64),
+  client_instance: BrowserClientInstance,
+  phase: BrowserCallPhase
+});
+var DesktopHealth = import_zod33.z.strictObject({
+  status: import_zod33.z.literal("ok"),
+  service: import_zod33.z.literal("matrx-desktop"),
+  version: import_zod33.z.string().max(32),
+  protocol_version: import_zod33.z.string().max(16),
+  ws_path: import_zod33.z.literal("/v1/connect"),
+  device_id: import_zod33.z.string().max(64),
+  browser_connection: import_zod33.z.enum(["on", "off"])
+});
+var BrowserPairRequest = import_zod33.z.strictObject({ client_instance: BrowserClientInstance });
+var BrowserPairResult = import_zod33.z.strictObject({ pair_token: import_zod33.z.string().min(16).max(128), ws_path: import_zod33.z.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 = {
@@ -3187,7 +3337,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,
@@ -3201,7 +3361,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: {
@@ -3654,7 +3817,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
@@ -3687,7 +3879,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"];
@@ -3806,7 +4003,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 = {