@ai-matrx/desktop-protocol 0.13.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,
@@ -149,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,
@@ -247,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_-]+$/);
@@ -1195,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 = {
@@ -1231,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,
@@ -1383,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,
@@ -1488,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 = {
@@ -1539,9 +1633,10 @@ var TOOL_CATALOG = [
   { name: "shell_python", group: "files_shell", state: "built", path: "sandbox_proxy", ops: ["exec.run"], platforms: ALL, summary: "Run a Python script" },
   { 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" },
@@ -1599,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"),