@newbase-clawchat/openclaw-clawchat 2026.5.12-2 → 2026.5.12-21

package/src/protocol-types.typecheck.ts

@@ -0,0 +1,89 @@
+import type {
+  ConnectPayload,
+  EmptyPayload,
+  Envelope,
+  Fragment,
+  MessagePayload,
+  OfflineBatchPayload,
+  ProtocolFragment,
+  Sender,
+  StreamAddPayload,
+  StreamDonePayload,
+} from "./protocol-types.ts";
+
+type Assert<T extends true> = T;
+type IsAssignable<From, To> = [From] extends [To] ? true : false;
+type IsEqual<Actual, Expected> =
+  (<T>() => T extends Actual ? 1 : 2) extends <T>() => T extends Expected ? 1 : 2
+    ? true
+    : false;
+type Not<T extends boolean> = T extends true ? false : true;
+
+type _SenderRequiresType = Assert<
+  Not<IsAssignable<{ id: string; nick_name: string }, Sender>>
+>;
+
+type _MaterializedMessageIdMayBeOmittedOnUplink = Assert<
+  IsAssignable<
+    { message_mode: string; message: MessagePayload["message"] },
+    MessagePayload
+  >
+>;
+
+type _KnownTextFragmentRequiresText = Assert<
+  Not<IsAssignable<{ kind: "text" }, Fragment>>
+>;
+
+type _KnownMentionFragmentRequiresUserId = Assert<
+  Not<IsAssignable<{ kind: "mention" }, Fragment>>
+>;
+
+type _UnknownWireFragmentsAreRepresentable = Assert<
+  IsAssignable<{ kind: "sticker"; sticker_id: string }, ProtocolFragment>
+>;
+
+type _MaterializedMessageBodyUsesWireFragments = Assert<
+  IsEqual<MessagePayload["message"]["body"]["fragments"], Fragment[]>
+>;
+
+type _MaterializedMessageRejectsMalformedKnownFragments = Assert<
+  Not<
+    IsAssignable<
+      {
+        message_mode: string;
+        message: {
+          body: { fragments: [{ kind: "text" }] };
+          context: MessagePayload["message"]["context"];
+        };
+      },
+      MessagePayload
+    >
+  >
+>;
+
+type _StreamCompletionUsesWireFragments = Assert<
+  IsEqual<StreamDonePayload["fragments"], Fragment[]>
+>;
+
+type _StreamCompletionPayloadIsFlat = Assert<
+  Not<"message" extends keyof StreamDonePayload ? true : false>
+>;
+
+type _ConnectPayloadAllowsCanonicalMinimum = Assert<
+  IsAssignable<{ token: string; nonce: string }, ConnectPayload>
+>;
+
+type _StreamAddPayloadAllowsCanonicalMinimum = Assert<
+  IsAssignable<
+    { message_id: string; sequence: number; fragments: Fragment[] },
+    StreamAddPayload
+  >
+>;
+
+type _OfflineBatchPayloadCarriesEnvelopes = Assert<
+  IsAssignable<{ batch_id: number; items: Envelope[]; remaining: number }, OfflineBatchPayload>
+>;
+
+type _ControlPayloadsAreEmptyObjects = Assert<
+  IsAssignable<Record<string, never>, EmptyPayload>
+>;

package/src/protocol.ts

@@ -1,8 +1,8 @@
 /**
  * Local narrow guards for inbound protocol envelopes.
  *
- * The SDK's `message` event hands us `Envelope<unknown>`. Before casting the
- * payload to `DownlinkMessageSendPayload` we run these cheap structural checks
+ * Raw client events hand us `Envelope<unknown>`. Before casting the
+ * payload to `MessagePayload` we run these cheap structural checks
  * so runtime errors surface as skipped messages, not crashes.
  */