@ai-matrx/desktop-protocol 0.21.50 → 0.21.52

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 = 55;
+var PROTOCOL_MINOR = 57;
 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_-]+$/);
@@ -1948,6 +1948,12 @@ var AppsAccountsListResult = z15.strictObject({
   as_of_ms: epochMs.optional(),
   refreshing: z15.boolean().optional()
 });
+var AppsWindowsSetAccountParams = z15.strictObject({ app_key: AppKey, window: ChatPlace, email: z15.string().min(3).max(320) });
+var AppsWindowsForgetParams = z15.strictObject({ app_key: AppKey, window: ChatPlace });
+var ProbeFact = z15.strictObject({ key: z15.string().max(200), value: z15.string().max(2e3) });
+var ProbeSource = z15.strictObject({ source: z15.string().max(120), instance: z15.string().max(64).nullable(), facts: z15.array(ProbeFact).max(500) });
+var AppsChatsProbeParams = z15.strictObject({ app_key: AppKey, chat_id: z15.string().regex(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/) });
+var AppsChatsProbeResult = z15.strictObject({ app_key: AppKey, chat_id: z15.string().max(128), sources: z15.array(ProbeSource).max(200) });
 
 // src/schema/service.ts
 import { z as z16 } from "zod";
@@ -3325,7 +3331,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"]),
@@ -3347,7 +3358,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() }),
@@ -3387,6 +3403,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(),
@@ -3423,9 +3464,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(),
@@ -3452,7 +3497,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),
@@ -3547,6 +3597,16 @@ var CodingOptionsSetParams = z34.strictObject({
   effort: z34.string().max(40).optional()
 });
 var CodingOptionsSetResult = z34.strictObject({ session: CodingSessionRecord });
+var CodingAccountContinueParams = z34.strictObject({
+  session_id: SessionKey,
+  account_profile_id: z34.string().min(1).max(64).optional(),
+  client_request_id: CodingClientRequestId
+});
+var CodingAccountContinueResult = z34.strictObject({
+  session: CodingSessionRecord,
+  run: CodingRunRecord.nullable(),
+  how: z34.enum(["moved", "fresh"])
+});
 var CodingAgentSetParams = z34.strictObject({ session_id: SessionKey, agent: CodingAgentSelectionParams.optional() });
 var CodingAgentSetResult = z34.strictObject({ session: CodingSessionRecord });
 var CodingAgentsAccessParams = z34.strictObject({});
@@ -3575,19 +3635,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()
@@ -4484,6 +4548,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"] },
@@ -4574,6 +4642,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"] },
@@ -4747,6 +4817,12 @@ var SERVICES = {
   }
 };
 var NAMED_SCHEMAS = {
+  AppsWindowsSetAccountParams,
+  AppsWindowsForgetParams,
+  ProbeFact,
+  ProbeSource,
+  AppsChatsProbeParams,
+  AppsChatsProbeResult,
   InstanceStatus,
   AppInstall,
   AppInstance,
@@ -4925,6 +5001,9 @@ var NAMED_SCHEMAS = {
   CodingQuotaWindow,
   CodingProviderProblem,
   CodingProviderBinary,
+  CodingAccountUsage,
+  CodingContinueTarget,
+  CodingProviderAccount,
   CodingProviderStatus,
   CodingChatPreference,
   CodingTitleStatus,
@@ -4966,6 +5045,8 @@ var NAMED_SCHEMAS = {
   CodingStopElsewhereResult,
   CodingOptionsSetParams,
   CodingOptionsSetResult,
+  CodingAccountContinueParams,
+  CodingAccountContinueResult,
   CodingAgentSetParams,
   CodingAgentSetResult,
   CodingAgentsAccessParams,
@@ -4979,6 +5060,7 @@ var NAMED_SCHEMAS = {
   CodingRecentSeenParams,
   CodingRecentSeenResult,
   CodingSearchParams,
+  CodingSearchHit,
   CodingSearchResult,
   CodingReconcileParams,
   CodingReconcileResult,
@@ -5544,7 +5626,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" },
@@ -5681,7 +5768,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;
@@ -5717,15 +5815,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;
 }
@@ -5756,7 +5863,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;
@@ -5774,7 +5881,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 = "aeb1f5dd5ec4290d9ff8871fa39dd9be9605d25a40fec3c681f888c7f2a1954f";
+var CONTRACT_SHA256 = "ee1d6d3d83bb18a2ed020dbaf3c611b982699f9a9db8d728c38f2c6b8fbf0815";
 
 // src/close-policy.ts
 var CLOSE_RULES = {
@@ -5854,7 +5961,7 @@ var TOOL_CATALOG = [
   // 1.38, code from anywhere: the person's Claude Code and Codex sessions on this computer. Turning
   // either off in Agents › Tools refuses its ops on every relay connection (the existing switch).
   { name: "coding_sessions_read", group: "personal_automation", state: "built", path: "device_op", ops: ["coding.providers", "coding.sessions.list", "coding.discover", "coding.runs.list", "coding.history", "coding.transcript.read", "coding.item.full", "coding.activity", "coding.folders.recent", "coding.folders.check", "coding.agents.access", "coding.titles.status", "coding.prefs.list", "coding.recent.seen", "coding.search", "coding.transcript.raw", "coding.watch", "coding.session.watch"], platforms: ALL, summary: "Claude Code and Codex sessions: list, read live, search, download" },
-  { name: "coding_sessions_drive", group: "personal_automation", state: "built", path: "device_op", ops: ["coding.start", "coding.takeover", "coding.send", "coding.stop", "coding.stop_elsewhere", "coding.options.set", "coding.agent.set", "coding.folders.create", "coding.prefs.set", "coding.reconcile"], platforms: ALL, summary: "Claude Code and Codex sessions: start, send, stop, take over, rename" },
+  { name: "coding_sessions_drive", group: "personal_automation", state: "built", path: "device_op", ops: ["coding.start", "coding.takeover", "coding.send", "coding.stop", "coding.stop_elsewhere", "coding.options.set", "coding.account.continue", "coding.agent.set", "coding.folders.create", "coding.prefs.set", "coding.reconcile"], platforms: ALL, summary: "Claude Code and Codex sessions: start, send, stop, take over, rename" },
   // ── 4. Documents, notes and entities (1.37: the core's `documents` and `notes` owners; desktop_web is the `tools` service) ──
   { name: "desktop_documents", group: "tools_service", state: "built", path: "device_op", ops: ["documents.pdf_text", "documents.ocr", "documents.image_resize", "documents.office_generate"], platforms: ALL, summary: "PDF text, OCR, images, Word and Excel files" },
   { name: "desktop_web", group: "tools_service", state: "built", path: "device_op", ops: ["web.fetch", "web.scrape", "web.search", "web.fetch_with_browser"], platforms: ALL, summary: "Fetch, scrape and search the web from this computer's own connection" },
@@ -6223,6 +6330,8 @@ export {
   AppsChatsOpenParams,
   AppsChatsPlaceParams,
   AppsChatsPlaceResult,
+  AppsChatsProbeParams,
+  AppsChatsProbeResult,
   AppsChatsStarParams,
   AppsChatsStarResult,
   AppsChatsTitlesCheckParams,
@@ -6269,6 +6378,7 @@ export {
   AppsSyncStatusResult,
   AppsWindowActionResult,
   AppsWindowsAddParams,
+  AppsWindowsForgetParams,
   AppsWindowsGroupsParams,
   AppsWindowsGroupsResult,
   AppsWindowsListParams,
@@ -6282,6 +6392,7 @@ export {
   AppsWindowsReopenResult,
   AppsWindowsRestartParams,
   AppsWindowsSaveNamesParams,
+  AppsWindowsSetAccountParams,
   AppsWindowsSetRemoteControlParams,
   AppsWindowsSetRemoteControlResult,
   AppsWindowsShownParams,
@@ -6370,6 +6481,9 @@ export {
   ClipboardWriteResult,
   CloseCode,
   CloseCodeValue,
+  CodingAccountContinueParams,
+  CodingAccountContinueResult,
+  CodingAccountUsage,
   CodingActiveElsewhere,
   CodingActivityParams,
   CodingActivityResult,
@@ -6381,6 +6495,7 @@ export {
   CodingChangedEvent,
   CodingChatPreference,
   CodingClientRequestId,
+  CodingContinueTarget,
   CodingDiscoverParams,
   CodingDiscoverResult,
   CodingDiscoveredChat,
@@ -6413,6 +6528,7 @@ export {
   CodingPrefsListResult,
   CodingPrefsSetParams,
   CodingPrefsSetResult,
+  CodingProviderAccount,
   CodingProviderBinary,
   CodingProviderName,
   CodingProviderProblem,
@@ -6431,6 +6547,7 @@ export {
   CodingRunUsage,
   CodingRunsListParams,
   CodingRunsListResult,
+  CodingSearchHit,
   CodingSearchParams,
   CodingSearchResult,
   CodingSendParams,
@@ -6758,6 +6875,8 @@ export {
   PowerPreventSleepResult,
   PowerStatusParams,
   PowerStatusResult,
+  ProbeFact,
+  ProbeSource,
   ProcInfo,
   ProcKillParams,
   ProcKillResult,