@spectrum-ts/core 7.0.0 → 8.1.0

package/dist/{attachment-BGIJLBk4.d.ts → attachment-DSVZbNyn.d.ts}

@@ -1,6 +1,6 @@
 import z from "zod";
-import vCard from "vcf";
 import { LogLevel } from "@photon-ai/otel";
+import vCard from "vcf";
 
 //#region src/content/app.d.ts
 /**
@@ -447,12 +447,6 @@ interface Message<TPlatform extends string = string, TSender extends User = User
 declare const editSchema: z.ZodObject<{
   type: z.ZodLiteral<"edit">;
   content: z.ZodCustom<{
-    type: "text";
-    text: string;
-  } | {
-    type: "markdown";
-    markdown: string;
-  } | {
     type: "attachment";
     id: string;
     name: string;
@@ -507,19 +501,11 @@ declare const editSchema: z.ZodObject<{
     type: "custom";
     raw: unknown;
   } | {
-    type: "reaction";
-    emoji: string;
-    target: Message<string, User, Space<unknown>>;
+    type: "text";
+    text: string;
   } | {
-    type: "richlink";
-    url: string;
-    title: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodOptional<z.ZodString>>>;
-    summary: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodOptional<z.ZodString>>>;
-    cover: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodOptional<z.ZodObject<{
-      mimeType: z.ZodOptional<z.ZodString>;
-      read: z.ZodFunction<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
-      stream: z.ZodFunction<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
-    }, z.core.$strip>>>>;
+    type: "markdown";
+    markdown: string;
   } | {
     type: "group";
     items: Message<string, User, Space<unknown>>[];
@@ -543,6 +529,13 @@ declare const editSchema: z.ZodObject<{
     };
     selected: boolean;
     title: string;
+  } | {
+    type: "reaction";
+    emoji: string;
+    target: Message<string, User, Space<unknown>>;
+  } | {
+    type: "richlink";
+    url: string;
   } | {
     type: "voice";
     mimeType: string;
@@ -571,12 +564,6 @@ declare const editSchema: z.ZodObject<{
   } | {
     type: "effect";
     content: {
-      type: "text";
-      text: string;
-    } | {
-      type: "markdown";
-      markdown: string;
-    } | {
       type: "attachment";
       id: string;
       name: string;
@@ -584,6 +571,12 @@ declare const editSchema: z.ZodObject<{
       read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
       stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
       size?: number | undefined;
+    } | {
+      type: "text";
+      text: string;
+    } | {
+      type: "markdown";
+      markdown: string;
     };
     effect: string;
   } | {
@@ -602,12 +595,6 @@ declare const editSchema: z.ZodObject<{
       kind: "clear";
     };
   }, {
-    type: "text";
-    text: string;
-  } | {
-    type: "markdown";
-    markdown: string;
-  } | {
     type: "attachment";
     id: string;
     name: string;
@@ -662,19 +649,11 @@ declare const editSchema: z.ZodObject<{
     type: "custom";
     raw: unknown;
   } | {
-    type: "reaction";
-    emoji: string;
-    target: Message<string, User, Space<unknown>>;
+    type: "text";
+    text: string;
   } | {
-    type: "richlink";
-    url: string;
-    title: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodOptional<z.ZodString>>>;
-    summary: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodOptional<z.ZodString>>>;
-    cover: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodOptional<z.ZodObject<{
-      mimeType: z.ZodOptional<z.ZodString>;
-      read: z.ZodFunction<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
-      stream: z.ZodFunction<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
-    }, z.core.$strip>>>>;
+    type: "markdown";
+    markdown: string;
   } | {
     type: "group";
     items: Message<string, User, Space<unknown>>[];
@@ -698,6 +677,13 @@ declare const editSchema: z.ZodObject<{
     };
     selected: boolean;
     title: string;
+  } | {
+    type: "reaction";
+    emoji: string;
+    target: Message<string, User, Space<unknown>>;
+  } | {
+    type: "richlink";
+    url: string;
   } | {
     type: "voice";
     mimeType: string;
@@ -726,12 +712,6 @@ declare const editSchema: z.ZodObject<{
   } | {
     type: "effect";
     content: {
-      type: "text";
-      text: string;
-    } | {
-      type: "markdown";
-      markdown: string;
-    } | {
       type: "attachment";
       id: string;
       name: string;
@@ -739,6 +719,12 @@ declare const editSchema: z.ZodObject<{
       read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
       stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
       size?: number | undefined;
+    } | {
+      type: "text";
+      text: string;
+    } | {
+      type: "markdown";
+      markdown: string;
     };
     effect: string;
   } | {
@@ -982,12 +968,6 @@ declare function rename(displayName: string): ContentBuilder;
 declare const replySchema: z.ZodObject<{
   type: z.ZodLiteral<"reply">;
   content: z.ZodCustom<{
-    type: "text";
-    text: string;
-  } | {
-    type: "markdown";
-    markdown: string;
-  } | {
     type: "attachment";
     id: string;
     name: string;
@@ -1042,19 +1022,11 @@ declare const replySchema: z.ZodObject<{
     type: "custom";
     raw: unknown;
   } | {
-    type: "reaction";
-    emoji: string;
-    target: Message<string, User, Space<unknown>>;
+    type: "text";
+    text: string;
   } | {
-    type: "richlink";
-    url: string;
-    title: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodOptional<z.ZodString>>>;
-    summary: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodOptional<z.ZodString>>>;
-    cover: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodOptional<z.ZodObject<{
-      mimeType: z.ZodOptional<z.ZodString>;
-      read: z.ZodFunction<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
-      stream: z.ZodFunction<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
-    }, z.core.$strip>>>>;
+    type: "markdown";
+    markdown: string;
   } | {
     type: "group";
     items: Message<string, User, Space<unknown>>[];
@@ -1078,6 +1050,13 @@ declare const replySchema: z.ZodObject<{
     };
     selected: boolean;
     title: string;
+  } | {
+    type: "reaction";
+    emoji: string;
+    target: Message<string, User, Space<unknown>>;
+  } | {
+    type: "richlink";
+    url: string;
   } | {
     type: "voice";
     mimeType: string;
@@ -1106,12 +1085,6 @@ declare const replySchema: z.ZodObject<{
   } | {
     type: "effect";
     content: {
-      type: "text";
-      text: string;
-    } | {
-      type: "markdown";
-      markdown: string;
-    } | {
       type: "attachment";
       id: string;
       name: string;
@@ -1119,6 +1092,12 @@ declare const replySchema: z.ZodObject<{
       read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
       stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
       size?: number | undefined;
+    } | {
+      type: "text";
+      text: string;
+    } | {
+      type: "markdown";
+      markdown: string;
     };
     effect: string;
   } | {
@@ -1137,12 +1116,6 @@ declare const replySchema: z.ZodObject<{
       kind: "clear";
     };
   }, {
-    type: "text";
-    text: string;
-  } | {
-    type: "markdown";
-    markdown: string;
-  } | {
     type: "attachment";
     id: string;
     name: string;
@@ -1197,19 +1170,11 @@ declare const replySchema: z.ZodObject<{
     type: "custom";
     raw: unknown;
   } | {
-    type: "reaction";
-    emoji: string;
-    target: Message<string, User, Space<unknown>>;
+    type: "text";
+    text: string;
   } | {
-    type: "richlink";
-    url: string;
-    title: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodOptional<z.ZodString>>>;
-    summary: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodOptional<z.ZodString>>>;
-    cover: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodOptional<z.ZodObject<{
-      mimeType: z.ZodOptional<z.ZodString>;
-      read: z.ZodFunction<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
-      stream: z.ZodFunction<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
-    }, z.core.$strip>>>>;
+    type: "markdown";
+    markdown: string;
   } | {
     type: "group";
     items: Message<string, User, Space<unknown>>[];
@@ -1233,6 +1198,13 @@ declare const replySchema: z.ZodObject<{
     };
     selected: boolean;
     title: string;
+  } | {
+    type: "reaction";
+    emoji: string;
+    target: Message<string, User, Space<unknown>>;
+  } | {
+    type: "richlink";
+    url: string;
   } | {
     type: "voice";
     mimeType: string;
@@ -1261,12 +1233,6 @@ declare const replySchema: z.ZodObject<{
   } | {
     type: "effect";
     content: {
-      type: "text";
-      text: string;
-    } | {
-      type: "markdown";
-      markdown: string;
-    } | {
       type: "attachment";
       id: string;
       name: string;
@@ -1274,6 +1240,12 @@ declare const replySchema: z.ZodObject<{
       read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
       stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
       size?: number | undefined;
+    } | {
+      type: "text";
+      text: string;
+    } | {
+      type: "markdown";
+      markdown: string;
     };
     effect: string;
   } | {
@@ -1301,28 +1273,21 @@ declare function reply(content: ContentInput, target: Message | undefined): Cont
 declare const resolveContents: (items: readonly ContentInput[]) => Promise<Content[]>;
 //#endregion
 //#region src/content/richlink.d.ts
+/**
+ * A URL the platform should render as a rich link preview.
+ *
+ * Outbound-only by design: inbound messages always surface as `text` content —
+ * a URL received from a platform arrives as plain text, never as `richlink`, so
+ * no metadata is fetched on the inbound path. On outbound, each platform asks
+ * its native client to render the preview (remote iMessage: `enableLinkPreview`;
+ * Telegram: auto-unfurls the bare URL), so the framework carries only the URL
+ * and fetches nothing itself.
+ */
 declare const richlinkSchema: z.ZodObject<{
   type: z.ZodLiteral<"richlink">;
   url: z.ZodURL;
-  title: z.ZodFunction<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodOptional<z.ZodString>>>;
-  summary: z.ZodFunction<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodOptional<z.ZodString>>>;
-  cover: z.ZodFunction<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodOptional<z.ZodObject<{
-    mimeType: z.ZodOptional<z.ZodString>;
-    read: z.ZodFunction<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
-    stream: z.ZodFunction<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
-  }, z.core.$strip>>>>;
 }, z.core.$strip>;
 type Richlink = z.infer<typeof richlinkSchema>;
-/**
- * Construct a `richlink` content value.
- *
- * Accessors (`title`, `summary`, `cover`) are async and lazy: the first call
- * issues a single network request to the URL; subsequent calls share the
- * cached result. Network / parse failures resolve to `undefined` and are
- * cached — no retries. Callers who only need `title` / `summary` never
- * trigger an image download; calling `cover.read()` triggers one additional
- * request to fetch the image bytes.
- */
 declare const asRichlink: (input: {
   url: string;
 }) => Richlink;
@@ -6807,13 +6772,6 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strip>, z.ZodObject<{
   type: z.ZodLiteral<"richlink">;
   url: z.ZodURL;
-  title: z.ZodFunction<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodOptional<z.ZodString>>>;
-  summary: z.ZodFunction<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodOptional<z.ZodString>>>;
-  cover: z.ZodFunction<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodOptional<z.ZodObject<{
-    mimeType: z.ZodOptional<z.ZodString>;
-    read: z.ZodFunction<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
-    stream: z.ZodFunction<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
-  }, z.core.$strip>>>>;
 }, z.core.$strip>, z.ZodObject<{
   type: z.ZodLiteral<"app">;
   url: z.ZodFunction<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodURL>>;
@@ -6893,12 +6851,6 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strip>, z.ZodObject<{
   type: z.ZodLiteral<"reply">;
   content: z.ZodCustom<{
-    type: "text";
-    text: string;
-  } | {
-    type: "markdown";
-    markdown: string;
-  } | {
     type: "attachment";
     id: string;
     name: string;
@@ -6953,19 +6905,11 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: "custom";
     raw: unknown;
   } | {
-    type: "reaction";
-    emoji: string;
-    target: Message<string, User, Space<unknown>>;
+    type: "text";
+    text: string;
   } | {
-    type: "richlink";
-    url: string;
-    title: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodOptional<z.ZodString>>>;
-    summary: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodOptional<z.ZodString>>>;
-    cover: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodOptional<z.ZodObject<{
-      mimeType: z.ZodOptional<z.ZodString>;
-      read: z.ZodFunction<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
-      stream: z.ZodFunction<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
-    }, z.core.$strip>>>>;
+    type: "markdown";
+    markdown: string;
   } | {
     type: "group";
     items: Message<string, User, Space<unknown>>[];
@@ -6989,6 +6933,13 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     };
     selected: boolean;
     title: string;
+  } | {
+    type: "reaction";
+    emoji: string;
+    target: Message<string, User, Space<unknown>>;
+  } | {
+    type: "richlink";
+    url: string;
   } | {
     type: "voice";
     mimeType: string;
@@ -7017,12 +6968,6 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   } | {
     type: "effect";
     content: {
-      type: "text";
-      text: string;
-    } | {
-      type: "markdown";
-      markdown: string;
-    } | {
       type: "attachment";
       id: string;
       name: string;
@@ -7030,6 +6975,12 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
       stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
       size?: number | undefined;
+    } | {
+      type: "text";
+      text: string;
+    } | {
+      type: "markdown";
+      markdown: string;
     };
     effect: string;
   } | {
@@ -7048,12 +6999,6 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       kind: "clear";
     };
   }, {
-    type: "text";
-    text: string;
-  } | {
-    type: "markdown";
-    markdown: string;
-  } | {
     type: "attachment";
     id: string;
     name: string;
@@ -7108,19 +7053,11 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: "custom";
     raw: unknown;
   } | {
-    type: "reaction";
-    emoji: string;
-    target: Message<string, User, Space<unknown>>;
+    type: "text";
+    text: string;
   } | {
-    type: "richlink";
-    url: string;
-    title: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodOptional<z.ZodString>>>;
-    summary: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodOptional<z.ZodString>>>;
-    cover: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodOptional<z.ZodObject<{
-      mimeType: z.ZodOptional<z.ZodString>;
-      read: z.ZodFunction<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
-      stream: z.ZodFunction<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
-    }, z.core.$strip>>>>;
+    type: "markdown";
+    markdown: string;
   } | {
     type: "group";
     items: Message<string, User, Space<unknown>>[];
@@ -7144,6 +7081,13 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     };
     selected: boolean;
     title: string;
+  } | {
+    type: "reaction";
+    emoji: string;
+    target: Message<string, User, Space<unknown>>;
+  } | {
+    type: "richlink";
+    url: string;
   } | {
     type: "voice";
     mimeType: string;
@@ -7172,12 +7116,6 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   } | {
     type: "effect";
     content: {
-      type: "text";
-      text: string;
-    } | {
-      type: "markdown";
-      markdown: string;
-    } | {
       type: "attachment";
       id: string;
       name: string;
@@ -7185,6 +7123,12 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
       stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
       size?: number | undefined;
+    } | {
+      type: "text";
+      text: string;
+    } | {
+      type: "markdown";
+      markdown: string;
     };
     effect: string;
   } | {
@@ -7207,12 +7151,6 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strip>, z.ZodObject<{
   type: z.ZodLiteral<"edit">;
   content: z.ZodCustom<{
-    type: "text";
-    text: string;
-  } | {
-    type: "markdown";
-    markdown: string;
-  } | {
     type: "attachment";
     id: string;
     name: string;
@@ -7267,19 +7205,11 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: "custom";
     raw: unknown;
   } | {
-    type: "reaction";
-    emoji: string;
-    target: Message<string, User, Space<unknown>>;
+    type: "text";
+    text: string;
   } | {
-    type: "richlink";
-    url: string;
-    title: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodOptional<z.ZodString>>>;
-    summary: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodOptional<z.ZodString>>>;
-    cover: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodOptional<z.ZodObject<{
-      mimeType: z.ZodOptional<z.ZodString>;
-      read: z.ZodFunction<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
-      stream: z.ZodFunction<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
-    }, z.core.$strip>>>>;
+    type: "markdown";
+    markdown: string;
   } | {
     type: "group";
     items: Message<string, User, Space<unknown>>[];
@@ -7303,6 +7233,13 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     };
     selected: boolean;
     title: string;
+  } | {
+    type: "reaction";
+    emoji: string;
+    target: Message<string, User, Space<unknown>>;
+  } | {
+    type: "richlink";
+    url: string;
   } | {
     type: "voice";
     mimeType: string;
@@ -7331,12 +7268,6 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   } | {
     type: "effect";
     content: {
-      type: "text";
-      text: string;
-    } | {
-      type: "markdown";
-      markdown: string;
-    } | {
       type: "attachment";
       id: string;
       name: string;
@@ -7344,6 +7275,12 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
       stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
       size?: number | undefined;
+    } | {
+      type: "text";
+      text: string;
+    } | {
+      type: "markdown";
+      markdown: string;
     };
     effect: string;
   } | {
@@ -7362,12 +7299,6 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       kind: "clear";
     };
   }, {
-    type: "text";
-    text: string;
-  } | {
-    type: "markdown";
-    markdown: string;
-  } | {
     type: "attachment";
     id: string;
     name: string;
@@ -7422,19 +7353,11 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: "custom";
     raw: unknown;
   } | {
-    type: "reaction";
-    emoji: string;
-    target: Message<string, User, Space<unknown>>;
+    type: "text";
+    text: string;
   } | {
-    type: "richlink";
-    url: string;
-    title: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodOptional<z.ZodString>>>;
-    summary: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodOptional<z.ZodString>>>;
-    cover: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodOptional<z.ZodObject<{
-      mimeType: z.ZodOptional<z.ZodString>;
-      read: z.ZodFunction<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
-      stream: z.ZodFunction<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
-    }, z.core.$strip>>>>;
+    type: "markdown";
+    markdown: string;
   } | {
     type: "group";
     items: Message<string, User, Space<unknown>>[];
@@ -7458,6 +7381,13 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     };
     selected: boolean;
     title: string;
+  } | {
+    type: "reaction";
+    emoji: string;
+    target: Message<string, User, Space<unknown>>;
+  } | {
+    type: "richlink";
+    url: string;
   } | {
     type: "voice";
     mimeType: string;
@@ -7486,12 +7416,6 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   } | {
     type: "effect";
     content: {
-      type: "text";
-      text: string;
-    } | {
-      type: "markdown";
-      markdown: string;
-    } | {
       type: "attachment";
       id: string;
       name: string;
@@ -7499,6 +7423,12 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
       stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
       size?: number | undefined;
+    } | {
+      type: "text";
+      text: string;
+    } | {
+      type: "markdown";
+      markdown: string;
     };
     effect: string;
   } | {

package/dist/authoring.d.ts

@@ -1,6 +1,6 @@
-import { $t as groupSchema, Bt as asPollOption, Dn as buildPhotoAction, En as PhotoInput, H as ProviderMessageRecord, K as ManagedStream, Nt as asRead, On as photoActionSchema, St as asText, Tt as asRichlink, Wt as asMarkdown, Zt as asGroup, cn as reactionSchema, gt as asVoice, ln as asCustom, on as asReaction, r as asAttachment, yn as asContact, zt as asPoll } from "./attachment-BGIJLBk4.js";
+import { $t as groupSchema, Bt as asPollOption, Dn as buildPhotoAction, En as PhotoInput, H as ProviderMessageRecord, K as ManagedStream, Nt as asRead, On as photoActionSchema, St as asText, Tt as asRichlink, Wt as asMarkdown, Zt as asGroup, cn as reactionSchema, gt as asVoice, ln as asCustom, on as asReaction, r as asAttachment, yn as asContact, zt as asPoll } from "./attachment-DSVZbNyn.js";
 import z from "zod";
-import { LogAttrs, LogAttrs as LogAttrs$1, LogLevel, PhotonLogger, createLogger, sanitizeEmail, sanitizeErrorMessage, sanitizePhone, setLogLevel } from "@photon-ai/otel";
+import { FetchSpanOptions, LogAttrs, LogAttrs as LogAttrs$1, LogLevel, PhotonLogger, SanitizeUrlOptions, createLogger, sanitizeEmail, sanitizeErrorMessage, sanitizePhone, sanitizeUrl, setLogLevel } from "@photon-ai/otel";
 import { Token } from "marked";
 
 //#region src/content/effect.d.ts
@@ -30,6 +30,26 @@ declare const ensureM4a: (buffer: Buffer, mimeType: string) => Promise<{
   duration?: number;
 }>;
 //#endregion
+//#region src/utils/instrumented-fetch.d.ts
+/**
+ * Build a fetch that traces spectrum's OWN outbound HTTP: each request through
+ * the returned fetch emits a CLIENT span (tagged with `peer.service`) and
+ * carries W3C trace context downstream. It never mutates `globalThis.fetch`, so
+ * a consumer's unrelated requests stay untouched.
+ *
+ * The base delegates to `globalThis.fetch` at call time — deliberately NOT
+ * `createInstrumentedFetch(globalThis.fetch, …)`, which would capture the
+ * original and bypass a test's `spyOn(globalThis, "fetch")`. When telemetry is
+ * off (no `setupOtel`), the tracer is a no-op and this is a transparent
+ * pass-through. Create one per module: `const tf = tracedFetch("…")`.
+ *
+ * Pass `redactUrl` to strip secrets from a request URL before it is recorded as
+ * the span's `url.full` (e.g. a token in the path or query); the real request
+ * still uses the original URL. Pair with `sanitizeUrl` for semconv-style query
+ * redaction.
+ */
+declare const tracedFetch: (peerService: string, options?: Pick<FetchSpanOptions, "ignore" | "redactUrl">) => typeof fetch;
+//#endregion
 //#region src/utils/markdown.d.ts
 /**
  * Render a run of inline markdown tokens (a paragraph's or table cell's
@@ -103,4 +123,4 @@ declare const resumableOrderedStream: <TLive, TMissed, TOutput>(options: Resumab
  */
 declare function errorAttrs(error: unknown, prefix?: string): LogAttrs$1;
 //#endregion
-export { type CloseableAsyncIterable, type LogAttrs, type LogLevel, type PhotoInput, type PhotonLogger, type ProviderMessageRecord, type ResumableStreamItem, asAttachment, asContact, asCustom, asGroup, asMarkdown, asPoll, asPollOption, asReaction, asRead, asRichlink, asText, asVoice, buildPhotoAction, createLogger, ensureM4a, errorAttrs, groupSchema, messageEffectSchema, photoActionSchema, reactionSchema, renderInlineTokens, resumableOrderedStream, sanitizeEmail, sanitizeErrorMessage, sanitizePhone, setLogLevel };
+export { type CloseableAsyncIterable, type LogAttrs, type LogLevel, type PhotoInput, type PhotonLogger, type ProviderMessageRecord, type ResumableStreamItem, type SanitizeUrlOptions, asAttachment, asContact, asCustom, asGroup, asMarkdown, asPoll, asPollOption, asReaction, asRead, asRichlink, asText, asVoice, buildPhotoAction, createLogger, ensureM4a, errorAttrs, groupSchema, messageEffectSchema, photoActionSchema, reactionSchema, renderInlineTokens, resumableOrderedStream, sanitizeEmail, sanitizeErrorMessage, sanitizePhone, sanitizeUrl, setLogLevel, tracedFetch };

package/dist/authoring.js

@@ -1,8 +1,8 @@
-import { D as asGroup, E as markdownSchema, H as buildPhotoAction, I as asCustom, K as attachmentSchema, N as textSchema, R as asContact, U as photoActionSchema, W as asAttachment, _ as asReaction, b as asPoll, d as asVoice, h as asRead, i as stream, j as asText, k as groupSchema, l as renderInlineTokens, o as errorAttrs, p as asRichlink, w as asMarkdown, x as asPollOption, y as reactionSchema } from "./stream-BLWs7NJ5.js";
+import { D as asGroup, E as markdownSchema, H as buildPhotoAction, I as asCustom, J as tracedFetch, K as attachmentSchema, N as textSchema, R as asContact, U as photoActionSchema, W as asAttachment, _ as asReaction, b as asPoll, d as asVoice, h as asRead, i as stream, j as asText, k as groupSchema, l as renderInlineTokens, o as errorAttrs, p as asRichlink, w as asMarkdown, x as asPollOption, y as reactionSchema } from "./stream-Cs0NMbNv.js";
 import z from "zod";
+import { createLogger, createLogger as createLogger$1, sanitizeEmail, sanitizeErrorMessage, sanitizePhone, sanitizeUrl, setLogLevel } from "@photon-ai/otel";
 import { mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
 import { join } from "node:path";
-import { createLogger, createLogger as createLogger$1, sanitizeEmail, sanitizeErrorMessage, sanitizePhone, setLogLevel } from "@photon-ai/otel";
 import { spawn } from "node:child_process";
 import { tmpdir } from "node:os";
 //#region src/content/effect.ts
@@ -422,4 +422,4 @@ const resumableOrderedStream = (options) => stream((emit, end) => {
 	};
 });
 //#endregion
-export { asAttachment, asContact, asCustom, asGroup, asMarkdown, asPoll, asPollOption, asReaction, asRead, asRichlink, asText, asVoice, buildPhotoAction, createLogger, ensureM4a, errorAttrs, groupSchema, messageEffectSchema, photoActionSchema, reactionSchema, renderInlineTokens, resumableOrderedStream, sanitizeEmail, sanitizeErrorMessage, sanitizePhone, setLogLevel };
+export { asAttachment, asContact, asCustom, asGroup, asMarkdown, asPoll, asPollOption, asReaction, asRead, asRichlink, asText, asVoice, buildPhotoAction, createLogger, ensureM4a, errorAttrs, groupSchema, messageEffectSchema, photoActionSchema, reactionSchema, renderInlineTokens, resumableOrderedStream, sanitizeEmail, sanitizeErrorMessage, sanitizePhone, sanitizeUrl, setLogLevel, tracedFetch };

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-import { $ as FusorTokenData, A as isFusorEvent, An as AppLayout, At as Rename, B as PlatformUser, C as FusorVerify, Cn as Avatar, Ct as text, D as WebhookRawResult, Dt as resolveContents, E as WebhookRawRequest, Et as richlink, F as PlatformInstance, Ft as Poll, G as Broadcaster, Gt as markdown, Ht as poll, I as PlatformMessage, It as PollChoice, J as mergeStreams, Jt as StreamTextSource, K as ManagedStream, Kt as DeltaExtractor, L as PlatformProviderConfig, Lt as PollChoiceInput, M as EventProducer, Mn as app, Mt as Read, N as Platform, Nn as appLayoutSchema, O as FusorEvent, Ot as Reply, P as PlatformDef, Pt as read, Q as DedicatedTokenData, Qt as group, R as PlatformRuntime, Rt as PollOption, S as FusorRespond, Sn as User, T as WebhookHandler, Tn as avatar, U as SchemaMessage, Ut as Markdown, V as ProviderMessage, Vt as option, W as SpaceNamespace, X as Store, Xt as Group, Y as stream, Yt as TextStreamOptions, Z as CloudPlatform, _ as FusorClient, _n as ContactOrg, _t as voice, a as Content, an as ReactionBuilder, at as SharedTokenData, b as FusorMessagesReturn, bn as contact, bt as Typing, c as fromVCard, ct as SpectrumCloudError, d as UnsupportedKind, dn as Contact, dt as TokenData, en as Edit, et as ImessageInfoData, f as Spectrum, fn as ContactAddress, ft as cloud, g as isFusorClient, gn as ContactName, h as fusor, hn as ContactInput, ht as Voice, i as attachment, in as Reaction, it as ProjectProfile, j as AnyPlatformDef, jn as AppUrl, jt as rename, k as fusorEvent, kn as App, kt as reply, l as toVCard, lt as SubscriptionData, m as definePlatform, mn as ContactEmail, mt as EmojiKey, n as AttachmentInput, nn as Message, nt as PlatformsData, o as ContentBuilder, ot as SlackTeamMeta, p as SpectrumInstance, pn as ContactDetails, pt as Emoji, q as broadcast, qt as StreamText, rn as Space, rt as ProjectData, s as ContentInput, sn as reaction, st as SlackTokenData, t as Attachment, tn as edit, tt as PlatformStatus, u as UnsupportedError, un as custom, ut as SubscriptionStatus, v as FusorMessages, vn as ContactPhone, vt as Unsend, w as FusorVerifyRequest, wn as AvatarInput, wt as Richlink, x as FusorReply, xn as AgentSender, xt as typing, y as FusorMessagesCtx, yt as unsend, z as PlatformSpace } from "./attachment-BGIJLBk4.js";
+import { $ as FusorTokenData, A as isFusorEvent, An as AppLayout, At as Rename, B as PlatformUser, C as FusorVerify, Cn as Avatar, Ct as text, D as WebhookRawResult, Dt as resolveContents, E as WebhookRawRequest, Et as richlink, F as PlatformInstance, Ft as Poll, G as Broadcaster, Gt as markdown, Ht as poll, I as PlatformMessage, It as PollChoice, J as mergeStreams, Jt as StreamTextSource, K as ManagedStream, Kt as DeltaExtractor, L as PlatformProviderConfig, Lt as PollChoiceInput, M as EventProducer, Mn as app, Mt as Read, N as Platform, Nn as appLayoutSchema, O as FusorEvent, Ot as Reply, P as PlatformDef, Pt as read, Q as DedicatedTokenData, Qt as group, R as PlatformRuntime, Rt as PollOption, S as FusorRespond, Sn as User, T as WebhookHandler, Tn as avatar, U as SchemaMessage, Ut as Markdown, V as ProviderMessage, Vt as option, W as SpaceNamespace, X as Store, Xt as Group, Y as stream, Yt as TextStreamOptions, Z as CloudPlatform, _ as FusorClient, _n as ContactOrg, _t as voice, a as Content, an as ReactionBuilder, at as SharedTokenData, b as FusorMessagesReturn, bn as contact, bt as Typing, c as fromVCard, ct as SpectrumCloudError, d as UnsupportedKind, dn as Contact, dt as TokenData, en as Edit, et as ImessageInfoData, f as Spectrum, fn as ContactAddress, ft as cloud, g as isFusorClient, gn as ContactName, h as fusor, hn as ContactInput, ht as Voice, i as attachment, in as Reaction, it as ProjectProfile, j as AnyPlatformDef, jn as AppUrl, jt as rename, k as fusorEvent, kn as App, kt as reply, l as toVCard, lt as SubscriptionData, m as definePlatform, mn as ContactEmail, mt as EmojiKey, n as AttachmentInput, nn as Message, nt as PlatformsData, o as ContentBuilder, ot as SlackTeamMeta, p as SpectrumInstance, pn as ContactDetails, pt as Emoji, q as broadcast, qt as StreamText, rn as Space, rt as ProjectData, s as ContentInput, sn as reaction, st as SlackTokenData, t as Attachment, tn as edit, tt as PlatformStatus, u as UnsupportedError, un as custom, ut as SubscriptionStatus, v as FusorMessages, vn as ContactPhone, vt as Unsend, w as FusorVerifyRequest, wn as AvatarInput, wt as Richlink, x as FusorReply, xn as AgentSender, xt as typing, y as FusorMessagesCtx, yt as unsend, z as PlatformSpace } from "./attachment-DSVZbNyn.js";
 export { type AgentSender, type AnyPlatformDef, type App, type AppLayout, type AppUrl, type Attachment, type AttachmentInput, type Avatar, type AvatarInput, type Broadcaster, type CloudPlatform, type Contact, type ContactAddress, type ContactDetails, type ContactEmail, type ContactInput, type ContactName, type ContactOrg, type ContactPhone, type Content, type ContentBuilder, type ContentInput, type DedicatedTokenData, type DeltaExtractor, type Edit, Emoji, type EmojiKey, type EventProducer, type FusorClient, type FusorEvent, type FusorMessages, type FusorMessagesCtx, type FusorMessagesReturn, type FusorReply, type FusorRespond, type FusorTokenData, type FusorVerify, type FusorVerifyRequest, type Group, type ImessageInfoData, type ManagedStream, type Markdown, type Message, type Platform, type PlatformDef, type PlatformInstance, type PlatformMessage, type PlatformProviderConfig, type PlatformRuntime, type PlatformSpace, type PlatformStatus, type PlatformUser, type PlatformsData, type Poll, type PollChoice, type PollChoiceInput, type PollOption, type ProjectData, type ProjectProfile, type ProviderMessage, type Reaction, type ReactionBuilder, type Read, type Rename, type Reply, type Richlink, type SchemaMessage, type SharedTokenData, type SlackTeamMeta, type SlackTokenData, type Space, type SpaceNamespace, Spectrum, SpectrumCloudError, type SpectrumInstance, type Store, type StreamText, type StreamTextSource, type SubscriptionData, type SubscriptionStatus, type TextStreamOptions, type TokenData, type Typing, type Unsend, UnsupportedError, type UnsupportedKind, type User, type Voice, type WebhookHandler, type WebhookRawRequest, type WebhookRawResult, app, appLayoutSchema, attachment, avatar, broadcast, cloud, contact, custom, definePlatform, edit, fromVCard, fusor, fusorEvent, group, isFusorClient, isFusorEvent, markdown, mergeStreams, option, poll, reaction, read, rename, reply, resolveContents, richlink, stream, text, toVCard, typing, unsend, voice };

package/dist/index.js

@@ -1,8 +1,56 @@
-import { A as resolveContents, B as fromVCard, C as poll, F as drainStreamText, G as attachment, H as buildPhotoAction, I as asCustom, J as fetchLinkMetadata, L as custom, M as text, O as group, P as StreamConsumedError, R as asContact, S as option, T as markdown, U as photoActionSchema, V as toVCard, W as asAttachment, a as contentAttrs, c as markdownToPlainText, f as voice, g as read, i as stream, j as asText, m as richlink, n as createAsyncQueue, o as errorAttrs, p as asRichlink, q as fetchImage, r as mergeStreams, s as senderAttrs, t as broadcast, u as classifyIdentifier, v as reaction, w as asMarkdown, z as contact } from "./stream-BLWs7NJ5.js";
+import { A as resolveContents, B as fromVCard, C as poll, F as drainStreamText, G as attachment, H as buildPhotoAction, I as asCustom, J as tracedFetch, L as custom, M as text, O as group, P as StreamConsumedError, R as asContact, S as option, T as markdown, U as photoActionSchema, V as toVCard, W as asAttachment, a as contentAttrs, c as markdownToPlainText, f as voice, g as read, i as stream, j as asText, m as richlink, n as createAsyncQueue, o as errorAttrs, q as fetchUrlBytes, r as mergeStreams, s as senderAttrs, t as broadcast, u as classifyIdentifier, v as reaction, w as asMarkdown, z as contact } from "./stream-Cs0NMbNv.js";
 import z from "zod";
-import { createHmac, timingSafeEqual } from "node:crypto";
+import ogs from "open-graph-scraper";
 import { createLogger, setLogLevel, setupOtel, withSpan } from "@photon-ai/otel";
+import { createHmac, timingSafeEqual } from "node:crypto";
 import { RawInboundEvent } from "@photon-ai/proto/photon/fusor/v1/inbound";
+//#region src/utils/link-metadata.ts
+const DEFAULT_TIMEOUT_MS = 5e3;
+const USER_AGENT = "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_0) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.0 Safari/605.1.15 spectrum-ts/richlink";
+const normaliseImageUrl = (raw, base) => {
+	try {
+		return new URL(raw, base).toString();
+	} catch {
+		return;
+	}
+};
+const cleanString = (v) => {
+	if (typeof v !== "string") return;
+	const trimmed = v.trim();
+	return trimmed.length > 0 ? trimmed : void 0;
+};
+const fetchLinkMetadata = async (url) => {
+	try {
+		const result = await ogs({
+			url,
+			timeout: DEFAULT_TIMEOUT_MS,
+			fetchOptions: { headers: { "User-Agent": USER_AGENT } }
+		});
+		if (result.error) return {};
+		const { ogTitle, ogDescription, ogImage, ogSiteName, twitterTitle, twitterDescription, twitterImage } = result.result;
+		const title = cleanString(ogTitle) ?? cleanString(twitterTitle);
+		const summary = cleanString(ogDescription) ?? cleanString(twitterDescription);
+		const siteName = cleanString(ogSiteName);
+		const imageCandidate = ogImage?.[0] ?? twitterImage?.[0];
+		const resolved = imageCandidate ? normaliseImageUrl(imageCandidate.url, url) : void 0;
+		return {
+			title,
+			summary,
+			siteName,
+			image: imageCandidate && resolved ? {
+				url: resolved,
+				mimeType: "type" in imageCandidate && typeof imageCandidate.type === "string" ? imageCandidate.type : void 0
+			} : void 0
+		};
+	} catch {
+		return {};
+	}
+};
+const fetchImage = (url) => fetchUrlBytes(new URL(url), {
+	timeoutMs: DEFAULT_TIMEOUT_MS,
+	headers: { "User-Agent": USER_AGENT }
+});
+//#endregion
 //#region src/content/app.ts
 /**
 * Visible layout of an app card. Mirrors Apple's `MSMessageTemplateLayout`
@@ -2994,7 +3042,7 @@ function definePlatform(name, rawDef) {
 }
 //#endregion
 //#region src/build-env.ts
-const SPECTRUM_SDK_VERSION = "7.0.0";
+const SPECTRUM_SDK_VERSION = "8.1.0";
 //#endregion
 //#region src/utils/provider-packages.ts
 const OFFICIAL_PROVIDER_PACKAGES = {
@@ -3031,8 +3079,9 @@ var SpectrumCloudError = class extends Error {
 		this.code = code;
 	}
 };
+const cloudFetch = tracedFetch("spectrum-cloud");
 const request = async (path, init) => {
-	const response = await fetch(`${SPECTRUM_CLOUD_URL}${path}`, init);
+	const response = await cloudFetch(`${SPECTRUM_CLOUD_URL}${path}`, init);
 	if (!response.ok) {
 		const body = await response.text().catch(() => "");
 		try {
@@ -3744,7 +3793,10 @@ const mapContent = (content, platform, spaceRef, ctx) => {
 			type: "text",
 			text: asString(raw.text)
 		};
-		case "richlink": return asRichlink({ url: asString(raw.url) });
+		case "richlink": return {
+			type: "text",
+			text: asString(raw.url)
+		};
 		case "contact": return deserializeContact(raw);
 		case "reaction": return deserializeReaction(raw, spaceRef);
 		case "group": return deserializeGroup(raw, platform, spaceRef, ctx);
@@ -3984,7 +4036,9 @@ function bootstrapTelemetry(opts) {
 		serviceVersion: SPECTRUM_SDK_VERSION,
 		endpoint: PHOTON_OTEL_ENDPOINT,
 		headers,
-		resourceAttributes
+		resourceAttributes,
+		instrumentFetch: false,
+		register: false
 	});
 }
 function applyLogLevel(level) {

package/dist/{stream-BLWs7NJ5.js → stream-Cs0NMbNv.js}

@@ -1,5 +1,5 @@
 import z from "zod";
-import ogs from "open-graph-scraper";
+import { createInstrumentedFetch, sanitizeEmail, sanitizeErrorMessage, sanitizePhone, sanitizeUrl } from "@photon-ai/otel";
 import { randomUUID } from "node:crypto";
 import { createReadStream } from "node:fs";
 import { readFile, stat } from "node:fs/promises";
@@ -7,9 +7,31 @@ import { basename } from "node:path";
 import { Readable } from "node:stream";
 import { lookup } from "mime-types";
 import vCard from "vcf";
-import { sanitizeEmail, sanitizeErrorMessage, sanitizePhone } from "@photon-ai/otel";
 import { Marked } from "marked";
 import { Repeater } from "@repeaterjs/repeater";
+//#region src/utils/instrumented-fetch.ts
+/**
+* Build a fetch that traces spectrum's OWN outbound HTTP: each request through
+* the returned fetch emits a CLIENT span (tagged with `peer.service`) and
+* carries W3C trace context downstream. It never mutates `globalThis.fetch`, so
+* a consumer's unrelated requests stay untouched.
+*
+* The base delegates to `globalThis.fetch` at call time — deliberately NOT
+* `createInstrumentedFetch(globalThis.fetch, …)`, which would capture the
+* original and bypass a test's `spyOn(globalThis, "fetch")`. When telemetry is
+* off (no `setupOtel`), the tracer is a no-op and this is a transparent
+* pass-through. Create one per module: `const tf = tracedFetch("…")`.
+*
+* Pass `redactUrl` to strip secrets from a request URL before it is recorded as
+* the span's `url.full` (e.g. a token in the path or query); the real request
+* still uses the original URL. Pair with `sanitizeUrl` for semconv-style query
+* redaction.
+*/
+const tracedFetch = (peerService, options) => createInstrumentedFetch(((input, init) => globalThis.fetch(input, init)), {
+	attributes: { "peer.service": peerService },
+	...options
+});
+//#endregion
 //#region src/utils/io.ts
 const readSchema$1 = z.function({
 	input: [],
@@ -24,6 +46,7 @@ const bufferToStream = (buf) => new ReadableStream({ start(controller) {
 	controller.close();
 } });
 const DEFAULT_FETCH_TIMEOUT_MS = 1e4;
+const mediaFetch = tracedFetch("media", { redactUrl: sanitizeUrl });
 /**
 * Fetch URL bytes into memory — never touches the filesystem, so callers
 * remain safe in read-only environments. Returns the response's Content-Type
@@ -33,7 +56,7 @@ const 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, {
+		const res = await mediaFetch(url, {
 			signal: controller.signal,
 			headers: options?.headers
 		});
@@ -47,53 +70,6 @@ const fetchUrlBytes = async (url, options) => {
 	}
 };
 //#endregion
-//#region src/utils/link-metadata.ts
-const DEFAULT_TIMEOUT_MS = 5e3;
-const USER_AGENT = "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_0) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.0 Safari/605.1.15 spectrum-ts/richlink";
-const normaliseImageUrl = (raw, base) => {
-	try {
-		return new URL(raw, base).toString();
-	} catch {
-		return;
-	}
-};
-const cleanString = (v) => {
-	if (typeof v !== "string") return;
-	const trimmed = v.trim();
-	return trimmed.length > 0 ? trimmed : void 0;
-};
-const fetchLinkMetadata = async (url) => {
-	try {
-		const result = await ogs({
-			url,
-			timeout: DEFAULT_TIMEOUT_MS,
-			fetchOptions: { headers: { "User-Agent": USER_AGENT } }
-		});
-		if (result.error) return {};
-		const { ogTitle, ogDescription, ogImage, ogSiteName, twitterTitle, twitterDescription, twitterImage } = result.result;
-		const title = cleanString(ogTitle) ?? cleanString(twitterTitle);
-		const summary = cleanString(ogDescription) ?? cleanString(twitterDescription);
-		const siteName = cleanString(ogSiteName);
-		const imageCandidate = ogImage?.[0] ?? twitterImage?.[0];
-		const resolved = imageCandidate ? normaliseImageUrl(imageCandidate.url, url) : void 0;
-		return {
-			title,
-			summary,
-			siteName,
-			image: imageCandidate && resolved ? {
-				url: resolved,
-				mimeType: "type" in imageCandidate && typeof imageCandidate.type === "string" ? imageCandidate.type : void 0
-			} : void 0
-		};
-	} catch {
-		return {};
-	}
-};
-const fetchImage = (url) => fetchUrlBytes(new URL(url), {
-	timeoutMs: DEFAULT_TIMEOUT_MS,
-	headers: { "User-Agent": USER_AGENT }
-});
-//#endregion
 //#region src/content/attachment.ts
 const DEFAULT_ATTACHMENT_NAME = "attachment";
 const attachmentSchema = z.object({
@@ -916,67 +892,24 @@ function read(target) {
 }
 //#endregion
 //#region src/content/richlink.ts
-const richlinkCoverSchema = z.object({
-	mimeType: z.string().min(1).optional(),
-	read: readSchema$1,
-	stream: streamSchema
-});
-const optionalStringAccessor = z.function({
-	input: [],
-	output: z.promise(z.string().min(1).optional())
-});
-const coverAccessor = z.function({
-	input: [],
-	output: z.promise(richlinkCoverSchema.optional())
-});
-const richlinkSchema = z.object({
-	type: z.literal("richlink"),
-	url: z.url(),
-	title: optionalStringAccessor,
-	summary: optionalStringAccessor,
-	cover: coverAccessor
-});
-const memoize = (factory) => {
-	let cached;
-	return () => {
-		cached ??= factory();
-		return cached;
-	};
-};
-const buildCover = (image) => {
-	const read = memoize(() => fetchImage(image.url).then((r) => r.data).catch(() => Buffer.alloc(0)));
-	return {
-		mimeType: image.mimeType,
-		read,
-		stream: async () => bufferToStream(await read())
-	};
-};
 /**
-* Construct a `richlink` content value.
+* A URL the platform should render as a rich link preview.
 *
-* Accessors (`title`, `summary`, `cover`) are async and lazy: the first call
-* issues a single network request to the URL; subsequent calls share the
-* cached result. Network / parse failures resolve to `undefined` and are
-* cached — no retries. Callers who only need `title` / `summary` never
-* trigger an image download; calling `cover.read()` triggers one additional
-* request to fetch the image bytes.
+* Outbound-only by design: inbound messages always surface as `text` content —
+* a URL received from a platform arrives as plain text, never as `richlink`, so
+* no metadata is fetched on the inbound path. On outbound, each platform asks
+* its native client to render the preview (remote iMessage: `enableLinkPreview`;
+* Telegram: auto-unfurls the bare URL), so the framework carries only the URL
+* and fetches nothing itself.
 */
-const asRichlink = (input) => {
-	const getMetadata = memoize(() => fetchLinkMetadata(input.url));
-	const getCover = memoize(async () => {
-		const { image } = await getMetadata();
-		return image ? buildCover(image) : void 0;
-	});
-	const title = async () => (await getMetadata()).title;
-	const summary = async () => (await getMetadata()).summary;
-	return richlinkSchema.parse({
-		type: "richlink",
-		url: input.url,
-		title,
-		summary,
-		cover: getCover
-	});
-};
+const richlinkSchema = z.object({
+	type: z.literal("richlink"),
+	url: z.url()
+});
+const asRichlink = (input) => richlinkSchema.parse({
+	type: "richlink",
+	url: input.url
+});
 function richlink(url) {
 	return { build: async () => asRichlink({ url }) };
 }
@@ -1486,4 +1419,4 @@ function broadcast(source) {
 	};
 }
 //#endregion
-export { resolveContents as A, fromVCard as B, poll as C, asGroup as D, markdownSchema as E, drainStreamText as F, attachment as G, buildPhotoAction as H, asCustom as I, fetchLinkMetadata as J, attachmentSchema as K, custom as L, text as M, textSchema as N, group as O, StreamConsumedError as P, asContact as R, option as S, markdown as T, photoActionSchema as U, toVCard as V, asAttachment as W, asReaction as _, contentAttrs as a, asPoll as b, markdownToPlainText as c, asVoice as d, voice as f, read as g, asRead as h, stream as i, asText as j, groupSchema as k, renderInlineTokens as l, richlink as m, createAsyncQueue as n, errorAttrs as o, asRichlink as p, fetchImage as q, mergeStreams as r, senderAttrs as s, broadcast as t, classifyIdentifier as u, reaction as v, asMarkdown as w, asPollOption as x, reactionSchema as y, contact as z };
+export { resolveContents as A, fromVCard as B, poll as C, asGroup as D, markdownSchema as E, drainStreamText as F, attachment as G, buildPhotoAction as H, asCustom as I, tracedFetch as J, attachmentSchema as K, custom as L, text as M, textSchema as N, group as O, StreamConsumedError as P, asContact as R, option as S, markdown as T, photoActionSchema as U, toVCard as V, asAttachment as W, asReaction as _, contentAttrs as a, asPoll as b, markdownToPlainText as c, asVoice as d, voice as f, read as g, asRead as h, stream as i, asText as j, groupSchema as k, renderInlineTokens as l, richlink as m, createAsyncQueue as n, errorAttrs as o, asRichlink as p, fetchUrlBytes as q, mergeStreams as r, senderAttrs as s, broadcast as t, classifyIdentifier as u, reaction as v, asMarkdown as w, asPollOption as x, reactionSchema as y, contact as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spectrum-ts/core",
-  "version": "7.0.0",
+  "version": "8.1.0",
   "description": "The spectrum-ts runtime — Spectrum, content builders, fusor, and the provider authoring API.",
   "repository": {
     "type": "git",
@@ -32,7 +32,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@photon-ai/otel": "^1.0.0",
+    "@photon-ai/otel": "^3.1.0",
     "@photon-ai/proto": "^0.2.4",
     "@repeaterjs/repeater": "^3.0.6",
     "marked": "^18.0.5",