@sentry/junior-plugin-api 0.125.0 → 0.126.0

package/README.md

@@ -89,6 +89,9 @@ routing, response validation, rendering, confirmation, and query state.
   owns browser rendering.
 - `ctx.agent.dispatch` creates durable agent work with an explicit actor,
   destination, source, metadata, and idempotency identity.
+- Dispatches may include compact `replyAttribution` for destination-visible
+  context about what produced the reply. Core owns platform rendering; opaque
+  dispatch metadata remains internal.
 - Delegated credential subjects declare the narrow action that authorized them.
   Core owns runtime bindings; scheduler task subjects are accepted only from the
   scheduler plugin and are bound to the exact task id.

package/dist/context.d.ts

@@ -14,7 +14,7 @@ export type SlackSource = Extract<Source, {
 export type LocalSource = Extract<Source, {
     platform: "local";
 }>;
-export type SourceType = Source["type"];
+export type SourceVisibility = Source["visibility"];
 export type Destination = z.output<typeof destinationSchema>;
 export type SlackDestination = Extract<Destination, {
     platform: "slack";
@@ -91,7 +91,7 @@ export declare function createSlackSource(input: {
     teamId: string;
     threadTs?: string;
     /** Runtime-normalized source visibility. */
-    type: SourceType;
+    visibility: SourceVisibility;
 }): SlackSource;
 /** Build a normalized local source from a local conversation id. */
 export declare function createLocalSource(conversationId: string): LocalSource;

package/dist/dispatch.d.ts

@@ -1,7 +1,9 @@
 import { z } from "zod";
-import { destinationVisibilitySchema, dispatchOptionsSchema } from "./schemas";
+import { destinationVisibilitySchema, dispatchOptionsSchema, replyAttributionSchema } from "./schemas";
 export type DestinationVisibility = z.output<typeof destinationVisibilitySchema>;
 export type DispatchOptions = z.output<typeof dispatchOptionsSchema>;
+/** Compact destination-visible context explaining what produced a reply. */
+export type ReplyAttribution = z.output<typeof replyAttributionSchema>;
 export interface DispatchResult {
     id: string;
     status: "created" | "already_exists";

package/dist/index.js

@@ -84,7 +84,7 @@ var exactNonBlankStringSchema = nonBlankStringSchema.refine(
   (value) => value === value.trim()
 );
 var platformSchema = z3.enum(["slack", "local"]);
-var sourceTypeSchema = z3.enum(["pub", "priv"]);
+var sourceVisibilitySchema = z3.enum(["public", "private"]);
 var destinationVisibilitySchema = z3.enum(["public", "private"]);
 var slackAddressSchema = z3.object({
   platform: z3.literal("slack"),
@@ -101,13 +101,13 @@ var destinationSchema = z3.discriminatedUnion("platform", [
   localDestinationSchema
 ]);
 var slackSourceSchema = slackAddressSchema.extend({
-  type: sourceTypeSchema,
+  visibility: sourceVisibilitySchema,
   messageTs: nonBlankStringSchema.optional(),
   threadTs: nonBlankStringSchema.optional()
 }).strict();
 var localSourceSchema = z3.object({
   platform: z3.literal("local"),
-  type: z3.literal("priv"),
+  visibility: z3.literal("private"),
   conversationId: localConversationIdSchema
 }).strict();
 var sourceSchema = z3.discriminatedUnion("platform", [
@@ -202,6 +202,10 @@ var dispatchMetadataSchema = z3.record(z3.string(), z3.string()).superRefine((me
     }
   }
 });
+var replyAttributionSchema = z3.object({
+  label: exactNonBlankStringSchema.pipe(z3.string().max(48)).refine((value) => !/[\r\n]/.test(value)),
+  detail: exactNonBlankStringSchema.pipe(z3.string().max(128)).refine((value) => !/[\r\n]/.test(value)).optional()
+}).strict();
 var dispatchOptionsSchema = z3.object({
   idempotencyKey: nonBlankStringSchema.pipe(z3.string().max(512)),
   credentialSubject: pluginCredentialSubjectSchema.optional(),
@@ -209,6 +213,7 @@ var dispatchOptionsSchema = z3.object({
   destinationVisibility: destinationVisibilitySchema,
   input: nonBlankStringSchema.pipe(z3.string().max(32e3)),
   metadata: dispatchMetadataSchema.optional(),
+  replyAttribution: replyAttributionSchema.optional(),
   source: sourceSchema
 }).strict();
 
@@ -216,7 +221,7 @@ var dispatchOptionsSchema = z3.object({
 function createSlackSource(input) {
   return {
     platform: "slack",
-    type: input.type,
+    visibility: input.visibility,
     teamId: input.teamId,
     channelId: input.channelId,
     ...input.messageTs ? { messageTs: input.messageTs } : {},
@@ -226,12 +231,12 @@ function createSlackSource(input) {
 function createLocalSource(conversationId) {
   return {
     platform: "local",
-    type: "priv",
+    visibility: "private",
     conversationId
   };
 }
 function isPrivateSource(source) {
-  return source.type === "priv";
+  return source.visibility === "private";
 }
 function getSourceKey(source) {
   if (source.platform === "local") {
@@ -746,13 +751,14 @@ export {
   pluginUserPageLinksSchema,
   promptContextSchema,
   promptMessageSchema,
+  replyAttributionSchema,
   resourceEventSchema,
   resourceLinkAnnotationSchema,
   slackActorSchema,
   slackDestinationSchema,
   slackSourceSchema,
   sourceSchema,
-  sourceTypeSchema,
+  sourceVisibilitySchema,
   subscribableResourceSchema,
   systemActorSchema,
   toolApprovalModeSchema,

package/dist/schemas.d.ts

@@ -6,9 +6,9 @@ export declare const platformSchema: z.ZodEnum<{
     local: "local";
 }>;
 /** Runtime source visibility visible to plugins. */
-export declare const sourceTypeSchema: z.ZodEnum<{
-    pub: "pub";
-    priv: "priv";
+export declare const sourceVisibilitySchema: z.ZodEnum<{
+    public: "public";
+    private: "private";
 }>;
 /** Provider-neutral visibility of a routed destination. */
 export declare const destinationVisibilitySchema: z.ZodEnum<{
@@ -40,9 +40,9 @@ export declare const slackSourceSchema: z.ZodObject<{
     platform: z.ZodLiteral<"slack">;
     teamId: z.ZodString;
     channelId: z.ZodString;
-    type: z.ZodEnum<{
-        pub: "pub";
-        priv: "priv";
+    visibility: z.ZodEnum<{
+        public: "public";
+        private: "private";
     }>;
     messageTs: z.ZodOptional<z.ZodString>;
     threadTs: z.ZodOptional<z.ZodString>;
@@ -50,7 +50,7 @@ export declare const slackSourceSchema: z.ZodObject<{
 /** Runtime-owned local CLI coordinates for the inbound invocation. */
 export declare const localSourceSchema: z.ZodObject<{
     platform: z.ZodLiteral<"local">;
-    type: z.ZodLiteral<"priv">;
+    visibility: z.ZodLiteral<"private">;
     conversationId: z.ZodString;
 }, z.core.$strict>;
 /** Runtime-owned provider-neutral coordinates for the inbound invocation. */
@@ -58,15 +58,15 @@ export declare const sourceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     platform: z.ZodLiteral<"slack">;
     teamId: z.ZodString;
     channelId: z.ZodString;
-    type: z.ZodEnum<{
-        pub: "pub";
-        priv: "priv";
+    visibility: z.ZodEnum<{
+        public: "public";
+        private: "private";
     }>;
     messageTs: z.ZodOptional<z.ZodString>;
     threadTs: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>, z.ZodObject<{
     platform: z.ZodLiteral<"local">;
-    type: z.ZodLiteral<"priv">;
+    visibility: z.ZodLiteral<"private">;
     conversationId: z.ZodString;
 }, z.core.$strict>], "platform">;
 /** Stable user credential subject shape accepted from plugins. */
@@ -117,6 +117,11 @@ export declare const actorSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     platform: z.ZodLiteral<"system">;
     name: z.ZodString;
 }, z.core.$strict>], "platform">;
+/** Compact destination-visible context explaining what produced a reply. */
+export declare const replyAttributionSchema: z.ZodObject<{
+    label: z.ZodPipe<z.ZodString, z.ZodString>;
+    detail: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodString>>;
+}, z.core.$strict>;
 /** Plugin dispatch request accepted by Junior core. */
 export declare const dispatchOptionsSchema: z.ZodObject<{
     idempotencyKey: z.ZodPipe<z.ZodString, z.ZodString>;
@@ -141,19 +146,23 @@ export declare const dispatchOptionsSchema: z.ZodObject<{
     }>;
     input: z.ZodPipe<z.ZodString, z.ZodString>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    replyAttribution: z.ZodOptional<z.ZodObject<{
+        label: z.ZodPipe<z.ZodString, z.ZodString>;
+        detail: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodString>>;
+    }, z.core.$strict>>;
     source: z.ZodDiscriminatedUnion<[z.ZodObject<{
         platform: z.ZodLiteral<"slack">;
         teamId: z.ZodString;
         channelId: z.ZodString;
-        type: z.ZodEnum<{
-            pub: "pub";
-            priv: "priv";
+        visibility: z.ZodEnum<{
+            public: "public";
+            private: "private";
         }>;
         messageTs: z.ZodOptional<z.ZodString>;
         threadTs: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>, z.ZodObject<{
         platform: z.ZodLiteral<"local">;
-        type: z.ZodLiteral<"priv">;
+        visibility: z.ZodLiteral<"private">;
         conversationId: z.ZodString;
     }, z.core.$strict>], "platform">;
 }, z.core.$strict>;

package/dist/tasks.d.ts

@@ -126,15 +126,15 @@ export declare const pluginRunContextSchema: z.ZodObject<{
         platform: z.ZodLiteral<"slack">;
         teamId: z.ZodString;
         channelId: z.ZodString;
-        type: z.ZodEnum<{
-            pub: "pub";
-            priv: "priv";
+        visibility: z.ZodEnum<{
+            public: "public";
+            private: "private";
         }>;
         messageTs: z.ZodOptional<z.ZodString>;
         threadTs: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>, z.ZodObject<{
         platform: z.ZodLiteral<"local">;
-        type: z.ZodLiteral<"priv">;
+        visibility: z.ZodLiteral<"private">;
         conversationId: z.ZodString;
     }, z.core.$strict>], "platform">;
     transcript: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{

package/package.json

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

package/src/context.ts

@@ -19,7 +19,7 @@ export type SystemActor = z.output<typeof systemActorSchema>;
 export type Source = z.output<typeof sourceSchema>;
 export type SlackSource = Extract<Source, { platform: "slack" }>;
 export type LocalSource = Extract<Source, { platform: "local" }>;
-export type SourceType = Source["type"];
+export type SourceVisibility = Source["visibility"];
 
 export type Destination = z.output<typeof destinationSchema>;
 
@@ -103,11 +103,11 @@ export function createSlackSource(input: {
   teamId: string;
   threadTs?: string;
   /** Runtime-normalized source visibility. */
-  type: SourceType;
+  visibility: SourceVisibility;
 }): SlackSource {
   return {
     platform: "slack",
-    type: input.type,
+    visibility: input.visibility,
     teamId: input.teamId,
     channelId: input.channelId,
     ...(input.messageTs ? { messageTs: input.messageTs } : {}),
@@ -119,14 +119,14 @@ export function createSlackSource(input: {
 export function createLocalSource(conversationId: string): LocalSource {
   return {
     platform: "local",
-    type: "priv",
+    visibility: "private",
     conversationId,
   };
 }
 
 /** Return whether a source is private to a person or restricted group. */
 export function isPrivateSource(source: Source): boolean {
-  return source.type === "priv";
+  return source.visibility === "private";
 }
 
 /** Return the stable source identity used for idempotency and attribution. */

package/src/dispatch.ts

@@ -2,12 +2,15 @@ import { z } from "zod";
 import {
   destinationVisibilitySchema,
   dispatchOptionsSchema,
+  replyAttributionSchema,
 } from "./schemas";
 
 export type DestinationVisibility = z.output<
   typeof destinationVisibilitySchema
 >;
 export type DispatchOptions = z.output<typeof dispatchOptionsSchema>;
+/** Compact destination-visible context explaining what produced a reply. */
+export type ReplyAttribution = z.output<typeof replyAttributionSchema>;
 
 export interface DispatchResult {
   id: string;

package/src/schemas.ts

@@ -23,7 +23,7 @@ const exactNonBlankStringSchema = nonBlankStringSchema.refine(
 export const platformSchema = z.enum(["slack", "local"]);
 
 /** Runtime source visibility visible to plugins. */
-export const sourceTypeSchema = z.enum(["pub", "priv"]);
+export const sourceVisibilitySchema = z.enum(["public", "private"]);
 
 /** Provider-neutral visibility of a routed destination. */
 export const destinationVisibilitySchema = z.enum(["public", "private"]);
@@ -56,7 +56,7 @@ export const destinationSchema = z.discriminatedUnion("platform", [
 /** Runtime-owned Slack coordinates for the inbound invocation. */
 export const slackSourceSchema = slackAddressSchema
   .extend({
-    type: sourceTypeSchema,
+    visibility: sourceVisibilitySchema,
     messageTs: nonBlankStringSchema.optional(),
     threadTs: nonBlankStringSchema.optional(),
   })
@@ -66,7 +66,7 @@ export const slackSourceSchema = slackAddressSchema
 export const localSourceSchema = z
   .object({
     platform: z.literal("local"),
-    type: z.literal("priv"),
+    visibility: z.literal("private"),
     conversationId: localConversationIdSchema,
   })
   .strict();
@@ -187,6 +187,19 @@ const dispatchMetadataSchema = z
     }
   });
 
+/** Compact destination-visible context explaining what produced a reply. */
+export const replyAttributionSchema = z
+  .object({
+    label: exactNonBlankStringSchema
+      .pipe(z.string().max(48))
+      .refine((value) => !/[\r\n]/.test(value)),
+    detail: exactNonBlankStringSchema
+      .pipe(z.string().max(128))
+      .refine((value) => !/[\r\n]/.test(value))
+      .optional(),
+  })
+  .strict();
+
 /** Plugin dispatch request accepted by Junior core. */
 export const dispatchOptionsSchema = z
   .object({
@@ -196,6 +209,7 @@ export const dispatchOptionsSchema = z
     destinationVisibility: destinationVisibilitySchema,
     input: nonBlankStringSchema.pipe(z.string().max(32_000)),
     metadata: dispatchMetadataSchema.optional(),
+    replyAttribution: replyAttributionSchema.optional(),
     source: sourceSchema,
   })
   .strict();