@ai-matrx/desktop-protocol 0.21.51 → 0.21.53

package/dist/index.js

@@ -2,7 +2,7 @@
 import { z } from "zod";
 import { UUID_SHAPE_PATTERN } from "@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 = z.string().regex(/^[1-9][0-9]{0,2}\.[0-9]{1,3}$/);
 var RequestId = z.string().min(1).max(64).regex(/^[A-Za-z0-9_-]+$/);
@@ -905,8 +905,17 @@ var ModelsLlmStatusResult = z10.strictObject({
   /** Why the last start or download failed, one human line; null otherwise. */
   error: z10.string().max(300).nullable()
 });
-var ModelsLlmInstallParams = z10.strictObject({ model: TextModelId });
-var ModelsLlmInstallResult = z10.strictObject({ model: TextModelId, elapsed_ms: nonNegInt });
+var ModelsLlmInstallParams = z10.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: z10.string().min(8).max(512).optional()
+});
+var ModelsLlmInstallResult = z10.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: z10.record(z10.string().max(512), z10.string().regex(/^[0-9a-f]{64}$/)).optional()
+});
 var ModelsLlmStartParams = z10.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). */
@@ -928,7 +937,11 @@ var CatalogFile = z10.strictObject({
   /** The pinned https URL it is downloaded from. */
   url: z10.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: z10.string().max(32)
 });
@@ -3331,7 +3344,12 @@ var CodingSessionRecord = z34.strictObject({
   lastRunStatus: CodingRunStatus.nullable(),
   queued: z34.array(z34.string().max(1048576)).max(100),
   agent: CodingSessionAgent.nullable(),
-  agentRemovedDue: z34.boolean()
+  agentRemovedDue: z34.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: z34.string().min(1).max(64).optional()
 });
 var CodingActiveElsewhere = z34.strictObject({
   reason: z34.enum(["process", "recent-write", "open-tool-call", "open"]),
@@ -3353,7 +3371,12 @@ var CodingDiscoveredChat = z34.strictObject({
   unavailable: ShortText.nullable(),
   updatedAt: IsoTime,
   source: z34.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: z34.string().min(1).max(64).optional()
 });
 var CodingTranscriptItem = z34.discriminatedUnion("kind", [
   z34.strictObject({ kind: z34.literal("user"), id: z34.string().max(200), text: z34.string(), at: IsoTime.nullable() }),
@@ -3393,6 +3416,31 @@ var CodingProviderProblem = z34.strictObject({
   until: z34.string().max(120).nullable(),
   at: IsoTime
 });
+var CodingAccountUsage = z34.strictObject({
+  windows: z34.array(CodingQuotaWindow).max(20),
+  /** The provider's own status word ("allowed", "allowed_warning", "rejected"...), when it gives one. */
+  status: z34.string().max(60).nullable(),
+  /** When a rejected status lifts (ISO), when the provider says. */
+  resetsAt: z34.string().max(80).nullable(),
+  at: IsoTime
+});
+var CodingContinueTarget = z34.strictObject({
+  accountId: z34.string().min(1).max(64).nullable(),
+  label: z34.string().max(200)
+});
+var CodingProviderAccount = z34.strictObject({
+  id: z34.string().min(1).max(64),
+  label: z34.string().max(200),
+  /** (1.57) No known usage limit or expired sign-in on this account. Absent: not read. */
+  ready: z34.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 = z34.strictObject({
   path: LocalPath,
   version: z34.string().max(80).nullable(),
@@ -3429,9 +3477,13 @@ var CodingProviderStatus = z34.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: z34.array(z34.strictObject({ id: z34.string().min(1).max(64), label: z34.string().max(200) })).max(100).optional(),
+  accounts: z34.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 = z34.strictObject({
   title: z34.string().max(500).nullable(),
@@ -3458,7 +3510,12 @@ var CodingRecentRow = z34.strictObject({
   state: z34.enum(["running", "needs_attention", "new_output", "elsewhere", "idle"]),
   stateLabel: z34.string().max(120).nullable(),
   pinned: z34.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: z34.string().min(1).max(64).optional()
 });
 var CodingFolderCheck = z34.strictObject({
   path: z34.string().max(4096),
@@ -3591,19 +3648,23 @@ var CodingSearchParams = z34.strictObject({
   cursor: nonNegInt.optional(),
   limit: z34.int().min(1).max(100).optional()
 });
+var CodingSearchHit = z34.strictObject({
+  provider: CodingProviderName,
+  providerSessionId: SessionKey,
+  title: z34.string().max(500),
+  cwd: LocalPath.nullable(),
+  updatedAt: IsoTime,
+  where: z34.enum(["title", "content"]),
+  snippet: z34.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: z34.string().min(1).max(64).optional()
+});
 var CodingSearchResult = z34.strictObject({
   query: z34.string().max(500),
-  hits: z34.array(
-    z34.strictObject({
-      provider: CodingProviderName,
-      providerSessionId: SessionKey,
-      title: z34.string().max(500),
-      cwd: LocalPath.nullable(),
-      updatedAt: IsoTime,
-      where: z34.enum(["title", "content"]),
-      snippet: z34.string().max(2e3).nullable()
-    })
-  ),
+  hits: z34.array(CodingSearchHit),
   scanned: nonNegInt,
   total: nonNegInt,
   nextCursor: nonNegInt.nullable()
@@ -4953,6 +5014,9 @@ var NAMED_SCHEMAS = {
   CodingQuotaWindow,
   CodingProviderProblem,
   CodingProviderBinary,
+  CodingAccountUsage,
+  CodingContinueTarget,
+  CodingProviderAccount,
   CodingProviderStatus,
   CodingChatPreference,
   CodingTitleStatus,
@@ -5009,6 +5073,7 @@ var NAMED_SCHEMAS = {
   CodingRecentSeenParams,
   CodingRecentSeenResult,
   CodingSearchParams,
+  CodingSearchHit,
   CodingSearchResult,
   CodingReconcileParams,
   CodingReconcileResult,
@@ -5574,7 +5639,12 @@ var FIELDS_SINCE = {
   WindowInfo: { app: "1.7", pid: "1.7" },
   AppWindowInfo: { remote_control: "1.50" },
   WindowRemoteControl: { problem: "1.52" },
-  CodingProviderStatus: { accounts: "1.53", accountsProblem: "1.53" },
+  CodingProviderStatus: { accounts: "1.53", accountsProblem: "1.53", usage: "1.57", continueOn: "1.57" },
+  CodingProviderAccount: { ready: "1.57", lastProblem: "1.57", problem: "1.57", fix: "1.57", usage: "1.57", continueOn: "1.57" },
+  CodingSessionRecord: { accountId: "1.57" },
+  CodingDiscoveredChat: { accountId: "1.57" },
+  CodingRecentRow: { accountId: "1.57" },
+  CodingSearchHit: { accountId: "1.57" },
   AppsInstancesListParams: { fresh: "1.51" },
   AppsInstancesListResult: { as_of_ms: "1.51", refreshing: "1.51" },
   AppsAccountsListParams: { fresh: "1.51" },
@@ -5711,7 +5781,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"]]]
 ]);
 function stripNested(value, nested, version) {
   if (value === null || typeof value !== "object" || Array.isArray(value)) return value;
@@ -5747,15 +5828,24 @@ function windowListRemoteControlForPeer(value, version) {
   });
   return next.some((w, i) => w !== windows[i]) ? { ...body, windows: next } : value;
 }
-function providersDefaultSourceForPeer(value, version) {
-  if (knows(version, "1.54") || value === null || typeof value !== "object") return value;
+function providersForPeer(value, version) {
+  if (knows(version, "1.57") || value === null || typeof value !== "object") return value;
   const body = value;
   if (!Array.isArray(body.providers)) return value;
   const providers = body.providers;
   const next = providers.map((p) => {
-    const dm = p?.defaultModel;
-    if (dm === null || typeof dm !== "object" || dm.source !== "account") return p;
-    return { ...p, defaultModel: { ...dm, source: "driver" } };
+    if (p === null || typeof p !== "object") return p;
+    let out = p;
+    const dm = out.defaultModel;
+    if (!knows(version, "1.54") && dm !== null && typeof dm === "object" && dm.source === "account") {
+      out = { ...out, defaultModel: { ...dm, source: "driver" } };
+    }
+    const accounts = out.accounts;
+    if (Array.isArray(accounts)) {
+      const kept = accounts.map((a) => strip(a, FIELDS_SINCE.CodingProviderAccount, version));
+      if (kept.some((a, i) => a !== accounts[i])) out = { ...out, accounts: kept };
+    }
+    return out;
   });
   return next.some((p, i) => p !== providers[i]) ? { ...body, providers: next } : value;
 }
@@ -5786,7 +5876,7 @@ function forPeer(op, part, value, version) {
     const top = path ? strip(known, FIELDS_SINCE[path], version) : known;
     const nested = op ? NESTED_RESULTS.get(op) : void 0;
     const stripped = nested ? stripNested(top, nested, version) : top;
-    if (op === "coding.providers") return providersDefaultSourceForPeer(stripped, version);
+    if (op === "coding.providers") return providersForPeer(stripped, version);
     return op === "apps.windows.list" ? windowListRemoteControlForPeer(stripped, version) : stripped;
   }
   if (value === null || typeof value !== "object") return value;
@@ -5804,7 +5894,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 = "14b79673133fb1625ab0320921b60ad595de3228bfae1337a73be3ed2d3e5a45";
+var CONTRACT_SHA256 = "ee1d6d3d83bb18a2ed020dbaf3c611b982699f9a9db8d728c38f2c6b8fbf0815";
 
 // src/close-policy.ts
 var CLOSE_RULES = {
@@ -6406,6 +6496,7 @@ export {
   CloseCodeValue,
   CodingAccountContinueParams,
   CodingAccountContinueResult,
+  CodingAccountUsage,
   CodingActiveElsewhere,
   CodingActivityParams,
   CodingActivityResult,
@@ -6417,6 +6508,7 @@ export {
   CodingChangedEvent,
   CodingChatPreference,
   CodingClientRequestId,
+  CodingContinueTarget,
   CodingDiscoverParams,
   CodingDiscoverResult,
   CodingDiscoveredChat,
@@ -6449,6 +6541,7 @@ export {
   CodingPrefsListResult,
   CodingPrefsSetParams,
   CodingPrefsSetResult,
+  CodingProviderAccount,
   CodingProviderBinary,
   CodingProviderName,
   CodingProviderProblem,
@@ -6467,6 +6560,7 @@ export {
   CodingRunUsage,
   CodingRunsListParams,
   CodingRunsListResult,
+  CodingSearchHit,
   CodingSearchParams,
   CodingSearchResult,
   CodingSendParams,