@spectrum-ts/core 8.2.2 → 9.1.0

package/dist/{attachment-DqrtDRaN.d.ts → attachment-B4H1Q8xO.d.ts}

@@ -99,6 +99,12 @@ declare const buildPhotoAction: (input: PhotoInput, options: {
  * universal sugar that delegates here. Per-platform constraints (e.g.
  * group-only, remote-only) surface as `UnsupportedError` from the provider's
  * `send` action so the canonical and sugar forms share one error path.
+ *
+ * Bidirectional: providers also surface platform icon changes as inbound
+ * `Message`s carrying this content — `action.kind === "set"` arrives with
+ * the fetched icon behind `read()`, `"clear"` mirrors icon removal.
+ * `message.sender` is the user who changed it (may be `undefined` when the
+ * platform recorded no actor).
  */
 declare const avatarSchema: z.ZodObject<{
   type: z.ZodLiteral<"avatar">;
@@ -112,6 +118,15 @@ declare const avatarSchema: z.ZodObject<{
 }, z.core.$strip>;
 type Avatar = z.infer<typeof avatarSchema>;
 type AvatarInput = PhotoInput;
+/**
+ * The current chat avatar as returned by `space.getAvatar()`: raw image bytes
+ * plus MIME type. `data` is a Buffer so the value round-trips into the
+ * setter — `space.avatar(res.data, { mimeType: res.mimeType })`.
+ */
+interface AvatarData {
+  data: Buffer;
+  mimeType: string;
+}
 /**
  * Build an `Avatar` content value.
  *
@@ -304,9 +319,75 @@ declare const asReaction: (input: {
  */
 declare function reaction(emoji: string, target: Message | undefined): ReactionBuilder;
 //#endregion
+//#region src/content/membership.d.ts
+/**
+ * Group-membership management content. Universal content — providers
+ * dispatch by `content.type` in their `send` action and decide their own
+ * support story (e.g. iMessage only supports it for remote group chats;
+ * on a DM it surfaces an `UnsupportedError` telling the caller to create
+ * a group via `space.create` instead).
+ *
+ * `space.send(addMember(users))` is the canonical form; `space.add(...)`,
+ * `space.remove(...)`, and `space.leave()` are universal sugar that
+ * delegate here. All three are fire-and-forget — no `Message` is produced.
+ *
+ * Bidirectional: providers also surface platform membership events as
+ * inbound `Message`s carrying this content. `message.sender` is the acting
+ * user — who added/removed the members — and may be `undefined` when the
+ * platform recorded no actor. For `leaveSpace` the sender is the leaver
+ * (the content carries no `members`). The agent's own actions are
+ * suppressed: `space.add(...)` does not echo back as an inbound event.
+ *
+ * Members are id strings (or `User`s, normalized to their `id`) in the same
+ * platform handle format `space.create` accepts. No async resolution happens
+ * in the builder — ids reach the provider verbatim.
+ */
+declare const addMemberSchema: z.ZodObject<{
+  type: z.ZodLiteral<"addMember">;
+  members: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+type AddMember = z.infer<typeof addMemberSchema>;
+declare const removeMemberSchema: z.ZodObject<{
+  type: z.ZodLiteral<"removeMember">;
+  members: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+type RemoveMember = z.infer<typeof removeMemberSchema>;
+declare const leaveSpaceSchema: z.ZodObject<{
+  type: z.ZodLiteral<"leaveSpace">;
+}, z.core.$strip>;
+type LeaveSpace = z.infer<typeof leaveSpaceSchema>;
+/** Accepted member input: a `User`, a raw id string, or an array of either. */
+type MemberInput = User | string | (User | string)[];
+/**
+ * Build an `AddMember` content value inviting `users` into the current
+ * group chat. Accepts a single `User` or id string, or an array of either
+ * — batches land in one provider call.
+ */
+declare function addMember(users: MemberInput): ContentBuilder;
+/**
+ * Build a `RemoveMember` content value removing `users` from the current
+ * group chat. Accepts the same input shapes as `addMember`.
+ */
+declare function removeMember(users: MemberInput): ContentBuilder;
+/**
+ * Build a `LeaveSpace` content value making the agent's own account leave
+ * the current group chat.
+ */
+declare function leaveSpace(): ContentBuilder;
+//#endregion
 //#region src/types/space.d.ts
 interface Space<_Def = unknown> {
   readonly __platform: string;
+  /**
+   * Add members to the current chat. Sugar for `send(addMember(users))`.
+   * Accepts a single `User` or id string, or an array of either — batches
+   * land in one provider call. Fire-and-forget.
+   *
+   * Universal API; per-platform constraints (e.g. iMessage: remote + group
+   * only — a DM cannot be converted, create a group via `space.create`)
+   * surface as `UnsupportedError` from the provider's send action.
+   */
+  add(users: MemberInput): Promise<void>;
   /**
    * Set or clear the current chat's avatar (group icon). Sugar for
    * `send(avatar(input, options?))`.
@@ -335,6 +416,40 @@ interface Space<_Def = unknown> {
    * `send` results chain without narrowing; an undefined target throws.
    */
   edit(message: Message | undefined, newContent: ContentInput): Promise<void>;
+  /**
+   * Download the current chat avatar (group icon). Resolves `undefined` when
+   * the chat has none. The result round-trips into the setter:
+   * `space.avatar(res.data, { mimeType: res.mimeType })`.
+   *
+   * Universal API; per-platform constraints (e.g. iMessage: remote + group
+   * only — a DM throws) surface as `UnsupportedError`, as do platforms with
+   * no implementation.
+   */
+  getAvatar(): Promise<AvatarData | undefined>;
+  /**
+   * Read the current chat's display name (group/chat title). Resolves
+   * `undefined` when the chat has none — an unnamed group, or a 1:1 chat on a
+   * platform that stores no title for DMs. Round-trips into `space.rename()`.
+   *
+   * Universal API; unlike `rename` the read is not group-only. Per-platform
+   * constraints (e.g. iMessage: remote only) surface as `UnsupportedError`, as
+   * do platforms with no implementation.
+   */
+  getDisplayName(): Promise<string | undefined>;
+  /**
+   * List the chat's current participants, excluding the agent's own account
+   * where the platform can identify it. Each entry is a `User` tagged with
+   * `__platform`; `id` is the user's canonical platform handle (the same
+   * format `space.create` accepts), so results feed straight back into
+   * `add()` / `remove()` / `space.create()`. Platform extras (e.g.
+   * iMessage's `address`/`country`/`service`) ride along untyped — use the
+   * platform instance's `getMembers(space)` for typed extras.
+   *
+   * Universal API; per-platform constraints (e.g. iMessage: remote + group
+   * only — a DM throws) surface as `UnsupportedError`, as do platforms with
+   * no implementation.
+   */
+  getMembers(): Promise<User[]>;
   /**
    * Look up a message in this space by its id. Returns `undefined` if the
    * platform has no way to resolve the id (e.g. cache miss with no by-id
@@ -343,6 +458,14 @@ interface Space<_Def = unknown> {
    */
   getMessage(id: string): Promise<Message | undefined>;
   readonly id: string;
+  /**
+   * Leave the current chat with the agent's own account. Sugar for
+   * `send(leaveSpace())`. Fire-and-forget.
+   *
+   * Universal API; per-platform constraints (e.g. iMessage: remote + group
+   * only) surface as `UnsupportedError` from the provider's send action.
+   */
+  leave(): Promise<void>;
   /**
    * Mark the conversation as read up to `message`, surfacing a read receipt
    * to the sender where the platform supports one. Sugar for
@@ -356,6 +479,15 @@ interface Space<_Def = unknown> {
    * everywhere — same contract as `startTyping()`.
    */
   read(message: Message): Promise<void>;
+  /**
+   * Remove members from the current chat. Sugar for
+   * `send(removeMember(users))`. Accepts the same input shapes as `add`.
+   * Fire-and-forget.
+   *
+   * Universal API; per-platform constraints (e.g. iMessage: remote + group
+   * only) surface as `UnsupportedError` from the provider's send action.
+   */
+  remove(users: MemberInput): Promise<void>;
   /**
    * Rename the current chat. Sugar for `send(rename(displayName))`.
    *
@@ -442,14 +574,12 @@ interface Message<TPlatform extends string = string, TSender extends User = User
  * (no new message id is produced; the existing message mutates in place).
  *
  * Edit cannot wrap `edit`, `reply`, `reaction`, `group`, `typing`, `rename`,
- * `avatar`, `unsend`, or `read` content.
+ * `avatar`, `addMember`, `removeMember`, `leaveSpace`, `unsend`, or `read`
+ * content.
  */
 declare const editSchema: z.ZodObject<{
   type: z.ZodLiteral<"edit">;
   content: z.ZodCustom<{
-    type: "custom";
-    raw: unknown;
-  } | {
     type: "attachment";
     id: string;
     name: string;
@@ -458,25 +588,11 @@ declare const editSchema: z.ZodObject<{
     stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
     size?: number | undefined;
   } | {
-    type: "poll";
-    title: string;
-    options: {
-      title: string;
-    }[];
+    type: "text";
+    text: string;
   } | {
-    type: "poll_option";
-    option: {
-      title: string;
-    };
-    poll: {
-      type: "poll";
-      title: string;
-      options: {
-        title: string;
-      }[];
-    };
-    selected: boolean;
-    title: string;
+    type: "markdown";
+    markdown: string;
   } | {
     type: "contact";
     user?: {
@@ -521,18 +637,38 @@ declare const editSchema: z.ZodObject<{
     } | undefined;
     raw?: unknown;
   } | {
-    type: "text";
-    text: string;
+    type: "custom";
+    raw: unknown;
   } | {
-    type: "markdown";
-    markdown: string;
+    type: "poll";
+    title: string;
+    options: {
+      title: string;
+    }[];
   } | {
-    type: "group";
-    items: Message<string, User, Space<unknown>>[];
+    type: "poll_option";
+    option: {
+      title: string;
+    };
+    poll: {
+      type: "poll";
+      title: string;
+      options: {
+        title: string;
+      }[];
+    };
+    selected: boolean;
+    title: string;
   } | {
     type: "reaction";
     emoji: string;
     target: Message<string, User, Space<unknown>>;
+  } | {
+    type: "group";
+    items: Message<string, User, Space<unknown>>[];
+  } | {
+    type: "richlink";
+    url: string;
   } | {
     type: "streamText";
     stream: () => AsyncIterable<string>;
@@ -545,9 +681,6 @@ declare const editSchema: z.ZodObject<{
     name?: string | undefined;
     duration?: number | undefined;
     size?: number | undefined;
-  } | {
-    type: "richlink";
-    url: string;
   } | {
     type: "app";
     url: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodURL>>;
@@ -594,10 +727,15 @@ declare const editSchema: z.ZodObject<{
     } | {
       kind: "clear";
     };
-  }, {
-    type: "custom";
-    raw: unknown;
   } | {
+    type: "addMember";
+    members: string[];
+  } | {
+    type: "removeMember";
+    members: string[];
+  } | {
+    type: "leaveSpace";
+  }, {
     type: "attachment";
     id: string;
     name: string;
@@ -606,25 +744,11 @@ declare const editSchema: z.ZodObject<{
     stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
     size?: number | undefined;
   } | {
-    type: "poll";
-    title: string;
-    options: {
-      title: string;
-    }[];
+    type: "text";
+    text: string;
   } | {
-    type: "poll_option";
-    option: {
-      title: string;
-    };
-    poll: {
-      type: "poll";
-      title: string;
-      options: {
-        title: string;
-      }[];
-    };
-    selected: boolean;
-    title: string;
+    type: "markdown";
+    markdown: string;
   } | {
     type: "contact";
     user?: {
@@ -669,18 +793,38 @@ declare const editSchema: z.ZodObject<{
     } | undefined;
     raw?: unknown;
   } | {
-    type: "text";
-    text: string;
+    type: "custom";
+    raw: unknown;
   } | {
-    type: "markdown";
-    markdown: string;
+    type: "poll";
+    title: string;
+    options: {
+      title: string;
+    }[];
   } | {
-    type: "group";
-    items: Message<string, User, Space<unknown>>[];
+    type: "poll_option";
+    option: {
+      title: string;
+    };
+    poll: {
+      type: "poll";
+      title: string;
+      options: {
+        title: string;
+      }[];
+    };
+    selected: boolean;
+    title: string;
   } | {
     type: "reaction";
     emoji: string;
     target: Message<string, User, Space<unknown>>;
+  } | {
+    type: "group";
+    items: Message<string, User, Space<unknown>>[];
+  } | {
+    type: "richlink";
+    url: string;
   } | {
     type: "streamText";
     stream: () => AsyncIterable<string>;
@@ -693,9 +837,6 @@ declare const editSchema: z.ZodObject<{
     name?: string | undefined;
     duration?: number | undefined;
     size?: number | undefined;
-  } | {
-    type: "richlink";
-    url: string;
   } | {
     type: "app";
     url: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodURL>>;
@@ -742,6 +883,14 @@ declare const editSchema: z.ZodObject<{
     } | {
       kind: "clear";
     };
+  } | {
+    type: "addMember";
+    members: string[];
+  } | {
+    type: "removeMember";
+    members: string[];
+  } | {
+    type: "leaveSpace";
   }>;
   target: z.ZodCustom<Message<string, User, Space<unknown>>, Message<string, User, Space<unknown>>>;
 }, z.core.$strip>;
@@ -942,6 +1091,10 @@ declare function read(target: Message): ContentBuilder;
  * `space.send(rename("New Name"))` is the canonical form; `space.rename(...)`
  * is universal sugar that delegates here.
  *
+ * Bidirectional: providers also surface platform rename events as inbound
+ * `Message`s carrying this content; `message.sender` is the user who renamed
+ * the chat (may be `undefined` when the platform recorded no actor).
+ *
  * Throws at build time if `displayName` is empty. Per-platform constraints
  * (e.g. group-only, remote-only) surface as `UnsupportedError` from the
  * provider's `send` action so the canonical and sugar forms share one
@@ -963,14 +1116,12 @@ declare function rename(displayName: string): ContentBuilder;
  * `reply` like any other content type and route to a threaded send.
  *
  * Reply cannot wrap `reply`, `edit`, `reaction`, `group`, `typing`,
- * `rename`, `avatar`, `unsend`, or `read` content.
+ * `rename`, `avatar`, `addMember`, `removeMember`, `leaveSpace`, `unsend`,
+ * or `read` content.
  */
 declare const replySchema: z.ZodObject<{
   type: z.ZodLiteral<"reply">;
   content: z.ZodCustom<{
-    type: "custom";
-    raw: unknown;
-  } | {
     type: "attachment";
     id: string;
     name: string;
@@ -979,25 +1130,11 @@ declare const replySchema: z.ZodObject<{
     stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
     size?: number | undefined;
   } | {
-    type: "poll";
-    title: string;
-    options: {
-      title: string;
-    }[];
+    type: "text";
+    text: string;
   } | {
-    type: "poll_option";
-    option: {
-      title: string;
-    };
-    poll: {
-      type: "poll";
-      title: string;
-      options: {
-        title: string;
-      }[];
-    };
-    selected: boolean;
-    title: string;
+    type: "markdown";
+    markdown: string;
   } | {
     type: "contact";
     user?: {
@@ -1042,18 +1179,38 @@ declare const replySchema: z.ZodObject<{
     } | undefined;
     raw?: unknown;
   } | {
-    type: "text";
-    text: string;
+    type: "custom";
+    raw: unknown;
   } | {
-    type: "markdown";
-    markdown: string;
+    type: "poll";
+    title: string;
+    options: {
+      title: string;
+    }[];
   } | {
-    type: "group";
-    items: Message<string, User, Space<unknown>>[];
+    type: "poll_option";
+    option: {
+      title: string;
+    };
+    poll: {
+      type: "poll";
+      title: string;
+      options: {
+        title: string;
+      }[];
+    };
+    selected: boolean;
+    title: string;
   } | {
     type: "reaction";
     emoji: string;
     target: Message<string, User, Space<unknown>>;
+  } | {
+    type: "group";
+    items: Message<string, User, Space<unknown>>[];
+  } | {
+    type: "richlink";
+    url: string;
   } | {
     type: "streamText";
     stream: () => AsyncIterable<string>;
@@ -1066,9 +1223,6 @@ declare const replySchema: z.ZodObject<{
     name?: string | undefined;
     duration?: number | undefined;
     size?: number | undefined;
-  } | {
-    type: "richlink";
-    url: string;
   } | {
     type: "app";
     url: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodURL>>;
@@ -1115,10 +1269,15 @@ declare const replySchema: z.ZodObject<{
     } | {
       kind: "clear";
     };
-  }, {
-    type: "custom";
-    raw: unknown;
   } | {
+    type: "addMember";
+    members: string[];
+  } | {
+    type: "removeMember";
+    members: string[];
+  } | {
+    type: "leaveSpace";
+  }, {
     type: "attachment";
     id: string;
     name: string;
@@ -1127,25 +1286,11 @@ declare const replySchema: z.ZodObject<{
     stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
     size?: number | undefined;
   } | {
-    type: "poll";
-    title: string;
-    options: {
-      title: string;
-    }[];
+    type: "text";
+    text: string;
   } | {
-    type: "poll_option";
-    option: {
-      title: string;
-    };
-    poll: {
-      type: "poll";
-      title: string;
-      options: {
-        title: string;
-      }[];
-    };
-    selected: boolean;
-    title: string;
+    type: "markdown";
+    markdown: string;
   } | {
     type: "contact";
     user?: {
@@ -1190,18 +1335,38 @@ declare const replySchema: z.ZodObject<{
     } | undefined;
     raw?: unknown;
   } | {
-    type: "text";
-    text: string;
+    type: "custom";
+    raw: unknown;
   } | {
-    type: "markdown";
-    markdown: string;
+    type: "poll";
+    title: string;
+    options: {
+      title: string;
+    }[];
   } | {
-    type: "group";
-    items: Message<string, User, Space<unknown>>[];
+    type: "poll_option";
+    option: {
+      title: string;
+    };
+    poll: {
+      type: "poll";
+      title: string;
+      options: {
+        title: string;
+      }[];
+    };
+    selected: boolean;
+    title: string;
   } | {
     type: "reaction";
     emoji: string;
     target: Message<string, User, Space<unknown>>;
+  } | {
+    type: "group";
+    items: Message<string, User, Space<unknown>>[];
+  } | {
+    type: "richlink";
+    url: string;
   } | {
     type: "streamText";
     stream: () => AsyncIterable<string>;
@@ -1214,9 +1379,6 @@ declare const replySchema: z.ZodObject<{
     name?: string | undefined;
     duration?: number | undefined;
     size?: number | undefined;
-  } | {
-    type: "richlink";
-    url: string;
   } | {
     type: "app";
     url: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodURL>>;
@@ -1263,6 +1425,14 @@ declare const replySchema: z.ZodObject<{
     } | {
       kind: "clear";
     };
+  } | {
+    type: "addMember";
+    members: string[];
+  } | {
+    type: "removeMember";
+    members: string[];
+  } | {
+    type: "leaveSpace";
   }>;
   target: z.ZodCustom<Message<string, User, Space<unknown>>, Message<string, User, Space<unknown>>>;
 }, z.core.$strip>;
@@ -5991,7 +6161,8 @@ declare function broadcast<T>(source: ManagedStream<T>): Broadcaster<T>;
  * side effect.
  *
  * Names that collide with reserved `Space` keys (`send`, `edit`, `unsend`,
- * `getMessage`, `startTyping`, `stopTyping`, `responding`, `id`,
+ * `read`, `getMessage`, `getMembers`, `getAvatar`, `rename`, `avatar`, `add`,
+ * `remove`, `leave`, `startTyping`, `stopTyping`, `responding`, `id`,
  * `__platform`) are skipped at runtime with a warning and excluded at the
  * type level via `Exclude<…, keyof Space>`.
  */
@@ -6022,11 +6193,12 @@ type MessageActionFn = (message: Message, ...args: never[]) => Promise<void>;
  *
  * Two tiers live in the same `actions?` slot:
  *
- * - **Platform-wise actions** — fixed framework-known names (currently just
- *   `getMessage`) whose signatures are defined by `PlatformWiseActions`. They
- *   power universal sugar (`space.getMessage(id)`) AND surface on the
- *   platform instance. If a provider omits one, the framework wires a
- *   default that throws `UnsupportedError`.
+ * - **Platform-wise actions** — fixed framework-known names (`getMessage`,
+ *   `getMembers`, `getAvatar`) whose signatures are defined by
+ *   `PlatformWiseActions`. They power universal sugar
+ *   (`space.getMessage(id)`, `space.getMembers()`, `space.getAvatar()`) AND
+ *   surface on the platform instance. If a provider omits one, the framework
+ *   wires a default that throws `UnsupportedError`.
  * - **Platform-specific actions** — free-form keys each platform declares
  *   for its own ergonomics (e.g. iMessage's `getAttachment`). Surface on
  *   the platform instance only.
@@ -6044,13 +6216,40 @@ type InstanceActionFn = (ctx: any, ...args: any[]) => Promise<unknown>;
  * by declaring the key inside their `actions` slot, and platforms that omit
  * the key get a default that throws `UnsupportedError`.
  *
- * Add a new platform-wise capability by extending this record (and the
- * runtime list in `define.ts`); the corresponding instance method will be
- * surfaced on every `PlatformInstance` automatically.
+ * Add a new platform-wise capability by extending this record along with:
+ * `PlatformWiseInstanceMethods` (the public instance signature), the runtime
+ * list `PLATFORM_WISE_ACTION_KEYS` in `build.ts`, and — when the capability
+ * surfaces as universal `Space` sugar — the `Space` interface plus a
+ * `buildSpace` impl and `RESERVED_SPACE_KEYS` entry. The instance method is
+ * then surfaced on every `PlatformInstance` automatically.
  */
 interface PlatformWiseActions<_ResolvedSpace extends {
   id: string;
 }, _MessageType, _Client, _Config> {
+  getAvatar: (ctx: {
+    client: _Client;
+    config: _Config;
+    store: Store;
+  }, space: _ResolvedSpace & {
+    id: string;
+    __platform: string;
+  }) => Promise<AvatarData | undefined>;
+  getDisplayName: (ctx: {
+    client: _Client;
+    config: _Config;
+    store: Store;
+  }, space: _ResolvedSpace & {
+    id: string;
+    __platform: string;
+  }) => Promise<string | undefined>;
+  getMembers: (ctx: {
+    client: _Client;
+    config: _Config;
+    store: Store;
+  }, space: _ResolvedSpace & {
+    id: string;
+    __platform: string;
+  }) => Promise<readonly ProviderUserRecord[]>;
   getMessage: (ctx: {
     client: _Client;
     config: _Config;
@@ -6089,7 +6288,7 @@ type EventProducer<TPayload = unknown, TClient = unknown, TConfig = unknown> = (
 type ProviderMessage<TSender extends ResolvedUser = ResolvedUser, TSpace extends ResolvedSpace = ResolvedSpace, TExtra extends object = Record<never, never>> = {
   id: string;
   content: Content;
-  sender: TSender;
+  sender?: TSender;
   space: TSpace;
   timestamp?: Date;
 } & TExtra;
@@ -6116,6 +6315,17 @@ type ProviderMessageRecord = {
   } & Record<string, unknown>;
   timestamp?: Date;
 } & Record<string, unknown>;
+/**
+ * A chat participant a provider returned from `actions.getMembers` — the raw
+ * record shape, mirroring `ProviderMessageRecord.sender`. `id` is the user's
+ * canonical platform identifier (the same handle format `space.create`
+ * accepts); platform extras (e.g. iMessage's `address`/`country`/`service`)
+ * ride along untyped. `space.getMembers()` tags each record with
+ * `__platform` before surfacing it as a `User`.
+ */
+type ProviderUserRecord = {
+  id: string;
+} & Record<string, unknown>;
 type MergeSchema<TSchema extends z.ZodType | undefined, TBase extends object> = TSchema extends z.ZodType ? string extends keyof z.infer<TSchema> ? TBase : Omit<z.infer<TSchema>, keyof TBase> & TBase : TBase;
 type SchemaMessage<TUserSchema extends z.ZodType | undefined = undefined, TSpaceSchema extends z.ZodType | undefined = undefined> = ProviderMessage<MergeSchema<TUserSchema, ResolvedUser>, MergeSchema<TSpaceSchema, ResolvedSpace>>;
 type InferEventPayload<T> = T extends z.ZodType ? z.infer<T> : T extends ((ctx: never) => AsyncIterable<infer P>) ? P : never;
@@ -6157,13 +6367,14 @@ interface PlatformDef<_Name extends string = string, _ConfigSchema extends z.Zod
    *
    * Two tiers share this slot:
    *
-   * 1. **Platform-wise actions** (`getMessage`) — framework-recognized names
-   *    declared in `PlatformWiseActions`. Override by declaring the key here
-   *    with the matching signature. The framework injects `ctx = { client,
-   *    config, store }` as the first arg and surfaces the method on the
-   *    platform instance (`im.getMessage(space, id)`). If omitted, the
-   *    framework wires a default that throws `UnsupportedError`. Powers
-   *    universal sugar like `space.getMessage(id)`.
+   * 1. **Platform-wise actions** (`getMessage`, `getMembers`, `getAvatar`) —
+   *    framework-recognized names declared in `PlatformWiseActions`. Override
+   *    by declaring the key here with the matching signature. The framework
+   *    injects `ctx = { client, config, store }` as the first arg and
+   *    surfaces the method on the platform instance
+   *    (`im.getMessage(space, id)`). If omitted, the framework wires a
+   *    default that throws `UnsupportedError`. Powers universal sugar like
+   *    `space.getMessage(id)`.
    *
    * 2. **Platform-specific actions** — free-form keys like `getAttachment`.
    *    Each gets `ctx = { client, config, store }` as the first arg; the
@@ -6301,9 +6512,10 @@ interface PlatformDef<_Name extends string = string, _ConfigSchema extends z.Zod
      * lives here for platform-specific surface area.
      *
      * Names that collide with reserved `Space` keys (`send`, `edit`,
-     * `unsend`, `getMessage`, `startTyping`, `stopTyping`, `responding`,
-     * `id`, `__platform`) are skipped at runtime with a warning and excluded
-     * at the type level.
+     * `unsend`, `read`, `getMessage`, `getMembers`, `getAvatar`, `rename`,
+     * `avatar`, `add`, `remove`, `leave`, `startTyping`, `stopTyping`,
+     * `responding`, `id`, `__platform`) are skipped at runtime with a
+     * warning and excluded at the type level.
      */
     actions?: _SpaceActions;
   };
@@ -6410,6 +6622,9 @@ type InstanceActionFns<Def extends AnyPlatformDef> = Def["actions"] extends infe
 type ReservedInstanceKeys<Def extends AnyPlatformDef> = "user" | "space" | "messages" | PlatformWiseActionKey | Extract<keyof CustomEventInstanceProperties<Def>, string>;
 type InstanceActionMethods<Def extends AnyPlatformDef> = { [K in Exclude<keyof InstanceActionFns<Def>, ReservedInstanceKeys<Def> | symbol | number>]: (...args: TailArgs<Parameters<InstanceActionFns<Def>[K]>>) => ReturnType<InstanceActionFns<Def>[K]> };
 interface PlatformWiseInstanceMethods<Def extends AnyPlatformDef> {
+  getAvatar: (space: PlatformSpace<Def>) => Promise<AvatarData | undefined>;
+  getDisplayName: (space: PlatformSpace<Def>) => Promise<string | undefined>;
+  getMembers: (space: PlatformSpace<Def>) => Promise<PlatformUser<Def>[]>;
   getMessage: (space: PlatformSpace<Def>, messageId: string) => Promise<PlatformMessage<Def> | undefined>;
 }
 type PlatformSpace<Def extends AnyPlatformDef> = Omit<SpaceShapeOf<Def>, keyof Space | keyof SpaceActionMethods<Def>> & Space & SpaceActionMethods<Def>;
@@ -6852,6 +7067,14 @@ declare const baseContentSchema: z.ZodDiscriminatedUnion<readonly [z.ZodObject<{
   }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"clear">;
   }, z.core.$strip>], "kind">;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"addMember">;
+  members: z.ZodArray<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"removeMember">;
+  members: z.ZodArray<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"leaveSpace">;
 }, z.core.$strip>], "type">;
 type BaseContent = z.infer<typeof baseContentSchema>;
 declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -7021,12 +7244,17 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"clear">;
   }, z.core.$strip>], "kind">;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"addMember">;
+  members: z.ZodArray<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"removeMember">;
+  members: z.ZodArray<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"leaveSpace">;
 }, z.core.$strip>, z.ZodObject<{
   type: z.ZodLiteral<"reply">;
   content: z.ZodCustom<{
-    type: "custom";
-    raw: unknown;
-  } | {
     type: "attachment";
     id: string;
     name: string;
@@ -7035,25 +7263,11 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
     size?: number | undefined;
   } | {
-    type: "poll";
-    title: string;
-    options: {
-      title: string;
-    }[];
+    type: "text";
+    text: string;
   } | {
-    type: "poll_option";
-    option: {
-      title: string;
-    };
-    poll: {
-      type: "poll";
-      title: string;
-      options: {
-        title: string;
-      }[];
-    };
-    selected: boolean;
-    title: string;
+    type: "markdown";
+    markdown: string;
   } | {
     type: "contact";
     user?: {
@@ -7098,18 +7312,38 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     } | undefined;
     raw?: unknown;
   } | {
-    type: "text";
-    text: string;
+    type: "custom";
+    raw: unknown;
   } | {
-    type: "markdown";
-    markdown: string;
+    type: "poll";
+    title: string;
+    options: {
+      title: string;
+    }[];
   } | {
-    type: "group";
-    items: Message<string, User, Space<unknown>>[];
+    type: "poll_option";
+    option: {
+      title: string;
+    };
+    poll: {
+      type: "poll";
+      title: string;
+      options: {
+        title: string;
+      }[];
+    };
+    selected: boolean;
+    title: string;
   } | {
     type: "reaction";
     emoji: string;
     target: Message<string, User, Space<unknown>>;
+  } | {
+    type: "group";
+    items: Message<string, User, Space<unknown>>[];
+  } | {
+    type: "richlink";
+    url: string;
   } | {
     type: "streamText";
     stream: () => AsyncIterable<string>;
@@ -7122,9 +7356,6 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     name?: string | undefined;
     duration?: number | undefined;
     size?: number | undefined;
-  } | {
-    type: "richlink";
-    url: string;
   } | {
     type: "app";
     url: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodURL>>;
@@ -7171,10 +7402,15 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     } | {
       kind: "clear";
     };
-  }, {
-    type: "custom";
-    raw: unknown;
   } | {
+    type: "addMember";
+    members: string[];
+  } | {
+    type: "removeMember";
+    members: string[];
+  } | {
+    type: "leaveSpace";
+  }, {
     type: "attachment";
     id: string;
     name: string;
@@ -7183,25 +7419,11 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
     size?: number | undefined;
   } | {
-    type: "poll";
-    title: string;
-    options: {
-      title: string;
-    }[];
+    type: "text";
+    text: string;
   } | {
-    type: "poll_option";
-    option: {
-      title: string;
-    };
-    poll: {
-      type: "poll";
-      title: string;
-      options: {
-        title: string;
-      }[];
-    };
-    selected: boolean;
-    title: string;
+    type: "markdown";
+    markdown: string;
   } | {
     type: "contact";
     user?: {
@@ -7246,18 +7468,38 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     } | undefined;
     raw?: unknown;
   } | {
-    type: "text";
-    text: string;
+    type: "custom";
+    raw: unknown;
   } | {
-    type: "markdown";
-    markdown: string;
+    type: "poll";
+    title: string;
+    options: {
+      title: string;
+    }[];
   } | {
-    type: "group";
-    items: Message<string, User, Space<unknown>>[];
+    type: "poll_option";
+    option: {
+      title: string;
+    };
+    poll: {
+      type: "poll";
+      title: string;
+      options: {
+        title: string;
+      }[];
+    };
+    selected: boolean;
+    title: string;
   } | {
     type: "reaction";
     emoji: string;
     target: Message<string, User, Space<unknown>>;
+  } | {
+    type: "group";
+    items: Message<string, User, Space<unknown>>[];
+  } | {
+    type: "richlink";
+    url: string;
   } | {
     type: "streamText";
     stream: () => AsyncIterable<string>;
@@ -7270,9 +7512,6 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     name?: string | undefined;
     duration?: number | undefined;
     size?: number | undefined;
-  } | {
-    type: "richlink";
-    url: string;
   } | {
     type: "app";
     url: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodURL>>;
@@ -7319,14 +7558,19 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     } | {
       kind: "clear";
     };
+  } | {
+    type: "addMember";
+    members: string[];
+  } | {
+    type: "removeMember";
+    members: string[];
+  } | {
+    type: "leaveSpace";
   }>;
   target: z.ZodCustom<Message<string, User, Space<unknown>>, Message<string, User, Space<unknown>>>;
 }, z.core.$strip>, z.ZodObject<{
   type: z.ZodLiteral<"edit">;
   content: z.ZodCustom<{
-    type: "custom";
-    raw: unknown;
-  } | {
     type: "attachment";
     id: string;
     name: string;
@@ -7335,25 +7579,11 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
     size?: number | undefined;
   } | {
-    type: "poll";
-    title: string;
-    options: {
-      title: string;
-    }[];
+    type: "text";
+    text: string;
   } | {
-    type: "poll_option";
-    option: {
-      title: string;
-    };
-    poll: {
-      type: "poll";
-      title: string;
-      options: {
-        title: string;
-      }[];
-    };
-    selected: boolean;
-    title: string;
+    type: "markdown";
+    markdown: string;
   } | {
     type: "contact";
     user?: {
@@ -7398,18 +7628,38 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     } | undefined;
     raw?: unknown;
   } | {
-    type: "text";
-    text: string;
+    type: "custom";
+    raw: unknown;
   } | {
-    type: "markdown";
-    markdown: string;
+    type: "poll";
+    title: string;
+    options: {
+      title: string;
+    }[];
   } | {
-    type: "group";
-    items: Message<string, User, Space<unknown>>[];
+    type: "poll_option";
+    option: {
+      title: string;
+    };
+    poll: {
+      type: "poll";
+      title: string;
+      options: {
+        title: string;
+      }[];
+    };
+    selected: boolean;
+    title: string;
   } | {
     type: "reaction";
     emoji: string;
     target: Message<string, User, Space<unknown>>;
+  } | {
+    type: "group";
+    items: Message<string, User, Space<unknown>>[];
+  } | {
+    type: "richlink";
+    url: string;
   } | {
     type: "streamText";
     stream: () => AsyncIterable<string>;
@@ -7422,9 +7672,6 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     name?: string | undefined;
     duration?: number | undefined;
     size?: number | undefined;
-  } | {
-    type: "richlink";
-    url: string;
   } | {
     type: "app";
     url: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodURL>>;
@@ -7471,10 +7718,15 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     } | {
       kind: "clear";
     };
-  }, {
-    type: "custom";
-    raw: unknown;
   } | {
+    type: "addMember";
+    members: string[];
+  } | {
+    type: "removeMember";
+    members: string[];
+  } | {
+    type: "leaveSpace";
+  }, {
     type: "attachment";
     id: string;
     name: string;
@@ -7483,25 +7735,11 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
     size?: number | undefined;
   } | {
-    type: "poll";
-    title: string;
-    options: {
-      title: string;
-    }[];
+    type: "text";
+    text: string;
   } | {
-    type: "poll_option";
-    option: {
-      title: string;
-    };
-    poll: {
-      type: "poll";
-      title: string;
-      options: {
-        title: string;
-      }[];
-    };
-    selected: boolean;
-    title: string;
+    type: "markdown";
+    markdown: string;
   } | {
     type: "contact";
     user?: {
@@ -7546,18 +7784,38 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     } | undefined;
     raw?: unknown;
   } | {
-    type: "text";
-    text: string;
+    type: "custom";
+    raw: unknown;
   } | {
-    type: "markdown";
-    markdown: string;
+    type: "poll";
+    title: string;
+    options: {
+      title: string;
+    }[];
   } | {
-    type: "group";
-    items: Message<string, User, Space<unknown>>[];
+    type: "poll_option";
+    option: {
+      title: string;
+    };
+    poll: {
+      type: "poll";
+      title: string;
+      options: {
+        title: string;
+      }[];
+    };
+    selected: boolean;
+    title: string;
   } | {
     type: "reaction";
     emoji: string;
     target: Message<string, User, Space<unknown>>;
+  } | {
+    type: "group";
+    items: Message<string, User, Space<unknown>>[];
+  } | {
+    type: "richlink";
+    url: string;
   } | {
     type: "streamText";
     stream: () => AsyncIterable<string>;
@@ -7570,9 +7828,6 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     name?: string | undefined;
     duration?: number | undefined;
     size?: number | undefined;
-  } | {
-    type: "richlink";
-    url: string;
   } | {
     type: "app";
     url: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodURL>>;
@@ -7619,6 +7874,14 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     } | {
       kind: "clear";
     };
+  } | {
+    type: "addMember";
+    members: string[];
+  } | {
+    type: "removeMember";
+    members: string[];
+  } | {
+    type: "leaveSpace";
   }>;
   target: z.ZodCustom<Message<string, User, Space<unknown>>, Message<string, User, Space<unknown>>>;
 }, z.core.$strip>, z.ZodObject<{
@@ -7660,4 +7923,4 @@ declare function attachment(input: AttachmentInput, options?: {
   name?: string;
 }): ContentBuilder;
 //#endregion
-export { FusorTokenData as $, asGroup as $t, isFusorEvent as A, photoActionSchema as An, reply as At, PlatformUser as B, PollOption as Bt, FusorVerify as C, AgentSender as Cn, text as Ct, WebhookRawResult as D, avatar as Dn, resolveContents as Dt, WebhookRawRequest as E, AvatarInput as En, richlink as Et, PlatformInstance as F, appLayoutSchema as Fn, asRead as Ft, Broadcaster as G, Markdown as Gt, ProviderMessageRecord as H, asPollOption as Ht, PlatformMessage as I, read as It, mergeStreams as J, DeltaExtractor as Jt, ManagedStream as K, asMarkdown as Kt, PlatformProviderConfig as L, Poll as Lt, EventProducer as M, AppLayout as Mn, Rename as Mt, Platform as N, AppUrl as Nn, rename as Nt, FusorEvent as O, PhotoInput as On, Reply as Ot, PlatformDef as P, app as Pn, Read as Pt, DedicatedTokenData as Q, Group as Qt, PlatformRuntime as R, PollChoice as Rt, FusorRespond as S, contact as Sn, asText as St, WebhookHandler as T, Avatar as Tn, asRichlink as Tt, SchemaMessage as U, option as Ut, ProviderMessage as V, asPoll as Vt, SpaceNamespace as W, poll as Wt, Store as X, StreamTextSource as Xt, stream as Y, StreamText as Yt, CloudPlatform as Z, TextStreamOptions as Zt, FusorClient as _, ContactInput as _n, voice as _t, Content as a, Space as an, SharedTokenData as at, FusorMessagesReturn as b, ContactPhone as bn, Typing as bt, fromVCard as c, asReaction as cn, SpectrumCloudError as ct, UnsupportedKind as d, asCustom as dn, TokenData as dt, group as en, ImessageInfoData as et, Spectrum as f, custom as fn, cloud as ft, isFusorClient as g, ContactEmail as gn, asVoice as gt, fusor as h, ContactDetails as hn, Voice as ht, attachment as i, Message as in, ProjectProfile as it, AnyPlatformDef as j, App as jn, replySchema as jt, fusorEvent as k, buildPhotoAction as kn, asReply as kt, toVCard as l, reaction as ln, SubscriptionData as lt, definePlatform as m, ContactAddress as mn, EmojiKey as mt, AttachmentInput as n, Edit as nn, PlatformsData as nt, ContentBuilder as o, Reaction as on, SlackTeamMeta as ot, SpectrumInstance as p, Contact as pn, Emoji as pt, broadcast as q, markdown as qt, asAttachment as r, edit as rn, ProjectData as rt, ContentInput as s, ReactionBuilder as sn, SlackTokenData as st, Attachment as t, groupSchema as tn, PlatformStatus as tt, UnsupportedError as u, reactionSchema as un, SubscriptionStatus as ut, FusorMessages as v, ContactName as vn, Unsend as vt, FusorVerifyRequest as w, User as wn, Richlink as wt, FusorReply as x, asContact as xn, typing as xt, FusorMessagesCtx as y, ContactOrg as yn, unsend as yt, PlatformSpace as z, PollChoiceInput as zt };
+export { DedicatedTokenData as $, TextStreamOptions as $t, isFusorEvent as A, ContactName as An, asReply as At, PlatformUser as B, avatar as Bn, PollChoice as Bt, FusorVerify as C, asCustom as Cn, asText as Ct, WebhookRawResult as D, ContactDetails as Dn, richlink as Dt, WebhookRawRequest as E, ContactAddress as En, asRichlink as Et, PlatformInstance as F, AgentSender as Fn, renameSchema as Ft, SpaceNamespace as G, App as Gn, option as Gt, ProviderMessageRecord as H, PhotoInput as Hn, PollOption as Ht, PlatformMessage as I, User as In, Read as It, broadcast as J, app as Jn, asMarkdown as Jt, Broadcaster as K, AppLayout as Kn, poll as Kt, PlatformProviderConfig as L, Avatar as Ln, asRead as Lt, EventProducer as M, ContactPhone as Mn, replySchema as Mt, Platform as N, asContact as Nn, Rename as Nt, FusorEvent as O, ContactEmail as On, resolveContents as Ot, PlatformDef as P, contact as Pn, rename as Pt, CloudPlatform as Q, StreamTextSource as Qt, PlatformRuntime as R, AvatarData as Rn, read as Rt, FusorRespond as S, reactionSchema as Sn, typing as St, WebhookHandler as T, Contact as Tn, Richlink as Tt, ProviderUserRecord as U, buildPhotoAction as Un, asPoll as Ut, ProviderMessage as V, avatarSchema as Vn, PollChoiceInput as Vt, SchemaMessage as W, photoActionSchema as Wn, asPollOption as Wt, stream as X, DeltaExtractor as Xt, mergeStreams as Y, appLayoutSchema as Yn, markdown as Yt, Store as Z, StreamText as Zt, FusorClient as _, removeMemberSchema as _n, asVoice as _t, Content as a, edit as an, ProjectProfile as at, FusorMessagesReturn as b, asReaction as bn, unsend as bt, fromVCard as c, AddMember as cn, SlackTokenData as ct, UnsupportedKind as d, RemoveMember as dn, SubscriptionStatus as dt, Group as en, FusorTokenData as et, Spectrum as f, addMember as fn, TokenData as ft, isFusorClient as g, removeMember as gn, Voice as gt, fusor as h, leaveSpaceSchema as hn, EmojiKey as ht, attachment as i, Edit as in, ProjectData as it, AnyPlatformDef as j, ContactOrg as jn, reply as jt, fusorEvent as k, ContactInput as kn, Reply as kt, toVCard as l, LeaveSpace as ln, SpectrumCloudError as lt, definePlatform as m, leaveSpace as mn, Emoji as mt, AttachmentInput as n, group as nn, PlatformStatus as nt, ContentBuilder as o, Message as on, SharedTokenData as ot, SpectrumInstance as p, addMemberSchema as pn, cloud as pt, ManagedStream as q, AppUrl as qn, Markdown as qt, asAttachment as r, groupSchema as rn, PlatformsData as rt, ContentInput as s, Space as sn, SlackTeamMeta as st, Attachment as t, asGroup as tn, ImessageInfoData as tt, UnsupportedError as u, MemberInput as un, SubscriptionData as ut, FusorMessages as v, Reaction as vn, voice as vt, FusorVerifyRequest as w, custom as wn, text as wt, FusorReply as x, reaction as xn, Typing as xt, FusorMessagesCtx as y, ReactionBuilder as yn, Unsend as yt, PlatformSpace as z, AvatarInput as zn, Poll as zt };