@ai-matrx/desktop-protocol 0.21.20 → 0.21.22

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.21.22
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/desktop-protocol/v0.21.21..npm/desktop-protocol/v0.21.22 -- apps/shared/desktop-protocol`).
+No source changes intended and no consumer action required.
+
+## 0.21.21
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/desktop-protocol/v0.21.20..npm/desktop-protocol/v0.21.21 -- apps/shared/desktop-protocol`).
+No source changes intended and no consumer action required.
+
 ## 0.21.20
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see

package/dist/client.cjs

@@ -144,7 +144,7 @@ var import_zod2 = require("zod");
 var import_zod = require("zod");
 var import_uuid = require("@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 = 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_-]+$/);
@@ -216,8 +216,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({
@@ -2458,7 +2469,12 @@ var AppsWindowsUpdateStateResult = import_zod30.z.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: import_zod30.z.array(ChatPlace).max(200)
+  closed: import_zod30.z.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: import_zod30.z.array(ChatPlace).max(200).optional()
 });
 var AppsWindowsReopenParams = import_zod30.z.strictObject({ app_key: AppKey, windows: import_zod30.z.array(ChatPlace).min(1).max(200) });
 var AppsWindowsReopenResult = import_zod30.z.strictObject({ message: import_zod30.z.string().max(400), opened: import_zod30.z.array(ChatPlace).max(200) });
@@ -2473,6 +2489,109 @@ var AppsWindowsUpdateAndReopenResult = import_zod30.z.strictObject({
   installed_version: import_zod30.z.string().max(64).nullable()
 });
 
+// src/schema/browser.ts
+var import_zod31 = require("zod");
+var BrowserClientInstance = import_zod31.z.string().min(1).max(64).regex(/^[A-Za-z0-9_.:-]+$/);
+var BrowserKind = import_zod31.z.enum(["chrome", "edge", "brave", "arc", "opera", "vivaldi", "chromium", "firefox", "other"]);
+var BrowserSessionState = import_zod31.z.enum(["connected", "different_account", "extension_signed_out", "device_signed_out", "unverified"]);
+var BrowserSession = import_zod31.z.strictObject({
+  client_instance: BrowserClientInstance,
+  /** What the person sees ("Chrome — Work"), set by the extension. */
+  client_label: import_zod31.z.string().min(1).max(128),
+  browser: BrowserKind,
+  extension_version: import_zod31.z.string().min(1).max(32),
+  state: BrowserSessionState,
+  /** True only for `connected`: an agent's call can reach this session. */
+  routable: import_zod31.z.boolean(),
+  /** The extension's account email from its token (null when signed out or unknown). */
+  account_email: import_zod31.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_zod31.z.boolean()
+});
+var BrowserRegisterParams = import_zod31.z.strictObject({
+  client_instance: BrowserClientInstance,
+  client_label: import_zod31.z.string().min(1).max(128),
+  browser: BrowserKind,
+  extension_version: import_zod31.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_zod31.z.string().min(16).max(8192).nullable()
+});
+var BrowserRegisterResult = import_zod31.z.strictObject({ session: BrowserSession });
+var BrowserCallError = import_zod31.z.strictObject({
+  message: import_zod31.z.string().max(1e3),
+  /** The extension's own error code, when it has one ("tool_not_found", "denied"). */
+  code: import_zod31.z.string().max(64).nullable()
+});
+var BrowserResultParams = import_zod31.z.strictObject({
+  call_id: import_zod31.z.string().min(1).max(64),
+  ok: import_zod31.z.boolean(),
+  /** The tool's result when ok (any JSON). */
+  result: import_zod31.z.unknown(),
+  error: BrowserCallError.nullable()
+});
+var BrowserResultResult = import_zod31.z.strictObject({ accepted: import_zod31.z.boolean() });
+var BrowserCallPhase = import_zod31.z.enum(["awaiting_confirmation", "running"]);
+var BrowserProgressParams = import_zod31.z.strictObject({ call_id: import_zod31.z.string().min(1).max(64), phase: BrowserCallPhase });
+var BrowserProgressResult = import_zod31.z.strictObject({ accepted: import_zod31.z.boolean() });
+var BrowserSessionsParams = import_zod31.z.strictObject({});
+var BrowserSessionsResult = import_zod31.z.strictObject({
+  /** The person's Browser connection switch. Off: no pairing, no extension sessions. */
+  enabled: import_zod31.z.boolean(),
+  /** Whether Matrx 2 is signed in (without an owner no session is routable). */
+  owner_signed_in: import_zod31.z.boolean(),
+  sessions: import_zod31.z.array(BrowserSession).max(64)
+});
+var BrowserDisconnectParams = import_zod31.z.strictObject({ client_instance: BrowserClientInstance });
+var BrowserDisconnectResult = import_zod31.z.strictObject({ disconnected: import_zod31.z.boolean() });
+var BrowserSetEnabledParams = import_zod31.z.strictObject({ enabled: import_zod31.z.boolean() });
+var BrowserSetEnabledResult = import_zod31.z.strictObject({ enabled: import_zod31.z.boolean() });
+var BrowserPairCodeParams = import_zod31.z.strictObject({});
+var BrowserPairCodeResult = import_zod31.z.strictObject({ code: import_zod31.z.string().min(16).max(128) });
+var BrowserPairResetParams = import_zod31.z.strictObject({});
+var BrowserCallParams = import_zod31.z.strictObject({
+  tool: import_zod31.z.string().min(1).max(96).regex(/^[a-z][a-z0-9_]*$/),
+  args: import_zod31.z.record(import_zod31.z.string(), import_zod31.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_zod31.z.int().min(1e3).max(6e5).optional()
+});
+var BrowserCallResult = import_zod31.z.strictObject({
+  client_instance: BrowserClientInstance,
+  result: import_zod31.z.unknown(),
+  duration_ms: nonNegInt
+});
+var BrowserInvokeEvent = import_zod31.z.strictObject({
+  call_id: import_zod31.z.string().min(1).max(64),
+  tool: import_zod31.z.string().min(1).max(96),
+  args: import_zod31.z.record(import_zod31.z.string(), import_zod31.z.unknown()),
+  deadline_ms: epochMs
+});
+var BrowserSessionsChangedEvent = import_zod31.z.strictObject({ count: nonNegInt, enabled: import_zod31.z.boolean() });
+var BrowserProgressEvent = import_zod31.z.strictObject({
+  call_id: import_zod31.z.string().min(1).max(64),
+  client_instance: BrowserClientInstance,
+  phase: BrowserCallPhase
+});
+var DesktopHealth = import_zod31.z.strictObject({
+  status: import_zod31.z.literal("ok"),
+  service: import_zod31.z.literal("matrx-desktop"),
+  version: import_zod31.z.string().max(32),
+  protocol_version: import_zod31.z.string().max(16),
+  ws_path: import_zod31.z.literal("/v1/connect"),
+  device_id: import_zod31.z.string().max(64),
+  browser_connection: import_zod31.z.enum(["on", "off"])
+});
+var BrowserPairRequest = import_zod31.z.strictObject({ client_instance: BrowserClientInstance });
+var BrowserPairResult = import_zod31.z.strictObject({ pair_token: import_zod31.z.string().min(16).max(128), ws_path: import_zod31.z.literal("/v1/connect") });
+
 // src/schema/registry.ts
 var FS_ERR = ["NOT_FOUND", "PERMISSION_DENIED_OS", "INVALID_PARAMS", "RESOURCE_BUSY", "INTERNAL"];
 var OPS = {
@@ -2618,7 +2737,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,
@@ -2632,7 +2761,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