@sentry/junior 0.124.2 → 0.126.0

package/dist/chat/source.d.ts

@@ -0,0 +1,16 @@
+import { type Source } from "@sentry/junior-plugin-api";
+/** Source coordinates reduced to the stable locator for one conversation. */
+export type SessionSource = Extract<Source, {
+    platform: "local";
+}> | (Omit<Extract<Source, {
+    platform: "slack";
+}>, "messageTs" | "threadTs"> & {
+    threadTs: string;
+});
+/**
+ * Normalize a turn Source into the session-stable locator persisted on a
+ * conversation. Drops per-message timestamps; requires a Slack thread anchor.
+ */
+export declare function normalizeSessionSource(value: Source | undefined): SessionSource | undefined;
+/** Parse a serialized Source into the stable locator stored on a conversation. */
+export declare function parseSessionSource(value: unknown): SessionSource | undefined;

package/dist/chat/state/turn-session.d.ts

@@ -75,7 +75,7 @@ export declare function upsertAgentTurnSessionRecord(args: {
     dispatchId?: string;
     dispatchOutcome?: AgentDispatchOutcome;
     resultMessageId?: string;
-    /** Source-confirmed destination visibility from the current event's signal. */
+    /** Confirmed destination visibility; omit when unavailable. */
     destinationVisibility?: ConversationPrivacy;
     source?: Source;
     lastProgressAtMs?: number;
@@ -110,11 +110,7 @@ export declare function recordAgentTurnSessionSummary(args: {
     dispatchId?: string;
     dispatchOutcome?: AgentDispatchOutcome;
     resultMessageId?: string;
-    /**
-     * Source-confirmed destination visibility from the current event's signal
-     * (Slack `channel_type`). Leave unset when no live signal exists so an
-     * existing destination visibility is not overwritten.
-     */
+    /** Confirmed destination visibility; omit when unavailable. */
     destinationVisibility?: ConversationPrivacy;
     source?: Source;
     lastProgressAtMs?: number;

package/dist/{chunk-L7EZRQ2J.js → chunk-4PV73JHH.js}

@@ -6,36 +6,34 @@ import {
   isDmChannel,
   normalizeSlackConversationId,
   withSlackRetries
-} from "./chunk-IXTIJQ7Z.js";
+} from "./chunk-6KWO5DU3.js";
 import {
   getDb,
   parseDestination
-} from "./chunk-DW6SLS5F.js";
+} from "./chunk-KP7E267S.js";
 import {
   acquireActiveLock,
   getStateAdapter,
   sleep
-} from "./chunk-KYKLQYSU.js";
+} from "./chunk-APYVVX2Y.js";
 import {
   normalizeSlackEmojiName
-} from "./chunk-574YK7QW.js";
+} from "./chunk-XLIAQRDI.js";
 import {
   pluginCatalogRuntime
-} from "./chunk-ZO6E537B.js";
+} from "./chunk-GHNO2WUH.js";
 import {
   fetchWithBoundedOAuthErrorBodies
-} from "./chunk-EOSC6JOC.js";
-import {
-  logInfo,
-  logWarn
-} from "./chunk-ASK74NM6.js";
-import {
-  isRecord
-} from "./chunk-OB42YVAE.js";
+} from "./chunk-EFQX6XBW.js";
 import {
   parseSlackMessageTs,
   parseSlackUserId
 } from "./chunk-F3B2YJ76.js";
+import {
+  isRecord,
+  logInfo,
+  logWarn
+} from "./chunk-JP2ZOSQK.js";
 
 // src/chat/capabilities/router.ts
 var ProviderCredentialRouter = class {

package/dist/{chunk-IXTIJQ7Z.js → chunk-6KWO5DU3.js}

@@ -1,27 +1,34 @@
 import {
+  getConversationEventStore,
   getDb
-} from "./chunk-DW6SLS5F.js";
+} from "./chunk-KP7E267S.js";
 import {
   juniorConversationAnnotations,
+  juniorConversationEvents,
   juniorIdentities,
   juniorUsers
-} from "./chunk-GCGJGSQL.js";
+} from "./chunk-S4PUICSB.js";
 import {
   SANDBOX_WORKSPACE_ROOT,
   getStateAdapter,
   sleep
-} from "./chunk-KYKLQYSU.js";
+} from "./chunk-APYVVX2Y.js";
 import {
   botConfig,
   completeObject,
   embedTexts,
   getSlackBotToken,
   standardModelId
-} from "./chunk-574YK7QW.js";
+} from "./chunk-XLIAQRDI.js";
 import {
   isActorUserId,
   parseActorUserId
 } from "./chunk-HZF5P5UN.js";
+import {
+  parseSlackChannelReferenceId,
+  parseSlackMessageTs,
+  parseSlackTeamId
+} from "./chunk-F3B2YJ76.js";
 import {
   logException,
   logInfo,
@@ -30,12 +37,7 @@ import {
   setSpanAttributes,
   setSpanStatus,
   withSpan
-} from "./chunk-ASK74NM6.js";
-import {
-  parseSlackChannelReferenceId,
-  parseSlackMessageTs,
-  parseSlackTeamId
-} from "./chunk-F3B2YJ76.js";
+} from "./chunk-JP2ZOSQK.js";
 
 // src/chat/plugins/agent-hooks.ts
 import {
@@ -106,6 +108,133 @@ async function listConversationAnnotations(db, conversationId) {
   });
 }
 
+// src/chat/plugins/conversation-events.ts
+function registeredDefinition(plugin, value) {
+  return plugin.conversationEvents?.find(
+    (definition) => definition === value.definition
+  );
+}
+function eventIdentityVersion(plugin, definition) {
+  let version = definition.version;
+  for (const candidate of plugin.conversationEvents ?? []) {
+    if (candidate.eventName === definition.eventName) {
+      version = Math.min(version, candidate.version);
+    }
+  }
+  return version;
+}
+function createPluginConversationEvents(args) {
+  return {
+    async emit(value) {
+      const definition = registeredDefinition(args.plugin, value);
+      if (!definition) {
+        throw new Error(
+          `Plugin "${args.plugin.manifest.name}" cannot emit an unregistered conversation event.`
+        );
+      }
+      const content = definition.parse(value.data);
+      const identityVersion = eventIdentityVersion(args.plugin, definition);
+      await getConversationEventStore().append(
+        args.conversationId,
+        [
+          {
+            createdAtMs: Date.now(),
+            idempotencyKey: `plugin:${args.plugin.manifest.name}:operation:${args.operationId}:event:${definition.eventName}@${identityVersion}`,
+            data: {
+              type: "structured_event",
+              namespace: args.plugin.manifest.name,
+              name: definition.eventName,
+              version: definition.version,
+              turnId: args.turnId,
+              content
+            }
+          }
+        ],
+        { activity: "preserve" }
+      );
+    }
+  };
+}
+function renderPluginConversationEvent(args) {
+  const plugin = getPlugins().find(
+    (candidate) => candidate.manifest.name === args.namespace
+  );
+  const definition = plugin?.conversationEvents?.find(
+    (candidate) => candidate.eventName === args.name && candidate.version === args.version
+  );
+  if (!definition) return void 0;
+  return definition.renderEvent(definition.parse(args.content));
+}
+
+// src/chat/plugins/conversation-event-stats.ts
+import { and as and2, eq as eq2, gte, lt, sql } from "drizzle-orm";
+import { z } from "zod";
+var DAY_MS = 24 * 60 * 60 * 1e3;
+var costRowSchema = z.object({
+  costUsd: z.number().finite().nonnegative(),
+  date: z.string().date(),
+  events: z.number().int().nonnegative()
+}).strict();
+function startOfUtcDay(value) {
+  const date = new Date(value);
+  date.setUTCHours(0, 0, 0, 0);
+  return date;
+}
+function registeredEventName(plugin, eventName) {
+  if (!plugin.conversationEvents?.some(
+    (definition) => definition.eventName === eventName
+  )) {
+    throw new TypeError(
+      `Plugin "${plugin.manifest.name}" did not register event "${eventName}"`
+    );
+  }
+  return eventName;
+}
+function createPluginConversationEventStats(plugin, now = Date.now) {
+  return {
+    async costsByDay(input) {
+      const eventName = registeredEventName(plugin, input.eventName);
+      const end = startOfUtcDay(now());
+      const start = new Date(end.getTime() - (input.days - 1) * DAY_MS);
+      const endExclusive = new Date(end.getTime() + DAY_MS);
+      const date = sql`TO_CHAR(
+        ${juniorConversationEvents.createdAt} AT TIME ZONE 'UTC',
+        'YYYY-MM-DD'
+      )`;
+      const cost = sql`CASE
+        WHEN jsonb_typeof(${juniorConversationEvents.payload}->'content'->'costUsd') = 'number'
+          THEN (${juniorConversationEvents.payload}->'content'->>'costUsd')::double precision
+        ELSE 0
+      END`;
+      const rows = await getDb().select({
+        costUsd: sql`SUM(${cost})::double precision`.mapWith(Number),
+        date,
+        events: sql`COUNT(*)::integer`.mapWith(Number)
+      }).from(juniorConversationEvents).where(
+        and2(
+          eq2(juniorConversationEvents.type, "structured_event"),
+          sql`${juniorConversationEvents.payload}->>'namespace' = ${plugin.manifest.name}`,
+          sql`${juniorConversationEvents.payload}->>'name' = ${eventName}`,
+          gte(juniorConversationEvents.createdAt, start),
+          lt(juniorConversationEvents.createdAt, endExclusive)
+        )
+      ).groupBy(date);
+      const byDate = new Map(
+        z.array(costRowSchema).parse(rows).map((row) => [row.date, row])
+      );
+      return Array.from({ length: input.days }, (_, index) => {
+        const day = new Date(start.getTime() + index * DAY_MS);
+        const date2 = day.toISOString().slice(0, 10);
+        return byDate.get(date2) ?? {
+          costUsd: 0,
+          date: date2,
+          events: 0
+        };
+      });
+    }
+  };
+}
+
 // src/chat/plugins/logging.ts
 function createPluginLogger(plugin) {
   return {
@@ -149,7 +278,10 @@ function createPluginModel(pluginName, options = {}, runtime = {}) {
           pluginModelRole: "structured"
         }
       });
-      return { object: result.object };
+      return {
+        object: result.object,
+        ...result.costUsd !== void 0 ? { costUsd: result.costUsd } : {}
+      };
     }
   };
 }
@@ -321,7 +453,7 @@ function getSlackToolContext(context) {
 }
 
 // src/chat/plugins/viewer-actors.ts
-import { and as and2, eq as eq2 } from "drizzle-orm";
+import { and as and3, eq as eq3 } from "drizzle-orm";
 import {
   actorSchema
 } from "@sentry/junior-plugin-api";
@@ -335,10 +467,10 @@ async function readViewerActorsFromSql(db, email) {
     provider: juniorIdentities.provider,
     providerSubjectId: juniorIdentities.providerSubjectId,
     providerTenantId: juniorIdentities.providerTenantId
-  }).from(juniorIdentities).innerJoin(juniorUsers, eq2(juniorUsers.id, juniorIdentities.userId)).where(
-    and2(
-      eq2(juniorUsers.primaryEmailNormalized, normalizedEmail),
-      eq2(juniorIdentities.kind, "user")
+  }).from(juniorIdentities).innerJoin(juniorUsers, eq3(juniorUsers.id, juniorIdentities.userId)).where(
+    and3(
+      eq3(juniorUsers.primaryEmailNormalized, normalizedEmail),
+      eq3(juniorIdentities.kind, "user")
     )
   );
   const actors = [];
@@ -919,7 +1051,7 @@ function resolveChannelCapabilities(channelId) {
 }
 
 // src/chat/plugins/agent-hooks.ts
-import { z } from "zod";
+import { z as z2 } from "zod";
 var PluginHookDeniedError = class extends Error {
   constructor(message) {
     super(message);
@@ -951,7 +1083,7 @@ var PLUGIN_ROUTE_METHODS = /* @__PURE__ */ new Set([
 var PLUGIN_PROMPT_CONTRIBUTION_TOTAL_MAX_CHARS = 16e3;
 var PLUGIN_PROMPT_CONTEXT_MAX_BYTES = 8e3;
 var PLUGIN_PROMPT_CONTEXT_TOTAL_MAX_BYTES = 16e3;
-var systemPromptMessageArraySchema = z.array(promptMessageSchema);
+var systemPromptMessageArraySchema = z2.array(promptMessageSchema);
 function isRecord(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
@@ -973,12 +1105,20 @@ function systemPromptPluginContext(plugin) {
     ...basePluginContext(plugin)
   };
 }
-function invocationPluginContext(plugin, context) {
+function invocationPluginContext(plugin, context, turnId) {
   const base = basePluginContext(plugin);
   const common = {
     ...base,
     conversationId: context.conversationId,
     embedder: createPluginEmbedder(plugin.manifest.name),
+    ...context.conversationId && turnId ? {
+      events: createPluginConversationEvents({
+        conversationId: context.conversationId,
+        operationId: `user-prompt:${turnId}`,
+        plugin,
+        turnId
+      })
+    } : {},
     model: createPluginModel(plugin.manifest.name, plugin.model),
     source: context.source,
     text: context.userText ?? "",
@@ -1198,7 +1338,7 @@ async function getPluginUserPromptContributions(args) {
     }
     try {
       const rawResult = await hook({
-        ...invocationPluginContext(plugin, args.context)
+        ...invocationPluginContext(plugin, args.context, args.turnId)
       });
       if (rawResult === void 0) {
         continue;
@@ -1471,6 +1611,7 @@ function getPluginApiRoutes() {
     }
     const app = hook({
       ...basePluginContext(plugin),
+      eventStats: createPluginConversationEventStats(plugin),
       viewer: {
         actors: readViewerActors
       }
@@ -1647,6 +1788,9 @@ function sanitizeOperationalReport(args) {
         return void 0;
       }
       const sanitizedSeries = { key, label };
+      if (item.format === "usd") {
+        sanitizedSeries.format = "usd";
+      }
       const tone = operationalReportTone(item.tone);
       if (tone) {
         sanitizedSeries.tone = tone;
@@ -1756,6 +1900,7 @@ async function getPluginOperationalReports(nowMs) {
       const state = createPluginState(pluginName);
       const report = await hook({
         ...basePluginContext(plugin),
+        eventStats: createPluginConversationEventStats(plugin, () => nowMs),
         nowMs,
         state: pluginReadState(state)
       });
@@ -1930,6 +2075,8 @@ function createPluginHookRunner(input = {}) {
 
 export {
   listConversationAnnotations,
+  createPluginConversationEvents,
+  renderPluginConversationEvent,
   createPluginLogger,
   createPluginModel,
   createPluginEmbedder,

package/dist/{chunk-AYQZCJZJ.js → chunk-6ZBSTNYN.js}

@@ -74,10 +74,22 @@ var actorIdentitySchema = z2.object({
   slackUserId: z2.string().optional(),
   slackUserName: z2.string().optional()
 }).strict();
+var conversationAuxiliaryCostsSchema = z2.object({
+  costUsd: z2.number().finite().nonnegative(),
+  operations: z2.array(
+    z2.object({
+      costUsd: z2.number().finite().nonnegative(),
+      events: z2.number().int().positive(),
+      name: z2.string().min(1),
+      namespace: z2.string().min(1)
+    }).strict()
+  ).min(1)
+}).strict();
 var conversationSummaryReportSchema = z2.object({
   displayTitle: z2.string(),
   cumulativeDurationMs: z2.number(),
   cumulativeUsage: conversationUsageSchema.optional(),
+  auxiliaryCosts: conversationAuxiliaryCostsSchema.optional(),
   conversationId: z2.string(),
   isParticipant: z2.boolean(),
   status: conversationReportStatusSchema,
@@ -92,6 +104,7 @@ var conversationSummaryReportSchema = z2.object({
   channelNameRedacted: z2.boolean().optional(),
   locationId: z2.string().optional(),
   sentryTraceUrl: z2.string().optional(),
+  sourceUrl: z2.string().url().optional(),
   traceId: z2.string().optional()
 }).strict();
 var conversationReportMessageEventDataSchema = z2.object({
@@ -592,6 +605,7 @@ export {
   conversationFeedQuerySchema,
   archiveConversationBodySchema,
   archiveConversationResponseSchema,
+  conversationAuxiliaryCostsSchema,
   conversationSummaryReportSchema,
   conversationReportEventDataSchema,
   conversationReportEventSchema,

package/dist/chunk-72SDEHFP.js

@@ -0,0 +1,102 @@
+import {
+  parseSlackChannelId,
+  parseSlackMessageTs,
+  parseSlackTeamId
+} from "./chunk-F3B2YJ76.js";
+import {
+  toOptionalString
+} from "./chunk-JP2ZOSQK.js";
+
+// src/chat/slack/context.ts
+import { z } from "zod";
+function toTrimmedSlackString(value) {
+  const normalized = toOptionalString(value);
+  return normalized?.trim() || void 0;
+}
+var slackMessageEnvelopeSchema = z.object({
+  raw: z.unknown().optional()
+});
+var rawSlackMessageSchema = z.object({
+  channel: z.unknown().optional(),
+  message: z.unknown().optional(),
+  team: z.unknown().optional(),
+  team_id: z.unknown().optional(),
+  thread_ts: z.unknown().optional(),
+  ts: z.unknown().optional(),
+  user_team: z.unknown().optional()
+});
+var nestedRawSlackMessageSchema = z.object({
+  ts: z.unknown().optional()
+});
+function readSlackRawMessageContext(message) {
+  const envelope = slackMessageEnvelopeSchema.safeParse(message);
+  if (!envelope.success) {
+    return void 0;
+  }
+  const raw = rawSlackMessageSchema.safeParse(envelope.data.raw);
+  if (!raw.success) {
+    return void 0;
+  }
+  const nestedMessage = nestedRawSlackMessageSchema.safeParse(raw.data.message);
+  const channelId = parseSlackChannelId(raw.data.channel);
+  const threadTs = parseSlackMessageTs(raw.data.thread_ts);
+  const messageTs = parseSlackMessageTs(raw.data.ts);
+  const nestedMessageTs = nestedMessage.success && parseSlackMessageTs(nestedMessage.data.ts);
+  const teamId = parseSlackTeamId(raw.data.team_id) ?? parseSlackTeamId(raw.data.team);
+  const authorTeamId = parseSlackTeamId(raw.data.user_team);
+  return {
+    ...channelId ? { channelId } : {},
+    ...threadTs ? { threadTs } : {},
+    ...messageTs ? { messageTs } : {},
+    ...nestedMessageTs ? { nestedMessageTs } : {},
+    ...teamId ? { teamId } : {},
+    ...authorTeamId ? { authorTeamId } : {}
+  };
+}
+function parseSlackThreadId(threadId) {
+  const normalizedThreadId = toTrimmedSlackString(threadId);
+  if (!normalizedThreadId) {
+    return void 0;
+  }
+  const parts = normalizedThreadId.split(":");
+  if (parts.length !== 3 || parts[0] !== "slack") {
+    return void 0;
+  }
+  const channelId = parseSlackChannelId(parts[1]);
+  const threadTs = parseSlackMessageTs(parts[2]);
+  if (!channelId || !threadTs) {
+    return void 0;
+  }
+  return { channelId, threadTs };
+}
+function resolveSlackChannelIdFromThreadId(threadId) {
+  return parseSlackThreadId(threadId)?.channelId;
+}
+function resolveSlackChannelIdFromMessage(message) {
+  const messageChannelId = parseSlackChannelId(
+    message.channelId
+  );
+  if (messageChannelId) {
+    return messageChannelId;
+  }
+  const raw = message.raw;
+  if (raw && typeof raw === "object") {
+    const rawChannel = parseSlackChannelId(
+      raw.channel
+    );
+    if (rawChannel) {
+      return rawChannel;
+    }
+  }
+  const threadId = toTrimmedSlackString(
+    message.threadId
+  );
+  return resolveSlackChannelIdFromThreadId(threadId);
+}
+
+export {
+  readSlackRawMessageContext,
+  parseSlackThreadId,
+  resolveSlackChannelIdFromThreadId,
+  resolveSlackChannelIdFromMessage
+};

package/dist/{chunk-SMTAXLX4.js → chunk-ACJZZY5W.js}

@@ -1,9 +1,9 @@
 import {
   pluginCatalogRuntime
-} from "./chunk-ZO6E537B.js";
+} from "./chunk-GHNO2WUH.js";
 import {
   logWarn
-} from "./chunk-ASK74NM6.js";
+} from "./chunk-JP2ZOSQK.js";
 import {
   skillRoots
 } from "./chunk-H4HBKISO.js";

package/dist/{chunk-KYKLQYSU.js → chunk-APYVVX2Y.js}

@@ -1,6 +1,6 @@
 import {
   getChatConfig
-} from "./chunk-574YK7QW.js";
+} from "./chunk-XLIAQRDI.js";
 
 // src/chat/state/adapter.ts
 import { createMemoryState } from "@chat-adapter/state-memory";

package/dist/{chunk-EOSC6JOC.js → chunk-EFQX6XBW.js}

@@ -5,7 +5,7 @@ import {
   logInfo,
   logWarn,
   setSpanAttributes
-} from "./chunk-ASK74NM6.js";
+} from "./chunk-JP2ZOSQK.js";
 import {
   discoverInstalledPluginPackageContent,
   normalizePluginPackageNames

package/dist/{chunk-IMLJE2NY.js → chunk-EQMSKORN.js}

@@ -1,9 +1,9 @@
 import {
   getDb
-} from "./chunk-DW6SLS5F.js";
+} from "./chunk-KP7E267S.js";
 import {
   juniorStats
-} from "./chunk-GCGJGSQL.js";
+} from "./chunk-S4PUICSB.js";
 
 // src/stats.ts
 import { and, asc, gte, lte, sql } from "drizzle-orm";

package/dist/{chunk-ZO6E537B.js → chunk-GHNO2WUH.js}

@@ -1,6 +1,6 @@
 import {
   createPluginCatalogRuntime
-} from "./chunk-EOSC6JOC.js";
+} from "./chunk-EFQX6XBW.js";
 
 // src/chat/plugins/catalog-runtime.ts
 var pluginCatalogRuntime = createPluginCatalogRuntime();

package/dist/{chunk-WKBPFZ25.js → chunk-GK55KLEH.js}

@@ -1,6 +1,6 @@
 import {
   pluginCatalogRuntime
-} from "./chunk-ZO6E537B.js";
+} from "./chunk-GHNO2WUH.js";
 
 // src/chat/plugins/validation.ts
 import { isDeepStrictEqual } from "util";

package/dist/{chunk-PR3M62LK.js → chunk-HX236W2U.js}

@@ -57,7 +57,10 @@ var authenticationUnlinkedEvent = defineConversationEvent({
     };
   }
 });
-var NATIVE_EVENT_DEFINITIONS = [authenticationLinkedEvent, authenticationUnlinkedEvent];
+var NATIVE_EVENT_DEFINITIONS = [
+  authenticationLinkedEvent,
+  authenticationUnlinkedEvent
+];
 function getJuniorNativeEventDefinition(args) {
   return NATIVE_EVENT_DEFINITIONS.find(
     (definition) => definition.eventName === args.name && definition.version === args.version
@@ -67,9 +70,8 @@ function renderJuniorNativeConversationEvent(args) {
   if (args.namespace !== JUNIOR_NATIVE_EVENT_NAMESPACE) return void 0;
   const definition = getJuniorNativeEventDefinition(args);
   if (!definition) return void 0;
-  return conversationEventPresentationSchema.parse(
-    definition.renderEvent(definition.parse(args.content))
-  );
+  const presentation = definition.renderEvent(definition.parse(args.content));
+  return presentation === void 0 ? void 0 : conversationEventPresentationSchema.parse(presentation);
 }
 
 // src/chat/usage.ts

package/dist/{chunk-7LDOW4QA.js → chunk-JFW62B3Y.js}

@@ -1,7 +1,7 @@
 // package.json
 var package_default = {
   name: "@sentry/junior",
-  version: "0.124.2",
+  version: "0.126.0",
   private: false,
   publishConfig: {
     access: "public"

package/dist/{chunk-ASK74NM6.js → chunk-JP2ZOSQK.js}

@@ -1,7 +1,3 @@
-import {
-  toOptionalNumber,
-  toOptionalString
-} from "./chunk-OB42YVAE.js";
 import {
   captureException,
   getActiveSpan,
@@ -13,7 +9,7 @@ import {
 } from "./chunk-6GWA276C.js";
 import {
   getDeploymentTelemetryAttributes
-} from "./chunk-VMRKIKGO.js";
+} from "./chunk-LCRWDMCH.js";
 
 // src/chat/logging.ts
 import path from "path";
@@ -25,6 +21,17 @@ import {
   getLogger
 } from "@logtape/logtape";
 
+// src/chat/coerce.ts
+function toOptionalString(value) {
+  return typeof value === "string" && value.trim() ? value : void 0;
+}
+function toOptionalNumber(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+
 // src/chat/log-context.ts
 import { AsyncLocalStorage } from "async_hooks";
 var logContextStorage = new AsyncLocalStorage();
@@ -1455,6 +1462,9 @@ function extractGenAiUsageAttributes(...sources) {
 }
 
 export {
+  toOptionalString,
+  toOptionalNumber,
+  isRecord,
   normalizeIdentityEmail,
   normalizeGenAiFinishReason,
   summarizeMessageText,