@ai-matrx/desktop-protocol 0.12.0 → 0.14.0

package/dist/index.cjs

@@ -46,6 +46,10 @@ __export(src_exports, {
   CancelMsg: () => CancelMsg,
   ClientToCoreMsg: () => ClientToCoreMsg,
   ClientType: () => ClientType,
+  ClipboardReadParams: () => ClipboardReadParams,
+  ClipboardReadResult: () => ClipboardReadResult,
+  ClipboardWriteParams: () => ClipboardWriteParams,
+  ClipboardWriteResult: () => ClipboardWriteResult,
   CloseCode: () => CloseCode,
   CloseCodeValue: () => CloseCodeValue,
   ContractHash: () => ContractHash,
@@ -58,6 +62,7 @@ __export(src_exports, {
   DesktopProtocolError: () => DesktopProtocolError,
   DeviceId: () => DeviceId,
   EVENTS: () => EVENTS,
+  EXCLUDED_TOOLS: () => EXCLUDED_TOOLS,
   EndMsg: () => EndMsg,
   EndReason: () => EndReason,
   ErrorCode: () => ErrorCode,
@@ -148,6 +153,15 @@ __export(src_exports, {
   PROTOCOL_MAJOR: () => PROTOCOL_MAJOR,
   PROTOCOL_MINOR: () => PROTOCOL_MINOR,
   PROTOCOL_VERSION: () => PROTOCOL_VERSION,
+  ProcInfo: () => ProcInfo,
+  ProcKillParams: () => ProcKillParams,
+  ProcKillResult: () => ProcKillResult,
+  ProcListParams: () => ProcListParams,
+  ProcListResult: () => ProcListResult,
+  ProcPort: () => ProcPort,
+  ProcPortsParams: () => ProcPortsParams,
+  ProcPortsResult: () => ProcPortsResult,
+  ProcSort: () => ProcSort,
   ProtocolErrorBody: () => ProtocolErrorBody,
   ProtocolVersion: () => ProtocolVersion,
   PtyInfo: () => PtyInfo,
@@ -246,7 +260,7 @@ module.exports = __toCommonJS(src_exports);
 // src/schema/primitives.ts
 var import_zod = require("zod");
 var PROTOCOL_MAJOR = 1;
-var PROTOCOL_MINOR = 2;
+var PROTOCOL_MINOR = 3;
 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_-]+$/);
@@ -1194,6 +1208,69 @@ var ToolResultsFile = import_zod13.z.strictObject({
   results: import_zod13.z.array(ToolLevelResult).max(1e4)
 });
 
+// src/schema/proc.ts
+var import_zod14 = require("zod");
+var ProcSort = import_zod14.z.enum(["cpu", "memory", "pid", "name"]);
+var ProcListParams = import_zod14.z.strictObject({
+  /** Case-insensitive substring of the process name or its command line. */
+  name: import_zod14.z.string().min(1).max(128).optional(),
+  sort: ProcSort.default("cpu"),
+  limit: import_zod14.z.int().min(1).max(500).default(50)
+});
+var ProcInfo = import_zod14.z.strictObject({
+  pid: import_zod14.z.int().min(0),
+  /** Parent process id; null where the OS does not report it. */
+  ppid: import_zod14.z.int().min(0).nullable(),
+  name: import_zod14.z.string().max(256),
+  /** The command line, cut to 1024 characters. */
+  command: import_zod14.z.string().max(1024),
+  /** Share of one core, as `ps` and Task Manager report it; null where the OS does not say. */
+  cpu_percent: import_zod14.z.number().min(0).nullable(),
+  memory_bytes: nonNegInt.nullable(),
+  user: import_zod14.z.string().max(128).nullable()
+});
+var ProcListResult = import_zod14.z.strictObject({
+  processes: import_zod14.z.array(ProcInfo).max(500),
+  /** Processes that matched before `limit`. */
+  total: nonNegInt,
+  truncated: import_zod14.z.boolean()
+});
+var ProcPortsParams = import_zod14.z.strictObject({
+  /** Only this port. */
+  port: import_zod14.z.int().min(1).max(65535).optional()
+});
+var ProcPort = import_zod14.z.strictObject({
+  port: import_zod14.z.int().min(1).max(65535),
+  protocol: import_zod14.z.enum(["tcp", "udp"]),
+  /** The local address it listens on ("127.0.0.1", "*", "::"). */
+  address: import_zod14.z.string().max(64),
+  pid: import_zod14.z.int().min(0).nullable(),
+  process: import_zod14.z.string().max(256).nullable()
+});
+var ProcPortsResult = import_zod14.z.strictObject({ ports: import_zod14.z.array(ProcPort).max(4e3) });
+var ProcKillParams = import_zod14.z.strictObject({
+  pid: import_zod14.z.int().min(1),
+  /** Kill outright (SIGKILL; on Windows the same /F) instead of asking it to quit. */
+  force: import_zod14.z.boolean().default(false)
+});
+var ProcKillResult = import_zod14.z.strictObject({
+  pid: import_zod14.z.int().min(1),
+  signal: import_zod14.z.enum(["SIGTERM", "SIGKILL"]),
+  /** True when the process was gone within 3 s. */
+  exited: import_zod14.z.boolean()
+});
+
+// src/schema/clipboard.ts
+var import_zod15 = require("zod");
+var ClipboardReadParams = import_zod15.z.strictObject({});
+var ClipboardReadResult = import_zod15.z.strictObject({
+  /** The clipboard's text ("" when it holds none), cut to 1 MiB. */
+  text: import_zod15.z.string().max(1048576),
+  truncated: import_zod15.z.boolean()
+});
+var ClipboardWriteParams = import_zod15.z.strictObject({ text: import_zod15.z.string().max(1048576) });
+var ClipboardWriteResult = import_zod15.z.strictObject({ bytes: nonNegInt });
+
 // src/schema/registry.ts
 var FS_ERR = ["NOT_FOUND", "PERMISSION_DENIED_OS", "INVALID_PARAMS", "RESOURCE_BUSY", "INTERNAL"];
 var OPS = {
@@ -1230,7 +1307,12 @@ var OPS = {
   "apps.profiles.list": { params: AppsProfilesListParams, result: AppsProfilesListResult, kind: "unary", since: "1.2", errors: ["NOT_FOUND", "INVALID_PARAMS", "INTERNAL"] },
   "apps.profiles.save": { params: AppsProfilesSaveParams, result: AppsProfilesSaveResult, kind: "unary", since: "1.2", errors: ["AUTH_REQUIRED", "AUTH_FORBIDDEN", "NOT_FOUND", "INVALID_PARAMS", "CONFLICT", "PLATFORM_UNSUPPORTED", "DEVICE_OFFLINE", "INTERNAL"] },
   "apps.profiles.remove": { params: AppsProfilesRemoveParams, result: AppsProfilesRemoveResult, kind: "unary", since: "1.2", errors: ["AUTH_REQUIRED", "AUTH_FORBIDDEN", "NOT_FOUND", "DEVICE_OFFLINE", "INTERNAL"] },
-  "apps.open": { params: AppsOpenParams, result: AppsOpenResult, kind: "unary", since: "1.2", errors: ["NOT_FOUND", "PLATFORM_UNSUPPORTED", "AUTH_REQUIRED", "DEVICE_OFFLINE", "INTERNAL"] }
+  "apps.open": { params: AppsOpenParams, result: AppsOpenResult, kind: "unary", since: "1.2", errors: ["NOT_FOUND", "PLATFORM_UNSUPPORTED", "AUTH_REQUIRED", "DEVICE_OFFLINE", "INTERNAL"] },
+  "proc.list": { params: ProcListParams, result: ProcListResult, kind: "unary", since: "1.3", errors: ["INVALID_PARAMS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "proc.ports": { params: ProcPortsParams, result: ProcPortsResult, kind: "unary", since: "1.3", errors: ["INVALID_PARAMS", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "proc.kill": { params: ProcKillParams, result: ProcKillResult, kind: "unary", since: "1.3", errors: ["NOT_FOUND", "AUTH_FORBIDDEN", "PERMISSION_DENIED_OS", "INVALID_PARAMS", "INTERNAL"] },
+  "clipboard.read": { params: ClipboardReadParams, result: ClipboardReadResult, kind: "unary", since: "1.3", errors: ["PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "clipboard.write": { params: ClipboardWriteParams, result: ClipboardWriteResult, kind: "unary", since: "1.3", errors: ["PLATFORM_UNSUPPORTED", "PAYLOAD_TOO_LARGE", "INTERNAL"] }
 };
 var EVENTS = {
   "fs.changed": FsChangedEvent,
@@ -1382,6 +1464,19 @@ var NAMED_SCHEMAS = {
   RelayHopEnvelopeHeader,
   RelayHopConnectionEnd,
   CloseCodeValue,
+  ProcSort,
+  ProcListParams,
+  ProcInfo,
+  ProcListResult,
+  ProcPortsParams,
+  ProcPort,
+  ProcPortsResult,
+  ProcKillParams,
+  ProcKillResult,
+  ClipboardReadParams,
+  ClipboardReadResult,
+  ClipboardWriteParams,
+  ClipboardWriteResult,
   ToolLevel,
   ToolOutcome,
   ToolPlatform,
@@ -1487,7 +1582,7 @@ function forPeer(op, part, value, version) {
 var VERSIONED_RESULT_OPS = [...RESULT_PATH.keys()];
 
 // src/contract.ts
-var CONTRACT_SHA256 = "ef9fd8c8ab611bf450730452a6cf48a4ebd566218b6e17e2834ef030fc2044cb";
+var CONTRACT_SHA256 = "0354e634fd50ffdc4c83b7ede7f9c31f3b2c877c4574557a6b264d2998470fd6";
 
 // src/close-policy.ts
 var CLOSE_RULES = {
@@ -1534,23 +1629,14 @@ var TOOL_CATALOG = [
   { name: "fs_list", group: "files_shell", state: "built", path: "sandbox_proxy", ops: ["fs.list"], platforms: ALL, summary: "List a folder" },
   { name: "fs_mkdir", group: "files_shell", state: "built", path: "sandbox_proxy", ops: ["fs.mkdir"], platforms: ALL, summary: "Create a folder" },
   { name: "fs_search", group: "files_shell", state: "built", path: "sandbox_proxy", ops: ["fs.search_paths", "fs.search_content"], platforms: ALL, summary: "Find files by name or content" },
-  { name: "shell_execute", group: "files_shell", state: "built", path: "sandbox_proxy", ops: ["exec.run"], platforms: ALL, summary: "Run a command in a folder" },
+  { name: "shell_execute", group: "files_shell", state: "built", path: "sandbox_proxy", ops: ["exec.run"], platforms: ALL, summary: "Run a command; cd carries over" },
   { name: "shell_python", group: "files_shell", state: "built", path: "sandbox_proxy", ops: ["exec.run"], platforms: ALL, summary: "Run a Python script" },
-  {
-    name: "git_ingest",
-    group: "files_shell",
-    state: "broken",
-    path: "server",
-    ops: [],
-    platforms: ALL,
-    summary: "Digest a repository",
-    note: "Armed with the files tools, but a local path is read on the server, not the bound device"
-  },
   { name: "shell_job", group: "files_shell", state: "planned", path: "device_op", ops: ["exec.job.start", "exec.job.output", "exec.job.stop"], platforms: ALL, summary: "Background commands: start, read output, stop" },
   // ── 2. Computer control (TS owners) ──────────────────────────────────────────────────────────
-  { name: "desktop_process", group: "os_control", state: "planned", path: "device_op", ops: ["proc.list", "proc.ports", "proc.kill", "proc.launch_app", "proc.focus_app", "proc.installed_apps"], platforms: ALL, summary: "Processes, ports and apps" },
+  { name: "desktop_process", group: "os_control", state: "built", path: "device_op", ops: ["proc.list", "proc.ports", "proc.kill"], platforms: ALL, summary: "Running processes and ports; stop one" },
+  { name: "desktop_apps", group: "os_control", state: "planned", path: "device_op", ops: ["apps.list", "apps.open"], platforms: ALL, summary: "Installed apps; open or bring one forward" },
   { name: "desktop_system", group: "os_control", state: "planned", path: "device_op", ops: ["sysinfo.get", "system.open_url", "system.open_path", "system.notify"], platforms: ALL, summary: "System facts, open, notify" },
-  { name: "desktop_clipboard", group: "os_control", state: "planned", path: "device_op", ops: ["clipboard.read", "clipboard.write"], platforms: ALL, summary: "Read and write the clipboard" },
+  { 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: "planned", path: "device_op", ops: ["screen.list", "screen.capture"], platforms: ALL, summary: "Displays and screenshots" },
   { name: "desktop_window", group: "os_control", state: "planned", 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: "planned", path: "device_op", ops: ["input.type_text", "input.hotkey", "input.mouse_click", "input.mouse_move"], platforms: ALL, summary: "Keyboard and mouse" },
@@ -1577,6 +1663,9 @@ var TOOL_CATALOG = [
   // ── 6. Windows administration ────────────────────────────────────────────────────────────────
   { name: "desktop_windows_admin", group: "windows_admin", state: "planned", path: "device_op", ops: ["windows.registry_read", "windows.registry_write", "windows.services", "windows.service_control", "windows.event_log", "windows.features"], platforms: ["win32"], summary: "Registry, services, event log" }
 ];
+var EXCLUDED_TOOLS = {
+  git_ingest: "Runs on the server: it ingests repository URLs. A local path on a bound computer or sandbox is refused with the fs_* and shell remedy, since the server cannot see it"
+};
 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";
@@ -1605,12 +1694,12 @@ var LEGACY_ACTIONS = {
   "local_window.minimize": tool("desktop_window"),
   "local_process.list": tool("desktop_process"),
   "local_process.ports": tool("desktop_process"),
-  "local_process.launch_app": tool("desktop_process"),
+  "local_process.launch_app": tool("desktop_apps"),
   "local_process.kill": tool("desktop_process"),
-  "local_process.focus_app": tool("desktop_process"),
+  "local_process.focus_app": tool("desktop_apps"),
   "local_process.terminals": dropped("Matrx 2 terminals are exec sessions; the person's own terminal windows are not the agent's"),
   "local_process.tail_terminal": dropped("Matrx 2 terminals are exec sessions; the person's own terminal windows are not the agent's"),
-  "local_process.installed_apps": tool("desktop_process"),
+  "local_process.installed_apps": tool("desktop_apps"),
   "local_input.type_text": tool("desktop_input"),
   "local_input.hotkey": tool("desktop_input"),
   "local_input.mouse_click": tool("desktop_input"),
@@ -1826,6 +1915,10 @@ function renderToolStatusMarkdown(status) {
     }
     lines.push("");
   }
+  const excluded = Object.entries(EXCLUDED_TOOLS);
+  if (excluded.length > 0) {
+    lines.push("## Not device tools", "", "| Tool | Why |", "|---|---|", ...excluded.map(([name, why]) => `| ${name} | ${why} |`), "");
+  }
   return lines.join("\n");
 }
 //# sourceMappingURL=index.cjs.map