spectrum-ts 1.18.0 → 3.0.0

package/dist/{types-DcQ5a7PK.d.ts → types-YqCNUDIt.d.ts}

@@ -4,6 +4,16 @@ import z__default from 'zod';
 declare const contentSchema: z__default.ZodDiscriminatedUnion<[z__default.ZodObject<{
     type: z__default.ZodLiteral<"text">;
     text: z__default.ZodString;
+}, z__default.core.$strip>, z__default.ZodObject<{
+    type: z__default.ZodLiteral<"markdown">;
+    markdown: z__default.ZodString;
+}, z__default.core.$strip>, 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>, z__default.ZodObject<{
     type: z__default.ZodLiteral<"custom">;
     raw: z__default.ZodUnknown;
@@ -121,6 +131,9 @@ declare const contentSchema: z__default.ZodDiscriminatedUnion<[z__default.ZodObj
     content: z__default.ZodDiscriminatedUnion<[z__default.ZodObject<{
         type: z__default.ZodLiteral<"text">;
         text: z__default.ZodString;
+    }, z__default.core.$strip>, z__default.ZodObject<{
+        type: z__default.ZodLiteral<"markdown">;
+        markdown: z__default.ZodString;
     }, z__default.core.$strip>, z__default.ZodObject<{
         type: z__default.ZodLiteral<"attachment">;
         id: z__default.ZodString;
@@ -163,6 +176,9 @@ declare const contentSchema: z__default.ZodDiscriminatedUnion<[z__default.ZodObj
     } | {
         type: "text";
         text: string;
+    } | {
+        type: "markdown";
+        markdown: string;
     } | {
         type: "attachment";
         id: string;
@@ -171,6 +187,10 @@ declare const contentSchema: z__default.ZodDiscriminatedUnion<[z__default.ZodObj
         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: "streamText";
+        stream: () => AsyncIterable<string>;
+        format?: "markdown" | "plain" | undefined;
     } | {
         type: "custom";
         raw: unknown;
@@ -267,6 +287,9 @@ declare const contentSchema: z__default.ZodDiscriminatedUnion<[z__default.ZodObj
         content: {
             type: "text";
             text: string;
+        } | {
+            type: "markdown";
+            markdown: string;
         } | {
             type: "attachment";
             id: string;
@@ -295,6 +318,9 @@ declare const contentSchema: z__default.ZodDiscriminatedUnion<[z__default.ZodObj
     } | {
         type: "text";
         text: string;
+    } | {
+        type: "markdown";
+        markdown: string;
     } | {
         type: "attachment";
         id: string;
@@ -303,6 +329,10 @@ declare const contentSchema: z__default.ZodDiscriminatedUnion<[z__default.ZodObj
         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: "streamText";
+        stream: () => AsyncIterable<string>;
+        format?: "markdown" | "plain" | undefined;
     } | {
         type: "custom";
         raw: unknown;
@@ -399,6 +429,9 @@ declare const contentSchema: z__default.ZodDiscriminatedUnion<[z__default.ZodObj
         content: {
             type: "text";
             text: string;
+        } | {
+            type: "markdown";
+            markdown: string;
         } | {
             type: "attachment";
             id: string;
@@ -431,6 +464,9 @@ declare const contentSchema: z__default.ZodDiscriminatedUnion<[z__default.ZodObj
     } | {
         type: "text";
         text: string;
+    } | {
+        type: "markdown";
+        markdown: string;
     } | {
         type: "attachment";
         id: string;
@@ -439,6 +475,10 @@ declare const contentSchema: z__default.ZodDiscriminatedUnion<[z__default.ZodObj
         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: "streamText";
+        stream: () => AsyncIterable<string>;
+        format?: "markdown" | "plain" | undefined;
     } | {
         type: "custom";
         raw: unknown;
@@ -535,6 +575,9 @@ declare const contentSchema: z__default.ZodDiscriminatedUnion<[z__default.ZodObj
         content: {
             type: "text";
             text: string;
+        } | {
+            type: "markdown";
+            markdown: string;
         } | {
             type: "attachment";
             id: string;
@@ -563,6 +606,9 @@ declare const contentSchema: z__default.ZodDiscriminatedUnion<[z__default.ZodObj
     } | {
         type: "text";
         text: string;
+    } | {
+        type: "markdown";
+        markdown: string;
     } | {
         type: "attachment";
         id: string;
@@ -571,6 +617,10 @@ declare const contentSchema: z__default.ZodDiscriminatedUnion<[z__default.ZodObj
         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: "streamText";
+        stream: () => AsyncIterable<string>;
+        format?: "markdown" | "plain" | undefined;
     } | {
         type: "custom";
         raw: unknown;
@@ -667,6 +717,9 @@ declare const contentSchema: z__default.ZodDiscriminatedUnion<[z__default.ZodObj
         content: {
             type: "text";
             text: string;
+        } | {
+            type: "markdown";
+            markdown: string;
         } | {
             type: "attachment";
             id: string;
@@ -685,6 +738,9 @@ declare const contentSchema: z__default.ZodDiscriminatedUnion<[z__default.ZodObj
         displayName: string;
     }>;
     target: z__default.ZodCustom<Message<string, User, Space<unknown>>, Message<string, User, Space<unknown>>>;
+}, z__default.core.$strip>, z__default.ZodObject<{
+    type: z__default.ZodLiteral<"unsend">;
+    target: z__default.ZodCustom<Message<string, User, Space<unknown>>, Message<string, User, Space<unknown>>>;
 }, z__default.core.$strip>], "type">;
 type Content = z__default.infer<typeof contentSchema>;
 interface ContentBuilder {
@@ -701,6 +757,43 @@ interface AgentSender extends User {
     readonly kind: "agent";
 }
 
+/**
+ * A `ContentBuilder` whose build is statically known to produce `Reaction`
+ * content. `space.send` overloads on this so `space.send(reaction(...))`
+ * returns a Message with `content` narrowed to `Reaction`, matching
+ * `message.react()`.
+ */
+interface ReactionBuilder extends ContentBuilder {
+    build(): Promise<Reaction>;
+}
+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 the canonical form of
+ * `message.react(emoji)`. It resolves to the reaction `Message`
+ * (`content.type === "reaction"`) — keep it as the handle to `unsend()`
+ * later. Resolves `undefined` only when the platform does not support
+ * reactions (warned and skipped).
+ *
+ * Accepts `Message | undefined` so `space.send` results chain without
+ * narrowing (`send` resolves `undefined` when a platform skips unsupported
+ * content); an undefined target throws at build time.
+ *
+ * To react to a message known only by id, resolve it first via
+ * `space.getMessage(id)`.
+ */
+declare function reaction(emoji: string, target: Message | undefined): ReactionBuilder;
+
 interface Space<_Def = unknown> {
     readonly __platform: string;
     /**
@@ -725,7 +818,12 @@ interface Space<_Def = unknown> {
     avatar(input: Buffer, options: {
         mimeType: string;
     }): Promise<void>;
-    edit(message: Message, newContent: ContentInput): Promise<void>;
+    /**
+     * Rewrite a previously-sent outbound message. Sugar for
+     * `send(edit(newContent, message))`. Accepts `Message | undefined` so
+     * `send` results chain without narrowing; an undefined target throws.
+     */
+    edit(message: Message | undefined, newContent: ContentInput): Promise<void>;
     /**
      * Look up a message in this space by its id. Returns `undefined` if the
      * platform has no way to resolve the id (e.g. cache miss with no by-id
@@ -742,10 +840,25 @@ interface Space<_Def = unknown> {
      */
     rename(displayName: string): Promise<void>;
     responding<T>(fn: () => T | Promise<T>): Promise<T>;
+    /**
+     * A reaction send resolves to the reaction Message (`content` narrowed to
+     * `Reaction`) — the handle to `unsend()` later. Listed before the general
+     * overload so `send(reaction(...))` picks it; every other `ContentBuilder`
+     * fails the `ReactionBuilder` shape and falls through.
+     */
+    send(content: ReactionBuilder): Promise<(Message<string, AgentSender> & {
+        content: Reaction;
+    }) | undefined>;
     send(content: ContentInput): Promise<Message<string, AgentSender> | undefined>;
     send(...content: [ContentInput, ContentInput, ...ContentInput[]]): Promise<Message<string, AgentSender>[]>;
     startTyping(): Promise<void>;
     stopTyping(): Promise<void>;
+    /**
+     * Retract a previously-sent outbound message. Sugar for
+     * `send(unsend(message))`. Accepts `Message | undefined` so `send`
+     * results chain without narrowing; an undefined target throws.
+     */
+    unsend(message: Message | undefined): Promise<void>;
 }
 
 interface Message<TPlatform extends string = string, TSender extends User = User, TSpace extends Space = Space> {
@@ -754,12 +867,34 @@ interface Message<TPlatform extends string = string, TSender extends User = User
     edit(newContent: ContentInput): Promise<void>;
     readonly id: string;
     platform: TPlatform;
-    react(reaction: string): Promise<void>;
+    /**
+     * React to this message. Resolves to the reaction `Message` (content
+     * narrowed to `Reaction`) — keep it as the handle to `unsend()` later.
+     * Resolves `undefined` when the platform does not support reactions
+     * (warned and skipped).
+     *
+     * The return type is an inline intersection rather than a `TContent`
+     * generic on `Message`: a content type parameter would need `Content` as
+     * its default, and `Content`'s schemas (`reaction`, `reply`, `edit`,
+     * `group`) reference `Message` — TS rejects the resulting circular
+     * default (TS2716).
+     */
+    react(reaction: string): Promise<(Message<TPlatform, AgentSender, TSpace> & {
+        content: Reaction;
+    }) | undefined>;
     reply(content: ContentInput): Promise<Message<TPlatform, AgentSender, TSpace> | undefined>;
     reply(...content: [ContentInput, ContentInput, ...ContentInput[]]): Promise<Message<TPlatform, AgentSender, TSpace>[]>;
     sender: TSender | undefined;
     space: TSpace;
     timestamp: Date;
+    /**
+     * Retract this message. Sugar for `space.send(unsend(this))`. Unsends are
+     * fire-and-forget; per-platform support and constraints (e.g. iMessage's
+     * ~2-minute unsend window for regular messages) surface from the
+     * provider's send action. Only outbound messages can be unsent; calling
+     * this on an inbound message throws.
+     */
+    unsend(): Promise<void>;
 }
 
 type SubscriptionStatus = "active" | "canceled" | "past_due";
@@ -823,6 +958,12 @@ interface ProjectData {
     id: string;
     name: string;
     profile: ProjectProfile;
+    /**
+     * URL-safe project identifier (e.g. `what-c62a6`). Used as the subdomain of
+     * the Fusor "super webhook" edge a platform registers its provider webhook
+     * against — see Telegram's `webhookUrl`.
+     */
+    slug: string;
 }
 declare class SpectrumCloudError extends Error {
     readonly status: number;
@@ -883,7 +1024,7 @@ declare function broadcast<T>(source: ManagedStream<T>): Broadcaster<T>;
  * through `space.send(...)`, call the underlying SDK, or perform any other
  * side effect.
  *
- * Names that collide with reserved `Space` keys (`send`, `edit`,
+ * Names that collide with reserved `Space` keys (`send`, `edit`, `unsend`,
  * `getMessage`, `startTyping`, `stopTyping`, `responding`, `id`,
  * `__platform`) are skipped at runtime with a warning and excluded at the
  * type level via `Exclude<…, keyof Space>`.
@@ -897,9 +1038,9 @@ type SpaceActionFn = (space: Space, ...args: never[]) => Promise<void>;
  * SDK, or perform any other side effect.
  *
  * Names that collide with reserved `Message` keys (`react`, `reply`, `edit`,
- * `id`, `space`, `sender`, `content`, `platform`, `direction`, `timestamp`)
- * are skipped at runtime with a warning and excluded at the type level via
- * `Exclude<…, keyof Message>`.
+ * `unsend`, `id`, `space`, `sender`, `content`, `platform`, `direction`,
+ * `timestamp`) are skipped at runtime with a warning and excluded at the
+ * type level via `Exclude<…, keyof Message>`.
  */
 type MessageActionFn = (message: Message, ...args: never[]) => Promise<void>;
 /**
@@ -1010,10 +1151,17 @@ type ProviderMessageRecord = {
 } & Record<string, unknown>;
 type MergeSchema<TSchema extends z__default.ZodType | undefined, TBase extends object> = TSchema extends z__default.ZodType ? string extends keyof z__default.infer<TSchema> ? TBase : Omit<z__default.infer<TSchema>, keyof TBase> & TBase : TBase;
 type SchemaMessage<TUserSchema extends z__default.ZodType | undefined = undefined, TSpaceSchema extends z__default.ZodType | undefined = undefined> = ProviderMessage<MergeSchema<TUserSchema, ResolvedUser>, MergeSchema<TSpaceSchema, ResolvedSpace>>;
-type InferEventPayload<T> = T extends (ctx: never) => AsyncIterable<infer P> ? P : never;
+type InferEventPayload<T> = T extends z__default.ZodType ? z__default.infer<T> : T extends (ctx: never) => AsyncIterable<infer P> ? P : never;
 type ReservedNames = "stop" | "send" | "config" | "__internal" | "__providers";
 interface CreateClientContext<_ConfigSchema extends z__default.ZodType<object>> {
     config: z__default.infer<_ConfigSchema>;
+    /**
+     * The resolved cloud project record (slug, profile, …) when `Spectrum()` runs
+     * with `projectId` + `projectSecret`; `undefined` in local/direct mode. Lets
+     * `createClient` self-register provider webhooks against the Fusor edge keyed
+     * by `projectConfig.slug` — see Telegram.
+     */
+    projectConfig: ProjectData | undefined;
     projectId: string | undefined;
     projectSecret: string | undefined;
     store: Store;
@@ -1034,7 +1182,7 @@ interface CreateClientContext<_ConfigSchema extends z__default.ZodType<object>>
  * Minimum viable platform integration:
  * `name`, `config`, `lifecycle`, `user`, `space`, `messages`, `send`.
  */
-interface PlatformDef<_Name extends string = string, _ConfigSchema extends z__default.ZodType<object> = z__default.ZodType<object>, _UserSchema extends z__default.ZodType<object> | undefined = undefined, _SpaceSchema extends z__default.ZodType<object> | undefined = undefined, _SpaceParamsSchema extends z__default.ZodType<object> | undefined = undefined, _Client = unknown, _ResolvedUser extends ResolvedUser = ResolvedUser, _ResolvedSpace extends ResolvedSpace = ResolvedSpace, _MessageSchema extends z__default.ZodType<object> | undefined = undefined, _MessageType extends ProviderMessage<_ResolvedUser, _ResolvedSpace, InferSchema<_MessageSchema>> = ProviderMessage<_ResolvedUser, _ResolvedSpace, InferSchema<_MessageSchema>>, _Events extends (Record<string, EventProducer<unknown, _Client, z__default.infer<_ConfigSchema>>> & {
+interface PlatformDef<_Name extends string = string, _ConfigSchema extends z__default.ZodType<object> = z__default.ZodType<object>, _UserSchema extends z__default.ZodType<object> | undefined = undefined, _SpaceSchema extends z__default.ZodType<object> | undefined = undefined, _SpaceParamsSchema extends z__default.ZodType<object> | undefined = undefined, _Client = unknown, _ResolvedUser extends ResolvedUser = ResolvedUser, _ResolvedSpace extends ResolvedSpace = ResolvedSpace, _MessageSchema extends z__default.ZodType<object> | undefined = undefined, _MessageType extends ProviderMessage<_ResolvedUser, _ResolvedSpace, InferSchema<_MessageSchema>> = ProviderMessage<_ResolvedUser, _ResolvedSpace, InferSchema<_MessageSchema>>, _Events extends (Record<string, EventProducer<unknown, _Client, z__default.infer<_ConfigSchema>> | z__default.ZodType<object>> & {
     messages?: never;
 }) | undefined = undefined, _SpaceActions extends Record<string, SpaceActionFn> = Record<never, never>, _MessageActions extends Record<string, MessageActionFn> = Record<never, never>, _Actions extends Record<string, InstanceActionFn> = Record<never, never>> {
     /**
@@ -1128,8 +1276,10 @@ interface PlatformDef<_Name extends string = string, _ConfigSchema extends z__de
      * through this single action.
      *
      * Returns a `ProviderMessageRecord` (id + timestamp) for content that
-     * produces a message; returns `undefined` for fire-and-forget control
-     * signals (reactions, typing, edits) on platforms that don't return ids.
+     * produces a message — including reactions, whose record is the unsend
+     * handle (synthesize a deterministic id when the platform assigns none);
+     * returns `undefined` only for fire-and-forget control signals (typing,
+     * edits, renames, avatars, unsends) on platforms that don't return ids.
      *
      * One of the two universal platform contracts (along with `messages`).
      */
@@ -1143,7 +1293,7 @@ interface PlatformDef<_Name extends string = string, _ConfigSchema extends z__de
     space: {
         schema?: _SpaceSchema;
         params?: _SpaceParamsSchema;
-        resolve: (_: {
+        create: (_: {
             input: {
                 users: (_ResolvedUser & {
                     __platform: _Name;
@@ -1154,6 +1304,21 @@ interface PlatformDef<_Name extends string = string, _ConfigSchema extends z__de
             config: z__default.infer<_ConfigSchema>;
             store: Store;
         }) => Promise<_ResolvedSpace>;
+        /**
+         * Optional: hydrate a space from a known platform space id. When absent,
+         * the framework builds the candidate `{ id }` and validates it against
+         * `space.schema` — providers whose schema requires more fields must
+         * implement this.
+         */
+        get?: (_: {
+            input: {
+                id: string;
+                params?: _SpaceParamsSchema extends z__default.ZodType<object> ? z__default.infer<_SpaceParamsSchema> : undefined;
+            };
+            client: NoInferClient<_Client>;
+            config: z__default.infer<_ConfigSchema>;
+            store: Store;
+        }) => Promise<_ResolvedSpace>;
         /**
          * Optional platform-specific methods bound to `PlatformSpace<Def>`.
          *
@@ -1169,9 +1334,9 @@ interface PlatformDef<_Name extends string = string, _ConfigSchema extends z__de
          * lives here for platform-specific surface area.
          *
          * Names that collide with reserved `Space` keys (`send`, `edit`,
-         * `getMessage`, `startTyping`, `stopTyping`, `responding`, `id`,
-         * `__platform`) are skipped at runtime with a warning and excluded at
-         * the type level.
+         * `unsend`, `getMessage`, `startTyping`, `stopTyping`, `responding`,
+         * `id`, `__platform`) are skipped at runtime with a warning and excluded
+         * at the type level.
          */
         actions?: _SpaceActions;
     };
@@ -1191,7 +1356,7 @@ interface AnyPlatformDef {
     actions?: Record<string, InstanceActionFn>;
     config: z__default.ZodType<object>;
     events?: {
-        [key: string]: (ctx: any) => AsyncIterable<any>;
+        [key: string]: ((ctx: any) => AsyncIterable<any>) | z__default.ZodType<object>;
     };
     lifecycle: {
         createClient: (ctx: any) => Promise<any>;
@@ -1207,7 +1372,8 @@ interface AnyPlatformDef {
     space: {
         schema?: z__default.ZodType<object>;
         params?: z__default.ZodType<object>;
-        resolve: (_: any) => Promise<any>;
+        create: (_: any) => Promise<any>;
+        get?: (_: any) => Promise<any>;
         actions?: Record<string, SpaceActionFn>;
     };
     user: {
@@ -1249,21 +1415,31 @@ type UnifiedCustomEvent<Providers extends PlatformProviderConfig[], EventName ex
 type CustomEventStreams<Providers extends PlatformProviderConfig[]> = {
     [K in Exclude<AllCustomEventNames<Providers>, ReservedNames> & string]: AsyncIterable<UnifiedCustomEvent<Providers, K>>;
 };
-type ResolvedSpaceOf<Def extends AnyPlatformDef> = AwaitedReturn<Def["space"]["resolve"]>;
+type ResolvedSpaceOf<Def extends AnyPlatformDef> = AwaitedReturn<Def["space"]["create"]>;
 type SchemaSpaceOf<Def extends AnyPlatformDef> = InferOptionalSchema<Def["space"]["schema"]>;
 type ResolvedUserOf<Def extends AnyPlatformDef> = AwaitedReturn<Def["user"]["resolve"]>;
 type SpaceShapeOf<Def extends AnyPlatformDef> = [SchemaSpaceOf<Def>] extends [
     never
 ] ? ResolvedSpaceOf<Def> : SchemaSpaceOf<Def>;
-type SpaceParamsInputOf<Def extends AnyPlatformDef> = InputSchema<Def["space"]["params"]>;
+type SpaceParamsInputOf<Def extends AnyPlatformDef> = z__default.ZodType<object> extends Def["space"]["params"] ? never : InputSchema<Def["space"]["params"]>;
 type SpaceUserLike<Def extends AnyPlatformDef> = PlatformUser<Def> | string;
-type SpaceArrayArgs<Def extends AnyPlatformDef> = [
-    SpaceParamsInputOf<Def>
-] extends [never] ? [users: SpaceUserLike<Def>[]] : [users: SpaceUserLike<Def>[]] | [users: SpaceUserLike<Def>[], params: SpaceParamsInputOf<Def>] | [params: SpaceParamsInputOf<Def>];
-type SpaceVarargArgs<Def extends AnyPlatformDef> = [
+type SpaceParamsArgs<Def extends AnyPlatformDef> = [
     SpaceParamsInputOf<Def>
-] extends [never] ? SpaceUserLike<Def>[] : SpaceUserLike<Def>[] | [...SpaceUserLike<Def>[], SpaceParamsInputOf<Def>];
-type SpaceArgs<Def extends AnyPlatformDef> = SpaceArrayArgs<Def> | SpaceVarargArgs<Def>;
+] extends [never] ? [] : Record<string, never> extends SpaceParamsInputOf<Def> ? [params?: SpaceParamsInputOf<Def>] : [params: SpaceParamsInputOf<Def>];
+interface SpaceNamespace<Def extends AnyPlatformDef> {
+    /**
+     * Resolve or create a space from its participants — a single user (1:1
+     * conversation) or several (group, where the platform supports it). Users
+     * may be raw id strings or previously resolved `PlatformUser`s.
+     */
+    create(users: SpaceUserLike<Def> | SpaceUserLike<Def>[], ...params: SpaceParamsArgs<Def>): Promise<PlatformSpace<Def>>;
+    /**
+     * Construct a space from a known platform space id — e.g. one persisted
+     * from an earlier event. Providers may hydrate platform-specific fields
+     * (or verify existence) via their `space.get` hook.
+     */
+    get(id: string, ...params: SpaceParamsArgs<Def>): Promise<PlatformSpace<Def>>;
+}
 type SpaceActionFns<Def extends AnyPlatformDef> = Def["space"] extends {
     actions?: infer A;
 } ? A extends Record<string, SpaceActionFn> ? A : Record<string, never> : Record<string, never>;
@@ -1294,7 +1470,7 @@ type PlatformMessage<Def extends AnyPlatformDef> = Omit<SchemaInfer<Def["message
 type PlatformUser<Def extends AnyPlatformDef> = Omit<ResolvedUserOf<Def>, keyof User> & User;
 type PlatformInstance<Def extends AnyPlatformDef> = {
     readonly messages: AsyncIterable<[PlatformSpace<Def>, PlatformMessage<Def>]>;
-    space(...args: SpaceArgs<Def>): Promise<PlatformSpace<Def>>;
+    readonly space: SpaceNamespace<Def>;
     user(userID: string): Promise<PlatformUser<Def>>;
 } & CustomEventInstanceProperties<Def> & PlatformWiseInstanceMethods<Def> & InstanceActionMethods<Def>;
 type CustomEventInstanceProperties<Def extends AnyPlatformDef> = Def["events"] extends Record<string, unknown> ? {
@@ -1304,7 +1480,9 @@ interface PlatformRuntime {
     client: unknown;
     config: unknown;
     definition: AnyPlatformDef;
+    projectConfig: ProjectData | undefined;
     store: Store;
+    subscribeEvent?: (channel: string) => AsyncIterable<unknown> | undefined;
     subscribeMessages: () => ManagedStream<[Space, Message]>;
 }
 interface SpectrumLike<Providers extends PlatformProviderConfig[] = PlatformProviderConfig[]> {
@@ -1323,4 +1501,4 @@ interface Platform<Def extends AnyPlatformDef> {
     (message: Message): PlatformMessage<Def>;
 }
 
-export { type AgentSender as A, type Broadcaster as B, type ContentBuilder as C, type DedicatedTokenData as D, type EventProducer as E, type FusorTokenData as F, type SharedTokenData as G, type SlackTeamMeta as H, type InstanceActionFn as I, type SlackTokenData as J, SpectrumCloudError as K, type SubscriptionData as L, type Message as M, type SubscriptionStatus as N, broadcast as O, type Platform as P, cloud as Q, mergeStreams as R, type SchemaMessage as S, type TokenData as T, type User as U, stream as V, type PlatformDef as a, type Space as b, type ContentInput as c, type Store as d, type Content as e, type ProviderMessageRecord as f, type SpaceActionFn as g, type MessageActionFn as h, type CreateClientContext as i, type ProviderMessage as j, type PlatformProviderConfig as k, type SpectrumLike as l, type CustomEventStreams as m, type ProjectData as n, type AnyPlatformDef as o, type CloudPlatform as p, type ImessageInfoData as q, type ManagedStream as r, type PlatformInstance as s, type PlatformMessage as t, type PlatformRuntime as u, type PlatformSpace as v, type PlatformStatus as w, type PlatformUser as x, type PlatformsData as y, type ProjectProfile as z };
+export { asReaction as $, type AgentSender as A, type Broadcaster as B, type ContentBuilder as C, type DedicatedTokenData as D, type EventProducer as E, type FusorTokenData as F, type ProjectProfile as G, type ReactionBuilder as H, type InstanceActionFn as I, type SharedTokenData as J, type SlackTeamMeta as K, type SlackTokenData as L, type Message as M, type SpaceNamespace as N, SpectrumCloudError as O, type Platform as P, type SubscriptionData as Q, type Reaction as R, type SchemaMessage as S, type SubscriptionStatus as T, type User as U, type TokenData as V, broadcast as W, cloud as X, mergeStreams as Y, reaction as Z, stream as _, type PlatformDef as a, type ProjectData as b, type Store as c, type ProviderMessageRecord as d, type Space as e, contentSchema as f, type ProviderMessage as g, type ContentInput as h, type Content as i, type SpaceActionFn as j, type MessageActionFn as k, type CreateClientContext as l, type PlatformProviderConfig as m, type SpectrumLike as n, type CustomEventStreams as o, type AnyPlatformDef as p, type CloudPlatform as q, type ImessageInfoData as r, type ManagedStream as s, type PlatformInstance as t, type PlatformMessage as u, type PlatformRuntime as v, type PlatformSpace as w, type PlatformStatus as x, type PlatformUser as y, type PlatformsData as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spectrum-ts",
-  "version": "1.18.0",
+  "version": "3.0.0",
   "description": "Bring agents to any interface — unified messaging SDK for TypeScript.",
   "repository": {
     "type": "git",
@@ -42,11 +42,13 @@
     "@photon-ai/imessage-kit": "^3.0.0",
     "@photon-ai/otel": "^0.1.1",
     "@photon-ai/slack": "^0.2.0",
+    "@photon-ai/telegram-ts": "10.0.0",
     "@photon-ai/whatsapp-business": "^0.1.1",
     "@photon-ai/proto": "^0.2.4",
     "@repeaterjs/repeater": "^3.0.6",
     "better-grpc": "^0.3.2",
     "lru-cache": "^11.0.0",
+    "marked": "^18.0.5",
     "mime-types": "^3.0.1",
     "nice-grpc": "^2.1.16",
     "nice-grpc-common": "^2.0.2",