@ai-matrx/desktop-protocol 0.21.25 → 0.21.27

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.21.27
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/desktop-protocol/v0.21.26..npm/desktop-protocol/v0.21.27 -- apps/shared/desktop-protocol`).
+No source changes intended and no consumer action required.
+
+## 0.21.26
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/desktop-protocol/v0.21.25..npm/desktop-protocol/v0.21.26 -- apps/shared/desktop-protocol`).
+No source changes intended and no consumer action required.
+
 ## 0.21.25
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see

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 = 29;
+var PROTOCOL_MINOR = 32;
 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_-]+$/);
@@ -554,6 +554,8 @@ var FsMkdirParams = import_zod6.z.strictObject({ path: AbsPath, parents: import_
 var FsMkdirResult = import_zod6.z.strictObject({ path: AbsPath, created: import_zod6.z.boolean() });
 var FsMoveParams = import_zod6.z.strictObject({ from_path: AbsPath, to_path: AbsPath, overwrite: import_zod6.z.boolean().default(false) });
 var FsMoveResult = import_zod6.z.strictObject({ from_path: AbsPath, to_path: AbsPath });
+var FsCopyParams = import_zod6.z.strictObject({ from_path: AbsPath, to_path: AbsPath, overwrite: import_zod6.z.boolean().default(false) });
+var FsCopyResult = import_zod6.z.strictObject({ from_path: AbsPath, to_path: AbsPath });
 var FsDeleteParams = import_zod6.z.strictObject({
   path: AbsPath,
   recursive: import_zod6.z.boolean().default(false),
@@ -622,6 +624,36 @@ var FsSearchContentResult = import_zod6.z.strictObject({
     })
   )
 });
+var FsSearchIndexParams = import_zod6.z.strictObject({
+  query: import_zod6.z.string().min(1).max(256),
+  /** Only under this folder; absent: the whole computer (the walk: the home folder). */
+  scope: AbsPath.optional(),
+  max_results: import_zod6.z.int().min(1).max(1e3).default(200)
+});
+var FsSearchIndexResult = import_zod6.z.strictObject({
+  entries: import_zod6.z.array(FsEntry).max(1e3),
+  truncated: import_zod6.z.boolean(),
+  source: import_zod6.z.enum(["index", "walk"])
+});
+var FsInfoParams = import_zod6.z.strictObject({ path: AbsPath });
+var FsInfoResult = import_zod6.z.strictObject({
+  entry: FsEntry,
+  created: import_zod6.z.number().min(0).nullable(),
+  // seconds, float
+  owner: import_zod6.z.string().max(256).nullable(),
+  group: import_zod6.z.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: import_zod6.z.boolean(),
+  /** Finder's Locked (macOS uchg); null where the OS has no such flag. */
+  locked: import_zod6.z.boolean().nullable(),
+  /** The volume holding it refuses writes (a disk image, a read-only share). */
+  read_only: import_zod6.z.boolean()
+});
 var FsChange = import_zod6.z.strictObject({
   type: import_zod6.z.enum(["created", "modified", "deleted", "moved"]),
   path: AbsPath,
@@ -790,6 +822,49 @@ var MlProgress = import_zod9.z.strictObject({
   /** The segment just transcribed (transcribe only): text appears as it is recognised. */
   segment: TranscriptSegment.nullable()
 });
+var TextModelId = import_zod9.z.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 = import_zod9.z.strictObject({
+  id: TextModelId,
+  /** Download size of the weights. */
+  size_bytes: nonNegInt,
+  installed: import_zod9.z.boolean()
+});
+var LlmServerState = import_zod9.z.enum(["stopped", "starting", "running", "failed"]);
+var LlmRunning = import_zod9.z.strictObject({ id: TextModelId, port: import_zod9.z.int().min(1024).max(65535) });
+var ModelsLlmStatusParams = import_zod9.z.strictObject({});
+var ModelsLlmStatusResult = import_zod9.z.strictObject({
+  state: LlmServerState,
+  /** Every model in the catalog, with whether its weights are on this computer. */
+  models: import_zod9.z.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: 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 ModelsLlmStartParams = import_zod9.z.strictObject({
+  model: TextModelId,
+  /** Tokens of context; the service picks a size that fits this computer when omitted. */
+  context_length: import_zod9.z.int().min(512).max(131072).optional()
+});
+var ModelsLlmStartResult = import_zod9.z.strictObject({ running: LlmRunning, elapsed_ms: nonNegInt });
+var ModelsLlmStopParams = import_zod9.z.strictObject({});
+var ModelsLlmStopResult = import_zod9.z.strictObject({ stopped: import_zod9.z.boolean() });
 var MlServiceState = import_zod9.z.enum(["starting", "ready", "restarting", "failed", "stopped"]);
 var MlServiceStatus = import_zod9.z.strictObject({
   state: MlServiceState,
@@ -2334,6 +2409,19 @@ var ProjectMoveGroup = import_zod30.z.strictObject({
   /** A group of that name was already there (reused, never doubled). */
   group_exists: import_zod30.z.boolean().optional()
 });
+var ProjectMovePin = import_zod30.z.strictObject({
+  ok: import_zod30.z.boolean(),
+  /** "now" = written into the closed window; "next_close" = queued until that window closes. */
+  when: import_zod30.z.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: import_zod30.z.string().max(400).optional()
+});
 var AppsProjectsToWindowParams = import_zod30.z.strictObject({
   app_key: AppKey,
   project_id: ChatProjectId,
@@ -2342,6 +2430,8 @@ var AppsProjectsToWindowParams = import_zod30.z.strictObject({
   take_off: import_zod30.z.boolean().default(false),
   /** Also group them under the project's name in that window's sidebar (closed windows only). */
   group: import_zod30.z.boolean().default(false),
+  /** 1.32: also pin them in that window (now if closed, else when it next closes). */
+  pin: import_zod30.z.boolean().optional(),
   dry_run: import_zod30.z.boolean().default(false)
 });
 var AppsProjectsToWindowResult = import_zod30.z.strictObject({
@@ -2355,6 +2445,8 @@ var AppsProjectsToWindowResult = import_zod30.z.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: import_zod30.z.string().max(400)
 });
 var ColdChat = import_zod30.z.strictObject({
@@ -2642,6 +2734,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"] },
@@ -2662,6 +2757,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"] },