@sentry/junior-plugin-api 0.114.0 → 0.115.0

package/dist/index.js

@@ -271,6 +271,7 @@ var pluginToolResultSchema = z5.object({
   continuation: pluginToolContinuationSchema.optional(),
   error: z5.union([pluginToolErrorSchema, z5.string()]).optional()
 }).passthrough();
+var toolApprovalModeSchema = z5.enum(["auto", "review", "approve"]);
 function formatZodPath(path) {
   return path.length > 0 ? path.map(String).join(".") : "root";
 }
@@ -505,5 +506,6 @@ export {
   sourceTypeSchema,
   subscribableResourceSchema,
   systemActorSchema,
+  toolApprovalModeSchema,
   zodTool
 };

package/dist/tools.d.ts

@@ -108,7 +108,25 @@ export type PluginToolResult = z.output<typeof pluginToolResultSchema>;
 export type PluginToolExecute<TInput = unknown, TOutput = unknown> = {
     bivarianceHack(input: TInput, options: PluginToolExecuteOptions): Promise<TOutput> | TOutput;
 }["bivarianceHack"];
+/**
+ * Tool-declared approval mode.
+ *
+ * `auto` delegates to core policy, `review` enters approval review, and
+ * `approve` permits execution without review. Omission delegates to core
+ * defaults. These values do not select the reviewer.
+ *
+ * This is declaration metadata only; current tool execution is unchanged.
+ * TODO(#1053): Enforce effective approval modes before tool execution.
+ */
+export declare const toolApprovalModeSchema: z.ZodEnum<{
+    auto: "auto";
+    review: "review";
+    approve: "approve";
+}>;
+export type ToolApprovalMode = z.output<typeof toolApprovalModeSchema>;
 export interface PluginToolDefinition<TInput = unknown, TOutput = unknown> {
+    /** Optional declared approval mode; omission delegates to core defaults. */
+    approvalMode?: ToolApprovalMode;
     annotations?: unknown;
     description: string;
     executionMode?: unknown;

package/package.json

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

package/src/tools.ts

@@ -129,7 +129,23 @@ export type PluginToolExecute<TInput = unknown, TOutput = unknown> = {
   ): Promise<TOutput> | TOutput;
 }["bivarianceHack"];
 
+/**
+ * Tool-declared approval mode.
+ *
+ * `auto` delegates to core policy, `review` enters approval review, and
+ * `approve` permits execution without review. Omission delegates to core
+ * defaults. These values do not select the reviewer.
+ *
+ * This is declaration metadata only; current tool execution is unchanged.
+ * TODO(#1053): Enforce effective approval modes before tool execution.
+ */
+export const toolApprovalModeSchema = z.enum(["auto", "review", "approve"]);
+
+export type ToolApprovalMode = z.output<typeof toolApprovalModeSchema>;
+
 export interface PluginToolDefinition<TInput = unknown, TOutput = unknown> {
+  /** Optional declared approval mode; omission delegates to core defaults. */
+  approvalMode?: ToolApprovalMode;
   annotations?: unknown;
   description: string;
   executionMode?: unknown;