spectrum-ts 1.9.2 → 1.11.3

package/dist/{types-lUyzRurY.d.ts → types-Dd3RC_60.d.ts}

@@ -91,10 +91,10 @@ declare const contentSchema: z__default.ZodDiscriminatedUnion<[z__default.ZodObj
 }, z__default.core.$strip>, z__default.ZodObject<{
     type: z__default.ZodLiteral<"reaction">;
     emoji: z__default.ZodString;
-    target: z__default.ZodCustom<Message, Message>;
+    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<"group">;
-    items: z__default.ZodArray<z__default.ZodCustom<Message, Message>>;
+    items: z__default.ZodArray<z__default.ZodCustom<Message<string, User, Space<unknown>>, Message<string, User, Space<unknown>>>>;
 }, z__default.core.$strip>, z__default.ZodObject<{
     type: z__default.ZodLiteral<"poll">;
     title: z__default.ZodString;
@@ -214,10 +214,10 @@ declare const contentSchema: z__default.ZodDiscriminatedUnion<[z__default.ZodObj
     } | {
         type: "reaction";
         emoji: string;
-        target: Message;
+        target: Message<string, User, Space<unknown>>;
     } | {
         type: "group";
-        items: Message[];
+        items: Message<string, User, Space<unknown>>[];
     } | {
         type: "poll";
         title: string;
@@ -332,10 +332,10 @@ declare const contentSchema: z__default.ZodDiscriminatedUnion<[z__default.ZodObj
     } | {
         type: "reaction";
         emoji: string;
-        target: Message;
+        target: Message<string, User, Space<unknown>>;
     } | {
         type: "group";
-        items: Message[];
+        items: Message<string, User, Space<unknown>>[];
     } | {
         type: "poll";
         title: string;
@@ -374,7 +374,7 @@ declare const contentSchema: z__default.ZodDiscriminatedUnion<[z__default.ZodObj
         type: "typing";
         state: "start" | "stop";
     }>;
-    target: z__default.ZodCustom<Message, Message>;
+    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<"edit">;
     content: z__default.ZodCustom<{
@@ -454,10 +454,10 @@ declare const contentSchema: z__default.ZodDiscriminatedUnion<[z__default.ZodObj
     } | {
         type: "reaction";
         emoji: string;
-        target: Message;
+        target: Message<string, User, Space<unknown>>;
     } | {
         type: "group";
-        items: Message[];
+        items: Message<string, User, Space<unknown>>[];
     } | {
         type: "poll";
         title: string;
@@ -572,10 +572,10 @@ declare const contentSchema: z__default.ZodDiscriminatedUnion<[z__default.ZodObj
     } | {
         type: "reaction";
         emoji: string;
-        target: Message;
+        target: Message<string, User, Space<unknown>>;
     } | {
         type: "group";
-        items: Message[];
+        items: Message<string, User, Space<unknown>>[];
     } | {
         type: "poll";
         title: string;
@@ -614,7 +614,7 @@ declare const contentSchema: z__default.ZodDiscriminatedUnion<[z__default.ZodObj
         type: "typing";
         state: "start" | "stop";
     }>;
-    target: z__default.ZodCustom<Message, Message>;
+    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 {
@@ -625,11 +625,15 @@ type ContentInput = string | ContentBuilder;
 interface User {
     readonly __platform: string;
     readonly id: string;
+    readonly kind?: "agent";
+}
+interface AgentSender extends User {
+    readonly kind: "agent";
 }
 
 interface Space<_Def = unknown> {
     readonly __platform: string;
-    edit(message: OutboundMessage, newContent: ContentInput): Promise<void>;
+    edit(message: Message, 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
@@ -639,32 +643,25 @@ interface Space<_Def = unknown> {
     getMessage(id: string): Promise<Message | undefined>;
     readonly id: string;
     responding<T>(fn: () => T | Promise<T>): Promise<T>;
-    send(content: ContentInput): Promise<OutboundMessage | undefined>;
-    send(...content: [ContentInput, ContentInput, ...ContentInput[]]): Promise<OutboundMessage[]>;
+    send(content: ContentInput): Promise<Message<string, AgentSender> | undefined>;
+    send(...content: [ContentInput, ContentInput, ...ContentInput[]]): Promise<Message<string, AgentSender>[]>;
     startTyping(): Promise<void>;
     stopTyping(): Promise<void>;
 }
 
-interface BaseMessage<TPlatform extends string = string, TSender extends User = User, TSpace extends Space = Space> {
+interface Message<TPlatform extends string = string, TSender extends User = User, TSpace extends Space = Space> {
     content: Content;
+    direction: "inbound" | "outbound";
+    edit(newContent: ContentInput): Promise<void>;
     readonly id: string;
     platform: TPlatform;
     react(reaction: string): Promise<void>;
-    reply(content: ContentInput): Promise<OutboundMessage<TPlatform, TSender, TSpace> | undefined>;
-    reply(...content: [ContentInput, ContentInput, ...ContentInput[]]): Promise<OutboundMessage<TPlatform, TSender, TSpace>[]>;
+    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;
 }
-interface InboundMessage<TPlatform extends string = string, TSender extends User = User, TSpace extends Space = Space> extends BaseMessage<TPlatform, TSender, TSpace> {
-    direction: "inbound";
-    sender: TSender;
-}
-interface OutboundMessage<TPlatform extends string = string, TSender extends User = User, TSpace extends Space = Space> extends BaseMessage<TPlatform, TSender, TSpace> {
-    direction: "outbound";
-    edit(newContent: ContentInput): Promise<void>;
-    sender: TSender | undefined;
-}
-type Message<TPlatform extends string = string, TSender extends User = User, TSpace extends Space = Space> = InboundMessage<TPlatform, TSender, TSpace> | OutboundMessage<TPlatform, TSender, TSpace>;
 
 /**
  * A small per-platform key-value bag, modeled after Swift's `UserDefaults`.
@@ -702,16 +699,31 @@ interface Broadcaster<T> {
 declare function broadcast<T>(source: ManagedStream<T>): Broadcaster<T>;
 
 /**
- * A platform-defined sugar method on `Space`. Each entry is a content-builder
- * factory; the runtime injects a thin wrapper that calls
- * `space.send(factory(...args))` and returns the result.
+ * A platform-defined method on `Space`. The first parameter is bound to the
+ * built `Space` at construction time, so callers only pass the trailing args.
+ * Actions are plain functions returning `Promise<void>` — they can delegate
+ * through `space.send(...)`, call the underlying SDK, or perform any other
+ * side effect.
  *
  * 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 via `Exclude<…, keyof Space>`.
  */
-type SpaceActionFactory = (...args: never[]) => ContentBuilder;
+type SpaceActionFn = (space: Space, ...args: never[]) => Promise<void>;
+/**
+ * A platform-defined method on `Message`. The first parameter is bound to
+ * the message itself (`self`) at build time, so callers only pass the
+ * trailing args. Actions are plain functions returning `Promise<void>` —
+ * they can delegate through `message.space.send(...)`, call the underlying
+ * 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>`.
+ */
+type MessageActionFn = (message: Message, ...args: never[]) => Promise<void>;
 type ResolvedSpace = Pick<Space, "id">;
 type SpaceRef = Pick<Space, "id" | "__platform">;
 type ResolvedUser = Pick<User, "id">;
@@ -785,7 +797,7 @@ interface CreateClientContext<_ConfigSchema extends z__default.ZodType<object>>
  */
 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>>> & {
     messages?: never;
-}) | undefined = undefined> {
+}) | undefined = undefined, _SpaceActions extends Record<string, SpaceActionFn> = Record<never, never>, _MessageActions extends Record<string, MessageActionFn> = Record<never, never>> {
     /**
      * Optional escape hatch: platform actions beyond `send`. Currently the
      * framework recognizes one slot:
@@ -829,6 +841,26 @@ interface PlatformDef<_Name extends string = string, _ConfigSchema extends z__de
     };
     message?: {
         schema?: _MessageSchema;
+        /**
+         * Optional platform-specific sugar methods bound to `PlatformMessage<Def>`.
+         *
+         * Each entry is a `ContentBuilder` factory whose **first parameter** is
+         * the message itself (`self`); `buildMessage` injects a thin wrapper
+         * that supplies `self` and calls `space.send(factory(self, ...args))`.
+         * The wrapper is typed as `(...args) => Promise<void>` on
+         * `PlatformMessage<Def>` via `MessageActionMethods<Def>`.
+         *
+         * Mirrors `space.actions` — `space.actions` lives on the space slot for
+         * chat-level sugar (e.g. `space.background(...)`); `message.actions`
+         * lives here for per-message sugar that needs `self` (e.g.
+         * `message.read()`).
+         *
+         * 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.
+         */
+        actions?: _MessageActions;
     };
     /**
      * Inbound message stream. Returns an `AsyncIterable<ProviderMessageRecord>`
@@ -874,23 +906,25 @@ interface PlatformDef<_Name extends string = string, _ConfigSchema extends z__de
             store: Store;
         }) => Promise<_ResolvedSpace>;
         /**
-         * Optional platform-specific sugar methods bound to `PlatformSpace<Def>`.
+         * Optional platform-specific methods bound to `PlatformSpace<Def>`.
          *
-         * Each entry is a `ContentBuilder` factory; `buildSpace` injects a thin
-         * wrapper that calls `space.send(factory(...args))`. The wrapper is
-         * typed as `(...args) => Promise<OutboundMessage | undefined>` on
-         * `PlatformSpace<Def>` via `SpaceActionMethods<Def>`.
+         * Each entry is a plain async function `(space, ...args) => Promise<void>`;
+         * `buildSpace` injects the built `PlatformSpace<Def>` as the first
+         * argument and exposes the trailing args as the public surface. Action
+         * implementations choose how to dispatch — `space.send(...)`, a direct
+         * SDK call, or any other side effect — and always return `Promise<void>`
+         * to callers.
          *
          * Mirrors the top-level `PlatformDef.actions` slot — `actions` lives at
          * the platform level for capabilities (e.g. `getMessage`); `space.actions`
-         * lives here for sugar that delegates through `send`.
+         * 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.
          */
-        actions?: Record<string, SpaceActionFactory>;
+        actions?: _SpaceActions;
     };
     user: {
         schema?: _UserSchema;
@@ -918,6 +952,7 @@ interface AnyPlatformDef {
     };
     message?: {
         schema?: z__default.ZodType<object>;
+        actions?: Record<string, MessageActionFn>;
     };
     messages: (ctx: any) => AsyncIterable<any>;
     name: string;
@@ -926,7 +961,7 @@ interface AnyPlatformDef {
         schema?: z__default.ZodType<object>;
         params?: z__default.ZodType<object>;
         resolve: (_: any) => Promise<any>;
-        actions?: Record<string, SpaceActionFactory>;
+        actions?: Record<string, SpaceActionFn>;
     };
     user: {
         schema?: z__default.ZodType<object>;
@@ -982,21 +1017,27 @@ 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>;
-type SpaceActionFactories<Def extends AnyPlatformDef> = Def["space"] extends {
+type SpaceActionFns<Def extends AnyPlatformDef> = Def["space"] extends {
     actions?: infer A;
-} ? A extends Record<string, SpaceActionFactory> ? A : Record<string, never> : Record<string, never>;
+} ? A extends Record<string, SpaceActionFn> ? A : Record<string, never> : Record<string, never>;
+type TailArgs<T extends readonly unknown[]> = T extends readonly [
+    unknown,
+    ...infer Rest
+] ? Rest : [];
 type SpaceActionMethods<Def extends AnyPlatformDef> = {
-    [K in Exclude<keyof SpaceActionFactories<Def>, keyof Space>]: (...args: Parameters<SpaceActionFactories<Def>[K]>) => Promise<OutboundMessage | undefined>;
+    [K in Exclude<keyof SpaceActionFns<Def>, keyof Space>]: (...args: TailArgs<Parameters<SpaceActionFns<Def>[K]>>) => Promise<void>;
+};
+type MessageActionFns<Def extends AnyPlatformDef> = NonNullable<Def["message"]> extends {
+    actions?: infer A;
+} ? A extends Record<string, MessageActionFn> ? A : Record<string, never> : Record<string, never>;
+type MessageActionMethods<Def extends AnyPlatformDef> = {
+    [K in Exclude<keyof MessageActionFns<Def>, keyof Message>]: (...args: TailArgs<Parameters<MessageActionFns<Def>[K]>>) => Promise<void>;
 };
 type PlatformSpace<Def extends AnyPlatformDef> = Omit<SpaceShapeOf<Def>, keyof Space | keyof SpaceActionMethods<Def>> & Space & SpaceActionMethods<Def>;
-type PlatformMessage<Def extends AnyPlatformDef> = Omit<SchemaInfer<Def["message"]>, keyof Message> & Message<Def["name"], PlatformUser<Def>, PlatformSpace<Def>>;
-type InboundPlatformMessage<Def extends AnyPlatformDef> = Omit<SchemaInfer<Def["message"]>, keyof InboundMessage> & InboundMessage<Def["name"], PlatformUser<Def>, PlatformSpace<Def>>;
+type PlatformMessage<Def extends AnyPlatformDef> = Omit<SchemaInfer<Def["message"]>, keyof Message | keyof MessageActionMethods<Def>> & Message<Def["name"], PlatformUser<Def>, PlatformSpace<Def>> & MessageActionMethods<Def>;
 type PlatformUser<Def extends AnyPlatformDef> = Omit<ResolvedUserOf<Def>, keyof User> & User;
 type PlatformInstance<Def extends AnyPlatformDef> = {
-    readonly messages: AsyncIterable<[
-        PlatformSpace<Def>,
-        InboundPlatformMessage<Def>
-    ]>;
+    readonly messages: AsyncIterable<[PlatformSpace<Def>, PlatformMessage<Def>]>;
     space(...args: SpaceArgs<Def>): Promise<PlatformSpace<Def>>;
     user(userID: string): Promise<PlatformUser<Def>>;
 } & CustomEventInstanceProperties<Def>;
@@ -1008,7 +1049,7 @@ interface PlatformRuntime {
     config: unknown;
     definition: AnyPlatformDef;
     store: Store;
-    subscribeMessages: () => ManagedStream<[Space, InboundMessage]>;
+    subscribeMessages: () => ManagedStream<[Space, Message]>;
 }
 interface SpectrumLike<Providers extends PlatformProviderConfig[] = PlatformProviderConfig[]> {
     readonly __internal: {
@@ -1026,4 +1067,4 @@ interface Platform<Def extends AnyPlatformDef> {
     (message: Message): PlatformMessage<Def>;
 }
 
-export { type AnyPlatformDef as A, type Broadcaster as B, type ContentBuilder as C, type EventProducer as E, type InboundMessage as I, type Message as M, type OutboundMessage as O, type Platform as P, type SchemaMessage as S, type User as U, type PlatformDef as a, type ContentInput as b, type Content as c, type ProviderMessage as d, type CreateClientContext as e, type Store as f, type PlatformProviderConfig as g, type SpectrumLike as h, type CustomEventStreams as i, type Space as j, type InboundPlatformMessage as k, type ManagedStream as l, type PlatformInstance as m, type PlatformMessage as n, type PlatformRuntime as o, type PlatformSpace as p, type PlatformUser as q, broadcast as r, mergeStreams as s, stream as t };
+export { type AgentSender as A, type Broadcaster as B, type ContentBuilder as C, type EventProducer as E, type Message as M, type Platform as P, type SchemaMessage as S, type User as U, type PlatformDef as a, type Space as b, type ContentInput as c, type Content as d, type ProviderMessage as e, type SpaceActionFn as f, type MessageActionFn as g, type CreateClientContext as h, type Store as i, type PlatformProviderConfig as j, type SpectrumLike as k, type CustomEventStreams as l, type AnyPlatformDef as m, type ManagedStream as n, type PlatformInstance as o, type PlatformMessage as p, type PlatformRuntime as q, type PlatformSpace as r, type PlatformUser as s, broadcast as t, mergeStreams as u, stream as v };

package/package.json

@@ -1,6 +1,16 @@
 {
   "name": "spectrum-ts",
-  "version": "1.9.2",
+  "version": "1.11.3",
+  "description": "Bring agents to any interface — unified messaging SDK for TypeScript.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/photon-hq/spectrum-ts.git",
+    "directory": "packages/spectrum-ts"
+  },
+  "homepage": "https://photon.codes/spectrum",
+  "bugs": {
+    "url": "https://github.com/photon-hq/spectrum-ts/issues"
+  },
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -26,6 +36,7 @@
     "@photon-ai/advanced-imessage": "^0.8.0",
     "@photon-ai/imessage-kit": "^3.0.0",
     "@photon-ai/otel": "^0.1.1",
+    "@photon-ai/slack": "^0.2.0",
     "@photon-ai/whatsapp-business": "^0.1.1",
     "@repeaterjs/repeater": "^3.0.6",
     "better-grpc": "^0.3.2",