feat: summarize conversation

Author: maximerenou

README.md

@@ -6,7 +6,7 @@
 [![PHP version](https://img.shields.io/packagist/dependency-v/maximerenou/hugging-chat/php)](https://packagist.org/packages/maximerenou/hugging-chat)
 [![cURL extension required](https://img.shields.io/packagist/dependency-v/maximerenou/hugging-chat/ext-curl)](https://packagist.org/packages/maximerenou/hugging-chat)
 
-This is an unofficial Composer package for using **HuggingChat** (OpenAssistant's LLaMA model).
+This is an unofficial PHP client for **HuggingChat** (OpenAssistant's LLaMA model).
 
 ## Installation
 
@@ -63,6 +63,20 @@ $conversation = $ai->resumeChatConversation($identifiers);
 
 </details> 
 
+<details>
+  <summary>Generate a conversation's summary</summary>
+
+Useful to give a title to a conversation.
+
+```php
+// Question asked: "Who's Einstein?"
+// ...
+$summary = $conversation->getSummary();
+// Result: Famous genius mathematician.
+```
+
+</details> 
+
 <details>
   <summary>Handle HuggingChat errors</summary>
 

src/Conversation.php

@@ -136,7 +136,7 @@ public function ask(Prompt $message, $callback = null)
         return $this->current_text;
     }
 
-    public function handlePacket($raw)
+    protected function handlePacket($raw)
     {
         $data = json_decode($raw, true);
 
@@ -165,4 +165,23 @@ public function handlePacket($raw)
             'final' => $data['token']['special']
         ];
     }
+
+    public function getSummary()
+    {
+        $headers = [
+            'method: POST',
+            'accept: application/json',
+            "referer: https://huggingface.co/chat",
+            'content-type: application/json',
+            "cookie: hf-chat={$this->cookie}"
+        ];
+
+        $data = Tools::request("https://huggingface.co/chat/conversation/{$this->id}/summarize", $headers, '', false);
+        $data = json_decode($data, true);
+
+        if (! is_array($data) || empty($data['title']))
+            throw new \Exception("Failed to get conversation's summary");
+
+        return trim($data['title'], '"');
+    }
 }