More Walkthrough sections

Author: rojvv

src/chat-actions.md

@@ -0,0 +1,45 @@
+---
+title: Chat Actions
+parent: /#walkthrough
+walkthrough:
+  track: main
+  order: 17
+---
+
+Clients can show actions such as typing or uploading while preparing a response.
+
+## Showing an Action
+
+Use {{ "sendChatAction" |> m }} before starting the work.
+
+```ts
+client.command("status", async (ctx) => {
+  await ctx.sendChatAction({ type: "typing" });
+
+  const status = await getStatus();
+  await ctx.reply(status);
+});
+```
+
+Chat actions remain visible for a short time. Send the action again if the work takes longer.
+
+## Reporting Upload Progress
+
+Upload actions can include a progress percentage.
+
+```ts
+await client.sendChatAction(chatId, {
+  type: "uploadingDocument",
+  progress: 50,
+});
+```
+
+See {{ "ChatActionType" |> t }} for all available actions.
+
+## Cancelling an Action
+
+Send the `cancel` action when no response will follow.
+
+```ts
+await client.sendChatAction(chatId, { type: "cancel" });
+```

src/streaming-responses.md

@@ -0,0 +1,52 @@
+---
+title: Streaming Responses
+parent: /#walkthrough
+walkthrough:
+  track: bot
+  order: 5
+---
+
+Bots can stream text while generating a response.
+
+## Streaming a Draft
+
+Call {{ "sendMessageDraft" |> m }} repeatedly with the same draft ID. Each call should contain the complete text generated so far.
+
+```ts
+client.command("answer", async (ctx) => {
+  const draftId = ctx.msg.id;
+  let response = "";
+
+  for await (const chunk of generateAnswer()) {
+    response += chunk;
+    await ctx.replyDraft(draftId, response);
+  }
+
+  await ctx.reply(response);
+});
+```
+
+Send the completed response normally after the draft finishes.
+
+## Streaming a Rich Text Draft
+
+Use {{ "sendRichTextDraft" |> m }} to stream an {{ "InputRichText" |> t }}. Reuse the same draft ID and finish with a regular rich text message.
+
+```ts
+const draftId = ctx.msg.id;
+
+await ctx.replyRichTextDraft(draftId, {
+  type: "markdown",
+  markdown: "# Answer\n\nGenerating…",
+});
+
+await ctx.replyRichTextDraft(draftId, {
+  type: "markdown",
+  markdown: "# Answer\n\nThe answer is **42**.",
+});
+
+await ctx.replyRichText({
+  type: "markdown",
+  markdown: "# Answer\n\nThe answer is **42**.",
+});
+```