docs: update spectrum-ts documentation for v1.12.0 (#47)

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Author: photon-action-bot[bot]

docs-src/spectrum-ts/content.mdx.vel

@@ -1,14 +1,14 @@
 ---
 title: "Content"
-description: "Build text, attachments, voice, contacts, polls, rich links, groups, replies, edits, typing indicators, and platform-specific content for outgoing messages"
+description: "Build text, attachments, voice, contacts, polls, rich links, groups, replies, edits, typing indicators, rename, avatar, and platform-specific content for outgoing messages"
 ---
 
 import { TypeTooltip } from "/snippets/type-tooltip.mdx";
 
 {% set ci = symbol("ts:spectrum-ts#ContentInput") %}
 {% set cb = symbol("ts:spectrum-ts#ContentBuilder") %}
 
-Spectrum exposes a family of content builders — `text`, `attachment`, `voice`, `contact`, `richlink`, `poll`, `group`, `custom`, `reaction`, `reply`, `edit`, and `typing` — plus a string shortcut that's equivalent to `text()`. Any API that takes a <TypeTooltip name="ContentInput" type={`{{ ci.signature }}`} /> accepts a plain string or a <TypeTooltip name="ContentBuilder" type={`{{ cb.signature }}`} />.
+Spectrum exposes a family of content builders — `text`, `attachment`, `voice`, `contact`, `richlink`, `poll`, `group`, `custom`, `reaction`, `reply`, `edit`, `typing`, `rename`, and `avatar` — plus a string shortcut that's equivalent to `text()`. Any API that takes a <TypeTooltip name="ContentInput" type={`{{ ci.signature }}`} /> accepts a plain string or a <TypeTooltip name="ContentBuilder" type={`{{ cb.signature }}`} />.
 
 ## Text
 
@@ -212,7 +212,7 @@ import { reply, text } from "spectrum-ts";
 await space.send(reply(text("Got it"), message));
 ```
 
-`reply()` cannot wrap `reply`, `edit`, `reaction`, `group`, or `typing` content.
+`reply()` cannot wrap `reply`, `edit`, `reaction`, `group`, `typing`, `rename`, or `avatar` content.
 
 ## Edits
 
@@ -225,7 +225,7 @@ const sent = await space.send("Draft");
 await space.send(edit(text("Final version"), sent));
 ```
 
-`edit()` cannot wrap `edit`, `reply`, `reaction`, `group`, or `typing` content.
+`edit()` cannot wrap `edit`, `reply`, `reaction`, `group`, `typing`, `rename`, or `avatar` content.
 
 ## Typing indicators
 
@@ -240,6 +240,41 @@ await space.send(typing("stop"));  // stop typing
 
 `space.startTyping()`, `space.stopTyping()`, and `space.responding(fn)` are sugar over `space.send(typing(...))`. Platforms without a typing-indicator API silently no-op.
 
+## Rename
+
+Rename the current chat. Fire-and-forget — `space.send(rename(...))` resolves to `undefined`.
+
+```ts
+import { rename } from "spectrum-ts";
+
+await space.send(rename("New Chat Name"));
+```
+
+`space.rename(displayName)` is sugar for `space.send(rename(displayName))`. The builder throws at construction time if `displayName` is empty. Per-platform constraints (e.g. iMessage requires remote mode and a group chat) surface as `UnsupportedError` from the provider's send action.
+
+## Avatar
+
+Set or clear the chat avatar (group icon). Fire-and-forget — `space.send(avatar(...))` resolves to `undefined`.
+
+```ts
+import { avatar } from "spectrum-ts";
+
+// Set from a file path — MIME type inferred from the extension
+await space.send(avatar("./icon.png"));
+
+// Set from a buffer — mimeType is required
+await space.send(avatar(buffer, { mimeType: "image/jpeg" }));
+
+// Clear the current avatar
+await space.send(avatar("clear"));
+```
+
+`space.avatar(...)` is sugar for `space.send(avatar(...))`. Per-platform constraints (e.g. iMessage requires remote mode and a group chat) surface as `UnsupportedError` from the provider's send action.
+
+<Note>
+  The string `"clear"` is a reserved sentinel. If you have a file literally named `clear` with no extension, pass `"./clear"` or load it as a `Buffer`.
+</Note>
+
 ## Composing multiple items
 
 All send methods take a variadic list. Items are sent sequentially as separate messages:

docs-src/spectrum-ts/introduction.mdx.vel

@@ -79,7 +79,7 @@ Every provider feeds the same message stream. Your agent can send, react, reply,
 
 iMessage is where Spectrum is most mature.
 
-Spectrum gives you production iMessage infrastructure with the richest iMessage feature set we offer today. You get managed iMessage lines, so your agent can run on any server and connect to iMessage through Spectrum. The managed iMessage provider supports local development, DMs and groups, typing indicators, reactions, threaded replies, group creation, message effects, chat backgrounds, per-line routing, dedicated line auto-scale, and automatic token renewal.
+Spectrum gives you production iMessage infrastructure with the richest iMessage feature set we offer today. You get managed iMessage lines, so your agent can run on any server and connect to iMessage through Spectrum. The managed iMessage provider supports local development, DMs and groups, typing indicators, reactions, threaded replies, group creation, message effects, chat backgrounds, chat renaming, group avatars, per-line routing, dedicated line auto-scale, and automatic token renewal.
 
 That matters because iMessage is not a generic SMS fallback. Users expect native behavior, reliable delivery, and conversations that feel like they belong on Apple devices.
 

docs-src/spectrum-ts/providers/imessage.mdx.vel

@@ -37,7 +37,7 @@ The iMessage provider supports three connection modes — local, cloud, and dedi
     ```
 
     <Note>
-      Local mode only supports sending text and attachments. Reactions, typing indicators, threaded replies, group creation, and chat backgrounds are not available.
+      Local mode only supports sending text and attachments. Reactions, typing indicators, threaded replies, group creation, chat backgrounds, chat renaming, and group avatars are not available.
     </Note>
   </Tab>
   <Tab title="Dedicated">
@@ -170,6 +170,41 @@ The wrapped content can be a string or any `attachment(...)`. Effects only apply
   </Accordion>
 </AccordionGroup>
 
+## Chat renaming
+
+Rename a group chat using `space.rename()` or the canonical `rename()` content builder:
+
+```ts
+import { rename } from "spectrum-ts";
+
+// Sugar
+await space.rename("Book Club");
+
+// Canonical
+await space.send(rename("Book Club"));
+```
+
+Renaming requires cloud or dedicated mode and only works on group chats. In local mode or on a DM, `rename()` throws an `UnsupportedError`.
+
+## Group avatars
+
+Set or clear the group chat icon using `space.avatar()` or the canonical `avatar()` content builder:
+
+```ts
+import { avatar } from "spectrum-ts";
+
+// Sugar — set from a file path
+await space.avatar("./icon.png");
+
+// Sugar — clear the current avatar
+await space.avatar("clear");
+
+// Canonical
+await space.send(avatar("./icon.png"));
+```
+
+Group avatars require cloud or dedicated mode and only work on group chats. In local mode or on a DM, `avatar()` throws an `UnsupportedError`.
+
 ## Chat backgrounds
 
 Set or clear the chat background image. Import `background` from the iMessage provider and use the sugar method on a narrowed space:

docs-src/spectrum-ts/reactions-and-replies.mdx.vel

@@ -73,7 +73,7 @@ Both forms are equivalent — `message.reply(content)` wraps each content item i
 
 On platforms with thread support (iMessage, WhatsApp Business), this sends a threaded reply. On platforms without, the call resolves as a no-op — **the reply is not downgraded to a regular send**. If you need guaranteed delivery, use `space.send(...)` instead.
 
-`reply()` cannot wrap `reply`, `edit`, `reaction`, `group`, or `typing` content — the builder throws at construction time.
+`reply()` cannot wrap `reply`, `edit`, `reaction`, `group`, `typing`, `rename`, or `avatar` content — the builder throws at construction time.
 
 ## Editing messages
 
@@ -96,7 +96,7 @@ On platforms with thread support (iMessage, WhatsApp Business), this sends a thr
 
 `edit()` takes new content and the outbound message to rewrite. Edits are fire-and-forget — `space.send(edit(...))` resolves to `undefined`.
 
-`edit()` cannot wrap `edit`, `reply`, `reaction`, `group`, or `typing` content.
+`edit()` cannot wrap `edit`, `reply`, `reaction`, `group`, `typing`, `rename`, or `avatar` content.
 
 ## When to use what
 

docs-src/spectrum-ts/spaces-and-users.mdx.vel

@@ -20,6 +20,8 @@ Every <TypeTooltip name="Space" type={`{{ space.signature }}`} /> exposes the sa
 | `startTyping()` | Show a typing indicator. No-op if the platform doesn't support it. |
 | `stopTyping()` | Hide the typing indicator. |
 | `responding(fn)` | Start a typing indicator, run `fn`, and stop the indicator when it completes — even if `fn` throws. |
+| `rename(displayName)` | Rename the chat. Sugar for `send(rename(displayName))`. |
+| `avatar(input, options?)` | Set or clear the chat avatar. Sugar for `send(avatar(input, options?))`. |
 
 ```ts
 for await (const [space, message] of app.messages) {