@spectrum-ts/core 12.5.0 → 12.6.0

package/dist/{attachment-DYRlQfUs.d.ts → attachment-CWfyVjJ6.d.ts}

@@ -592,14 +592,6 @@ interface Message<TPlatform extends string = string, TSender extends User = User
 declare const editSchema: z.ZodObject<{
   type: z.ZodLiteral<"edit">;
   content: z.ZodCustom<{
-    type: "attachment";
-    id: string;
-    name: string;
-    mimeType: string;
-    read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
-    stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
-    size?: number | undefined;
-  } | {
     type: "contact";
     user?: {
       __platform: string;
@@ -642,6 +634,14 @@ declare const editSchema: z.ZodObject<{
       read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
     } | undefined;
     raw?: unknown;
+  } | {
+    type: "attachment";
+    id: string;
+    name: string;
+    mimeType: string;
+    read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
+    stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
+    size?: number | undefined;
   } | {
     type: "custom";
     raw: unknown;
@@ -678,6 +678,9 @@ declare const editSchema: z.ZodObject<{
     type: "reaction";
     emoji: string;
     target: Message<string, User, Space<unknown>>;
+  } | {
+    type: "richlink";
+    url: string;
   } | {
     type: "streamText";
     stream: () => AsyncIterable<string>;
@@ -691,9 +694,6 @@ declare const editSchema: z.ZodObject<{
     name?: string | undefined;
     duration?: number | undefined;
     size?: number | undefined;
-  } | {
-    type: "richlink";
-    url: string;
   } | {
     type: "app";
     url: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodURL>>;
@@ -750,14 +750,6 @@ declare const editSchema: z.ZodObject<{
   } | {
     type: "leaveSpace";
   }, {
-    type: "attachment";
-    id: string;
-    name: string;
-    mimeType: string;
-    read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
-    stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
-    size?: number | undefined;
-  } | {
     type: "contact";
     user?: {
       __platform: string;
@@ -800,6 +792,14 @@ declare const editSchema: z.ZodObject<{
       read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
     } | undefined;
     raw?: unknown;
+  } | {
+    type: "attachment";
+    id: string;
+    name: string;
+    mimeType: string;
+    read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
+    stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
+    size?: number | undefined;
   } | {
     type: "custom";
     raw: unknown;
@@ -836,6 +836,9 @@ declare const editSchema: z.ZodObject<{
     type: "reaction";
     emoji: string;
     target: Message<string, User, Space<unknown>>;
+  } | {
+    type: "richlink";
+    url: string;
   } | {
     type: "streamText";
     stream: () => AsyncIterable<string>;
@@ -849,9 +852,6 @@ declare const editSchema: z.ZodObject<{
     name?: string | undefined;
     duration?: number | undefined;
     size?: number | undefined;
-  } | {
-    type: "richlink";
-    url: string;
   } | {
     type: "app";
     url: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodURL>>;
@@ -1138,14 +1138,6 @@ declare function rename(displayName: string): ContentBuilder;
 declare const replySchema: z.ZodObject<{
   type: z.ZodLiteral<"reply">;
   content: z.ZodCustom<{
-    type: "attachment";
-    id: string;
-    name: string;
-    mimeType: string;
-    read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
-    stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
-    size?: number | undefined;
-  } | {
     type: "contact";
     user?: {
       __platform: string;
@@ -1188,6 +1180,14 @@ declare const replySchema: z.ZodObject<{
       read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
     } | undefined;
     raw?: unknown;
+  } | {
+    type: "attachment";
+    id: string;
+    name: string;
+    mimeType: string;
+    read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
+    stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
+    size?: number | undefined;
   } | {
     type: "custom";
     raw: unknown;
@@ -1224,6 +1224,9 @@ declare const replySchema: z.ZodObject<{
     type: "reaction";
     emoji: string;
     target: Message<string, User, Space<unknown>>;
+  } | {
+    type: "richlink";
+    url: string;
   } | {
     type: "streamText";
     stream: () => AsyncIterable<string>;
@@ -1237,9 +1240,6 @@ declare const replySchema: z.ZodObject<{
     name?: string | undefined;
     duration?: number | undefined;
     size?: number | undefined;
-  } | {
-    type: "richlink";
-    url: string;
   } | {
     type: "app";
     url: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodURL>>;
@@ -1296,14 +1296,6 @@ declare const replySchema: z.ZodObject<{
   } | {
     type: "leaveSpace";
   }, {
-    type: "attachment";
-    id: string;
-    name: string;
-    mimeType: string;
-    read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
-    stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
-    size?: number | undefined;
-  } | {
     type: "contact";
     user?: {
       __platform: string;
@@ -1346,6 +1338,14 @@ declare const replySchema: z.ZodObject<{
       read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
     } | undefined;
     raw?: unknown;
+  } | {
+    type: "attachment";
+    id: string;
+    name: string;
+    mimeType: string;
+    read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
+    stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
+    size?: number | undefined;
   } | {
     type: "custom";
     raw: unknown;
@@ -1382,6 +1382,9 @@ declare const replySchema: z.ZodObject<{
     type: "reaction";
     emoji: string;
     target: Message<string, User, Space<unknown>>;
+  } | {
+    type: "richlink";
+    url: string;
   } | {
     type: "streamText";
     stream: () => AsyncIterable<string>;
@@ -1395,9 +1398,6 @@ declare const replySchema: z.ZodObject<{
     name?: string | undefined;
     duration?: number | undefined;
     size?: number | undefined;
-  } | {
-    type: "richlink";
-    url: string;
   } | {
     type: "app";
     url: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodURL>>;
@@ -6170,6 +6170,15 @@ interface ManagedStream<T> extends AsyncIterable<T> {
 }
 type StreamCleanup = void | (() => void | Promise<void>);
 declare function stream<T>(setup: (emit: (value: T) => Promise<void>, end: (error?: unknown) => void) => StreamCleanup | Promise<StreamCleanup>): ManagedStream<T>;
+/**
+ * Merges a fixed set of streams. The result represents all of them: it ends
+ * once every member has ended — immediately, for an empty set — and one
+ * member's error ends the whole merge.
+ *
+ * For a set that changes while the stream runs, use `createStreamGroup`
+ * (`@spectrum-ts/core/authoring`), which ends only on `close()` and drops a
+ * failed member instead of tearing down its siblings.
+ */
 declare function mergeStreams<T>(streams: readonly ManagedStream<T>[]): ManagedStream<T>;
 interface Broadcaster<T> {
   close(): Promise<void>;
@@ -7283,14 +7292,6 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strip>, z.ZodObject<{
   type: z.ZodLiteral<"reply">;
   content: z.ZodCustom<{
-    type: "attachment";
-    id: string;
-    name: string;
-    mimeType: string;
-    read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
-    stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
-    size?: number | undefined;
-  } | {
     type: "contact";
     user?: {
       __platform: string;
@@ -7333,6 +7334,14 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
     } | undefined;
     raw?: unknown;
+  } | {
+    type: "attachment";
+    id: string;
+    name: string;
+    mimeType: string;
+    read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
+    stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
+    size?: number | undefined;
   } | {
     type: "custom";
     raw: unknown;
@@ -7369,6 +7378,9 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: "reaction";
     emoji: string;
     target: Message<string, User, Space<unknown>>;
+  } | {
+    type: "richlink";
+    url: string;
   } | {
     type: "streamText";
     stream: () => AsyncIterable<string>;
@@ -7382,9 +7394,6 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     name?: string | undefined;
     duration?: number | undefined;
     size?: number | undefined;
-  } | {
-    type: "richlink";
-    url: string;
   } | {
     type: "app";
     url: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodURL>>;
@@ -7441,14 +7450,6 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   } | {
     type: "leaveSpace";
   }, {
-    type: "attachment";
-    id: string;
-    name: string;
-    mimeType: string;
-    read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
-    stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
-    size?: number | undefined;
-  } | {
     type: "contact";
     user?: {
       __platform: string;
@@ -7491,6 +7492,14 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
     } | undefined;
     raw?: unknown;
+  } | {
+    type: "attachment";
+    id: string;
+    name: string;
+    mimeType: string;
+    read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
+    stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
+    size?: number | undefined;
   } | {
     type: "custom";
     raw: unknown;
@@ -7527,6 +7536,9 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: "reaction";
     emoji: string;
     target: Message<string, User, Space<unknown>>;
+  } | {
+    type: "richlink";
+    url: string;
   } | {
     type: "streamText";
     stream: () => AsyncIterable<string>;
@@ -7540,9 +7552,6 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     name?: string | undefined;
     duration?: number | undefined;
     size?: number | undefined;
-  } | {
-    type: "richlink";
-    url: string;
   } | {
     type: "app";
     url: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodURL>>;
@@ -7603,14 +7612,6 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strip>, z.ZodObject<{
   type: z.ZodLiteral<"edit">;
   content: z.ZodCustom<{
-    type: "attachment";
-    id: string;
-    name: string;
-    mimeType: string;
-    read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
-    stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
-    size?: number | undefined;
-  } | {
     type: "contact";
     user?: {
       __platform: string;
@@ -7653,6 +7654,14 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
     } | undefined;
     raw?: unknown;
+  } | {
+    type: "attachment";
+    id: string;
+    name: string;
+    mimeType: string;
+    read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
+    stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
+    size?: number | undefined;
   } | {
     type: "custom";
     raw: unknown;
@@ -7689,6 +7698,9 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: "reaction";
     emoji: string;
     target: Message<string, User, Space<unknown>>;
+  } | {
+    type: "richlink";
+    url: string;
   } | {
     type: "streamText";
     stream: () => AsyncIterable<string>;
@@ -7702,9 +7714,6 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     name?: string | undefined;
     duration?: number | undefined;
     size?: number | undefined;
-  } | {
-    type: "richlink";
-    url: string;
   } | {
     type: "app";
     url: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodURL>>;
@@ -7761,14 +7770,6 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   } | {
     type: "leaveSpace";
   }, {
-    type: "attachment";
-    id: string;
-    name: string;
-    mimeType: string;
-    read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
-    stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
-    size?: number | undefined;
-  } | {
     type: "contact";
     user?: {
       __platform: string;
@@ -7811,6 +7812,14 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
     } | undefined;
     raw?: unknown;
+  } | {
+    type: "attachment";
+    id: string;
+    name: string;
+    mimeType: string;
+    read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
+    stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
+    size?: number | undefined;
   } | {
     type: "custom";
     raw: unknown;
@@ -7847,6 +7856,9 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: "reaction";
     emoji: string;
     target: Message<string, User, Space<unknown>>;
+  } | {
+    type: "richlink";
+    url: string;
   } | {
     type: "streamText";
     stream: () => AsyncIterable<string>;
@@ -7860,9 +7872,6 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     name?: string | undefined;
     duration?: number | undefined;
     size?: number | undefined;
-  } | {
-    type: "richlink";
-    url: string;
   } | {
     type: "app";
     url: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodURL>>;

package/dist/authoring.d.ts

@@ -1,4 +1,4 @@
-import { Bt as readSchema, Dt as asRichlink, Fn as asContact, Gn as buildPhotoAction, Gt as asPoll, H as ProviderMessageRecord, It as renameSchema, Kn as photoActionSchema, Kt as asPollOption, Nt as replySchema, Rt as asRead, Sn as asReaction, Tn as asCustom, U as ProviderUserRecord, Un as avatarSchema, Wn as PhotoInput, Xt as asMarkdown, _n as leaveSpaceSchema, _t as asVoice, an as groupSchema, bt as asUnsend, hn as addMemberSchema, jt as asReply, q as ManagedStream, r as asAttachment, rn as asGroup, wn as reactionSchema, wt as asText, yn as removeMemberSchema } from "./attachment-DYRlQfUs.js";
+import { Bt as readSchema, Dt as asRichlink, Fn as asContact, Gn as buildPhotoAction, Gt as asPoll, H as ProviderMessageRecord, It as renameSchema, Kn as photoActionSchema, Kt as asPollOption, Nt as replySchema, Rt as asRead, Sn as asReaction, Tn as asCustom, U as ProviderUserRecord, Un as avatarSchema, Wn as PhotoInput, Xt as asMarkdown, _n as leaveSpaceSchema, _t as asVoice, an as groupSchema, bt as asUnsend, hn as addMemberSchema, jt as asReply, q as ManagedStream, r as asAttachment, rn as asGroup, wn as reactionSchema, wt as asText, yn as removeMemberSchema } from "./attachment-CWfyVjJ6.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";
@@ -167,6 +167,55 @@ interface ResumableOrderedStreamOptions<TLive, TMissed, TOutput> {
  */
 declare const resumableOrderedStream: <TLive, TMissed, TOutput>(options: ResumableOrderedStreamOptions<TLive, TMissed, TOutput>) => ManagedStream<TOutput>;
 //#endregion
+//#region src/utils/stream-group.d.ts
+/**
+ * Builds a member stream. Invoked once per attach — and again on re-attach, so
+ * a member that faulted can be revived by adding its key back.
+ */
+type StreamGroupSource<T> = () => ManagedStream<T>;
+interface StreamGroupOptions {
+  /** Log provenance, e.g. `"imessage.messages"`. */
+  label?: string;
+}
+interface StreamGroup<T> extends ManagedStream<T> {
+  /**
+   * Attach `key`. Returns false — without invoking `source`, which typically
+   * opens a subscription — when the key is already attached or the group is
+   * closed. Safe before the group has a consumer: the factory runs when the
+   * group first starts.
+   */
+  add(key: string, source: StreamGroupSource<T>): boolean;
+  has(key: string): boolean;
+  /** Attached keys, in attach order. */
+  keys(): string[];
+  /**
+   * Detach `key` and close its source. Resolves once that source's own
+   * `close()` settles; it deliberately does not wait on the member's worker,
+   * which unparks only when the group's consumer pulls. Returns false when the
+   * key was not attached.
+   */
+  remove(key: string): Promise<boolean>;
+}
+/**
+ * A merged stream whose membership can change while it runs.
+ *
+ * Sibling of `mergeStreams`, with a deliberately different lifetime contract —
+ * pick by whether the source set is fixed:
+ *
+ *   - `mergeStreams` merges a *fixed* set. Its result represents all of them:
+ *     it ends when they have all ended (immediately, for an empty set) and one
+ *     member's error ends the whole merge.
+ *   - `createStreamGroup` owns a *mutable* set. It ends only via `close()` —
+ *     zero members parks the consumer rather than ending it, so a set that is
+ *     briefly empty mid-reconcile does not terminate the stream — and a member
+ *     that fails is logged and dropped while its siblings keep running.
+ *
+ * Dropping a faulted member (rather than restarting it here) keeps retry policy
+ * with the caller that knows the real inventory: `keys()` stops reporting it, so
+ * the caller's next reconcile re-adds it through `add`.
+ */
+declare function createStreamGroup<T>(options?: StreamGroupOptions): StreamGroup<T>;
+//#endregion
 //#region src/utils/telemetry.d.ts
 /**
  * Structured attributes for an unknown thrown value: its type, sanitized
@@ -192,4 +241,4 @@ interface TokenRenewalOptions {
 }
 declare const createTokenRenewal: (options: TokenRenewalOptions) => TokenRenewal;
 //#endregion
-export { type CloseableAsyncIterable, type LogAttrs, type LogLevel, type PhotoInput, type PhotonLogger, type ProviderMessageRecord, type ProviderUserRecord, type ResumableStreamItem, type SanitizeUrlOptions, type TokenRenewal, type TokenRenewalOptions, addMemberSchema, asAttachment, asContact, asCustom, asGroup, asMarkdown, asPoll, asPollOption, asReaction, asRead, asReply, asRichlink, asText, asUnsend, asVoice, avatarSchema, buildPhotoAction, createLogger, createTokenRenewal, ensureM4a, envAwareConfig, envFor, errorAttrs, fromEnv, groupSchema, leaveSpaceSchema, messageEffectSchema, photoActionSchema, reactionSchema, readSchema, removeMemberSchema, renameSchema, 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, type StreamGroup, type StreamGroupOptions, type StreamGroupSource, type TokenRenewal, type TokenRenewalOptions, addMemberSchema, asAttachment, asContact, asCustom, asGroup, asMarkdown, asPoll, asPollOption, asReaction, asRead, asReply, asRichlink, asText, asUnsend, asVoice, avatarSchema, buildPhotoAction, createLogger, createStreamGroup, createTokenRenewal, ensureM4a, envAwareConfig, envFor, errorAttrs, fromEnv, groupSchema, leaveSpaceSchema, messageEffectSchema, photoActionSchema, reactionSchema, readSchema, removeMemberSchema, renameSchema, renderInlineTokens, replySchema, resumableOrderedStream, sanitizeEmail, sanitizeErrorMessage, sanitizePhone, sanitizeUrl, setLogLevel, tracedFetch };

package/dist/authoring.js

@@ -1,4 +1,4 @@
-import { C as replySchema, E as asRead, G as asGroup, H as asMarkdown, L as addMemberSchema, M as asPoll, N as asPollOption, O as readSchema, T as renameSchema, V as removeMemberSchema, W as markdownSchema, Y as asText, Z as textSchema, _ as asUnsend, a as createTokenRenewal, ct as buildPhotoAction, et as asCustom, f as envAwareConfig, ft as attachmentSchema, h as asVoice, i as stream, j as reactionSchema, k as asReaction, lt as photoActionSchema, m as fromEnv, mt as tracedFetch, nt as asContact, p as envFor, q as groupSchema, s as errorAttrs, st as avatarSchema, u as renderInlineTokens, ut as asAttachment, x as asReply, y as asRichlink, z as leaveSpaceSchema } from "./stream-BCNqsDU_.js";
+import { C as replySchema, E as asRead, G as asGroup, H as asMarkdown, L as addMemberSchema, M as asPoll, N as asPollOption, O as readSchema, T as renameSchema, V as removeMemberSchema, W as markdownSchema, Y as asText, Z as textSchema, _ as asUnsend, a as createTokenRenewal, ct as buildPhotoAction, et as asCustom, f as envAwareConfig, ft as attachmentSchema, h as asVoice, i as stream, j as reactionSchema, k as asReaction, lt as photoActionSchema, m as fromEnv, mt as tracedFetch, nt as asContact, p as envFor, q as groupSchema, s as errorAttrs, st as avatarSchema, u as renderInlineTokens, ut as asAttachment, x as asReply, y as asRichlink, z as leaveSpaceSchema } from "./stream-t0CbOOUT.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,99 @@ const resumableOrderedStream = (options) => stream((emit, end) => {
 	};
 });
 //#endregion
-export { addMemberSchema, asAttachment, asContact, asCustom, asGroup, asMarkdown, asPoll, asPollOption, asReaction, asRead, asReply, asRichlink, asText, asUnsend, asVoice, avatarSchema, buildPhotoAction, createLogger, createTokenRenewal, ensureM4a, envAwareConfig, envFor, errorAttrs, fromEnv, groupSchema, leaveSpaceSchema, messageEffectSchema, photoActionSchema, reactionSchema, readSchema, removeMemberSchema, renameSchema, renderInlineTokens, replySchema, resumableOrderedStream, sanitizeEmail, sanitizeErrorMessage, sanitizePhone, sanitizeUrl, setLogLevel, tracedFetch };
+//#region src/utils/stream-group.ts
+const groupLog = createLogger$1("spectrum.stream");
+/**
+* A merged stream whose membership can change while it runs.
+*
+* Sibling of `mergeStreams`, with a deliberately different lifetime contract —
+* pick by whether the source set is fixed:
+*
+*   - `mergeStreams` merges a *fixed* set. Its result represents all of them:
+*     it ends when they have all ended (immediately, for an empty set) and one
+*     member's error ends the whole merge.
+*   - `createStreamGroup` owns a *mutable* set. It ends only via `close()` —
+*     zero members parks the consumer rather than ending it, so a set that is
+*     briefly empty mid-reconcile does not terminate the stream — and a member
+*     that fails is logged and dropped while its siblings keep running.
+*
+* Dropping a faulted member (rather than restarting it here) keeps retry policy
+* with the caller that knows the real inventory: `keys()` stops reporting it, so
+* the caller's next reconcile re-adds it through `add`.
+*/
+function createStreamGroup(options = {}) {
+	const label = options.label ?? "stream-group";
+	const members = /* @__PURE__ */ new Map();
+	let closed = false;
+	let spawn;
+	const memberAttrs = (key) => ({
+		"spectrum.stream.group": label,
+		"spectrum.stream.member": key
+	});
+	const reportMemberExit = (key, member, error) => {
+		if (member.detached) return;
+		if (error === void 0) {
+			groupLog.error("stream group member ended unexpectedly", memberAttrs(key));
+			return;
+		}
+		groupLog.error("stream group member failed", {
+			...memberAttrs(key),
+			...errorAttrs(error)
+		}, error instanceof Error ? error : void 0);
+	};
+	const runMember = async (key, member, emit) => {
+		try {
+			const source = member.factory();
+			member.source = source;
+			for await (const value of source) await emit(value);
+			reportMemberExit(key, member);
+		} catch (error) {
+			reportMemberExit(key, member, error ?? /* @__PURE__ */ new Error("unknown stream error"));
+		} finally {
+			if (members.get(key) === member) members.delete(key);
+		}
+	};
+	const base = stream((emit) => {
+		spawn = (key, member) => {
+			member.worker = runMember(key, member, emit);
+		};
+		for (const [key, member] of members) spawn(key, member);
+		return async () => {
+			closed = true;
+			spawn = void 0;
+			const attached = Array.from(members.values());
+			for (const member of attached) member.detached = true;
+			await Promise.allSettled(attached.map((member) => member.source?.close()));
+			await Promise.allSettled(attached.map((member) => member.worker));
+		};
+	});
+	const closeBase = base.close.bind(base);
+	return Object.assign(base, {
+		add: (key, source) => {
+			if (closed || members.has(key)) return false;
+			const member = {
+				detached: false,
+				factory: source
+			};
+			members.set(key, member);
+			spawn?.(key, member);
+			return true;
+		},
+		close: async () => {
+			closed = true;
+			await closeBase();
+		},
+		has: (key) => members.has(key),
+		keys: () => Array.from(members.keys()),
+		remove: async (key) => {
+			const member = members.get(key);
+			if (!member) return false;
+			member.detached = true;
+			members.delete(key);
+			await member.source?.close();
+			return true;
+		}
+	});
+}
+//#endregion
+export { addMemberSchema, asAttachment, asContact, asCustom, asGroup, asMarkdown, asPoll, asPollOption, asReaction, asRead, asReply, asRichlink, asText, asUnsend, asVoice, avatarSchema, buildPhotoAction, createLogger, createStreamGroup, createTokenRenewal, ensureM4a, envAwareConfig, envFor, errorAttrs, fromEnv, groupSchema, leaveSpaceSchema, messageEffectSchema, photoActionSchema, reactionSchema, readSchema, removeMemberSchema, renameSchema, renderInlineTokens, replySchema, resumableOrderedStream, sanitizeEmail, sanitizeErrorMessage, sanitizePhone, sanitizeUrl, setLogLevel, tracedFetch };

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-import { $ as DedicatedTokenData, $t as StreamText, A as isFusorEvent, An as ContactEmail, At as Reply, B as PlatformUser, Bn as AvatarData, C as FusorVerify, Cn as reaction, Ct as typing, D as WebhookRawResult, Dn as Contact, E as WebhookRawRequest, En as custom, Et as Richlink, F as PlatformInstance, Ft as rename, G as SpaceNamespace, Hn as avatar, Ht as PollChoice, I as PlatformMessage, In as contact, J as broadcast, Jn as AppLayout, Jt as poll, K as Broadcaster, L as PlatformProviderConfig, Ln as AgentSender, Lt as Read, M as EventProducer, Mn as ContactName, Mt as reply, N as Platform, Nn as ContactOrg, O as FusorEvent, On as ContactAddress, Ot as richlink, P as PlatformDef, Pn as ContactPhone, Pt as Rename, Q as CloudPlatform, Qn as appLayoutSchema, Qt as DeltaExtractor, R as PlatformRuntime, Rn as User, S as FusorRespond, St as Typing, T as WebhookHandler, Tt as text, Ut as PollChoiceInput, V as ProviderMessage, Vn as AvatarInput, Vt as Poll, W as SchemaMessage, Wt as PollOption, X as stream, Xn as AppUrl, Y as mergeStreams, Yn as AppOptions, Yt as Markdown, Z as Store, Zn as app, Zt as markdown, _ as FusorClient, a as Content, at as ProjectProfile, b as FusorMessagesReturn, bn as Reaction, c as fromVCard, cn as Message, ct as SlackTokenData, d as UnsupportedKind, dn as LeaveSpace, dt as SubscriptionStatus, en as StreamTextSource, et as FusorTokenData, f as Spectrum, fn as MemberInput, ft as TokenData, g as isFusorClient, gn as leaveSpace, gt as Voice, h as fusor, ht as EmojiKey, i as attachment, in as group, it as ProjectData, j as AnyPlatformDef, jn as ContactInput, k as fusorEvent, kn as ContactDetails, kt as resolveContents, l as toVCard, ln as Space, lt as SpectrumCloudError, m as definePlatform, mn as addMember, mt as Emoji, n as AttachmentInput, nn as Group, nt as PlatformStatus, o as ContentBuilder, on as Edit, ot as SharedTokenData, p as SpectrumInstance, pn as RemoveMember, pt as cloud, q as ManagedStream, qn as App, qt as option, rt as PlatformsData, s as ContentInput, sn as edit, st as SlackTeamMeta, t as Attachment, tn as TextStreamOptions, tt as ImessageInfoData, u as UnsupportedError, un as AddMember, ut as SubscriptionData, v as FusorMessages, vn as removeMember, vt as voice, w as FusorVerifyRequest, x as FusorReply, xn as ReactionBuilder, xt as unsend, y as FusorMessagesCtx, yt as Unsend, z as PlatformSpace, zn as Avatar, zt as read } from "./attachment-DYRlQfUs.js";
+import { $ as DedicatedTokenData, $t as StreamText, A as isFusorEvent, An as ContactEmail, At as Reply, B as PlatformUser, Bn as AvatarData, C as FusorVerify, Cn as reaction, Ct as typing, D as WebhookRawResult, Dn as Contact, E as WebhookRawRequest, En as custom, Et as Richlink, F as PlatformInstance, Ft as rename, G as SpaceNamespace, Hn as avatar, Ht as PollChoice, I as PlatformMessage, In as contact, J as broadcast, Jn as AppLayout, Jt as poll, K as Broadcaster, L as PlatformProviderConfig, Ln as AgentSender, Lt as Read, M as EventProducer, Mn as ContactName, Mt as reply, N as Platform, Nn as ContactOrg, O as FusorEvent, On as ContactAddress, Ot as richlink, P as PlatformDef, Pn as ContactPhone, Pt as Rename, Q as CloudPlatform, Qn as appLayoutSchema, Qt as DeltaExtractor, R as PlatformRuntime, Rn as User, S as FusorRespond, St as Typing, T as WebhookHandler, Tt as text, Ut as PollChoiceInput, V as ProviderMessage, Vn as AvatarInput, Vt as Poll, W as SchemaMessage, Wt as PollOption, X as stream, Xn as AppUrl, Y as mergeStreams, Yn as AppOptions, Yt as Markdown, Z as Store, Zn as app, Zt as markdown, _ as FusorClient, a as Content, at as ProjectProfile, b as FusorMessagesReturn, bn as Reaction, c as fromVCard, cn as Message, ct as SlackTokenData, d as UnsupportedKind, dn as LeaveSpace, dt as SubscriptionStatus, en as StreamTextSource, et as FusorTokenData, f as Spectrum, fn as MemberInput, ft as TokenData, g as isFusorClient, gn as leaveSpace, gt as Voice, h as fusor, ht as EmojiKey, i as attachment, in as group, it as ProjectData, j as AnyPlatformDef, jn as ContactInput, k as fusorEvent, kn as ContactDetails, kt as resolveContents, l as toVCard, ln as Space, lt as SpectrumCloudError, m as definePlatform, mn as addMember, mt as Emoji, n as AttachmentInput, nn as Group, nt as PlatformStatus, o as ContentBuilder, on as Edit, ot as SharedTokenData, p as SpectrumInstance, pn as RemoveMember, pt as cloud, q as ManagedStream, qn as App, qt as option, rt as PlatformsData, s as ContentInput, sn as edit, st as SlackTeamMeta, t as Attachment, tn as TextStreamOptions, tt as ImessageInfoData, u as UnsupportedError, un as AddMember, ut as SubscriptionData, v as FusorMessages, vn as removeMember, vt as voice, w as FusorVerifyRequest, x as FusorReply, xn as ReactionBuilder, xt as unsend, y as FusorMessagesCtx, yt as Unsend, z as PlatformSpace, zn as Avatar, zt as read } from "./attachment-CWfyVjJ6.js";
 export { type AddMember, type AgentSender, type AnyPlatformDef, type App, type AppLayout, type AppOptions, 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 { $ as drainStreamText, A as reaction, B as removeMember, D as read, F as poll, H as asMarkdown, I as addMember, J as resolveContents, K as group, L as addMemberSchema, P as option, Q as StreamConsumedError, R as leaveSpace, S as reply, T as renameSchema, U as markdown, V as removeMemberSchema, X as text, Y as asText, a as createTokenRenewal, at as toVCard, b as richlink, c as senderAttrs, d as classifyIdentifier, dt as attachment, et as asCustom, f as envAwareConfig, g as voice, h as asVoice, i as stream, it as fromVCard, l as markdownToPlainText, mt as tracedFetch, n as createAsyncQueue, nt as asContact, o as contentAttrs, ot as avatar, p as envFor, pt as fetchUrlBytes, r as mergeStreams, rt as contact, s as errorAttrs, st as avatarSchema, t as broadcast, tt as custom, ut as asAttachment, v as unsend, w as rename, z as leaveSpaceSchema } from "./stream-BCNqsDU_.js";
+import { $ as drainStreamText, A as reaction, B as removeMember, D as read, F as poll, H as asMarkdown, I as addMember, J as resolveContents, K as group, L as addMemberSchema, P as option, Q as StreamConsumedError, R as leaveSpace, S as reply, T as renameSchema, U as markdown, V as removeMemberSchema, X as text, Y as asText, a as createTokenRenewal, at as toVCard, b as richlink, c as senderAttrs, d as classifyIdentifier, dt as attachment, et as asCustom, f as envAwareConfig, g as voice, h as asVoice, i as stream, it as fromVCard, l as markdownToPlainText, mt as tracedFetch, n as createAsyncQueue, nt as asContact, o as contentAttrs, ot as avatar, p as envFor, pt as fetchUrlBytes, r as mergeStreams, rt as contact, s as errorAttrs, st as avatarSchema, t as broadcast, tt as custom, ut as asAttachment, v as unsend, w as rename, z as leaveSpaceSchema } from "./stream-t0CbOOUT.js";
 import z from "zod";
 import ogs from "open-graph-scraper";
 import { createLogger, setLogLevel, setupOtel, withSpan } from "@photon-ai/otel";
@@ -3019,7 +3019,7 @@ function definePlatform(platformId, rawDef) {
 }
 //#endregion
 //#region src/build-env.ts
-const SPECTRUM_SDK_VERSION = "12.5.0";
+const SPECTRUM_SDK_VERSION = "12.6.0";
 //#endregion
 //#region src/utils/provider-packages.ts
 const OFFICIAL_PROVIDER_PACKAGES = {

package/dist/{stream-BCNqsDU_.js → stream-t0CbOOUT.js}

@@ -1739,6 +1739,15 @@ function stream(setup) {
 		await repeater.return(void 0).catch(ignoreCleanupError);
 	} });
 }
+/**
+* Merges a fixed set of streams. The result represents all of them: it ends
+* once every member has ended — immediately, for an empty set — and one
+* member's error ends the whole merge.
+*
+* For a set that changes while the stream runs, use `createStreamGroup`
+* (`@spectrum-ts/core/authoring`), which ends only on `close()` and drops a
+* failed member instead of tearing down its siblings.
+*/
 function mergeStreams(streams) {
 	return stream((emit, end) => {
 		if (streams.length === 0) {

package/package.json

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