@sentry/junior-plugin-api 0.191.0 → 0.193.0

package/README.md

@@ -42,9 +42,9 @@ reports, and other typed hook surfaces exported by this package.
 
 - Hook context carries the active source, actor, conversation, plugin metadata,
   database, logging, and only the host capabilities required by that hook.
-- Source uses `kind` to state what produced the input, including input such as
-  a Resource event that has no provider platform. Actor and Destination keep
-  `platform` for their provider scope.
+- Source uses `kind` to state what produced the input. Resource events,
+  scheduled tasks, event tasks, Plugin dispatches, and Agent invocations do not
+  name a provider. Actor and Destination still use `platform` to name one.
 - Prompt hooks return bounded structured prompt messages rather than mutate the
   core prompt.
 - `formatMarkdown` is a pure text rewrite into ordinary Markdown before delivery.

package/dist/context.d.ts

@@ -27,6 +27,18 @@ export type WebSource = Extract<Source, {
 export type ResourceEventSource = Extract<Source, {
     kind: "resource_event";
 }>;
+export type ScheduledTaskSource = Extract<Source, {
+    kind: "scheduled_task";
+}>;
+export type EventTaskSource = Extract<Source, {
+    kind: "event_task";
+}>;
+export type PluginDispatchSource = Extract<Source, {
+    kind: "plugin_dispatch";
+}>;
+export type AgentInvocationSource = Extract<Source, {
+    kind: "agent_invocation";
+}>;
 export type SourceVisibility = z.output<typeof sourceVisibilitySchema>;
 export type Destination = z.output<typeof destinationSchema>;
 export type SlackDestination = Extract<Destination, {
@@ -108,11 +120,15 @@ export interface WebInvocationContext extends BaseInvocationContext {
 export interface ResourceEventInvocationContext extends BaseInvocationContext {
     /** Existing conversation destination used for tool context. */
     destination: Destination;
-    actor?: SystemActor;
+    actor?: Actor;
     /** Runtime-owned Resource event Source for this invocation. */
     source: ResourceEventSource;
 }
-export type InvocationContext = LocalInvocationContext | ResourceEventInvocationContext | SlackInvocationContext | WebInvocationContext;
+export type InvocationContext = LocalInvocationContext | SlackInvocationContext | WebInvocationContext | (BaseInvocationContext & {
+    destination: Destination;
+    actor?: Actor;
+    source: AgentInvocationSource | EventTaskSource | PluginDispatchSource | ResourceEventSource | ScheduledTaskSource;
+});
 /** Build a normalized Slack source from runtime-owned Slack coordinates. */
 export declare function createSlackSource(input: {
     channelId: string;

package/dist/conversation-events.d.ts

@@ -73,4 +73,8 @@ export interface PluginConversationEventStats {
         days: 7 | 30 | 90;
         eventName: string;
     }): Promise<PluginConversationEventCostDay[]>;
+    costsByHour(input: {
+        eventName: string;
+        hours?: number;
+    }): Promise<PluginConversationEventCostDay[]>;
 }

package/dist/index.js

@@ -176,11 +176,19 @@ var resourceEventSourceSchema = z4.object({
   identifier: exactNonBlankStringSchema,
   namespace: exactNonBlankStringSchema
 }).strict();
+var scheduledTaskSourceSchema = z4.object({ kind: z4.literal("scheduled_task") }).strict();
+var eventTaskSourceSchema = z4.object({ kind: z4.literal("event_task") }).strict();
+var pluginDispatchSourceSchema = z4.object({ kind: z4.literal("plugin_dispatch") }).strict();
+var agentInvocationSourceSchema = z4.object({ kind: z4.literal("agent_invocation") }).strict();
 var currentSourceSchema = z4.discriminatedUnion("kind", [
   slackSourceSchema,
   localSourceSchema,
   webSourceSchema,
-  resourceEventSourceSchema
+  resourceEventSourceSchema,
+  scheduledTaskSourceSchema,
+  eventTaskSourceSchema,
+  pluginDispatchSourceSchema,
+  agentInvocationSourceSchema
 ]);
 function normalizeStoredSource(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) {
@@ -318,8 +326,7 @@ var dispatchOptionsSchema = z4.object({
   destinationVisibility: destinationVisibilitySchema,
   input: nonBlankStringSchema.pipe(z4.string().max(32e3)),
   metadata: dispatchMetadataSchema.optional(),
-  replyAttribution: replyAttributionSchema.optional(),
-  source: sourceSchema
+  replyAttribution: replyAttributionSchema.optional()
 }).strict();
 
 // src/context.ts
@@ -373,6 +380,11 @@ function getSourceKey(source) {
     }
     case "resource_event":
       return `resource-event:${source.namespace}:${source.eventKey}`;
+    case "scheduled_task":
+    case "event_task":
+    case "plugin_dispatch":
+    case "agent_invocation":
+      return void 0;
   }
 }
 function isSlackDestination(destination) {
@@ -1044,6 +1056,7 @@ export {
   RESOURCE_EVENT_TEXT_MAX_LENGTH,
   actorSchema,
   actorUserIdSchema,
+  agentInvocationSourceSchema,
   codeChangeInputSchema,
   codeChangeStateSchema,
   conversationAnnotationInputSchema,
@@ -1063,6 +1076,7 @@ export {
   destinationVisibilitySchema,
   dispatchOptionsSchema,
   enforceEgressPolicy,
+  eventTaskSourceSchema,
   getSourceKey,
   identitySchema,
   isPrivateSource,
@@ -1081,6 +1095,7 @@ export {
   pluginCredentialLeaseSchema,
   pluginCredentialResultSchema,
   pluginCredentialSubjectSchema,
+  pluginDispatchSourceSchema,
   pluginGrantSchema,
   pluginProviderAccountSchema,
   pluginResourceEventTypeSchema,
@@ -1114,6 +1129,7 @@ export {
   resourceEventTypeSchema,
   resourceLinkAnnotationSchema,
   resourceTypeSchema,
+  scheduledTaskSourceSchema,
   slackActorSchema,
   slackDestinationSchema,
   slackLocationSchema,

package/dist/operations.d.ts

@@ -78,7 +78,7 @@ export interface PluginOperationalBarChartWidget {
     emptyText?: string;
     id: string;
     series: PluginOperationalChartSeries[];
-    timeRangeDays?: Array<7 | 30 | 90>;
+    timeRangeDays?: Array<1 | 7 | 30 | 90>;
     title: string;
     type: "bar_chart";
 }

package/dist/schemas.d.ts

@@ -88,6 +88,22 @@ export declare const resourceEventSourceSchema: z.ZodObject<{
     identifier: z.ZodString;
     namespace: z.ZodString;
 }, z.core.$strict>;
+/** Runtime-owned Scheduled task input Source. */
+export declare const scheduledTaskSourceSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"scheduled_task">;
+}, z.core.$strict>;
+/** Runtime-owned Event task input Source. */
+export declare const eventTaskSourceSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"event_task">;
+}, z.core.$strict>;
+/** Runtime-owned Plugin dispatch input Source. */
+export declare const pluginDispatchSourceSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"plugin_dispatch">;
+}, z.core.$strict>;
+/** Runtime-owned Agent invocation input Source. */
+export declare const agentInvocationSourceSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"agent_invocation">;
+}, z.core.$strict>;
 /** Runtime-owned input Source. Stored `platform` and Location fields normalize on read. */
 export declare const sourceSchema: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"slack">;
@@ -116,6 +132,14 @@ export declare const sourceSchema: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.Zo
     eventType: z.ZodString;
     identifier: z.ZodString;
     namespace: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"scheduled_task">;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"event_task">;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"plugin_dispatch">;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"agent_invocation">;
 }, z.core.$strict>], "kind">, unknown>;
 /** Stable user credential subject shape accepted from plugins. */
 export declare const pluginCredentialSubjectSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -234,32 +258,4 @@ export declare const dispatchOptionsSchema: z.ZodObject<{
         label: z.ZodPipe<z.ZodString, z.ZodString>;
         detail: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodString>>;
     }, z.core.$strict>>;
-    source: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
-        kind: z.ZodLiteral<"slack">;
-        teamId: z.ZodString;
-        channelId: z.ZodString;
-        visibility: z.ZodEnum<{
-            public: "public";
-            private: "private";
-        }>;
-        messageTs: z.ZodOptional<z.ZodString>;
-        threadTs: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>, z.ZodObject<{
-        kind: z.ZodLiteral<"local">;
-        visibility: z.ZodLiteral<"private">;
-        conversationId: z.ZodString;
-    }, z.core.$strict>, z.ZodObject<{
-        kind: z.ZodLiteral<"web">;
-        visibility: z.ZodEnum<{
-            public: "public";
-            private: "private";
-        }>;
-        conversationId: z.ZodString;
-    }, z.core.$strict>, z.ZodObject<{
-        kind: z.ZodLiteral<"resource_event">;
-        eventKey: z.ZodString;
-        eventType: z.ZodString;
-        identifier: z.ZodString;
-        namespace: z.ZodString;
-    }, z.core.$strict>], "kind">, unknown>;
 }, z.core.$strict>;

package/dist/tasks.d.ts

@@ -175,6 +175,14 @@ export declare const pluginRunContextSchema: z.ZodObject<{
         eventType: z.ZodString;
         identifier: z.ZodString;
         namespace: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"scheduled_task">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"event_task">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"plugin_dispatch">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"agent_invocation">;
     }, z.core.$strict>], "kind">, unknown>;
     transcript: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodLiteral<"message">;

package/dist/tools.d.ts

@@ -1,4 +1,4 @@
-import type { Actor, Identity, LocalInvocationContext, ResourceEventInvocationContext, PluginContext, PluginEmbedder, PluginModel, SlackInvocationContext, User, WebInvocationContext } from "./context";
+import type { Actor, Identity, InvocationContext, PluginContext, PluginEmbedder, PluginModel, User } from "./context";
 import type { PluginCredentialSubject } from "./credentials";
 import type { PluginAnnotations } from "./annotations";
 import type { SlackConversationLink } from "./operations";
@@ -276,8 +276,8 @@ export declare function zodTool<TInputSchema extends ZodTypeAny, TOutputSchema e
 export declare function definePluginTool<TInputSchema extends ZodTypeAny, TOutputSchema extends ZodTypeAny, TExecuteResult extends z.input<TOutputSchema> | PluginToolOutputEnvelope<z.input<TOutputSchema>>>(definition: ZodPluginToolDefinition<TInputSchema, TOutputSchema, TExecuteResult>): PluginToolDefinition<z.output<TInputSchema>, z.output<TOutputSchema>, ParsedPluginToolExecuteResult<TOutputSchema, TExecuteResult>>;
 export interface SlackToolRegistrationHookContext {
     /**
-     * Capabilities of the source Slack conversation exposed to this plugin.
-     * Recomputed from `source.channelId`, not from `destination`.
+     * What Slack tools can do in the Conversation Location.
+     * Computed from Location, not from Source or Destination.
      */
     channelCapabilities: {
         canAddReactions: boolean;
@@ -334,17 +334,8 @@ interface BaseToolRegistrationHookContext extends PluginContext {
     userText?: string;
     workspaces: PluginWorkspaceToolContext;
 }
-interface SlackToolRegistrationContext extends BaseToolRegistrationHookContext, SlackInvocationContext {
-    slack: SlackToolRegistrationHookContext;
-}
-interface LocalToolRegistrationContext extends BaseToolRegistrationHookContext, LocalInvocationContext {
-    slack?: never;
-}
-interface WebToolRegistrationContext extends BaseToolRegistrationHookContext, WebInvocationContext {
-    slack?: never;
-}
-interface ResourceEventToolRegistrationContext extends BaseToolRegistrationHookContext, ResourceEventInvocationContext {
-    slack?: never;
-}
-export type ToolRegistrationHookContext = LocalToolRegistrationContext | ResourceEventToolRegistrationContext | SlackToolRegistrationContext | WebToolRegistrationContext;
+export type ToolRegistrationHookContext = BaseToolRegistrationHookContext & InvocationContext & {
+    /** Slack tool details when the Conversation has a Slack Location. */
+    slack?: SlackToolRegistrationHookContext;
+};
 export {};

package/package.json

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

package/src/context.ts

@@ -34,6 +34,13 @@ export type SlackSource = Extract<Source, { kind: "slack" }>;
 export type LocalSource = Extract<Source, { kind: "local" }>;
 export type WebSource = Extract<Source, { kind: "web" }>;
 export type ResourceEventSource = Extract<Source, { kind: "resource_event" }>;
+export type ScheduledTaskSource = Extract<Source, { kind: "scheduled_task" }>;
+export type EventTaskSource = Extract<Source, { kind: "event_task" }>;
+export type PluginDispatchSource = Extract<Source, { kind: "plugin_dispatch" }>;
+export type AgentInvocationSource = Extract<
+  Source,
+  { kind: "agent_invocation" }
+>;
 export type SourceVisibility = z.output<typeof sourceVisibilitySchema>;
 
 export type Destination = z.output<typeof destinationSchema>;
@@ -122,16 +129,25 @@ export interface WebInvocationContext extends BaseInvocationContext {
 export interface ResourceEventInvocationContext extends BaseInvocationContext {
   /** Existing conversation destination used for tool context. */
   destination: Destination;
-  actor?: SystemActor;
+  actor?: Actor;
   /** Runtime-owned Resource event Source for this invocation. */
   source: ResourceEventSource;
 }
 
 export type InvocationContext =
   | LocalInvocationContext
-  | ResourceEventInvocationContext
   | SlackInvocationContext
-  | WebInvocationContext;
+  | WebInvocationContext
+  | (BaseInvocationContext & {
+      destination: Destination;
+      actor?: Actor;
+      source:
+        | AgentInvocationSource
+        | EventTaskSource
+        | PluginDispatchSource
+        | ResourceEventSource
+        | ScheduledTaskSource;
+    });
 
 /** Build a normalized Slack source from runtime-owned Slack coordinates. */
 export function createSlackSource(input: {
@@ -209,6 +225,11 @@ export function getSourceKey(source: Source): string | undefined {
     }
     case "resource_event":
       return `resource-event:${source.namespace}:${source.eventKey}`;
+    case "scheduled_task":
+    case "event_task":
+    case "plugin_dispatch":
+    case "agent_invocation":
+      return undefined;
   }
 }
 

package/src/conversation-events.ts

@@ -129,4 +129,8 @@ export interface PluginConversationEventStats {
     days: 7 | 30 | 90;
     eventName: string;
   }): Promise<PluginConversationEventCostDay[]>;
+  costsByHour(input: {
+    eventName: string;
+    hours?: number;
+  }): Promise<PluginConversationEventCostDay[]>;
 }

package/src/operations.ts

@@ -91,7 +91,7 @@ export interface PluginOperationalBarChartWidget {
   emptyText?: string;
   id: string;
   series: PluginOperationalChartSeries[];
-  timeRangeDays?: Array<7 | 30 | 90>;
+  timeRangeDays?: Array<1 | 7 | 30 | 90>;
   title: string;
   type: "bar_chart";
 }

package/src/schemas.ts

@@ -121,11 +121,35 @@ export const resourceEventSourceSchema = z
   })
   .strict();
 
+/** Runtime-owned Scheduled task input Source. */
+export const scheduledTaskSourceSchema = z
+  .object({ kind: z.literal("scheduled_task") })
+  .strict();
+
+/** Runtime-owned Event task input Source. */
+export const eventTaskSourceSchema = z
+  .object({ kind: z.literal("event_task") })
+  .strict();
+
+/** Runtime-owned Plugin dispatch input Source. */
+export const pluginDispatchSourceSchema = z
+  .object({ kind: z.literal("plugin_dispatch") })
+  .strict();
+
+/** Runtime-owned Agent invocation input Source. */
+export const agentInvocationSourceSchema = z
+  .object({ kind: z.literal("agent_invocation") })
+  .strict();
+
 const currentSourceSchema = z.discriminatedUnion("kind", [
   slackSourceSchema,
   localSourceSchema,
   webSourceSchema,
   resourceEventSourceSchema,
+  scheduledTaskSourceSchema,
+  eventTaskSourceSchema,
+  pluginDispatchSourceSchema,
+  agentInvocationSourceSchema,
 ]);
 
 function normalizeStoredSource(value: unknown): unknown {
@@ -320,6 +344,5 @@ export const dispatchOptionsSchema = z
     input: nonBlankStringSchema.pipe(z.string().max(32_000)),
     metadata: dispatchMetadataSchema.optional(),
     replyAttribution: replyAttributionSchema.optional(),
-    source: sourceSchema,
   })
   .strict();

package/src/tools.ts

@@ -1,14 +1,11 @@
 import type {
   Actor,
   Identity,
-  LocalInvocationContext,
-  ResourceEventInvocationContext,
+  InvocationContext,
   PluginContext,
   PluginEmbedder,
   PluginModel,
-  SlackInvocationContext,
   User,
-  WebInvocationContext,
 } from "./context";
 import type { PluginCredentialSubject } from "./credentials";
 import type { PluginAnnotations } from "./annotations";
@@ -508,8 +505,8 @@ export function definePluginTool<
 
 export interface SlackToolRegistrationHookContext {
   /**
-   * Capabilities of the source Slack conversation exposed to this plugin.
-   * Recomputed from `source.channelId`, not from `destination`.
+   * What Slack tools can do in the Conversation Location.
+   * Computed from Location, not from Source or Destination.
    */
   channelCapabilities: {
     canAddReactions: boolean;
@@ -568,28 +565,8 @@ interface BaseToolRegistrationHookContext extends PluginContext {
   workspaces: PluginWorkspaceToolContext;
 }
 
-interface SlackToolRegistrationContext
-  extends BaseToolRegistrationHookContext, SlackInvocationContext {
-  slack: SlackToolRegistrationHookContext;
-}
-
-interface LocalToolRegistrationContext
-  extends BaseToolRegistrationHookContext, LocalInvocationContext {
-  slack?: never;
-}
-
-interface WebToolRegistrationContext
-  extends BaseToolRegistrationHookContext, WebInvocationContext {
-  slack?: never;
-}
-
-interface ResourceEventToolRegistrationContext
-  extends BaseToolRegistrationHookContext, ResourceEventInvocationContext {
-  slack?: never;
-}
-
-export type ToolRegistrationHookContext =
-  | LocalToolRegistrationContext
-  | ResourceEventToolRegistrationContext
-  | SlackToolRegistrationContext
-  | WebToolRegistrationContext;
+export type ToolRegistrationHookContext = BaseToolRegistrationHookContext &
+  InvocationContext & {
+    /** Slack tool details when the Conversation has a Slack Location. */
+    slack?: SlackToolRegistrationHookContext;
+  };