@sentry/junior-plugin-api 0.160.0 → 0.161.0

package/README.md

@@ -44,6 +44,7 @@ reports, and other typed hook surfaces exported by this package.
   database, logging, and only the host capabilities required by that hook.
 - Prompt hooks return bounded structured prompt messages rather than mutate the
   core prompt.
+- `formatMarkdown` is a pure text rewrite into ordinary Markdown before delivery.
 - User prompt hooks for durable turns may emit registered structured events
   through `ctx.events` for auxiliary work completed while building context.
 - Tool hooks return model-visible schemas aligned with their executor inputs.
@@ -58,6 +59,9 @@ reports, and other typed hook surfaces exported by this package.
   binds the plugin namespace and owns access to the conversation event log.
   Event `costUsd` is additive operation cost and must not duplicate cost
   already recorded in the conversation's agent model usage.
+- Profile report hooks return the same bounded operational report content for
+  one subject user on a person profile. Core owns viewer authorization,
+  collection, sanitization, and browser rendering.
 - Tool hooks may lazily resolve the active actor's canonical identity and linked
   user through `ctx.users.resolveActor()`.
 - Authenticated API route hooks receive `ctx.users.resolve(email)` for lazy

package/dist/annotations.d.ts

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import type { PluginContext } from "./context";
 export declare const resourceLinkAnnotationSchema: z.ZodObject<{
     kind: z.ZodLiteral<"resource_link">;
     key: z.ZodString;
@@ -42,3 +43,30 @@ export interface PluginAnnotations {
 export interface PluginConversationAnnotations {
     forConversation(conversationId: string): PluginAnnotations;
 }
+export declare const conversationSidebarIconSchema: z.ZodEnum<{
+    "circle-dot": "circle-dot";
+    "circle-dashed": "circle-dashed";
+    "circle-x": "circle-x";
+    "git-merge": "git-merge";
+    "triangle-alert": "triangle-alert";
+}>;
+export declare const conversationSidebarAnnotationSchema: z.ZodObject<{
+    icon: z.ZodOptional<z.ZodEnum<{
+        "circle-dot": "circle-dot";
+        "circle-dashed": "circle-dashed";
+        "circle-x": "circle-x";
+        "git-merge": "git-merge";
+        "triangle-alert": "triangle-alert";
+    }>>;
+    key: z.ZodString;
+    label: z.ZodString;
+}, z.core.$strict>;
+export type ConversationSidebarAnnotation = z.output<typeof conversationSidebarAnnotationSchema>;
+export interface ConversationSidebarHookContext extends PluginContext {
+    /** Stored annotations owned by this plugin, keyed by candidate conversation. */
+    annotationsByConversationId: Record<string, ConversationAnnotation[]>;
+    conversationIds: string[];
+}
+export interface ConversationSidebarResult {
+    annotationsByConversationId: Record<string, ConversationSidebarAnnotation[]>;
+}

package/dist/conversation-events.d.ts

@@ -2,8 +2,8 @@ import { z } from "zod";
 export declare const conversationEventIconSchema: z.ZodEnum<{
     check: "check";
     key: "key";
-    warning: "warning";
     link: "link";
+    warning: "warning";
     activity: "activity";
     brain: "brain";
     calendar: "calendar";
@@ -22,8 +22,8 @@ export declare const conversationEventPresentationSchema: z.ZodObject<{
     icon: z.ZodOptional<z.ZodEnum<{
         check: "check";
         key: "key";
-        warning: "warning";
         link: "link";
+        warning: "warning";
         activity: "activity";
         brain: "brain";
         calendar: "calendar";

package/dist/hooks.d.ts

@@ -1,8 +1,14 @@
+import type { ConversationSidebarHookContext, ConversationSidebarResult } from "./annotations";
 import type { EgressHookContext, EgressResponseHookContext, IssueCredentialHookContext, PluginCredentialResult, PluginGrant, PluginProviderAccount, ResolveOAuthAccountHookContext } from "./credentials";
-import type { HeartbeatHookContext, HeartbeatResult, OperationalReportHookContext, ApiRouteRegistrationHookContext, PluginOperationalReportContent, PluginRoute, PluginRouteApp, RouteRegistrationHookContext, SlackConversationLink, SlackConversationLinkHookContext, UnfinishedWorkHookContext, UnfinishedWorkResult } from "./operations";
+import type { HeartbeatHookContext, HeartbeatResult, OperationalReportHookContext, ProfileReportHookContext, ApiRouteRegistrationHookContext, PluginOperationalReportContent, PluginRoute, PluginRouteApp, RouteRegistrationHookContext, SlackConversationLink, SlackConversationLinkHookContext, UnfinishedWorkHookContext, UnfinishedWorkResult } from "./operations";
 import type { AfterMcpToolHookContext, BeforeToolExecuteHookContext, PluginToolDefinition, SandboxPrepareHookContext, ToolRegistrationHookContext } from "./tools";
 import type { PromptMessage, SystemPromptContext, UserPromptContext, UserPromptContribution } from "./prompt";
+/** Input for a pure Markdown rewrite before destination delivery formatting. */
+export interface FormatMarkdownHookContext {
+    text: string;
+}
 export interface PluginHooks {
+    conversationSidebar?(ctx: ConversationSidebarHookContext): Promise<ConversationSidebarResult> | ConversationSidebarResult;
     systemPrompt?(ctx: SystemPromptContext): Promise<PromptMessage[]> | PromptMessage[];
     userPrompt?(ctx: UserPromptContext): Promise<UserPromptContribution[] | undefined> | UserPromptContribution[] | undefined;
     beforeToolExecute?(ctx: BeforeToolExecuteHookContext): Promise<void> | void;
@@ -19,11 +25,18 @@ export interface PluginHooks {
     issueCredential?(ctx: IssueCredentialHookContext): Promise<PluginCredentialResult> | PluginCredentialResult;
     onEgressResponse?(ctx: EgressResponseHookContext): Promise<void> | void;
     operationalReport?(ctx: OperationalReportHookContext): Promise<PluginOperationalReportContent | undefined> | PluginOperationalReportContent | undefined;
+    /**
+     * Return one person-scoped operational report for a profile page.
+     * Omit or return undefined when the plugin has nothing to show for the subject.
+     */
+    profileReport?(ctx: ProfileReportHookContext): Promise<PluginOperationalReportContent | undefined> | PluginOperationalReportContent | undefined;
     /** Return plugin-owned product API routes mounted under Junior's authenticated plugin namespace. */
     apiRoutes?(ctx: ApiRouteRegistrationHookContext): PluginRouteApp | undefined;
     resolveOAuthAccount?(ctx: ResolveOAuthAccountHookContext): Promise<PluginProviderAccount | undefined> | PluginProviderAccount | undefined;
     routes?(ctx: RouteRegistrationHookContext): PluginRoute[];
     sandboxPrepare?(ctx: SandboxPrepareHookContext): Promise<void> | void;
     slackConversationLink?(ctx: SlackConversationLinkHookContext): SlackConversationLink | undefined;
+    /** Pure Markdown rewrite. Emit ordinary Markdown only. */
+    formatMarkdown?(ctx: FormatMarkdownHookContext): string;
     tools?(ctx: ToolRegistrationHookContext): Record<string, PluginToolDefinition>;
 }

package/dist/index.js

@@ -19,6 +19,18 @@ var resourceLinkAnnotationSchema = z.object({
 var conversationAnnotationInputSchema = z.discriminatedUnion("kind", [
   resourceLinkAnnotationSchema
 ]);
+var conversationSidebarIconSchema = z.enum([
+  "circle-dot",
+  "circle-dashed",
+  "circle-x",
+  "git-merge",
+  "triangle-alert"
+]);
+var conversationSidebarAnnotationSchema = z.object({
+  icon: conversationSidebarIconSchema.optional(),
+  key: z.string().trim().min(1).max(256),
+  label: z.string().trim().min(1).max(256)
+}).strict();
 
 // src/conversation-events.ts
 import { z as z2 } from "zod";
@@ -849,6 +861,8 @@ export {
   conversationAnnotationInputSchema,
   conversationEventIconSchema,
   conversationEventPresentationSchema,
+  conversationSidebarAnnotationSchema,
+  conversationSidebarIconSchema,
   createLocalSource,
   createSlackSource,
   createWebSource,

package/dist/operations.d.ts

@@ -96,6 +96,15 @@ export interface OperationalReportHookContext extends PluginContext {
     nowMs: number;
     state: PluginReadState;
 }
+/** Read-only context for one person-scoped plugin report on a profile page. */
+export interface ProfileReportHookContext extends PluginContext {
+    nowMs: number;
+    state: PluginReadState;
+    /** Canonical user for the profile being viewed. */
+    subject: User;
+    /** Canonical user for the authenticated viewer. */
+    viewer: User;
+}
 export type PluginRouteMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS" | "ALL";
 export type PluginRouteHandler = {
     bivarianceHack(request: Request): Promise<Response> | Response;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sentry/junior-plugin-api",
-  "version": "0.160.0",
+  "version": "0.161.0",
   "private": false,
   "publishConfig": {
     "access": "public"

package/src/annotations.ts

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import type { PluginContext } from "./context";
 
 function usesHttpProtocol(value: string): boolean {
   try {
@@ -44,3 +45,35 @@ export interface PluginAnnotations {
 export interface PluginConversationAnnotations {
   forConversation(conversationId: string): PluginAnnotations;
 }
+
+export const conversationSidebarIconSchema = z.enum([
+  "circle-dot",
+  "circle-dashed",
+  "circle-x",
+  "git-merge",
+  "triangle-alert",
+]);
+
+export const conversationSidebarAnnotationSchema = z
+  .object({
+    icon: conversationSidebarIconSchema.optional(),
+    key: z.string().trim().min(1).max(256),
+    label: z.string().trim().min(1).max(256),
+  })
+  .strict();
+export type ConversationSidebarAnnotation = z.output<
+  typeof conversationSidebarAnnotationSchema
+>;
+
+export interface ConversationSidebarHookContext extends PluginContext {
+  /** Stored annotations owned by this plugin, keyed by candidate conversation. */
+  annotationsByConversationId: Record<string, ConversationAnnotation[]>;
+  conversationIds: string[];
+}
+
+export interface ConversationSidebarResult {
+  annotationsByConversationId: Record<
+    string,
+    ConversationSidebarAnnotation[]
+  >;
+}

package/src/hooks.ts

@@ -1,3 +1,7 @@
+import type {
+  ConversationSidebarHookContext,
+  ConversationSidebarResult,
+} from "./annotations";
 import type {
   EgressHookContext,
   EgressResponseHookContext,
@@ -11,6 +15,7 @@ import type {
   HeartbeatHookContext,
   HeartbeatResult,
   OperationalReportHookContext,
+  ProfileReportHookContext,
   ApiRouteRegistrationHookContext,
   PluginOperationalReportContent,
   PluginRoute,
@@ -35,7 +40,15 @@ import type {
   UserPromptContribution,
 } from "./prompt";
 
+/** Input for a pure Markdown rewrite before destination delivery formatting. */
+export interface FormatMarkdownHookContext {
+  text: string;
+}
+
 export interface PluginHooks {
+  conversationSidebar?(
+    ctx: ConversationSidebarHookContext,
+  ): Promise<ConversationSidebarResult> | ConversationSidebarResult;
   systemPrompt?(
     ctx: SystemPromptContext,
   ): Promise<PromptMessage[]> | PromptMessage[];
@@ -72,6 +85,16 @@ export interface PluginHooks {
     | Promise<PluginOperationalReportContent | undefined>
     | PluginOperationalReportContent
     | undefined;
+  /**
+   * Return one person-scoped operational report for a profile page.
+   * Omit or return undefined when the plugin has nothing to show for the subject.
+   */
+  profileReport?(
+    ctx: ProfileReportHookContext,
+  ):
+    | Promise<PluginOperationalReportContent | undefined>
+    | PluginOperationalReportContent
+    | undefined;
   /** Return plugin-owned product API routes mounted under Junior's authenticated plugin namespace. */
   apiRoutes?(ctx: ApiRouteRegistrationHookContext): PluginRouteApp | undefined;
   resolveOAuthAccount?(
@@ -85,6 +108,8 @@ export interface PluginHooks {
   slackConversationLink?(
     ctx: SlackConversationLinkHookContext,
   ): SlackConversationLink | undefined;
+  /** Pure Markdown rewrite. Emit ordinary Markdown only. */
+  formatMarkdown?(ctx: FormatMarkdownHookContext): string;
   tools?(
     ctx: ToolRegistrationHookContext,
   ): Record<string, PluginToolDefinition>;

package/src/operations.ts

@@ -113,6 +113,16 @@ export interface OperationalReportHookContext extends PluginContext {
   state: PluginReadState;
 }
 
+/** Read-only context for one person-scoped plugin report on a profile page. */
+export interface ProfileReportHookContext extends PluginContext {
+  nowMs: number;
+  state: PluginReadState;
+  /** Canonical user for the profile being viewed. */
+  subject: User;
+  /** Canonical user for the authenticated viewer. */
+  viewer: User;
+}
+
 export type PluginRouteMethod =
   | "GET"
   | "POST"