@spectrum-ts/core 8.0.0 → 8.1.0

package/dist/{attachment-ByH1Espb.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,6 +447,14 @@ interface Message<TPlatform extends string = string, TSender extends User = User
 declare const editSchema: z.ZodObject<{
   type: z.ZodLiteral<"edit">;
   content: z.ZodCustom<{
+    type: "attachment";
+    id: string;
+    name: string;
+    mimeType: string;
+    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: "contact";
     user?: {
       __platform: string;
@@ -489,17 +497,6 @@ declare const editSchema: z.ZodObject<{
       read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
     } | undefined;
     raw?: unknown;
-  } | {
-    type: "attachment";
-    id: string;
-    name: string;
-    mimeType: string;
-    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: "group";
-    items: Message<string, User, Space<unknown>>[];
   } | {
     type: "custom";
     raw: unknown;
@@ -510,9 +507,8 @@ declare const editSchema: z.ZodObject<{
     type: "markdown";
     markdown: string;
   } | {
-    type: "reaction";
-    emoji: string;
-    target: Message<string, User, Space<unknown>>;
+    type: "group";
+    items: Message<string, User, Space<unknown>>[];
   } | {
     type: "poll";
     title: string;
@@ -533,6 +529,10 @@ declare const editSchema: z.ZodObject<{
     };
     selected: boolean;
     title: string;
+  } | {
+    type: "reaction";
+    emoji: string;
+    target: Message<string, User, Space<unknown>>;
   } | {
     type: "richlink";
     url: string;
@@ -595,6 +595,14 @@ declare const editSchema: z.ZodObject<{
       kind: "clear";
     };
   }, {
+    type: "attachment";
+    id: string;
+    name: string;
+    mimeType: string;
+    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: "contact";
     user?: {
       __platform: string;
@@ -637,17 +645,6 @@ declare const editSchema: z.ZodObject<{
       read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
     } | undefined;
     raw?: unknown;
-  } | {
-    type: "attachment";
-    id: string;
-    name: string;
-    mimeType: string;
-    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: "group";
-    items: Message<string, User, Space<unknown>>[];
   } | {
     type: "custom";
     raw: unknown;
@@ -658,9 +655,8 @@ declare const editSchema: z.ZodObject<{
     type: "markdown";
     markdown: string;
   } | {
-    type: "reaction";
-    emoji: string;
-    target: Message<string, User, Space<unknown>>;
+    type: "group";
+    items: Message<string, User, Space<unknown>>[];
   } | {
     type: "poll";
     title: string;
@@ -681,6 +677,10 @@ declare const editSchema: z.ZodObject<{
     };
     selected: boolean;
     title: string;
+  } | {
+    type: "reaction";
+    emoji: string;
+    target: Message<string, User, Space<unknown>>;
   } | {
     type: "richlink";
     url: string;
@@ -968,6 +968,14 @@ declare function rename(displayName: string): ContentBuilder;
 declare const replySchema: z.ZodObject<{
   type: z.ZodLiteral<"reply">;
   content: z.ZodCustom<{
+    type: "attachment";
+    id: string;
+    name: string;
+    mimeType: string;
+    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: "contact";
     user?: {
       __platform: string;
@@ -1010,17 +1018,6 @@ declare const replySchema: z.ZodObject<{
       read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
     } | undefined;
     raw?: unknown;
-  } | {
-    type: "attachment";
-    id: string;
-    name: string;
-    mimeType: string;
-    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: "group";
-    items: Message<string, User, Space<unknown>>[];
   } | {
     type: "custom";
     raw: unknown;
@@ -1031,9 +1028,8 @@ declare const replySchema: z.ZodObject<{
     type: "markdown";
     markdown: string;
   } | {
-    type: "reaction";
-    emoji: string;
-    target: Message<string, User, Space<unknown>>;
+    type: "group";
+    items: Message<string, User, Space<unknown>>[];
   } | {
     type: "poll";
     title: string;
@@ -1054,6 +1050,10 @@ declare const replySchema: z.ZodObject<{
     };
     selected: boolean;
     title: string;
+  } | {
+    type: "reaction";
+    emoji: string;
+    target: Message<string, User, Space<unknown>>;
   } | {
     type: "richlink";
     url: string;
@@ -1116,6 +1116,14 @@ declare const replySchema: z.ZodObject<{
       kind: "clear";
     };
   }, {
+    type: "attachment";
+    id: string;
+    name: string;
+    mimeType: string;
+    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: "contact";
     user?: {
       __platform: string;
@@ -1158,17 +1166,6 @@ declare const replySchema: z.ZodObject<{
       read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
     } | undefined;
     raw?: unknown;
-  } | {
-    type: "attachment";
-    id: string;
-    name: string;
-    mimeType: string;
-    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: "group";
-    items: Message<string, User, Space<unknown>>[];
   } | {
     type: "custom";
     raw: unknown;
@@ -1179,9 +1176,8 @@ declare const replySchema: z.ZodObject<{
     type: "markdown";
     markdown: string;
   } | {
-    type: "reaction";
-    emoji: string;
-    target: Message<string, User, Space<unknown>>;
+    type: "group";
+    items: Message<string, User, Space<unknown>>[];
   } | {
     type: "poll";
     title: string;
@@ -1202,6 +1198,10 @@ declare const replySchema: z.ZodObject<{
     };
     selected: boolean;
     title: string;
+  } | {
+    type: "reaction";
+    emoji: string;
+    target: Message<string, User, Space<unknown>>;
   } | {
     type: "richlink";
     url: string;
@@ -6851,6 +6851,14 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strip>, z.ZodObject<{
   type: z.ZodLiteral<"reply">;
   content: z.ZodCustom<{
+    type: "attachment";
+    id: string;
+    name: string;
+    mimeType: string;
+    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: "contact";
     user?: {
       __platform: string;
@@ -6893,17 +6901,6 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
     } | undefined;
     raw?: unknown;
-  } | {
-    type: "attachment";
-    id: string;
-    name: string;
-    mimeType: string;
-    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: "group";
-    items: Message<string, User, Space<unknown>>[];
   } | {
     type: "custom";
     raw: unknown;
@@ -6914,9 +6911,8 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: "markdown";
     markdown: string;
   } | {
-    type: "reaction";
-    emoji: string;
-    target: Message<string, User, Space<unknown>>;
+    type: "group";
+    items: Message<string, User, Space<unknown>>[];
   } | {
     type: "poll";
     title: string;
@@ -6937,6 +6933,10 @@ 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;
@@ -6999,6 +6999,14 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       kind: "clear";
     };
   }, {
+    type: "attachment";
+    id: string;
+    name: string;
+    mimeType: string;
+    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: "contact";
     user?: {
       __platform: string;
@@ -7041,17 +7049,6 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
     } | undefined;
     raw?: unknown;
-  } | {
-    type: "attachment";
-    id: string;
-    name: string;
-    mimeType: string;
-    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: "group";
-    items: Message<string, User, Space<unknown>>[];
   } | {
     type: "custom";
     raw: unknown;
@@ -7062,9 +7059,8 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: "markdown";
     markdown: string;
   } | {
-    type: "reaction";
-    emoji: string;
-    target: Message<string, User, Space<unknown>>;
+    type: "group";
+    items: Message<string, User, Space<unknown>>[];
   } | {
     type: "poll";
     title: string;
@@ -7085,6 +7081,10 @@ 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;
@@ -7151,6 +7151,14 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strip>, z.ZodObject<{
   type: z.ZodLiteral<"edit">;
   content: z.ZodCustom<{
+    type: "attachment";
+    id: string;
+    name: string;
+    mimeType: string;
+    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: "contact";
     user?: {
       __platform: string;
@@ -7193,17 +7201,6 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
     } | undefined;
     raw?: unknown;
-  } | {
-    type: "attachment";
-    id: string;
-    name: string;
-    mimeType: string;
-    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: "group";
-    items: Message<string, User, Space<unknown>>[];
   } | {
     type: "custom";
     raw: unknown;
@@ -7214,9 +7211,8 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: "markdown";
     markdown: string;
   } | {
-    type: "reaction";
-    emoji: string;
-    target: Message<string, User, Space<unknown>>;
+    type: "group";
+    items: Message<string, User, Space<unknown>>[];
   } | {
     type: "poll";
     title: string;
@@ -7237,6 +7233,10 @@ 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;
@@ -7299,6 +7299,14 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       kind: "clear";
     };
   }, {
+    type: "attachment";
+    id: string;
+    name: string;
+    mimeType: string;
+    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: "contact";
     user?: {
       __platform: string;
@@ -7341,17 +7349,6 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
     } | undefined;
     raw?: unknown;
-  } | {
-    type: "attachment";
-    id: string;
-    name: string;
-    mimeType: string;
-    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: "group";
-    items: Message<string, User, Space<unknown>>[];
   } | {
     type: "custom";
     raw: unknown;
@@ -7362,9 +7359,8 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: "markdown";
     markdown: string;
   } | {
-    type: "reaction";
-    emoji: string;
-    target: Message<string, User, Space<unknown>>;
+    type: "group";
+    items: Message<string, User, Space<unknown>>[];
   } | {
     type: "poll";
     title: string;
@@ -7385,6 +7381,10 @@ 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;

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-ByH1Espb.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-Cz0pdWd1.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-ByH1Espb.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,8 @@
-import { A as resolveContents, B as fromVCard, C as poll, F as drainStreamText, G as attachment, H as buildPhotoAction, I as asCustom, 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-Cz0pdWd1.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 ogs from "open-graph-scraper";
-import { createHmac, timingSafeEqual } from "node:crypto";
 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;
@@ -3042,7 +3042,7 @@ function definePlatform(name, rawDef) {
 }
 //#endregion
 //#region src/build-env.ts
-const SPECTRUM_SDK_VERSION = "8.0.0";
+const SPECTRUM_SDK_VERSION = "8.1.0";
 //#endregion
 //#region src/utils/provider-packages.ts
 const OFFICIAL_PROVIDER_PACKAGES = {
@@ -3079,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 {
@@ -4035,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-Cz0pdWd1.js → stream-Cs0NMbNv.js}

@@ -1,4 +1,5 @@
 import z from "zod";
+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";
@@ -6,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: [],
@@ -23,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
@@ -32,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
 		});
@@ -1395,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, 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 };
+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": "8.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",