@sentry/junior-plugin-api 0.154.0 → 0.155.0

package/dist/hooks.d.ts

@@ -1,5 +1,5 @@
 import type { EgressHookContext, EgressResponseHookContext, IssueCredentialHookContext, PluginCredentialResult, PluginGrant, PluginProviderAccount, ResolveOAuthAccountHookContext } from "./credentials";
-import type { HeartbeatHookContext, HeartbeatResult, OperationalReportHookContext, ApiRouteRegistrationHookContext, PluginOperationalReportContent, PluginRoute, PluginRouteApp, RouteRegistrationHookContext, SlackConversationLink, SlackConversationLinkHookContext } from "./operations";
+import type { HeartbeatHookContext, HeartbeatResult, OperationalReportHookContext, 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";
 export interface PluginHooks {
@@ -15,6 +15,7 @@ export interface PluginHooks {
     afterMcpTool?(ctx: AfterMcpToolHookContext): Promise<void> | void;
     grantForEgress?(ctx: EgressHookContext): Promise<PluginGrant | undefined> | PluginGrant | undefined;
     heartbeat?(ctx: HeartbeatHookContext): Promise<HeartbeatResult | void> | HeartbeatResult | void;
+    unfinishedWork?(ctx: UnfinishedWorkHookContext): Promise<UnfinishedWorkResult> | UnfinishedWorkResult;
     issueCredential?(ctx: IssueCredentialHookContext): Promise<PluginCredentialResult> | PluginCredentialResult;
     onEgressResponse?(ctx: EgressResponseHookContext): Promise<void> | void;
     operationalReport?(ctx: OperationalReportHookContext): Promise<PluginOperationalReportContent | undefined> | PluginOperationalReportContent | undefined;

package/dist/operations.d.ts

@@ -16,6 +16,14 @@ export interface HeartbeatHookContext extends PluginContext {
 export interface HeartbeatResult {
     dispatchCount?: number;
 }
+export interface UnfinishedWorkHookContext extends PluginContext {
+    /** Bounded conversation candidates selected by the host. */
+    conversationIds: string[];
+}
+export interface UnfinishedWorkResult {
+    /** Candidate conversations that have plugin-owned work to finish. */
+    conversationIds: string[];
+}
 export type PluginOperationalTone = "danger" | "good" | "neutral" | "warning";
 export interface PluginOperationalMetric {
     label: string;

package/package.json

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

package/src/hooks.ts

@@ -18,6 +18,8 @@ import type {
   RouteRegistrationHookContext,
   SlackConversationLink,
   SlackConversationLinkHookContext,
+  UnfinishedWorkHookContext,
+  UnfinishedWorkResult,
 } from "./operations";
 import type {
   AfterMcpToolHookContext,
@@ -57,6 +59,9 @@ export interface PluginHooks {
   heartbeat?(
     ctx: HeartbeatHookContext,
   ): Promise<HeartbeatResult | void> | HeartbeatResult | void;
+  unfinishedWork?(
+    ctx: UnfinishedWorkHookContext,
+  ): Promise<UnfinishedWorkResult> | UnfinishedWorkResult;
   issueCredential?(
     ctx: IssueCredentialHookContext,
   ): Promise<PluginCredentialResult> | PluginCredentialResult;

package/src/operations.ts

@@ -20,6 +20,16 @@ export interface HeartbeatResult {
   dispatchCount?: number;
 }
 
+export interface UnfinishedWorkHookContext extends PluginContext {
+  /** Bounded conversation candidates selected by the host. */
+  conversationIds: string[];
+}
+
+export interface UnfinishedWorkResult {
+  /** Candidate conversations that have plugin-owned work to finish. */
+  conversationIds: string[];
+}
+
 export type PluginOperationalTone = "danger" | "good" | "neutral" | "warning";
 
 export interface PluginOperationalMetric {