spectrum-ts 2.0.0 → 3.0.0

package/dist/providers/index.d.ts

@@ -3,17 +3,17 @@ export { slack } from './slack/index.js';
 export { telegram } from './telegram/index.js';
 export { terminal } from './terminal/index.js';
 export { whatsappBusiness } from './whatsapp-business/index.js';
-import '../types-Bje8aq1k.js';
+import '../types-YqCNUDIt.js';
 import 'hotscript';
 import 'zod';
 import 'zod/v4/core';
-import '../attachment-B4nSrKVd.js';
+import '../attachment-WePAHfcH.js';
 import '../photo-content-BJKnqgN-.js';
 import '@photon-ai/advanced-imessage';
 import '@photon-ai/imessage-kit';
 import '@photon-ai/slack';
 import '@photon-ai/telegram-ts';
-import '../types-BD0-kKyv.js';
+import '../types-BujGKBin.js';
 import 'node:child_process';
 import 'node:net';
 import '@photon-ai/whatsapp-business';

package/dist/providers/index.js

@@ -1,30 +1,30 @@
 import { createRequire as __spectrumCreateRequire } from "node:module"; const require = __spectrumCreateRequire(import.meta.url);
 import {
   imessage
-} from "../chunk-ATNAE7OR.js";
-import "../chunk-6BI4PFTP.js";
+} from "../chunk-AYCMTRVC.js";
+import "../chunk-CHY5YLLV.js";
 import {
   slack
-} from "../chunk-WXY5QP3M.js";
+} from "../chunk-FULEQIRQ.js";
 import {
   telegram
-} from "../chunk-5LT5J3NR.js";
+} from "../chunk-TXRWKSNH.js";
 import "../chunk-34FQGGD7.js";
-import "../chunk-3B4QH4JG.js";
+import "../chunk-MHGCPC2V.js";
 import {
   terminal
-} from "../chunk-U3LXXT3W.js";
-import "../chunk-NNY6LMSC.js";
+} from "../chunk-EZ5SNNFS.js";
+import "../chunk-77U6SH5A.js";
 import {
   whatsappBusiness
-} from "../chunk-Q537JPTG.js";
+} from "../chunk-UXJ5OO6P.js";
 import "../chunk-2D27WW5B.js";
 import "../chunk-3GEJYGZK.js";
-import "../chunk-U7AWXDH6.js";
+import "../chunk-NZ5WCMTY.js";
 import "../chunk-5XEFJBN2.js";
 import "../chunk-6UZFVXQF.js";
-import "../chunk-NGC4DJIX.js";
-import "../chunk-2ILTJC35.js";
+import "../chunk-LX437ZTY.js";
+import "../chunk-LQMDV75O.js";
 export {
   imessage,
   slack,

package/dist/providers/slack/index.d.ts

@@ -1,4 +1,4 @@
-import { S as SchemaMessage, P as Platform, a as PlatformDef } from '../../types-Bje8aq1k.js';
+import { S as SchemaMessage, P as Platform, a as PlatformDef } from '../../types-YqCNUDIt.js';
 import * as z from 'zod';
 import z__default from 'zod';
 import * as _photon_ai_slack from '@photon-ai/slack';
@@ -30,7 +30,6 @@ declare const slack: Platform<PlatformDef<"Slack", z.ZodUnion<readonly [z.ZodObj
     id: z.ZodString;
     teamId: z.ZodString;
 }, zod_v4_core.$strip>, z.ZodObject<{
-    channel: z.ZodOptional<z.ZodString>;
     teamId: z.ZodString;
 }, zod_v4_core.$strip>, _photon_ai_slack.SlackClient, {
     id: string;

package/dist/providers/slack/index.js

@@ -1,11 +1,11 @@
 import { createRequire as __spectrumCreateRequire } from "node:module"; const require = __spectrumCreateRequire(import.meta.url);
 import {
   slack
-} from "../../chunk-WXY5QP3M.js";
+} from "../../chunk-FULEQIRQ.js";
 import "../../chunk-3GEJYGZK.js";
 import "../../chunk-5XEFJBN2.js";
-import "../../chunk-NGC4DJIX.js";
-import "../../chunk-2ILTJC35.js";
+import "../../chunk-LX437ZTY.js";
+import "../../chunk-LQMDV75O.js";
 export {
   slack
 };

package/dist/providers/telegram/index.d.ts

@@ -1,9 +1,9 @@
-import { P as Platform, a as PlatformDef, g as ProviderMessage } from '../../types-Bje8aq1k.js';
+import { P as Platform, a as PlatformDef, g as ProviderMessage } from '../../types-YqCNUDIt.js';
 import * as _photon_ai_telegram_ts from '@photon-ai/telegram-ts';
 import * as zod_v4_core from 'zod/v4/core';
 import * as z from 'zod';
 import z__default from 'zod';
-import { F as FusorClient } from '../../types-BD0-kKyv.js';
+import { F as FusorClient } from '../../types-BujGKBin.js';
 import 'hotscript';
 
 interface TelegramSpace {
@@ -36,9 +36,7 @@ declare const telegram: Platform<PlatformDef<"telegram", z.ZodObject<{
     botToken: z.ZodString;
     webhookSecret: z.ZodOptional<z.ZodString>;
     baseUrl: z.ZodDefault<z.ZodURL>;
-}, zod_v4_core.$strip>, z.ZodType<object, unknown, zod_v4_core.$ZodTypeInternals<object, unknown>> | undefined, z.ZodType<object, unknown, zod_v4_core.$ZodTypeInternals<object, unknown>> | undefined, z.ZodObject<{
-    chatId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
-}, zod_v4_core.$strip>, FusorClient<_photon_ai_telegram_ts.Update>, {
+}, zod_v4_core.$strip>, z.ZodType<object, unknown, zod_v4_core.$ZodTypeInternals<object, unknown>> | undefined, z.ZodType<object, unknown, zod_v4_core.$ZodTypeInternals<object, unknown>> | undefined, z.ZodType<object, unknown, zod_v4_core.$ZodTypeInternals<object, unknown>> | undefined, FusorClient<_photon_ai_telegram_ts.Update>, {
     id: string;
 }, TelegramSpace, undefined, ProviderMessage<{
     id: string;

package/dist/providers/telegram/index.js

@@ -1,13 +1,13 @@
 import { createRequire as __spectrumCreateRequire } from "node:module"; const require = __spectrumCreateRequire(import.meta.url);
 import {
   telegram
-} from "../../chunk-5LT5J3NR.js";
+} from "../../chunk-TXRWKSNH.js";
 import "../../chunk-34FQGGD7.js";
-import "../../chunk-3B4QH4JG.js";
-import "../../chunk-NNY6LMSC.js";
+import "../../chunk-MHGCPC2V.js";
+import "../../chunk-77U6SH5A.js";
 import "../../chunk-6UZFVXQF.js";
-import "../../chunk-NGC4DJIX.js";
-import "../../chunk-2ILTJC35.js";
+import "../../chunk-LX437ZTY.js";
+import "../../chunk-LQMDV75O.js";
 export {
   telegram
 };

package/dist/providers/terminal/index.d.ts

@@ -1,4 +1,4 @@
-import { P as Platform, a as PlatformDef, f as contentSchema } from '../../types-Bje8aq1k.js';
+import { P as Platform, a as PlatformDef, f as contentSchema } from '../../types-YqCNUDIt.js';
 import { ChildProcess } from 'node:child_process';
 import z__default from 'zod';
 import { Socket } from 'node:net';
@@ -106,9 +106,7 @@ declare const terminal: Platform<PlatformDef<"Terminal", z__default.ZodObject<{
         name: z__default.ZodString;
         description: z__default.ZodOptional<z__default.ZodString>;
     }, z__default.core.$strip>>>;
-}, z__default.core.$strip>, z__default.ZodType<object, unknown, z__default.core.$ZodTypeInternals<object, unknown>> | undefined, z__default.ZodType<object, unknown, z__default.core.$ZodTypeInternals<object, unknown>> | undefined, z__default.ZodObject<{
-    id: z__default.ZodOptional<z__default.ZodString>;
-}, z__default.core.$strip>, TerminalClient, {
+}, z__default.core.$strip>, z__default.ZodType<object, unknown, z__default.core.$ZodTypeInternals<object, unknown>> | undefined, z__default.ZodType<object, unknown, z__default.core.$ZodTypeInternals<object, unknown>> | undefined, z__default.ZodType<object, unknown, z__default.core.$ZodTypeInternals<object, unknown>> | undefined, TerminalClient, {
     id: string;
 }, {
     id: string;

package/dist/providers/terminal/index.js

@@ -1,13 +1,13 @@
 import { createRequire as __spectrumCreateRequire } from "node:module"; const require = __spectrumCreateRequire(import.meta.url);
 import {
   terminal
-} from "../../chunk-U3LXXT3W.js";
-import "../../chunk-NNY6LMSC.js";
-import "../../chunk-U7AWXDH6.js";
+} from "../../chunk-EZ5SNNFS.js";
+import "../../chunk-77U6SH5A.js";
+import "../../chunk-NZ5WCMTY.js";
 import "../../chunk-5XEFJBN2.js";
 import "../../chunk-6UZFVXQF.js";
-import "../../chunk-NGC4DJIX.js";
-import "../../chunk-2ILTJC35.js";
+import "../../chunk-LX437ZTY.js";
+import "../../chunk-LQMDV75O.js";
 export {
   terminal
 };

package/dist/providers/whatsapp-business/index.d.ts

@@ -1,4 +1,4 @@
-import { S as SchemaMessage, P as Platform, a as PlatformDef } from '../../types-Bje8aq1k.js';
+import { S as SchemaMessage, P as Platform, a as PlatformDef } from '../../types-YqCNUDIt.js';
 import { WhatsAppClient } from '@photon-ai/whatsapp-business';
 import * as z from 'zod';
 import z__default from 'zod';

package/dist/providers/whatsapp-business/index.js

@@ -1,14 +1,14 @@
 import { createRequire as __spectrumCreateRequire } from "node:module"; const require = __spectrumCreateRequire(import.meta.url);
 import {
   whatsappBusiness
-} from "../../chunk-Q537JPTG.js";
+} from "../../chunk-UXJ5OO6P.js";
 import "../../chunk-2D27WW5B.js";
 import "../../chunk-3GEJYGZK.js";
-import "../../chunk-U7AWXDH6.js";
+import "../../chunk-NZ5WCMTY.js";
 import "../../chunk-5XEFJBN2.js";
 import "../../chunk-6UZFVXQF.js";
-import "../../chunk-NGC4DJIX.js";
-import "../../chunk-2ILTJC35.js";
+import "../../chunk-LX437ZTY.js";
+import "../../chunk-LQMDV75O.js";
 export {
   whatsappBusiness
 };

package/dist/{types-BD0-kKyv.d.ts → types-BujGKBin.d.ts}

@@ -1,4 +1,4 @@
-import { b as ProjectData, c as Store, d as ProviderMessageRecord, e as Space, M as Message } from './types-Bje8aq1k.js';
+import { b as ProjectData, c as Store, d as ProviderMessageRecord, e as Space, M as Message } from './types-YqCNUDIt.js';
 
 declare const FUSOR_EVENT_BRAND: unique symbol;
 interface FusorEvent<TName extends string = string, TData = unknown> {

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

@@ -4,9 +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;
@@ -124,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;
@@ -166,6 +176,9 @@ declare const contentSchema: z__default.ZodDiscriminatedUnion<[z__default.ZodObj
     } | {
         type: "text";
         text: string;
+    } | {
+        type: "markdown";
+        markdown: string;
     } | {
         type: "attachment";
         id: string;
@@ -177,6 +190,7 @@ declare const contentSchema: z__default.ZodDiscriminatedUnion<[z__default.ZodObj
     } | {
         type: "streamText";
         stream: () => AsyncIterable<string>;
+        format?: "markdown" | "plain" | undefined;
     } | {
         type: "custom";
         raw: unknown;
@@ -273,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;
@@ -301,6 +318,9 @@ declare const contentSchema: z__default.ZodDiscriminatedUnion<[z__default.ZodObj
     } | {
         type: "text";
         text: string;
+    } | {
+        type: "markdown";
+        markdown: string;
     } | {
         type: "attachment";
         id: string;
@@ -312,6 +332,7 @@ declare const contentSchema: z__default.ZodDiscriminatedUnion<[z__default.ZodObj
     } | {
         type: "streamText";
         stream: () => AsyncIterable<string>;
+        format?: "markdown" | "plain" | undefined;
     } | {
         type: "custom";
         raw: unknown;
@@ -408,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;
@@ -440,6 +464,9 @@ declare const contentSchema: z__default.ZodDiscriminatedUnion<[z__default.ZodObj
     } | {
         type: "text";
         text: string;
+    } | {
+        type: "markdown";
+        markdown: string;
     } | {
         type: "attachment";
         id: string;
@@ -451,6 +478,7 @@ declare const contentSchema: z__default.ZodDiscriminatedUnion<[z__default.ZodObj
     } | {
         type: "streamText";
         stream: () => AsyncIterable<string>;
+        format?: "markdown" | "plain" | undefined;
     } | {
         type: "custom";
         raw: unknown;
@@ -547,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;
@@ -575,6 +606,9 @@ declare const contentSchema: z__default.ZodDiscriminatedUnion<[z__default.ZodObj
     } | {
         type: "text";
         text: string;
+    } | {
+        type: "markdown";
+        markdown: string;
     } | {
         type: "attachment";
         id: string;
@@ -586,6 +620,7 @@ declare const contentSchema: z__default.ZodDiscriminatedUnion<[z__default.ZodObj
     } | {
         type: "streamText";
         stream: () => AsyncIterable<string>;
+        format?: "markdown" | "plain" | undefined;
     } | {
         type: "custom";
         raw: unknown;
@@ -682,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;
@@ -700,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 {
@@ -716,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;
     /**
@@ -740,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
@@ -757,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> {
@@ -769,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";
@@ -904,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>`.
@@ -918,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>;
 /**
@@ -1156,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`).
      */
@@ -1171,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;
@@ -1182,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>`.
          *
@@ -1197,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;
     };
@@ -1235,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: {
@@ -1277,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> = [
+type SpaceParamsArgs<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> = [
-    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>;
@@ -1322,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> ? {
@@ -1353,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 ProjectProfile as G, type SharedTokenData as H, type InstanceActionFn as I, type SlackTeamMeta as J, type SlackTokenData as K, SpectrumCloudError as L, type Message as M, type SubscriptionData as N, type SubscriptionStatus as O, type Platform as P, broadcast as Q, cloud as R, type SchemaMessage as S, type TokenData as T, type User as U, mergeStreams as V, stream as W, 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 };
+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": "2.0.0",
+  "version": "3.0.0",
   "description": "Bring agents to any interface — unified messaging SDK for TypeScript.",
   "repository": {
     "type": "git",
@@ -48,6 +48,7 @@
     "@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",