@ai-matrx/desktop-protocol 0.12.0 → 0.14.0

package/dist/client.d.cts

@@ -1,8 +1,8 @@
 import { BackoffOptions } from '@ai-matrx/realtime';
 export { RECONNECT_ALARM_ATTEMPTS } from '@ai-matrx/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-CxAHZMAM.cjs';
-export { i as isDesktopProtocolError } from './models-CxAHZMAM.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-DqFPqtNS.cjs';
+export { i as isDesktopProtocolError } from './models-DqFPqtNS.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/realtime';
 export { RECONNECT_ALARM_ATTEMPTS } from '@ai-matrx/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-CxAHZMAM.js';
-export { i as isDesktopProtocolError } from './models-CxAHZMAM.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-DqFPqtNS.js';
+export { i as isDesktopProtocolError } from './models-DqFPqtNS.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

@@ -94,7 +94,7 @@ import { z as z2 } from "zod";
 // src/schema/primitives.ts
 import { z } from "zod";
 var PROTOCOL_MAJOR = 1;
-var PROTOCOL_MINOR = 2;
+var PROTOCOL_MINOR = 3;
 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_-]+$/);
@@ -781,23 +781,86 @@ var RelayCallEnvelope = z10.strictObject({
   params: z10.unknown()
 });
 
-// src/schema/apps.ts
+// src/schema/clipboard.ts
 import { z as z11 } from "zod";
-var AppKey = z11.string().regex(/^[a-z][a-z0-9_-]{0,39}$/);
-var AppProfileId = z11.string().regex(/^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/);
-var AppProfileLocator = z11.string().min(1).max(512).regex(/^[A-Za-z0-9 _()+@,-][A-Za-z0-9 ._()+@,-]{0,127}(\/[A-Za-z0-9 _()+@,-][A-Za-z0-9 ._()+@,-]{0,127}){0,7}$/);
-var AppSupport = z11.enum(["supported", "partial", "unsupported"]);
-var AppFeatureStatus = z11.strictObject({
+var ClipboardReadParams = z11.strictObject({});
+var ClipboardReadResult = z11.strictObject({
+  /** The clipboard's text ("" when it holds none), cut to 1 MiB. */
+  text: z11.string().max(1048576),
+  truncated: z11.boolean()
+});
+var ClipboardWriteParams = z11.strictObject({ text: z11.string().max(1048576) });
+var ClipboardWriteResult = z11.strictObject({ bytes: nonNegInt });
+
+// src/schema/proc.ts
+import { z as z12 } from "zod";
+var ProcSort = z12.enum(["cpu", "memory", "pid", "name"]);
+var ProcListParams = z12.strictObject({
+  /** Case-insensitive substring of the process name or its command line. */
+  name: z12.string().min(1).max(128).optional(),
+  sort: ProcSort.default("cpu"),
+  limit: z12.int().min(1).max(500).default(50)
+});
+var ProcInfo = z12.strictObject({
+  pid: z12.int().min(0),
+  /** Parent process id; null where the OS does not report it. */
+  ppid: z12.int().min(0).nullable(),
+  name: z12.string().max(256),
+  /** The command line, cut to 1024 characters. */
+  command: z12.string().max(1024),
+  /** Share of one core, as `ps` and Task Manager report it; null where the OS does not say. */
+  cpu_percent: z12.number().min(0).nullable(),
+  memory_bytes: nonNegInt.nullable(),
+  user: z12.string().max(128).nullable()
+});
+var ProcListResult = z12.strictObject({
+  processes: z12.array(ProcInfo).max(500),
+  /** Processes that matched before `limit`. */
+  total: nonNegInt,
+  truncated: z12.boolean()
+});
+var ProcPortsParams = z12.strictObject({
+  /** Only this port. */
+  port: z12.int().min(1).max(65535).optional()
+});
+var ProcPort = z12.strictObject({
+  port: z12.int().min(1).max(65535),
+  protocol: z12.enum(["tcp", "udp"]),
+  /** The local address it listens on ("127.0.0.1", "*", "::"). */
+  address: z12.string().max(64),
+  pid: z12.int().min(0).nullable(),
+  process: z12.string().max(256).nullable()
+});
+var ProcPortsResult = z12.strictObject({ ports: z12.array(ProcPort).max(4e3) });
+var ProcKillParams = z12.strictObject({
+  pid: z12.int().min(1),
+  /** Kill outright (SIGKILL; on Windows the same /F) instead of asking it to quit. */
+  force: z12.boolean().default(false)
+});
+var ProcKillResult = z12.strictObject({
+  pid: z12.int().min(1),
+  signal: z12.enum(["SIGTERM", "SIGKILL"]),
+  /** True when the process was gone within 3 s. */
+  exited: z12.boolean()
+});
+
+// src/schema/apps.ts
+import { z as z13 } from "zod";
+var AppKey = z13.string().regex(/^[a-z][a-z0-9_-]{0,39}$/);
+var AppProfileId = z13.string().regex(/^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/);
+var AppProfileLocator = z13.string().min(1).max(512).regex(/^[A-Za-z0-9 _()+@,-][A-Za-z0-9 ._()+@,-]{0,127}(\/[A-Za-z0-9 _()+@,-][A-Za-z0-9 ._()+@,-]{0,127}){0,7}$/);
+var AppSupport = z13.enum(["supported", "partial", "unsupported"]);
+var AppFeatureStatus = z13.strictObject({
   status: AppSupport,
   /** One line, set whenever status is not "supported". */
-  reason: z11.string().max(140).nullable()
+  reason: z13.string().max(140).nullable()
 });
-var AppInfo = z11.strictObject({
+var AppInfo = z13.strictObject({
   app_key: AppKey,
-  name: z11.string().max(64),
-  installed: z11.boolean(),
+  name: z13.string().max(64),
+  installed: z13.boolean(),
   /** The app's own version string, or null when it is not installed or does not say. */
-  version: z11.string().max(64).nullable(),
+  version: z13.string().max(64).nullable(),
   /** The install found (an .app bundle, an .exe, a binary), or null. */
   location: AbsPath.nullable(),
   /** Open the app at all on this OS. */
@@ -807,69 +870,69 @@ var AppInfo = z11.strictObject({
   /** Plan usage read from the app's own files on this OS. */
   usage: AppFeatureStatus
 });
-var AppUsageReading = z11.strictObject({
-  window: z11.enum(["five_hour", "weekly", "extra"]),
+var AppUsageReading = z13.strictObject({
+  window: z13.enum(["five_hour", "weekly", "extra"]),
   /** 0–100 for five_hour and weekly; extra-usage spend as a percent of its cap (may pass 100). */
-  percent: z11.number().min(0).max(1e4),
+  percent: z13.number().min(0).max(1e4),
   /** When the app recorded it. */
   sampled_at_ms: epochMs,
   /** True when the window has rolled over since the sample, so the figure has reset. */
-  reset_since: z11.boolean()
+  reset_since: z13.boolean()
 });
-var AppProfile = z11.strictObject({
+var AppProfile = z13.strictObject({
   /** The row's id; null for a folder found on disk that no row names yet. */
   id: AppProfileId.nullable(),
   app_key: AppKey,
-  display_name: z11.string().min(1).max(120),
+  display_name: z13.string().min(1).max(120),
   /** The account the person means to be signed in here; null when not stated (never guessed). */
-  account_identity: z11.string().min(3).max(320).nullable(),
+  account_identity: z13.string().min(3).max(320).nullable(),
   profile_locator: AppProfileLocator.nullable(),
   /** The device the row is tied to; null when the row names none. */
   device_id: DeviceId.nullable(),
   /** The folder this profile resolves to on this device; null for a row tied to another device. */
   folder: AbsPath.nullable(),
   /** The folder exists on this device. */
-  on_disk: z11.boolean(),
+  on_disk: z13.boolean(),
   /** An instance with this profile is running; null when it could not be determined. */
-  running: z11.boolean().nullable(),
+  running: z13.boolean().nullable(),
   /** Usage the app recorded for this profile; null when the app exposes none here. */
-  usage: z11.array(AppUsageReading).nullable(),
+  usage: z13.array(AppUsageReading).nullable(),
   last_opened_ms: epochMs.nullable()
 });
-var AppsListParams = z11.strictObject({});
-var AppsListResult = z11.strictObject({ apps: z11.array(AppInfo) });
-var AppsProfilesListParams = z11.strictObject({
+var AppsListParams = z13.strictObject({});
+var AppsListResult = z13.strictObject({ apps: z13.array(AppInfo) });
+var AppsProfilesListParams = z13.strictObject({
   /** Only this app's profiles; every app's when absent. */
   app_key: AppKey.optional()
 });
-var AppsProfilesListResult = z11.strictObject({
-  profiles: z11.array(AppProfile),
+var AppsProfilesListResult = z13.strictObject({
+  profiles: z13.array(AppProfile),
   /**
    * Whether the saved rows could be read: false while signed out or offline, when only folders
    * found on disk are listed.
    */
-  registry: z11.enum(["ok", "signed_out", "unavailable"])
+  registry: z13.enum(["ok", "signed_out", "unavailable"])
 });
-var AppsProfilesSaveParams = z11.strictObject({
+var AppsProfilesSaveParams = z13.strictObject({
   id: AppProfileId.optional(),
   app_key: AppKey,
-  display_name: z11.string().min(1).max(120),
-  account_identity: z11.string().min(3).max(320).nullable(),
+  display_name: z13.string().min(1).max(120),
+  account_identity: z13.string().min(3).max(320).nullable(),
   /** On create: the folder to use (one found on disk), or null for the app's default profile. Ignored on update. */
   profile_locator: AppProfileLocator.nullable(),
   /** On create with profile_locator null: make a new folder named after display_name instead. */
-  new_folder: z11.boolean().default(false)
+  new_folder: z13.boolean().default(false)
 });
 var AppsProfilesSaveResult = AppProfile;
-var AppsProfilesRemoveParams = z11.strictObject({ id: AppProfileId });
-var AppsProfilesRemoveResult = z11.strictObject({ removed: z11.boolean() });
-var AppsOpenParams = z11.strictObject({
+var AppsProfilesRemoveParams = z13.strictObject({ id: AppProfileId });
+var AppsProfilesRemoveResult = z13.strictObject({ removed: z13.boolean() });
+var AppsOpenParams = z13.strictObject({
   app_key: AppKey,
   profile_id: AppProfileId.optional()
 });
-var AppsOpenResult = z11.strictObject({
+var AppsOpenResult = z13.strictObject({
   /** True when an instance with this profile was already running; it is brought forward. */
-  already_running: z11.boolean(),
+  already_running: z13.boolean(),
   folder: AbsPath.nullable()
 });
 
@@ -909,7 +972,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,