diff --git a/README.md b/README.md
index b4f1f73..e6c0ba1 100644
--- a/README.md
+++ b/README.md
@@ -29,7 +29,7 @@ npm install speedybot
## SpeedyBot basics
-You can get a bot up and running fast by grabbing one of the batteries-included samples at **[https://speedybot.js.org/examples](https://speedybot.js.org/examples/)** and see how SpeedyBot has you covered for crafting bots that can do it all-- **[securely integrate w/ LLMs + content management systems](https://speedybot.js.org/examples/voiceflow/README)**, **[process file-uploads](https://speedybot.js.org/patterns.md#handle-file-uploads)**, **[segment content based on user data + behavior](https://speedybot.js.org/patterns.md#restrict-emails)**, create + manage **[SpeedyCards](https://speedybot.js.org/speedycard)**, **[ask for a user's location in a privacy-respecting way](https://speedybot.js.org/examples/location/README)** and lots more.
+You can get a bot up and running fast by grabbing one of the batteries-included samples at **[https://speedybot.js.org/examples](https://speedybot.js.org/examples/)** and see how SpeedyBot has you covered for crafting bots that can do it all-- **[securely integrate w/ LLMs + content management systems](https://speedybot.js.org/examples/voiceflow/README)**, **[process file-uploads](https://speedybot.js.org/patterns#handle-file-uploads)**, **[segment content based on user data + behavior](https://speedybot.js.org/patterns#restrict-emails)**, create + manage **[SpeedyCards](https://speedybot.js.org/speedycard)**, **[ask for a user's location in a privacy-respecting way](https://speedybot.js.org/examples/location/README)** and lots more.
## The basics
diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts
index 2a061b9..580f028 100644
--- a/docs/.vitepress/config.mts
+++ b/docs/.vitepress/config.mts
@@ -7,7 +7,7 @@ export default defineConfig({
title: "SpeedyBot",
description: "Rich conversation agents, the speedy and easy way",
themeConfig: {
- logo: "./..//sb_logo.svg",
+ logo: "./../sb_logo.svg",
footer: {
message: `MIT License ${new Date().getFullYear()}`, // this'll be statically updated everytime redeploy
},
@@ -83,14 +83,11 @@ export default defineConfig({
},
{
text: "Contributing",
- link: "https://github.com/valgaze/speedybot/blob/main/CONTRIBUTING.md",
+ link: "https://github.com/valgaze/speedybot/blob/v2/contributing.md#contributing",
},
],
},
-
- // { text: "🏡 Home", link: "/" },
],
-
sidebar: [
{
text: "🤖 Bot Utils ",
diff --git a/docs/patterns.md b/docs/patterns.md
index 4ec33c8..bb17855 100644
--- a/docs/patterns.md
+++ b/docs/patterns.md
@@ -288,7 +288,7 @@ Bot.exact("$clear", async ($) => {
return $.end;
});
-// identify words from a list
+// identify words from a list (case-insensitive)
Bot.contains(["bingo", "bongo"], async ($) => {
await $.send(
`You entered text that contained the word bingo/bongo somewhere`
@@ -330,6 +330,29 @@ Bot.addStep(async ($) => {
});
```
+## List Rooms
+
+Retrieve a full list of rooms associated with a `BOT_TOKEN` using `Bot.getAllRooms` or `Bot.getRecentRooms`
+
+This can be be a long-running operation-- `Bot.getAllRooms` captures all rooms by exhaustively checking all pages [pages](https://developer.webex.com/docs/basics#pagination)
+
+```ts
+import { SpeedyBot } from "speedybot";
+
+const Bot = new SpeedyBot();
+Bot.setToken("BOT_TOKEN");
+
+// List the last 100 recent rooms
+const recentRooms = await Bot.getRecentRooms();
+
+// List ALL rooms associated with a BOT_TOKEN
+// type: 'direct' | 'group' (default both)
+// sortBy: "id" | "lastactivity" | "created";
+const allRooms = await Bot.getAllRooms({ type: "group" });
+
+console.log(allRooms.map((room) => room.title));
+```
+
## Handle "chips"
"Chips" in SpeedyBot let users enter text by tapping buttons. Your SpeedyBot will respond as if the user typed the message dispatched in each tap of a chip. This is one of SpeedyBot's most useful but underrated features
diff --git a/docs/sb_logo.svg b/docs/public/sb_logo.svg
similarity index 86%
rename from docs/sb_logo.svg
rename to docs/public/sb_logo.svg
index 9614c59..d10aee1 100644
--- a/docs/sb_logo.svg
+++ b/docs/public/sb_logo.svg
@@ -1,53 +1,49 @@