@sentry/junior-plugin-api 0.180.0 → 0.181.0

package/README.md

@@ -62,14 +62,12 @@ reports, and other typed hook surfaces exported by this package.
 - Profile report hooks return the same bounded operational report content for
   one subject user on a person profile. Core owns viewer authorization,
   collection, sanitization, and browser rendering.
-- Tool hooks may lazily resolve the active actor's canonical identity and linked
-  user through `ctx.users.resolveActor()`.
+- Tool hooks may resolve the active Actor's Identity and User through
+  `ctx.users.resolveActor()`.
 - Authenticated API route hooks receive `ctx.users.resolve(email)` for lazy
-  canonical user resolution. Routes that do not need personal ownership do not
-  query identity storage.
-- User page readers receive the canonical viewer `User` with linked identities.
-  Plugins return bounded data and do not mount their own page routes or browser
-  code.
+  User lookup. Routes that do not need User data do not query identity storage.
+- User page readers receive the signed-in `User`. Plugins return limited data.
+  They do not mount their own page routes or browser code.
 
 ## User Pages
 

package/dist/context.d.ts

@@ -74,6 +74,8 @@ interface BaseInvocationContext {
      * Interactive Slack turns use `slack:{channelId}:{threadTs}`.
      */
     conversationId?: string;
+    /** Location associated with this Conversation. */
+    locationId?: string;
 }
 export interface SlackInvocationContext extends BaseInvocationContext {
     /** Runtime-owned default outbound destination for this invocation. */

package/dist/index.js

@@ -479,9 +479,13 @@ var pluginRunTranscriptEntrySchema = z6.discriminatedUnion("type", [
   }).strict()
 ]);
 var pluginRunContextSchema = z6.object({
+  /** User linked to the Actor, when known. */
+  actorUserId: z6.string().min(1).optional(),
   completedAtMs: z6.number().finite(),
   conversationId: z6.string().min(1),
   destination: destinationSchema,
+  /** Location associated with this Conversation. */
+  locationId: z6.string().min(1).optional(),
   /**
    * All distinct actors annotated on this run's committed instruction-authority
    * messages, in first-seen order. Attribution provenance only, never an

package/dist/prompt.d.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import type { Destination, Platform, PluginContext, PluginEmbedder, PluginModel, Actor, Source } from "./context";
+import type { Destination, Platform, PluginContext, PluginEmbedder, PluginModel, Actor, Identity, Source, User } from "./context";
 import type { PluginState } from "./state";
 import type { PluginConversationEvents } from "./conversation-events";
 export declare const promptMessageSchema: z.ZodObject<{
@@ -40,8 +40,17 @@ export type UserPromptContext = Pick<PluginContext, "db" | "log" | "plugin"> & {
     /** Conversation-bound event writer when the prompt belongs to a durable turn. */
     events?: PluginConversationEvents;
     model: PluginModel;
+    /** Location associated with this Conversation. */
+    locationId?: string;
     actor?: Actor;
     source: Source;
     state: PluginState;
     text: string;
+    users: {
+        /** Resolve the current Actor's Identity and User. */
+        resolveActor(): Promise<{
+            identity: Identity;
+            user?: User;
+        } | undefined>;
+    };
 };

package/dist/tasks.d.ts

@@ -89,6 +89,7 @@ export declare const pluginRunTranscriptEntrySchema: z.ZodDiscriminatedUnion<[z.
 export type PluginRunTranscriptProvenance = z.output<typeof pluginRunTranscriptProvenanceSchema>;
 /** Runtime-owned completed-run projection exposed to plugin tasks. */
 export declare const pluginRunContextSchema: z.ZodObject<{
+    actorUserId: z.ZodOptional<z.ZodString>;
     completedAtMs: z.ZodNumber;
     conversationId: z.ZodString;
     destination: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -99,6 +100,7 @@ export declare const pluginRunContextSchema: z.ZodObject<{
         platform: z.ZodLiteral<"local">;
         conversationId: z.ZodString;
     }, z.core.$strict>], "platform">;
+    locationId: z.ZodOptional<z.ZodString>;
     actors: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         platform: z.ZodLiteral<"slack">;
         teamId: z.ZodString;

package/package.json

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

package/src/context.ts

@@ -83,6 +83,8 @@ interface BaseInvocationContext {
    * Interactive Slack turns use `slack:{channelId}:{threadTs}`.
    */
   conversationId?: string;
+  /** Location associated with this Conversation. */
+  locationId?: string;
 }
 
 export interface SlackInvocationContext extends BaseInvocationContext {

package/src/prompt.ts

@@ -6,7 +6,9 @@ import type {
   PluginEmbedder,
   PluginModel,
   Actor,
+  Identity,
   Source,
+  User,
 } from "./context";
 import type { PluginState } from "./state";
 import type { PluginConversationEvents } from "./conversation-events";
@@ -84,8 +86,14 @@ export type UserPromptContext = Pick<PluginContext, "db" | "log" | "plugin"> & {
   /** Conversation-bound event writer when the prompt belongs to a durable turn. */
   events?: PluginConversationEvents;
   model: PluginModel;
+  /** Location associated with this Conversation. */
+  locationId?: string;
   actor?: Actor;
   source: Source;
   state: PluginState;
   text: string;
+  users: {
+    /** Resolve the current Actor's Identity and User. */
+    resolveActor(): Promise<{ identity: Identity; user?: User } | undefined>;
+  };
 };

package/src/schemas.ts

@@ -149,6 +149,8 @@ export const systemActorSchema = z
   })
   .strict();
 
+// TODO(dcramer): Separate actor kind from provider platform.
+// System actors should not use `platform: "system"`.
 /** Runtime-provided actor identity visible to plugin hooks. */
 export const actorSchema = z.discriminatedUnion("platform", [
   slackActorSchema,

package/src/tasks.ts

@@ -50,9 +50,13 @@ export type PluginRunTranscriptProvenance = z.output<
 /** Runtime-owned completed-run projection exposed to plugin tasks. */
 export const pluginRunContextSchema = z
   .object({
+    /** User linked to the Actor, when known. */
+    actorUserId: z.string().min(1).optional(),
     completedAtMs: z.number().finite(),
     conversationId: z.string().min(1),
     destination: destinationSchema,
+    /** Location associated with this Conversation. */
+    locationId: z.string().min(1).optional(),
     /**
      * All distinct actors annotated on this run's committed instruction-authority
      * messages, in first-seen order. Attribution provenance only, never an