spectrum-ts 4.0.0 → 4.2.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-Be0T6E0e.js';
+import '../types-CyfLJXgu.js';
 import 'hotscript';
 import 'zod';
 import 'zod/v4/core';
-import '../attachment-CEpGtZLm.js';
-import '../photo-content-BJKnqgN-.js';
+import '../attachment-CnivEhr6.js';
+import '../read-C4uvozGX.js';
 import '@photon-ai/advanced-imessage';
 import '@photon-ai/imessage-kit';
 import '@photon-ai/slack';
 import '@photon-ai/telegram-ts';
-import '../types-CDYXH2R7.js';
+import '../types-ZgFTj5hJ.js';
 import 'node:child_process';
 import 'node:net';
 import '@photon-ai/whatsapp-business';

package/dist/providers/index.js

@@ -1,29 +1,29 @@
 import { createRequire as __spectrumCreateRequire } from "node:module"; const require = __spectrumCreateRequire(import.meta.url);
-import {
-  imessage
-} from "../chunk-W5HNZ7YT.js";
-import "../chunk-ZR3TKZMT.js";
-import {
-  slack
-} from "../chunk-VEF6FUE7.js";
 import {
   telegram
-} from "../chunk-57NECZQZ.js";
-import "../chunk-34FQGGD7.js";
-import "../chunk-LZXPLXZF.js";
+} from "../chunk-N6THJDZV.js";
 import {
   terminal
-} from "../chunk-PV4AVMNN.js";
-import "../chunk-FAIFTUV2.js";
+} from "../chunk-ARL2NOBO.js";
 import {
   whatsappBusiness
-} from "../chunk-5VCWWPFW.js";
+} from "../chunk-DMPDLSFU.js";
+import "../chunk-34FQGGD7.js";
+import "../chunk-FAIFTUV2.js";
+import {
+  imessage
+} from "../chunk-NLMQ75LH.js";
+import "../chunk-ZR3TKZMT.js";
+import "../chunk-LZXPLXZF.js";
 import "../chunk-2D27WW5B.js";
-import "../chunk-3GEJYGZK.js";
 import "../chunk-A37PM5N2.js";
-import "../chunk-5XEFJBN2.js";
 import "../chunk-6UZFVXQF.js";
-import "../chunk-OGTHPDG7.js";
+import {
+  slack
+} from "../chunk-WXLQNANA.js";
+import "../chunk-3GEJYGZK.js";
+import "../chunk-5XEFJBN2.js";
+import "../chunk-B52VPQO3.js";
 import "../chunk-UXAKIXVM.js";
 export {
   imessage,

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

@@ -1,4 +1,4 @@
-import { S as SchemaMessage, P as Platform, a as PlatformDef } from '../../types-Be0T6E0e.js';
+import { a as SchemaMessage, P as Platform, b as PlatformDef } from '../../types-CyfLJXgu.js';
 import * as z from 'zod';
 import z__default from 'zod';
 import * as _photon_ai_slack from '@photon-ai/slack';

package/dist/providers/slack/index.js

@@ -1,10 +1,10 @@
 import { createRequire as __spectrumCreateRequire } from "node:module"; const require = __spectrumCreateRequire(import.meta.url);
 import {
   slack
-} from "../../chunk-VEF6FUE7.js";
+} from "../../chunk-WXLQNANA.js";
 import "../../chunk-3GEJYGZK.js";
 import "../../chunk-5XEFJBN2.js";
-import "../../chunk-OGTHPDG7.js";
+import "../../chunk-B52VPQO3.js";
 import "../../chunk-UXAKIXVM.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-Be0T6E0e.js';
+import { P as Platform, b as PlatformDef, g as ProviderMessage } from '../../types-CyfLJXgu.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-CDYXH2R7.js';
+import { F as FusorClient } from '../../types-ZgFTj5hJ.js';
 import 'hotscript';
 
 interface TelegramSpace {

package/dist/providers/telegram/index.js

@@ -1,12 +1,12 @@
 import { createRequire as __spectrumCreateRequire } from "node:module"; const require = __spectrumCreateRequire(import.meta.url);
 import {
   telegram
-} from "../../chunk-57NECZQZ.js";
+} from "../../chunk-N6THJDZV.js";
 import "../../chunk-34FQGGD7.js";
-import "../../chunk-LZXPLXZF.js";
 import "../../chunk-FAIFTUV2.js";
+import "../../chunk-LZXPLXZF.js";
 import "../../chunk-6UZFVXQF.js";
-import "../../chunk-OGTHPDG7.js";
+import "../../chunk-B52VPQO3.js";
 import "../../chunk-UXAKIXVM.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-Be0T6E0e.js';
+import { P as Platform, b as PlatformDef, f as contentSchema } from '../../types-CyfLJXgu.js';
 import { ChildProcess } from 'node:child_process';
 import z__default from 'zod';
 import { Socket } from 'node:net';

package/dist/providers/terminal/index.js

@@ -1,12 +1,12 @@
 import { createRequire as __spectrumCreateRequire } from "node:module"; const require = __spectrumCreateRequire(import.meta.url);
 import {
   terminal
-} from "../../chunk-PV4AVMNN.js";
+} from "../../chunk-ARL2NOBO.js";
 import "../../chunk-FAIFTUV2.js";
 import "../../chunk-A37PM5N2.js";
-import "../../chunk-5XEFJBN2.js";
 import "../../chunk-6UZFVXQF.js";
-import "../../chunk-OGTHPDG7.js";
+import "../../chunk-5XEFJBN2.js";
+import "../../chunk-B52VPQO3.js";
 import "../../chunk-UXAKIXVM.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-Be0T6E0e.js';
+import { a as SchemaMessage, P as Platform, b as PlatformDef } from '../../types-CyfLJXgu.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,13 +1,13 @@
 import { createRequire as __spectrumCreateRequire } from "node:module"; const require = __spectrumCreateRequire(import.meta.url);
 import {
   whatsappBusiness
-} from "../../chunk-5VCWWPFW.js";
+} from "../../chunk-DMPDLSFU.js";
 import "../../chunk-2D27WW5B.js";
-import "../../chunk-3GEJYGZK.js";
 import "../../chunk-A37PM5N2.js";
-import "../../chunk-5XEFJBN2.js";
 import "../../chunk-6UZFVXQF.js";
-import "../../chunk-OGTHPDG7.js";
+import "../../chunk-3GEJYGZK.js";
+import "../../chunk-5XEFJBN2.js";
+import "../../chunk-B52VPQO3.js";
 import "../../chunk-UXAKIXVM.js";
 export {
   whatsappBusiness

package/dist/read-C4uvozGX.d.ts

@@ -0,0 +1,53 @@
+import z__default from 'zod';
+import { M as Message, U as User, S as Space, C as ContentBuilder } from './types-CyfLJXgu.js';
+
+/**
+ * Shared building blocks for photo-style content (chat background, group
+ * avatar/icon, …) whose builders all share the same `set | clear` shape and
+ * the same `"clear"` reserved-string sentinel.
+ *
+ * Keeping the action schema and `buildPhotoAction` factory here means both
+ * `background()` and `avatar()` parse against the same structural definition
+ * and any DX fix (mime inference, read caching, sentinel docs) lands once.
+ */
+declare const CLEAR_SENTINEL: "clear";
+type PhotoInput = typeof CLEAR_SENTINEL | string | Buffer | URL;
+
+/**
+ * A `read` marks the conversation as read **up to** `target`, surfacing a
+ * read receipt to the sender where the platform supports one.
+ *
+ * `space.send(read(message))` is the canonical outbound API;
+ * `message.read()` and `space.read(message)` are sugar that delegate here.
+ * Reads are fire-and-forget — providers handle them inside their `send`
+ * action and the resolved value is `undefined`.
+ *
+ * Granularity is per-platform:
+ *
+ * - WhatsApp Business: per-message receipt via `markRead(target.id)`, which
+ *   also marks every earlier message in the conversation as read.
+ * - iMessage (remote): chat-level `chats.markRead(chatGuid)` — `target` only
+ *   identifies the chat, and **every** unread message in it is marked read.
+ *   Local mode rejects with `UnsupportedError` (warned and skipped).
+ * - Telegram / Slack: silently no-op. Neither surfaces read state for bot
+ *   conversations (Telegram bot chats are effectively auto-read), so the
+ *   signal is vacuously satisfied — same best-effort contract as `typing`.
+ */
+declare const readSchema: z__default.ZodObject<{
+    type: z__default.ZodLiteral<"read">;
+    target: z__default.ZodCustom<Message<string, User, Space<unknown>>, Message<string, User, Space<unknown>>>;
+}, z__default.core.$strip>;
+type Read = z__default.infer<typeof readSchema>;
+/**
+ * Construct a `read` content value marking the conversation read up to
+ * `target`.
+ *
+ * Only inbound messages (those received from a user) can be marked read;
+ * calling this with an outbound target throws at build time so the misuse
+ * surfaces before the send pipeline runs. The target is required (not
+ * `Message | undefined` like `unsend`): read targets come from the inbound
+ * stream, never from a chainable `send()` result.
+ */
+declare function read(target: Message): ContentBuilder;
+
+export { type PhotoInput as P, type Read as R, read as r };

package/dist/{types-Be0T6E0e.d.ts → types-CyfLJXgu.d.ts}

@@ -741,6 +741,9 @@ declare const contentSchema: z__default.ZodDiscriminatedUnion<[z__default.ZodObj
 }, 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>, z__default.ZodObject<{
+    type: z__default.ZodLiteral<"read">;
+    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 {
@@ -832,6 +835,19 @@ interface Space<_Def = unknown> {
      */
     getMessage(id: string): Promise<Message | undefined>;
     readonly id: string;
+    /**
+     * Mark the conversation as read up to `message`, surfacing a read receipt
+     * to the sender where the platform supports one. Sugar for
+     * `send(read(message))`. Fire-and-forget; only inbound messages can be
+     * marked read.
+     *
+     * Granularity is per-platform: WhatsApp Business issues a receipt for
+     * `message` and everything before it; iMessage (remote) marks the whole
+     * chat read. Platforms with no read-receipt concept for bot conversations
+     * (Telegram, Slack) silently no-op, so the signal is best-effort
+     * everywhere — same contract as `startTyping()`.
+     */
+    read(message: Message): Promise<void>;
     /**
      * Rename the current chat. Sugar for `send(rename(displayName))`.
      *
@@ -882,6 +898,15 @@ interface Message<TPlatform extends string = string, TSender extends User = User
     react(reaction: string): Promise<(Message<TPlatform, AgentSender, TSpace> & {
         content: Reaction;
     }) | undefined>;
+    /**
+     * Mark this message (and everything before it in the conversation) as
+     * read. Sugar for `space.send(read(this))`. Reads are fire-and-forget;
+     * per-platform granularity and support (e.g. iMessage marks the whole
+     * chat; Telegram/Slack silently no-op) surface from the provider's send
+     * action. Only inbound messages can be marked read; calling this on an
+     * outbound message throws.
+     */
+    read(): Promise<void>;
     reply(content: ContentInput): Promise<Message<TPlatform, AgentSender, TSpace> | undefined>;
     reply(...content: [ContentInput, ContentInput, ...ContentInput[]]): Promise<Message<TPlatform, AgentSender, TSpace>[]>;
     sender: TSender | undefined;
@@ -1502,4 +1527,4 @@ interface Platform<Def extends AnyPlatformDef> {
     (message: Message): PlatformMessage<Def>;
 }
 
-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 };
+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 Space 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 SchemaMessage as a, type PlatformDef as b, type ProjectData as c, type Store as d, type ProviderMessageRecord 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/dist/{types-CDYXH2R7.d.ts → types-ZgFTj5hJ.d.ts}

@@ -1,4 +1,4 @@
-import { b as ProjectData, c as Store, d as ProviderMessageRecord, e as Space, M as Message } from './types-Be0T6E0e.js';
+import { c as ProjectData, d as Store, e as ProviderMessageRecord, S as Space, M as Message } from './types-CyfLJXgu.js';
 
 declare const FUSOR_EVENT_BRAND: unique symbol;
 interface FusorEvent<TName extends string = string, TData = unknown> {
@@ -62,11 +62,16 @@ interface FusorClient<TPayload = unknown> {
 type WebhookHandler = (space: Space, message: Message) => void | Promise<void>;
 /**
  * Raw webhook input for HTTP servers without Web `Request`/`Response` (Express,
- * raw Node). `body` MUST be the exact bytes fusor POSTed — never a re-encoded
- * JSON/text body — so the protobuf decode works. `headers` are accepted (so the
- * natural `{ headers: req.headers, body: req.body }` shape keeps working) but are
- * not read: inbound authenticity is established by the per-platform `verify()`,
- * which reads the inner request reconstructed from the envelope.
+ * raw Node). `body` MUST be the exact bytes POSTed — never a re-encoded
+ * JSON/text body — so both the protobuf decode (fusor) and the HMAC
+ * verification (native Spectrum webhook) work.
+ *
+ * `headers` ARE read for **native Spectrum webhooks**: `X-Spectrum-Signature` /
+ * `X-Spectrum-Timestamp` carry the HMAC verified against
+ * `Spectrum({ webhookSecret })`, and the signature header also selects the
+ * native path. For **fusor** envelopes they are ignored (authenticity is the
+ * per-platform `verify()` reading the inner reconstructed request). The natural
+ * `{ headers: req.headers, body: req.body }` shape works for both.
  */
 interface WebhookRawRequest {
     body: Uint8Array | ArrayBuffer;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spectrum-ts",
-  "version": "4.0.0",
+  "version": "4.2.0",
   "description": "Bring agents to any interface — unified messaging SDK for TypeScript.",
   "repository": {
     "type": "git",
@@ -27,6 +27,18 @@
       "types": "./dist/authoring.d.ts",
       "default": "./dist/authoring.js"
     },
+    "./elysia": {
+      "types": "./dist/elysia.d.ts",
+      "default": "./dist/elysia.js"
+    },
+    "./express": {
+      "types": "./dist/express.d.ts",
+      "default": "./dist/express.js"
+    },
+    "./hono": {
+      "types": "./dist/hono.d.ts",
+      "default": "./dist/hono.js"
+    },
     "./providers": {
       "types": "./dist/providers/index.d.ts",
       "default": "./dist/providers/index.js"
@@ -55,12 +67,24 @@
     "zod": "^4.2.1"
   },
   "peerDependencies": {
+    "elysia": "^1",
+    "express": "^4 || ^5",
     "ffmpeg-static": "^5",
+    "hono": "^4",
     "typescript": "^5 || ^6.0.0"
   },
   "peerDependenciesMeta": {
+    "elysia": {
+      "optional": true
+    },
+    "express": {
+      "optional": true
+    },
     "ffmpeg-static": {
       "optional": true
+    },
+    "hono": {
+      "optional": true
     }
   },
   "license": "MIT"

package/dist/photo-content-BJKnqgN-.d.ts

@@ -1,13 +0,0 @@
-/**
- * Shared building blocks for photo-style content (chat background, group
- * avatar/icon, …) whose builders all share the same `set | clear` shape and
- * the same `"clear"` reserved-string sentinel.
- *
- * Keeping the action schema and `buildPhotoAction` factory here means both
- * `background()` and `avatar()` parse against the same structural definition
- * and any DX fix (mime inference, read caching, sentinel docs) lands once.
- */
-declare const CLEAR_SENTINEL: "clear";
-type PhotoInput = typeof CLEAR_SENTINEL | string | Buffer | URL;
-
-export type { PhotoInput as P };