@ai-matrx/desktop-protocol 0.21.50 → 0.21.52

package/CHANGELOG.md

@@ -1,7 +1,31 @@
 # Changelog
 
-## 0.21.50
+## 0.21.52
 ### Unreleased
+### Protocol 1.57 — the account a coding record belongs to, and each sign-in's usage
+
+- `accountId` (optional) on `CodingSessionRecord`, `CodingDiscoveredChat`, `CodingRecentRow` and
+  the new named `CodingSearchHit`: the account a session runs as, or whose config directory holds
+  the chat; absent = the default sign-in. Before this, the engine's `accountId` on Recent rows and
+  search hits made `coding.sessions.list` and `coding.search` fail "did not match its schema".
+- `coding.providers`: `usage` (`CodingAccountUsage`) and `continueOn` (`CodingContinueTarget`) on a
+  provider and on each of its `accounts` (now the named `CodingProviderAccount`, with its own
+  `ready`, `lastProblem`, `problem`, `fix`).
+- All optional, in FIELDS_SINCE, stripped by `forPeer` for a 1.56 peer (accounts' fields one level
+  below the providers). Consumer action: none for an older client; a 1.57 client can show the
+  account and "Continue on <account>" remotely.
+- coding-sessions now parses every engine answer with these strict schemas (its wire-contract test).
+
+## 0.21.51
+### Unreleased
+### Protocol 1.56 — Continue on another account, from anywhere
+
+- New op `coding.account.continue` ({session_id, account_profile_id?, client_request_id}) →
+  {session, run, how: "moved" | "fresh"}: the session moves to another of the person's accounts for
+  its app (absent `account_profile_id`: the default sign-in) and the turn a limit or the person
+  stopped is sent again there, exactly once per request id. In `coding_sessions_drive`.
+  Consumer action: a 1.55 core answers UNKNOWN_OPERATION; say that computer needs an update.
+
 ### Protocol 1.55 — copy chats to another account with their organisation
 
 - New op `apps.chats.copy_to_account` ({origin, target, chat_ids, mode, restart, mirror_groups,

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 = 55;
+var PROTOCOL_MINOR = 57;
 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_-]+$/);
@@ -2481,7 +2481,12 @@ var CodingSessionRecord = import_zod28.z.strictObject({
   lastRunStatus: CodingRunStatus.nullable(),
   queued: import_zod28.z.array(import_zod28.z.string().max(1048576)).max(100),
   agent: CodingSessionAgent.nullable(),
-  agentRemovedDue: import_zod28.z.boolean()
+  agentRemovedDue: import_zod28.z.boolean(),
+  /**
+   * (1.57) Claude Code: the account the record belongs to (Accounts' profile id): the one a session
+   * runs as, or whose config directory holds the chat. Absent: the default sign-in.
+   */
+  accountId: import_zod28.z.string().min(1).max(64).optional()
 });
 var CodingActiveElsewhere = import_zod28.z.strictObject({
   reason: import_zod28.z.enum(["process", "recent-write", "open-tool-call", "open"]),
@@ -2503,7 +2508,12 @@ var CodingDiscoveredChat = import_zod28.z.strictObject({
   unavailable: ShortText.nullable(),
   updatedAt: IsoTime,
   source: import_zod28.z.string().max(60).nullable(),
-  activeElsewhere: CodingActiveElsewhere.nullable()
+  activeElsewhere: CodingActiveElsewhere.nullable(),
+  /**
+   * (1.57) Claude Code: the account the record belongs to (Accounts' profile id): the one a session
+   * runs as, or whose config directory holds the chat. Absent: the default sign-in.
+   */
+  accountId: import_zod28.z.string().min(1).max(64).optional()
 });
 var CodingTranscriptItem = import_zod28.z.discriminatedUnion("kind", [
   import_zod28.z.strictObject({ kind: import_zod28.z.literal("user"), id: import_zod28.z.string().max(200), text: import_zod28.z.string(), at: IsoTime.nullable() }),
@@ -2543,6 +2553,31 @@ var CodingProviderProblem = import_zod28.z.strictObject({
   until: import_zod28.z.string().max(120).nullable(),
   at: IsoTime
 });
+var CodingAccountUsage = import_zod28.z.strictObject({
+  windows: import_zod28.z.array(CodingQuotaWindow).max(20),
+  /** The provider's own status word ("allowed", "allowed_warning", "rejected"...), when it gives one. */
+  status: import_zod28.z.string().max(60).nullable(),
+  /** When a rejected status lifts (ISO), when the provider says. */
+  resetsAt: import_zod28.z.string().max(80).nullable(),
+  at: IsoTime
+});
+var CodingContinueTarget = import_zod28.z.strictObject({
+  accountId: import_zod28.z.string().min(1).max(64).nullable(),
+  label: import_zod28.z.string().max(200)
+});
+var CodingProviderAccount = import_zod28.z.strictObject({
+  id: import_zod28.z.string().min(1).max(64),
+  label: import_zod28.z.string().max(200),
+  /** (1.57) No known usage limit or expired sign-in on this account. Absent: not read. */
+  ready: import_zod28.z.boolean().optional(),
+  lastProblem: CodingProviderProblem.optional(),
+  problem: ShortText.optional(),
+  fix: ShortText.optional(),
+  /** (1.57) Absent: never seen ("No usage data yet"). */
+  usage: CodingAccountUsage.optional(),
+  /** (1.57) This account is limited and that other one is not: "Continue on <label>". */
+  continueOn: CodingContinueTarget.optional()
+});
 var CodingProviderBinary = import_zod28.z.strictObject({
   path: LocalPath,
   version: import_zod28.z.string().max(80).nullable(),
@@ -2579,9 +2614,13 @@ var CodingProviderStatus = import_zod28.z.strictObject({
    * can use, as the computer's engine lists them; New session offers them beside the default sign-in.
    * Absent: only the default sign-in (or a computer older than 1.53).
    */
-  accounts: import_zod28.z.array(import_zod28.z.strictObject({ id: import_zod28.z.string().min(1).max(64), label: import_zod28.z.string().max(200) })).max(100).optional(),
+  accounts: import_zod28.z.array(CodingProviderAccount).max(100).optional(),
   /** (1.53) The computer tried to list `accounts` and could not: a short sentence the form shows with a retry. */
-  accountsProblem: ShortText.optional()
+  accountsProblem: ShortText.optional(),
+  /** (1.57) The default sign-in's usage as last seen. Absent: never seen ("No usage data yet"). */
+  usage: CodingAccountUsage.optional(),
+  /** (1.57) The default sign-in is limited and this other account is not: "Continue on <label>". */
+  continueOn: CodingContinueTarget.optional()
 });
 var CodingChatPreference = import_zod28.z.strictObject({
   title: import_zod28.z.string().max(500).nullable(),
@@ -2608,7 +2647,12 @@ var CodingRecentRow = import_zod28.z.strictObject({
   state: import_zod28.z.enum(["running", "needs_attention", "new_output", "elsewhere", "idle"]),
   stateLabel: import_zod28.z.string().max(120).nullable(),
   pinned: import_zod28.z.boolean(),
-  startedBy: CodingStartedBy.nullable()
+  startedBy: CodingStartedBy.nullable(),
+  /**
+   * (1.57) Claude Code: the account the record belongs to (Accounts' profile id): the one a session
+   * runs as, or whose config directory holds the chat. Absent: the default sign-in.
+   */
+  accountId: import_zod28.z.string().min(1).max(64).optional()
 });
 var CodingFolderCheck = import_zod28.z.strictObject({
   path: import_zod28.z.string().max(4096),
@@ -2703,6 +2747,16 @@ var CodingOptionsSetParams = import_zod28.z.strictObject({
   effort: import_zod28.z.string().max(40).optional()
 });
 var CodingOptionsSetResult = import_zod28.z.strictObject({ session: CodingSessionRecord });
+var CodingAccountContinueParams = import_zod28.z.strictObject({
+  session_id: SessionKey,
+  account_profile_id: import_zod28.z.string().min(1).max(64).optional(),
+  client_request_id: CodingClientRequestId
+});
+var CodingAccountContinueResult = import_zod28.z.strictObject({
+  session: CodingSessionRecord,
+  run: CodingRunRecord.nullable(),
+  how: import_zod28.z.enum(["moved", "fresh"])
+});
 var CodingAgentSetParams = import_zod28.z.strictObject({ session_id: SessionKey, agent: CodingAgentSelectionParams.optional() });
 var CodingAgentSetResult = import_zod28.z.strictObject({ session: CodingSessionRecord });
 var CodingAgentsAccessParams = import_zod28.z.strictObject({});
@@ -2731,19 +2785,23 @@ var CodingSearchParams = import_zod28.z.strictObject({
   cursor: nonNegInt.optional(),
   limit: import_zod28.z.int().min(1).max(100).optional()
 });
+var CodingSearchHit = import_zod28.z.strictObject({
+  provider: CodingProviderName,
+  providerSessionId: SessionKey,
+  title: import_zod28.z.string().max(500),
+  cwd: LocalPath.nullable(),
+  updatedAt: IsoTime,
+  where: import_zod28.z.enum(["title", "content"]),
+  snippet: import_zod28.z.string().max(2e3).nullable(),
+  /**
+   * (1.57) Claude Code: the account the record belongs to (Accounts' profile id): the one a session
+   * runs as, or whose config directory holds the chat. Absent: the default sign-in.
+   */
+  accountId: import_zod28.z.string().min(1).max(64).optional()
+});
 var CodingSearchResult = import_zod28.z.strictObject({
   query: import_zod28.z.string().max(500),
-  hits: import_zod28.z.array(
-    import_zod28.z.strictObject({
-      provider: CodingProviderName,
-      providerSessionId: SessionKey,
-      title: import_zod28.z.string().max(500),
-      cwd: LocalPath.nullable(),
-      updatedAt: IsoTime,
-      where: import_zod28.z.enum(["title", "content"]),
-      snippet: import_zod28.z.string().max(2e3).nullable()
-    })
-  ),
+  hits: import_zod28.z.array(CodingSearchHit),
   scanned: nonNegInt,
   total: nonNegInt,
   nextCursor: nonNegInt.nullable()
@@ -3583,6 +3641,12 @@ var AppsAccountsListResult = import_zod32.z.strictObject({
   as_of_ms: epochMs.optional(),
   refreshing: import_zod32.z.boolean().optional()
 });
+var AppsWindowsSetAccountParams = import_zod32.z.strictObject({ app_key: AppKey, window: ChatPlace, email: import_zod32.z.string().min(3).max(320) });
+var AppsWindowsForgetParams = import_zod32.z.strictObject({ app_key: AppKey, window: ChatPlace });
+var ProbeFact = import_zod32.z.strictObject({ key: import_zod32.z.string().max(200), value: import_zod32.z.string().max(2e3) });
+var ProbeSource = import_zod32.z.strictObject({ source: import_zod32.z.string().max(120), instance: import_zod32.z.string().max(64).nullable(), facts: import_zod32.z.array(ProbeFact).max(500) });
+var AppsChatsProbeParams = import_zod32.z.strictObject({ app_key: AppKey, chat_id: import_zod32.z.string().regex(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/) });
+var AppsChatsProbeResult = import_zod32.z.strictObject({ app_key: AppKey, chat_id: import_zod32.z.string().max(128), sources: import_zod32.z.array(ProbeSource).max(200) });
 
 // src/schema/browser.ts
 var import_zod33 = require("zod");
@@ -4429,6 +4493,10 @@ var OPS = {
   // 1.47: instances and accounts kept apart — an account's usage is the account's, every instance shows it by id.
   "apps.instances.list": { params: AppsInstancesListParams, result: AppsInstancesListResult, kind: "unary", since: "1.47", errors: ["NOT_FOUND", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "apps.accounts.list": { params: AppsAccountsListParams, result: AppsAccountsListResult, kind: "unary", since: "1.47", errors: ["NOT_FOUND", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  // 1.56: an instance's kept-for account and forgetting it (the app's own tool writes both); every raw fact about one chat.
+  "apps.windows.set_account": { params: AppsWindowsSetAccountParams, result: AppsWindowActionResult, kind: "unary", since: "1.56", errors: ["NOT_FOUND", "INVALID_PARAMS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "apps.windows.forget": { params: AppsWindowsForgetParams, result: AppsWindowActionResult, kind: "unary", since: "1.56", errors: ["NOT_FOUND", "CONFLICT", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "apps.chats.probe": { params: AppsChatsProbeParams, result: AppsChatsProbeResult, kind: "unary", since: "1.56", errors: ["NOT_FOUND", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "apps.projects.move": { params: AppsProjectsMoveParams, result: AppsProjectsMoveResult, kind: "unary", since: "1.10", errors: ["NOT_FOUND", "INVALID_PARAMS", "CONFLICT", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "apps.projects.create": { params: AppsProjectsCreateParams, result: AppsProjectsCreateResult, kind: "unary", since: "1.10", errors: ["INVALID_PARAMS", "CONFLICT", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "apps.projects.import_pins": { params: AppsProjectsImportPinsParams, result: AppsProjectsImportPinsResult, kind: "unary", since: "1.10", errors: ["CONFLICT", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
@@ -4519,6 +4587,8 @@ var OPS = {
   "coding.stop": { params: CodingStopParams, result: CodingStopResult, kind: "unary", since: "1.38", errors: ["INVALID_PARAMS", "INTERNAL"] },
   "coding.stop_elsewhere": { params: CodingStopElsewhereParams, result: CodingStopElsewhereResult, kind: "unary", since: "1.38", errors: ["INVALID_PARAMS", "NOT_FOUND", "CONFLICT", "PERMISSION_DENIED_OS", "INTERNAL"] },
   "coding.options.set": { params: CodingOptionsSetParams, result: CodingOptionsSetResult, kind: "unary", since: "1.38", errors: ["INVALID_PARAMS", "NOT_FOUND", "INTERNAL"] },
+  // 1.56: "Continue on <account>" — the session moves to another account and its stopped turn is sent again, exactly once.
+  "coding.account.continue": { params: CodingAccountContinueParams, result: CodingAccountContinueResult, kind: "unary", since: "1.56", errors: ["INVALID_PARAMS", "NOT_FOUND", "RESOURCE_BUSY", "AUTH_FORBIDDEN", "INTERNAL"] },
   "coding.agent.set": { params: CodingAgentSetParams, result: CodingAgentSetResult, kind: "unary", since: "1.38", errors: ["INVALID_PARAMS", "NOT_FOUND", "AUTH_FORBIDDEN", "INTERNAL"] },
   "coding.agents.access": { params: CodingAgentsAccessParams, result: CodingAgentsAccessResult, kind: "unary", since: "1.38", errors: ["INTERNAL"] },
   "coding.titles.status": { params: CodingTitlesStatusParams, result: CodingTitlesStatusResult, kind: "unary", since: "1.38", errors: ["INTERNAL"] },
@@ -4694,7 +4764,18 @@ var NESTED_RESULTS = /* @__PURE__ */ new Map([
   ["apps.projects.to_window", [["group", "ProjectMoveGroup"]]],
   ["apps.windows.list", [["windows", "AppWindowInfo"]]],
   ["apps.windows.set_remote_control", [["remote_control", "WindowRemoteControl"]]],
-  ["coding.providers", [["providers", "CodingProviderStatus"]]]
+  ["coding.providers", [["providers", "CodingProviderStatus"]]],
+  // 1.57: the account a coding record belongs to.
+  ["coding.sessions.list", [["sessions", "CodingSessionRecord"], ["recent", "CodingRecentRow"]]],
+  ["coding.recent.seen", [["recent", "CodingRecentRow"]]],
+  ["coding.discover", [["chats", "CodingDiscoveredChat"]]],
+  ["coding.search", [["hits", "CodingSearchHit"]]],
+  ["coding.start", [["session", "CodingSessionRecord"]]],
+  ["coding.send", [["session", "CodingSessionRecord"]]],
+  ["coding.takeover", [["session", "CodingSessionRecord"]]],
+  ["coding.options.set", [["session", "CodingSessionRecord"]]],
+  ["coding.agent.set", [["session", "CodingSessionRecord"]]],
+  ["coding.account.continue", [["session", "CodingSessionRecord"]]]
 ]);
 var WINDOW_RESULTS = /* @__PURE__ */ new Map([
   ["window.list", "windows"],