@sentry/junior 0.125.0 → 0.126.0

package/dist/chat/slack/footer.d.ts

@@ -1,7 +1,12 @@
+import type { ReplyAttribution } from "@sentry/junior-plugin-api";
 interface SlackMrkdwnTextObject {
     text: string;
     type: "mrkdwn";
 }
+interface SlackPlainTextObject {
+    text: string;
+    type: "plain_text";
+}
 /** Slack-flavored Markdown block — accepts a standard Markdown subset and Slack renders it natively. */
 interface SlackMarkdownBlock {
     text: string;
@@ -12,7 +17,7 @@ interface SlackSectionBlock {
     type: "section";
 }
 interface SlackContextBlock {
-    elements: SlackMrkdwnTextObject[];
+    elements: Array<SlackMrkdwnTextObject | SlackPlainTextObject>;
     type: "context";
 }
 export type SlackMessageBlock = SlackMarkdownBlock | SlackSectionBlock | SlackContextBlock;
@@ -22,8 +27,11 @@ interface SlackReplyFooterItem {
     value: string;
 }
 export interface SlackReplyFooter {
+    attribution?: ReplyAttribution;
     items: SlackReplyFooterItem[];
 }
+/** Render compact reply attribution for the Slack footer. */
+export declare function formatReplyAttribution(attribution: ReplyAttribution): string;
 /**
  * Build the compact conversation footer for visible Slack reply surfaces.
  *
@@ -31,6 +39,7 @@ export interface SlackReplyFooter {
  */
 export declare function buildSlackReplyFooter(args: {
     conversationId?: string;
+    replyAttribution?: ReplyAttribution;
 }): SlackReplyFooter | undefined;
 /** Build Slack blocks for a reply chunk using the Slack-flavored markdown block for the body. */
 export declare function buildSlackReplyBlocks(text: string, footer: SlackReplyFooter | undefined): SlackMessageBlock[] | undefined;

package/dist/chat/slack/reply.d.ts

@@ -1,12 +1,19 @@
+/**
+ * Destination-visible Slack reply delivery.
+ *
+ * Owns chunking, conversation footer attachment, and outbound posting.
+ */
+import type { ReplyAttribution } from "@sentry/junior-plugin-api";
 /**
  * Send one destination-visible Slack reply.
  *
- * Chunks oversized text, builds the conversation footer from
- * `conversationId`, and posts through the shared Slack outbound boundary.
+ * Chunks oversized text, builds compact attribution and conversation footer
+ * context, and posts through the shared Slack outbound boundary.
  */
 export declare function sendSlackReply(args: {
     channelId: string;
     conversationId: string;
+    replyAttribution?: ReplyAttribution;
     text: string;
     threadTs?: string;
 }): Promise<string | 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-K6MQWEEJ.js → chunk-4PV73JHH.js}

@@ -6,36 +6,34 @@ import {
   isDmChannel,
   normalizeSlackConversationId,
   withSlackRetries
-} from "./chunk-ODB55JM7.js";
+} from "./chunk-6KWO5DU3.js";
 import {
   getDb,
   parseDestination
-} from "./chunk-IS4DGI5J.js";
+} from "./chunk-KP7E267S.js";
 import {
   acquireActiveLock,
   getStateAdapter,
   sleep
-} from "./chunk-XJYGLTYI.js";
+} from "./chunk-APYVVX2Y.js";
 import {
   normalizeSlackEmojiName
-} from "./chunk-KN7QI56S.js";
+} from "./chunk-XLIAQRDI.js";
 import {
   pluginCatalogRuntime
-} from "./chunk-NM3PMQS6.js";
+} from "./chunk-GHNO2WUH.js";
 import {
   fetchWithBoundedOAuthErrorBodies
-} from "./chunk-2U5CLBYF.js";
-import {
-  logInfo,
-  logWarn
-} from "./chunk-MVYNJECP.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-ODB55JM7.js → chunk-6KWO5DU3.js}

@@ -1,7 +1,7 @@
 import {
   getConversationEventStore,
   getDb
-} from "./chunk-IS4DGI5J.js";
+} from "./chunk-KP7E267S.js";
 import {
   juniorConversationAnnotations,
   juniorConversationEvents,
@@ -12,18 +12,23 @@ import {
   SANDBOX_WORKSPACE_ROOT,
   getStateAdapter,
   sleep
-} from "./chunk-XJYGLTYI.js";
+} from "./chunk-APYVVX2Y.js";
 import {
   botConfig,
   completeObject,
   embedTexts,
   getSlackBotToken,
   standardModelId
-} from "./chunk-KN7QI56S.js";
+} from "./chunk-XLIAQRDI.js";
 import {
   isActorUserId,
   parseActorUserId
 } from "./chunk-HZF5P5UN.js";
+import {
+  parseSlackChannelReferenceId,
+  parseSlackMessageTs,
+  parseSlackTeamId
+} from "./chunk-F3B2YJ76.js";
 import {
   logException,
   logInfo,
@@ -32,12 +37,7 @@ import {
   setSpanAttributes,
   setSpanStatus,
   withSpan
-} from "./chunk-MVYNJECP.js";
-import {
-  parseSlackChannelReferenceId,
-  parseSlackMessageTs,
-  parseSlackTeamId
-} from "./chunk-F3B2YJ76.js";
+} from "./chunk-JP2ZOSQK.js";
 
 // src/chat/plugins/agent-hooks.ts
 import {

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-CAPBVX4L.js → chunk-ACJZZY5W.js}

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

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

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

package/dist/{chunk-2U5CLBYF.js → chunk-EFQX6XBW.js}

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

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

@@ -1,6 +1,6 @@
 import {
   getDb
-} from "./chunk-IS4DGI5J.js";
+} from "./chunk-KP7E267S.js";
 import {
   juniorStats
 } from "./chunk-S4PUICSB.js";

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

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

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

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

package/dist/{chunk-ZXGBLAYQ.js → chunk-JFW62B3Y.js}

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

package/dist/{chunk-MVYNJECP.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-2R5MASH3.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,

package/dist/{chunk-LG5TXWXI.js → chunk-KISG7E24.js}

@@ -13,7 +13,7 @@ import {
   persistAuthPauseTurnState,
   requireTurnFailureEventId,
   scheduleSessionCompletedPluginTasks
-} from "./chunk-JT3YMQR3.js";
+} from "./chunk-YMSVBWBY.js";
 import {
   buildSentryConversationUrl
 } from "./chunk-4CODA7P5.js";
@@ -40,7 +40,7 @@ import {
   resolveBaseUrl,
   resolvePluginOAuthAccount,
   truncateStatusText
-} from "./chunk-K6MQWEEJ.js";
+} from "./chunk-4PV73JHH.js";
 import {
   JUNIOR_THREAD_STATE_TTL_MS,
   TurnSliceLimitExceededError,
@@ -73,7 +73,13 @@ import {
   recordDeliveredAssistantMessage,
   turnHasReply,
   updateConversationStats
-} from "./chunk-7K57FJXR.js";
+} from "./chunk-WRH7DWFO.js";
+import {
+  parseSlackThreadId,
+  readSlackRawMessageContext,
+  resolveSlackChannelIdFromMessage,
+  resolveSlackChannelIdFromThreadId
+} from "./chunk-72SDEHFP.js";
 import {
   SlackActionError,
   getDashboardConversationLink,
@@ -82,19 +88,19 @@ import {
   getSlackClient,
   isDmChannel,
   normalizeSlackConversationId
-} from "./chunk-ODB55JM7.js";
+} from "./chunk-6KWO5DU3.js";
 import {
   getConversationEventStore,
   getConversationStore,
   parseDestination,
   requireSlackDestination,
   sameDestination
-} from "./chunk-IS4DGI5J.js";
+} from "./chunk-KP7E267S.js";
 import {
   acquireActiveLock,
   getDefaultRedisStateAdapterFor,
   getStateAdapter
-} from "./chunk-XJYGLTYI.js";
+} from "./chunk-APYVVX2Y.js";
 import {
   FUNCTION_TIMEOUT_BUFFER_SECONDS,
   botConfig,
@@ -103,45 +109,37 @@ import {
   getRuntimeMetadata,
   normalizeSlackEmojiName,
   standardModelId
-} from "./chunk-KN7QI56S.js";
-import {
-  parseSlackThreadId,
-  readSlackRawMessageContext,
-  resolveSlackChannelIdFromMessage,
-  resolveSlackChannelIdFromThreadId
-} from "./chunk-S7G34U75.js";
+} from "./chunk-XLIAQRDI.js";
 import {
   discoverSkills
-} from "./chunk-CAPBVX4L.js";
+} from "./chunk-ACJZZY5W.js";
 import {
   pluginCatalogRuntime
-} from "./chunk-NM3PMQS6.js";
+} from "./chunk-GHNO2WUH.js";
 import {
   buildOAuthTokenRequest,
   hasRequiredOAuthScope,
   parseOAuthTokenResponse
-} from "./chunk-2U5CLBYF.js";
+} from "./chunk-EFQX6XBW.js";
 import {
   createSlackResumeActor,
   isUserActor,
   parseStoredSlackActor
 } from "./chunk-HZF5P5UN.js";
+import {
+  parseSlackMessageTs
+} from "./chunk-F3B2YJ76.js";
 import {
   buildTurnFailureResponse,
+  isRecord,
   logException,
   logInfo,
   logWarn,
   setTags,
-  withLogContext
-} from "./chunk-MVYNJECP.js";
-import {
-  isRecord,
   toOptionalNumber,
-  toOptionalString
-} from "./chunk-OB42YVAE.js";
-import {
-  parseSlackMessageTs
-} from "./chunk-F3B2YJ76.js";
+  toOptionalString,
+  withLogContext
+} from "./chunk-JP2ZOSQK.js";
 import {
   homeDir
 } from "./chunk-H4HBKISO.js";
@@ -508,6 +506,9 @@ function createSlackWebApiAssistantStatusSession(args) {
 }
 
 // src/chat/slack/footer.ts
+function formatReplyAttribution(attribution) {
+  return attribution.detail ? `${attribution.label} \xB7 ${attribution.detail}` : attribution.label;
+}
 function buildSlackReplyFooter(args) {
   const items = [];
   const conversationId = args.conversationId?.trim();
@@ -522,7 +523,10 @@ function buildSlackReplyFooter(args) {
     }
     items.push(idItem);
   }
-  return items.length > 0 ? { items } : void 0;
+  return items.length > 0 || args.replyAttribution ? {
+    ...args.replyAttribution ? { attribution: args.replyAttribution } : {},
+    items
+  } : void 0;
 }
 function buildSlackReplyBlocks(text, footer) {
   if (!text.trim()) {
@@ -534,13 +538,22 @@ function buildSlackReplyBlocks(text, footer) {
       text
     }
   ];
-  if (footer?.items.length) {
+  if (footer && (footer.attribution || footer.items.length > 0)) {
+    const attributionElements = footer.attribution ? [
+      {
+        type: "plain_text",
+        text: formatReplyAttribution(footer.attribution)
+      }
+    ] : [];
     blocks.push({
       type: "context",
-      elements: footer.items.map((item) => ({
-        type: "mrkdwn",
-        text: item.url ? `*${escapeSlackMrkdwnText(item.label)}:* ${formatSlackLink(item.url, item.value)}` : `*${escapeSlackMrkdwnText(item.label)}:* ${escapeSlackMrkdwnText(item.value)}`
-      }))
+      elements: [
+        ...attributionElements,
+        ...footer.items.map((item) => ({
+          type: "mrkdwn",
+          text: item.url ? `*${escapeSlackMrkdwnText(item.label)}:* ${formatSlackLink(item.url, item.value)}` : `*${escapeSlackMrkdwnText(item.label)}:* ${escapeSlackMrkdwnText(item.value)}`
+        }))
+      ]
     });
   }
   return blocks;
@@ -754,18 +767,23 @@ function buildSlackOutputMessage(text) {
 async function sendSlackReply(args) {
   const chunks = splitSlackReplyText(args.text);
   const footer = buildSlackReplyFooter({
-    conversationId: args.conversationId
+    conversationId: args.conversationId,
+    replyAttribution: args.replyAttribution
   });
   let lastMessageTs;
   for (const [index, text] of chunks.entries()) {
+    const isFinalChunk = index === chunks.length - 1;
     const blocks = buildSlackReplyBlocks(
       text,
-      index === chunks.length - 1 ? footer : void 0
+      isFinalChunk ? footer : void 0
     );
+    const fallbackText = isFinalChunk && args.replyAttribution ? `${text}
+
+${escapeSlackMrkdwnText(formatReplyAttribution(args.replyAttribution))}` : text;
     const response = await postSlackMessage({
       channelId: args.channelId,
       threadTs: args.threadTs,
-      text,
+      text: fallbackText,
       ...blocks ? { blocks } : {}
     });
     lastMessageTs = response.ts;
@@ -1085,12 +1103,13 @@ function resolveReplyTimeoutMs(explicitTimeoutMs) {
   const parsed = Number.parseInt(raw, 10);
   return Number.isFinite(parsed) && parsed > 0 ? parsed : void 0;
 }
-async function postSlackMessageBestEffort(channelId, threadTs, text, conversationId) {
+async function postSlackMessageBestEffort(channelId, threadTs, text, conversationId, replyAttribution) {
   try {
     if (conversationId) {
       await sendSlackReply({
         channelId,
         conversationId,
+        replyAttribution,
         text,
         threadTs
       });
@@ -1408,6 +1427,7 @@ async function resumeSlackTurnInContext(args) {
         messageTs = await sendSlackReply({
           channelId: runArgs.channelId,
           conversationId: runArgs.conversationId,
+          replyAttribution: runArgs.replyContext?.routing.dispatch?.replyAttribution,
           text,
           threadTs: runArgs.threadTs
         });
@@ -1683,7 +1703,8 @@ async function resumeSlackTurnInContext(args) {
             deferredAuthInfo.providerDisplayName,
             deferredAuthInfo.requestText
           ),
-          runArgs.conversationId
+          runArgs.conversationId,
+          runArgs.replyContext?.routing.dispatch?.replyAttribution
         );
       }
       return true;