spectrum-ts 1.9.2 → 1.12.0

package/dist/{chunk-HWADNTQF.js → chunk-YKWKZ2PZ.js}

@@ -1,58 +1,3 @@
-// src/content/poll.ts
-import z from "zod";
-var pollChoiceSchema = z.object({
-  title: z.string().nonempty()
-});
-var pollSchema = z.object({
-  type: z.literal("poll"),
-  title: z.string().nonempty().max(300),
-  options: z.array(pollChoiceSchema).min(2).max(10)
-});
-var pollOptionSchema = z.object({
-  type: z.literal("poll_option"),
-  option: pollChoiceSchema,
-  poll: pollSchema,
-  selected: z.boolean(),
-  title: z.string().nonempty()
-}).superRefine((value, ctx) => {
-  if (value.title !== value.option.title) {
-    ctx.addIssue({
-      code: "custom",
-      message: "poll_option title must match option.title",
-      path: ["title"]
-    });
-  }
-  if (!value.poll.options.some(
-    (pollOption) => pollOption.title === value.option.title
-  )) {
-    ctx.addIssue({
-      code: "custom",
-      message: "poll_option option must exist in poll.options",
-      path: ["option"]
-    });
-  }
-});
-var asPoll = (input) => pollSchema.parse({ type: "poll", ...input });
-var asPollOption = (input) => pollOptionSchema.parse({
-  type: "poll_option",
-  ...input,
-  title: input.option.title
-});
-var option = (title) => ({ title });
-var normalize = (raw) => typeof raw === "string" ? { title: raw } : { title: raw.title };
-var collectOptions = (args) => {
-  const [first] = args;
-  if (args.length === 1 && Array.isArray(first)) {
-    return first;
-  }
-  return args;
-};
-function poll(title, ...rest) {
-  return {
-    build: async () => asPoll({ title, options: collectOptions(rest).map(normalize) })
-  };
-}
-
 // src/utils/stream.ts
 import { Repeater } from "@repeaterjs/repeater";
 var ignoreCleanupError = () => void 0;
@@ -247,6 +192,10 @@ var cloud = {
     method: "POST",
     headers: { Authorization: basicAuth(projectId, projectSecret) }
   }),
+  issueSlackTokens: (projectId, projectSecret) => request(`/projects/${projectId}/slack/tokens`, {
+    method: "POST",
+    headers: { Authorization: basicAuth(projectId, projectSecret) }
+  }),
   getPlatforms: (projectId) => request(`/projects/${projectId}/platforms/`),
   togglePlatform: (projectId, projectSecret, platform, enabled) => request(`/projects/${projectId}/platforms/`, {
     method: "PATCH",
@@ -259,10 +208,6 @@ var cloud = {
 };
 
 export {
-  asPoll,
-  asPollOption,
-  option,
-  poll,
   stream,
   mergeStreams,
   broadcast,

package/dist/index.d.ts

@@ -1,7 +1,8 @@
-import { C as ContentBuilder, U as User, M as Message, b as ContentInput, O as OutboundMessage, c as Content, d as ProviderMessage, E as EventProducer, e as CreateClientContext, f as Store, a as PlatformDef, P as Platform, g as PlatformProviderConfig, h as SpectrumLike, i as CustomEventStreams, j as Space, I as InboundMessage } from './types-lUyzRurY.js';
-export { A as AnyPlatformDef, B as Broadcaster, k as InboundPlatformMessage, l as ManagedStream, m as PlatformInstance, n as PlatformMessage, o as PlatformRuntime, p as PlatformSpace, q as PlatformUser, S as SchemaMessage, r as broadcast, s as mergeStreams, t as stream } from './types-lUyzRurY.js';
-import vCard from 'vcf';
+import { C as ContentBuilder, U as User, M as Message, b as Space, c as ContentInput, d as Content, e as ProviderMessage, E as EventProducer, f as SpaceActionFn, g as MessageActionFn, h as CreateClientContext, i as Store, a as PlatformDef, P as Platform, j as PlatformProviderConfig, k as SpectrumLike, l as CustomEventStreams, A as AgentSender } from './types-BzW4gInA.js';
+export { m as AnyPlatformDef, B as Broadcaster, n as ManagedStream, o as PlatformInstance, p as PlatformMessage, q as PlatformRuntime, r as PlatformSpace, s as PlatformUser, S as SchemaMessage, t as broadcast, u as mergeStreams, v as stream } from './types-BzW4gInA.js';
 import z__default from 'zod';
+import { P as PhotoInput } from './photo-content-BQF42prd.js';
+import vCard from 'vcf';
 import 'hotscript';
 
 declare function attachment(input: string | Buffer, options?: {
@@ -9,6 +10,49 @@ declare function attachment(input: string | Buffer, options?: {
     name?: string;
 }): ContentBuilder;
 
+/**
+ * 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.
+ */
+declare const avatarSchema: z__default.ZodObject<{
+    type: z__default.ZodLiteral<"avatar">;
+    action: z__default.ZodDiscriminatedUnion<[z__default.ZodObject<{
+        kind: z__default.ZodLiteral<"set">;
+        read: z__default.ZodFunction<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
+        mimeType: z__default.ZodString;
+    }, z__default.core.$strip>, z__default.ZodObject<{
+        kind: z__default.ZodLiteral<"clear">;
+    }, z__default.core.$strip>], "kind">;
+}, z__default.core.$strip>;
+type Avatar = z__default.infer<typeof avatarSchema>;
+type AvatarInput = PhotoInput;
+/**
+ * Build an `Avatar` content value.
+ *
+ * - `avatar("clear")` — remove the current chat avatar.
+ * - `avatar("./icon.png")` — set avatar from a filesystem path. MIME type is
+ *   inferred from the extension; override with `options.mimeType`.
+ * - `avatar(buffer, { mimeType })` — set avatar from in-memory bytes.
+ *   `options.mimeType` is required (enforced at the type level).
+ *
+ * `"clear"` is a reserved string-literal sentinel. If you have a file
+ * literally named `clear` with no extension, pass `"./clear"` or load it as a
+ * Buffer.
+ */
+declare function avatar(input: string, options?: {
+    mimeType?: string;
+}): ContentBuilder;
+declare function avatar(input: Buffer, options: {
+    mimeType: string;
+}): ContentBuilder;
+
 declare const nameSchema: z__default.ZodObject<{
     formatted: z__default.ZodOptional<z__default.ZodString>;
     first: z__default.ZodOptional<z__default.ZodString>;
@@ -130,11 +174,34 @@ declare function custom(raw: unknown): ContentBuilder;
  * them inside their `send` action and the resolved value is `undefined`
  * (no new message id is produced; the existing message mutates in place).
  *
- * Edit cannot wrap `edit`, `reply`, `reaction`, `group`, or `typing`.
+ * Edit cannot wrap `edit`, `reply`, `reaction`, `group`, `typing`, `rename`,
+ * or `avatar` content.
  */
 declare const editSchema: z__default.ZodObject<{
     type: z__default.ZodLiteral<"edit">;
     content: z__default.ZodCustom<{
+        type: "avatar";
+        action: {
+            kind: "set";
+            read: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
+            mimeType: string;
+        } | {
+            kind: "clear";
+        };
+    } | {
+        type: "text";
+        text: string;
+    } | {
+        type: "attachment";
+        name: string;
+        mimeType: string;
+        read: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
+        stream: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
+        size?: number | undefined;
+    } | {
+        type: "custom";
+        raw: unknown;
+    } | {
         type: "contact";
         user?: {
             __platform: string;
@@ -177,19 +244,6 @@ declare const editSchema: z__default.ZodObject<{
             read: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
         } | undefined;
         raw?: unknown;
-    } | {
-        type: "text";
-        text: string;
-    } | {
-        type: "attachment";
-        name: string;
-        mimeType: string;
-        read: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
-        stream: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
-        size?: number | undefined;
-    } | {
-        type: "custom";
-        raw: unknown;
     } | {
         type: "voice";
         mimeType: string;
@@ -211,10 +265,10 @@ declare const editSchema: z__default.ZodObject<{
     } | {
         type: "reaction";
         emoji: string;
-        target: Message;
+        target: Message<string, User, Space<unknown>>;
     } | {
         type: "group";
-        items: Message[];
+        items: Message<string, User, Space<unknown>>[];
     } | {
         type: "poll";
         title: string;
@@ -252,7 +306,32 @@ declare const editSchema: z__default.ZodObject<{
     } | {
         type: "typing";
         state: "start" | "stop";
+    } | {
+        type: "rename";
+        displayName: string;
     }, {
+        type: "avatar";
+        action: {
+            kind: "set";
+            read: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
+            mimeType: string;
+        } | {
+            kind: "clear";
+        };
+    } | {
+        type: "text";
+        text: string;
+    } | {
+        type: "attachment";
+        name: string;
+        mimeType: string;
+        read: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
+        stream: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
+        size?: number | undefined;
+    } | {
+        type: "custom";
+        raw: unknown;
+    } | {
         type: "contact";
         user?: {
             __platform: string;
@@ -295,19 +374,6 @@ declare const editSchema: z__default.ZodObject<{
             read: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
         } | undefined;
         raw?: unknown;
-    } | {
-        type: "text";
-        text: string;
-    } | {
-        type: "attachment";
-        name: string;
-        mimeType: string;
-        read: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
-        stream: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
-        size?: number | undefined;
-    } | {
-        type: "custom";
-        raw: unknown;
     } | {
         type: "voice";
         mimeType: string;
@@ -329,10 +395,10 @@ declare const editSchema: z__default.ZodObject<{
     } | {
         type: "reaction";
         emoji: string;
-        target: Message;
+        target: Message<string, User, Space<unknown>>;
     } | {
         type: "group";
-        items: Message[];
+        items: Message<string, User, Space<unknown>>[];
     } | {
         type: "poll";
         title: string;
@@ -370,19 +436,21 @@ declare const editSchema: z__default.ZodObject<{
     } | {
         type: "typing";
         state: "start" | "stop";
+    } | {
+        type: "rename";
+        displayName: string;
     }>;
-    target: z__default.ZodCustom<Message, Message>;
+    target: z__default.ZodCustom<Message<string, User, Space<unknown>>, Message<string, User, Space<unknown>>>;
 }, z__default.core.$strip>;
 type Edit = z__default.infer<typeof editSchema>;
 /**
  * Construct an `edit` content value rewriting `target`'s content.
  *
- * `target` is typed as `OutboundMessage` because only messages you sent can
- * be edited; the schema field stays loose at `Message` (matching
- * reply/reaction) so providers receive the same shape regardless of
- * direction.
+ * Only outbound messages (those sent by the agent) can be edited; calling
+ * this with an inbound target throws at build time so the misuse surfaces
+ * before the send pipeline runs.
  */
-declare function edit(content: ContentInput, target: OutboundMessage): ContentBuilder;
+declare function edit(content: ContentInput, target: Message): ContentBuilder;
 
 /**
  * A `group` bundles multiple messages into one logical unit (e.g. an album
@@ -395,7 +463,7 @@ declare function edit(content: ContentInput, target: OutboundMessage): ContentBu
  */
 declare const groupSchema: z__default.ZodObject<{
     type: z__default.ZodLiteral<"group">;
-    items: z__default.ZodArray<z__default.ZodCustom<Message, Message>>;
+    items: z__default.ZodArray<z__default.ZodCustom<Message<string, User, Space<unknown>>, Message<string, User, Space<unknown>>>>;
 }, z__default.core.$strip>;
 type Group = z__default.infer<typeof groupSchema>;
 declare function group(...items: [ContentInput, ContentInput, ...ContentInput[]]): ContentBuilder;
@@ -438,21 +506,41 @@ declare function poll(title: string, ...options: PollChoiceInput[]): ContentBuil
 declare const reactionSchema: z__default.ZodObject<{
     type: z__default.ZodLiteral<"reaction">;
     emoji: z__default.ZodString;
-    target: z__default.ZodCustom<Message, Message>;
+    target: z__default.ZodCustom<Message<string, User, Space<unknown>>, Message<string, User, Space<unknown>>>;
 }, z__default.core.$strip>;
 type Reaction = z__default.infer<typeof reactionSchema>;
 /**
  * Construct a `reaction` content value targeting the given message.
  *
  * `space.send(reaction(emoji, message))` is sugar for `message.react(emoji)`.
- * Reactions are fire-and-forget — the returned `OutboundMessage` will be
- * `undefined` because platforms do not surface a message id for reactions.
+ * Reactions are fire-and-forget — the returned `Message` will be `undefined`
+ * because platforms do not surface a message id for reactions.
  *
  * To react to a message known only by id, resolve it first via
  * `space.getMessage(id)`.
  */
 declare function reaction(emoji: string, target: Message): ContentBuilder;
 
+/**
+ * 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.
+ */
+declare const renameSchema: z__default.ZodObject<{
+    type: z__default.ZodLiteral<"rename">;
+    displayName: z__default.ZodString;
+}, z__default.core.$strip>;
+type Rename = z__default.infer<typeof renameSchema>;
+declare function rename(displayName: string): ContentBuilder;
+
 /**
  * A `reply` wraps inner content with the message it replies to.
  *
@@ -460,11 +548,34 @@ declare function reaction(emoji: string, target: Message): ContentBuilder;
  * `message.reply(content)` is sugar that delegates here. Providers see
  * `reply` like any other content type and route to a threaded send.
  *
- * Reply cannot wrap `reply`, `reaction`, or `group` content.
+ * Reply cannot wrap `reply`, `edit`, `reaction`, `group`, `typing`, `rename`,
+ * or `avatar` content.
  */
 declare const replySchema: z__default.ZodObject<{
     type: z__default.ZodLiteral<"reply">;
     content: z__default.ZodCustom<{
+        type: "avatar";
+        action: {
+            kind: "set";
+            read: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
+            mimeType: string;
+        } | {
+            kind: "clear";
+        };
+    } | {
+        type: "text";
+        text: string;
+    } | {
+        type: "attachment";
+        name: string;
+        mimeType: string;
+        read: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
+        stream: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
+        size?: number | undefined;
+    } | {
+        type: "custom";
+        raw: unknown;
+    } | {
         type: "contact";
         user?: {
             __platform: string;
@@ -507,19 +618,6 @@ declare const replySchema: z__default.ZodObject<{
             read: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
         } | undefined;
         raw?: unknown;
-    } | {
-        type: "text";
-        text: string;
-    } | {
-        type: "attachment";
-        name: string;
-        mimeType: string;
-        read: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
-        stream: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
-        size?: number | undefined;
-    } | {
-        type: "custom";
-        raw: unknown;
     } | {
         type: "voice";
         mimeType: string;
@@ -541,10 +639,10 @@ declare const replySchema: z__default.ZodObject<{
     } | {
         type: "reaction";
         emoji: string;
-        target: Message;
+        target: Message<string, User, Space<unknown>>;
     } | {
         type: "group";
-        items: Message[];
+        items: Message<string, User, Space<unknown>>[];
     } | {
         type: "poll";
         title: string;
@@ -582,7 +680,32 @@ declare const replySchema: z__default.ZodObject<{
     } | {
         type: "typing";
         state: "start" | "stop";
+    } | {
+        type: "rename";
+        displayName: string;
     }, {
+        type: "avatar";
+        action: {
+            kind: "set";
+            read: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
+            mimeType: string;
+        } | {
+            kind: "clear";
+        };
+    } | {
+        type: "text";
+        text: string;
+    } | {
+        type: "attachment";
+        name: string;
+        mimeType: string;
+        read: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
+        stream: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
+        size?: number | undefined;
+    } | {
+        type: "custom";
+        raw: unknown;
+    } | {
         type: "contact";
         user?: {
             __platform: string;
@@ -625,19 +748,6 @@ declare const replySchema: z__default.ZodObject<{
             read: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
         } | undefined;
         raw?: unknown;
-    } | {
-        type: "text";
-        text: string;
-    } | {
-        type: "attachment";
-        name: string;
-        mimeType: string;
-        read: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
-        stream: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
-        size?: number | undefined;
-    } | {
-        type: "custom";
-        raw: unknown;
     } | {
         type: "voice";
         mimeType: string;
@@ -659,10 +769,10 @@ declare const replySchema: z__default.ZodObject<{
     } | {
         type: "reaction";
         emoji: string;
-        target: Message;
+        target: Message<string, User, Space<unknown>>;
     } | {
         type: "group";
-        items: Message[];
+        items: Message<string, User, Space<unknown>>[];
     } | {
         type: "poll";
         title: string;
@@ -700,8 +810,11 @@ declare const replySchema: z__default.ZodObject<{
     } | {
         type: "typing";
         state: "start" | "stop";
+    } | {
+        type: "rename";
+        displayName: string;
     }>;
-    target: z__default.ZodCustom<Message, Message>;
+    target: z__default.ZodCustom<Message<string, User, Space<unknown>>, Message<string, User, Space<unknown>>>;
 }, z__default.core.$strip>;
 type Reply = z__default.infer<typeof replySchema>;
 declare function reply(content: ContentInput, target: Message): ContentBuilder;
@@ -2698,7 +2811,7 @@ declare function definePlatform<_Name extends string, _ConfigSchema extends z__d
     id: string;
 }, _MessageSchema extends z__default.ZodType<object> | undefined = undefined, _MessageType extends ProviderMessage<_ResolvedUser, _ResolvedSpace, _MessageSchema extends z__default.ZodType<object> ? z__default.infer<_MessageSchema> : Record<never, never>> = ProviderMessage<_ResolvedUser, _ResolvedSpace, _MessageSchema extends z__default.ZodType<object> ? z__default.infer<_MessageSchema> : Record<never, never>>, _Events extends (Record<string, EventProducer<unknown, _Client, z__default.infer<_ConfigSchema>>> & {
     messages?: never;
-}) | undefined = undefined, _Static extends Record<string, unknown> = Record<never, never>>(name: _Name, def: {
+}) | undefined = undefined, _Static extends Record<string, unknown> = Record<never, never>, _SpaceActions extends Record<string, SpaceActionFn> = Record<never, never>, _MessageActions extends Record<string, MessageActionFn> = Record<never, never>>(name: _Name, def: {
     lifecycle: {
         createClient: (ctx: CreateClientContext<_ConfigSchema>) => Promise<_Client>;
         destroyClient?: (ctx: {
@@ -2706,16 +2819,16 @@ declare function definePlatform<_Name extends string, _ConfigSchema extends z__d
             store: Store;
         }) => Promise<void>;
     };
-} & Omit<PlatformDef<_Name, _ConfigSchema, _UserSchema, _SpaceSchema, _SpaceParamsSchema, _Client, _ResolvedUser, _ResolvedSpace, _MessageSchema, _MessageType, _Events>, "lifecycle" | "name"> & {
+} & Omit<PlatformDef<_Name, _ConfigSchema, _UserSchema, _SpaceSchema, _SpaceParamsSchema, _Client, _ResolvedUser, _ResolvedSpace, _MessageSchema, _MessageType, _Events, _SpaceActions, _MessageActions>, "lifecycle" | "name"> & {
     static?: _Static;
-}): Platform<PlatformDef<_Name, _ConfigSchema, _UserSchema, _SpaceSchema, _SpaceParamsSchema, _Client, _ResolvedUser, _ResolvedSpace, _MessageSchema, _MessageType, _Events>> & Readonly<_Static>;
+}): Platform<PlatformDef<_Name, _ConfigSchema, _UserSchema, _SpaceSchema, _SpaceParamsSchema, _Client, _ResolvedUser, _ResolvedSpace, _MessageSchema, _MessageType, _Events, _SpaceActions, _MessageActions>> & Readonly<_Static>;
 
 type SpectrumInstance<Providers extends PlatformProviderConfig[] = PlatformProviderConfig[]> = SpectrumLike<Providers> & CustomEventStreams<Providers> & {
-    readonly messages: AsyncIterable<[Space, InboundMessage]>;
+    readonly messages: AsyncIterable<[Space, Message]>;
     stop(): Promise<void>;
-    send(space: Space, content: ContentInput): Promise<OutboundMessage | undefined>;
-    send(space: Space, ...content: [ContentInput, ContentInput, ...ContentInput[]]): Promise<OutboundMessage[]>;
-    edit(message: OutboundMessage, newContent: ContentInput): Promise<void>;
+    send(space: Space, content: ContentInput): Promise<Message<string, AgentSender> | undefined>;
+    send(space: Space, ...content: [ContentInput, ContentInput, ...ContentInput[]]): Promise<Message<string, AgentSender>[]>;
+    edit(message: Message, newContent: ContentInput): Promise<void>;
     responding<T>(space: Space, fn: () => T | Promise<T>): Promise<T>;
 };
 /**
@@ -2765,7 +2878,7 @@ interface DedicatedTokenData {
     type: "dedicated";
 }
 type TokenData = SharedTokenData | DedicatedTokenData;
-type CloudPlatform = "imessage" | "whatsapp_business";
+type CloudPlatform = "imessage" | "whatsapp_business" | "slack";
 interface PlatformStatus {
     enabled: boolean;
 }
@@ -2778,6 +2891,17 @@ interface WhatsappBusinessTokenData {
     expiresIn: number;
     numbers: Record<string, string | null>;
 }
+interface SlackTeamMeta {
+    appId: string;
+    botUserId: string;
+    grantedScopes: string[];
+    teamName: string;
+}
+interface SlackTokenData {
+    auth: Record<string, string>;
+    expiresIn: number;
+    teams: Record<string, SlackTeamMeta>;
+}
 declare class SpectrumCloudError extends Error {
     readonly status: number;
     readonly code: string;
@@ -2788,6 +2912,7 @@ declare const cloud: {
     issueImessageTokens: (projectId: string, projectSecret: string) => Promise<TokenData>;
     getImessageInfo: (projectId: string) => Promise<ImessageInfoData>;
     issueWhatsappBusinessTokens: (projectId: string, projectSecret: string) => Promise<WhatsappBusinessTokenData>;
+    issueSlackTokens: (projectId: string, projectSecret: string) => Promise<SlackTokenData>;
     getPlatforms: (projectId: string) => Promise<PlatformsData>;
     togglePlatform: (projectId: string, projectSecret: string, platform: CloudPlatform, enabled: boolean) => Promise<PlatformsData>;
 };
@@ -2815,4 +2940,4 @@ declare class UnsupportedError extends Error {
 declare const fromVCard: (vcf: string) => ContactInput;
 declare const toVCard: (contact: Contact) => Promise<string>;
 
-export { type CloudPlatform, type Contact, type ContactAddress, type ContactDetails, type ContactEmail, type ContactInput, type ContactName, type ContactOrg, type ContactPhone, Content, ContentBuilder, ContentInput, type DedicatedTokenData, type Edit, Emoji, type EmojiKey, EventProducer, type Group, type ImessageInfoData, Message, Platform, PlatformDef, PlatformProviderConfig, type PlatformStatus, type PlatformsData, type Poll, type PollChoice, type PollChoiceInput, type PollOption, type Reaction, type Reply, type Richlink, type SharedTokenData, Space, Spectrum, SpectrumCloudError, type SpectrumInstance, type SubscriptionData, type SubscriptionStatus, type TokenData, type Typing, UnsupportedError, type UnsupportedKind, User, type Voice, attachment, cloud, contact, custom, definePlatform, edit, fromVCard, group, option, poll, reaction, reply, resolveContents, richlink, text, toVCard, typing, voice };
+export { AgentSender, type Avatar, type AvatarInput, type CloudPlatform, type Contact, type ContactAddress, type ContactDetails, type ContactEmail, type ContactInput, type ContactName, type ContactOrg, type ContactPhone, Content, ContentBuilder, ContentInput, type DedicatedTokenData, type Edit, Emoji, type EmojiKey, EventProducer, type Group, type ImessageInfoData, Message, Platform, PlatformDef, PlatformProviderConfig, type PlatformStatus, type PlatformsData, type Poll, type PollChoice, type PollChoiceInput, type PollOption, type Reaction, type Rename, type Reply, type Richlink, type SharedTokenData, type SlackTeamMeta, type SlackTokenData, Space, Spectrum, SpectrumCloudError, type SpectrumInstance, type SubscriptionData, type SubscriptionStatus, type TokenData, type Typing, UnsupportedError, type UnsupportedKind, User, type Voice, attachment, avatar, cloud, contact, custom, definePlatform, edit, fromVCard, group, option, poll, reaction, rename, reply, resolveContents, richlink, text, toVCard, typing, voice };

package/dist/index.js

@@ -1,38 +1,44 @@
 import {
   group,
   richlink
-} from "./chunk-5NHNMN4H.js";
+} from "./chunk-UFJZIZDO.js";
 import {
   voice
-} from "./chunk-TN54TDTQ.js";
+} from "./chunk-4TXLNBGE.js";
+import {
+  option,
+  poll
+} from "./chunk-KO67KDBD.js";
 import {
   SpectrumCloudError,
   broadcast,
   cloud,
   mergeStreams,
-  option,
-  poll,
   stream
-} from "./chunk-HWADNTQF.js";
+} from "./chunk-YKWKZ2PZ.js";
+import {
+  contact,
+  fromVCard,
+  toVCard
+} from "./chunk-L3VXHUVY.js";
 import {
   UnsupportedError,
   attachment,
+  avatar,
   buildSpace,
-  contact,
   contentAttrs,
   custom,
   definePlatform,
   edit,
-  fromVCard,
   reaction,
+  rename,
   reply,
   resolveContents,
   senderAttrs,
   text,
-  toVCard,
   typing,
   wrapProviderMessage
-} from "./chunk-XZSBR26X.js";
+} from "./chunk-YDHES53X.js";
 
 // src/emoji/generated.ts
 var GeneratedEmoji = {
@@ -2385,6 +2391,7 @@ export {
   SpectrumCloudError,
   UnsupportedError,
   attachment,
+  avatar,
   broadcast,
   cloud,
   contact,
@@ -2397,6 +2404,7 @@ export {
   option,
   poll,
   reaction,
+  rename,
   reply,
   resolveContents,
   richlink,

package/dist/photo-content-BQF42prd.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Shared building blocks for photo-style content (chat background, group
+ * avatar/icon, …) whose builders all share the same `set | clear` shape and
+ * the same `"clear"` reserved-string sentinel.
+ *
+ * Keeping the action schema and `buildPhotoAction` factory here means both
+ * `background()` and `avatar()` parse against the same structural definition
+ * and any DX fix (mime inference, read caching, sentinel docs) lands once.
+ */
+declare const CLEAR_SENTINEL: "clear";
+type PhotoInput = typeof CLEAR_SENTINEL | string | Buffer;
+
+export type { PhotoInput as P };