spectrum-ts 2.0.0 → 3.0.0

package/dist/{attachment-B4nSrKVd.d.ts → attachment-WePAHfcH.d.ts}

@@ -1,5 +1,5 @@
 import z__default from 'zod';
-import { C as ContentBuilder } from './types-Bje8aq1k.js';
+import { C as ContentBuilder } from './types-YqCNUDIt.js';
 
 declare const attachmentSchema: z__default.ZodObject<{
     type: z__default.ZodLiteral<"attachment">;

package/dist/{authoring-BjE5BvlO.d.ts → authoring-DDh3muGT.d.ts}

@@ -1,7 +1,7 @@
-import './attachment-B4nSrKVd.js';
+import './attachment-WePAHfcH.js';
 import vCard from 'vcf';
 import z__default from 'zod';
-import { U as User, C as ContentBuilder, M as Message, e as Space, h as ContentInput } from './types-Bje8aq1k.js';
+import { U as User, C as ContentBuilder, M as Message, e as Space, h as ContentInput } from './types-YqCNUDIt.js';
 
 declare const nameSchema: z__default.ZodObject<{
     formatted: z__default.ZodOptional<z__default.ZodString>;
@@ -140,6 +140,43 @@ declare const asGroup: (input: {
 }) => Group;
 declare function group(...items: [ContentInput, ContentInput, ...ContentInput[]]): ContentBuilder;
 
+/**
+ * Maps one chunk emitted by a stream to the incremental text it carries.
+ * Return a string to emit, or `null`/`undefined` to skip the chunk (e.g. for
+ * control events that carry no text).
+ */
+type DeltaExtractor<T> = (chunk: T) => string | null | undefined;
+/**
+ * Anything the stream overloads of `text()` and `markdown()` accept as a
+ * source. The builder normalizes all of these to an internal
+ * `AsyncIterable<string>` of text deltas:
+ *
+ * - the Vercel AI SDK `streamText()` result (its `.textStream` is picked up
+ *   automatically — pass either the whole result or `.textStream` directly),
+ * - a raw `AsyncIterable<T>` (e.g. an OpenAI / Anthropic streaming response),
+ * - a raw `ReadableStream<T>` of chunks.
+ */
+type StreamTextSource<T = unknown> = {
+    textStream: AsyncIterable<string> | ReadableStream<string>;
+} | AsyncIterable<T> | ReadableStream<T>;
+interface TextStreamOptions<T = unknown> {
+    /**
+     * Map each chunk to its incremental text. Omit to rely on built-in
+     * auto-detection of the common SDK shapes (OpenAI chat/responses, Anthropic
+     * messages, AI SDK text streams, and plain strings).
+     */
+    extract?: DeltaExtractor<T>;
+}
+declare const streamTextSchema: z__default.ZodObject<{
+    type: z__default.ZodLiteral<"streamText">;
+    stream: z__default.ZodCustom<() => AsyncIterable<string>, () => AsyncIterable<string>>;
+    format: z__default.ZodOptional<z__default.ZodEnum<{
+        markdown: "markdown";
+        plain: "plain";
+    }>>;
+}, z__default.core.$strip>;
+type StreamText = z__default.infer<typeof streamTextSchema>;
+
 declare const pollChoiceSchema: z__default.ZodObject<{
     title: z__default.ZodString;
 }, z__default.core.$strip>;
@@ -185,28 +222,6 @@ declare const option: (title: string) => PollChoice;
 declare function poll(title: string, options: PollChoiceInput[]): ContentBuilder;
 declare function poll(title: string, ...options: PollChoiceInput[]): ContentBuilder;
 
-declare const reactionSchema: z__default.ZodObject<{
-    type: z__default.ZodLiteral<"reaction">;
-    emoji: z__default.ZodString;
-    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>;
-declare const asReaction: (input: {
-    emoji: string;
-    target: Message;
-}) => Reaction;
-/**
- * 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 `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;
-
 declare const richlinkSchema: z__default.ZodObject<{
     type: z__default.ZodLiteral<"richlink">;
     url: z__default.ZodURL;
@@ -239,7 +254,27 @@ declare const textSchema: z__default.ZodObject<{
     text: z__default.ZodString;
 }, z__default.core.$strip>;
 declare const asText: (text: string) => z__default.infer<typeof textSchema>;
-declare function text(text: string): ContentBuilder;
+/**
+ * Send plain text — a static string or a streaming LLM response.
+ *
+ * `text("hi")` sends one message. `text(source)` wraps a text stream so it
+ * can be sent like any other content; delivery is platform-specific —
+ * iMessage (remote) sends the first chunk as a real message and then edits it
+ * in place as more text arrives; Telegram (private chats) animates a native
+ * draft preview and persists the final text as one message. Platforms that
+ * can't stream wait for the stream to finish and deliver the accumulated text
+ * as one plain message.
+ *
+ * A stream source accepts whatever the popular SDKs return (the AI SDK
+ * `streamText()` result, OpenAI / Anthropic streaming responses, or any
+ * `AsyncIterable` / `ReadableStream`); pass `options.extract` for any chunk
+ * shape the built-in detection doesn't recognize. A stream can only be sent
+ * once. Options apply to stream sources only — they are ignored for strings.
+ *
+ * For text written in markdown, use `markdown()` instead.
+ */
+declare function text(source: string): ContentBuilder;
+declare function text<T = unknown>(source: StreamTextSource<T>, options?: TextStreamOptions<T>): ContentBuilder;
 
 declare const voiceSchema: z__default.ZodObject<{
     type: z__default.ZodLiteral<"voice">;
@@ -266,4 +301,4 @@ declare function voice(input: VoiceInput, options?: {
     duration?: number;
 }): ContentBuilder;
 
-export { asRichlink as A, asText as B, type ContactInput as C, asVoice as D, type Group as G, type Poll as P, type Reaction as R, type Voice as V, type Contact as a, type ContactAddress as b, type ContactDetails as c, type ContactEmail as d, type ContactName as e, type ContactOrg as f, type ContactPhone as g, type PollChoice as h, type PollChoiceInput as i, type PollOption as j, type Richlink as k, contact as l, custom as m, group as n, option as o, poll as p, richlink as q, reaction as r, asContact as s, text as t, asCustom as u, voice as v, asGroup as w, asPoll as x, asPollOption as y, asReaction as z };
+export { asVoice as A, type ContactInput as C, type DeltaExtractor as D, type Group as G, type Poll as P, type Richlink as R, type StreamTextSource as S, type TextStreamOptions as T, type Voice as V, type Contact as a, type ContactAddress as b, type ContactDetails as c, type ContactEmail as d, type ContactName as e, type ContactOrg as f, type ContactPhone as g, type PollChoice as h, type PollChoiceInput as i, type PollOption as j, type StreamText as k, contact as l, custom as m, group as n, option as o, poll as p, asContact as q, richlink as r, asCustom as s, text as t, asGroup as u, voice as v, asPoll as w, asPollOption as x, asRichlink as y, asText as z };

package/dist/authoring.d.ts

@@ -1,6 +1,6 @@
-export { c as asAttachment } from './attachment-B4nSrKVd.js';
-export { s as asContact, u as asCustom, w as asGroup, x as asPoll, y as asPollOption, z as asReaction, A as asRichlink, B as asText, D as asVoice } from './authoring-BjE5BvlO.js';
-export { d as ProviderMessageRecord } from './types-Bje8aq1k.js';
+export { c as asAttachment } from './attachment-WePAHfcH.js';
+export { q as asContact, s as asCustom, u as asGroup, w as asPoll, x as asPollOption, y as asRichlink, z as asText, A as asVoice } from './authoring-DDh3muGT.js';
+export { d as ProviderMessageRecord, $ as asReaction } from './types-YqCNUDIt.js';
 import 'zod';
 import 'vcf';
 import 'hotscript';

package/dist/authoring.js

@@ -1,27 +1,27 @@
 import { createRequire as __spectrumCreateRequire } from "node:module"; const require = __spectrumCreateRequire(import.meta.url);
 import {
   asRichlink
-} from "./chunk-6BI4PFTP.js";
+} from "./chunk-CHY5YLLV.js";
 import {
   asGroup
-} from "./chunk-3B4QH4JG.js";
+} from "./chunk-MHGCPC2V.js";
 import {
   asVoice
-} from "./chunk-NNY6LMSC.js";
+} from "./chunk-77U6SH5A.js";
 import {
   asPoll,
   asPollOption
 } from "./chunk-2D27WW5B.js";
 import {
   asContact
-} from "./chunk-U7AWXDH6.js";
+} from "./chunk-NZ5WCMTY.js";
 import "./chunk-6UZFVXQF.js";
 import {
   asAttachment,
   asCustom,
   asReaction,
   asText
-} from "./chunk-2ILTJC35.js";
+} from "./chunk-LQMDV75O.js";
 export {
   asAttachment,
   asContact,

package/dist/{chunk-NNY6LMSC.js → chunk-77U6SH5A.js}

@@ -4,7 +4,7 @@ import {
   fetchUrlBytes,
   readSchema,
   streamSchema
-} from "./chunk-2ILTJC35.js";
+} from "./chunk-LQMDV75O.js";
 
 // src/content/voice.ts
 import { createReadStream } from "fs";