@ai-matrx/desktop-protocol 0.21.76 → 0.21.78

package/dist/client.d.cts

@@ -1,8 +1,8 @@
 import { BackoffOptions } from '@ai-matrx/data/realtime';
 export { RECONNECT_ALARM_ATTEMPTS } from '@ai-matrx/data/realtime';
 import { z } from 'zod';
-import { W as Welcome, D as DesktopProtocolError, C as CloseOutcome, O as OpName, a as OpParams, b as OpResult, c as OPS, S as StreamMeta, E as EndReason, d as EVENTS, e as ClientType, M as ModelsTranscribeResult, T as TranscriptionModelId, f as MlProgress } from './models-Bz88NHi0.cjs';
-export { i as isDesktopProtocolError } from './models-Bz88NHi0.cjs';
+import { W as Welcome, D as DesktopProtocolError, C as CloseOutcome, O as OpName, a as OpParams, b as OpResult, c as OPS, S as StreamMeta, E as EndReason, d as EVENTS, e as ClientType, M as ModelsTranscribeResult, T as TranscriptionModelId, f as MlProgress } from './models-DzJnHq8i.cjs';
+export { i as isDesktopProtocolError } from './models-DzJnHq8i.cjs';
 import { FrameHeader } from './frame.cjs';
 
 /** The subset of the WHATWG WebSocket the client uses — browser, React Native, `ws` and Workers all fit. */

package/dist/client.d.ts

@@ -1,8 +1,8 @@
 import { BackoffOptions } from '@ai-matrx/data/realtime';
 export { RECONNECT_ALARM_ATTEMPTS } from '@ai-matrx/data/realtime';
 import { z } from 'zod';
-import { W as Welcome, D as DesktopProtocolError, C as CloseOutcome, O as OpName, a as OpParams, b as OpResult, c as OPS, S as StreamMeta, E as EndReason, d as EVENTS, e as ClientType, M as ModelsTranscribeResult, T as TranscriptionModelId, f as MlProgress } from './models-Bz88NHi0.js';
-export { i as isDesktopProtocolError } from './models-Bz88NHi0.js';
+import { W as Welcome, D as DesktopProtocolError, C as CloseOutcome, O as OpName, a as OpParams, b as OpResult, c as OPS, S as StreamMeta, E as EndReason, d as EVENTS, e as ClientType, M as ModelsTranscribeResult, T as TranscriptionModelId, f as MlProgress } from './models-DzJnHq8i.js';
+export { i as isDesktopProtocolError } from './models-DzJnHq8i.js';
 import { FrameHeader } from './frame.js';
 
 /** The subset of the WHATWG WebSocket the client uses — browser, React Native, `ws` and Workers all fit. */

package/dist/client.js

@@ -12,7 +12,7 @@ import {
   Welcome,
   closeRule,
   knows
-} from "./chunk-server-HOQE4M4I.js";
+} from "./chunk-server-2NXFL3HJ.js";
 import {
   DesktopProtocolError,
   FRAME_VERSION,

package/dist/index.cjs

@@ -565,6 +565,8 @@ __export(src_exports, {
   ModelsDownloadsListResult: () => ModelsDownloadsListResult,
   ModelsInstallParams: () => ModelsInstallParams,
   ModelsInstallResult: () => ModelsInstallResult,
+  ModelsLlmChatParams: () => ModelsLlmChatParams,
+  ModelsLlmChatResult: () => ModelsLlmChatResult,
   ModelsLlmInstallParams: () => ModelsLlmInstallParams,
   ModelsLlmInstallResult: () => ModelsLlmInstallResult,
   ModelsLlmStartParams: () => ModelsLlmStartParams,
@@ -941,7 +943,7 @@ module.exports = __toCommonJS(src_exports);
 var import_zod = require("zod");
 var import_uuid = require("@ai-matrx/kit/uuid");
 var PROTOCOL_MAJOR = 1;
-var PROTOCOL_MINOR = 75;
+var PROTOCOL_MINOR = 76;
 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_-]+$/);
@@ -1028,8 +1030,13 @@ var ErrorReason = import_zod2.z.enum([
   "awaiting_confirmation",
   // TIMEOUT: the person did not answer the browser's confirmation in time
   // 1.34 (REASONS_SINCE): the per-device tool policy (src/tools/policy.ts)
-  "tool_disabled_on_device"
+  "tool_disabled_on_device",
   // AUTH_FORBIDDEN: the person turned this tool off for agents on this computer (Agents › Tools)
+  // 1.76 (REASONS_SINCE): models.llm.chat
+  "model_not_running",
+  // NOT_FOUND (nothing runs) or RESOURCE_BUSY (another model runs): start this model first
+  "model_server_unreachable"
+  // RESOURCE_GONE (retryable): llama-server did not answer on this computer
 ]);
 var FsPatchEditFailure = import_zod2.z.strictObject({ edit_index: nonNegInt, reason: import_zod2.z.string().max(300) });
 var ProtocolErrorBody = import_zod2.z.strictObject({
@@ -1888,6 +1895,14 @@ var ModelsLlmStartParams = import_zod10.z.strictObject({
 var ModelsLlmStartResult = import_zod10.z.strictObject({ running: LlmRunning, elapsed_ms: nonNegInt });
 var ModelsLlmStopParams = import_zod10.z.strictObject({});
 var ModelsLlmStopResult = import_zod10.z.strictObject({ stopped: import_zod10.z.boolean() });
+var ModelsLlmChatParams = import_zod10.z.strictObject({
+  model: TextModelId,
+  body: import_zod10.z.record(import_zod10.z.string().max(200), import_zod10.z.unknown()),
+  /** Start the model first when nothing runs (a `models` progress event says so); a different model running is never stopped. */
+  start_if_stopped: import_zod10.z.boolean().optional(),
+  window_bytes: import_zod10.z.int().min(4096).max(16777216).optional()
+});
+var ModelsLlmChatResult = import_zod10.z.strictObject({ model: TextModelId, content_type: import_zod10.z.string().max(128) });
 var Sha256Hex = import_zod10.z.string().regex(/^[0-9a-f]{64}$/);
 var CatalogFile = import_zod10.z.strictObject({
   /** Path inside the model's folder (the artifact's path_in_repo). */
@@ -5805,6 +5820,7 @@ var OPS = {
   "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"] },
+  "models.llm.chat": { params: ModelsLlmChatParams, result: ModelsLlmChatResult, kind: "stream", since: "1.76", errors: ["NOT_FOUND", "RESOURCE_BUSY", "RESOURCE_GONE", "INVALID_PARAMS", "TIMEOUT", "CANCELLED", "RATE_LIMITED", "INTERNAL"] },
   "models.downloads.list": { params: ModelsDownloadsListParams, result: ModelsDownloadsListResult, kind: "unary", since: "1.45", errors: ["INTERNAL"] },
   "models.downloads.cancel": { params: ModelsDownloadsCancelParams, result: ModelsDownloadsCancelResult, kind: "unary", since: "1.45", errors: ["NOT_FOUND", "INTERNAL"] },
   "models.local.list": { params: ModelsLocalListParams, result: ModelsLocalListResult, kind: "unary", since: "1.74", errors: ["INTERNAL"] },
@@ -6283,6 +6299,8 @@ var NAMED_SCHEMAS = {
   ModelsLlmStartResult,
   ModelsLlmStopParams,
   ModelsLlmStopResult,
+  ModelsLlmChatParams,
+  ModelsLlmChatResult,
   DownloadKind,
   DownloadRow,
   ModelsDownloadsListParams,
@@ -7049,7 +7067,9 @@ var REASONS_SINCE = {
   browser_account_mismatch: "1.28",
   browser_connection_off: "1.28",
   awaiting_confirmation: "1.28",
-  tool_disabled_on_device: "1.34"
+  tool_disabled_on_device: "1.34",
+  model_not_running: "1.76",
+  model_server_unreachable: "1.76"
 };
 var PERMISSIONS_SINCE = {
   reminders: "1.41",
@@ -7275,7 +7295,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 = "2896ee158ca6330cf3cbca88431d15776fb40f53deb0b132bea12ad8d7986757";
+var CONTRACT_SHA256 = "2abe47c1779ecfce3c670b9a5ed3d0a85d9c95e7ec1ebe40b13efcfc54156ca2";
 
 // src/close-policy.ts
 var CLOSE_RULES = {
@@ -7358,8 +7378,11 @@ var TOOL_CATALOG = [
   { 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" },
+  { 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, search and research the web from this computer's own connection (research: search on AI Matrx, every result read here)" },
   { name: "desktop_entities", group: "tools_service", state: "built", path: "device_op", ops: ["entities.ner", "entities.pii"], platforms: ALL, summary: "Names, places, organizations and private data, found on the device" },
+  // matrx-local's SemanticFindPaths: needs a local embedding index of this computer's files and an
+  // embedding model on the device; neither exists yet, so it is Coming soon on Agents › Tools.
+  { name: "desktop_semantic_find", group: "files_shell", state: "planned", path: "device_op", ops: ["fs.search_semantic"], platforms: ALL, summary: "Find files by meaning (a local embedding index of this computer's files)" },
   { name: "desktop_notes", group: "files_shell", state: "built", path: "device_op", ops: ["notes.folders", "notes.list", "notes.read", "notes.write", "notes.search"], platforms: ALL, summary: "The person's local notes (Documents/Matrx/Notes): list, read, write, search" },
   // ── 5. Python `ml` service ───────────────────────────────────────────────────────────────────
   // Built: models.transcribe through local_proxy's POST /op/{cap.op} (matrx-ai implementations/desktop.py).
@@ -7374,7 +7397,6 @@ var EXCLUDED_TOOLS = {
 var tool = (name) => ({ kind: "tool", tool: name });
 var dropped = (reason) => ({ kind: "dropped", reason });
 var SHELL_COVERS = "Done with shell_execute (mv, cp, rm, tar), as every coding agent does";
-var CLOUD_SCRAPER = "The cloud scraper and research tools run with this computer as their network (the `proxy` capability)";
 var LEGACY_ACTIONS = {
   "local_file.read": tool("fs_read"),
   "local_file.write": tool("fs_write"),
@@ -7389,7 +7411,7 @@ var LEGACY_ACTIONS = {
   "local_file.list": tool("fs_list"),
   "local_file.places": dropped("The device's home and folders reach the agent in its binding briefing (sysinfo.get)"),
   "local_file.find": tool("fs_search"),
-  "local_file.semantic_find": dropped("Needs a local embedding index; returns with file sync's index, not before"),
+  "local_file.semantic_find": dropped("Needs a local embedding index; desktop_semantic_find is planned (Coming soon on Agents \u203A Tools) until it exists"),
   "local_shell.run": tool("shell_execute"),
   "local_shell.output": tool("shell_job"),
   "local_shell.stop": tool("shell_job"),
@@ -7437,7 +7459,7 @@ var LEGACY_ACTIONS = {
   "local_web.fetch_with_browser": tool("desktop_web"),
   "local_web.scrape": tool("desktop_web"),
   "local_web.search": tool("desktop_web"),
-  "local_web.research": dropped(CLOUD_SCRAPER),
+  "local_web.research": tool("desktop_web"),
   "local_web.download": tool("desktop_net"),
   "local_web.upload": dropped("Uploads are cloud files (matrx-files) and file sync, one upload path"),
   "local_net.info": tool("desktop_net"),