spectrum-ts 1.13.0 → 1.14.0

package/dist/{chunk-E7AXYNOZ.js → chunk-5HNHMI6L.js}

@@ -10,7 +10,7 @@ import {
   asReaction,
   asText,
   definePlatform
-} from "./chunk-YDHES53X.js";
+} from "./chunk-JTS25BT3.js";
 
 // src/providers/slack/index.ts
 import { createClient as createClient2, staticTokens } from "@photon-ai/slack";

package/dist/{chunk-YDHES53X.js → chunk-JTS25BT3.js}

@@ -22,6 +22,28 @@ var bufferToStream = (buf) => new ReadableStream({
     controller.close();
   }
 });
+var DEFAULT_FETCH_TIMEOUT_MS = 1e4;
+var fetchUrlBytes = async (url, options) => {
+  const controller = new AbortController();
+  const timer = setTimeout(
+    () => controller.abort(),
+    options?.timeoutMs ?? DEFAULT_FETCH_TIMEOUT_MS
+  );
+  try {
+    const res = await fetch(url, {
+      signal: controller.signal,
+      headers: options?.headers
+    });
+    if (!res.ok) {
+      throw new Error(`URL fetch ${url.toString()} returned ${res.status}`);
+    }
+    const data = Buffer.from(await res.arrayBuffer());
+    const mimeType = res.headers.get("content-type") ?? void 0;
+    return { data, mimeType };
+  } finally {
+    clearTimeout(timer);
+  }
+};
 
 // src/content/attachment.ts
 var DEFAULT_ATTACHMENT_NAME = "attachment";
@@ -33,7 +55,18 @@ var attachmentSchema = z2.object({
   read: readSchema,
   stream: streamSchema
 });
-var resolveAttachmentName = (input, name) => name || (typeof input === "string" ? basename(input) : DEFAULT_ATTACHMENT_NAME);
+var resolveAttachmentName = (input, name) => {
+  if (name) {
+    return name;
+  }
+  if (input instanceof URL) {
+    return basename(input.pathname) || DEFAULT_ATTACHMENT_NAME;
+  }
+  if (typeof input === "string") {
+    return basename(input);
+  }
+  return DEFAULT_ATTACHMENT_NAME;
+};
 var resolveAttachmentMimeType = (name, mimeType) => {
   if (mimeType) {
     return mimeType;
@@ -70,6 +103,13 @@ function attachment(input, options) {
     build: async () => {
       const name = resolveAttachmentName(input, options?.name);
       const mimeType = resolveAttachmentMimeType(name, options?.mimeType);
+      if (input instanceof URL) {
+        return asAttachment({
+          name,
+          mimeType,
+          read: async () => (await fetchUrlBytes(input)).data
+        });
+      }
       if (typeof input === "string") {
         const stats = await stat(input);
         return asAttachment({
@@ -114,7 +154,12 @@ var resolveMimeType = (input, mimeType, contentLabel) => {
   if (mimeType) {
     return mimeType;
   }
-  if (typeof input === "string") {
+  if (input instanceof URL) {
+    const resolved = lookupMimeType2(basename2(input.pathname));
+    if (resolved) {
+      return resolved;
+    }
+  } else if (typeof input === "string") {
     const resolved = lookupMimeType2(basename2(input));
     if (resolved) {
       return resolved;
@@ -140,7 +185,9 @@ var buildPhotoAction = (input, options, contentLabel) => {
   }
   const mimeType = resolveMimeType(input, options?.mimeType, contentLabel);
   let read;
-  if (typeof input === "string") {
+  if (input instanceof URL) {
+    read = cachedRead(async () => (await fetchUrlBytes(input)).data);
+  } else if (typeof input === "string") {
     read = cachedRead(() => readFile2(input));
   } else {
     const snapshot = Buffer.from(input);
@@ -785,7 +832,7 @@ function buildSpace(params) {
       await space.send(rename(displayName));
     },
     avatar: (async (input, options) => {
-      if (typeof input === "string") {
+      if (typeof input === "string" || input instanceof URL) {
         await space.send(avatar(input, options));
         return;
       }
@@ -1121,6 +1168,7 @@ export {
   readSchema,
   streamSchema,
   bufferToStream,
+  fetchUrlBytes,
   attachmentSchema,
   asAttachment,
   attachment,

package/dist/{chunk-4TXLNBGE.js → chunk-ODO6KRGX.js}

@@ -1,8 +1,9 @@
 import {
   bufferToStream,
+  fetchUrlBytes,
   readSchema,
   streamSchema
-} from "./chunk-YDHES53X.js";
+} from "./chunk-JTS25BT3.js";
 
 // src/content/voice.ts
 import { createReadStream } from "fs";
@@ -26,11 +27,23 @@ var resolveVoiceName = (input, name) => {
   if (name) {
     return name;
   }
+  if (input instanceof URL) {
+    return basename(input.pathname) || void 0;
+  }
   if (typeof input === "string") {
     return basename(input);
   }
   return;
 };
+var resolveVoiceMimeHint = (input, name) => {
+  if (input instanceof URL) {
+    return basename(input.pathname) || void 0;
+  }
+  if (typeof input === "string") {
+    return basename(input);
+  }
+  return name;
+};
 var resolveVoiceMimeType = (name, mimeType) => {
   if (mimeType) {
     if (!AUDIO_MIME_PATTERN.test(mimeType)) {
@@ -79,8 +92,16 @@ function voice(input, options) {
   return {
     build: async () => {
       const name = resolveVoiceName(input, options?.name);
-      const mimeHint = typeof input === "string" ? basename(input) : name;
+      const mimeHint = resolveVoiceMimeHint(input, name);
       const mimeType = resolveVoiceMimeType(mimeHint, options?.mimeType);
+      if (input instanceof URL) {
+        return asVoice({
+          name,
+          mimeType,
+          duration: options?.duration,
+          read: async () => (await fetchUrlBytes(input)).data
+        });
+      }
       if (typeof input === "string") {
         const stats = await stat(input);
         if (!stats.isFile()) {

package/dist/{chunk-UFJZIZDO.js → chunk-TOJQ6DPE.js}

@@ -1,9 +1,10 @@
 import {
   bufferToStream,
+  fetchUrlBytes,
   readSchema,
   resolveContents,
   streamSchema
-} from "./chunk-YDHES53X.js";
+} from "./chunk-JTS25BT3.js";
 
 // src/content/group.ts
 import z from "zod";
@@ -82,24 +83,10 @@ var fetchLinkMetadata = async (url) => {
     return {};
   }
 };
-var fetchImage = async (url) => {
-  const controller = new AbortController();
-  const timer = setTimeout(() => controller.abort(), DEFAULT_TIMEOUT_MS);
-  try {
-    const res = await fetch(url, {
-      signal: controller.signal,
-      headers: { "User-Agent": USER_AGENT }
-    });
-    if (!res.ok) {
-      throw new Error(`image fetch ${url} returned ${res.status}`);
-    }
-    const data = Buffer.from(await res.arrayBuffer());
-    const mimeType = res.headers.get("content-type") ?? void 0;
-    return { data, mimeType };
-  } finally {
-    clearTimeout(timer);
-  }
-};
+var fetchImage = (url) => fetchUrlBytes(new URL(url), {
+  timeoutMs: DEFAULT_TIMEOUT_MS,
+  headers: { "User-Agent": USER_AGENT }
+});
 
 // src/content/richlink.ts
 var richlinkCoverSchema = z2.object({

package/dist/{chunk-FPYXHZZA.js → chunk-UGBHJEX2.js}

@@ -2,7 +2,7 @@ import {
   asGroup,
   asRichlink,
   groupSchema
-} from "./chunk-UFJZIZDO.js";
+} from "./chunk-TOJQ6DPE.js";
 import {
   asPoll,
   asPollOption
@@ -16,7 +16,7 @@ import {
   asContact,
   fromVCard,
   toVCard
-} from "./chunk-L3VXHUVY.js";
+} from "./chunk-YZ226L5Y.js";
 import {
   UnsupportedError,
   asAttachment,
@@ -29,7 +29,7 @@ import {
   reactionSchema,
   text,
   textSchema
-} from "./chunk-YDHES53X.js";
+} from "./chunk-JTS25BT3.js";
 
 // src/providers/imessage/index.ts
 import { createClient as createClient2, MessageEffect as MessageEffect2 } from "@photon-ai/advanced-imessage";

package/dist/{chunk-ZGWANTLX.js → chunk-VTQWVJZ5.js}

@@ -1,18 +1,18 @@
 import {
   asVoice
-} from "./chunk-4TXLNBGE.js";
+} from "./chunk-ODO6KRGX.js";
 import {
   asContact,
   fromVCard,
   toVCard
-} from "./chunk-L3VXHUVY.js";
+} from "./chunk-YZ226L5Y.js";
 import {
   UnsupportedError,
   asAttachment,
   asCustom,
   definePlatform,
   reactionSchema
-} from "./chunk-YDHES53X.js";
+} from "./chunk-JTS25BT3.js";
 
 // src/providers/terminal/index.ts
 import { spawn } from "child_process";
@@ -665,7 +665,7 @@ async function spectrumToProtocol(content) {
   }
   throw UnsupportedError.content(
     content.type,
-    "terminal"
+    "Terminal"
   );
 }
 function protocolToSpectrum(p) {

package/dist/{chunk-L3VXHUVY.js → chunk-YZ226L5Y.js}

@@ -1,6 +1,6 @@
 import {
   readSchema
-} from "./chunk-YDHES53X.js";
+} from "./chunk-JTS25BT3.js";
 
 // src/utils/vcard.ts
 import vCard from "vcf";

package/dist/{chunk-VQOW7X7U.js → chunk-ZUQYLYGI.js}

@@ -8,7 +8,7 @@ import {
 } from "./chunk-YKWKZ2PZ.js";
 import {
   asContact
-} from "./chunk-L3VXHUVY.js";
+} from "./chunk-YZ226L5Y.js";
 import {
   UnsupportedError,
   asAttachment,
@@ -16,7 +16,7 @@ import {
   asReaction,
   asText,
   definePlatform
-} from "./chunk-YDHES53X.js";
+} from "./chunk-JTS25BT3.js";
 
 // src/providers/whatsapp-business/index.ts
 import { createClient as createClient2 } from "@photon-ai/whatsapp-business";

package/dist/index.d.ts

@@ -1,11 +1,12 @@
-import { C as ContentBuilder, U as User, M as Message, b as Space, c as ContentInput, d as Content, e as ProviderMessage, E as EventProducer, f as SpaceActionFn, g as MessageActionFn, h as CreateClientContext, i as Store, a as PlatformDef, P as Platform, j as PlatformProviderConfig, k as SpectrumLike, l as CustomEventStreams, A as AgentSender } from './types-BzW4gInA.js';
-export { m as AnyPlatformDef, B as Broadcaster, n as ManagedStream, o as PlatformInstance, p as PlatformMessage, q as PlatformRuntime, r as PlatformSpace, s as PlatformUser, S as SchemaMessage, t as broadcast, u as mergeStreams, v as stream } from './types-BzW4gInA.js';
+import { C as ContentBuilder, U as User, M as Message, b as Space, c as ContentInput, d as Content, e as ProviderMessage, E as EventProducer, f as SpaceActionFn, g as MessageActionFn, h as CreateClientContext, i as Store, a as PlatformDef, P as Platform, j as PlatformProviderConfig, k as SpectrumLike, l as CustomEventStreams, A as AgentSender } from './types-CtsphK2p.js';
+export { m as AnyPlatformDef, B as Broadcaster, n as ManagedStream, o as PlatformInstance, p as PlatformMessage, q as PlatformRuntime, r as PlatformSpace, s as PlatformUser, S as SchemaMessage, t as broadcast, u as mergeStreams, v as stream } from './types-CtsphK2p.js';
 import z__default from 'zod';
-import { P as PhotoInput } from './photo-content-BQF42prd.js';
+import { P as PhotoInput } from './photo-content-BJKnqgN-.js';
 import vCard from 'vcf';
 import 'hotscript';
 
-declare function attachment(input: string | Buffer, options?: {
+type AttachmentInput = string | Buffer | URL;
+declare function attachment(input: AttachmentInput, options?: {
     mimeType?: string;
     name?: string;
 }): ContentBuilder;
@@ -39,6 +40,10 @@ type AvatarInput = PhotoInput;
  * - `avatar("clear")` — remove the current chat avatar.
  * - `avatar("./icon.png")` — set avatar from a filesystem path. MIME type is
  *   inferred from the extension; override with `options.mimeType`.
+ * - `avatar(new URL("https://…/icon.png"))` — fetch the avatar lazily over
+ *   the network. Bytes stay in memory (safe in read-only environments). MIME
+ *   type is inferred from the URL pathname extension; override with
+ *   `options.mimeType` when the URL has no usable extension.
  * - `avatar(buffer, { mimeType })` — set avatar from in-memory bytes.
  *   `options.mimeType` is required (enforced at the type level).
  *
@@ -46,7 +51,7 @@ type AvatarInput = PhotoInput;
  * literally named `clear` with no extension, pass `"./clear"` or load it as a
  * Buffer.
  */
-declare function avatar(input: string, options?: {
+declare function avatar(input: string | URL, options?: {
     mimeType?: string;
 }): ContentBuilder;
 declare function avatar(input: Buffer, options: {
@@ -874,7 +879,8 @@ declare const voiceSchema: z__default.ZodObject<{
     stream: z__default.ZodFunction<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
 }, z__default.core.$strip>;
 type Voice = z__default.infer<typeof voiceSchema>;
-declare function voice(input: string | Buffer, options?: {
+type VoiceInput = string | Buffer | URL;
+declare function voice(input: VoiceInput, options?: {
     mimeType?: string;
     name?: string;
     duration?: number;

package/dist/index.js

@@ -1,10 +1,10 @@
 import {
   group,
   richlink
-} from "./chunk-UFJZIZDO.js";
+} from "./chunk-TOJQ6DPE.js";
 import {
   voice
-} from "./chunk-4TXLNBGE.js";
+} from "./chunk-ODO6KRGX.js";
 import {
   option,
   poll
@@ -20,7 +20,7 @@ import {
   contact,
   fromVCard,
   toVCard
-} from "./chunk-L3VXHUVY.js";
+} from "./chunk-YZ226L5Y.js";
 import {
   UnsupportedError,
   attachment,
@@ -38,7 +38,7 @@ import {
   text,
   typing,
   wrapProviderMessage
-} from "./chunk-YDHES53X.js";
+} from "./chunk-JTS25BT3.js";
 
 // src/emoji/generated.ts
 var GeneratedEmoji = {
@@ -2311,7 +2311,9 @@ async function Spectrum(options) {
     ];
     process.off("SIGINT", handleSignal);
     process.off("SIGTERM", handleSignal);
+    const streamCloseStart = performance.now();
     await Promise.allSettled(streamShutdowns);
+    const streamCloseMs = Math.round(performance.now() - streamCloseStart);
     const clientShutdowns = [];
     for (const state of platformStates.values()) {
       const destroy = state.definition.lifecycle.destroyClient;
@@ -2331,11 +2333,17 @@ async function Spectrum(options) {
         )
       );
     }
+    const clientCloseStart = performance.now();
     await Promise.allSettled(clientShutdowns);
+    const clientCloseMs = Math.round(performance.now() - clientCloseStart);
     customEventStreams.clear();
     messageBroadcasters.clear();
     platformStates.clear();
-    lifecycleLog.info("Spectrum stopped", { providers: providerNames });
+    lifecycleLog.info("Spectrum stopped", {
+      providers: providerNames,
+      streamCloseMs,
+      clientCloseMs
+    });
     if (otelHandle) {
       await otelHandle.shutdown();
     }

package/dist/{photo-content-BQF42prd.d.ts → photo-content-BJKnqgN-.d.ts}

@@ -8,6 +8,6 @@
  * and any DX fix (mime inference, read caching, sentinel docs) lands once.
  */
 declare const CLEAR_SENTINEL: "clear";
-type PhotoInput = typeof CLEAR_SENTINEL | string | Buffer;
+type PhotoInput = typeof CLEAR_SENTINEL | string | Buffer | URL;
 
 export type { PhotoInput as P };

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

@@ -1,8 +1,8 @@
-import { C as ContentBuilder, c as ContentInput, M as Message, S as SchemaMessage, P as Platform, a as PlatformDef, b as Space } from '../../types-BzW4gInA.js';
+import { C as ContentBuilder, c as ContentInput, M as Message, S as SchemaMessage, P as Platform, a as PlatformDef, b as Space } from '../../types-CtsphK2p.js';
 import * as zod_v4_core from 'zod/v4/core';
 import * as z from 'zod';
 import z__default from 'zod';
-import { P as PhotoInput } from '../../photo-content-BQF42prd.js';
+import { P as PhotoInput } from '../../photo-content-BJKnqgN-.js';
 import { MessageEffect, AdvancedIMessage } from '@photon-ai/advanced-imessage';
 import { IMessageSDK } from '@photon-ai/imessage-kit';
 import 'hotscript';
@@ -14,6 +14,10 @@ type BackgroundInput = PhotoInput;
  * - `background("clear")` — remove the current chat background.
  * - `background("./photo.jpg")` — set background from a filesystem path.
  *   MIME type is inferred from the extension; override with `options.mimeType`.
+ * - `background(new URL("https://…/photo.jpg"))` — fetch the background
+ *   lazily over the network. Bytes stay in memory (safe in read-only
+ *   environments). MIME type is inferred from the URL pathname extension;
+ *   override with `options.mimeType` when the URL has no usable extension.
  * - `background(buffer, { mimeType })` — set background from in-memory bytes.
  *   `options.mimeType` is required.
  *
@@ -30,7 +34,7 @@ type BackgroundInput = PhotoInput;
  * The framework treats it as a fire-and-forget control signal at runtime.
  */
 declare function background(input: "clear"): ContentBuilder;
-declare function background(input: string | Buffer, options?: {
+declare function background(input: string | Buffer | URL, options?: {
     mimeType?: string;
 }): ContentBuilder;
 

package/dist/providers/imessage/index.js

@@ -3,12 +3,12 @@ import {
   effect,
   imessage,
   read
-} from "../../chunk-FPYXHZZA.js";
-import "../../chunk-UFJZIZDO.js";
+} from "../../chunk-UGBHJEX2.js";
+import "../../chunk-TOJQ6DPE.js";
 import "../../chunk-KO67KDBD.js";
 import "../../chunk-YKWKZ2PZ.js";
-import "../../chunk-L3VXHUVY.js";
-import "../../chunk-YDHES53X.js";
+import "../../chunk-YZ226L5Y.js";
+import "../../chunk-JTS25BT3.js";
 export {
   background,
   effect,

package/dist/providers/index.d.ts

@@ -2,11 +2,11 @@ export { imessage } from './imessage/index.js';
 export { slack } from './slack/index.js';
 export { terminal } from './terminal/index.js';
 export { whatsappBusiness } from './whatsapp-business/index.js';
-import '../types-BzW4gInA.js';
+import '../types-CtsphK2p.js';
 import 'hotscript';
 import 'zod';
 import 'zod/v4/core';
-import '../photo-content-BQF42prd.js';
+import '../photo-content-BJKnqgN-.js';
 import '@photon-ai/advanced-imessage';
 import '@photon-ai/imessage-kit';
 import '@photon-ai/slack';

package/dist/providers/index.js

@@ -1,21 +1,21 @@
 import {
   imessage
-} from "../chunk-FPYXHZZA.js";
-import "../chunk-UFJZIZDO.js";
+} from "../chunk-UGBHJEX2.js";
+import "../chunk-TOJQ6DPE.js";
 import {
   slack
-} from "../chunk-E7AXYNOZ.js";
+} from "../chunk-5HNHMI6L.js";
 import {
   terminal
-} from "../chunk-ZGWANTLX.js";
-import "../chunk-4TXLNBGE.js";
+} from "../chunk-VTQWVJZ5.js";
+import "../chunk-ODO6KRGX.js";
 import {
   whatsappBusiness
-} from "../chunk-VQOW7X7U.js";
+} from "../chunk-ZUQYLYGI.js";
 import "../chunk-KO67KDBD.js";
 import "../chunk-YKWKZ2PZ.js";
-import "../chunk-L3VXHUVY.js";
-import "../chunk-YDHES53X.js";
+import "../chunk-YZ226L5Y.js";
+import "../chunk-JTS25BT3.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-BzW4gInA.js';
+import { S as SchemaMessage, P as Platform, a as PlatformDef } from '../../types-CtsphK2p.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,8 +1,8 @@
 import {
   slack
-} from "../../chunk-E7AXYNOZ.js";
+} from "../../chunk-5HNHMI6L.js";
 import "../../chunk-YKWKZ2PZ.js";
-import "../../chunk-YDHES53X.js";
+import "../../chunk-JTS25BT3.js";
 export {
   slack
 };

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

@@ -1,4 +1,4 @@
-import { P as Platform, a as PlatformDef, M as Message, U as User, b as Space } from '../../types-BzW4gInA.js';
+import { P as Platform, a as PlatformDef, M as Message, U as User, b as Space } from '../../types-CtsphK2p.js';
 import { ChildProcess } from 'node:child_process';
 import z__default from 'zod';
 import { Socket } from 'node:net';
@@ -107,15 +107,15 @@ declare const terminal: Platform<PlatformDef<"Terminal", z__default.ZodObject<{
     } | undefined;
     id: string;
     content: {
-        type: "text";
-        text: string;
-    } | {
         type: "attachment";
         name: string;
         mimeType: string;
         read: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
         stream: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
         size?: number | undefined;
+    } | {
+        type: "text";
+        text: string;
     } | {
         type: "custom";
         raw: unknown;
@@ -210,15 +210,15 @@ declare const terminal: Platform<PlatformDef<"Terminal", z__default.ZodObject<{
     } | {
         type: "effect";
         content: {
-            type: "text";
-            text: string;
-        } | {
             type: "attachment";
             name: string;
             mimeType: string;
             read: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
             stream: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
             size?: number | undefined;
+        } | {
+            type: "text";
+            text: string;
         };
         effect: string;
     } | {
@@ -237,17 +237,17 @@ declare const terminal: Platform<PlatformDef<"Terminal", z__default.ZodObject<{
             kind: "clear";
         };
     } | {
-        type: "edit";
+        type: "reply";
         content: {
-            type: "text";
-            text: string;
-        } | {
             type: "attachment";
             name: string;
             mimeType: string;
             read: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
             stream: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
             size?: number | undefined;
+        } | {
+            type: "text";
+            text: string;
         } | {
             type: "custom";
             raw: unknown;
@@ -342,15 +342,15 @@ declare const terminal: Platform<PlatformDef<"Terminal", z__default.ZodObject<{
         } | {
             type: "effect";
             content: {
-                type: "text";
-                text: string;
-            } | {
                 type: "attachment";
                 name: string;
                 mimeType: string;
                 read: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
                 stream: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
                 size?: number | undefined;
+            } | {
+                type: "text";
+                text: string;
             };
             effect: string;
         } | {
@@ -371,17 +371,17 @@ declare const terminal: Platform<PlatformDef<"Terminal", z__default.ZodObject<{
         };
         target: Message<string, User, Space<unknown>>;
     } | {
-        type: "reply";
+        type: "edit";
         content: {
-            type: "text";
-            text: string;
-        } | {
             type: "attachment";
             name: string;
             mimeType: string;
             read: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
             stream: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
             size?: number | undefined;
+        } | {
+            type: "text";
+            text: string;
         } | {
             type: "custom";
             raw: unknown;
@@ -476,15 +476,15 @@ declare const terminal: Platform<PlatformDef<"Terminal", z__default.ZodObject<{
         } | {
             type: "effect";
             content: {
-                type: "text";
-                text: string;
-            } | {
                 type: "attachment";
                 name: string;
                 mimeType: string;
                 read: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
                 stream: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
                 size?: number | undefined;
+            } | {
+                type: "text";
+                text: string;
             };
             effect: string;
         } | {

package/dist/providers/terminal/index.js

@@ -1,9 +1,9 @@
 import {
   terminal
-} from "../../chunk-ZGWANTLX.js";
-import "../../chunk-4TXLNBGE.js";
-import "../../chunk-L3VXHUVY.js";
-import "../../chunk-YDHES53X.js";
+} from "../../chunk-VTQWVJZ5.js";
+import "../../chunk-ODO6KRGX.js";
+import "../../chunk-YZ226L5Y.js";
+import "../../chunk-JTS25BT3.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-BzW4gInA.js';
+import { S as SchemaMessage, P as Platform, a as PlatformDef } from '../../types-CtsphK2p.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,10 +1,10 @@
 import {
   whatsappBusiness
-} from "../../chunk-VQOW7X7U.js";
+} from "../../chunk-ZUQYLYGI.js";
 import "../../chunk-KO67KDBD.js";
 import "../../chunk-YKWKZ2PZ.js";
-import "../../chunk-L3VXHUVY.js";
-import "../../chunk-YDHES53X.js";
+import "../../chunk-YZ226L5Y.js";
+import "../../chunk-JTS25BT3.js";
 export {
   whatsappBusiness
 };

package/dist/{types-BzW4gInA.d.ts → types-CtsphK2p.d.ts}

@@ -700,13 +700,16 @@ interface Space<_Def = unknown> {
      * - `space.avatar("clear")` — remove the current avatar.
      * - `space.avatar("./icon.png")` — set from a filesystem path; MIME type
      *   is inferred from the extension.
+     * - `space.avatar(new URL("https://…/icon.png"))` — fetch the avatar
+     *   lazily over the network. Bytes stay in memory (safe in read-only
+     *   environments); MIME type is inferred from the URL pathname extension.
      * - `space.avatar(buffer, { mimeType })` — set from in-memory bytes;
      *   `mimeType` is required (enforced at the type level).
      *
      * Universal API; per-platform constraints (e.g. iMessage: remote + group
      * only) surface as `UnsupportedError` from the provider's send action.
      */
-    avatar(input: string, options?: {
+    avatar(input: string | URL, options?: {
         mimeType?: string;
     }): Promise<void>;
     avatar(input: Buffer, options: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spectrum-ts",
-  "version": "1.13.0",
+  "version": "1.14.0",
   "description": "Bring agents to any interface — unified messaging SDK for TypeScript.",
   "repository": {
     "type": "git",
@@ -34,7 +34,7 @@
     "./manifest.json": "./dist/manifest.json"
   },
   "dependencies": {
-    "@photon-ai/advanced-imessage": "^0.9.0",
+    "@photon-ai/advanced-imessage": "^0.10.0",
     "@photon-ai/imessage-kit": "^3.0.0",
     "@photon-ai/otel": "^0.1.1",
     "@photon-ai/slack": "^0.2.0",