@spectrum-ts/core 8.2.2 → 9.0.0

package/dist/authoring.d.ts

@@ -1,4 +1,4 @@
-import { $t as asGroup, An as photoActionSchema, Ft as asRead, H as ProviderMessageRecord, Ht as asPollOption, K as ManagedStream, Kt as asMarkdown, On as PhotoInput, St as asText, Tt as asRichlink, Vt as asPoll, cn as asReaction, dn as asCustom, gt as asVoice, jt as replySchema, kn as buildPhotoAction, kt as asReply, r as asAttachment, tn as groupSchema, un as reactionSchema, xn as asContact } from "./attachment-DqrtDRaN.js";
+import { At as asReply, Cn as asCustom, Ct as asText, Et as asRichlink, Ft as renameSchema, H as ProviderMessageRecord, Hn as PhotoInput, Jt as asMarkdown, Lt as asRead, Mt as replySchema, Nn as asContact, Sn as reactionSchema, U as ProviderUserRecord, Un as buildPhotoAction, Ut as asPoll, Vn as avatarSchema, Wn as photoActionSchema, Wt as asPollOption, _n as removeMemberSchema, _t as asVoice, bn as asReaction, hn as leaveSpaceSchema, pn as addMemberSchema, q as ManagedStream, r as asAttachment, rn as groupSchema, tn as asGroup } from "./attachment-Bn3rw5jW.js";
 import z from "zod";
 import { FetchSpanOptions, LogAttrs, LogAttrs as LogAttrs$1, LogLevel, PhotonLogger, SanitizeUrlOptions, createLogger, sanitizeEmail, sanitizeErrorMessage, sanitizePhone, sanitizeUrl, setLogLevel } from "@photon-ai/otel";
 import { Token } from "marked";
@@ -123,4 +123,4 @@ declare const resumableOrderedStream: <TLive, TMissed, TOutput>(options: Resumab
  */
 declare function errorAttrs(error: unknown, prefix?: string): LogAttrs$1;
 //#endregion
-export { type CloseableAsyncIterable, type LogAttrs, type LogLevel, type PhotoInput, type PhotonLogger, type ProviderMessageRecord, type ResumableStreamItem, type SanitizeUrlOptions, asAttachment, asContact, asCustom, asGroup, asMarkdown, asPoll, asPollOption, asReaction, asRead, asReply, asRichlink, asText, asVoice, buildPhotoAction, createLogger, ensureM4a, errorAttrs, groupSchema, messageEffectSchema, photoActionSchema, reactionSchema, renderInlineTokens, replySchema, resumableOrderedStream, sanitizeEmail, sanitizeErrorMessage, sanitizePhone, sanitizeUrl, setLogLevel, tracedFetch };
+export { type CloseableAsyncIterable, type LogAttrs, type LogLevel, type PhotoInput, type PhotonLogger, type ProviderMessageRecord, type ProviderUserRecord, type ResumableStreamItem, type SanitizeUrlOptions, addMemberSchema, asAttachment, asContact, asCustom, asGroup, asMarkdown, asPoll, asPollOption, asReaction, asRead, asReply, asRichlink, asText, asVoice, avatarSchema, buildPhotoAction, createLogger, ensureM4a, errorAttrs, groupSchema, leaveSpaceSchema, messageEffectSchema, photoActionSchema, reactionSchema, removeMemberSchema, renameSchema, renderInlineTokens, replySchema, resumableOrderedStream, sanitizeEmail, sanitizeErrorMessage, sanitizePhone, sanitizeUrl, setLogLevel, tracedFetch };

package/dist/authoring.js

@@ -1,4 +1,4 @@
-import { A as asGroup, C as asPoll, D as asMarkdown, G as buildPhotoAction, I as textSchema, K as photoActionSchema, M as groupSchema, P as asText, S as reactionSchema, V as asContact, Y as attachmentSchema, Z as tracedFetch, _ as replySchema, b as asReaction, d as asVoice, h as asReply, i as stream, k as markdownSchema, l as renderInlineTokens, o as errorAttrs, p as asRichlink, q as asAttachment, v as asRead, w as asPollOption, z as asCustom } from "./stream-DAbdViJ9.js";
+import { A as addMemberSchema, B as groupSchema, E as asPollOption, F as asMarkdown, H as asText, L as markdownSchema, M as leaveSpaceSchema, P as removeMemberSchema, R as asGroup, S as asReaction, T as asPoll, W as textSchema, Y as asContact, _ as replySchema, at as attachmentSchema, b as asRead, d as asVoice, et as avatarSchema, h as asReply, i as stream, l as renderInlineTokens, nt as photoActionSchema, o as errorAttrs, p as asRichlink, q as asCustom, rt as asAttachment, st as tracedFetch, tt as buildPhotoAction, w as reactionSchema, y as renameSchema } from "./stream-DxI5ZiE2.js";
 import z from "zod";
 import { createLogger, createLogger as createLogger$1, sanitizeEmail, sanitizeErrorMessage, sanitizePhone, sanitizeUrl, setLogLevel } from "@photon-ai/otel";
 import { mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
@@ -422,4 +422,4 @@ const resumableOrderedStream = (options) => stream((emit, end) => {
 	};
 });
 //#endregion
-export { asAttachment, asContact, asCustom, asGroup, asMarkdown, asPoll, asPollOption, asReaction, asRead, asReply, asRichlink, asText, asVoice, buildPhotoAction, createLogger, ensureM4a, errorAttrs, groupSchema, messageEffectSchema, photoActionSchema, reactionSchema, renderInlineTokens, replySchema, resumableOrderedStream, sanitizeEmail, sanitizeErrorMessage, sanitizePhone, sanitizeUrl, setLogLevel, tracedFetch };
+export { addMemberSchema, asAttachment, asContact, asCustom, asGroup, asMarkdown, asPoll, asPollOption, asReaction, asRead, asReply, asRichlink, asText, asVoice, avatarSchema, buildPhotoAction, createLogger, ensureM4a, errorAttrs, groupSchema, leaveSpaceSchema, messageEffectSchema, photoActionSchema, reactionSchema, removeMemberSchema, renameSchema, renderInlineTokens, replySchema, resumableOrderedStream, sanitizeEmail, sanitizeErrorMessage, sanitizePhone, sanitizeUrl, setLogLevel, tracedFetch };

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-import { $ as FusorTokenData, A as isFusorEvent, At as reply, B as PlatformUser, Bt as PollOption, C as FusorVerify, Cn as AgentSender, Ct as text, D as WebhookRawResult, Dn as avatar, Dt as resolveContents, E as WebhookRawRequest, En as AvatarInput, Et as richlink, F as PlatformInstance, Fn as appLayoutSchema, G as Broadcaster, Gt as Markdown, I as PlatformMessage, It as read, J as mergeStreams, Jt as DeltaExtractor, K as ManagedStream, L as PlatformProviderConfig, Lt as Poll, M as EventProducer, Mn as AppLayout, Mt as Rename, N as Platform, Nn as AppUrl, Nt as rename, O as FusorEvent, Ot as Reply, P as PlatformDef, Pn as app, Pt as Read, Q as DedicatedTokenData, Qt as Group, R as PlatformRuntime, Rt as PollChoice, S as FusorRespond, Sn as contact, T as WebhookHandler, Tn as Avatar, U as SchemaMessage, Ut as option, V as ProviderMessage, W as SpaceNamespace, Wt as poll, X as Store, Xt as StreamTextSource, Y as stream, Yt as StreamText, Z as CloudPlatform, Zt as TextStreamOptions, _ as FusorClient, _n as ContactInput, _t as voice, a as Content, an as Space, at as SharedTokenData, b as FusorMessagesReturn, bn as ContactPhone, bt as Typing, c as fromVCard, ct as SpectrumCloudError, d as UnsupportedKind, dt as TokenData, en as group, et as ImessageInfoData, f as Spectrum, fn as custom, ft as cloud, g as isFusorClient, gn as ContactEmail, h as fusor, hn as ContactDetails, ht as Voice, i as attachment, in as Message, it as ProjectProfile, j as AnyPlatformDef, jn as App, k as fusorEvent, l as toVCard, ln as reaction, lt as SubscriptionData, m as definePlatform, mn as ContactAddress, mt as EmojiKey, n as AttachmentInput, nn as Edit, nt as PlatformsData, o as ContentBuilder, on as Reaction, ot as SlackTeamMeta, p as SpectrumInstance, pn as Contact, pt as Emoji, q as broadcast, qt as markdown, rn as edit, rt as ProjectData, s as ContentInput, sn as ReactionBuilder, st as SlackTokenData, t as Attachment, tt as PlatformStatus, u as UnsupportedError, ut as SubscriptionStatus, v as FusorMessages, vn as ContactName, vt as Unsend, w as FusorVerifyRequest, wn as User, wt as Richlink, x as FusorReply, xt as typing, y as FusorMessagesCtx, yn as ContactOrg, yt as unsend, z as PlatformSpace, zt as PollChoiceInput } from "./attachment-DqrtDRaN.js";
-export { type AgentSender, type AnyPlatformDef, type App, type AppLayout, type AppUrl, type Attachment, type AttachmentInput, type Avatar, type AvatarInput, type Broadcaster, type CloudPlatform, type Contact, type ContactAddress, type ContactDetails, type ContactEmail, type ContactInput, type ContactName, type ContactOrg, type ContactPhone, type Content, type ContentBuilder, type ContentInput, type DedicatedTokenData, type DeltaExtractor, type Edit, Emoji, type EmojiKey, type EventProducer, type FusorClient, type FusorEvent, type FusorMessages, type FusorMessagesCtx, type FusorMessagesReturn, type FusorReply, type FusorRespond, type FusorTokenData, type FusorVerify, type FusorVerifyRequest, type Group, type ImessageInfoData, type ManagedStream, type Markdown, type Message, type Platform, type PlatformDef, type PlatformInstance, type PlatformMessage, type PlatformProviderConfig, type PlatformRuntime, type PlatformSpace, type PlatformStatus, type PlatformUser, type PlatformsData, type Poll, type PollChoice, type PollChoiceInput, type PollOption, type ProjectData, type ProjectProfile, type ProviderMessage, type Reaction, type ReactionBuilder, type Read, type Rename, type Reply, type Richlink, type SchemaMessage, type SharedTokenData, type SlackTeamMeta, type SlackTokenData, type Space, type SpaceNamespace, Spectrum, SpectrumCloudError, type SpectrumInstance, type Store, type StreamText, type StreamTextSource, type SubscriptionData, type SubscriptionStatus, type TextStreamOptions, type TokenData, type Typing, type Unsend, UnsupportedError, type UnsupportedKind, type User, type Voice, type WebhookHandler, type WebhookRawRequest, type WebhookRawResult, app, appLayoutSchema, attachment, avatar, broadcast, cloud, contact, custom, definePlatform, edit, fromVCard, fusor, fusorEvent, group, isFusorClient, isFusorEvent, markdown, mergeStreams, option, poll, reaction, read, rename, reply, resolveContents, richlink, stream, text, toVCard, typing, unsend, voice };
+import { $ as DedicatedTokenData, $t as TextStreamOptions, A as isFusorEvent, An as ContactName, B as PlatformUser, Bn as avatar, Bt as PollChoice, C as FusorVerify, D as WebhookRawResult, Dn as ContactDetails, Dt as richlink, E as WebhookRawRequest, En as ContactAddress, F as PlatformInstance, Fn as AgentSender, G as SpaceNamespace, Gn as App, Gt as option, Ht as PollOption, I as PlatformMessage, In as User, It as Read, J as broadcast, Jn as app, K as Broadcaster, Kn as AppLayout, Kt as poll, L as PlatformProviderConfig, Ln as Avatar, M as EventProducer, Mn as ContactPhone, N as Platform, Nt as Rename, O as FusorEvent, On as ContactEmail, Ot as resolveContents, P as PlatformDef, Pn as contact, Pt as rename, Q as CloudPlatform, Qt as StreamTextSource, R as PlatformRuntime, Rn as AvatarData, Rt as read, S as FusorRespond, St as typing, T as WebhookHandler, Tn as Contact, Tt as Richlink, V as ProviderMessage, Vt as PollChoiceInput, W as SchemaMessage, X as stream, Xt as DeltaExtractor, Y as mergeStreams, Yn as appLayoutSchema, Yt as markdown, Z as Store, Zt as StreamText, _ as FusorClient, a as Content, an as edit, at as ProjectProfile, b as FusorMessagesReturn, bt as unsend, c as fromVCard, cn as AddMember, ct as SlackTokenData, d as UnsupportedKind, dn as RemoveMember, dt as SubscriptionStatus, en as Group, et as FusorTokenData, f as Spectrum, fn as addMember, ft as TokenData, g as isFusorClient, gn as removeMember, gt as Voice, h as fusor, ht as EmojiKey, i as attachment, in as Edit, it as ProjectData, j as AnyPlatformDef, jn as ContactOrg, jt as reply, k as fusorEvent, kn as ContactInput, kt as Reply, l as toVCard, ln as LeaveSpace, lt as SpectrumCloudError, m as definePlatform, mn as leaveSpace, mt as Emoji, n as AttachmentInput, nn as group, nt as PlatformStatus, o as ContentBuilder, on as Message, ot as SharedTokenData, p as SpectrumInstance, pt as cloud, q as ManagedStream, qn as AppUrl, qt as Markdown, rt as PlatformsData, s as ContentInput, sn as Space, st as SlackTeamMeta, t as Attachment, tt as ImessageInfoData, u as UnsupportedError, un as MemberInput, ut as SubscriptionData, v as FusorMessages, vn as Reaction, vt as voice, w as FusorVerifyRequest, wn as custom, wt as text, x as FusorReply, xn as reaction, xt as Typing, y as FusorMessagesCtx, yn as ReactionBuilder, yt as Unsend, z as PlatformSpace, zn as AvatarInput, zt as Poll } from "./attachment-Bn3rw5jW.js";
+export { type AddMember, type AgentSender, type AnyPlatformDef, type App, type AppLayout, type AppUrl, type Attachment, type AttachmentInput, type Avatar, type AvatarData, type AvatarInput, type Broadcaster, type CloudPlatform, type Contact, type ContactAddress, type ContactDetails, type ContactEmail, type ContactInput, type ContactName, type ContactOrg, type ContactPhone, type Content, type ContentBuilder, type ContentInput, type DedicatedTokenData, type DeltaExtractor, type Edit, Emoji, type EmojiKey, type EventProducer, type FusorClient, type FusorEvent, type FusorMessages, type FusorMessagesCtx, type FusorMessagesReturn, type FusorReply, type FusorRespond, type FusorTokenData, type FusorVerify, type FusorVerifyRequest, type Group, type ImessageInfoData, type LeaveSpace, type ManagedStream, type Markdown, type MemberInput, type Message, type Platform, type PlatformDef, type PlatformInstance, type PlatformMessage, type PlatformProviderConfig, type PlatformRuntime, type PlatformSpace, type PlatformStatus, type PlatformUser, type PlatformsData, type Poll, type PollChoice, type PollChoiceInput, type PollOption, type ProjectData, type ProjectProfile, type ProviderMessage, type Reaction, type ReactionBuilder, type Read, type RemoveMember, type Rename, type Reply, type Richlink, type SchemaMessage, type SharedTokenData, type SlackTeamMeta, type SlackTokenData, type Space, type SpaceNamespace, Spectrum, SpectrumCloudError, type SpectrumInstance, type Store, type StreamText, type StreamTextSource, type SubscriptionData, type SubscriptionStatus, type TextStreamOptions, type TokenData, type Typing, type Unsend, UnsupportedError, type UnsupportedKind, type User, type Voice, type WebhookHandler, type WebhookRawRequest, type WebhookRawResult, addMember, app, appLayoutSchema, attachment, avatar, broadcast, cloud, contact, custom, definePlatform, edit, fromVCard, fusor, fusorEvent, group, isFusorClient, isFusorEvent, leaveSpace, markdown, mergeStreams, option, poll, reaction, read, removeMember, rename, reply, resolveContents, richlink, stream, text, toVCard, typing, unsend, voice };

package/dist/index.js

@@ -1,4 +1,4 @@
-import { B as custom, D as asMarkdown, E as poll, F as text, G as buildPhotoAction, H as contact, J as attachment, K as photoActionSchema, L as StreamConsumedError, N as resolveContents, O as markdown, P as asText, R as drainStreamText, T as option, U as fromVCard, V as asContact, W as toVCard, X as fetchUrlBytes, Z as tracedFetch, a as contentAttrs, c as markdownToPlainText, f as voice, g as reply, i as stream, j as group, m as richlink, n as createAsyncQueue, o as errorAttrs, q as asAttachment, r as mergeStreams, s as senderAttrs, t as broadcast, u as classifyIdentifier, x as reaction, y as read, z as asCustom } from "./stream-DAbdViJ9.js";
+import { $ as avatar, A as addMemberSchema, C as reaction, D as option, F as asMarkdown, G as StreamConsumedError, H as asText, I as markdown, J as custom, K as drainStreamText, M as leaveSpaceSchema, N as removeMember, O as poll, P as removeMemberSchema, Q as toVCard, U as text, V as resolveContents, X as contact, Y as asContact, Z as fromVCard, a as contentAttrs, c as markdownToPlainText, et as avatarSchema, f as voice, g as reply, i as stream, it as attachment, j as leaveSpace, k as addMember, m as richlink, n as createAsyncQueue, o as errorAttrs, ot as fetchUrlBytes, q as asCustom, r as mergeStreams, rt as asAttachment, s as senderAttrs, st as tracedFetch, t as broadcast, u as classifyIdentifier, v as rename, x as read, y as renameSchema, z as group } from "./stream-DxI5ZiE2.js";
 import z from "zod";
 import ogs from "open-graph-scraper";
 import { createLogger, setLogLevel, setupOtel, withSpan } from "@photon-ai/otel";
@@ -161,30 +161,6 @@ function app(url) {
 	return { build: async () => asApp(url) };
 }
 //#endregion
-//#region src/content/avatar.ts
-/**
-* Set or clear the chat avatar (group icon). Universal content — providers
-* dispatch by `content.type === "avatar"` in their `send` action and decide
-* their own support story (e.g. iMessage only supports it for remote group
-* chats).
-*
-* `space.send(avatar(...))` is the canonical form; `space.avatar(...)` is
-* 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.
-*/
-const avatarSchema = z.object({
-	type: z.literal("avatar"),
-	action: photoActionSchema
-});
-function avatar(input, options) {
-	const action = buildPhotoAction(input, options, "avatar");
-	return { build: async () => avatarSchema.parse({
-		type: "avatar",
-		action
-	}) };
-}
-//#endregion
 //#region src/content/edit.ts
 const isMessage$1 = (v) => typeof v === "object" && v !== null && "id" in v && "content" in v;
 const isContent = (v) => typeof v === "object" && v !== null && "type" in v && typeof v.type === "string";
@@ -198,7 +174,8 @@ const isContent = (v) => typeof v === "object" && v !== null && "type" in v && t
 * (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.
 */
 const editSchema = z.object({
 	type: z.literal("edit"),
@@ -222,7 +199,7 @@ function edit(content, target) {
 		if (target.direction !== "outbound") throw new Error(`edit() target must be an outbound message (got direction "${target.direction}", message id "${target.id}")`);
 		const [resolved] = await resolveContents([content]);
 		if (!resolved) throw new Error("edit() requires content");
-		if (resolved.type === "edit" || resolved.type === "reply" || resolved.type === "reaction" || resolved.type === "group" || resolved.type === "typing" || resolved.type === "rename" || resolved.type === "avatar" || resolved.type === "unsend" || resolved.type === "read") throw new Error(`edit() cannot wrap "${resolved.type}" content`);
+		if (resolved.type === "edit" || resolved.type === "reply" || resolved.type === "reaction" || resolved.type === "group" || resolved.type === "typing" || resolved.type === "rename" || resolved.type === "avatar" || resolved.type === "addMember" || resolved.type === "removeMember" || resolved.type === "leaveSpace" || resolved.type === "unsend" || resolved.type === "read") throw new Error(`edit() cannot wrap "${resolved.type}" content`);
 		return asEdit({
 			content: resolved,
 			target
@@ -230,31 +207,6 @@ function edit(content, target) {
 	} };
 }
 //#endregion
-//#region src/content/rename.ts
-/**
-* Rename the current chat. Universal content — providers dispatch by
-* `content.type === "rename"` in their `send` action and decide their own
-* support story (e.g. iMessage only supports it for remote group chats).
-*
-* `space.send(rename("New Name"))` is the canonical form; `space.rename(...)`
-* is universal sugar that delegates here.
-*
-* 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
-* error path.
-*/
-const renameSchema = z.object({
-	type: z.literal("rename"),
-	displayName: z.string().min(1, "rename() displayName must be non-empty")
-});
-function rename(displayName) {
-	return { build: async () => renameSchema.parse({
-		type: "rename",
-		displayName
-	}) };
-}
-//#endregion
 //#region src/content/typing.ts
 /**
 * A `typing` content value carries a typing-indicator signal — either
@@ -2344,6 +2296,9 @@ const FIRE_AND_FORGET_TYPES = new Set([
 	"edit",
 	"rename",
 	"avatar",
+	"addMember",
+	"removeMember",
+	"leaveSpace",
 	"unsend",
 	"read"
 ]);
@@ -2356,13 +2311,22 @@ const RESERVED_SPACE_KEYS = new Set([
 	"unsend",
 	"read",
 	"getMessage",
+	"getMembers",
+	"getAvatar",
 	"rename",
 	"avatar",
+	"add",
+	"remove",
+	"leave",
 	"startTyping",
 	"stopTyping",
 	"responding"
 ]);
-const PLATFORM_WISE_ACTION_KEYS = new Set(["getMessage"]);
+const PLATFORM_WISE_ACTION_KEYS = new Set([
+	"getMessage",
+	"getMembers",
+	"getAvatar"
+]);
 const RESERVED_MESSAGE_KEYS = new Set([
 	"content",
 	"direction",
@@ -2691,6 +2655,38 @@ function buildSpace(params) {
 			}, "inbound");
 		});
 	}
+	async function getMembersImpl() {
+		const getMembers = definition.actions?.getMembers;
+		if (!getMembers) throw UnsupportedError.action("getMembers", definition.name);
+		return withSpan("spectrum.space.members.get", {
+			"spectrum.provider": definition.name,
+			"spectrum.space.id": spaceRef.id
+		}, async () => {
+			const raw = await getMembers({
+				client,
+				config,
+				store
+			}, spaceRef);
+			if (!Array.isArray(raw)) throw new Error(`${definition.name} getMembers() must resolve an array of member records (got ${raw === null ? "null" : typeof raw})`);
+			return raw.map((member) => ({
+				...member,
+				id: member.id,
+				__platform: definition.name
+			}));
+		});
+	}
+	async function getAvatarImpl() {
+		const getAvatar = definition.actions?.getAvatar;
+		if (!getAvatar) throw UnsupportedError.action("getAvatar", definition.name);
+		return withSpan("spectrum.space.avatar.get", {
+			"spectrum.provider": definition.name,
+			"spectrum.space.id": spaceRef.id
+		}, async () => await getAvatar({
+			client,
+			config,
+			store
+		}, spaceRef));
+	}
 	const platformActions = {};
 	const declaredActions = definition.space.actions;
 	if (declaredActions) for (const [name, factory] of Object.entries(declaredActions)) {
@@ -2717,6 +2713,8 @@ function buildSpace(params) {
 			await space.send(read(message));
 		},
 		getMessage: getMessageImpl,
+		getMembers: getMembersImpl,
+		getAvatar: getAvatarImpl,
 		rename: async (displayName) => {
 			await space.send(rename(displayName));
 		},
@@ -2728,6 +2726,15 @@ function buildSpace(params) {
 			if (!options?.mimeType) throw new Error("space.avatar(Buffer) requires options.mimeType — pass { mimeType: '...' }");
 			await space.send(avatar(input, { mimeType: options.mimeType }));
 		}),
+		add: async (users) => {
+			await space.send(addMember(users));
+		},
+		remove: async (users) => {
+			await space.send(removeMember(users));
+		},
+		leave: async () => {
+			await space.send(leaveSpace());
+		},
 		startTyping: async () => {
 			await space.send(typing("start"));
 		},
@@ -3020,7 +3027,7 @@ function definePlatform(name, rawDef) {
 }
 //#endregion
 //#region src/build-env.ts
-const SPECTRUM_SDK_VERSION = "8.2.2";
+const SPECTRUM_SDK_VERSION = "9.0.0";
 //#endregion
 //#region src/utils/provider-packages.ts
 const OFFICIAL_PROVIDER_PACKAGES = {
@@ -3780,9 +3787,41 @@ const mapContent = (content, platform, spaceRef, ctx) => {
 		case "reply": return deserializeReply(raw, platform, spaceRef, ctx);
 		case "group": return deserializeGroup(raw, platform, spaceRef, ctx);
 		case "attachment": return deserializeAttachment(raw, platform, spaceRef, ctx);
+		case "addMember": return addMemberSchema.parse({
+			type: "addMember",
+			members: memberStrings(raw.members)
+		});
+		case "removeMember": return removeMemberSchema.parse({
+			type: "removeMember",
+			members: memberStrings(raw.members)
+		});
+		case "leaveSpace": return leaveSpaceSchema.parse({ type: "leaveSpace" });
+		case "rename": return renameSchema.parse({
+			type: "rename",
+			displayName: asString(raw.displayName)
+		});
+		case "avatar": return deserializeAvatar(raw, platform);
 		default: return asCustom(content);
 	}
 };
+const memberStrings = (value) => Array.isArray(value) ? value.filter((entry) => typeof entry === "string") : [];
+const deserializeAvatar = (raw, platform) => {
+	const action = isRecord(raw.action) ? raw.action : {};
+	if (action.kind === "clear") return avatarSchema.parse({
+		type: "avatar",
+		action: { kind: "clear" }
+	});
+	if (action.kind !== "set") throw new Error(`unknown avatar action kind: ${String(action.kind)}`);
+	const unavailable = () => Promise.reject(UnsupportedError.action("getAvatar", platform, "avatar bytes are not delivered over the Spectrum webhook — fetch the current icon via space.getAvatar()"));
+	return avatarSchema.parse({
+		type: "avatar",
+		action: {
+			kind: "set",
+			mimeType: asString(action.mimeType) || DEFAULT_MIME_TYPE,
+			read: unavailable
+		}
+	});
+};
 const deserializeAttachment = (raw, platform, spaceRef, ctx) => {
 	const id = asString(raw.id);
 	const bytes = ctx.resolveAttachment?.(platform, spaceRef, id);
@@ -4564,4 +4603,4 @@ async function Spectrum(options) {
 	} });
 }
 //#endregion
-export { Emoji, Spectrum, SpectrumCloudError, UnsupportedError, app, appLayoutSchema, attachment, avatar, broadcast, cloud, contact, custom, definePlatform, edit, fromVCard, fusor, fusorEvent, group, isFusorClient, isFusorEvent, markdown, mergeStreams, option, poll, reaction, read, rename, reply, resolveContents, richlink, stream, text, toVCard, typing, unsend, voice };
+export { Emoji, Spectrum, SpectrumCloudError, UnsupportedError, addMember, app, appLayoutSchema, attachment, avatar, broadcast, cloud, contact, custom, definePlatform, edit, fromVCard, fusor, fusorEvent, group, isFusorClient, isFusorEvent, leaveSpace, markdown, mergeStreams, option, poll, reaction, read, removeMember, rename, reply, resolveContents, richlink, stream, text, toVCard, typing, unsend, voice };

package/dist/{stream-DAbdViJ9.js → stream-DxI5ZiE2.js}

@@ -202,6 +202,36 @@ const buildPhotoAction = (input, options, contentLabel) => {
 	};
 };
 //#endregion
+//#region src/content/avatar.ts
+/**
+* Set or clear the chat avatar (group icon). Universal content — providers
+* dispatch by `content.type === "avatar"` in their `send` action and decide
+* their own support story (e.g. iMessage only supports it for remote group
+* chats).
+*
+* `space.send(avatar(...))` is the canonical form; `space.avatar(...)` is
+* 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).
+*/
+const avatarSchema = z.object({
+	type: z.literal("avatar"),
+	action: photoActionSchema
+});
+function avatar(input, options) {
+	const action = buildPhotoAction(input, options, "avatar");
+	return { build: async () => avatarSchema.parse({
+		type: "avatar",
+		action
+	}) };
+}
+//#endregion
 //#region src/utils/vcard.ts
 const asPropertyArray = (prop) => {
 	if (!prop) return [];
@@ -758,6 +788,68 @@ function markdown(source, options) {
 	return streamTextBuilder("markdown", source, options);
 }
 //#endregion
+//#region src/content/membership.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.
+*/
+const addMemberSchema = z.object({
+	type: z.literal("addMember"),
+	members: z.array(z.string()).min(1, "addMember() requires at least one member")
+});
+const removeMemberSchema = z.object({
+	type: z.literal("removeMember"),
+	members: z.array(z.string()).min(1, "removeMember() requires at least one member")
+});
+const leaveSpaceSchema = z.object({ type: z.literal("leaveSpace") });
+const toMemberIds = (users) => (Array.isArray(users) ? users : [users]).map((u) => typeof u === "string" ? u : u.id);
+/**
+* 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.
+*/
+function addMember(users) {
+	return { build: async () => addMemberSchema.parse({
+		type: "addMember",
+		members: toMemberIds(users)
+	}) };
+}
+/**
+* Build a `RemoveMember` content value removing `users` from the current
+* group chat. Accepts the same input shapes as `addMember`.
+*/
+function removeMember(users) {
+	return { build: async () => removeMemberSchema.parse({
+		type: "removeMember",
+		members: toMemberIds(users)
+	}) };
+}
+/**
+* Build a `LeaveSpace` content value making the agent's own account leave
+* the current group chat.
+*/
+function leaveSpace() {
+	return { build: async () => leaveSpaceSchema.parse({ type: "leaveSpace" }) };
+}
+//#endregion
 //#region src/content/poll.ts
 const pollChoiceSchema = z.object({ title: z.string().nonempty() });
 const pollSchema = z.object({
@@ -891,6 +983,35 @@ function read(target) {
 	} };
 }
 //#endregion
+//#region src/content/rename.ts
+/**
+* Rename the current chat. Universal content — providers dispatch by
+* `content.type === "rename"` in their `send` action and decide their own
+* support story (e.g. iMessage only supports it for remote group chats).
+*
+* `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
+* error path.
+*/
+const renameSchema = z.object({
+	type: z.literal("rename"),
+	displayName: z.string().min(1, "rename() displayName must be non-empty")
+});
+function rename(displayName) {
+	return { build: async () => renameSchema.parse({
+		type: "rename",
+		displayName
+	}) };
+}
+//#endregion
 //#region src/content/reply.ts
 const isMessage = (v) => typeof v === "object" && v !== null && "id" in v && "content" in v;
 const isContent = (v) => typeof v === "object" && v !== null && "type" in v && typeof v.type === "string";
@@ -902,7 +1023,8 @@ const isContent = (v) => typeof v === "object" && v !== null && "type" in v && t
 * `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.
 */
 const replySchema = z.object({
 	type: z.literal("reply"),
@@ -918,7 +1040,7 @@ function reply(content, target) {
 		if (!target) throw new Error("reply() target is undefined — the targeted message was never sent (space.send resolves undefined when a platform skips unsupported content)");
 		const [resolved] = await resolveContents([content]);
 		if (!resolved) throw new Error("reply() requires content");
-		if (resolved.type === "reply" || resolved.type === "edit" || resolved.type === "reaction" || resolved.type === "group" || resolved.type === "typing" || resolved.type === "rename" || resolved.type === "avatar" || resolved.type === "unsend" || resolved.type === "read") throw new Error(`reply() cannot wrap "${resolved.type}" content`);
+		if (resolved.type === "reply" || resolved.type === "edit" || resolved.type === "reaction" || resolved.type === "group" || resolved.type === "typing" || resolved.type === "rename" || resolved.type === "avatar" || resolved.type === "addMember" || resolved.type === "removeMember" || resolved.type === "leaveSpace" || resolved.type === "unsend" || resolved.type === "read") throw new Error(`reply() cannot wrap "${resolved.type}" content`);
 		return asReply({
 			content: resolved,
 			target
@@ -1454,4 +1576,4 @@ function broadcast(source) {
 	};
 }
 //#endregion
-export { asGroup as A, custom as B, asPoll as C, asMarkdown as D, poll as E, text as F, buildPhotoAction as G, contact as H, textSchema as I, attachment as J, photoActionSchema as K, StreamConsumedError as L, groupSchema as M, resolveContents as N, markdown as O, asText as P, drainStreamText as R, reactionSchema as S, option as T, fromVCard as U, asContact as V, toVCard as W, fetchUrlBytes as X, attachmentSchema as Y, tracedFetch as Z, replySchema as _, contentAttrs as a, asReaction as b, markdownToPlainText as c, asVoice as d, voice as f, reply as g, asReply as h, stream as i, group as j, markdownSchema as k, renderInlineTokens as l, richlink as m, createAsyncQueue as n, errorAttrs as o, asRichlink as p, asAttachment as q, mergeStreams as r, senderAttrs as s, broadcast as t, classifyIdentifier as u, asRead as v, asPollOption as w, reaction as x, read as y, asCustom as z };
+export { avatar as $, addMemberSchema as A, groupSchema as B, reaction as C, option as D, asPollOption as E, asMarkdown as F, StreamConsumedError as G, asText as H, markdown as I, custom as J, drainStreamText as K, markdownSchema as L, leaveSpaceSchema as M, removeMember as N, poll as O, removeMemberSchema as P, toVCard as Q, asGroup as R, asReaction as S, asPoll as T, text as U, resolveContents as V, textSchema as W, contact as X, asContact as Y, fromVCard as Z, replySchema as _, contentAttrs as a, attachmentSchema as at, asRead as b, markdownToPlainText as c, asVoice as d, avatarSchema as et, voice as f, reply as g, asReply as h, stream as i, attachment as it, leaveSpace as j, addMember as k, renderInlineTokens as l, richlink as m, createAsyncQueue as n, photoActionSchema as nt, errorAttrs as o, fetchUrlBytes as ot, asRichlink as p, asCustom as q, mergeStreams as r, asAttachment as rt, senderAttrs as s, tracedFetch as st, broadcast as t, buildPhotoAction as tt, classifyIdentifier as u, rename as v, reactionSchema as w, read as x, renameSchema as y, group as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spectrum-ts/core",
-  "version": "8.2.2",
+  "version": "9.0.0",
   "description": "The spectrum-ts runtime — Spectrum, content builders, fusor, and the provider authoring API.",
   "repository": {
     "type": "git",