@ai-matrx/desktop-protocol 0.21.49 → 0.21.51

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 = 54;
+var PROTOCOL_MINOR = 56;
 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_-]+$/);
@@ -1818,6 +1818,50 @@ var AppsWindowsUpdateAndReopenResult = z14.strictObject({
   /** The version installed, null when the install did not happen (or dry_run). */
   installed_version: z14.string().max(64).nullable()
 });
+var AppsChatsCopyToAccountParams = z14.strictObject({
+  app_key: AppKey,
+  origin: ChatPlace,
+  target: ChatPlace,
+  chat_ids: z14.array(ChatId).min(1).max(500),
+  mode: z14.enum(["copy", "move"]).default("copy"),
+  restart: z14.enum(["queued", "restart_verify"]).default("queued"),
+  /** Put each chat in the target group named as its origin group (default true). */
+  mirror_groups: z14.boolean().default(true),
+  /** Pin in the target the chats pinned in the origin (default true). */
+  pins_follow: z14.boolean().default(true),
+  /** A copy: group them in the origin under this name ("Copied to <target>"). */
+  source_group: z14.string().trim().min(1).max(200).optional()
+});
+var CopiedChat = z14.strictObject({
+  chat_id: ChatId,
+  title: z14.string().max(500),
+  outcome: z14.enum(["copied", "moved", "already", "skipped"]),
+  /** The target group it was put in (its origin group's name), or null. */
+  group: z14.string().max(200).nullable(),
+  group_state: z14.enum(["now", "next_close", "failed"]).nullable(),
+  pinned: z14.boolean(),
+  pin_state: z14.enum(["now", "next_close", "failed"]).nullable(),
+  /** The read-back: verified, waiting for a window to close (queued), or failed. */
+  state: z14.enum(["verified", "queued", "failed"]),
+  reason: z14.string().max(400).nullable()
+});
+var AppsChatsCopyToAccountResult = z14.strictObject({
+  message: z14.string().max(400),
+  origin: ChatPlace,
+  target: ChatPlace,
+  mode: z14.enum(["copy", "move"]),
+  /** The marker the chats are filed under ("From <origin>"), for Bring back. */
+  project: z14.strictObject({ id: ChatProjectId, name: z14.string().max(200) }),
+  /** The target groups used, by name: made or reused, now or at the next close. */
+  groups: z14.array(z14.strictObject({ name: z14.string().max(200), chats: z14.number().int().nonnegative(), ok: z14.boolean(), when: z14.enum(["now", "next_close"]).nullable(), reason: z14.string().max(400).nullable() })).max(500),
+  source_group: z14.strictObject({ name: z14.string().max(200), ok: z14.boolean(), when: z14.enum(["now", "next_close"]).nullable(), reason: z14.string().max(400).nullable() }).nullable(),
+  chats: z14.array(CopiedChat).max(500),
+  verified: z14.number().int().nonnegative(),
+  queued: z14.number().int().nonnegative(),
+  failed: z14.number().int().nonnegative(),
+  /** What the restart choice did: "restart_verify" closed and reopened `windows`; a fall back to "queued" says why. */
+  restart: z14.strictObject({ asked: z14.enum(["queued", "restart_verify"]), done: z14.enum(["queued", "restart_verify"]), windows: z14.array(ChatPlace).max(2), reason: z14.string().max(400).nullable() })
+});
 
 // src/schema/apps-instances.ts
 import { z as z15 } from "zod";
@@ -1904,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";
@@ -3503,6 +3553,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({});
@@ -4440,9 +4500,15 @@ 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"] },
+  // 1.55: copy (or move) chats to another account with their groups and pins, in one engine pass, read back.
+  "apps.chats.copy_to_account": { params: AppsChatsCopyToAccountParams, result: AppsChatsCopyToAccountResult, kind: "unary", since: "1.55", errors: ["NOT_FOUND", "INVALID_PARAMS", "CONFLICT", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "apps.projects.to_window": { params: AppsProjectsToWindowParams, result: AppsProjectsToWindowResult, kind: "unary", since: "1.19", errors: ["NOT_FOUND", "INVALID_PARAMS", "CONFLICT", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   // 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"] },
@@ -4528,6 +4594,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"] },
@@ -4701,6 +4769,12 @@ var SERVICES = {
   }
 };
 var NAMED_SCHEMAS = {
+  AppsWindowsSetAccountParams,
+  AppsWindowsForgetParams,
+  ProbeFact,
+  ProbeSource,
+  AppsChatsProbeParams,
+  AppsChatsProbeResult,
   InstanceStatus,
   AppInstall,
   AppInstance,
@@ -4920,6 +4994,8 @@ var NAMED_SCHEMAS = {
   CodingStopElsewhereResult,
   CodingOptionsSetParams,
   CodingOptionsSetResult,
+  CodingAccountContinueParams,
+  CodingAccountContinueResult,
   CodingAgentSetParams,
   CodingAgentSetResult,
   CodingAgentsAccessParams,
@@ -5157,6 +5233,9 @@ var NAMED_SCHEMAS = {
   WindowRemoteControl,
   AppsWindowsSetRemoteControlParams,
   AppsWindowsSetRemoteControlResult,
+  AppsChatsCopyToAccountParams,
+  CopiedChat,
+  AppsChatsCopyToAccountResult,
   AccountUsage,
   AccountReset,
   AppsWindowsListParams,
@@ -5725,7 +5804,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 = "5408ddb0e04daf99badca47b8f47b4b9bc6f30227dd488356854d85b17b3a9d4";
+var CONTRACT_SHA256 = "14b79673133fb1625ab0320921b60ad595de3228bfae1337a73be3ed2d3e5a45";
 
 // src/close-policy.ts
 var CLOSE_RULES = {
@@ -5805,7 +5884,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" },
@@ -6167,11 +6246,15 @@ export {
   AppsChatsChangedEvent,
   AppsChatsColdParams,
   AppsChatsColdResult,
+  AppsChatsCopyToAccountParams,
+  AppsChatsCopyToAccountResult,
   AppsChatsListParams,
   AppsChatsListResult,
   AppsChatsOpenParams,
   AppsChatsPlaceParams,
   AppsChatsPlaceResult,
+  AppsChatsProbeParams,
+  AppsChatsProbeResult,
   AppsChatsStarParams,
   AppsChatsStarResult,
   AppsChatsTitlesCheckParams,
@@ -6218,6 +6301,7 @@ export {
   AppsSyncStatusResult,
   AppsWindowActionResult,
   AppsWindowsAddParams,
+  AppsWindowsForgetParams,
   AppsWindowsGroupsParams,
   AppsWindowsGroupsResult,
   AppsWindowsListParams,
@@ -6231,6 +6315,7 @@ export {
   AppsWindowsReopenResult,
   AppsWindowsRestartParams,
   AppsWindowsSaveNamesParams,
+  AppsWindowsSetAccountParams,
   AppsWindowsSetRemoteControlParams,
   AppsWindowsSetRemoteControlResult,
   AppsWindowsShownParams,
@@ -6319,6 +6404,8 @@ export {
   ClipboardWriteResult,
   CloseCode,
   CloseCodeValue,
+  CodingAccountContinueParams,
+  CodingAccountContinueResult,
   CodingActiveElsewhere,
   CodingActivityParams,
   CodingActivityResult,
@@ -6422,6 +6509,7 @@ export {
   ContactsSearchParams,
   ContactsSearchResult,
   ContractHash,
+  CopiedChat,
   CoreToClientMsg,
   CoreToServiceMsg,
   CreditMsg,
@@ -6706,6 +6794,8 @@ export {
   PowerPreventSleepResult,
   PowerStatusParams,
   PowerStatusResult,
+  ProbeFact,
+  ProbeSource,
   ProcInfo,
   ProcKillParams,
   ProcKillResult,