spectrum-ts 1.18.0 → 2.0.0

package/README.md

@@ -1,6 +1,9 @@
 <div align="center">
   <h1>Spectrum</h1>
   <p><strong>Bring agents to any interface.</strong></p>
+  
+  Photon (photon.codes) builds Spectrum, a multi-channel agent framework that makes AI agents reachable over real conversation surfaces like iMessage, SMS, and email instead of trapping them in web chat.
+  
   <p>
     <a href="https://www.npmjs.com/package/spectrum-ts"><img src="https://img.shields.io/npm/v/spectrum-ts.svg?style=flat&colorA=1a1a1a&colorB=3178c6" alt="npm version" /></a>
     <a href="https://www.npmjs.com/package/spectrum-ts"><img src="https://img.shields.io/npm/dm/spectrum-ts.svg?style=flat&colorA=1a1a1a&colorB=3178c6" alt="npm downloads" /></a>
@@ -10,7 +13,13 @@
   </p>
 </div>
 
-Spectrum is a unified messaging SDK for TypeScript. Write your agent logic once and deliver it across every messaging platform — iMessage, WhatsApp, terminal, or your own — through one fully type-safe interface.
+## About Photon
+
+**[Photon](https://photon.codes)** builds infrastructure for AI agents that operate over real communication channels.
+
+Spectrum is Photon’s open-source multi-channel agent framework, enabling AI agents to communicate through interfaces people already use—such as iMessage, SMS, email, Slack, Discord, and voice—instead of being confined to web chat.
+
+Learn more at **https://photon.codes**.
 
 ## Getting Started
 
@@ -54,6 +63,7 @@ Visit **[docs.photon.codes](https://docs.photon.codes)** to view the full docume
 |----------|---------|
 | iMessage | `spectrum-ts/providers/imessage` |
 | WhatsApp | `spectrum-ts/providers/whatsapp` |
+| Telegram | `spectrum-ts/providers/telegram` |
 | Terminal | `spectrum-ts/providers/terminal` |
 | Custom   | `definePlatform` from `spectrum-ts` |
 

package/dist/{attachment-DfWSZS5L.d.ts → attachment-B4nSrKVd.d.ts}

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

package/dist/{authoring-C9uDdZ2F.d.ts → authoring-BjE5BvlO.d.ts}

@@ -1,7 +1,7 @@
-import './attachment-DfWSZS5L.js';
+import './attachment-B4nSrKVd.js';
 import vCard from 'vcf';
 import z__default from 'zod';
-import { U as User, C as ContentBuilder, M as Message, b as Space, c as ContentInput } from './types-DcQ5a7PK.js';
+import { U as User, C as ContentBuilder, M as Message, e as Space, h as ContentInput } from './types-Bje8aq1k.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-DfWSZS5L.js';
-export { s as asContact, u as asCustom, w as asGroup, x as asPoll, y as asPollOption, z as asReaction, A as asRichlink, B as asText, D as asVoice } from './authoring-C9uDdZ2F.js';
-export { f as ProviderMessageRecord } from './types-DcQ5a7PK.js';
+export { c as asAttachment } from './attachment-B4nSrKVd.js';
+export { s as asContact, u as asCustom, w as asGroup, x as asPoll, y as asPollOption, z as asReaction, A as asRichlink, B as asText, D as asVoice } from './authoring-BjE5BvlO.js';
+export { d as ProviderMessageRecord } from './types-Bje8aq1k.js';
 import 'zod';
 import 'vcf';
 import 'hotscript';

package/dist/authoring.js

@@ -1,8 +1,10 @@
 import { createRequire as __spectrumCreateRequire } from "node:module"; const require = __spectrumCreateRequire(import.meta.url);
 import {
-  asGroup,
   asRichlink
-} from "./chunk-JQN6CRSC.js";
+} from "./chunk-6BI4PFTP.js";
+import {
+  asGroup
+} from "./chunk-3B4QH4JG.js";
 import {
   asVoice
 } from "./chunk-NNY6LMSC.js";
@@ -12,7 +14,8 @@ import {
 } from "./chunk-2D27WW5B.js";
 import {
   asContact
-} from "./chunk-QGJFZMD5.js";
+} from "./chunk-U7AWXDH6.js";
+import "./chunk-6UZFVXQF.js";
 import {
   asAttachment,
   asCustom,

package/dist/chunk-34FQGGD7.js

@@ -0,0 +1,34 @@
+import { createRequire as __spectrumCreateRequire } from "node:module"; const require = __spectrumCreateRequire(import.meta.url);
+
+// src/fusor/event.ts
+var FUSOR_EVENT_BRAND = /* @__PURE__ */ Symbol.for("spectrum.fusor.event");
+var FUSOR_MESSAGES_CHANNEL = "messages";
+function fusorEvent(name, data) {
+  return { [FUSOR_EVENT_BRAND]: true, name, data };
+}
+function isFusorEvent(value) {
+  return typeof value === "object" && value !== null && value[FUSOR_EVENT_BRAND] === true;
+}
+
+// src/fusor/types.ts
+var FUSOR_BRAND = /* @__PURE__ */ Symbol.for("spectrum.fusor.client");
+
+// src/fusor/index.ts
+function fusor(platform, verify) {
+  return {
+    [FUSOR_BRAND]: true,
+    platform,
+    verify
+  };
+}
+function isFusorClient(value) {
+  return typeof value === "object" && value !== null && value[FUSOR_BRAND] === true;
+}
+
+export {
+  FUSOR_MESSAGES_CHANNEL,
+  fusorEvent,
+  isFusorEvent,
+  fusor,
+  isFusorClient
+};

package/dist/chunk-3B4QH4JG.js

@@ -0,0 +1,35 @@
+import { createRequire as __spectrumCreateRequire } from "node:module"; const require = __spectrumCreateRequire(import.meta.url);
+import {
+  resolveContents
+} from "./chunk-2ILTJC35.js";
+
+// src/content/group.ts
+import z from "zod";
+var isMessage = (v) => typeof v === "object" && v !== null && "id" in v && "content" in v;
+var groupSchema = z.object({
+  type: z.literal("group"),
+  items: z.array(z.custom(isMessage)).min(2)
+});
+var asGroup = (input) => groupSchema.parse({ type: "group", items: input.items });
+var stubOutboundMessage = (content) => ({ id: "", content });
+function group(...items) {
+  return {
+    build: async () => {
+      const resolved = await resolveContents(items);
+      const members = [];
+      for (const item of resolved) {
+        if (item.type === "group" || item.type === "reaction") {
+          throw new Error(`group() cannot contain "${item.type}" items`);
+        }
+        members.push(stubOutboundMessage(item));
+      }
+      return asGroup({ items: members });
+    }
+  };
+}
+
+export {
+  groupSchema,
+  asGroup,
+  group
+};

package/dist/chunk-3GEJYGZK.js

@@ -0,0 +1,84 @@
+import { createRequire as __spectrumCreateRequire } from "node:module"; const require = __spectrumCreateRequire(import.meta.url);
+
+// src/utils/cloud.ts
+var SPECTRUM_CLOUD_URL = process.env.SPECTRUM_CLOUD_URL ?? "https://spectrum.photon.codes";
+var SpectrumCloudError = class extends Error {
+  status;
+  code;
+  constructor(status, code, message) {
+    super(message);
+    this.name = "SpectrumCloudError";
+    this.status = status;
+    this.code = code;
+  }
+};
+var request = async (path, init) => {
+  const response = await fetch(`${SPECTRUM_CLOUD_URL}${path}`, init);
+  if (!response.ok) {
+    const body = await response.text().catch(() => "");
+    try {
+      const parsed = JSON.parse(body);
+      throw new SpectrumCloudError(
+        response.status,
+        parsed.code,
+        parsed.message
+      );
+    } catch (error) {
+      if (error instanceof SpectrumCloudError) {
+        throw error;
+      }
+      throw new SpectrumCloudError(
+        response.status,
+        "UNKNOWN",
+        body || response.statusText
+      );
+    }
+  }
+  const json = await response.json();
+  if (!json.succeed) {
+    throw new SpectrumCloudError(
+      response.status,
+      "UNKNOWN",
+      "Server returned succeed=false"
+    );
+  }
+  return json.data;
+};
+var basicAuth = (projectId, projectSecret) => `Basic ${btoa(`${projectId}:${projectSecret}`)}`;
+var cloud = {
+  getProject: (projectId, projectSecret) => request(`/projects/${projectId}/`, {
+    headers: { Authorization: basicAuth(projectId, projectSecret) }
+  }),
+  getSubscription: (projectId) => request(`/projects/${projectId}/billing/subscription`),
+  issueImessageTokens: (projectId, projectSecret) => request(`/projects/${projectId}/imessage/tokens`, {
+    method: "POST",
+    headers: { Authorization: basicAuth(projectId, projectSecret) }
+  }),
+  getImessageInfo: (projectId) => request(`/projects/${projectId}/imessage/`),
+  issueWhatsappBusinessTokens: (projectId, projectSecret) => request(`/projects/${projectId}/whatsapp-business/tokens`, {
+    method: "POST",
+    headers: { Authorization: basicAuth(projectId, projectSecret) }
+  }),
+  issueSlackTokens: (projectId, projectSecret) => request(`/projects/${projectId}/slack/tokens`, {
+    method: "POST",
+    headers: { Authorization: basicAuth(projectId, projectSecret) }
+  }),
+  issueFusorToken: (projectId, projectSecret) => request(`/projects/${projectId}/fusor/token`, {
+    method: "POST",
+    headers: { Authorization: basicAuth(projectId, projectSecret) }
+  }),
+  getPlatforms: (projectId) => request(`/projects/${projectId}/platforms/`),
+  togglePlatform: (projectId, projectSecret, platform, enabled) => request(`/projects/${projectId}/platforms/`, {
+    method: "PATCH",
+    headers: {
+      Authorization: basicAuth(projectId, projectSecret),
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify({ platform, enabled })
+  })
+};
+
+export {
+  SpectrumCloudError,
+  cloud
+};