@sentry/junior-plugin-api 0.259.0 → 0.261.0

package/README.md

@@ -48,6 +48,12 @@ reports, and other typed hook surfaces exported by this package.
 - Prompt hooks return bounded structured prompt messages rather than mutate the
   core prompt.
 - `formatMarkdown` is a pure text rewrite into ordinary Markdown before delivery.
+- `conversationTitleContext` returns short facts about objects that the first
+  human message refers to, such as an issue number and title. The hook gets the
+  plugin's config values, such as a default repository. It must read provider
+  data through `ctx.egress`, which uses Junior's system identity and never
+  starts authorization. Only the title model sees the facts. Junior bounds the
+  wait and ignores a failed hook.
 - 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.

package/dist/index.d.ts

@@ -1164,6 +1164,12 @@ export declare const eventInputSchema: z.ZodObject<{
   }, z.core.$strict>, z.ZodObject<{
     email: z.ZodString;
   }, z.core.$strict>]>>>;
+  doneBy: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+    provider: z.ZodString;
+    handle: z.ZodString;
+  }, z.core.$strict>, z.ZodObject<{
+    email: z.ZodString;
+  }, z.core.$strict>]>>;
 }, z.core.$strict>;
 export type EventData = z.output<typeof eventDataSchema>;
 export type EventInput = z.output<typeof eventInputSchema>;
@@ -1190,6 +1196,12 @@ export declare const eventSchema: z.ZodObject<{
   }, z.core.$strict>, z.ZodObject<{
     email: z.ZodString;
   }, z.core.$strict>]>>>;
+  doneBy: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+    provider: z.ZodString;
+    handle: z.ZodString;
+  }, z.core.$strict>, z.ZodObject<{
+    email: z.ZodString;
+  }, z.core.$strict>]>>;
   namespace: z.ZodString;
 }, z.core.$strict>;
 export type Event = z.output<typeof eventSchema>;
@@ -2227,7 +2239,30 @@ export declare function enforceEgressPolicy(input: {
 export interface FormatMarkdownHookContext {
   text: string;
 }
+/** First human message of a new Conversation, given before title generation. */
+export interface ConversationTitleContextHookContext extends PluginContext {
+  /**
+   * String config values of this plugin for the Conversation's Location, by
+   * short key. For example, `repo` for the `github.repo` config key.
+   */
+  config: Record<string, string>;
+  /**
+   * Host-owned provider egress for title reads. It uses Junior's system
+   * identity, so it never uses a user's credentials or starts authorization.
+   */
+  egress: PluginEgress;
+  /** Ends the hook when the host stops waiting for title context. */
+  signal: AbortSignal;
+  text: string;
+}
 export interface PluginHooks {
+  /**
+   * Return short facts that help name a new Conversation, such as
+   * `owner/repo#123: Issue title` for a linked issue. Junior shows these facts
+   * only to the title model. Return nothing when the message has no known
+   * objects.
+   */
+  conversationTitleContext?(ctx: ConversationTitleContextHookContext): Promise<string[] | undefined> | string[] | undefined;
   conversationSidebar?(ctx: ConversationSidebarHookContext): Promise<ConversationSidebarResult> | ConversationSidebarResult;
   systemPrompt?(ctx: SystemPromptContext): Promise<PromptMessage[]> | PromptMessage[];
   userPrompt?(ctx: UserPromptContext): Promise<UserPromptContribution[] | undefined> | UserPromptContribution[] | undefined;

package/dist/index.js

@@ -847,7 +847,13 @@ const eventInputSchema = z.object({
 	data: eventDataSchema.optional(),
 	untrustedText: z.string().transform((value) => value.slice(0, EVENT_TEXT_MAX_LENGTH)).optional(),
 	/** People involved in the change. Watch Events list them as mentions. */
-	people: z.array(eventPersonSchema).max(20).optional()
+	people: z.array(eventPersonSchema).max(20).optional(),
+	/**
+	* The person who did what the Event describes, such as a reviewer or a
+	* commenter. Core resolves them like `people`, so the agent knows when a
+	* mention and a provider name are the same person.
+	*/
+	doneBy: eventPersonSchema.optional()
 }).strict();
 const eventSchema = eventInputSchema.extend({ namespace: z.string().min(1) });
 // src/tasks.ts

package/package.json

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