@ai-matrx/desktop-protocol 0.21.21 → 0.21.23

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.21.23
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/desktop-protocol/v0.21.22..npm/desktop-protocol/v0.21.23 -- apps/shared/desktop-protocol`).
+No source changes intended and no consumer action required.
+
+## 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

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 = 27;
+var PROTOCOL_MINOR = 29;
 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({
@@ -2378,6 +2389,44 @@ var AppsChatsColdResult = import_zod30.z.strictObject({
   /** Chats working right now (not waiting). */
   working: nonNegInt
 });
+var TitleCopies = import_zod30.z.strictObject({
+  window: ChatPlace,
+  /** Record copies in that window holding a different name (main keeps one per account folder). */
+  copies: nonNegInt,
+  titles: import_zod30.z.array(import_zod30.z.strictObject({ title: import_zod30.z.string().max(2e3), source: import_zod30.z.string().max(32) })).max(50)
+});
+var TitleMismatch = import_zod30.z.strictObject({
+  chat_id: ChatId,
+  /** The right name: the latest one a person gave it (in any window, or in Matrx), else the newest automatic title. */
+  title: import_zod30.z.string().max(2e3),
+  title_source: import_zod30.z.enum(["user", "auto"]),
+  /** Where the right name came from: a window, "matrx", or "ledger" (decided earlier). */
+  decided_from: import_zod30.z.string().max(64),
+  kind: import_zod30.z.enum(["user_vs_auto", "user_vs_user", "auto_vs_auto", "source_only"]),
+  windows: import_zod30.z.array(ChatPlace).max(200),
+  differs_in: import_zod30.z.array(TitleCopies).max(200)
+});
+var AppsChatsTitlesCheckParams = import_zod30.z.strictObject({ app_key: AppKey });
+var AppsChatsTitlesCheckResult = import_zod30.z.strictObject({
+  app_key: AppKey,
+  chats_total: nonNegInt,
+  chats_in_several_windows: nonNegInt,
+  /** Chats with a different name in some window (or in Matrx). */
+  chats_with_a_different_name: nonNegInt,
+  copies_to_write: nonNegInt,
+  chats: import_zod30.z.array(TitleMismatch).max(5e3)
+});
+var AppsChatsTitlesPushParams = import_zod30.z.strictObject({ app_key: AppKey, chat_id: ChatId.optional(), dry_run: import_zod30.z.boolean().optional() });
+var AppsChatsTitlesPushResult = import_zod30.z.strictObject({
+  app_key: AppKey,
+  /** Record files rewritten (title and titleSource only, each backed up first). */
+  written: nonNegInt,
+  chats_fixed: nonNegInt,
+  /** Copies that could not be written (left for the next push). */
+  failed: nonNegInt,
+  /** Still different after the push (dry_run: would be written). */
+  chats_with_a_different_name: nonNegInt
+});
 var AppsChatsOpenParams = import_zod30.z.strictObject({ app_key: AppKey, chat_id: ChatId, window: ChatPlace.optional() });
 var SpendSplit = import_zod30.z.strictObject({ main: import_zod30.z.number(), helpers: import_zod30.z.number() });
 var SpendScopes = import_zod30.z.strictObject({ today: SpendSplit, week: SpendSplit });
@@ -2478,6 +2527,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 = {
@@ -2540,6 +2692,8 @@ var OPS = {
   // 1.11: Going cold, Spend, sync health, windows upkeep.
   "apps.chats.cold": { params: AppsChatsColdParams, result: AppsChatsColdResult, kind: "unary", since: "1.11", errors: ["NOT_FOUND", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "apps.chats.open": { params: AppsChatsOpenParams, result: AppsWindowActionResult, kind: "unary", since: "1.11", errors: ["NOT_FOUND", "CONFLICT", "TIMEOUT", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "apps.chats.titles_check": { params: AppsChatsTitlesCheckParams, result: AppsChatsTitlesCheckResult, kind: "unary", since: "1.29", errors: ["NOT_FOUND", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "apps.chats.titles_push": { params: AppsChatsTitlesPushParams, result: AppsChatsTitlesPushResult, kind: "unary", since: "1.29", errors: ["NOT_FOUND", "CONFLICT", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "apps.spend": { params: AppsSpendParams, result: AppsSpendResult, kind: "unary", since: "1.11", errors: ["NOT_FOUND", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "apps.sync.status": { params: AppsSyncStatusParams, result: AppsSyncStatusResult, kind: "unary", since: "1.11", errors: ["NOT_FOUND", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "apps.sync.run": { params: AppsSyncRunParams, result: AppsWindowActionResult, kind: "unary", since: "1.11", errors: ["NOT_FOUND", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
@@ -2623,7 +2777,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,
@@ -2637,7 +2801,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