add README.md

Author: maximerenou

README.md

@@ -0,0 +1,43 @@
+# Bing AI
+
+## Install
+
+    composer require maximerenou/bing-ai
+
+## Usage
+
+Edit and run `examples/chat.php` to test it.
+
+```php
+use MaximeRenou\BingAI\BingAI;
+use MaximeRenou\BingAI\Chat\Prompt;
+
+// $cookie - your "_U" cookie from bing.com
+$ai = new BingAI;
+$conversation = $ai->createChatConversation($cookie)
+    ->withLocation($latitude, $longitude, $radius) // Optional
+    ->withPreferences('fr-FR', 'fr-FR', 'FR'); // Optional
+
+// Example 1: sync
+// $text - Text-only version of Bing's answer
+// $messages - Message objects array
+list($text, $messages) = $conversation->ask(new Prompt("Hello World"));
+
+// Example 2: async
+// $text - Incomplete text version
+// $messages - Incomplete messages fleet
+list($final_text, $final_messages) = $conversation->ask($prompt, function ($text, $cards) {
+    echo $text;
+});
+
+```
+
+If you want to resume a previous conversation, you can retrieve its identifiers:
+```php
+// Get current identifiers
+$identifiers = $conversation->getIdentifiers();
+
+// ...
+// Resume conversation with $identifiers parameter
+$conversation = $ai->createChatConversation($cookie, $identifiers);
+```

composer.json

@@ -13,6 +13,7 @@
         }
     ],
     "require": {
-        "ratchet/pawl": "^0.4.1"
+        "ratchet/pawl": "^0.4.1",
+        "ext-curl": "*"
     }
 }

examples/chat.php

@@ -1,17 +1,18 @@
 <?php
 
+$cookie = "YOUR_COOKIE_HERE"; //@TODO change
+
 require __DIR__ . '/../vendor/autoload.php';
 
 date_default_timezone_set("Europe/Paris");
 
-$cookie = "COOKIE_HERE";
-$id = null;
-
 $ai = new \MaximeRenou\BingAI\BingAI();
 
-$conversation = $ai->createChatConversation($cookie, $id)
+$conversation = $ai->createChatConversation($cookie)
     ->withPreferences('fr-FR', 'fr-FR', 'FR');
 
+\MaximeRenou\BingAI\Tools::$debug = true;
+
 echo 'Type "q" to quit' . PHP_EOL;
 
 while (true) {
@@ -23,9 +24,9 @@
 
     echo PHP_EOL;
 
-    $message = new \MaximeRenou\BingAI\Chat\Message($text);
+    $prompt = new \MaximeRenou\BingAI\Chat\Prompt($text);
 
-    list($text, $cards) = $conversation->send($message, function ($text, $cards) {
+    list($text, $cards) = $conversation->ask($prompt, function ($text, $cards) {
         echo "- $text \r";
     });