@sentry/junior-plugin-api 0.132.0 → 0.134.0

package/README.md

@@ -47,6 +47,9 @@ reports, and other typed hook surfaces exported by this package.
 - 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.
+- Tool registration hooks may use `ctx.sandbox` for plugin-owned workspace
+  files and commands; Junior still owns sandbox lifecycle, cancellation,
+  provider egress, and authorization recovery.
 - Host-owned structured model and embedding calls do not expose provider
   credentials to plugins. Both return a best-effort provider cost estimate when
   one is available.

package/dist/tools.d.ts

@@ -27,6 +27,7 @@ export interface PluginSandbox {
         cmd: string;
         cwd?: string;
         env?: Record<string, string>;
+        signal?: AbortSignal;
         sudo?: boolean;
     }): Promise<{
         exitCode: number;
@@ -152,6 +153,8 @@ export interface PluginToolExecuteOptions {
      * Plugin tools should use typed input fields and runtime hook context instead.
      */
     experimental_context?: unknown;
+    /** Abort when the owning agent tool call is cancelled or times out. */
+    signal?: AbortSignal;
     /** Stable runtime tool-call id; durable create tools should derive idempotency keys from it. */
     toolCallId?: string;
 }
@@ -292,6 +295,8 @@ interface BaseToolRegistrationHookContext extends PluginContext {
     mcp?: PluginMcp;
     model: PluginModel;
     resourceEvents: PluginResourceEventToolContext;
+    /** Sandbox filesystem and command capability for plugin-owned workspace tools. */
+    sandbox: PluginSandbox;
     state: PluginState;
     users: {
         /** Resolve the current actor's stored identity and linked user. */

package/package.json

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

package/src/tools.ts

@@ -41,6 +41,7 @@ export interface PluginSandbox {
     cmd: string;
     cwd?: string;
     env?: Record<string, string>;
+    signal?: AbortSignal;
     sudo?: boolean;
   }): Promise<{
     exitCode: number;
@@ -185,6 +186,8 @@ export interface PluginToolExecuteOptions {
    * Plugin tools should use typed input fields and runtime hook context instead.
    */
   experimental_context?: unknown;
+  /** Abort when the owning agent tool call is cancelled or times out. */
+  signal?: AbortSignal;
   /** Stable runtime tool-call id; durable create tools should derive idempotency keys from it. */
   toolCallId?: string;
 }
@@ -521,6 +524,8 @@ interface BaseToolRegistrationHookContext extends PluginContext {
   mcp?: PluginMcp;
   model: PluginModel;
   resourceEvents: PluginResourceEventToolContext;
+  /** Sandbox filesystem and command capability for plugin-owned workspace tools. */
+  sandbox: PluginSandbox;
   state: PluginState;
   users: {
     /** Resolve the current actor's stored identity and linked user. */