@sentry/junior-plugin-api 0.258.0 → 0.260.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;
@@ -2380,11 +2415,39 @@ export interface PluginMcpConfig {
   /** Provider tools hidden from the model and callable only by plugin-owned wrapper tools. */
   wrappedTools?: string[];
 }
+/**
+ * Which provider accounts Junior may use for one plugin.
+ *
+ * By default, each Actor connects their own account with per-actor OAuth.
+ * A plugin can also allow an optional install-wide service account, often a
+ * bot. An Admin connects it one time on the dashboard Admin page.
+ *
+ * An Actor's own connection always wins. An Actor without their own
+ * connection uses the service account for what it lists. Other requests ask
+ * the Actor to connect their own account.
+ *
+ * With `userOAuth: false`, Junior uses only the service account. It never
+ * asks an Actor to connect, ignores their own connections, and hides tools
+ * that the service account does not list. Until an Admin connects the
+ * account, the plugin is not available.
+ */
+export interface PluginAccountsConfig {
+  /** Set false to turn off per-actor OAuth for the plugin. Defaults to true. */
+  userOAuth?: boolean;
+  /** Optional service account and what it may use. Omit for none. */
+  serviceAccount?: PluginServiceAccountConfig;
+}
+/** What one plugin's service account may use. */
+export interface PluginServiceAccountConfig {
+  /** MCP tools that the account may call. Each must be loaded by `mcp`. */
+  tools: string[];
+}
 export interface PluginEnvVarDeclaration {
   default?: string;
   exposeToCommandEnv?: boolean;
 }
 export interface PluginManifest {
+  accounts?: PluginAccountsConfig;
   apiHeaders?: Record<string, string>;
   commandEnv?: Record<string, string>;
   configKeys?: string[];

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.258.0",
+  "version": "0.260.0",
   "private": false,
   "publishConfig": {
     "access": "public"