@sentry/junior-plugin-api 0.145.0 → 0.147.0

package/dist/credentials.d.ts

@@ -10,6 +10,8 @@ export declare const pluginAuthorizationSchema: z.ZodObject<{
 }, z.core.$strict>;
 /** Runtime schema for a provider account attached to stored OAuth tokens. */
 export declare const pluginProviderAccountSchema: z.ZodObject<{
+    displayName: z.ZodOptional<z.ZodString>;
+    handle: z.ZodOptional<z.ZodString>;
     id: z.ZodString;
     label: z.ZodOptional<z.ZodString>;
     url: z.ZodOptional<z.ZodString>;
@@ -17,6 +19,8 @@ export declare const pluginProviderAccountSchema: z.ZodObject<{
 /** Runtime schema for OAuth tokens stored by the host for plugin credentials. */
 export declare const pluginStoredTokensSchema: z.ZodObject<{
     account: z.ZodOptional<z.ZodObject<{
+        displayName: z.ZodOptional<z.ZodString>;
+        handle: z.ZodOptional<z.ZodString>;
         id: z.ZodString;
         label: z.ZodOptional<z.ZodString>;
         url: z.ZodOptional<z.ZodString>;
@@ -43,6 +47,8 @@ export declare const pluginCredentialHeaderTransformSchema: z.ZodObject<{
 /** Runtime schema for a short-lived plugin-issued credential lease. */
 export declare const pluginCredentialLeaseSchema: z.ZodObject<{
     account: z.ZodOptional<z.ZodObject<{
+        displayName: z.ZodOptional<z.ZodString>;
+        handle: z.ZodOptional<z.ZodString>;
         id: z.ZodString;
         label: z.ZodOptional<z.ZodString>;
         url: z.ZodOptional<z.ZodString>;
@@ -62,6 +68,8 @@ export declare const pluginCredentialLeaseSchema: z.ZodObject<{
 export declare const pluginCredentialResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     lease: z.ZodObject<{
         account: z.ZodOptional<z.ZodObject<{
+            displayName: z.ZodOptional<z.ZodString>;
+            handle: z.ZodOptional<z.ZodString>;
             id: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
             url: z.ZodOptional<z.ZodString>;

package/dist/index.js

@@ -293,6 +293,24 @@ function definePromptContext(definition) {
 import { z as z5 } from "zod";
 var RESOURCE_EVENT_SUMMARY_MAX_LENGTH = 4e3;
 var RESOURCE_EVENT_TEXT_MAX_LENGTH = 8e3;
+var RESOURCE_EVENT_DATA_MAX_KEYS = 32;
+var RESOURCE_EVENT_DATA_MAX_JSON_BYTES = 4e3;
+var resourceEventDataSchema = z5.record(z5.string(), z5.unknown()).superRefine((value, context) => {
+  const keys = Object.keys(value);
+  if (keys.length > RESOURCE_EVENT_DATA_MAX_KEYS) {
+    context.addIssue({
+      code: "custom",
+      message: `Resource event data may include at most ${RESOURCE_EVENT_DATA_MAX_KEYS} keys.`
+    });
+  }
+  const jsonBytes = new TextEncoder().encode(JSON.stringify(value)).byteLength;
+  if (jsonBytes > RESOURCE_EVENT_DATA_MAX_JSON_BYTES) {
+    context.addIssue({
+      code: "custom",
+      message: `Resource event data may be at most ${RESOURCE_EVENT_DATA_MAX_JSON_BYTES} JSON bytes.`
+    });
+  }
+});
 var resourceEventTypeSchema = z5.string().regex(/^[a-z][a-z0-9_-]*(?:\.[a-z][a-z0-9_-]*)+$/).describe(
   "Canonical dotted event type, such as issue.closed or pull_request.review.changes_requested."
 );
@@ -374,6 +392,8 @@ var resourceEventInputSchema = z5.object({
   occurredAtMs: z5.number().finite(),
   terminal: z5.boolean().optional(),
   trustedSummary: z5.string().min(1).transform((value) => value.slice(0, RESOURCE_EVENT_SUMMARY_MAX_LENGTH)),
+  /** Trusted structured facts. Prefer ids and urls over long prose. */
+  data: resourceEventDataSchema.optional(),
   untrustedText: z5.string().transform((value) => value.slice(0, RESOURCE_EVENT_TEXT_MAX_LENGTH)).optional()
 }).strict();
 var resourceEventSchema = resourceEventInputSchema.extend({
@@ -562,6 +582,8 @@ var pluginAuthorizationSchema = z9.object({
   type: z9.literal("oauth")
 }).strict();
 var pluginProviderAccountSchema = z9.object({
+  displayName: nonBlankStringSchema.optional(),
+  handle: nonBlankStringSchema.optional(),
   id: nonBlankStringSchema,
   label: nonBlankStringSchema.optional(),
   url: nonBlankStringSchema.optional()
@@ -789,6 +811,8 @@ export {
   EgressPolicyDenied,
   PluginToolInputError,
   REQUIRED_TOOL_ANNOTATION_KEYS,
+  RESOURCE_EVENT_DATA_MAX_JSON_BYTES,
+  RESOURCE_EVENT_DATA_MAX_KEYS,
   RESOURCE_EVENT_SUMMARY_MAX_LENGTH,
   RESOURCE_EVENT_TEXT_MAX_LENGTH,
   actorSchema,
@@ -839,6 +863,7 @@ export {
   promptContextSchema,
   promptMessageSchema,
   replyAttributionSchema,
+  resourceEventDataSchema,
   resourceEventInputSchema,
   resourceEventSchema,
   resourceEventTypeSchema,

package/dist/resource-events.d.ts

@@ -1,6 +1,10 @@
 import { z } from "zod";
 export declare const RESOURCE_EVENT_SUMMARY_MAX_LENGTH = 4000;
 export declare const RESOURCE_EVENT_TEXT_MAX_LENGTH = 8000;
+export declare const RESOURCE_EVENT_DATA_MAX_KEYS = 32;
+export declare const RESOURCE_EVENT_DATA_MAX_JSON_BYTES = 4000;
+/** Small trusted facts from the plugin. The agent should not look these up again. */
+export declare const resourceEventDataSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
 /** Canonical dotted event type published and selected across plugins. */
 export declare const resourceEventTypeSchema: z.ZodString;
 export declare const resourceTypeSchema: z.ZodString;
@@ -38,8 +42,10 @@ export declare const resourceEventInputSchema: z.ZodObject<{
     occurredAtMs: z.ZodNumber;
     terminal: z.ZodOptional<z.ZodBoolean>;
     trustedSummary: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     untrustedText: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
 }, z.core.$strict>;
+export type ResourceEventData = z.output<typeof resourceEventDataSchema>;
 export type ResourceEventInput = z.output<typeof resourceEventInputSchema>;
 export declare const resourceEventSchema: z.ZodObject<{
     eventKey: z.ZodString;
@@ -48,6 +54,7 @@ export declare const resourceEventSchema: z.ZodObject<{
     occurredAtMs: z.ZodNumber;
     terminal: z.ZodOptional<z.ZodBoolean>;
     trustedSummary: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     untrustedText: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
     namespace: z.ZodString;
 }, z.core.$strict>;

package/package.json

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

package/src/credentials.ts

@@ -21,6 +21,8 @@ export const pluginAuthorizationSchema = z
 /** Runtime schema for a provider account attached to stored OAuth tokens. */
 export const pluginProviderAccountSchema = z
   .object({
+    displayName: nonBlankStringSchema.optional(),
+    handle: nonBlankStringSchema.optional(),
     id: nonBlankStringSchema,
     label: nonBlankStringSchema.optional(),
     url: nonBlankStringSchema.optional(),

package/src/resource-events.ts

@@ -2,6 +2,28 @@ import { z } from "zod";
 
 export const RESOURCE_EVENT_SUMMARY_MAX_LENGTH = 4_000;
 export const RESOURCE_EVENT_TEXT_MAX_LENGTH = 8_000;
+export const RESOURCE_EVENT_DATA_MAX_KEYS = 32;
+export const RESOURCE_EVENT_DATA_MAX_JSON_BYTES = 4_000;
+
+/** Small trusted facts from the plugin. The agent should not look these up again. */
+export const resourceEventDataSchema = z
+  .record(z.string(), z.unknown())
+  .superRefine((value, context) => {
+    const keys = Object.keys(value);
+    if (keys.length > RESOURCE_EVENT_DATA_MAX_KEYS) {
+      context.addIssue({
+        code: "custom",
+        message: `Resource event data may include at most ${RESOURCE_EVENT_DATA_MAX_KEYS} keys.`,
+      });
+    }
+    const jsonBytes = new TextEncoder().encode(JSON.stringify(value)).byteLength;
+    if (jsonBytes > RESOURCE_EVENT_DATA_MAX_JSON_BYTES) {
+      context.addIssue({
+        code: "custom",
+        message: `Resource event data may be at most ${RESOURCE_EVENT_DATA_MAX_JSON_BYTES} JSON bytes.`,
+      });
+    }
+  });
 
 /** Canonical dotted event type published and selected across plugins. */
 export const resourceEventTypeSchema = z
@@ -124,6 +146,8 @@ export const resourceEventInputSchema = z
       .string()
       .min(1)
       .transform((value) => value.slice(0, RESOURCE_EVENT_SUMMARY_MAX_LENGTH)),
+    /** Trusted structured facts. Prefer ids and urls over long prose. */
+    data: resourceEventDataSchema.optional(),
     untrustedText: z
       .string()
       .transform((value) => value.slice(0, RESOURCE_EVENT_TEXT_MAX_LENGTH))
@@ -131,6 +155,7 @@ export const resourceEventInputSchema = z
   })
   .strict();
 
+export type ResourceEventData = z.output<typeof resourceEventDataSchema>;
 export type ResourceEventInput = z.output<typeof resourceEventInputSchema>;
 
 export const resourceEventSchema = resourceEventInputSchema.extend({