@sentry/junior-plugin-api 0.147.0 → 0.149.0

package/dist/context.d.ts

@@ -1,11 +1,12 @@
 import { z } from "zod";
 import type { ZodTypeAny } from "zod";
-import { destinationSchema, identitySchema, localActorSchema, platformSchema, actorSchema, slackActorSchema, systemActorSchema, sourceSchema, userSchema } from "./schemas";
+import { destinationSchema, identitySchema, webActorSchema, localActorSchema, platformSchema, actorSchema, slackActorSchema, systemActorSchema, sourceSchema, userSchema } from "./schemas";
 /** Runtime platform name without source or destination coordinates. */
 export type Platform = z.output<typeof platformSchema>;
 export type Actor = z.output<typeof actorSchema>;
 export type SlackActor = z.output<typeof slackActorSchema>;
 export type LocalActor = z.output<typeof localActorSchema>;
+export type WebActor = z.output<typeof webActorSchema>;
 export type SystemActor = z.output<typeof systemActorSchema>;
 export type Identity = z.output<typeof identitySchema>;
 export type User = z.output<typeof userSchema>;
@@ -16,6 +17,9 @@ export type SlackSource = Extract<Source, {
 export type LocalSource = Extract<Source, {
     platform: "local";
 }>;
+export type WebSource = Extract<Source, {
+    platform: "web";
+}>;
 export type SourceVisibility = Source["visibility"];
 export type Destination = z.output<typeof destinationSchema>;
 export type SlackDestination = Extract<Destination, {
@@ -85,7 +89,14 @@ export interface LocalInvocationContext extends BaseInvocationContext {
     /** Runtime-owned source where the invocation came from. */
     source: LocalSource;
 }
-export type InvocationContext = LocalInvocationContext | SlackInvocationContext;
+export interface WebInvocationContext extends BaseInvocationContext {
+    /** Existing conversation destination used for location and tool context. */
+    destination: Destination;
+    actor?: WebActor;
+    /** Runtime-owned dashboard/web source for this invocation. */
+    source: WebSource;
+}
+export type InvocationContext = LocalInvocationContext | SlackInvocationContext | WebInvocationContext;
 /** Build a normalized Slack source from runtime-owned Slack coordinates. */
 export declare function createSlackSource(input: {
     channelId: string;
@@ -97,6 +108,8 @@ export declare function createSlackSource(input: {
 }): SlackSource;
 /** Build a normalized local source from a local conversation id. */
 export declare function createLocalSource(conversationId: string): LocalSource;
+/** Build a normalized web/dashboard source from a conversation id. */
+export declare function createWebSource(conversationId: string, visibility?: SourceVisibility): WebSource;
 /** Return whether a source is private to a person or restricted group. */
 export declare function isPrivateSource(source: Source): boolean;
 /** Return the stable source identity used for idempotency and attribution. */

package/dist/index.js

@@ -111,9 +111,16 @@ var localSourceSchema = z3.object({
   visibility: z3.literal("private"),
   conversationId: localConversationIdSchema
 }).strict();
+var webSourceSchema = z3.object({
+  platform: z3.literal("web"),
+  visibility: sourceVisibilitySchema,
+  // Web can continue any existing conversation id, including Slack roots.
+  conversationId: exactNonBlankStringSchema
+}).strict();
 var sourceSchema = z3.discriminatedUnion("platform", [
   slackSourceSchema,
-  localSourceSchema
+  localSourceSchema,
+  webSourceSchema
 ]);
 var pluginCredentialSubjectSchema = z3.discriminatedUnion(
   "allowedWhen",
@@ -146,6 +153,10 @@ var localActorSchema = z3.object({
   ...actorProfileSchema,
   platform: z3.literal("local")
 }).strict();
+var webActorSchema = z3.object({
+  ...actorProfileSchema,
+  platform: z3.literal("web")
+}).strict();
 var systemActorSchema = z3.object({
   platform: z3.literal("system"),
   name: exactActorUserIdSchema
@@ -153,6 +164,7 @@ var systemActorSchema = z3.object({
 var actorSchema = z3.discriminatedUnion("platform", [
   slackActorSchema,
   localActorSchema,
+  webActorSchema,
   systemActorSchema
 ]);
 var identitySchema = z3.object({
@@ -250,18 +262,29 @@ function createLocalSource(conversationId) {
     conversationId
   };
 }
+function createWebSource(conversationId, visibility = "public") {
+  return {
+    platform: "web",
+    visibility,
+    conversationId
+  };
+}
 function isPrivateSource(source) {
   return source.visibility === "private";
 }
 function getSourceKey(source) {
-  if (source.platform === "local") {
-    return source.conversationId;
-  }
-  const messageKey = source.threadTs ?? source.messageTs;
-  if (!messageKey) {
-    return void 0;
+  switch (source.platform) {
+    case "web":
+    case "local":
+      return source.conversationId;
+    case "slack": {
+      const messageKey = source.threadTs ?? source.messageTs;
+      if (!messageKey) {
+        return void 0;
+      }
+      return `slack:${source.teamId}:${source.channelId}:${messageKey}`;
+    }
   }
-  return `slack:${source.teamId}:${source.channelId}:${messageKey}`;
 }
 function isSlackDestination(destination) {
   return destination?.platform === "slack";
@@ -821,6 +844,7 @@ export {
   conversationEventPresentationSchema,
   createLocalSource,
   createSlackSource,
+  createWebSource,
   defineConversationEvent,
   defineJuniorPlugin,
   definePluginTool,
@@ -878,5 +902,7 @@ export {
   systemActorSchema,
   toolApprovalModeSchema,
   userSchema,
+  webActorSchema,
+  webSourceSchema,
   zodTool
 };

package/dist/schemas.d.ts

@@ -53,6 +53,15 @@ export declare const localSourceSchema: z.ZodObject<{
     visibility: z.ZodLiteral<"private">;
     conversationId: z.ZodString;
 }, z.core.$strict>;
+/** Runtime-owned dashboard/web coordinates for the inbound invocation. */
+export declare const webSourceSchema: z.ZodObject<{
+    platform: z.ZodLiteral<"web">;
+    visibility: z.ZodEnum<{
+        public: "public";
+        private: "private";
+    }>;
+    conversationId: z.ZodString;
+}, z.core.$strict>;
 /** Runtime-owned provider-neutral coordinates for the inbound invocation. */
 export declare const sourceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     platform: z.ZodLiteral<"slack">;
@@ -68,6 +77,13 @@ export declare const sourceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     platform: z.ZodLiteral<"local">;
     visibility: z.ZodLiteral<"private">;
     conversationId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    platform: z.ZodLiteral<"web">;
+    visibility: z.ZodEnum<{
+        public: "public";
+        private: "private";
+    }>;
+    conversationId: z.ZodString;
 }, z.core.$strict>], "platform">;
 /** Stable user credential subject shape accepted from plugins. */
 export declare const pluginCredentialSubjectSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -95,6 +111,13 @@ export declare const localActorSchema: z.ZodObject<{
     userId: z.ZodString;
     userName: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
+export declare const webActorSchema: z.ZodObject<{
+    platform: z.ZodLiteral<"web">;
+    email: z.ZodOptional<z.ZodString>;
+    fullName: z.ZodOptional<z.ZodString>;
+    userId: z.ZodString;
+    userName: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
 export declare const systemActorSchema: z.ZodObject<{
     platform: z.ZodLiteral<"system">;
     name: z.ZodString;
@@ -113,6 +136,12 @@ export declare const actorSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     fullName: z.ZodOptional<z.ZodString>;
     userId: z.ZodString;
     userName: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    platform: z.ZodLiteral<"web">;
+    email: z.ZodOptional<z.ZodString>;
+    fullName: z.ZodOptional<z.ZodString>;
+    userId: z.ZodString;
+    userName: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>, z.ZodObject<{
     platform: z.ZodLiteral<"system">;
     name: z.ZodString;
@@ -187,5 +216,12 @@ export declare const dispatchOptionsSchema: z.ZodObject<{
         platform: z.ZodLiteral<"local">;
         visibility: z.ZodLiteral<"private">;
         conversationId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        platform: z.ZodLiteral<"web">;
+        visibility: z.ZodEnum<{
+            public: "public";
+            private: "private";
+        }>;
+        conversationId: z.ZodString;
     }, z.core.$strict>], "platform">;
 }, z.core.$strict>;

package/dist/tasks.d.ts

@@ -31,6 +31,12 @@ export declare const pluginRunTranscriptProvenanceSchema: z.ZodObject<{
         fullName: z.ZodOptional<z.ZodString>;
         userId: z.ZodString;
         userName: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        platform: z.ZodLiteral<"web">;
+        email: z.ZodOptional<z.ZodString>;
+        fullName: z.ZodOptional<z.ZodString>;
+        userId: z.ZodString;
+        userName: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>, z.ZodObject<{
         platform: z.ZodLiteral<"system">;
         name: z.ZodString;
@@ -62,6 +68,12 @@ export declare const pluginRunTranscriptEntrySchema: z.ZodDiscriminatedUnion<[z.
             fullName: z.ZodOptional<z.ZodString>;
             userId: z.ZodString;
             userName: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            platform: z.ZodLiteral<"web">;
+            email: z.ZodOptional<z.ZodString>;
+            fullName: z.ZodOptional<z.ZodString>;
+            userId: z.ZodString;
+            userName: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>, z.ZodObject<{
             platform: z.ZodLiteral<"system">;
             name: z.ZodString;
@@ -100,6 +112,12 @@ export declare const pluginRunContextSchema: z.ZodObject<{
         fullName: z.ZodOptional<z.ZodString>;
         userId: z.ZodString;
         userName: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        platform: z.ZodLiteral<"web">;
+        email: z.ZodOptional<z.ZodString>;
+        fullName: z.ZodOptional<z.ZodString>;
+        userId: z.ZodString;
+        userName: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>, z.ZodObject<{
         platform: z.ZodLiteral<"system">;
         name: z.ZodString;
@@ -117,6 +135,12 @@ export declare const pluginRunContextSchema: z.ZodObject<{
         fullName: z.ZodOptional<z.ZodString>;
         userId: z.ZodString;
         userName: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        platform: z.ZodLiteral<"web">;
+        email: z.ZodOptional<z.ZodString>;
+        fullName: z.ZodOptional<z.ZodString>;
+        userId: z.ZodString;
+        userName: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>, z.ZodObject<{
         platform: z.ZodLiteral<"system">;
         name: z.ZodString;
@@ -136,6 +160,13 @@ export declare const pluginRunContextSchema: z.ZodObject<{
         platform: z.ZodLiteral<"local">;
         visibility: z.ZodLiteral<"private">;
         conversationId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        platform: z.ZodLiteral<"web">;
+        visibility: z.ZodEnum<{
+            public: "public";
+            private: "private";
+        }>;
+        conversationId: z.ZodString;
     }, z.core.$strict>], "platform">;
     transcript: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodLiteral<"message">;
@@ -162,6 +193,12 @@ export declare const pluginRunContextSchema: z.ZodObject<{
                 fullName: z.ZodOptional<z.ZodString>;
                 userId: z.ZodString;
                 userName: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                platform: z.ZodLiteral<"web">;
+                email: z.ZodOptional<z.ZodString>;
+                fullName: z.ZodOptional<z.ZodString>;
+                userId: z.ZodString;
+                userName: z.ZodOptional<z.ZodString>;
             }, z.core.$strict>, z.ZodObject<{
                 platform: z.ZodLiteral<"system">;
                 name: z.ZodString;

package/dist/tools.d.ts

@@ -1,4 +1,4 @@
-import type { PluginContext, LocalInvocationContext, PluginEmbedder, Identity, PluginModel, Actor, SlackInvocationContext, User } from "./context";
+import type { Actor, Identity, LocalInvocationContext, PluginContext, PluginEmbedder, PluginModel, SlackInvocationContext, User, WebInvocationContext } from "./context";
 import type { PluginCredentialSubject } from "./credentials";
 import type { PluginAnnotations } from "./annotations";
 import type { SlackConversationLink } from "./operations";
@@ -285,7 +285,7 @@ interface BaseToolRegistrationHookContext extends PluginContext {
     /**
      * Opaque Junior conversation/session identity for this turn.
      * Interactive Slack turns use `slack:{channelId}:{threadTs}`.
-     * Scheduled/API turns use an internal id such as `agent-dispatch:{id}`.
+     * Scheduled/web turns use an internal id such as `agent-dispatch:{id}`.
      * Do not parse as Slack unless the value starts with `slack:`.
      */
     conversationId?: string;
@@ -313,5 +313,8 @@ interface SlackToolRegistrationContext extends BaseToolRegistrationHookContext,
 interface LocalToolRegistrationContext extends BaseToolRegistrationHookContext, LocalInvocationContext {
     slack?: never;
 }
-export type ToolRegistrationHookContext = LocalToolRegistrationContext | SlackToolRegistrationContext;
+interface WebToolRegistrationContext extends BaseToolRegistrationHookContext, WebInvocationContext {
+    slack?: never;
+}
+export type ToolRegistrationHookContext = LocalToolRegistrationContext | SlackToolRegistrationContext | WebToolRegistrationContext;
 export {};

package/package.json

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

package/src/context.ts

@@ -3,6 +3,7 @@ import type { ZodTypeAny } from "zod";
 import {
   destinationSchema,
   identitySchema,
+  webActorSchema,
   localActorSchema,
   platformSchema,
   actorSchema,
@@ -17,12 +18,14 @@ export type Platform = z.output<typeof platformSchema>;
 export type Actor = z.output<typeof actorSchema>;
 export type SlackActor = z.output<typeof slackActorSchema>;
 export type LocalActor = z.output<typeof localActorSchema>;
+export type WebActor = z.output<typeof webActorSchema>;
 export type SystemActor = z.output<typeof systemActorSchema>;
 export type Identity = z.output<typeof identitySchema>;
 export type User = z.output<typeof userSchema>;
 export type Source = z.output<typeof sourceSchema>;
 export type SlackSource = Extract<Source, { platform: "slack" }>;
 export type LocalSource = Extract<Source, { platform: "local" }>;
+export type WebSource = Extract<Source, { platform: "web" }>;
 export type SourceVisibility = Source["visibility"];
 
 export type Destination = z.output<typeof destinationSchema>;
@@ -98,7 +101,18 @@ export interface LocalInvocationContext extends BaseInvocationContext {
   source: LocalSource;
 }
 
-export type InvocationContext = LocalInvocationContext | SlackInvocationContext;
+export interface WebInvocationContext extends BaseInvocationContext {
+  /** Existing conversation destination used for location and tool context. */
+  destination: Destination;
+  actor?: WebActor;
+  /** Runtime-owned dashboard/web source for this invocation. */
+  source: WebSource;
+}
+
+export type InvocationContext =
+  | LocalInvocationContext
+  | SlackInvocationContext
+  | WebInvocationContext;
 
 /** Build a normalized Slack source from runtime-owned Slack coordinates. */
 export function createSlackSource(input: {
@@ -128,6 +142,18 @@ export function createLocalSource(conversationId: string): LocalSource {
   };
 }
 
+/** Build a normalized web/dashboard source from a conversation id. */
+export function createWebSource(
+  conversationId: string,
+  visibility: SourceVisibility = "public",
+): WebSource {
+  return {
+    platform: "web",
+    visibility,
+    conversationId,
+  };
+}
+
 /** Return whether a source is private to a person or restricted group. */
 export function isPrivateSource(source: Source): boolean {
   return source.visibility === "private";
@@ -135,14 +161,18 @@ export function isPrivateSource(source: Source): boolean {
 
 /** Return the stable source identity used for idempotency and attribution. */
 export function getSourceKey(source: Source): string | undefined {
-  if (source.platform === "local") {
-    return source.conversationId;
-  }
-  const messageKey = source.threadTs ?? source.messageTs;
-  if (!messageKey) {
-    return undefined;
+  switch (source.platform) {
+    case "web":
+    case "local":
+      return source.conversationId;
+    case "slack": {
+      const messageKey = source.threadTs ?? source.messageTs;
+      if (!messageKey) {
+        return undefined;
+      }
+      return `slack:${source.teamId}:${source.channelId}:${messageKey}`;
+    }
   }
-  return `slack:${source.teamId}:${source.channelId}:${messageKey}`;
 }
 
 /** Narrow a runtime destination to the Slack-specific address shape. */

package/src/schemas.ts

@@ -71,10 +71,21 @@ export const localSourceSchema = z
   })
   .strict();
 
+/** Runtime-owned dashboard/web coordinates for the inbound invocation. */
+export const webSourceSchema = z
+  .object({
+    platform: z.literal("web"),
+    visibility: sourceVisibilitySchema,
+    // Web can continue any existing conversation id, including Slack roots.
+    conversationId: exactNonBlankStringSchema,
+  })
+  .strict();
+
 /** Runtime-owned provider-neutral coordinates for the inbound invocation. */
 export const sourceSchema = z.discriminatedUnion("platform", [
   slackSourceSchema,
   localSourceSchema,
+  webSourceSchema,
 ]);
 
 /** Stable user credential subject shape accepted from plugins. */
@@ -122,6 +133,13 @@ export const localActorSchema = z
   })
   .strict();
 
+export const webActorSchema = z
+  .object({
+    ...actorProfileSchema,
+    platform: z.literal("web"),
+  })
+  .strict();
+
 export const systemActorSchema = z
   .object({
     platform: z.literal("system"),
@@ -133,6 +151,7 @@ export const systemActorSchema = z
 export const actorSchema = z.discriminatedUnion("platform", [
   slackActorSchema,
   localActorSchema,
+  webActorSchema,
   systemActorSchema,
 ]);
 

package/src/tools.ts

@@ -1,12 +1,13 @@
 import type {
-  PluginContext,
+  Actor,
+  Identity,
   LocalInvocationContext,
+  PluginContext,
   PluginEmbedder,
-  Identity,
   PluginModel,
-  Actor,
   SlackInvocationContext,
   User,
+  WebInvocationContext,
 } from "./context";
 import type { PluginCredentialSubject } from "./credentials";
 import type { PluginAnnotations } from "./annotations";
@@ -514,7 +515,7 @@ interface BaseToolRegistrationHookContext extends PluginContext {
   /**
    * Opaque Junior conversation/session identity for this turn.
    * Interactive Slack turns use `slack:{channelId}:{threadTs}`.
-   * Scheduled/API turns use an internal id such as `agent-dispatch:{id}`.
+   * Scheduled/web turns use an internal id such as `agent-dispatch:{id}`.
    * Do not parse as Slack unless the value starts with `slack:`.
    */
   conversationId?: string;
@@ -544,6 +545,12 @@ interface LocalToolRegistrationContext
   slack?: never;
 }
 
+interface WebToolRegistrationContext
+  extends BaseToolRegistrationHookContext, WebInvocationContext {
+  slack?: never;
+}
+
 export type ToolRegistrationHookContext =
   | LocalToolRegistrationContext
-  | SlackToolRegistrationContext;
+  | SlackToolRegistrationContext
+  | WebToolRegistrationContext;