@ai-matrx/desktop-protocol 0.1.0 → 0.1.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.1.1
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/desktop-protocol/v0.1.0..npm/desktop-protocol/v0.1.1 -- apps/shared/desktop-protocol`).
+No source changes intended and no consumer action required.
+
 ## 0.1.0
 
 First release — the Matrx 2 phone slice, lane A.
@@ -14,6 +20,13 @@ First release — the Matrx 2 phone slice, lane A.
   `@ai-matrx/realtime`'s `createBackoff`.
 - `./react` — `DesktopClientProvider`, `useDesktopConnection`, `useDesktopRequest`,
   `useDesktopEvent`.
+- Relay ↔ device hop, as built by the relay (lane D): `BROADCAST_CID` (an ENVELOPE frame with
+  cid 0 from the device reaches every client), `connectionEndFrame` / `isConnectionEnd` (an
+  ENVELOPE frame with FIN and no payload: relay → device "client gone", device → relay "close this
+  client"), with zod twins `RelayHopEnvelopeHeader` and `RelayHopConnectionEnd`; the `/call` hop
+  shapes `RelayCallHello` (id `hello`) and `RelayCallEnvelope` (id `call`); close codes
+  `ABNORMAL` 1006 (how a relay deploy arrives), `DEVICE_RECONNECTED` 1012, `TRY_AGAIN_LATER` 1013,
+  and `CloseCodeValue` so Python sees the same table. Corpus cases 40–55.
 - Generated twins: `generated/desktop-protocol.schema.json` and
   `aidream/_generated/desktop_protocol.py` (Pydantic, `StrictModel` base, `OPS`/`EVENTS`,
   `validate_wire`), held identical by `pnpm generate --check`.
@@ -33,3 +46,4 @@ Defects found in the draft and fixed here (not preserved):
 ### Consumer action
 
 None — new package.
+

package/README.md

@@ -51,7 +51,9 @@ term.write("ls\n");
   those, never on messages. A dropped socket rejects unary work with `DEVICE_OFFLINE` (retryable).
 - **Terminal closes** (`4010` revoked, `4003` forbidden, `4004` not found, `4009` replaced, `4426`
   upgrade) end the client for good; everything else reconnects with the shared
-  `@ai-matrx/realtime` backoff (stability reset + jitter).
+  `@ai-matrx/realtime` backoff (stability reset + jitter) — including `1006` (a relay deploy drops
+  every socket without a close frame) and `1012` (the relay's "the device reconnected": hello and
+  reattach against the new core session).
 - Background problems (malformed messages, sequence gaps, heartbeat death, reconnect alarm) go to
   `onDiagnostic` — loud by default (`console.warn`).
 

package/dist/client.cjs

@@ -283,7 +283,15 @@ var CoreToClientMsg = import_zod3.z.discriminatedUnion("type", [ResponseMsg, Err
 var CloseCode = {
   NORMAL: 1e3,
   GOING_AWAY: 1001,
-  // relay deploy / app quit — reconnect immediately
+  // app quit; relay: the device was silent for 75 s — reconnect
+  /** Never sent by anyone: what a socket reports when it drops without a close frame. A relay
+   *  deploy (every Durable Object restarts) arrives as this — reconnect immediately. */
+  ABNORMAL: 1006,
+  /** Relay → clients: the device (re)connected, so the core session they spoke to is gone —
+   *  reconnect, hello, and reattach with since_seq. */
+  DEVICE_RECONNECTED: 1012,
+  TRY_AGAIN_LATER: 1013,
+  // relay: signing keys or the device registry unreachable — retry
   AUTH_INVALID: 4001,
   AUTH_FORBIDDEN: 4003,
   DEVICE_NOT_FOUND: 4004,
@@ -296,6 +304,7 @@ var CloseCode = {
   PROTOCOL_ERROR: 4400,
   UPGRADE_REQUIRED: 4426
 };
+var CloseCodeValue = import_zod3.z.literal([1e3, 1001, 1006, 1012, 1013, 4001, 4003, 4004, 4008, 4009, 4010, 4400, 4426]);
 
 // src/schema/frame.ts
 var import_zod4 = require("zod");
@@ -307,6 +316,22 @@ var FrameHeader = import_zod4.z.strictObject({
   sid: u32,
   seq: u32
 });
+var RelayHopEnvelopeHeader = import_zod4.z.strictObject({
+  version: import_zod4.z.literal(FRAME_VERSION),
+  flags: import_zod4.z.literal(0),
+  channel: import_zod4.z.literal(255),
+  cid: u32,
+  sid: import_zod4.z.literal(0),
+  seq: import_zod4.z.literal(0)
+});
+var RelayHopConnectionEnd = import_zod4.z.strictObject({
+  version: import_zod4.z.literal(FRAME_VERSION),
+  flags: import_zod4.z.literal(1),
+  channel: import_zod4.z.literal(255),
+  cid: import_zod4.z.int().min(1).max(4294967295),
+  sid: import_zod4.z.literal(0),
+  seq: import_zod4.z.literal(0)
+});
 var DEFAULT_WINDOW_BYTES = 262144;
 var DEFAULT_MAX_FRAME_PAYLOAD_BYTES = 65536;
 
@@ -616,6 +641,22 @@ var RelayCallResponse = import_zod9.z.discriminatedUnion("ok", [
   import_zod9.z.strictObject({ ok: import_zod9.z.literal(true), result: import_zod9.z.unknown() }),
   import_zod9.z.strictObject({ ok: import_zod9.z.literal(false), error: ProtocolErrorBody })
 ]);
+var RELAY_CALL_HELLO_ID = "hello";
+var RELAY_CALL_REQUEST_ID = "call";
+var RelayCallHello = import_zod9.z.strictObject({
+  type: import_zod9.z.literal("hello"),
+  id: import_zod9.z.literal(RELAY_CALL_HELLO_ID),
+  protocolVersion: ProtocolVersion,
+  clientType: import_zod9.z.literal("server"),
+  clientVersion: import_zod9.z.string().min(1).max(32)
+});
+var RelayCallEnvelope = import_zod9.z.strictObject({
+  id: import_zod9.z.literal(RELAY_CALL_REQUEST_ID),
+  type: import_zod9.z.literal("request"),
+  cap: import_zod9.z.string().min(1).max(32),
+  op: import_zod9.z.string().min(1).max(64),
+  params: import_zod9.z.unknown()
+});
 
 // src/schema/registry.ts
 var FS_ERR = ["NOT_FOUND", "PERMISSION_DENIED_OS", "INVALID_PARAMS", "RESOURCE_BUSY", "INTERNAL"];