@ai-matrx/desktop-protocol 0.21.51 → 0.21.53

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 0.21.53
+
+UNVERIFIED: this release has no Unreleased entry and the source comparison could not be made (the caller supplied no source comparison). Whether source changed is unknown; consumer action is unknown.
+Check the package's gitHead on npm against this version's gitHead: `git diff <previous gitHead> <this gitHead> -- apps/shared/desktop-protocol/src`.
+
+## 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

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 = 56;
+var PROTOCOL_MINOR = 58;
 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_-]+$/);
@@ -886,8 +886,17 @@ var ModelsLlmStatusResult = import_zod9.z.strictObject({
   /** Why the last start or download failed, one human line; null otherwise. */
   error: import_zod9.z.string().max(300).nullable()
 });
-var ModelsLlmInstallParams = import_zod9.z.strictObject({ model: TextModelId });
-var ModelsLlmInstallResult = import_zod9.z.strictObject({ model: TextModelId, elapsed_ms: nonNegInt });
+var ModelsLlmInstallParams = import_zod9.z.strictObject({
+  model: TextModelId,
+  /** (1.58) The person's own Hugging Face token for this download (gated/private files): sent only to Hugging Face hosts, never stored or logged. */
+  hf_token: import_zod9.z.string().min(8).max(512).optional()
+});
+var ModelsLlmInstallResult = import_zod9.z.strictObject({
+  model: TextModelId,
+  elapsed_ms: nonNegInt,
+  /** (1.58) path -> SHA-256 of every file whose catalog sha256 was null, hashed on this first download. */
+  hashed: import_zod9.z.record(import_zod9.z.string().max(512), import_zod9.z.string().regex(/^[0-9a-f]{64}$/)).optional()
+});
 var ModelsLlmStartParams = import_zod9.z.strictObject({
   model: TextModelId,
   /** Tokens of context, from the knob desktop.models/context_length. Omitted today means the service's fixed 4096 (optional until callers send it). */
@@ -909,7 +918,11 @@ var CatalogFile = import_zod9.z.strictObject({
   /** The pinned https URL it is downloaded from. */
   url: import_zod9.z.string().url().max(2048),
   size_bytes: nonNegInt,
-  sha256: Sha256Hex,
+  /**
+   * The file's SHA-256; (1.58) null when its source publishes none (a small non-LFS file on Hugging
+   * Face): the first download hashes it and reports it in `models.llm.install`'s `hashed`.
+   */
+  sha256: Sha256Hex.nullable(),
   /** weights, weights_shard, mmproj, config, tokenizer, … (ai.model_artifact.role). */
   role: import_zod9.z.string().max(32)
 });
@@ -2481,7 +2494,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 +2521,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 +2566,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 +2627,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 +2660,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),
@@ -2741,19 +2798,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()
@@ -4716,7 +4777,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"],