spectrum-ts 4.0.0 → 4.1.0

package/dist/{attachment-CEpGtZLm.d.ts → attachment-CnivEhr6.d.ts}

@@ -1,5 +1,5 @@
 import z__default from 'zod';
-import { C as ContentBuilder } from './types-Be0T6E0e.js';
+import { C as ContentBuilder } from './types-CyfLJXgu.js';
 
 declare const attachmentSchema: z__default.ZodObject<{
     type: z__default.ZodLiteral<"attachment">;

package/dist/{authoring-CP3vRza8.d.ts → authoring-b9AhXgPI.d.ts}

@@ -1,7 +1,7 @@
-import './attachment-CEpGtZLm.js';
+import './attachment-CnivEhr6.js';
 import vCard from 'vcf';
 import z__default from 'zod';
-import { U as User, C as ContentBuilder, M as Message, e as Space, h as ContentInput } from './types-Be0T6E0e.js';
+import { U as User, C as ContentBuilder, M as Message, S as Space, h as ContentInput } from './types-CyfLJXgu.js';
 
 declare const nameSchema: z__default.ZodObject<{
     formatted: z__default.ZodOptional<z__default.ZodString>;

package/dist/authoring.d.ts

@@ -1,6 +1,6 @@
-export { c as asAttachment } from './attachment-CEpGtZLm.js';
-export { q as asContact, s as asCustom, u as asGroup, w as asPoll, x as asPollOption, y as asRichlink, z as asText, A as asVoice } from './authoring-CP3vRza8.js';
-export { d as ProviderMessageRecord, $ as asReaction } from './types-Be0T6E0e.js';
+export { c as asAttachment } from './attachment-CnivEhr6.js';
+export { q as asContact, s as asCustom, u as asGroup, w as asPoll, x as asPollOption, y as asRichlink, z as asText, A as asVoice } from './authoring-b9AhXgPI.js';
+export { e as ProviderMessageRecord, $ as asReaction } from './types-CyfLJXgu.js';
 import 'zod';
 import 'vcf';
 import 'hotscript';

package/dist/{chunk-5VCWWPFW.js → chunk-3KWFP4L2.js}

@@ -15,7 +15,7 @@ import {
 import {
   UnsupportedError,
   definePlatform
-} from "./chunk-OGTHPDG7.js";
+} from "./chunk-B52VPQO3.js";
 import {
   asAttachment,
   asCustom,
@@ -644,6 +644,10 @@ var send = async (clients, spaceId, content) => {
   if (content.type === "typing") {
     return;
   }
+  if (content.type === "read") {
+    await primary(clients).messages.markRead(content.target.id);
+    return;
+  }
   const client = primary(clients);
   switch (content.type) {
     case "text":

package/dist/{chunk-OGTHPDG7.js → chunk-B52VPQO3.js}

@@ -46,10 +46,10 @@ var resolveMimeType = (input, mimeType, contentLabel) => {
     `Unable to resolve MIME type for ${contentLabel}. Pass options.mimeType explicitly.`
   );
 };
-var cachedRead = (read) => {
+var cachedRead = (read2) => {
   let cached;
   return () => {
-    cached ??= read().catch((err) => {
+    cached ??= read2().catch((err) => {
       cached = void 0;
       throw err;
     });
@@ -61,16 +61,16 @@ var buildPhotoAction = (input, options, contentLabel) => {
     return { kind: "clear" };
   }
   const mimeType = resolveMimeType(input, options?.mimeType, contentLabel);
-  let read;
+  let read2;
   if (input instanceof URL) {
-    read = cachedRead(async () => (await fetchUrlBytes(input)).data);
+    read2 = cachedRead(async () => (await fetchUrlBytes(input)).data);
   } else if (typeof input === "string") {
-    read = cachedRead(() => readFile(input));
+    read2 = cachedRead(() => readFile(input));
   } else {
     const snapshot = Buffer.from(input);
-    read = cachedRead(async () => snapshot);
+    read2 = cachedRead(async () => snapshot);
   }
-  return { kind: "set", read, mimeType };
+  return { kind: "set", read: read2, mimeType };
 };
 
 // src/content/avatar.ts
@@ -116,7 +116,7 @@ function edit(content, target) {
       if (!resolved) {
         throw new Error("edit() requires content");
       }
-      if (resolved.type === "edit" || resolved.type === "reply" || resolved.type === "reaction" || resolved.type === "group" || resolved.type === "typing" || resolved.type === "rename" || resolved.type === "avatar" || resolved.type === "unsend") {
+      if (resolved.type === "edit" || resolved.type === "reply" || resolved.type === "reaction" || resolved.type === "group" || resolved.type === "typing" || resolved.type === "rename" || resolved.type === "avatar" || resolved.type === "unsend" || resolved.type === "read") {
         throw new Error(`edit() cannot wrap "${resolved.type}" content`);
       }
       return asEdit({ content: resolved, target });
@@ -138,11 +138,34 @@ function markdown(source, options) {
   return streamTextBuilder("markdown", source, options);
 }
 
-// src/content/rename.ts
+// src/content/read.ts
 import z5 from "zod";
-var renameSchema = z5.object({
-  type: z5.literal("rename"),
-  displayName: z5.string().min(1, "rename() displayName must be non-empty")
+var isMessage2 = (v) => typeof v === "object" && v !== null && "id" in v && "content" in v;
+var readSchema2 = z5.object({
+  type: z5.literal("read"),
+  target: z5.custom(isMessage2, {
+    message: "read target must be a Message"
+  })
+});
+var asRead = (input) => readSchema2.parse({ type: "read", ...input });
+function read(target) {
+  return {
+    build: async () => {
+      if (target.direction !== "inbound") {
+        throw new Error(
+          `read() target must be an inbound message (got direction "${target.direction}", message id "${target.id}")`
+        );
+      }
+      return asRead({ target });
+    }
+  };
+}
+
+// src/content/rename.ts
+import z6 from "zod";
+var renameSchema = z6.object({
+  type: z6.literal("rename"),
+  displayName: z6.string().min(1, "rename() displayName must be non-empty")
 });
 function rename(displayName) {
   return {
@@ -151,15 +174,15 @@ function rename(displayName) {
 }
 
 // src/content/reply.ts
-import z6 from "zod";
-var isMessage2 = (v) => typeof v === "object" && v !== null && "id" in v && "content" in v;
+import z7 from "zod";
+var isMessage3 = (v) => typeof v === "object" && v !== null && "id" in v && "content" in v;
 var isContent2 = (v) => typeof v === "object" && v !== null && "type" in v && typeof v.type === "string";
-var replySchema = z6.object({
-  type: z6.literal("reply"),
-  content: z6.custom(isContent2, {
+var replySchema = z7.object({
+  type: z7.literal("reply"),
+  content: z7.custom(isContent2, {
     message: "reply content must be a Content value"
   }),
-  target: z6.custom(isMessage2, {
+  target: z7.custom(isMessage3, {
     message: "reply target must be a Message"
   })
 });
@@ -176,7 +199,7 @@ function reply(content, target) {
       if (!resolved) {
         throw new Error("reply() requires content");
       }
-      if (resolved.type === "reply" || resolved.type === "edit" || resolved.type === "reaction" || resolved.type === "group" || resolved.type === "typing" || resolved.type === "rename" || resolved.type === "avatar" || resolved.type === "unsend") {
+      if (resolved.type === "reply" || resolved.type === "edit" || resolved.type === "reaction" || resolved.type === "group" || resolved.type === "typing" || resolved.type === "rename" || resolved.type === "avatar" || resolved.type === "unsend" || resolved.type === "read") {
         throw new Error(`reply() cannot wrap "${resolved.type}" content`);
       }
       return asReply({ content: resolved, target });
@@ -185,10 +208,10 @@ function reply(content, target) {
 }
 
 // src/content/typing.ts
-import z7 from "zod";
-var typingSchema = z7.object({
-  type: z7.literal("typing"),
-  state: z7.enum(["start", "stop"])
+import z8 from "zod";
+var typingSchema = z8.object({
+  type: z8.literal("typing"),
+  state: z8.enum(["start", "stop"])
 });
 function typing(state = "start") {
   return {
@@ -197,11 +220,11 @@ function typing(state = "start") {
 }
 
 // src/content/unsend.ts
-import z8 from "zod";
-var isMessage3 = (v) => typeof v === "object" && v !== null && "id" in v && "content" in v;
-var unsendSchema = z8.object({
-  type: z8.literal("unsend"),
-  target: z8.custom(isMessage3, {
+import z9 from "zod";
+var isMessage4 = (v) => typeof v === "object" && v !== null && "id" in v && "content" in v;
+var unsendSchema = z9.object({
+  type: z9.literal("unsend"),
+  target: z9.custom(isMessage4, {
     message: "unsend target must be a Message"
   })
 });
@@ -545,7 +568,8 @@ var FIRE_AND_FORGET_TYPES = /* @__PURE__ */ new Set([
   "edit",
   "rename",
   "avatar",
-  "unsend"
+  "unsend",
+  "read"
 ]);
 var isFireAndForget = (item) => FIRE_AND_FORGET_TYPES.has(item.type) || item.__fireAndForget === true;
 var RESERVED_SPACE_KEYS = /* @__PURE__ */ new Set([
@@ -554,6 +578,7 @@ var RESERVED_SPACE_KEYS = /* @__PURE__ */ new Set([
   "send",
   "edit",
   "unsend",
+  "read",
   "getMessage",
   "rename",
   "avatar",
@@ -569,6 +594,7 @@ var RESERVED_MESSAGE_KEYS = /* @__PURE__ */ new Set([
   "id",
   "platform",
   "react",
+  "read",
   "reply",
   "sender",
   "space",
@@ -938,6 +964,9 @@ function buildSpace(params) {
     unsend: async (message) => {
       await space.send(unsend(message));
     },
+    read: async (message) => {
+      await space.send(read(message));
+    },
     getMessage: getMessageImpl,
     rename: async (displayName) => {
       await space.send(rename(displayName));
@@ -1010,6 +1039,15 @@ function buildMessage(params) {
     }
     await space.send(unsend(target));
   };
+  const read2 = async () => {
+    const target = requireBuiltMessage("read");
+    if (target.direction !== "inbound") {
+      throw new Error(
+        `cannot mark message ${target.id} as read: only inbound messages can be marked read (direction: "${target.direction}")`
+      );
+    }
+    await space.send(read(target));
+  };
   const buildSenderWithPlatform = () => {
     if (params.sender === void 0) {
       return;
@@ -1046,6 +1084,7 @@ function buildMessage(params) {
     direction: params.direction,
     platform: definition.name,
     react,
+    read: read2,
     reply: reply2,
     edit: edit2,
     unsend: unsend2,
@@ -1325,6 +1364,7 @@ export {
   markdownSchema,
   asMarkdown,
   markdown,
+  read,
   rename,
   reply,
   typing,

package/dist/{chunk-W5HNZ7YT.js → chunk-DMT6BFJV.js}

@@ -30,7 +30,7 @@ import {
   definePlatform,
   markdownSchema,
   photoActionSchema
-} from "./chunk-OGTHPDG7.js";
+} from "./chunk-B52VPQO3.js";
 import {
   asAttachment,
   asCustom,
@@ -172,68 +172,38 @@ function effect(input, messageEffect) {
   };
 }
 
-// src/providers/imessage/content/read.ts
-import z4 from "zod";
-var isMessage = (v) => typeof v === "object" && v !== null && "id" in v && "content" in v;
-var readSchema = z4.object({
-  type: z4.literal("read"),
-  __platform: z4.literal("iMessage"),
-  __fireAndForget: z4.literal(true),
-  target: z4.custom(isMessage, {
-    message: "read target must be a Message"
-  })
-});
-var isRead = (v) => readSchema.safeParse(v).success;
-function read(target) {
-  return {
-    build: async () => {
-      if (target.direction !== "inbound") {
-        throw new Error(
-          `read() target must be an inbound message (got direction "${target.direction}", message id "${target.id}")`
-        );
-      }
-      return readSchema.parse({
-        type: "read",
-        __platform: "iMessage",
-        __fireAndForget: true,
-        target
-      });
-    }
-  };
-}
-
 // src/providers/imessage/auth.ts
 import { createClient } from "@photon-ai/advanced-imessage";
 
 // src/providers/imessage/types.ts
 import { IMessageSDK } from "@photon-ai/imessage-kit";
-import z5 from "zod";
+import z4 from "zod";
 var SHARED_PHONE = "shared";
 var isLocal = (client) => client instanceof IMessageSDK;
-var clientEntry = z5.object({
-  address: z5.string(),
-  token: z5.string(),
-  phone: z5.string()
+var clientEntry = z4.object({
+  address: z4.string(),
+  token: z4.string(),
+  phone: z4.string()
 });
-var configSchema = z5.union([
-  z5.object({ local: z5.literal(true) }),
-  z5.object({
-    local: z5.literal(false).optional().default(false),
-    clients: clientEntry.or(z5.array(clientEntry)).optional()
+var configSchema = z4.union([
+  z4.object({ local: z4.literal(true) }),
+  z4.object({
+    local: z4.literal(false).optional().default(false),
+    clients: clientEntry.or(z4.array(clientEntry)).optional()
   })
 ]);
-var userSchema = z5.object({});
-var spaceSchema = z5.object({
-  id: z5.string(),
-  type: z5.enum(["dm", "group"]),
-  phone: z5.string()
+var userSchema = z4.object({});
+var spaceSchema = z4.object({
+  id: z4.string(),
+  type: z4.enum(["dm", "group"]),
+  phone: z4.string()
 });
-var spaceParamsSchema = z5.object({
-  phone: z5.string().optional()
+var spaceParamsSchema = z4.object({
+  phone: z4.string().optional()
 });
-var messageSchema = z5.object({
-  partIndex: z5.number().int().nonnegative().optional(),
-  parentId: z5.string().optional()
+var messageSchema = z4.object({
+  partIndex: z4.number().int().nonnegative().optional(),
+  parentId: z4.string().optional()
 });
 
 // src/providers/imessage/auth.ts
@@ -2852,23 +2822,11 @@ var imessage = definePlatform("iMessage", {
       // local-mode iMessage is identical to the canonical form.
       background: async (space, input, opts) => {
         await space.send(background(input, opts));
-      },
-      // Sugar: `space.read(message)` → `space.send(read(message))`.
-      read: async (space, message) => {
-        await space.send(read(message));
       }
     }
   },
   message: {
-    schema: messageSchema,
-    actions: {
-      // Sugar: `message.read()` → `message.space.send(read(self))`.
-      // `buildMessage` injects the message as the first argument; callers
-      // pass nothing.
-      read: async (message) => {
-        await message.space.send(read(message));
-      }
-    }
+    schema: messageSchema
   },
   messages: ({ client, projectConfig }) => isLocal(client) ? messages2(client) : messages4(client, projectConfig),
   send: async ({ space, content, client }) => {
@@ -2941,12 +2899,12 @@ var imessage = definePlatform("iMessage", {
       await handleAvatar(client, space, content);
       return;
     }
-    if (isBackground(content)) {
-      await handleBackground(client, space, content);
+    if (content.type === "read") {
+      await handleRead(client, space);
       return;
     }
-    if (isRead(content)) {
-      await handleRead(client, space);
+    if (isBackground(content)) {
+      await handleBackground(client, space, content);
       return;
     }
     if (isCustomizedMiniApp(content)) {
@@ -3018,6 +2976,5 @@ export {
   background,
   customizedMiniApp,
   effect,
-  read,
   imessage
 };

package/dist/{chunk-PV4AVMNN.js → chunk-IM5ADDZS.js}

@@ -15,7 +15,7 @@ import {
 import {
   UnsupportedError,
   definePlatform
-} from "./chunk-OGTHPDG7.js";
+} from "./chunk-B52VPQO3.js";
 import {
   asAttachment,
   asCustom,

package/dist/{chunk-57NECZQZ.js → chunk-U3QQ56YZ.js}

@@ -16,7 +16,7 @@ import {
   asMarkdown,
   definePlatform,
   renderInlineTokens
-} from "./chunk-OGTHPDG7.js";
+} from "./chunk-B52VPQO3.js";
 import {
   asAttachment,
   asCustom,
@@ -793,6 +793,8 @@ var send = async ({
       return await sendReaction(client, space, content);
     case "typing":
       return await sendTyping(client, space, content.state);
+    case "read":
+      return;
     case "edit":
       return await sendEdit(client, space, content);
     case "group":

package/dist/{chunk-VEF6FUE7.js → chunk-WXLQNANA.js}

@@ -9,7 +9,7 @@ import {
 import {
   UnsupportedError,
   definePlatform
-} from "./chunk-OGTHPDG7.js";
+} from "./chunk-B52VPQO3.js";
 import {
   asAttachment,
   asCustom,
@@ -350,6 +350,9 @@ var send = async (client, space, content) => {
   if (content.type === "typing") {
     return;
   }
+  if (content.type === "read") {
+    return;
+  }
   return await sendContent(client, space, content);
 };
 var sendContent = async (client, space, content, threadTs) => {

package/dist/index.d.ts

@@ -1,12 +1,13 @@
-export { A as Attachment, a as AttachmentInput, b as attachment } from './attachment-CEpGtZLm.js';
+export { A as Attachment, a as AttachmentInput, b as attachment } from './attachment-CnivEhr6.js';
 import z__default from 'zod';
-import { P as PhotoInput } from './photo-content-BJKnqgN-.js';
-import { C as ContentBuilder, M as Message, U as User, e as Space, h as ContentInput, i as Content, g as ProviderMessage, E as EventProducer, j as SpaceActionFn, k as MessageActionFn, I as InstanceActionFn, l as CreateClientContext, c as Store, a as PlatformDef, P as Platform, m as PlatformProviderConfig, n as SpectrumLike, o as CustomEventStreams, A as AgentSender, b as ProjectData } from './types-Be0T6E0e.js';
-export { p as AnyPlatformDef, B as Broadcaster, q as CloudPlatform, D as DedicatedTokenData, F as FusorTokenData, r as ImessageInfoData, s as ManagedStream, t as PlatformInstance, u as PlatformMessage, v as PlatformRuntime, w as PlatformSpace, x as PlatformStatus, y as PlatformUser, z as PlatformsData, G as ProjectProfile, R as Reaction, H as ReactionBuilder, S as SchemaMessage, J as SharedTokenData, K as SlackTeamMeta, L as SlackTokenData, N as SpaceNamespace, O as SpectrumCloudError, Q as SubscriptionData, T as SubscriptionStatus, V as TokenData, W as broadcast, X as cloud, Y as mergeStreams, Z as reaction, _ as stream } from './types-Be0T6E0e.js';
-import { S as StreamTextSource, T as TextStreamOptions, C as ContactInput, a as Contact } from './authoring-CP3vRza8.js';
-export { b as ContactAddress, c as ContactDetails, d as ContactEmail, e as ContactName, f as ContactOrg, g as ContactPhone, D as DeltaExtractor, G as Group, P as Poll, h as PollChoice, i as PollChoiceInput, j as PollOption, R as Richlink, k as StreamText, V as Voice, l as contact, m as custom, n as group, o as option, p as poll, r as richlink, t as text, v as voice } from './authoring-CP3vRza8.js';
-import { a as FusorVerify, F as FusorClient, b as FusorMessages, W as WebhookHandler, c as WebhookRawRequest, d as WebhookRawResult } from './types-CDYXH2R7.js';
-export { e as FusorEvent, f as FusorMessagesCtx, g as FusorMessagesReturn, h as FusorReply, i as FusorRespond, j as FusorVerifyRequest, k as fusorEvent, l as isFusorEvent } from './types-CDYXH2R7.js';
+import { P as PhotoInput } from './read-C4uvozGX.js';
+export { R as Read, r as read } from './read-C4uvozGX.js';
+import { C as ContentBuilder, M as Message, U as User, S as Space, h as ContentInput, i as Content, g as ProviderMessage, E as EventProducer, j as SpaceActionFn, k as MessageActionFn, I as InstanceActionFn, l as CreateClientContext, d as Store, b as PlatformDef, P as Platform, m as PlatformProviderConfig, n as SpectrumLike, o as CustomEventStreams, A as AgentSender, c as ProjectData } from './types-CyfLJXgu.js';
+export { p as AnyPlatformDef, B as Broadcaster, q as CloudPlatform, D as DedicatedTokenData, F as FusorTokenData, r as ImessageInfoData, s as ManagedStream, t as PlatformInstance, u as PlatformMessage, v as PlatformRuntime, w as PlatformSpace, x as PlatformStatus, y as PlatformUser, z as PlatformsData, G as ProjectProfile, R as Reaction, H as ReactionBuilder, a as SchemaMessage, J as SharedTokenData, K as SlackTeamMeta, L as SlackTokenData, N as SpaceNamespace, O as SpectrumCloudError, Q as SubscriptionData, T as SubscriptionStatus, V as TokenData, W as broadcast, X as cloud, Y as mergeStreams, Z as reaction, _ as stream } from './types-CyfLJXgu.js';
+import { S as StreamTextSource, T as TextStreamOptions, C as ContactInput, a as Contact } from './authoring-b9AhXgPI.js';
+export { b as ContactAddress, c as ContactDetails, d as ContactEmail, e as ContactName, f as ContactOrg, g as ContactPhone, D as DeltaExtractor, G as Group, P as Poll, h as PollChoice, i as PollChoiceInput, j as PollOption, R as Richlink, k as StreamText, V as Voice, l as contact, m as custom, n as group, o as option, p as poll, r as richlink, t as text, v as voice } from './authoring-b9AhXgPI.js';
+import { a as FusorVerify, F as FusorClient, b as FusorMessages, W as WebhookHandler, c as WebhookRawRequest, d as WebhookRawResult } from './types-BIta6Kxi.js';
+export { e as FusorEvent, f as FusorMessagesCtx, g as FusorMessagesReturn, h as FusorReply, i as FusorRespond, j as FusorVerifyRequest, k as fusorEvent, l as isFusorEvent } from './types-BIta6Kxi.js';
 import 'hotscript';
 import 'vcf';
 
@@ -67,7 +68,7 @@ declare function avatar(input: Buffer, options: {
  * (no new message id is produced; the existing message mutates in place).
  *
  * Edit cannot wrap `edit`, `reply`, `reaction`, `group`, `typing`, `rename`,
- * `avatar`, or `unsend` content.
+ * `avatar`, `unsend`, or `read` content.
  */
 declare const editSchema: z__default.ZodObject<{
     type: z__default.ZodLiteral<"edit">;
@@ -427,7 +428,7 @@ declare function rename(displayName: string): ContentBuilder;
  * `reply` like any other content type and route to a threaded send.
  *
  * Reply cannot wrap `reply`, `edit`, `reaction`, `group`, `typing`,
- * `rename`, `avatar`, or `unsend` content.
+ * `rename`, `avatar`, `unsend`, or `read` content.
  */
 declare const replySchema: z__default.ZodObject<{
     type: z__default.ZodLiteral<"reply">;

package/dist/index.js

@@ -44,13 +44,14 @@ import {
   definePlatform,
   edit,
   markdown,
+  read,
   rename,
   reply,
   senderAttrs,
   typing,
   unsend,
   wrapProviderMessage
-} from "./chunk-OGTHPDG7.js";
+} from "./chunk-B52VPQO3.js";
 import {
   attachment,
   custom,
@@ -3358,6 +3359,7 @@ export {
   option,
   poll,
   reaction,
+  read,
   rename,
   reply,
   resolveContents,

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

@@ -1,9 +1,10 @@
-import { C as ContentBuilder, h as ContentInput, M as Message, S as SchemaMessage, P as Platform, a as PlatformDef, e as Space, c as Store } from '../../types-Be0T6E0e.js';
+import { C as ContentBuilder, h as ContentInput, a as SchemaMessage, P as Platform, b as PlatformDef, S as Space, d as Store } from '../../types-CyfLJXgu.js';
 import * as zod_v4_core from 'zod/v4/core';
 import * as z from 'zod';
 import z__default from 'zod';
-import { A as Attachment } from '../../attachment-CEpGtZLm.js';
-import { P as PhotoInput } from '../../photo-content-BJKnqgN-.js';
+import { A as Attachment } from '../../attachment-CnivEhr6.js';
+import { P as PhotoInput } from '../../read-C4uvozGX.js';
+export { r as read } from '../../read-C4uvozGX.js';
 import { MessageEffect, AdvancedIMessage } from '@photon-ai/advanced-imessage';
 import { IMessageSDK } from '@photon-ai/imessage-kit';
 import 'hotscript';
@@ -114,26 +115,6 @@ declare function customizedMiniApp(input: CustomizedMiniAppInput): ContentBuilde
 type IMessageMessageEffect = MessageEffect;
 declare function effect(input: ContentInput, messageEffect: IMessageMessageEffect): ContentBuilder;
 
-/**
- * Mark the chat containing `target` as read. iMessage-only, remote-only.
- *
- * Implemented via `chats.markRead(chatGuid)`, which marks **every unread
- * message in the chat** as read — there is no per-message read receipt in
- * the SDK. `target` is used only to identify the chat (and to give
- * `message.read()` something to pass), so passing any message from a chat
- * marks the whole chat as read.
- *
- * `space.send(read(message))` is the canonical form; `space.read(message)`
- * and `message.read()` are sugar attached via the iMessage platform's
- * `space.actions` / `message.actions` slots.
- *
- * `Read` is intentionally not a member of the universal `Content` union —
- * the `as unknown as Content` cast keeps the builder shape compatible with
- * the framework's `ContentBuilder.build(): Promise<Content>` signature. The
- * framework treats it as a fire-and-forget control signal at runtime.
- */
-declare function read(target: Message): ContentBuilder;
-
 interface RemoteClient {
     client: AdvancedIMessage;
     phone: string;
@@ -189,10 +170,7 @@ declare const imessage: Platform<PlatformDef<"iMessage", z.ZodUnion<readonly [z.
     background: (space: Space, input: BackgroundInput, opts?: {
         mimeType?: string;
     }) => Promise<void>;
-    read: (space: Space, message: Message) => Promise<void>;
-}, {
-    read: (message: Message) => Promise<void>;
-}, {
+}, Record<never, never>, {
     getMessage: ({ client }: {
         client: IMessageClient;
         config: {
@@ -241,4 +219,4 @@ declare const imessage: Platform<PlatformDef<"iMessage", z.ZodUnion<readonly [z.
     };
 }>;
 
-export { type BackgroundInput, type CustomizedMiniApp, type CustomizedMiniAppInput, type CustomizedMiniAppLayout, type IMessageMessageEffect, background, customizedMiniApp, effect, imessage, read };
+export { type BackgroundInput, type CustomizedMiniApp, type CustomizedMiniAppInput, type CustomizedMiniAppLayout, type IMessageMessageEffect, background, customizedMiniApp, effect, imessage };

package/dist/providers/imessage/index.js

@@ -3,9 +3,8 @@ import {
   background,
   customizedMiniApp,
   effect,
-  imessage,
-  read
-} from "../../chunk-W5HNZ7YT.js";
+  imessage
+} from "../../chunk-DMT6BFJV.js";
 import "../../chunk-ZR3TKZMT.js";
 import "../../chunk-LZXPLXZF.js";
 import "../../chunk-2D27WW5B.js";
@@ -13,7 +12,9 @@ import "../../chunk-3GEJYGZK.js";
 import "../../chunk-A37PM5N2.js";
 import "../../chunk-5XEFJBN2.js";
 import "../../chunk-6UZFVXQF.js";
-import "../../chunk-OGTHPDG7.js";
+import {
+  read
+} from "../../chunk-B52VPQO3.js";
 import "../../chunk-UXAKIXVM.js";
 export {
   background,

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-BIta6Kxi.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";
+} from "../chunk-DMT6BFJV.js";
 import "../chunk-ZR3TKZMT.js";
 import {
   slack
-} from "../chunk-VEF6FUE7.js";
+} from "../chunk-WXLQNANA.js";
 import {
   telegram
-} from "../chunk-57NECZQZ.js";
+} from "../chunk-U3QQ56YZ.js";
 import "../chunk-34FQGGD7.js";
 import "../chunk-LZXPLXZF.js";
 import {
   terminal
-} from "../chunk-PV4AVMNN.js";
+} from "../chunk-IM5ADDZS.js";
 import "../chunk-FAIFTUV2.js";
 import {
   whatsappBusiness
-} from "../chunk-5VCWWPFW.js";
+} from "../chunk-3KWFP4L2.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-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-BIta6Kxi.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-U3QQ56YZ.js";
 import "../../chunk-34FQGGD7.js";
 import "../../chunk-LZXPLXZF.js";
 import "../../chunk-FAIFTUV2.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-IM5ADDZS.js";
 import "../../chunk-FAIFTUV2.js";
 import "../../chunk-A37PM5N2.js";
 import "../../chunk-5XEFJBN2.js";
 import "../../chunk-6UZFVXQF.js";
-import "../../chunk-OGTHPDG7.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-3KWFP4L2.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-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-CDYXH2R7.d.ts → types-BIta6Kxi.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> {

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spectrum-ts",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "description": "Bring agents to any interface — unified messaging SDK for TypeScript.",
   "repository": {
     "type": "git",

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 };