@sentry/junior-plugin-api 0.122.0 → 0.122.1

package/dist/hooks.d.ts

@@ -1,11 +1,18 @@
 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 { BeforeToolExecuteHookContext, PluginToolDefinition, SandboxPrepareHookContext, ToolRegistrationHookContext } from "./tools";
+import type { AfterMcpToolHookContext, BeforeToolExecuteHookContext, PluginToolDefinition, SandboxPrepareHookContext, ToolRegistrationHookContext } from "./tools";
 import type { PromptMessage, SystemPromptContext, UserPromptContext, UserPromptContribution } from "./prompt";
 export interface PluginHooks {
     systemPrompt?(ctx: SystemPromptContext): Promise<PromptMessage[]> | PromptMessage[];
     userPrompt?(ctx: UserPromptContext): Promise<UserPromptContribution[] | undefined> | UserPromptContribution[] | undefined;
     beforeToolExecute?(ctx: BeforeToolExecuteHookContext): Promise<void> | void;
+    /**
+     * Run after a successful hosted MCP tool call.
+     *
+     * Prefer this for junior-owned side effects such as conversation annotations.
+     * Do not use it to invent a parallel tool contract for the provider tool.
+     */
+    afterMcpTool?(ctx: AfterMcpToolHookContext): Promise<void> | void;
     grantForEgress?(ctx: EgressHookContext): Promise<PluginGrant | undefined> | PluginGrant | undefined;
     heartbeat?(ctx: HeartbeatHookContext): Promise<HeartbeatResult | void> | HeartbeatResult | void;
     issueCredential?(ctx: IssueCredentialHookContext): Promise<PluginCredentialResult> | PluginCredentialResult;

package/dist/tools.d.ts

@@ -123,6 +123,29 @@ export interface BeforeToolExecuteHookContext extends PluginContext {
         name: string;
     };
 }
+/**
+ * Context for post-success MCP tool processing.
+ *
+ * Runs after a hosted MCP tool succeeds on the model-facing path. Use for
+ * junior-owned side effects such as conversation annotations without replacing
+ * the provider tool contract.
+ */
+export interface AfterMcpToolHookContext extends PluginContext {
+    /**
+     * Opaque Junior conversation/session identity for this turn.
+     * Interactive Slack turns use `slack:{channelId}:{threadTs}`.
+     */
+    conversationId?: string;
+    annotations?: PluginAnnotations;
+    result: {
+        structuredContent?: unknown;
+    };
+    tool: {
+        arguments: Record<string, unknown>;
+        /** Provider-local MCP tool name, for example `save_issue`. */
+        name: string;
+    };
+}
 export interface PluginToolExecuteOptions {
     /**
      * @deprecated Internal compatibility escape hatch for legacy tool bridges.

package/package.json

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

package/src/hooks.ts

@@ -20,6 +20,7 @@ import type {
   SlackConversationLinkHookContext,
 } from "./operations";
 import type {
+  AfterMcpToolHookContext,
   BeforeToolExecuteHookContext,
   PluginToolDefinition,
   SandboxPrepareHookContext,
@@ -43,6 +44,13 @@ export interface PluginHooks {
     | UserPromptContribution[]
     | undefined;
   beforeToolExecute?(ctx: BeforeToolExecuteHookContext): Promise<void> | void;
+  /**
+   * Run after a successful hosted MCP tool call.
+   *
+   * Prefer this for junior-owned side effects such as conversation annotations.
+   * Do not use it to invent a parallel tool contract for the provider tool.
+   */
+  afterMcpTool?(ctx: AfterMcpToolHookContext): Promise<void> | void;
   grantForEgress?(
     ctx: EgressHookContext,
   ): Promise<PluginGrant | undefined> | PluginGrant | undefined;

package/src/tools.ts

@@ -153,6 +153,30 @@ export interface BeforeToolExecuteHookContext extends PluginContext {
   };
 }
 
+/**
+ * Context for post-success MCP tool processing.
+ *
+ * Runs after a hosted MCP tool succeeds on the model-facing path. Use for
+ * junior-owned side effects such as conversation annotations without replacing
+ * the provider tool contract.
+ */
+export interface AfterMcpToolHookContext extends PluginContext {
+  /**
+   * Opaque Junior conversation/session identity for this turn.
+   * Interactive Slack turns use `slack:{channelId}:{threadTs}`.
+   */
+  conversationId?: string;
+  annotations?: PluginAnnotations;
+  result: {
+    structuredContent?: unknown;
+  };
+  tool: {
+    arguments: Record<string, unknown>;
+    /** Provider-local MCP tool name, for example `save_issue`. */
+    name: string;
+  };
+}
+
 export interface PluginToolExecuteOptions {
   /**
    * @deprecated Internal compatibility escape hatch for legacy tool bridges.