@ai-matrx/desktop-protocol 0.21.25 → 0.21.27

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 = 29;
+var PROTOCOL_MINOR = 32;
 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_-]+$/);
@@ -521,6 +521,8 @@ var FsMkdirParams = z6.strictObject({ path: AbsPath, parents: z6.boolean().defau
 var FsMkdirResult = z6.strictObject({ path: AbsPath, created: z6.boolean() });
 var FsMoveParams = z6.strictObject({ from_path: AbsPath, to_path: AbsPath, overwrite: z6.boolean().default(false) });
 var FsMoveResult = z6.strictObject({ from_path: AbsPath, to_path: AbsPath });
+var FsCopyParams = z6.strictObject({ from_path: AbsPath, to_path: AbsPath, overwrite: z6.boolean().default(false) });
+var FsCopyResult = z6.strictObject({ from_path: AbsPath, to_path: AbsPath });
 var FsDeleteParams = z6.strictObject({
   path: AbsPath,
   recursive: z6.boolean().default(false),
@@ -589,6 +591,36 @@ var FsSearchContentResult = z6.strictObject({
     })
   )
 });
+var FsSearchIndexParams = z6.strictObject({
+  query: z6.string().min(1).max(256),
+  /** Only under this folder; absent: the whole computer (the walk: the home folder). */
+  scope: AbsPath.optional(),
+  max_results: z6.int().min(1).max(1e3).default(200)
+});
+var FsSearchIndexResult = z6.strictObject({
+  entries: z6.array(FsEntry).max(1e3),
+  truncated: z6.boolean(),
+  source: z6.enum(["index", "walk"])
+});
+var FsInfoParams = z6.strictObject({ path: AbsPath });
+var FsInfoResult = z6.strictObject({
+  entry: FsEntry,
+  created: z6.number().min(0).nullable(),
+  // seconds, float
+  owner: z6.string().max(256).nullable(),
+  group: z6.string().max(256).nullable(),
+  /** A file's logical size, or a folder's whole tree (null when the walk was cut short). */
+  total_size: nonNegInt.nullable(),
+  /** Bytes the OS uses for it on disk (blocks), same bound as total_size. */
+  size_on_disk: nonNegInt.nullable(),
+  /** A folder's own children (not its tree); null for a file. */
+  items: nonNegInt.nullable(),
+  hidden: z6.boolean(),
+  /** Finder's Locked (macOS uchg); null where the OS has no such flag. */
+  locked: z6.boolean().nullable(),
+  /** The volume holding it refuses writes (a disk image, a read-only share). */
+  read_only: z6.boolean()
+});
 var FsChange = z6.strictObject({
   type: z6.enum(["created", "modified", "deleted", "moved"]),
   path: AbsPath,
@@ -809,6 +841,49 @@ var MlProgress = z10.strictObject({
   /** The segment just transcribed (transcribe only): text appears as it is recognised. */
   segment: TranscriptSegment.nullable()
 });
+var TextModelId = z10.enum([
+  "smollm2-135m",
+  "llama-3.2-3b",
+  "phi-4-mini",
+  "gemma-3-4b",
+  "llama-3.1-8b",
+  "qwen-2.5-7b",
+  "mistral-small-3.1",
+  "gpt-oss-20b",
+  "qwen-2.5-coder-7b",
+  "qwen-2.5-coder-14b"
+]);
+var TextModelInfo = z10.strictObject({
+  id: TextModelId,
+  /** Download size of the weights. */
+  size_bytes: nonNegInt,
+  installed: z10.boolean()
+});
+var LlmServerState = z10.enum(["stopped", "starting", "running", "failed"]);
+var LlmRunning = z10.strictObject({ id: TextModelId, port: z10.int().min(1024).max(65535) });
+var ModelsLlmStatusParams = z10.strictObject({});
+var ModelsLlmStatusResult = z10.strictObject({
+  state: LlmServerState,
+  /** Every model in the catalog, with whether its weights are on this computer. */
+  models: z10.array(TextModelInfo).max(64),
+  running: LlmRunning.nullable(),
+  /** The model being loaded while `state` is "starting". */
+  starting: TextModelId.nullable(),
+  /** Non-null while the server program or a model's weights are being downloaded. */
+  install: MlInstallProgress.nullable(),
+  /** 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 ModelsLlmStartParams = z10.strictObject({
+  model: TextModelId,
+  /** Tokens of context; the service picks a size that fits this computer when omitted. */
+  context_length: z10.int().min(512).max(131072).optional()
+});
+var ModelsLlmStartResult = z10.strictObject({ running: LlmRunning, elapsed_ms: nonNegInt });
+var ModelsLlmStopParams = z10.strictObject({});
+var ModelsLlmStopResult = z10.strictObject({ stopped: z10.boolean() });
 var MlServiceState = z10.enum(["starting", "ready", "restarting", "failed", "stopped"]);
 var MlServiceStatus = z10.strictObject({
   state: MlServiceState,
@@ -1290,6 +1365,19 @@ var ProjectMoveGroup = z14.strictObject({
   /** A group of that name was already there (reused, never doubled). */
   group_exists: z14.boolean().optional()
 });
+var ProjectMovePin = z14.strictObject({
+  ok: z14.boolean(),
+  /** "now" = written into the closed window; "next_close" = queued until that window closes. */
+  when: z14.enum(["now", "next_close"]),
+  /** Pinned by this call (dry run: would be). */
+  pinned: nonNegInt,
+  /** Already pinned there. */
+  already: nonNegInt,
+  /** Waiting for the window to close (dry run: would wait). */
+  queued: nonNegInt,
+  /** Why not pinned (ok false), or why queued. */
+  reason: z14.string().max(400).optional()
+});
 var AppsProjectsToWindowParams = z14.strictObject({
   app_key: AppKey,
   project_id: ChatProjectId,
@@ -1298,6 +1386,8 @@ var AppsProjectsToWindowParams = z14.strictObject({
   take_off: z14.boolean().default(false),
   /** Also group them under the project's name in that window's sidebar (closed windows only). */
   group: z14.boolean().default(false),
+  /** 1.32: also pin them in that window (now if closed, else when it next closes). */
+  pin: z14.boolean().optional(),
   dry_run: z14.boolean().default(false)
 });
 var AppsProjectsToWindowResult = z14.strictObject({
@@ -1311,6 +1401,8 @@ var AppsProjectsToWindowResult = z14.strictObject({
   /** Chats of the project from other apps (no windows to place into), left as they are. */
   other_apps: nonNegInt,
   group: ProjectMoveGroup.nullable(),
+  /** 1.32: the pin in the target window (absent: not asked). */
+  pin: ProjectMovePin.optional(),
   message: z14.string().max(400)
 });
 var ColdChat = z14.strictObject({
@@ -2691,6 +2783,9 @@ var OPS = {
   "fs.write": { params: FsWriteParams, result: FsWriteResult, kind: "unary", since: "1.0", errors: [...FS_ERR, "CONFLICT", "PAYLOAD_TOO_LARGE"] },
   "fs.mkdir": { params: FsMkdirParams, result: FsMkdirResult, kind: "unary", since: "1.0", errors: [...FS_ERR, "CONFLICT"] },
   "fs.move": { params: FsMoveParams, result: FsMoveResult, kind: "unary", since: "1.0", errors: [...FS_ERR, "CONFLICT"] },
+  "fs.copy": { params: FsCopyParams, result: FsCopyResult, kind: "unary", since: "1.30", errors: [...FS_ERR, "CONFLICT"] },
+  "fs.info": { params: FsInfoParams, result: FsInfoResult, kind: "unary", since: "1.30", errors: FS_ERR },
+  "fs.search_index": { params: FsSearchIndexParams, result: FsSearchIndexResult, kind: "unary", since: "1.30", errors: [...FS_ERR, "TIMEOUT"] },
   "fs.delete": { params: FsDeleteParams, result: FsDeleteResult, kind: "unary", since: "1.0", errors: FS_ERR },
   "fs.watch": { params: FsWatchParams, result: FsWatchResult, kind: "resource", since: "1.0", errors: [...FS_ERR, "RATE_LIMITED"] },
   "fs.patch": { params: FsPatchParams, result: FsPatchResult, kind: "unary", since: "1.0", errors: [...FS_ERR, "CONFLICT"] },
@@ -2711,6 +2806,10 @@ var OPS = {
   "models.status": { params: ModelsStatusParams, result: ModelsStatusResult, kind: "unary", since: "1.2", errors: ["INTERNAL"] },
   "models.install": { params: ModelsInstallParams, result: ModelsInstallResult, kind: "unary", since: "1.2", errors: ["RESOURCE_BUSY", "RESOURCE_GONE", "TIMEOUT", "CANCELLED", "INTERNAL"] },
   "models.transcribe": { params: ModelsTranscribeParams, result: ModelsTranscribeResult, kind: "unary", since: "1.2", errors: ["NOT_FOUND", "INVALID_PARAMS", "PERMISSION_DENIED_OS", "RESOURCE_BUSY", "RESOURCE_GONE", "CANCELLED", "PAYLOAD_TOO_LARGE", "INTERNAL"] },
+  "models.llm.status": { params: ModelsLlmStatusParams, result: ModelsLlmStatusResult, kind: "unary", since: "1.31", errors: ["INTERNAL"] },
+  "models.llm.install": { params: ModelsLlmInstallParams, result: ModelsLlmInstallResult, kind: "unary", since: "1.31", errors: ["RESOURCE_BUSY", "RESOURCE_GONE", "TIMEOUT", "CANCELLED", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "models.llm.start": { params: ModelsLlmStartParams, result: ModelsLlmStartResult, kind: "unary", since: "1.31", errors: ["NOT_FOUND", "RESOURCE_BUSY", "RESOURCE_GONE", "TIMEOUT", "CANCELLED", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "models.llm.stop": { params: ModelsLlmStopParams, result: ModelsLlmStopResult, kind: "unary", since: "1.31", errors: ["INTERNAL"] },
   // Desktop apps and their profiles (SPEC §6 apps); profiles are rows in users.desktop_app_profile.
   "apps.list": { params: AppsListParams, result: AppsListResult, kind: "unary", since: "1.2", errors: ["INTERNAL"] },
   "apps.profiles.list": { params: AppsProfilesListParams, result: AppsProfilesListResult, kind: "unary", since: "1.2", errors: ["NOT_FOUND", "INVALID_PARAMS", "INTERNAL"] },
@@ -2861,7 +2960,11 @@ var SERVICES = {
     ops: {
       "ml.status": { params: MlStatusParams, result: MlStatusResult },
       "ml.install": { params: ModelsInstallParams, result: ModelsInstallResult },
-      "ml.transcribe": { params: ModelsTranscribeParams, result: ModelsTranscribeResult }
+      "ml.transcribe": { params: ModelsTranscribeParams, result: ModelsTranscribeResult },
+      "ml.llm_status": { params: ModelsLlmStatusParams, result: ModelsLlmStatusResult },
+      "ml.llm_install": { params: ModelsLlmInstallParams, result: ModelsLlmInstallResult },
+      "ml.llm_start": { params: ModelsLlmStartParams, result: ModelsLlmStartResult },
+      "ml.llm_stop": { params: ModelsLlmStopParams, result: ModelsLlmStopResult }
     }
   },
   coding: {
@@ -2931,6 +3034,12 @@ var NAMED_SCHEMAS = {
   FsMkdirResult,
   FsMoveParams,
   FsMoveResult,
+  FsCopyParams,
+  FsCopyResult,
+  FsInfoParams,
+  FsInfoResult,
+  FsSearchIndexParams,
+  FsSearchIndexResult,
   FsDeleteParams,
   FsDeleteResult,
   FsWatchParams,
@@ -2989,6 +3098,18 @@ var NAMED_SCHEMAS = {
   ModelsStatusParams,
   ModelsStatusResult,
   ModelsProgressEvent,
+  TextModelId,
+  TextModelInfo,
+  LlmServerState,
+  LlmRunning,
+  ModelsLlmStatusParams,
+  ModelsLlmStatusResult,
+  ModelsLlmInstallParams,
+  ModelsLlmInstallResult,
+  ModelsLlmStartParams,
+  ModelsLlmStartResult,
+  ModelsLlmStopParams,
+  ModelsLlmStopResult,
   CodingServiceCredentials,
   CodingHistoryBlocked,
   CodingHistoryFailure,
@@ -3228,6 +3349,7 @@ var NAMED_SCHEMAS = {
   ProjectMoveChat,
   ProjectMoveSkip,
   ProjectMoveGroup,
+  ProjectMovePin,
   AppsProjectsToWindowParams,
   AppsProjectsToWindowResult,
   ShownSection,
@@ -3362,7 +3484,9 @@ var FIELDS_SINCE = {
   ScreenDisplay: { rotation: "1.24", refresh_hz: "1.24", builtin: "1.24" },
   PowerStatusResult: { energy: "1.24" },
   AppsSpendResult: { days: "1.24" },
-  AppsWindowsUpdateStateResult: { closed_by_update: "1.27" }
+  AppsWindowsUpdateStateResult: { closed_by_update: "1.27" },
+  AppsProjectsToWindowParams: { pin: "1.32" },
+  AppsProjectsToWindowResult: { pin: "1.32" }
 };
 var NULL_SINCE = {
   "RelayDeviceStatusEvent.since_ms": { since: "1.1", olderPeersGet: 0 }
@@ -3498,7 +3622,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 = "5994ab9f6c2dba636a90e18c99bd3a90736f23782b3f8df9e0d2d7234b8e2b1b";
+var CONTRACT_SHA256 = "ee8e6c98c76f3557f832157e3b2b21bb23ebb74b67b79151f3b9ff788f5273ee";
 
 // src/close-policy.ts
 var CLOSE_RULES = {
@@ -3555,6 +3679,7 @@ var TOOL_CATALOG = [
   { name: "desktop_system", group: "os_control", state: "built", path: "device_op", ops: ["sysinfo.get", "sysinfo.hardware", "system.open_url", "system.open_path", "system.open_settings", "system.notify"], platforms: ALL, summary: "System facts, open, notify" },
   { name: "desktop_clipboard", group: "os_control", state: "built", path: "device_op", ops: ["clipboard.read", "clipboard.write"], platforms: ALL, summary: "Read and write the clipboard's text" },
   { name: "desktop_screen", group: "os_control", state: "built", path: "device_op", ops: ["screen.list", "screen.capture"], platforms: ALL, summary: "Displays and screenshots" },
+  { name: "desktop_browser", group: "os_control", state: "built", path: "device_op", ops: ["browser.sessions", "browser.call"], platforms: ALL, summary: "The person's own browser through the AI Matrx extension: tabs, read, screenshot, navigate, click, type" },
   { name: "desktop_window", group: "os_control", state: "built", path: "device_op", ops: ["window.list", "window.focus", "window.move", "window.minimize"], platforms: ALL, summary: "Find, focus and arrange windows" },
   { name: "desktop_input", group: "os_control", state: "built", path: "device_op", ops: ["input.type_text", "input.hotkey", "input.mouse_click", "input.mouse_move", "input.keyboard_settings", "input.set_keyboard_settings"], platforms: ALL, summary: "Keyboard and mouse" },
   { name: "desktop_audio", group: "os_control", state: "built", path: "device_op", ops: ["audio.devices", "audio.levels", "audio.set_levels", "audio.record", "audio.play"], platforms: ALL, summary: "Audio devices, record, play" },
@@ -3637,14 +3762,15 @@ var LEGACY_ACTIONS = {
   "local_system.open_url": tool("desktop_system"),
   "local_system.open_path": tool("desktop_system"),
   "local_system.notify": tool("desktop_system"),
-  "local_browser.navigate": dropped("The browser agent is the extension (matrx-extend) and the cloud browser; a second Playwright on the device duplicates it"),
-  "local_browser.click": dropped("The browser agent is the extension (matrx-extend) and the cloud browser"),
-  "local_browser.type_text": dropped("The browser agent is the extension (matrx-extend) and the cloud browser"),
-  "local_browser.extract": dropped("The browser agent is the extension (matrx-extend) and the cloud browser"),
-  "local_browser.screenshot": dropped("The browser agent is the extension (matrx-extend) and the cloud browser"),
-  "local_browser.eval": dropped("The browser agent is the extension (matrx-extend) and the cloud browser"),
-  "local_browser.tabs": dropped("The browser agent is the extension (matrx-extend) and the cloud browser"),
-  "local_browser.close": dropped("The browser agent is the extension (matrx-extend) and the cloud browser"),
+  // The person's own browser is the AI Matrx extension paired with Matrx 2 (cap browser).
+  "local_browser.navigate": tool("desktop_browser"),
+  "local_browser.click": tool("desktop_browser"),
+  "local_browser.type_text": tool("desktop_browser"),
+  "local_browser.extract": tool("desktop_browser"),
+  "local_browser.screenshot": tool("desktop_browser"),
+  "local_browser.eval": dropped("The extension runs no page script for Matrx 2: its script and cdp tools are privileged and refused over the desktop path; read, click and type cover what eval was used for"),
+  "local_browser.tabs": tool("desktop_browser"),
+  "local_browser.close": tool("desktop_browser"),
   "local_web.fetch": tool("desktop_web"),
   "local_web.fetch_with_browser": tool("desktop_web"),
   "local_web.scrape": tool("desktop_web"),
@@ -3840,6 +3966,29 @@ function renderToolStatusMarkdown(status) {
   }
   return lines.join("\n");
 }
+
+// src/tools/policy.ts
+function refusedOps(disabledTools) {
+  const off = new Set(disabledTools);
+  const senders = /* @__PURE__ */ new Map();
+  for (const tool2 of TOOL_CATALOG) for (const op of tool2.ops) senders.set(op, [...senders.get(op) ?? [], tool2.name]);
+  const refused = /* @__PURE__ */ new Set();
+  for (const [op, tools] of senders) if (tools.every((t) => off.has(t))) refused.add(op);
+  return refused;
+}
+function toolsSending(op) {
+  return TOOL_CATALOG.filter((t) => t.ops.includes(op)).map((t) => t.name);
+}
+function sharedOpsBlocking(tool2, disabledTools) {
+  const entry = TOOL_CATALOG.find((t) => t.name === tool2);
+  if (!entry || entry.ops.length === 0) return [];
+  const off = /* @__PURE__ */ new Set([...disabledTools, tool2]);
+  const refused = refusedOps([...off]);
+  if (entry.ops.some((op) => refused.has(op))) return [];
+  const keepers = /* @__PURE__ */ new Set();
+  for (const op of entry.ops) for (const other of TOOL_CATALOG) if (other.name !== tool2 && !off.has(other.name) && other.ops.includes(op)) keepers.add(other.name);
+  return [...keepers].sort();
+}
 export {
   AbsPath,
   AccountAgent,
@@ -4074,10 +4223,14 @@ export {
   FrameHeader,
   FsChange,
   FsChangedEvent,
+  FsCopyParams,
+  FsCopyResult,
   FsDeleteParams,
   FsDeleteResult,
   FsEncoding,
   FsEntry,
+  FsInfoParams,
+  FsInfoResult,
   FsKind,
   FsListParams,
   FsListResult,
@@ -4095,6 +4248,8 @@ export {
   FsReadStreamResult,
   FsSearchContentParams,
   FsSearchContentResult,
+  FsSearchIndexParams,
+  FsSearchIndexResult,
   FsSearchPathsParams,
   FsSearchPathsResult,
   FsStatParams,
@@ -4146,6 +4301,8 @@ export {
   LEGACY_ACTIONS,
   LEGACY_DISPATCHERS,
   Limits,
+  LlmRunning,
+  LlmServerState,
   MATRX_EXTENSION_IDS,
   MlInstallPhase,
   MlInstallProgress,
@@ -4157,6 +4314,14 @@ export {
   MlStatusResult,
   ModelsInstallParams,
   ModelsInstallResult,
+  ModelsLlmInstallParams,
+  ModelsLlmInstallResult,
+  ModelsLlmStartParams,
+  ModelsLlmStartResult,
+  ModelsLlmStatusParams,
+  ModelsLlmStatusResult,
+  ModelsLlmStopParams,
+  ModelsLlmStopResult,
   ModelsProgressEvent,
   ModelsStatusParams,
   ModelsStatusResult,
@@ -4191,6 +4356,7 @@ export {
   ProcSort,
   ProjectMoveChat,
   ProjectMoveGroup,
+  ProjectMovePin,
   ProjectMoveSkip,
   ProtocolErrorBody,
   ProtocolVersion,
@@ -4308,6 +4474,8 @@ export {
   TOOL_GROUPS,
   TOOL_LEVELS,
   TOOL_PLATFORMS,
+  TextModelId,
+  TextModelInfo,
   TitleCopies,
   TitleMismatch,
   ToolLevel,
@@ -4368,9 +4536,12 @@ export {
   negotiate,
   nonNegInt,
   readCid,
+  refusedOps,
   renderToolStatusMarkdown,
+  sharedOpsBlocking,
   stampCid,
   statusForPeer,
+  toolsSending,
   u32,
   versionSubprotocol
 };