@ai-matrx/desktop-protocol 0.21.31 → 0.21.32

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -1,6 +1,6 @@
1
1
  import { z } from 'zod';
2
- import { O as OpName } from './models-C4JytZ8c.cjs';
3
- export { B as BEARER_PREFIX, g as CLOSE_RULES, h as CancelMsg, j as ClientToCoreMsg, e as ClientType, k as CloseAction, l as CloseCode, m as CloseCodeValue, C as CloseOutcome, n as CloseRule, o as CoreToClientMsg, p as CreditMsg, D as DesktopProtocolError, d as EVENTS, q as EndMsg, E as EndReason, r as ErrorCode, s as ErrorCodeName, t as ErrorData, u as ErrorMsg, v as ErrorReason, w as ErrorReasonName, x as EventMsg, y as EventName, F as FsPatchEditFailure, H as HelloMsg, L as Limits, z as LlmRunning, A as LlmServerState, G as MlInstallPhase, I as MlInstallProgress, f as MlProgress, J as MlRuntimeState, K as MlServiceState, N as MlServiceStatus, P as MlStatusParams, Q as MlStatusResult, R as ModelsInstallParams, U as ModelsInstallResult, V as ModelsLlmInstallParams, X as ModelsLlmInstallResult, Y as ModelsLlmStartParams, Z as ModelsLlmStartResult, _ as ModelsLlmStatusParams, $ as ModelsLlmStatusResult, a0 as ModelsLlmStopParams, a1 as ModelsLlmStopResult, a2 as ModelsProgressEvent, a3 as ModelsStatusParams, a4 as ModelsStatusResult, a5 as ModelsTranscribeParams, M as ModelsTranscribeResult, a6 as NAMED_SCHEMAS, a7 as NamedSchemaId, c as OPS, a8 as OpDescriptor, a as OpParams, b as OpResult, a9 as OpSpec, aa as PING_TEXT, ab as PONG_TEXT, ac as ProtocolErrorBody, ad as RelayMsg, ae as RequestMsg, af as ResponseMsg, ag as SERVICES, ah as SUBPROTOCOL, ai as ServiceId, aj as ServiceOpName, ak as ServiceOpSpec, al as ServiceSpec, S as StreamMeta, am as StreamMsg, an as TextModelId, ao as TextModelInfo, ap as TranscriptSegment, T as TranscriptionModelId, aq as TranscriptionModelInfo, W as Welcome, ar as closeRule, i as isDesktopProtocolError, as as isTerminalClose } from './models-C4JytZ8c.cjs';
2
+ import { O as OpName } from './models-BNbWn8EL.cjs';
3
+ export { B as BEARER_PREFIX, g as CLOSE_RULES, h as CancelMsg, j as ClientToCoreMsg, e as ClientType, k as CloseAction, l as CloseCode, m as CloseCodeValue, C as CloseOutcome, n as CloseRule, o as CoreToClientMsg, p as CreditMsg, D as DesktopProtocolError, d as EVENTS, q as EndMsg, E as EndReason, r as ErrorCode, s as ErrorCodeName, t as ErrorData, u as ErrorMsg, v as ErrorReason, w as ErrorReasonName, x as EventMsg, y as EventName, F as FsPatchEditFailure, H as HelloMsg, L as Limits, z as LlmRunning, A as LlmServerState, G as MlInstallPhase, I as MlInstallProgress, f as MlProgress, J as MlRuntimeState, K as MlServiceState, N as MlServiceStatus, P as MlStatusParams, Q as MlStatusResult, R as ModelsInstallParams, U as ModelsInstallResult, V as ModelsLlmInstallParams, X as ModelsLlmInstallResult, Y as ModelsLlmStartParams, Z as ModelsLlmStartResult, _ as ModelsLlmStatusParams, $ as ModelsLlmStatusResult, a0 as ModelsLlmStopParams, a1 as ModelsLlmStopResult, a2 as ModelsProgressEvent, a3 as ModelsStatusParams, a4 as ModelsStatusResult, a5 as ModelsTranscribeParams, M as ModelsTranscribeResult, a6 as NAMED_SCHEMAS, a7 as NamedSchemaId, c as OPS, a8 as OpDescriptor, a as OpParams, b as OpResult, a9 as OpSpec, aa as PING_TEXT, ab as PONG_TEXT, ac as ProtocolErrorBody, ad as RelayMsg, ae as RequestMsg, af as ResponseMsg, ag as SERVICES, ah as SUBPROTOCOL, ai as ServiceId, aj as ServiceOpName, ak as ServiceOpSpec, al as ServiceSpec, S as StreamMeta, am as StreamMsg, an as TextModelId, ao as TextModelInfo, ap as TranscriptSegment, T as TranscriptionModelId, aq as TranscriptionModelInfo, W as Welcome, ar as closeRule, i as isDesktopProtocolError, as as isTerminalClose } from './models-BNbWn8EL.cjs';
4
4
  export { BROADCAST_CID, DecodedFrame, FRAME_HEADER_BYTES, FRAME_STRUCT_FORMAT, FRAME_VERSION, FrameChannel, FrameChannelValue, FrameFlag, assertFrameHeader, connectionEndFrame, decodeFrame, encodeFrame, hasFlag, isConnectionEnd, readCid, stampCid } from './frame.cjs';
5
5
 
6
6
  /** @ai-matrx/desktop-protocol — version and primitive schemas. Schema source: lint-enforced rules in scripts/check-schema-source.mjs. */
@@ -108,9 +108,9 @@ declare const PROTOCOL_MAJOR: 1;
108
108
  * page by its name. A 1.40 peer is sent neither the new rows nor the new fields; a 1.40
109
109
  * core refuses the new panes as INVALID_PARAMS.
110
110
  */
111
- declare const PROTOCOL_MINOR: 41;
111
+ declare const PROTOCOL_MINOR: 42;
112
112
  /** This package's version as the wire spells it ("major.minor"): hello, welcome, relay status. */
113
- declare const PROTOCOL_VERSION: "1.41";
113
+ declare const PROTOCOL_VERSION: "1.42";
114
114
  /** Internal building blocks — deliberately unnamed in $defs (inlined wherever used). */
115
115
  declare const u32: z.ZodInt;
116
116
  declare const nonNegInt: z.ZodInt;
@@ -9056,6 +9056,10 @@ type MessagesListResult = z.output<typeof MessagesListResult>;
9056
9056
  declare const MessagesSendParams: z.ZodObject<{
9057
9057
  to: z.ZodString;
9058
9058
  text: z.ZodString;
9059
+ service: z.ZodOptional<z.ZodEnum<{
9060
+ iMessage: "iMessage";
9061
+ SMS: "SMS";
9062
+ }>>;
9059
9063
  }, z.core.$strict>;
9060
9064
  type MessagesSendParams = z.output<typeof MessagesSendParams>;
9061
9065
  declare const MessagesSendResult: z.ZodObject<{
@@ -10027,6 +10031,9 @@ declare const FIELDS_SINCE: {
10027
10031
  readonly "SysinfoGetResult.permissions[]": {
10028
10032
  readonly detail: "1.41";
10029
10033
  };
10034
+ readonly MessagesSendParams: {
10035
+ readonly service: "1.42";
10036
+ };
10030
10037
  };
10031
10038
  type FieldsSincePath = keyof typeof FIELDS_SINCE;
10032
10039
  /**
@@ -10099,7 +10106,7 @@ declare function forPeer(op: OpName | null, part: "error", value: unknown, versi
10099
10106
  declare const VERSIONED_RESULT_OPS: readonly OpName[];
10100
10107
 
10101
10108
  /** SHA-256 of generated/desktop-protocol.schema.json: the contract both sides of a service connection were built from. */
10102
- declare const CONTRACT_SHA256: "a2ea77f45ed3f5421e4c722442205e48fce2bbc5bccc892b54403304eca55443";
10109
+ declare const CONTRACT_SHA256: "c96c1a43bc4b34d518fa088be9300d96baab63938ce0dbfb9425cdc706097668";
10103
10110
 
10104
10111
  /**
10105
10112
  * The local tool catalog (SPEC §10): every tool a platform agent calls on a person's computer, the
package/dist/index.d.ts CHANGED
@@ -1,6 +1,6 @@
1
1
  import { z } from 'zod';
2
- import { O as OpName } from './models-C4JytZ8c.js';
3
- export { B as BEARER_PREFIX, g as CLOSE_RULES, h as CancelMsg, j as ClientToCoreMsg, e as ClientType, k as CloseAction, l as CloseCode, m as CloseCodeValue, C as CloseOutcome, n as CloseRule, o as CoreToClientMsg, p as CreditMsg, D as DesktopProtocolError, d as EVENTS, q as EndMsg, E as EndReason, r as ErrorCode, s as ErrorCodeName, t as ErrorData, u as ErrorMsg, v as ErrorReason, w as ErrorReasonName, x as EventMsg, y as EventName, F as FsPatchEditFailure, H as HelloMsg, L as Limits, z as LlmRunning, A as LlmServerState, G as MlInstallPhase, I as MlInstallProgress, f as MlProgress, J as MlRuntimeState, K as MlServiceState, N as MlServiceStatus, P as MlStatusParams, Q as MlStatusResult, R as ModelsInstallParams, U as ModelsInstallResult, V as ModelsLlmInstallParams, X as ModelsLlmInstallResult, Y as ModelsLlmStartParams, Z as ModelsLlmStartResult, _ as ModelsLlmStatusParams, $ as ModelsLlmStatusResult, a0 as ModelsLlmStopParams, a1 as ModelsLlmStopResult, a2 as ModelsProgressEvent, a3 as ModelsStatusParams, a4 as ModelsStatusResult, a5 as ModelsTranscribeParams, M as ModelsTranscribeResult, a6 as NAMED_SCHEMAS, a7 as NamedSchemaId, c as OPS, a8 as OpDescriptor, a as OpParams, b as OpResult, a9 as OpSpec, aa as PING_TEXT, ab as PONG_TEXT, ac as ProtocolErrorBody, ad as RelayMsg, ae as RequestMsg, af as ResponseMsg, ag as SERVICES, ah as SUBPROTOCOL, ai as ServiceId, aj as ServiceOpName, ak as ServiceOpSpec, al as ServiceSpec, S as StreamMeta, am as StreamMsg, an as TextModelId, ao as TextModelInfo, ap as TranscriptSegment, T as TranscriptionModelId, aq as TranscriptionModelInfo, W as Welcome, ar as closeRule, i as isDesktopProtocolError, as as isTerminalClose } from './models-C4JytZ8c.js';
2
+ import { O as OpName } from './models-BNbWn8EL.js';
3
+ export { B as BEARER_PREFIX, g as CLOSE_RULES, h as CancelMsg, j as ClientToCoreMsg, e as ClientType, k as CloseAction, l as CloseCode, m as CloseCodeValue, C as CloseOutcome, n as CloseRule, o as CoreToClientMsg, p as CreditMsg, D as DesktopProtocolError, d as EVENTS, q as EndMsg, E as EndReason, r as ErrorCode, s as ErrorCodeName, t as ErrorData, u as ErrorMsg, v as ErrorReason, w as ErrorReasonName, x as EventMsg, y as EventName, F as FsPatchEditFailure, H as HelloMsg, L as Limits, z as LlmRunning, A as LlmServerState, G as MlInstallPhase, I as MlInstallProgress, f as MlProgress, J as MlRuntimeState, K as MlServiceState, N as MlServiceStatus, P as MlStatusParams, Q as MlStatusResult, R as ModelsInstallParams, U as ModelsInstallResult, V as ModelsLlmInstallParams, X as ModelsLlmInstallResult, Y as ModelsLlmStartParams, Z as ModelsLlmStartResult, _ as ModelsLlmStatusParams, $ as ModelsLlmStatusResult, a0 as ModelsLlmStopParams, a1 as ModelsLlmStopResult, a2 as ModelsProgressEvent, a3 as ModelsStatusParams, a4 as ModelsStatusResult, a5 as ModelsTranscribeParams, M as ModelsTranscribeResult, a6 as NAMED_SCHEMAS, a7 as NamedSchemaId, c as OPS, a8 as OpDescriptor, a as OpParams, b as OpResult, a9 as OpSpec, aa as PING_TEXT, ab as PONG_TEXT, ac as ProtocolErrorBody, ad as RelayMsg, ae as RequestMsg, af as ResponseMsg, ag as SERVICES, ah as SUBPROTOCOL, ai as ServiceId, aj as ServiceOpName, ak as ServiceOpSpec, al as ServiceSpec, S as StreamMeta, am as StreamMsg, an as TextModelId, ao as TextModelInfo, ap as TranscriptSegment, T as TranscriptionModelId, aq as TranscriptionModelInfo, W as Welcome, ar as closeRule, i as isDesktopProtocolError, as as isTerminalClose } from './models-BNbWn8EL.js';
4
4
  export { BROADCAST_CID, DecodedFrame, FRAME_HEADER_BYTES, FRAME_STRUCT_FORMAT, FRAME_VERSION, FrameChannel, FrameChannelValue, FrameFlag, assertFrameHeader, connectionEndFrame, decodeFrame, encodeFrame, hasFlag, isConnectionEnd, readCid, stampCid } from './frame.js';
5
5
 
6
6
  /** @ai-matrx/desktop-protocol — version and primitive schemas. Schema source: lint-enforced rules in scripts/check-schema-source.mjs. */
@@ -108,9 +108,9 @@ declare const PROTOCOL_MAJOR: 1;
108
108
  * page by its name. A 1.40 peer is sent neither the new rows nor the new fields; a 1.40
109
109
  * core refuses the new panes as INVALID_PARAMS.
110
110
  */
111
- declare const PROTOCOL_MINOR: 41;
111
+ declare const PROTOCOL_MINOR: 42;
112
112
  /** This package's version as the wire spells it ("major.minor"): hello, welcome, relay status. */
113
- declare const PROTOCOL_VERSION: "1.41";
113
+ declare const PROTOCOL_VERSION: "1.42";
114
114
  /** Internal building blocks — deliberately unnamed in $defs (inlined wherever used). */
115
115
  declare const u32: z.ZodInt;
116
116
  declare const nonNegInt: z.ZodInt;
@@ -9056,6 +9056,10 @@ type MessagesListResult = z.output<typeof MessagesListResult>;
9056
9056
  declare const MessagesSendParams: z.ZodObject<{
9057
9057
  to: z.ZodString;
9058
9058
  text: z.ZodString;
9059
+ service: z.ZodOptional<z.ZodEnum<{
9060
+ iMessage: "iMessage";
9061
+ SMS: "SMS";
9062
+ }>>;
9059
9063
  }, z.core.$strict>;
9060
9064
  type MessagesSendParams = z.output<typeof MessagesSendParams>;
9061
9065
  declare const MessagesSendResult: z.ZodObject<{
@@ -10027,6 +10031,9 @@ declare const FIELDS_SINCE: {
10027
10031
  readonly "SysinfoGetResult.permissions[]": {
10028
10032
  readonly detail: "1.41";
10029
10033
  };
10034
+ readonly MessagesSendParams: {
10035
+ readonly service: "1.42";
10036
+ };
10030
10037
  };
10031
10038
  type FieldsSincePath = keyof typeof FIELDS_SINCE;
10032
10039
  /**
@@ -10099,7 +10106,7 @@ declare function forPeer(op: OpName | null, part: "error", value: unknown, versi
10099
10106
  declare const VERSIONED_RESULT_OPS: readonly OpName[];
10100
10107
 
10101
10108
  /** SHA-256 of generated/desktop-protocol.schema.json: the contract both sides of a service connection were built from. */
10102
- declare const CONTRACT_SHA256: "a2ea77f45ed3f5421e4c722442205e48fce2bbc5bccc892b54403304eca55443";
10109
+ declare const CONTRACT_SHA256: "c96c1a43bc4b34d518fa088be9300d96baab63938ce0dbfb9425cdc706097668";
10103
10110
 
10104
10111
  /**
10105
10112
  * The local tool catalog (SPEC §10): every tool a platform agent calls on a person's computer, the
package/dist/index.js CHANGED
@@ -2,7 +2,7 @@
2
2
  import { z } from "zod";
3
3
  import { UUID_SHAPE_PATTERN } from "@ai-matrx/kit/uuid";
4
4
  var PROTOCOL_MAJOR = 1;
5
- var PROTOCOL_MINOR = 41;
5
+ var PROTOCOL_MINOR = 42;
6
6
  var PROTOCOL_VERSION = `${PROTOCOL_MAJOR}.${PROTOCOL_MINOR}`;
7
7
  var ProtocolVersion = z.string().regex(/^[1-9][0-9]{0,2}\.[0-9]{1,3}$/);
8
8
  var RequestId = z.string().min(1).max(64).regex(/^[A-Za-z0-9_-]+$/);
@@ -3690,7 +3690,12 @@ var MessagesListResult = z36.strictObject({ messages: z36.array(MessagesMessage)
3690
3690
  var MessagesSendParams = z36.strictObject({
3691
3691
  /** A phone number or email the person can message. */
3692
3692
  to: z36.string().min(3).max(320),
3693
- text: z36.string().min(1).max(2e4)
3693
+ text: z36.string().min(1).max(2e4),
3694
+ /**
3695
+ * Send only over this service (Matrx Local's SendMessage `service`). Absent: iMessage first, and
3696
+ * SMS when the recipient has no iMessage (since 1.42).
3697
+ */
3698
+ service: z36.enum(["iMessage", "SMS"]).optional()
3694
3699
  });
3695
3700
  var MessagesSendResult = z36.strictObject({ sent: z36.boolean() });
3696
3701
  var ContactsSearchParams = z36.strictObject({
@@ -5152,7 +5157,8 @@ var FIELDS_SINCE = {
5152
5157
  WebBrowserFetchParams: { land: "1.40" },
5153
5158
  WebBrowserFetchResult: { source: "1.40" },
5154
5159
  SysinfoGetResult: { requirements: "1.41" },
5155
- "SysinfoGetResult.permissions[]": { detail: "1.41" }
5160
+ "SysinfoGetResult.permissions[]": { detail: "1.41" },
5161
+ MessagesSendParams: { service: "1.42" }
5156
5162
  };
5157
5163
  var NULL_SINCE = {
5158
5164
  "RelayDeviceStatusEvent.since_ms": { since: "1.1", olderPeersGet: 0 }
@@ -5314,7 +5320,7 @@ function forPeer(op, part, value, version) {
5314
5320
  var VERSIONED_RESULT_OPS = [.../* @__PURE__ */ new Set([...RESULT_PATH.keys(), ...WINDOW_RESULTS.keys(), ...NESTED_RESULTS.keys()])];
5315
5321
 
5316
5322
  // src/contract.ts
5317
- var CONTRACT_SHA256 = "a2ea77f45ed3f5421e4c722442205e48fce2bbc5bccc892b54403304eca55443";
5323
+ var CONTRACT_SHA256 = "c96c1a43bc4b34d518fa088be9300d96baab63938ce0dbfb9425cdc706097668";
5318
5324
 
5319
5325
  // src/close-policy.ts
5320
5326
  var CLOSE_RULES = {
@@ -5385,7 +5391,9 @@ var TOOL_CATALOG = [
5385
5391
  { name: "desktop_contacts", group: "personal_automation", state: "built", path: "device_op", ops: ["contacts.search", "contacts.get"], platforms: ["darwin"], summary: "Contacts: search, one card" },
5386
5392
  { name: "desktop_calendar", group: "personal_automation", state: "built", path: "device_op", ops: ["calendar.list", "calendar.create", "reminders.list", "reminders.create"], platforms: ["darwin"], summary: "Calendar and Reminders: list and add" },
5387
5393
  { name: "desktop_photos", group: "personal_automation", state: "built", path: "device_op", ops: ["photos.search", "photos.get"], platforms: ["darwin"], summary: "The Photos library: find, export an original" },
5388
- { name: "desktop_location", group: "personal_automation", state: "built", path: "device_op", ops: ["location.get"], platforms: ["darwin", "win32"], summary: "Where the computer is (the OS's location service)" },
5394
+ // Windows comes back once a Windows location fix is proven (plan attack retire-local 2026-10-12, B6):
5395
+ // until then local_mac_apps (macOS-only) is judged on macOS and nothing claims Windows.
5396
+ { name: "desktop_location", group: "personal_automation", state: "built", path: "device_op", ops: ["location.get"], platforms: ["darwin"], summary: "Where the computer is (the OS's location service)" },
5389
5397
  { name: "desktop_net", group: "personal_automation", state: "built", path: "device_op", ops: ["net.info", "net.wifi", "net.bluetooth", "net.devices", "net.mdns", "net.scan", "net.download"], platforms: ALL, summary: "Local network, Wi-Fi, Bluetooth, open ports and downloads" },
5390
5398
  { name: "desktop_schedule", group: "personal_automation", state: "built", path: "device_op", ops: ["schedule.create", "schedule.list", "schedule.cancel"], platforms: ALL, summary: "Run a tool's op on this computer on an interval; list and cancel" },
5391
5399
  // 1.38, code from anywhere: the person's Claude Code and Codex sessions on this computer. Turning