@sentry/junior-plugin-api 0.162.0 → 0.164.0

package/dist/hooks.d.ts

@@ -1,7 +1,7 @@
 import type { ConversationSidebarHookContext, ConversationSidebarResult } from "./annotations";
 import type { EgressHookContext, EgressResponseHookContext, IssueCredentialHookContext, PluginCredentialResult, PluginGrant, PluginProviderAccount, ResolveOAuthAccountHookContext } from "./credentials";
 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 { AfterMcpToolHookContext, BeforeToolExecuteHookContext, PluginToolDefinition, SandboxPrepareHookContext, ToolRegistrationHookContext, WorkspacePrepareHookContext } from "./tools";
 import type { PromptMessage, SystemPromptContext, UserPromptContext, UserPromptContribution } from "./prompt";
 /** Input for a pure Markdown rewrite before destination delivery formatting. */
 export interface FormatMarkdownHookContext {
@@ -35,6 +35,7 @@ export interface PluginHooks {
     resolveOAuthAccount?(ctx: ResolveOAuthAccountHookContext): Promise<PluginProviderAccount | undefined> | PluginProviderAccount | undefined;
     routes?(ctx: RouteRegistrationHookContext): PluginRoute[];
     sandboxPrepare?(ctx: SandboxPrepareHookContext): Promise<void> | void;
+    workspacePrepare?(ctx: WorkspacePrepareHookContext): Promise<void> | void;
     slackConversationLink?(ctx: SlackConversationLinkHookContext): SlackConversationLink | undefined;
     /** Pure Markdown rewrite. Emit ordinary Markdown only. */
     formatMarkdown?(ctx: FormatMarkdownHookContext): string;

package/dist/tools.d.ts

@@ -109,6 +109,14 @@ export interface PluginMcp {
      */
     prepare(): Promise<"authorization_pending" | "ready">;
 }
+/** Provider-owned repository preparation for one Workspace snapshot build. */
+export interface WorkspacePrepareHookContext extends PluginContext {
+    repos: Array<{
+        path: string;
+        repo: string;
+    }>;
+    sandbox: PluginSandbox;
+}
 export interface SandboxPrepareHookContext extends PluginContext {
     actor?: Actor;
     sandbox: PluginSandbox;
@@ -281,6 +289,13 @@ export interface PluginResourceEventToolContext {
     /** Whether this invocation can create a working resource-event subscription. */
     canSubscribe: boolean;
 }
+export interface PluginWorkspaceToolContext {
+    /** Find named Workspaces that include one provider repository. */
+    findByRepository(input: {
+        provider: string;
+        repo: string;
+    }): Promise<string[]>;
+}
 interface BaseToolRegistrationHookContext extends PluginContext {
     /**
      * Opaque Junior conversation/session identity for this turn.
@@ -306,6 +321,7 @@ interface BaseToolRegistrationHookContext extends PluginContext {
         } | undefined>;
     };
     userText?: string;
+    workspaces: PluginWorkspaceToolContext;
 }
 interface SlackToolRegistrationContext extends BaseToolRegistrationHookContext, SlackInvocationContext {
     slack: SlackToolRegistrationHookContext;

package/package.json

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

package/src/hooks.ts

@@ -32,6 +32,7 @@ import type {
   PluginToolDefinition,
   SandboxPrepareHookContext,
   ToolRegistrationHookContext,
+  WorkspacePrepareHookContext,
 } from "./tools";
 import type {
   PromptMessage,
@@ -105,6 +106,7 @@ export interface PluginHooks {
     | undefined;
   routes?(ctx: RouteRegistrationHookContext): PluginRoute[];
   sandboxPrepare?(ctx: SandboxPrepareHookContext): Promise<void> | void;
+  workspacePrepare?(ctx: WorkspacePrepareHookContext): Promise<void> | void;
   slackConversationLink?(
     ctx: SlackConversationLinkHookContext,
   ): SlackConversationLink | undefined;

package/src/tools.ts

@@ -140,6 +140,15 @@ export interface PluginMcp {
   prepare(): Promise<"authorization_pending" | "ready">;
 }
 
+/** Provider-owned repository preparation for one Workspace snapshot build. */
+export interface WorkspacePrepareHookContext extends PluginContext {
+  repos: Array<{
+    path: string;
+    repo: string;
+  }>;
+  sandbox: PluginSandbox;
+}
+
 export interface SandboxPrepareHookContext extends PluginContext {
   actor?: Actor;
   sandbox: PluginSandbox;
@@ -511,6 +520,14 @@ export interface PluginResourceEventToolContext {
   canSubscribe: boolean;
 }
 
+export interface PluginWorkspaceToolContext {
+  /** Find named Workspaces that include one provider repository. */
+  findByRepository(input: {
+    provider: string;
+    repo: string;
+  }): Promise<string[]>;
+}
+
 interface BaseToolRegistrationHookContext extends PluginContext {
   /**
    * Opaque Junior conversation/session identity for this turn.
@@ -533,6 +550,7 @@ interface BaseToolRegistrationHookContext extends PluginContext {
     resolveActor(): Promise<{ identity: Identity; user?: User } | undefined>;
   };
   userText?: string;
+  workspaces: PluginWorkspaceToolContext;
 }
 
 interface SlackToolRegistrationContext