@sentry/junior 0.69.0 → 0.70.0

package/dist/app.js

@@ -19,6 +19,7 @@ import {
   getAgentPlugins,
   getAgentTurnSessionRecord,
   getInterruptionMarker,
+  initConversationContext,
   listAgentTurnSessionSummaries,
   listAgentTurnSessionSummariesForConversation,
   loadConnectedMcpProviders,
@@ -32,12 +33,13 @@ import {
   resolveSlackChannelTypeFromMessage,
   resolveSlackConversationContext,
   setAgentPlugins,
+  setConversationTitle,
   splitSlackReplyText,
   truncateStatusText,
   upsertAgentTurnSessionRecord,
   validateAgentPlugins,
   verifySlackDirectCredentialSubject
-} from "./chunk-N3MORKTH.js";
+} from "./chunk-HOGQL2H6.js";
 import {
   discoverSkills,
   findSkillByName,
@@ -6545,6 +6547,7 @@ import {
   agentPluginProviderAccountSchema
 } from "@sentry/junior-plugin-api";
 var finiteNumberSchema = z.number().refine(Number.isFinite);
+var httpStatusSchema = z.number().int().min(100).max(599);
 var providerNameSchema = z.string().regex(/^[a-z][a-z0-9-]*$/);
 var sandboxEgressGrantSchema = agentPluginGrantSchema;
 var sandboxEgressCredentialContextSchema = z.object({
@@ -6584,7 +6587,7 @@ var sandboxEgressPermissionDeniedSignalSchema = z.object({
   provider: providerNameSchema,
   source: z.literal("upstream"),
   sso: z.string().optional(),
-  status: z.literal(403),
+  status: httpStatusSchema,
   upstreamHost: z.string().min(1),
   upstreamPath: z.string().min(1),
   createdAtMs: finiteNumberSchema
@@ -8482,6 +8485,10 @@ function stringField(record, key) {
   const value = record[key];
   return typeof value === "string" ? value : "";
 }
+function numberField(record, key) {
+  const value = record[key];
+  return typeof value === "number" && Number.isFinite(value) ? value : 0;
+}
 function stringListField(record, key) {
   const value = record[key];
   return Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
@@ -8502,14 +8509,15 @@ function upstreamPermissionDeniedText(value) {
     return void 0;
   }
   const signal = value.permission_denied;
-  if (signal.source !== "upstream" || signal.status !== 403) {
+  if (signal.source !== "upstream") {
     return void 0;
   }
   const provider = stringField(signal, "provider");
   const message = stringField(signal, "message");
   const upstreamHost = stringField(signal, "upstreamHost");
   const upstreamPath2 = stringField(signal, "upstreamPath");
-  if (!provider || !message || !upstreamHost || !upstreamPath2) {
+  const status = numberField(signal, "status");
+  if (!provider || !message || !upstreamHost || !upstreamPath2 || !status) {
     return void 0;
   }
   const grant = isRecord3(signal.grant) ? signal.grant : {};
@@ -8535,7 +8543,7 @@ function upstreamPermissionDeniedText(value) {
       ...grantRequirements.map((item) => `- ${item}`)
     ] : [],
     `Upstream: ${upstreamHost}${upstreamPath2}`,
-    "Status: 403",
+    `Status: ${status}`,
     ...acceptedPermissions ? [`Accepted provider permissions: ${acceptedPermissions}`] : [],
     ...sso ? [`Provider SSO: ${sso}`] : [],
     ...command ? [`Command: ${command}`] : [],
@@ -8953,12 +8961,41 @@ async function selectPluginGrant(input) {
     plugin: { name: plugin.name },
     log: createAgentPluginLogger(plugin.name),
     request: {
+      ...input.bodyText !== void 0 ? { bodyText: input.bodyText } : {},
       method: input.method,
       url: input.upstreamUrl.toString()
     }
   });
   return result === void 0 ? void 0 : parseGrant(result, plugin.name);
 }
+async function onPluginEgressResponse(input) {
+  const plugin = agentPluginFor(input.provider);
+  const hook = plugin?.hooks?.onEgressResponse;
+  if (!plugin || !hook) {
+    return {};
+  }
+  let permissionDenied;
+  await hook({
+    plugin: { name: plugin.name },
+    log: createAgentPluginLogger(plugin.name),
+    grant: input.grant,
+    permissionDenied(message) {
+      const trimmed = message.trim();
+      if (!trimmed) {
+        throw new Error(
+          `Plugin "${plugin.name}" onEgressResponse permissionDenied message is empty`
+        );
+      }
+      permissionDenied = { message: trimmed };
+    },
+    request: {
+      method: input.method,
+      url: input.upstreamUrl.toString()
+    },
+    response: input.response
+  });
+  return permissionDenied ? { permissionDenied } : {};
+}
 function hasEgressCredentialHooks(provider) {
   const hooks = agentPluginFor(provider)?.hooks;
   return Boolean(hooks?.grantForEgress || hooks?.issueCredential);
@@ -17426,6 +17463,7 @@ async function selectSandboxEgressGrant(input) {
     return defaultGrantForProvider(input);
   }
   const pluginGrant = await selectPluginGrant({
+    ...input.bodyText !== void 0 ? { bodyText: input.bodyText } : {},
     provider: input.provider,
     method: input.method,
     upstreamUrl: input.upstreamUrl
@@ -17587,6 +17625,7 @@ async function verifyVercelSandboxOidcToken(token) {
 }
 
 // src/chat/sandbox/egress-proxy.ts
+import { EgressAuthRequired } from "@sentry/junior-plugin-api";
 var OIDC_TOKEN_HEADER = "vercel-sandbox-oidc-token";
 var FORWARDED_HOST_HEADER = "vercel-forwarded-host";
 var FORWARDED_SCHEME_HEADER = "vercel-forwarded-scheme";
@@ -17616,6 +17655,8 @@ var DECODED_RESPONSE_HEADERS = /* @__PURE__ */ new Set([
 ]);
 var UPSTREAM_TOKEN_REJECTION_STATUS = 401;
 var UPSTREAM_PERMISSION_REJECTION_STATUS = 403;
+var GRANT_SELECTION_BODY_TEXT_LIMIT_BYTES = 64 * 1024;
+var RESPONSE_BODY_TEXT_LIMIT_BYTES = 64 * 1024;
 function jsonError(message, status) {
   return Response.json({ error: message }, { status });
 }
@@ -17714,6 +17755,9 @@ function githubPermissionHeaders(upstream) {
 function permissionDeniedMessage(provider, grant) {
   return `${provider} returned HTTP 403 after Junior injected the ${grant.name} grant. Junior forwarded the request; this is not a local runtime block.`;
 }
+function isEgressAuthRequired(error) {
+  return error instanceof EgressAuthRequired || error instanceof Error && error.name === "EgressAuthRequired";
+}
 function logSandboxEgressUpstreamRequest(input) {
   if (!shouldLogSandboxEgressInfo()) {
     return;
@@ -17822,6 +17866,78 @@ async function requestBodyBytes(request) {
   }
   return await request.arrayBuffer();
 }
+function isGrantSelectionBodyVisible(input) {
+  return input.provider === "github" && input.upstreamUrl.hostname.toLowerCase() === "api.github.com" && input.upstreamUrl.pathname.toLowerCase().endsWith("/graphql");
+}
+function requestBodyText(body) {
+  if (body === void 0 || body.byteLength > GRANT_SELECTION_BODY_TEXT_LIMIT_BYTES) {
+    return void 0;
+  }
+  return new TextDecoder().decode(body);
+}
+function responseContentLength(upstream) {
+  const raw = upstream.headers.get("content-length");
+  if (!raw) {
+    return void 0;
+  }
+  const parsed = Number(raw);
+  return Number.isSafeInteger(parsed) && parsed >= 0 ? parsed : void 0;
+}
+async function responseTextWithinLimit(upstream, maxBytes) {
+  const limit = Math.min(
+    Math.max(0, Math.floor(maxBytes)),
+    RESPONSE_BODY_TEXT_LIMIT_BYTES
+  );
+  if (limit <= 0) {
+    return void 0;
+  }
+  const contentLength = responseContentLength(upstream);
+  if (contentLength !== void 0 && contentLength > limit) {
+    return void 0;
+  }
+  let clone;
+  try {
+    clone = upstream.clone();
+  } catch {
+    return void 0;
+  }
+  const body = clone.body;
+  if (!body) {
+    return "";
+  }
+  const reader = body.getReader();
+  const chunks = [];
+  let bytes = 0;
+  try {
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) {
+        break;
+      }
+      if (!value) {
+        continue;
+      }
+      bytes += value.byteLength;
+      if (bytes > limit) {
+        await reader.cancel().catch(() => void 0);
+        return void 0;
+      }
+      chunks.push(value);
+    }
+  } catch {
+    await reader.cancel().catch(() => void 0);
+    return void 0;
+  } finally {
+    reader.releaseLock();
+  }
+  const combined = new Uint8Array(bytes);
+  let offset = 0;
+  for (const chunk of chunks) {
+    combined.set(chunk, offset);
+    offset += chunk.byteLength;
+  }
+  return new TextDecoder().decode(combined);
+}
 function requestHeaders(request, lease, upstreamHost) {
   const headers = new Headers();
   request.headers.forEach((value, key) => {
@@ -17956,7 +18072,14 @@ async function proxySandboxEgressRequest(request, deps = {}) {
       403
     );
   }
+  let body;
+  let bodyRead = false;
+  if (isGrantSelectionBodyVisible({ provider, upstreamUrl })) {
+    body = await requestBodyBytes(request);
+    bodyRead = true;
+  }
   const grantSelection = await selectSandboxEgressGrant({
+    bodyText: requestBodyText(body),
     provider,
     method: request.method,
     upstreamUrl
@@ -18067,7 +18190,9 @@ async function proxySandboxEgressRequest(request, deps = {}) {
   }
   const fetchImpl = deps.fetch ?? fetch;
   const headers = requestHeaders(request, lease, upstreamUrl.hostname);
-  const body = await requestBodyBytes(request);
+  if (!bodyRead) {
+    body = await requestBodyBytes(request);
+  }
   const intercepted = await deps.interceptHttp?.({
     provider,
     request: new Request(upstreamUrl, {
@@ -18086,6 +18211,93 @@ async function proxySandboxEgressRequest(request, deps = {}) {
     ...body !== void 0 ? { body } : {},
     redirect: "manual"
   });
+  try {
+    const effects = await onPluginEgressResponse({
+      provider,
+      grant: lease.grant,
+      method: request.method,
+      upstreamUrl,
+      response: {
+        headers: new Headers(upstream.headers),
+        readText: async (maxBytes) => await responseTextWithinLimit(upstream, maxBytes),
+        status: upstream.status
+      }
+    });
+    if (effects.permissionDenied) {
+      await setSandboxEgressPermissionDeniedSignal(credentialContext, {
+        provider,
+        grant: lease.grant,
+        ...lease.account ? { account: lease.account } : {},
+        message: effects.permissionDenied.message,
+        source: "upstream",
+        status: upstream.status,
+        upstreamHost: upstreamUrl.hostname,
+        upstreamPath: displayedUpstreamPath(upstreamUrl),
+        ...provider === "github" ? githubPermissionHeaders(upstream) : {}
+      });
+      logWarn(
+        "sandbox_egress_upstream_permission_classified",
+        {},
+        {
+          ...egressAttributes({
+            egressId: activeEgressId,
+            grantAccess: lease.grant.access,
+            grantName: lease.grant.name,
+            grantReason: lease.grant.reason,
+            host: upstreamUrl.hostname,
+            method: request.method,
+            path: upstreamUrl.pathname,
+            provider,
+            status: upstream.status
+          }),
+          ...routingAttributes(request, upstreamUrl),
+          ...upstreamPermissionAttributes(provider, upstream)
+        },
+        "Sandbox egress plugin classified upstream response as permission denied"
+      );
+    }
+  } catch (error) {
+    if (!isEgressAuthRequired(error)) {
+      throw error;
+    }
+    await clearSandboxEgressCredentialLease(
+      provider,
+      lease.grant.name,
+      credentialContext
+    );
+    await setSandboxEgressAuthRequiredSignal(credentialContext, {
+      provider,
+      grant: lease.grant,
+      ...error.authorization ?? lease.authorization ? { authorization: error.authorization ?? lease.authorization } : {},
+      message: error.message
+    });
+    logWarn(
+      "sandbox_egress_upstream_auth_required_classified",
+      {},
+      {
+        ...egressAttributes({
+          egressId: activeEgressId,
+          grantAccess: lease.grant.access,
+          grantName: lease.grant.name,
+          grantReason: lease.grant.reason,
+          host: upstreamUrl.hostname,
+          method: request.method,
+          path: upstreamUrl.pathname,
+          provider,
+          status: upstream.status
+        }),
+        ...routingAttributes(request, upstreamUrl),
+        ...upstreamPermissionAttributes(provider, upstream)
+      },
+      "Sandbox egress plugin classified upstream response as auth required"
+    );
+    await upstream.body?.cancel().catch(() => void 0);
+    return authRequiredResponse({
+      provider,
+      grant: lease.grant,
+      message: error.message
+    });
+  }
   logSandboxEgressUpstreamRequest({
     egressId: activeEgressId,
     grantAccess: lease.grant.access,
@@ -19034,6 +19246,7 @@ function createSlackTurnRuntime(deps) {
         text: args.text
       });
     }
+    await args.onInputCommitted?.();
   };
   return {
     async handleNewMention(thread, message, hooks) {
@@ -19222,6 +19435,7 @@ function createSlackTurnRuntime(deps) {
               message,
               decision: { shouldReply: false, reason },
               context: threadContext,
+              onInputCommitted: hooks.onInputCommitted,
               text: combinedText
             });
             return;
@@ -19258,6 +19472,7 @@ function createSlackTurnRuntime(deps) {
               message,
               decision,
               context: threadContext,
+              onInputCommitted: hooks.onInputCommitted,
               preparedState,
               text: combinedText
             });
@@ -19269,6 +19484,7 @@ function createSlackTurnRuntime(deps) {
               message,
               decision,
               context: threadContext,
+              onInputCommitted: hooks.onInputCommitted,
               preparedState,
               text: combinedText
             });
@@ -20694,12 +20910,13 @@ function createReplyToThread(deps) {
           updateConversationStats
         });
         if (conversationId) {
+          const turnStartedAtMs = message.metadata.dateSent.getTime();
           void recordAgentTurnSessionSummary({
             channelName,
             conversationId,
             sessionId: turnId,
             sliceId: 1,
-            startedAtMs: message.metadata.dateSent.getTime(),
+            startedAtMs: turnStartedAtMs,
             state: "running",
             surface: "slack",
             requester,
@@ -20710,12 +20927,41 @@ function createReplyToThread(deps) {
               error,
               "agent_turn_summary_record_failed",
               turnTraceContext,
-              {
-                "app.agent.turn.state": "running"
-              },
+              { "app.agent.turn.state": "running" },
               "Failed to record running turn summary"
             );
           });
+          void initConversationContext(conversationId, {
+            channelName,
+            originSurface: "slack",
+            originRequester: requester,
+            startedAtMs: turnStartedAtMs
+          }).catch((error) => {
+            logException(
+              error,
+              "conversation_details_context_init_failed",
+              turnTraceContext,
+              { "app.agent.turn.state": "running" },
+              "Failed to init conversation context at turn start"
+            );
+          });
+          const existingAssistantTitle = preparedState.artifacts.assistantTitle?.trim();
+          if (existingAssistantTitle) {
+            void setConversationTitle(conversationId, {
+              displayTitle: existingAssistantTitle,
+              ...preparedState.artifacts.assistantTitleSourceMessageId ? {
+                titleSourceMessageId: preparedState.artifacts.assistantTitleSourceMessageId
+              } : {}
+            }).catch((error) => {
+              logException(
+                error,
+                "conversation_details_title_refresh_failed",
+                turnTraceContext,
+                { "app.agent.turn.state": "running" },
+                "Failed to refresh conversation title from artifacts"
+              );
+            });
+          }
         }
         setTags({
           conversationId
@@ -20791,6 +21037,7 @@ function createReplyToThread(deps) {
         let persistedAtLeastOnce = false;
         let shouldPersistFailureState = true;
         let latestArtifacts = preparedState.artifacts;
+        let assistantTitleArtifacts = {};
         try {
           const loadedPiMessages = await loadPiMessagesForTurn({
             conversationId,
@@ -20833,6 +21080,54 @@ function createReplyToThread(deps) {
             runId,
             threadId
           });
+          void assistantTitleTask.then(async (titleUpdateResult) => {
+            if (!titleUpdateResult) return;
+            assistantTitleArtifacts = {
+              assistantTitleSourceMessageId: titleUpdateResult.sourceMessageId,
+              ...titleUpdateResult.title ? { assistantTitle: titleUpdateResult.title } : {}
+            };
+            latestArtifacts = {
+              ...latestArtifacts,
+              ...assistantTitleArtifacts
+            };
+            if (conversationId && titleUpdateResult.title) {
+              try {
+                await setConversationTitle(conversationId, {
+                  displayTitle: titleUpdateResult.title,
+                  titleSourceMessageId: titleUpdateResult.sourceMessageId
+                });
+              } catch (error) {
+                logException(
+                  error,
+                  "conversation_details_title_set_failed",
+                  turnTraceContext,
+                  {},
+                  "Failed to set conversation title in details record"
+                );
+              }
+            }
+            try {
+              await persistThreadState(thread, {
+                artifacts: latestArtifacts
+              });
+            } catch (error) {
+              logException(
+                error,
+                "assistant_title_artifact_persist_failed",
+                turnTraceContext,
+                {},
+                "Failed to persist async assistant title artifact state"
+              );
+            }
+          }).catch((error) => {
+            logException(
+              error,
+              "assistant_title_task_failed",
+              turnTraceContext,
+              {},
+              "Async assistant title task failed"
+            );
+          });
           const toolChannelId = preparedState.artifacts.assistantContextChannelId ?? channelId;
           const resolveSteeringMessages = async (queuedMessages) => {
             return await Promise.all(
@@ -20911,8 +21206,13 @@ function createReplyToThread(deps) {
                 });
               },
               onArtifactStateUpdated: async (artifacts) => {
-                latestArtifacts = artifacts;
-                await persistThreadState(thread, { artifacts });
+                latestArtifacts = {
+                  ...artifacts,
+                  ...assistantTitleArtifacts
+                };
+                await persistThreadState(thread, {
+                  artifacts: latestArtifacts
+                });
               },
               onAuthPending: async (pendingAuth) => {
                 await applyPendingAuthUpdate({
@@ -21013,24 +21313,26 @@ function createReplyToThread(deps) {
               await sent.delete();
             }
           }
-          const titleUpdateResult = await assistantTitleTask;
-          if (titleUpdateResult) {
-            artifactStatePatch.assistantTitleSourceMessageId = titleUpdateResult.sourceMessageId;
-            if (titleUpdateResult.title) {
-              artifactStatePatch.assistantTitle = titleUpdateResult.title;
-            }
-          }
           const completedState = buildDeliveredTurnStatePatch({
-            artifactStatePatch,
-            artifacts: preparedState.artifacts,
+            artifactStatePatch: {
+              ...artifactStatePatch,
+              ...assistantTitleArtifacts
+            },
+            artifacts: latestArtifacts,
             conversation: preparedState.conversation,
             reply,
             sessionId: turnId,
             userMessageId: preparedState.userMessageId
           });
+          if (completedState.artifacts) {
+            latestArtifacts = completedState.artifacts;
+          }
           await persistThreadState(thread, {
             ...completedState
           });
+          if (completedState.artifacts && (assistantTitleArtifacts.assistantTitle !== void 0 || assistantTitleArtifacts.assistantTitleSourceMessageId !== void 0) && (completedState.artifacts.assistantTitle !== assistantTitleArtifacts.assistantTitle || completedState.artifacts.assistantTitleSourceMessageId !== assistantTitleArtifacts.assistantTitleSourceMessageId)) {
+            await persistThreadState(thread, { artifacts: latestArtifacts });
+          }
           if (conversationId) {
             await recordAgentTurnSessionSummary({
               channelName,
@@ -21041,7 +21343,6 @@ function createReplyToThread(deps) {
               sliceId: 1,
               startedAtMs: message.metadata.dateSent.getTime(),
               state: "completed",
-              conversationTitle: titleUpdateResult?.title,
               requester,
               destination,
               traceId: getActiveTraceId()

package/dist/chat/plugins/credential-hooks.d.ts

@@ -1,12 +1,31 @@
 import { type AgentPluginCredentialResult, type AgentPluginGrant, type AgentPluginProviderAccount } from "@sentry/junior-plugin-api";
 import type { StoredTokens, UserTokenStore } from "@/chat/credentials/user-token-store";
 export interface EgressGrantInput {
+    bodyText?: string;
     method: string;
     provider: string;
     upstreamUrl: URL;
 }
 /** Ask a plugin which grant an outbound request needs. */
 export declare function selectPluginGrant(input: EgressGrantInput): Promise<AgentPluginGrant | undefined>;
+export interface EgressResponseInput {
+    grant: AgentPluginGrant;
+    method: string;
+    provider: string;
+    response: {
+        headers: Headers;
+        readText(maxBytes: number): Promise<string | undefined>;
+        status: number;
+    };
+    upstreamUrl: URL;
+}
+export interface EgressResponseEffects {
+    permissionDenied?: {
+        message: string;
+    };
+}
+/** Let the owning plugin inspect an upstream response without changing pass-through behavior. */
+export declare function onPluginEgressResponse(input: EgressResponseInput): Promise<EgressResponseEffects>;
 /** Return whether a plugin owns credential issuance for egress. */
 export declare function hasEgressCredentialHooks(provider: string): boolean;
 export interface IssueCredentialInput {

package/dist/chat/sandbox/egress-credentials.d.ts

@@ -21,6 +21,7 @@ export declare class SandboxEgressCredentialNeededError extends Error {
 }
 /** Select the plugin-defined or default grant needed for one outbound request. */
 export declare function selectSandboxEgressGrant(input: {
+    bodyText?: string;
     method: string;
     provider: string;
     upstreamUrl: URL;

package/dist/chat/sandbox/egress-schemas.d.ts

@@ -89,7 +89,7 @@ export declare const sandboxEgressPermissionDeniedSignalSchema: z.ZodObject<{
     provider: z.ZodString;
     source: z.ZodLiteral<"upstream">;
     sso: z.ZodOptional<z.ZodString>;
-    status: z.ZodLiteral<403>;
+    status: z.ZodNumber;
     upstreamHost: z.ZodString;
     upstreamPath: z.ZodString;
     createdAtMs: z.ZodNumber;

package/dist/chat/state/conversation-details.d.ts

@@ -0,0 +1,46 @@
+import type { AgentTurnRequester, AgentTurnSurface } from "./turn-session";
+export interface ConversationDetailsRecord {
+    conversationId: string;
+    /** Generated display title from the LLM. Absent until title has been produced. */
+    displayTitle?: string;
+    /** The message id used as input when generating the title. */
+    titleSourceMessageId?: string;
+    /** Slack channel name or equivalent location label. */
+    channelName?: string;
+    /** Surface on which the conversation was started. */
+    originSurface?: AgentTurnSurface;
+    /** Requester who initiated the conversation (first turn). */
+    originRequester?: AgentTurnRequester;
+    /** Timestamp of the first turn in the conversation. */
+    startedAtMs?: number;
+}
+/**
+ * Record the origin context for a conversation the first time it is seen and
+ * refresh the context TTL on later turns without changing the stored origin.
+ */
+export declare function initConversationContext(conversationId: string, context: {
+    channelName?: string;
+    originSurface?: AgentTurnSurface;
+    originRequester?: AgentTurnRequester;
+    startedAtMs: number;
+}): Promise<void>;
+/**
+ * Persist or refresh the LLM-generated title for a conversation.
+ *
+ * Plain set — no read, no lock.
+ */
+export declare function setConversationTitle(conversationId: string, title: {
+    displayTitle: string;
+    titleSourceMessageId?: string;
+}): Promise<void>;
+/**
+ * Read conversation details for a single conversation.
+ * Assembles the context and title records in parallel.
+ * Returns undefined only when neither context nor title details exist yet.
+ */
+export declare function getConversationDetails(conversationId: string): Promise<ConversationDetailsRecord | undefined>;
+/**
+ * Bulk-fetch conversation details for a set of conversation ids in parallel.
+ * Returns a map from conversationId → record (omits ids with no details).
+ */
+export declare function getConversationDetailsForIds(conversationIds: Iterable<string>): Promise<Map<string, ConversationDetailsRecord>>;

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

@@ -12,7 +12,6 @@ export interface AgentTurnRequester {
 }
 export interface AgentTurnSessionRecord {
     channelName?: string;
-    conversationTitle?: string;
     version: number;
     conversationId: string;
     cumulativeDurationMs: number;
@@ -39,7 +38,6 @@ export declare function getAgentTurnSessionRecord(conversationId: string, sessio
 /** Commit stable Pi session state and advance the turn session record. */
 export declare function upsertAgentTurnSessionRecord(args: {
     channelName?: string;
-    conversationTitle?: string;
     conversationId: string;
     cumulativeDurationMs?: number;
     cumulativeUsage?: AgentTurnUsage;
@@ -61,7 +59,6 @@ export declare function upsertAgentTurnSessionRecord(args: {
 /** Record turn-session metadata without storing conversation messages. */
 export declare function recordAgentTurnSessionSummary(args: {
     channelName?: string;
-    conversationTitle?: string;
     conversationId: string;
     cumulativeDurationMs?: number;
     cumulativeUsage?: AgentTurnUsage;

package/dist/{chunk-N3MORKTH.js → chunk-HOGQL2H6.js}

@@ -29,6 +29,7 @@ import {
   logInfo,
   logWarn,
   soulPathCandidates,
+  toOptionalNumber,
   worldPathCandidates
 } from "./chunk-BBXYXOJW.js";
 import {
@@ -2174,7 +2175,6 @@ function parseAgentTurnSessionFields(parsed) {
     return void 0;
   }
   const channelName = typeof parsed.channelName === "string" && parsed.channelName.trim() ? parsed.channelName.trim() : void 0;
-  const conversationTitle = typeof parsed.conversationTitle === "string" && parsed.conversationTitle.trim() ? parsed.conversationTitle.trim() : void 0;
   const conversationId = parsed.conversationId;
   const sessionId = parsed.sessionId;
   const sliceId = toFiniteNonNegativeNumber(parsed.sliceId);
@@ -2194,7 +2194,6 @@ function parseAgentTurnSessionFields(parsed) {
   return {
     version,
     ...channelName ? { channelName } : {},
-    ...conversationTitle ? { conversationTitle } : {},
     conversationId,
     sessionId,
     sliceId,
@@ -2285,7 +2284,6 @@ function materializeAgentTurnSessionRecord(stored, piMessages) {
   return {
     version: stored.version,
     ...stored.channelName ? { channelName: stored.channelName } : {},
-    ...stored.conversationTitle ? { conversationTitle: stored.conversationTitle } : {},
     conversationId: stored.conversationId,
     sessionId: stored.sessionId,
     sliceId: stored.sliceId,
@@ -2347,7 +2345,6 @@ function buildStoredRecord(args) {
   return {
     version: (args.previousVersion ?? 0) + 1,
     ...args.channelName ? { channelName: args.channelName } : {},
-    ...args.conversationTitle ? { conversationTitle: args.conversationTitle } : {},
     conversationId: args.conversationId,
     sessionId: args.sessionId,
     sliceId: args.sliceId,
@@ -2408,7 +2405,6 @@ async function updateAgentTurnSessionState(args) {
       state: args.state,
       committedMessageCount: parsed.committedMessageCount,
       ...parsed.channelName ? { channelName: parsed.channelName } : {},
-      ...parsed.conversationTitle ? { conversationTitle: parsed.conversationTitle } : {},
       startedAtMs: parsed.startedAtMs,
       lastProgressAtMs: parsed.lastProgressAtMs,
       previousVersion: parsed.version,
@@ -2442,9 +2438,6 @@ async function upsertAgentTurnSessionRecord(args) {
     ttlMs,
     record: buildStoredRecord({
       ...args.channelName ?? existingRecord?.channelName ? { channelName: args.channelName ?? existingRecord?.channelName } : {},
-      ...args.conversationTitle ?? existingRecord?.conversationTitle ? {
-        conversationTitle: args.conversationTitle ?? existingRecord?.conversationTitle
-      } : {},
       conversationId: args.conversationId,
       sessionId: args.sessionId,
       sliceId: args.sliceId,
@@ -2478,9 +2471,6 @@ async function recordAgentTurnSessionSummary(args) {
     {
       version: existing?.version ?? 0,
       ...args.channelName ?? existing?.channelName ? { channelName: args.channelName ?? existing?.channelName } : {},
-      ...args.conversationTitle ?? existing?.conversationTitle ? {
-        conversationTitle: args.conversationTitle ?? existing?.conversationTitle
-      } : {},
       conversationId: args.conversationId,
       sessionId: args.sessionId,
       sliceId: args.sliceId,
@@ -2687,6 +2677,123 @@ function formatSlackConversationRedactedLabel(context) {
   return formatSlackConversationTypeLabel(context.type);
 }
 
+// src/chat/state/conversation-details.ts
+import { THREAD_STATE_TTL_MS as THREAD_STATE_TTL_MS2 } from "chat";
+var CONVERSATION_PREFIX = "junior:conversation";
+var CONVERSATION_DETAILS_TTL_MS = THREAD_STATE_TTL_MS2;
+function conversationContextKey(conversationId) {
+  return `${CONVERSATION_PREFIX}:${conversationId}:context`;
+}
+function conversationTitleKey(conversationId) {
+  return `${CONVERSATION_PREFIX}:${conversationId}:title`;
+}
+function parseAgentTurnRequester2(value) {
+  if (!isRecord(value)) return void 0;
+  const requester = {
+    ...typeof value.email === "string" ? { email: value.email } : {},
+    ...typeof value.fullName === "string" ? { fullName: value.fullName } : {},
+    ...typeof value.slackUserId === "string" ? { slackUserId: value.slackUserId } : {},
+    ...typeof value.slackUserName === "string" ? { slackUserName: value.slackUserName } : {}
+  };
+  return Object.keys(requester).length > 0 ? requester : void 0;
+}
+function parseOriginSurface(value) {
+  if (value === "slack" || value === "api" || value === "scheduler" || value === "internal") {
+    return value;
+  }
+  return void 0;
+}
+function storedContextFromInput(context) {
+  return {
+    ...context.channelName ? { channelName: context.channelName } : {},
+    ...context.originSurface ? { originSurface: context.originSurface } : {},
+    ...context.originRequester ? { originRequester: context.originRequester } : {},
+    startedAtMs: context.startedAtMs
+  };
+}
+function parseContext(value) {
+  if (!isRecord(value)) return void 0;
+  const startedAtMs = toOptionalNumber(value.startedAtMs);
+  if (startedAtMs === void 0) return void 0;
+  return {
+    ...typeof value.channelName === "string" && value.channelName.trim() ? { channelName: value.channelName.trim() } : {},
+    ...parseOriginSurface(value.originSurface) ? { originSurface: parseOriginSurface(value.originSurface) } : {},
+    ...parseAgentTurnRequester2(value.originRequester) ? { originRequester: parseAgentTurnRequester2(value.originRequester) } : {},
+    startedAtMs
+  };
+}
+function parseTitle(value) {
+  if (!isRecord(value)) return void 0;
+  const displayTitle = typeof value.displayTitle === "string" && value.displayTitle.trim() ? value.displayTitle.trim() : void 0;
+  if (!displayTitle) return void 0;
+  return {
+    displayTitle,
+    ...typeof value.titleSourceMessageId === "string" ? { titleSourceMessageId: value.titleSourceMessageId } : {}
+  };
+}
+async function initConversationContext(conversationId, context) {
+  const stateAdapter = getStateAdapter();
+  await stateAdapter.connect();
+  const key2 = conversationContextKey(conversationId);
+  const inserted = await stateAdapter.setIfNotExists(
+    key2,
+    storedContextFromInput(context),
+    CONVERSATION_DETAILS_TTL_MS
+  );
+  if (inserted) return;
+  const existing = parseContext(await stateAdapter.get(key2));
+  if (!existing) {
+    return;
+  }
+  await stateAdapter.set(key2, existing, CONVERSATION_DETAILS_TTL_MS);
+}
+async function setConversationTitle(conversationId, title) {
+  const stateAdapter = getStateAdapter();
+  await stateAdapter.connect();
+  await stateAdapter.set(
+    conversationTitleKey(conversationId),
+    {
+      displayTitle: title.displayTitle,
+      ...title.titleSourceMessageId ? { titleSourceMessageId: title.titleSourceMessageId } : {}
+    },
+    CONVERSATION_DETAILS_TTL_MS
+  );
+}
+async function getConversationDetails(conversationId) {
+  const stateAdapter = getStateAdapter();
+  await stateAdapter.connect();
+  const [rawContext, rawTitle] = await Promise.all([
+    stateAdapter.get(conversationContextKey(conversationId)),
+    stateAdapter.get(conversationTitleKey(conversationId))
+  ]);
+  const context = parseContext(rawContext);
+  const title = parseTitle(rawTitle);
+  if (!context && !title) return void 0;
+  return {
+    conversationId,
+    ...title?.displayTitle ? { displayTitle: title.displayTitle } : {},
+    ...title?.titleSourceMessageId ? { titleSourceMessageId: title.titleSourceMessageId } : {},
+    ...context?.channelName ? { channelName: context.channelName } : {},
+    ...context?.originSurface ? { originSurface: context.originSurface } : {},
+    ...context?.originRequester ? { originRequester: context.originRequester } : {},
+    ...context?.startedAtMs !== void 0 ? { startedAtMs: context.startedAtMs } : {}
+  };
+}
+async function getConversationDetailsForIds(conversationIds) {
+  const uniqueIds = [...new Set(conversationIds)].filter(Boolean);
+  const entries = await Promise.all(
+    uniqueIds.map(async (id) => {
+      const details = await getConversationDetails(id);
+      return details ? [id, details] : void 0;
+    })
+  );
+  const result = /* @__PURE__ */ new Map();
+  for (const entry of entries) {
+    if (entry) result.set(entry[0], entry[1]);
+  }
+  return result;
+}
+
 export {
   createAgentPluginLogger,
   createPluginState,
@@ -2729,5 +2836,9 @@ export {
   resolveSlackChannelTypeFromMessage,
   resolveSlackConversationContext,
   resolveSlackConversationContextFromThreadId,
-  formatSlackConversationRedactedLabel
+  formatSlackConversationRedactedLabel,
+  initConversationContext,
+  setConversationTitle,
+  getConversationDetails,
+  getConversationDetailsForIds
 };

package/dist/cli/init.js

@@ -31,6 +31,17 @@ export const POST = (request: Request) => app.fetch(request);
 `
   );
 }
+function writePluginsFile(targetDir) {
+  fs.writeFileSync(
+    path.join(targetDir, "plugins.ts"),
+    `import { defineJuniorPlugins } from "@sentry/junior";
+
+export const plugins = defineJuniorPlugins([
+  "@sentry/junior-maintenance",
+]);
+`
+  );
+}
 function writeNitroConfig(targetDir) {
   fs.writeFileSync(
     path.join(targetDir, "nitro.config.ts"),
@@ -39,7 +50,11 @@ import { juniorNitro } from "@sentry/junior/nitro";
 
 export default defineConfig({
   preset: "vercel",
-  modules: [juniorNitro()],
+  modules: [
+    juniorNitro({
+      plugins: "./plugins",
+    }),
+  ],
   routes: {
     "/**": { handler: "./server.ts" },
   },
@@ -129,6 +144,7 @@ async function runInit(dir, log = console.log) {
     },
     dependencies: {
       "@sentry/junior": "latest",
+      "@sentry/junior-maintenance": "latest",
       hono: "^4.12.0"
     },
     devDependencies: {
@@ -199,6 +215,7 @@ SENTRY_ORG_SLUG=
   );
   writeServerEntry(target);
   writeQueueConsumerEntry(target);
+  writePluginsFile(target);
   writeNitroConfig(target);
   writeViteConfig(target);
   writeVercelJson(target);

package/dist/reporting.d.ts

@@ -37,7 +37,10 @@ export interface DashboardRequesterIdentity {
     slackUserName?: string;
 }
 export interface DashboardSessionReport {
-    conversationTitle?: string;
+    /** Always-populated display title. LLM-generated title when available, otherwise the
+     * Slack channel/conversation location label or a generic fallback. Privacy redaction
+     * wins over everything else for non-public conversations. */
+    displayTitle: string;
     cumulativeDurationMs: number;
     cumulativeUsage?: DashboardTurnUsage;
     conversationId: string;
@@ -48,7 +51,6 @@ export interface DashboardSessionReport {
     lastProgressAt: string;
     completedAt?: string;
     surface: DashboardSurface;
-    title: string;
     requesterIdentity?: DashboardRequesterIdentity;
     channel?: string;
     channelName?: string;
@@ -93,6 +95,8 @@ export interface DashboardTurnReport extends DashboardSessionReport {
 }
 export interface DashboardConversationReport {
     conversationId: string;
+    /** Always-populated display title, computed the same way as DashboardSessionReport.displayTitle. */
+    displayTitle: string;
     generatedAt: string;
     turns: DashboardTurnReport[];
 }

package/dist/reporting.js

@@ -6,10 +6,12 @@ import {
   formatSlackConversationRedactedLabel,
   getAgentPluginOperationalReports,
   getAgentTurnSessionRecord,
+  getConversationDetails,
+  getConversationDetailsForIds,
   listAgentTurnSessionSummaries,
   listAgentTurnSessionSummariesForConversation,
   resolveSlackConversationContextFromThreadId
-} from "./chunk-N3MORKTH.js";
+} from "./chunk-HOGQL2H6.js";
 import {
   discoverSkills
 } from "./chunk-GT67ZWZQ.js";
@@ -89,12 +91,6 @@ function surfaceFromConversationId(conversationId) {
 function surfaceFromSummary(summary) {
   return summary.surface ?? surfaceFromConversationId(summary.conversationId);
 }
-function titleFromSummary(summary) {
-  if (summary.state === "awaiting_resume" && summary.resumeReason) {
-    return `Awaiting ${summary.resumeReason} resume`;
-  }
-  return `Turn ${summary.sessionId}`;
-}
 function requesterIdentityReport(requester) {
   if (!requester) return void 0;
   const identity = {
@@ -116,27 +112,33 @@ function turnUsageReport(usage) {
   };
   return Object.keys(report).length > 0 ? report : void 0;
 }
-function sessionReportFromSummary(summary, nowMs = Date.now()) {
+function sessionReportFromSummary(summary, nowMs = Date.now(), details) {
   const slackThread = parseSlackThreadId(summary.conversationId);
   const privacy = resolveConversationPrivacy({
     conversationId: summary.conversationId
   });
+  const effectiveChannelName = details?.channelName ?? summary.channelName;
   const slackConversation = resolveSlackConversationContextFromThreadId({
     threadId: summary.conversationId,
-    channelName: summary.channelName
+    channelName: effectiveChannelName
   });
   const privateLabel = privacy !== "public" ? slackConversation ? formatSlackConversationRedactedLabel(slackConversation) : PRIVATE_CONVERSATION_LABEL : void 0;
-  const conversationTitle = privateLabel ?? summary.conversationTitle;
-  const channelName = privateLabel ?? summary.channelName;
+  const channelName = privateLabel ?? effectiveChannelName;
+  const effectiveSurface = details?.originSurface ?? surfaceFromSummary(summary);
+  const displayTitle = privateLabel ?? details?.displayTitle ?? slackStatsLocationLabel({
+    channel: slackThread?.channelId,
+    channelName: effectiveChannelName
+  }) ?? surfaceFallbackLabel(effectiveSurface);
+  const effectiveRequester = details?.originRequester ?? summary.requester;
   const sentryConversationUrl = buildSentryConversationUrl(
     summary.conversationId
   );
   const sentryTraceUrl = summary.traceId ? buildSentryTraceUrl(summary.traceId) : void 0;
-  const requesterIdentity = requesterIdentityReport(summary.requester);
+  const requesterIdentity = requesterIdentityReport(effectiveRequester);
   const cumulativeUsage = turnUsageReport(summary.cumulativeUsage);
   return {
     conversationId: summary.conversationId,
-    ...conversationTitle ? { conversationTitle } : {},
+    displayTitle,
     id: summary.sessionId,
     status: statusFromCheckpoint(summary, nowMs),
     startedAt: new Date(summary.startedAtMs).toISOString(),
@@ -145,8 +147,7 @@ function sessionReportFromSummary(summary, nowMs = Date.now()) {
     ...summary.state === "completed" ? { completedAt: new Date(summary.updatedAtMs).toISOString() } : {},
     cumulativeDurationMs: summary.cumulativeDurationMs,
     ...cumulativeUsage ? { cumulativeUsage } : {},
-    surface: surfaceFromSummary(summary),
-    title: titleFromSummary(summary),
+    surface: effectiveSurface,
     ...requesterIdentity ? { requesterIdentity } : {},
     ...slackThread ? { channel: slackThread.channelId } : {},
     ...channelName ? { channelName } : {},
@@ -237,8 +238,27 @@ function slackStatsLocationLabel(input) {
   }
   return name || channelId;
 }
+function surfaceFallbackLabel(surface) {
+  if (surface === "scheduler") return "Scheduler";
+  if (surface === "api") return "API";
+  if (surface === "internal") return "Internal";
+  return "Conversation";
+}
+function displayTitleFromDetails(conversationId, details) {
+  if (!details) return void 0;
+  const slackThread = parseSlackThreadId(conversationId);
+  const slackConversation = resolveSlackConversationContextFromThreadId({
+    threadId: conversationId,
+    channelName: details.channelName
+  });
+  const privateLabel = resolveConversationPrivacy({ conversationId }) !== "public" ? formatSlackConversationRedactedLabel(slackConversation) ?? PRIVATE_CONVERSATION_LABEL : void 0;
+  return privateLabel ?? details.displayTitle ?? slackStatsLocationLabel({
+    channel: slackThread?.channelId,
+    channelName: details.channelName
+  }) ?? (details.originSurface ? surfaceFallbackLabel(details.originSurface) : void 0);
+}
 function locationLabel(turn) {
-  return slackStatsLocationLabel(turn) ?? (turn.surface === "scheduler" ? "Scheduler" : turn.surface === "api" ? "API" : turn.surface === "internal" ? "Internal" : "Unknown");
+  return slackStatsLocationLabel(turn) ?? surfaceFallbackLabel(turn.surface);
 }
 function emptyStatsItem(label) {
   return {
@@ -265,7 +285,7 @@ function statusSignals(turns) {
 }
 function statsItems(map) {
   return [...map.values()].sort(
-    (left, right) => right.conversations - left.conversations || right.durationMs - left.durationMs || left.label.localeCompare(right.label)
+    (left, right) => right.conversations - left.conversations || right.turns - left.turns || right.durationMs - left.durationMs || left.label.localeCompare(right.label)
   );
 }
 function newestTurn(turns) {
@@ -620,11 +640,18 @@ async function readSessions() {
   const summaries = await listAgentTurnSessionSummaries(
     DASHBOARD_SESSION_FEED_LIMIT
   );
+  const detailsByConversationId = await getConversationDetailsForIds(
+    summaries.map((s) => s.conversationId)
+  );
   return {
     source: "turn_session_records",
     generatedAt: new Date(nowMs).toISOString(),
     sessions: summaries.map(
-      (summary) => sessionReportFromSummary(summary, nowMs)
+      (summary) => sessionReportFromSummary(
+        summary,
+        nowMs,
+        detailsByConversationId.get(summary.conversationId)
+      )
     )
   };
 }
@@ -643,13 +670,20 @@ async function readConversationStats() {
     summaries: sampledSummaries,
     truncated
   });
+  const detailsByConversationId = await getConversationDetailsForIds(
+    reportSummaries.map((summary) => summary.conversationId)
+  );
   return buildConversationStatsReport({
     generatedAt,
     nowMs,
     sampleLimit: DASHBOARD_CONVERSATION_STATS_LIMIT,
     sampleSize: sampledSummaries.length,
     sessions: reportSummaries.map(
-      (summary) => sessionReportFromSummary(summary, nowMs)
+      (summary) => sessionReportFromSummary(
+        summary,
+        nowMs,
+        detailsByConversationId.get(summary.conversationId)
+      )
     ),
     truncated
   });
@@ -663,7 +697,11 @@ async function readPluginOperationalReports() {
   };
 }
 async function readConversation(conversationId) {
-  const summaries = (await listAgentTurnSessionSummariesForConversation(conversationId)).sort(
+  const [rawSummaries, details] = await Promise.all([
+    listAgentTurnSessionSummariesForConversation(conversationId),
+    getConversationDetails(conversationId)
+  ]);
+  const summaries = rawSummaries.sort(
     (left, right) => left.startedAtMs - right.startedAtMs || left.updatedAtMs - right.updatedAtMs || left.sessionId.localeCompare(right.sessionId)
   );
   const turns = await Promise.all(
@@ -686,7 +724,7 @@ async function readConversation(conversationId) {
       const traceId = summary.traceId ?? sessionRecord?.traceId ?? (canExposeTranscript ? traceIdFromTranscript(transcript) : void 0);
       const sentryTraceUrl = traceId ? buildSentryTraceUrl(traceId) : void 0;
       return {
-        ...sessionReportFromSummary(summary),
+        ...sessionReportFromSummary(summary, Date.now(), details),
         ...traceId ? { traceId } : {},
         ...sentryTraceUrl ? { sentryTraceUrl } : {},
         transcriptAvailable: Boolean(sessionRecord) && canExposeTranscript,
@@ -700,8 +738,11 @@ async function readConversation(conversationId) {
       };
     })
   );
+  const firstTurn = turns[0];
+  const displayTitle = firstTurn?.displayTitle ?? displayTitleFromDetails(conversationId, details) ?? surfaceFallbackLabel(firstTurn?.surface ?? "slack");
   return {
     conversationId,
+    displayTitle,
     generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
     turns
   };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sentry/junior",
-  "version": "0.69.0",
+  "version": "0.70.0",
   "private": false,
   "publishConfig": {
     "access": "public"
@@ -65,7 +65,7 @@
     "node-html-markdown": "^2.0.0",
     "yaml": "^2.9.0",
     "zod": "^4.4.3",
-    "@sentry/junior-plugin-api": "0.69.0"
+    "@sentry/junior-plugin-api": "0.70.0"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",
@@ -78,7 +78,7 @@
     "typescript": "^6.0.3",
     "vercel": "^54.4.0",
     "vitest": "^4.1.7",
-    "@sentry/junior-scheduler": "0.69.0"
+    "@sentry/junior-scheduler": "0.70.0"
   },
   "scripts": {
     "build": "tsup && tsc -p tsconfig.build.json --emitDeclarationOnly",