spectrum-ts 3.1.0 → 4.1.0

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,18 +3,19 @@ import {
   background,
   customizedMiniApp,
   effect,
-  imessage,
-  read
-} from "../../chunk-WMG36LHW.js";
-import "../../chunk-CHY5YLLV.js";
-import "../../chunk-MHGCPC2V.js";
+  imessage
+} from "../../chunk-DMT6BFJV.js";
+import "../../chunk-ZR3TKZMT.js";
+import "../../chunk-LZXPLXZF.js";
 import "../../chunk-2D27WW5B.js";
 import "../../chunk-3GEJYGZK.js";
-import "../../chunk-NZ5WCMTY.js";
+import "../../chunk-A37PM5N2.js";
 import "../../chunk-5XEFJBN2.js";
 import "../../chunk-6UZFVXQF.js";
-import "../../chunk-L3NUESOW.js";
-import "../../chunk-LQMDV75O.js";
+import {
+  read
+} from "../../chunk-B52VPQO3.js";
+import "../../chunk-UXAKIXVM.js";
 export {
   background,
   customizedMiniApp,

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,30 +1,30 @@
 import { createRequire as __spectrumCreateRequire } from "node:module"; const require = __spectrumCreateRequire(import.meta.url);
 import {
   imessage
-} from "../chunk-WMG36LHW.js";
-import "../chunk-CHY5YLLV.js";
+} from "../chunk-DMT6BFJV.js";
+import "../chunk-ZR3TKZMT.js";
 import {
   slack
-} from "../chunk-7ON5XHC2.js";
+} from "../chunk-WXLQNANA.js";
 import {
   telegram
-} from "../chunk-PSSWQBOH.js";
+} from "../chunk-U3QQ56YZ.js";
 import "../chunk-34FQGGD7.js";
-import "../chunk-MHGCPC2V.js";
+import "../chunk-LZXPLXZF.js";
 import {
   terminal
-} from "../chunk-Q44CIGG6.js";
-import "../chunk-77U6SH5A.js";
+} from "../chunk-IM5ADDZS.js";
+import "../chunk-FAIFTUV2.js";
 import {
   whatsappBusiness
-} from "../chunk-FA7VA4XN.js";
+} from "../chunk-3KWFP4L2.js";
 import "../chunk-2D27WW5B.js";
 import "../chunk-3GEJYGZK.js";
-import "../chunk-NZ5WCMTY.js";
+import "../chunk-A37PM5N2.js";
 import "../chunk-5XEFJBN2.js";
 import "../chunk-6UZFVXQF.js";
-import "../chunk-L3NUESOW.js";
-import "../chunk-LQMDV75O.js";
+import "../chunk-B52VPQO3.js";
+import "../chunk-UXAKIXVM.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-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,11 +1,11 @@
 import { createRequire as __spectrumCreateRequire } from "node:module"; const require = __spectrumCreateRequire(import.meta.url);
 import {
   slack
-} from "../../chunk-7ON5XHC2.js";
+} from "../../chunk-WXLQNANA.js";
 import "../../chunk-3GEJYGZK.js";
 import "../../chunk-5XEFJBN2.js";
-import "../../chunk-L3NUESOW.js";
-import "../../chunk-LQMDV75O.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,13 +1,13 @@
 import { createRequire as __spectrumCreateRequire } from "node:module"; const require = __spectrumCreateRequire(import.meta.url);
 import {
   telegram
-} from "../../chunk-PSSWQBOH.js";
+} from "../../chunk-U3QQ56YZ.js";
 import "../../chunk-34FQGGD7.js";
-import "../../chunk-MHGCPC2V.js";
-import "../../chunk-77U6SH5A.js";
+import "../../chunk-LZXPLXZF.js";
+import "../../chunk-FAIFTUV2.js";
 import "../../chunk-6UZFVXQF.js";
-import "../../chunk-L3NUESOW.js";
-import "../../chunk-LQMDV75O.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,13 +1,13 @@
 import { createRequire as __spectrumCreateRequire } from "node:module"; const require = __spectrumCreateRequire(import.meta.url);
 import {
   terminal
-} from "../../chunk-Q44CIGG6.js";
-import "../../chunk-77U6SH5A.js";
-import "../../chunk-NZ5WCMTY.js";
+} from "../../chunk-IM5ADDZS.js";
+import "../../chunk-FAIFTUV2.js";
+import "../../chunk-A37PM5N2.js";
 import "../../chunk-5XEFJBN2.js";
 import "../../chunk-6UZFVXQF.js";
-import "../../chunk-L3NUESOW.js";
-import "../../chunk-LQMDV75O.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,14 +1,14 @@
 import { createRequire as __spectrumCreateRequire } from "node:module"; const require = __spectrumCreateRequire(import.meta.url);
 import {
   whatsappBusiness
-} from "../../chunk-FA7VA4XN.js";
+} from "../../chunk-3KWFP4L2.js";
 import "../../chunk-2D27WW5B.js";
 import "../../chunk-3GEJYGZK.js";
-import "../../chunk-NZ5WCMTY.js";
+import "../../chunk-A37PM5N2.js";
 import "../../chunk-5XEFJBN2.js";
 import "../../chunk-6UZFVXQF.js";
-import "../../chunk-L3NUESOW.js";
-import "../../chunk-LQMDV75O.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": "3.1.0",
+  "version": "4.1.0",
   "description": "Bring agents to any interface — unified messaging SDK for TypeScript.",
   "repository": {
     "type": "git",
@@ -46,12 +46,9 @@
     "@photon-ai/whatsapp-business": "^0.1.1",
     "@photon-ai/proto": "^0.2.4",
     "@repeaterjs/repeater": "^3.0.6",
-    "better-grpc": "^0.3.2",
     "lru-cache": "^11.0.0",
     "marked": "^18.0.5",
     "mime-types": "^3.0.1",
-    "nice-grpc": "^2.1.16",
-    "nice-grpc-common": "^2.0.2",
     "open-graph-scraper": "^6.11.0",
     "type-fest": "^5.4.1",
     "vcf": "^2.1.2",

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