spectrum-ts 1.17.1 → 2.0.0

package/dist/{chunk-YJMPSD3S.js → chunk-ATNAE7OR.js}

@@ -1,29 +1,35 @@
 import { createRequire as __spectrumCreateRequire } from "node:module"; const require = __spectrumCreateRequire(import.meta.url);
+import {
+  asRichlink
+} from "./chunk-6BI4PFTP.js";
 import {
   asGroup,
-  asRichlink,
   groupSchema
-} from "./chunk-JQN6CRSC.js";
+} from "./chunk-3B4QH4JG.js";
 import {
   asPoll,
   asPollOption
 } from "./chunk-2D27WW5B.js";
 import {
-  cloud,
+  cloud
+} from "./chunk-3GEJYGZK.js";
+import {
+  asContact
+} from "./chunk-U7AWXDH6.js";
+import {
   mergeStreams,
   stream
-} from "./chunk-MC6ZKFSG.js";
+} from "./chunk-5XEFJBN2.js";
 import {
-  asContact,
   fromVCard,
   toVCard
-} from "./chunk-QGJFZMD5.js";
+} from "./chunk-6UZFVXQF.js";
 import {
   UnsupportedError,
   buildPhotoAction,
   definePlatform,
   photoActionSchema
-} from "./chunk-IPOFBAIM.js";
+} from "./chunk-NGC4DJIX.js";
 import {
   asAttachment,
   asCustom,
@@ -60,21 +66,79 @@ function background(input, options) {
   };
 }
 
+// src/providers/imessage/content/customized-mini-app.ts
+import z2 from "zod";
+var layoutSchema = z2.object({
+  caption: z2.string().nonempty().optional(),
+  subcaption: z2.string().nonempty().optional(),
+  trailingCaption: z2.string().nonempty().optional(),
+  trailingSubcaption: z2.string().nonempty().optional(),
+  image: z2.instanceof(Uint8Array).optional(),
+  imageTitle: z2.string().nonempty().optional(),
+  imageSubtitle: z2.string().nonempty().optional(),
+  summary: z2.string().nonempty().optional()
+}).refine(
+  (layout) => layout.caption !== void 0 || layout.subcaption !== void 0 || layout.trailingCaption !== void 0 || layout.trailingSubcaption !== void 0 || layout.image !== void 0,
+  {
+    message: "layout must set at least one of caption, subcaption, trailingCaption, trailingSubcaption, image"
+  }
+).refine(
+  (layout) => layout.image === void 0 === (layout.imageTitle === void 0),
+  {
+    message: "layout.image and layout.imageTitle must be set together",
+    path: ["imageTitle"]
+  }
+).refine(
+  (layout) => layout.imageSubtitle === void 0 || layout.image !== void 0,
+  {
+    message: "layout.imageSubtitle requires layout.image",
+    path: ["imageSubtitle"]
+  }
+);
+var customizedMiniAppSchema = z2.object({
+  type: z2.literal("customized-mini-app"),
+  __platform: z2.literal("iMessage"),
+  // Display name of the owning app, shown by Messages fallback UI.
+  appName: z2.string().nonempty(),
+  // Apple App Store numeric id of the owning app. Positive when set; omit to
+  // send a card whose extension is not published on the App Store.
+  appStoreId: z2.number().int().positive().optional(),
+  // Bundle identifier of the iMessage extension target.
+  extensionBundleId: z2.string().nonempty(),
+  // Visible card layout.
+  layout: layoutSchema,
+  // 10-character uppercase alphanumeric Apple Team ID.
+  teamId: z2.string(),
+  // Absolute URL delivered to the installed extension on tap.
+  url: z2.url()
+});
+var isCustomizedMiniApp = (v) => customizedMiniAppSchema.safeParse(v).success;
+var asCustomizedMiniApp = (input) => customizedMiniAppSchema.parse({
+  type: "customized-mini-app",
+  __platform: "iMessage",
+  ...input
+});
+function customizedMiniApp(input) {
+  return {
+    build: async () => asCustomizedMiniApp(input)
+  };
+}
+
 // src/providers/imessage/content/effect.ts
 import {
   MessageEffect
 } from "@photon-ai/advanced-imessage";
 
 // src/content/effect.ts
-import z2 from "zod";
-var effectInnerSchema = z2.discriminatedUnion("type", [
+import z3 from "zod";
+var effectInnerSchema = z3.discriminatedUnion("type", [
   textSchema,
   attachmentSchema
 ]);
-var messageEffectSchema = z2.object({
-  type: z2.literal("effect"),
+var messageEffectSchema = z3.object({
+  type: z3.literal("effect"),
   content: effectInnerSchema,
-  effect: z2.string().nonempty()
+  effect: z3.string().nonempty()
 });
 
 // src/providers/imessage/content/effect.ts
@@ -104,13 +168,13 @@ function effect(input, messageEffect) {
 }
 
 // src/providers/imessage/content/read.ts
-import z3 from "zod";
+import z4 from "zod";
 var isMessage = (v) => typeof v === "object" && v !== null && "id" in v && "content" in v;
-var readSchema = z3.object({
-  type: z3.literal("read"),
-  __platform: z3.literal("iMessage"),
-  __fireAndForget: z3.literal(true),
-  target: z3.custom(isMessage, {
+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"
   })
 });
@@ -138,33 +202,33 @@ import { createClient } from "@photon-ai/advanced-imessage";
 
 // src/providers/imessage/types.ts
 import { IMessageSDK } from "@photon-ai/imessage-kit";
-import z4 from "zod";
+import z5 from "zod";
 var SHARED_PHONE = "shared";
 var isLocal = (client) => client instanceof IMessageSDK;
-var clientEntry = z4.object({
-  address: z4.string(),
-  token: z4.string(),
-  phone: z4.string()
+var clientEntry = z5.object({
+  address: z5.string(),
+  token: z5.string(),
+  phone: z5.string()
 });
-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 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 userSchema = z4.object({});
-var spaceSchema = z4.object({
-  id: z4.string(),
-  type: z4.enum(["dm", "group"]),
-  phone: z4.string()
+var userSchema = z5.object({});
+var spaceSchema = z5.object({
+  id: z5.string(),
+  type: z5.enum(["dm", "group"]),
+  phone: z5.string()
 });
-var spaceParamsSchema = z4.object({
-  phone: z4.string().optional()
+var spaceParamsSchema = z5.object({
+  phone: z5.string().optional()
 });
-var messageSchema = z4.object({
-  partIndex: z4.number().int().nonnegative().optional(),
-  parentId: z4.string().optional()
+var messageSchema = z5.object({
+  partIndex: z5.number().int().nonnegative().optional(),
+  parentId: z5.string().optional()
 });
 
 // src/providers/imessage/auth.ts
@@ -549,6 +613,18 @@ var setBackground = async (remote, spaceId, content) => {
   );
 };
 
+// src/providers/imessage/remote/customized-mini-app.ts
+var sendCustomizedMiniApp = async (remote, spaceId, content) => {
+  const chat = toChatGuid(spaceId);
+  const message = await remote.messages.sendCustomizedMiniApp(chat, content);
+  return {
+    id: message.guid,
+    content,
+    space: { id: spaceId },
+    timestamp: message.dateCreated
+  };
+};
+
 // src/providers/imessage/remote/inbound.ts
 import {
   NotFoundError as NotFoundError2
@@ -910,7 +986,6 @@ var getMessage3 = async (remote, spaceId, msgId, phone) => {
   if (childRef) {
     try {
       const fetched = await remote.messages.get(
-        toChatGuid(spaceId),
         toMessageGuid(childRef.parentGuid)
       );
       const parent = await rebuildFromAppleMessage(
@@ -933,10 +1008,7 @@ var getMessage3 = async (remote, spaceId, msgId, phone) => {
     }
   }
   try {
-    const fetched = await remote.messages.get(
-      toChatGuid(spaceId),
-      toMessageGuid(msgId)
-    );
+    const fetched = await remote.messages.get(toMessageGuid(msgId));
     const rebuilt = await rebuildFromAppleMessage(
       remote,
       fetched,
@@ -975,10 +1047,7 @@ var resolveReactionTarget = async (client, cache, chat, targetGuid, partIndex, p
   let candidate = cache.get(targetGuid);
   if (!candidate) {
     try {
-      const fetched = await client.messages.get(
-        toChatGuid(chat),
-        toMessageGuid(targetGuid)
-      );
+      const fetched = await client.messages.get(toMessageGuid(targetGuid));
       candidate = await rebuildFromAppleMessage(client, fetched, phone, chat);
       cacheMessage(cache, candidate);
     } catch {
@@ -1976,6 +2045,55 @@ var messages3 = (clients, projectConfig) => {
   );
 };
 
+// src/providers/imessage/remote/stream-text.ts
+var INITIAL_THROTTLE_MS = 1e3;
+var BACKOFF_FACTOR = 2;
+var MAX_EDITS = 5;
+var sendStreamText = async (remote, spaceId, content) => {
+  const chat = toChatGuid(spaceId);
+  let sent;
+  let full = "";
+  let lastSentText = "";
+  let lastEditAt = 0;
+  let editCount = 0;
+  const flushEdit = async (text2) => {
+    if (!sent || text2 === lastSentText) {
+      return;
+    }
+    await remote.messages.edit(chat, toMessageGuid(sent.guid), text2);
+    lastSentText = text2;
+    lastEditAt = Date.now();
+    editCount += 1;
+  };
+  for await (const delta of content.stream()) {
+    full += delta;
+    if (!sent) {
+      sent = await remote.messages.sendText(chat, full);
+      lastSentText = full;
+      lastEditAt = Date.now();
+      continue;
+    }
+    const hasBudgetForInterimEdit = editCount < MAX_EDITS - 1;
+    const requiredGap = INITIAL_THROTTLE_MS * BACKOFF_FACTOR ** editCount;
+    if (hasBudgetForInterimEdit && Date.now() - lastEditAt >= requiredGap) {
+      await flushEdit(full);
+    }
+  }
+  if (!sent) {
+    throw unsupportedRemoteContent(
+      "streamText",
+      "stream produced no text \u2014 nothing to send"
+    );
+  }
+  await flushEdit(full);
+  return {
+    id: sent.guid,
+    content: asText(full),
+    space: { id: spaceId },
+    timestamp: sent.dateCreated
+  };
+};
+
 // src/providers/imessage/remote/typing.ts
 var startTyping = async (remote, spaceId) => {
   await remote.chats.setTyping(toChatGuid(spaceId), true);
@@ -1987,6 +2105,7 @@ var stopTyping = async (remote, spaceId) => {
 // src/providers/imessage/remote/api.ts
 var messages4 = (clients, projectConfig) => messages3(clients, projectConfig);
 var setBackground2 = async (remote, spaceId, content) => setBackground(remote, spaceId, content);
+var sendCustomizedMiniApp2 = async (remote, spaceId, content) => sendCustomizedMiniApp(remote, spaceId, content);
 var setDisplayName2 = async (remote, spaceId, content) => setDisplayName(remote, spaceId, content);
 var setIcon2 = async (remote, spaceId, content) => setIcon(remote, spaceId, content);
 var markRead2 = async (remote, spaceId) => {
@@ -1999,6 +2118,7 @@ var stopTyping2 = async (remote, spaceId) => {
   await stopTyping(remote, spaceId);
 };
 var send4 = async (remote, spaceId, content) => send3(remote, spaceId, content);
+var sendStreamText2 = async (remote, spaceId, content) => sendStreamText(remote, spaceId, content);
 var replyToMessage2 = async (remote, spaceId, msgId, content) => replyToMessage(remote, spaceId, msgId, content);
 var editMessage2 = async (remote, spaceId, msgId, content) => editMessage(remote, spaceId, msgId, content);
 var reactToMessage2 = async (remote, spaceId, target, reaction) => {
@@ -2056,6 +2176,17 @@ var handleEdit = async (client, space, content) => {
   const remote = clientForPhone(client, space.phone);
   await editMessage2(remote, space.id, content.target.id, content.content);
 };
+var handleStreamText = async (client, space, content) => {
+  if (isLocal(client)) {
+    throw UnsupportedError.action(
+      "streamText",
+      "iMessage (local mode)",
+      "streaming text responses require remote iMessage"
+    );
+  }
+  const remote = clientForPhone(client, space.phone);
+  return await sendStreamText2(remote, space.id, content);
+};
 var handleBackground = async (client, space, content) => {
   if (isLocal(client)) {
     throw UnsupportedError.action(
@@ -2067,6 +2198,17 @@ var handleBackground = async (client, space, content) => {
   const remote = clientForPhone(client, space.phone);
   await setBackground2(remote, space.id, content);
 };
+var handleCustomizedMiniApp = async (client, space, content) => {
+  if (isLocal(client)) {
+    throw UnsupportedError.action(
+      "customized-mini-app",
+      "iMessage (local mode)",
+      "mini app cards require remote iMessage"
+    );
+  }
+  const remote = clientForPhone(client, space.phone);
+  return await sendCustomizedMiniApp2(remote, space.id, content);
+};
 var handleRead = async (client, space) => {
   if (isLocal(client)) {
     throw UnsupportedError.action(
@@ -2275,6 +2417,9 @@ var imessage = definePlatform("iMessage", {
       await handleEdit(client, space, content);
       return;
     }
+    if (content.type === "streamText") {
+      return await handleStreamText(client, space, content);
+    }
     if (content.type === "rename") {
       await handleRename(client, space, content);
       return;
@@ -2291,6 +2436,9 @@ var imessage = definePlatform("iMessage", {
       await handleRead(client, space);
       return;
     }
+    if (isCustomizedMiniApp(content)) {
+      return await handleCustomizedMiniApp(client, space, content);
+    }
     if (isLocal(client)) {
       return await send2(client, space.id, content);
     }
@@ -2351,6 +2499,7 @@ var imessage = definePlatform("iMessage", {
 
 export {
   background,
+  customizedMiniApp,
   effect,
   read,
   imessage

package/dist/{chunk-IPOFBAIM.js → chunk-NGC4DJIX.js}

@@ -216,7 +216,7 @@ var UnsupportedError = class _UnsupportedError extends Error {
 };
 
 // src/platform/define.ts
-import { withSpan as withSpan2 } from "@photon-ai/otel";
+import { createLogger as createLogger2, withSpan as withSpan2 } from "@photon-ai/otel";
 
 // src/utils/identifier.ts
 import { sanitizeEmail, sanitizePhone } from "@photon-ai/otel";
@@ -747,6 +747,7 @@ function buildMessage(params) {
 }
 
 // src/platform/define.ts
+var platformLog2 = createLogger2("spectrum.platform");
 function classifySpaceIdentifier(args) {
   const stringArgs = args.filter((a) => typeof a === "string");
   if (stringArgs.length > 1) {
@@ -910,13 +911,20 @@ function createPlatformInstance(def, runtime) {
   const eventProperties = {};
   const customEvents = def.events ?? {};
   for (const eventName of Object.keys(customEvents)) {
-    const producer = customEvents[eventName];
-    if (producer) {
+    const declared = customEvents[eventName];
+    if (typeof declared === "function") {
+      const producer = declared;
       eventProperties[eventName] = producer({
         client: runtime.client,
         config: runtime.config,
+        projectConfig: runtime.projectConfig,
         store: runtime.store
       });
+      continue;
+    }
+    const fusorEvents = runtime.subscribeEvent?.(eventName);
+    if (fusorEvents) {
+      eventProperties[eventName] = fusorEvents;
     }
   }
   let messagesIterable;
@@ -948,8 +956,9 @@ function createPlatformInstance(def, runtime) {
     eventProperties
   );
 }
-function definePlatform(name, def) {
-  const fullDef = { name, ...def };
+function definePlatform(name, rawDef) {
+  const def = rawDef;
+  const fullDef = { ...def, name };
   const platformCache = /* @__PURE__ */ new WeakMap();
   const narrowSpectrum = (spectrum) => {
     const cached = platformCache.get(spectrum);
@@ -969,17 +978,19 @@ function definePlatform(name, def) {
   };
   const narrowSpace = (input) => {
     if (input.__platform !== name) {
-      throw new Error(
-        `Expected space from "${name}", got "${input.__platform}"`
-      );
+      platformLog2.warn("space platform mismatch; narrowing skipped", {
+        expected: name,
+        actual: input.__platform
+      });
     }
     return input;
   };
   const narrowMessage = (input) => {
     if (input.platform !== name) {
-      throw new Error(
-        `Expected message from "${name}", got "${input.platform}"`
-      );
+      platformLog2.warn("message platform mismatch; narrowing skipped", {
+        expected: name,
+        actual: input.platform
+      });
     }
     return input;
   };
@@ -1022,12 +1033,6 @@ function definePlatform(name, def) {
   }
   return narrower;
 }
-function defineFusorPlatform(name, def) {
-  return definePlatform(
-    name,
-    def
-  );
-}
 
 export {
   photoActionSchema,
@@ -1042,6 +1047,5 @@ export {
   senderAttrs,
   wrapProviderMessage,
   buildSpace,
-  definePlatform,
-  defineFusorPlatform
+  definePlatform
 };

package/dist/{chunk-5TIF3FIE.js → chunk-Q537JPTG.js}

@@ -3,17 +3,19 @@ import {
   asPollOption
 } from "./chunk-2D27WW5B.js";
 import {
-  cloud,
-  mergeStreams,
-  stream
-} from "./chunk-MC6ZKFSG.js";
+  cloud
+} from "./chunk-3GEJYGZK.js";
 import {
   asContact
-} from "./chunk-QGJFZMD5.js";
+} from "./chunk-U7AWXDH6.js";
+import {
+  mergeStreams,
+  stream
+} from "./chunk-5XEFJBN2.js";
 import {
   UnsupportedError,
   definePlatform
-} from "./chunk-IPOFBAIM.js";
+} from "./chunk-NGC4DJIX.js";
 import {
   asAttachment,
   asCustom,

package/dist/{chunk-5BKZJMZV.js → chunk-U3LXXT3W.js}

@@ -3,14 +3,19 @@ import {
   asVoice
 } from "./chunk-NNY6LMSC.js";
 import {
-  asContact,
+  asContact
+} from "./chunk-U7AWXDH6.js";
+import {
+  stream
+} from "./chunk-5XEFJBN2.js";
+import {
   fromVCard,
   toVCard
-} from "./chunk-QGJFZMD5.js";
+} from "./chunk-6UZFVXQF.js";
 import {
   UnsupportedError,
   definePlatform
-} from "./chunk-IPOFBAIM.js";
+} from "./chunk-NGC4DJIX.js";
 import {
   asAttachment,
   asCustom,
@@ -694,7 +699,7 @@ function protocolToSpectrum(p) {
       }
       return cached;
     };
-    const stream = async () => {
+    const stream2 = async () => {
       if (path) {
         const [{ createReadStream }, { Readable }] = await Promise.all([
           import("fs"),
@@ -718,7 +723,7 @@ function protocolToSpectrum(p) {
         mimeType: p.mimeType,
         size: p.size,
         read: readBytes,
-        stream
+        stream: stream2
       });
     }
     return asVoice({
@@ -726,7 +731,7 @@ function protocolToSpectrum(p) {
       mimeType: p.mimeType,
       size: p.size,
       read: readBytes,
-      stream
+      stream: stream2
     });
   }
   if (p.type === "contact") {
@@ -784,33 +789,57 @@ var terminal = definePlatform("Terminal", {
       return { id };
     }
   },
-  async *messages({ client }) {
-    for await (const evt of client.events) {
-      if (evt.kind === "message") {
-        const msg = evt.value;
-        client.knownChats.add(msg.spaceId);
-        yield {
-          id: msg.id,
-          content: protocolToSpectrum(msg.content),
-          sender: { id: msg.senderId },
-          space: { id: msg.spaceId },
-          timestamp: parseTimestamp(msg.timestamp),
-          // replyTo is a terminal-specific extra — agents inspect via a
-          // cast until Spectrum's message model grows first-class support.
-          ...msg.replyTo ? { replyTo: msg.replyTo } : {}
-        };
-        continue;
-      }
-      const r = evt.value;
-      client.knownChats.add(r.spaceId);
-      yield {
-        id: `reaction:${r.messageId}:${r.reaction}:${r.timestamp}`,
-        content: reactionContentFromProtocol(r),
-        sender: { id: r.senderId },
-        space: { id: r.spaceId },
-        timestamp: parseTimestamp(r.timestamp)
+  // Return a ManagedStream (not a native async generator): a native generator
+  // parked on an in-flight `client.events.next()` cannot be force-cancelled —
+  // a `.return()` queues behind the pending `next()` and never reaches the
+  // event queue, which would deadlock `Spectrum.stop()`. Driving the queue with
+  // an explicit pump lets cleanup call the queue iterator's `return()` directly
+  // (synchronous close + drain), so the stream tears down promptly on stop()
+  // without waiting for destroyClient.
+  messages({ client }) {
+    return stream((emit, end) => {
+      const iterator = client.events[Symbol.asyncIterator]();
+      const pump = (async () => {
+        try {
+          let result = await iterator.next();
+          while (!result.done) {
+            const evt = result.value;
+            if (evt.kind === "message") {
+              const msg = evt.value;
+              client.knownChats.add(msg.spaceId);
+              await emit({
+                id: msg.id,
+                content: protocolToSpectrum(msg.content),
+                sender: { id: msg.senderId },
+                space: { id: msg.spaceId },
+                timestamp: parseTimestamp(msg.timestamp),
+                // replyTo is a terminal-specific extra — agents inspect via a
+                // cast until Spectrum's message model grows first-class support.
+                ...msg.replyTo ? { replyTo: msg.replyTo } : {}
+              });
+            } else {
+              const r = evt.value;
+              client.knownChats.add(r.spaceId);
+              await emit({
+                id: `reaction:${r.messageId}:${r.reaction}:${r.timestamp}`,
+                content: reactionContentFromProtocol(r),
+                sender: { id: r.senderId },
+                space: { id: r.spaceId },
+                timestamp: parseTimestamp(r.timestamp)
+              });
+            }
+            result = await iterator.next();
+          }
+          end();
+        } catch (error) {
+          end(error);
+        }
+      })();
+      return async () => {
+        await iterator.return?.();
+        await pump.catch(() => void 0);
       };
-    }
+    });
   },
   send: async ({ client, content, space }) => {
     if (content.type === "reply") {