spectrum-ts 1.5.0 → 1.7.2

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { e as ContentBuilder, U as User, M as Message, C as ContentInput, f as Content, b as ProviderMessage, E as EventProducer, g as CreateClientContext, S as Store, a as PlatformDef, P as Platform, h as PlatformProviderConfig, i as SpectrumLike, j as CustomEventStreams, k as Space, I as InboundMessage, O as OutboundMessage } from './types-D0QSU6kb.js';
-export { A as AnyPlatformDef, B as Broadcaster, l as InboundPlatformMessage, d as ManagedStream, m as PlatformInstance, n as PlatformMessage, o as PlatformRuntime, p as PlatformSpace, q as PlatformUser, c as SchemaMessage, r as broadcast, s as mergeStreams, t as stream } from './types-D0QSU6kb.js';
+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 z__default from 'zod';
 import 'hotscript';
@@ -121,6 +121,269 @@ declare function contact(input: string | ContactInput | vCard): ContentBuilder;
 
 declare function custom(raw: unknown): ContentBuilder;
 
+/**
+ * An `edit` rewrites the content of a previously-sent outbound message.
+ *
+ * `space.send(edit(newContent, message))` is the canonical outbound API;
+ * `message.edit(newContent)` and `space.edit(message, newContent)` are
+ * sugar that delegate here. Edits are fire-and-forget — providers handle
+ * 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`.
+ */
+declare const editSchema: z__default.ZodObject<{
+    type: z__default.ZodLiteral<"edit">;
+    content: z__default.ZodCustom<{
+        type: "contact";
+        user?: {
+            __platform: string;
+            id: string;
+        } | undefined;
+        name?: {
+            formatted?: string | undefined;
+            first?: string | undefined;
+            last?: string | undefined;
+            middle?: string | undefined;
+            prefix?: string | undefined;
+            suffix?: string | undefined;
+        } | undefined;
+        phones?: {
+            value: string;
+            type?: "mobile" | "home" | "work" | "other" | undefined;
+        }[] | undefined;
+        emails?: {
+            value: string;
+            type?: "home" | "work" | "other" | undefined;
+        }[] | undefined;
+        addresses?: {
+            street?: string | undefined;
+            city?: string | undefined;
+            region?: string | undefined;
+            postalCode?: string | undefined;
+            country?: string | undefined;
+            type?: "home" | "work" | "other" | undefined;
+        }[] | undefined;
+        org?: {
+            name?: string | undefined;
+            title?: string | undefined;
+            department?: string | undefined;
+        } | undefined;
+        urls?: string[] | undefined;
+        birthday?: string | undefined;
+        note?: string | undefined;
+        photo?: {
+            mimeType: string;
+            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;
+        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>>>>;
+        name?: string | undefined;
+        duration?: number | undefined;
+        size?: number | undefined;
+    } | {
+        type: "richlink";
+        url: string;
+        title: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodOptional<z__default.ZodString>>>;
+        summary: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodOptional<z__default.ZodString>>>;
+        cover: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodOptional<z__default.ZodObject<{
+            mimeType: z__default.ZodOptional<z__default.ZodString>;
+            read: z__default.ZodFunction<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
+            stream: z__default.ZodFunction<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
+        }, z__default.core.$strip>>>>;
+    } | {
+        type: "reaction";
+        emoji: string;
+        target: Message;
+    } | {
+        type: "group";
+        items: Message[];
+    } | {
+        type: "poll";
+        title: string;
+        options: {
+            title: string;
+        }[];
+    } | {
+        type: "poll_option";
+        option: {
+            title: string;
+        };
+        poll: {
+            type: "poll";
+            title: string;
+            options: {
+                title: string;
+            }[];
+        };
+        selected: boolean;
+        title: string;
+    } | {
+        type: "effect";
+        content: {
+            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;
+        };
+        effect: string;
+    } | {
+        type: "typing";
+        state: "start" | "stop";
+    }, {
+        type: "contact";
+        user?: {
+            __platform: string;
+            id: string;
+        } | undefined;
+        name?: {
+            formatted?: string | undefined;
+            first?: string | undefined;
+            last?: string | undefined;
+            middle?: string | undefined;
+            prefix?: string | undefined;
+            suffix?: string | undefined;
+        } | undefined;
+        phones?: {
+            value: string;
+            type?: "mobile" | "home" | "work" | "other" | undefined;
+        }[] | undefined;
+        emails?: {
+            value: string;
+            type?: "home" | "work" | "other" | undefined;
+        }[] | undefined;
+        addresses?: {
+            street?: string | undefined;
+            city?: string | undefined;
+            region?: string | undefined;
+            postalCode?: string | undefined;
+            country?: string | undefined;
+            type?: "home" | "work" | "other" | undefined;
+        }[] | undefined;
+        org?: {
+            name?: string | undefined;
+            title?: string | undefined;
+            department?: string | undefined;
+        } | undefined;
+        urls?: string[] | undefined;
+        birthday?: string | undefined;
+        note?: string | undefined;
+        photo?: {
+            mimeType: string;
+            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;
+        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>>>>;
+        name?: string | undefined;
+        duration?: number | undefined;
+        size?: number | undefined;
+    } | {
+        type: "richlink";
+        url: string;
+        title: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodOptional<z__default.ZodString>>>;
+        summary: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodOptional<z__default.ZodString>>>;
+        cover: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodOptional<z__default.ZodObject<{
+            mimeType: z__default.ZodOptional<z__default.ZodString>;
+            read: z__default.ZodFunction<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
+            stream: z__default.ZodFunction<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
+        }, z__default.core.$strip>>>>;
+    } | {
+        type: "reaction";
+        emoji: string;
+        target: Message;
+    } | {
+        type: "group";
+        items: Message[];
+    } | {
+        type: "poll";
+        title: string;
+        options: {
+            title: string;
+        }[];
+    } | {
+        type: "poll_option";
+        option: {
+            title: string;
+        };
+        poll: {
+            type: "poll";
+            title: string;
+            options: {
+                title: string;
+            }[];
+        };
+        selected: boolean;
+        title: string;
+    } | {
+        type: "effect";
+        content: {
+            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;
+        };
+        effect: string;
+    } | {
+        type: "typing";
+        state: "start" | "stop";
+    }>;
+    target: z__default.ZodCustom<Message, Message>;
+}, 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.
+ */
+declare function edit(content: ContentInput, target: OutboundMessage): ContentBuilder;
+
 /**
  * A `group` bundles multiple messages into one logical unit (e.g. an album
  * of images sent together). Each item is a full `Message` — addressable by
@@ -190,6 +453,259 @@ type Reaction = z__default.infer<typeof reactionSchema>;
  */
 declare function reaction(emoji: string, target: Message): ContentBuilder;
 
+/**
+ * A `reply` wraps inner content with the message it replies to.
+ *
+ * `space.send(reply(content, message))` is the canonical outbound API;
+ * `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.
+ */
+declare const replySchema: z__default.ZodObject<{
+    type: z__default.ZodLiteral<"reply">;
+    content: z__default.ZodCustom<{
+        type: "contact";
+        user?: {
+            __platform: string;
+            id: string;
+        } | undefined;
+        name?: {
+            formatted?: string | undefined;
+            first?: string | undefined;
+            last?: string | undefined;
+            middle?: string | undefined;
+            prefix?: string | undefined;
+            suffix?: string | undefined;
+        } | undefined;
+        phones?: {
+            value: string;
+            type?: "mobile" | "home" | "work" | "other" | undefined;
+        }[] | undefined;
+        emails?: {
+            value: string;
+            type?: "home" | "work" | "other" | undefined;
+        }[] | undefined;
+        addresses?: {
+            street?: string | undefined;
+            city?: string | undefined;
+            region?: string | undefined;
+            postalCode?: string | undefined;
+            country?: string | undefined;
+            type?: "home" | "work" | "other" | undefined;
+        }[] | undefined;
+        org?: {
+            name?: string | undefined;
+            title?: string | undefined;
+            department?: string | undefined;
+        } | undefined;
+        urls?: string[] | undefined;
+        birthday?: string | undefined;
+        note?: string | undefined;
+        photo?: {
+            mimeType: string;
+            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;
+        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>>>>;
+        name?: string | undefined;
+        duration?: number | undefined;
+        size?: number | undefined;
+    } | {
+        type: "richlink";
+        url: string;
+        title: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodOptional<z__default.ZodString>>>;
+        summary: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodOptional<z__default.ZodString>>>;
+        cover: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodOptional<z__default.ZodObject<{
+            mimeType: z__default.ZodOptional<z__default.ZodString>;
+            read: z__default.ZodFunction<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
+            stream: z__default.ZodFunction<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
+        }, z__default.core.$strip>>>>;
+    } | {
+        type: "reaction";
+        emoji: string;
+        target: Message;
+    } | {
+        type: "group";
+        items: Message[];
+    } | {
+        type: "poll";
+        title: string;
+        options: {
+            title: string;
+        }[];
+    } | {
+        type: "poll_option";
+        option: {
+            title: string;
+        };
+        poll: {
+            type: "poll";
+            title: string;
+            options: {
+                title: string;
+            }[];
+        };
+        selected: boolean;
+        title: string;
+    } | {
+        type: "effect";
+        content: {
+            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;
+        };
+        effect: string;
+    } | {
+        type: "typing";
+        state: "start" | "stop";
+    }, {
+        type: "contact";
+        user?: {
+            __platform: string;
+            id: string;
+        } | undefined;
+        name?: {
+            formatted?: string | undefined;
+            first?: string | undefined;
+            last?: string | undefined;
+            middle?: string | undefined;
+            prefix?: string | undefined;
+            suffix?: string | undefined;
+        } | undefined;
+        phones?: {
+            value: string;
+            type?: "mobile" | "home" | "work" | "other" | undefined;
+        }[] | undefined;
+        emails?: {
+            value: string;
+            type?: "home" | "work" | "other" | undefined;
+        }[] | undefined;
+        addresses?: {
+            street?: string | undefined;
+            city?: string | undefined;
+            region?: string | undefined;
+            postalCode?: string | undefined;
+            country?: string | undefined;
+            type?: "home" | "work" | "other" | undefined;
+        }[] | undefined;
+        org?: {
+            name?: string | undefined;
+            title?: string | undefined;
+            department?: string | undefined;
+        } | undefined;
+        urls?: string[] | undefined;
+        birthday?: string | undefined;
+        note?: string | undefined;
+        photo?: {
+            mimeType: string;
+            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;
+        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>>>>;
+        name?: string | undefined;
+        duration?: number | undefined;
+        size?: number | undefined;
+    } | {
+        type: "richlink";
+        url: string;
+        title: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodOptional<z__default.ZodString>>>;
+        summary: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodOptional<z__default.ZodString>>>;
+        cover: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodOptional<z__default.ZodObject<{
+            mimeType: z__default.ZodOptional<z__default.ZodString>;
+            read: z__default.ZodFunction<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
+            stream: z__default.ZodFunction<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
+        }, z__default.core.$strip>>>>;
+    } | {
+        type: "reaction";
+        emoji: string;
+        target: Message;
+    } | {
+        type: "group";
+        items: Message[];
+    } | {
+        type: "poll";
+        title: string;
+        options: {
+            title: string;
+        }[];
+    } | {
+        type: "poll_option";
+        option: {
+            title: string;
+        };
+        poll: {
+            type: "poll";
+            title: string;
+            options: {
+                title: string;
+            }[];
+        };
+        selected: boolean;
+        title: string;
+    } | {
+        type: "effect";
+        content: {
+            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;
+        };
+        effect: string;
+    } | {
+        type: "typing";
+        state: "start" | "stop";
+    }>;
+    target: z__default.ZodCustom<Message, Message>;
+}, z__default.core.$strip>;
+type Reply = z__default.infer<typeof replySchema>;
+declare function reply(content: ContentInput, target: Message): ContentBuilder;
+
 declare const resolveContents: (items: readonly ContentInput[]) => Promise<Content[]>;
 
 declare const richlinkSchema: z__default.ZodObject<{
@@ -208,6 +724,33 @@ declare function richlink(url: string): ContentBuilder;
 
 declare function text(text: string): ContentBuilder;
 
+/**
+ * A `typing` content value carries a typing-indicator signal — either
+ * `"start"` or `"stop"`. Like `reaction`, it's fire-and-forget: providers
+ * dispatch on `content.type === "typing"` inside their `send()` action and
+ * `space.send(typing(...))` resolves to `undefined`.
+ *
+ * `space.startTyping()` / `space.stopTyping()` / `space.responding()` are
+ * sugar over `space.send(typing("start" | "stop"))`. Platforms that have no
+ * typing-indicator API (e.g. WhatsApp Business) silently no-op so the
+ * signal is best-effort everywhere.
+ */
+declare const typingSchema: z__default.ZodObject<{
+    type: z__default.ZodLiteral<"typing">;
+    state: z__default.ZodEnum<{
+        start: "start";
+        stop: "stop";
+    }>;
+}, z__default.core.$strip>;
+type Typing = z__default.infer<typeof typingSchema>;
+/**
+ * Construct a `typing` content value. Defaults to `"start"`.
+ *
+ * `space.send(typing())` is equivalent to `space.startTyping()`;
+ * `space.send(typing("stop"))` is equivalent to `space.stopTyping()`.
+ */
+declare function typing(state?: "start" | "stop"): ContentBuilder;
+
 declare const voiceSchema: z__default.ZodObject<{
     type: z__default.ZodLiteral<"voice">;
     name: z__default.ZodOptional<z__default.ZodString>;
@@ -2153,11 +2696,9 @@ declare function definePlatform<_Name extends string, _ConfigSchema extends z__d
     id: string;
 }, _ResolvedSpace extends {
     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 {
-    messages: EventProducer<_MessageType, _Client, z__default.infer<_ConfigSchema>>;
-} = {
-    messages: EventProducer<_MessageType, _Client, z__default.infer<_ConfigSchema>>;
-}, _Static extends Record<string, unknown> = Record<never, never>>(name: _Name, def: {
+}, _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: {
     lifecycle: {
         createClient: (ctx: CreateClientContext<_ConfigSchema>) => Promise<_Client>;
         destroyClient?: (ctx: {
@@ -2272,4 +2813,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, 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 Richlink, type SharedTokenData, Space, Spectrum, SpectrumCloudError, type SpectrumInstance, type SubscriptionData, type SubscriptionStatus, type TokenData, UnsupportedError, type UnsupportedKind, User, type Voice, attachment, cloud, contact, custom, definePlatform, fromVCard, group, option, poll, reaction, resolveContents, richlink, text, toVCard, voice };
+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 };