@sentry/junior-plugin-api 0.179.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

@@ -90,9 +90,10 @@ import { z as z3 } from "zod";
 var slackTeamIdSchema = z3.string().regex(/^T[A-Z0-9]+$/);
 var slackConversationIdSchema = z3.string().regex(/^(C|G|D)[A-Z0-9]+$/);
 var localConversationIdSchema = z3.string().regex(/^local:[a-z0-9_-]+:[a-z0-9][a-z0-9_-]*$/);
-var exactActorUserIdSchema = z3.string().min(1).refine(
+var actorUserIdSchema = z3.string().min(1).refine(
   (value) => value === value.trim() && value.toLowerCase() !== "unknown"
 );
+var exactActorUserIdSchema = actorUserIdSchema;
 var nonBlankStringSchema = z3.string().refine((value) => value.trim().length > 0);
 var exactNonBlankStringSchema = nonBlankStringSchema.refine(
   (value) => value === value.trim()
@@ -264,8 +265,8 @@ function createSlackSource(input) {
     visibility: input.visibility,
     teamId: input.teamId,
     channelId: input.channelId,
-    ...input.messageTs ? { messageTs: input.messageTs } : {},
-    ...input.threadTs ? { threadTs: input.threadTs } : {}
+    ...input.messageTs ? { messageTs: input.messageTs } : void 0,
+    ...input.threadTs ? { threadTs: input.threadTs } : void 0
   };
 }
 function createLocalSource(conversationId) {
@@ -478,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
@@ -601,7 +606,7 @@ function createZodTool(definition, helperName) {
         }
         return outputSchema.parse(result);
       }
-    } : {}
+    } : void 0
   };
 }
 function zodTool(definition) {
@@ -863,11 +868,14 @@ var pluginUserPageLinkSchema = z10.object({
   pluginName: nonBlankStringSchema.max(100)
 }).strict();
 var pluginUserPageLinksSchema = z10.array(pluginUserPageLinkSchema);
+var pluginUserPageCursorSchema = nonBlankStringSchema.max(1e3).optional();
+var pluginUserPageFilterSchema = nonBlankStringSchema.max(64).optional();
+var pluginUserPageQuerySchema = z10.string().trim().max(200).optional();
 var pluginUserPageInputSchema = z10.object({
-  cursor: nonBlankStringSchema.max(1e3).optional(),
-  filter: nonBlankStringSchema.max(64).optional(),
+  cursor: pluginUserPageCursorSchema,
+  filter: pluginUserPageFilterSchema,
   limit: z10.number().int().min(1).max(50),
-  query: z10.string().trim().max(200).optional()
+  query: pluginUserPageQuerySchema
 }).strict();
 export {
   EgressAuthRequired,
@@ -880,6 +888,7 @@ export {
   RESOURCE_EVENT_SUMMARY_MAX_LENGTH,
   RESOURCE_EVENT_TEXT_MAX_LENGTH,
   actorSchema,
+  actorUserIdSchema,
   conversationAnnotationInputSchema,
   conversationEventIconSchema,
   conversationEventPresentationSchema,
@@ -925,9 +934,12 @@ export {
   pluginToolContinuationSchema,
   pluginToolOutputSchema,
   pluginUserPageContentSchema,
+  pluginUserPageCursorSchema,
+  pluginUserPageFilterSchema,
   pluginUserPageInputSchema,
   pluginUserPageLinkSchema,
   pluginUserPageLinksSchema,
+  pluginUserPageQuerySchema,
   promptContextSchema,
   promptMessageSchema,
   replyAttributionSchema,

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/schemas.d.ts

@@ -1,4 +1,6 @@
 import { z } from "zod";
+/** Exact non-blank actor user id that rejects the sentinel "unknown". */
+export declare const actorUserIdSchema: z.ZodString;
 export declare const nonBlankStringSchema: z.ZodString;
 /** Runtime platform names supported by plugin public contracts. */
 export declare const platformSchema: z.ZodEnum<{

package/dist/tasks.d.ts

@@ -1,8 +1,8 @@
 /**
  * Public plugin background-task contracts.
  *
- * Plugins register small task handlers, while Junior core owns durable
- * scheduling, queue delivery, retries, and the bounded run projection.
+ * Plugins register small task handlers. Junior core owns scheduling, delivery,
+ * retries, and the bounded run projection.
  */
 import { z } from "zod";
 import type { PluginConversationEvents } from "./conversation-events";
@@ -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/dist/user-pages.d.ts

@@ -68,6 +68,12 @@ export declare const pluginUserPageLinksSchema: z.ZodArray<z.ZodObject<{
 }, z.core.$strict>>;
 /** Safe navigation metadata for one registered plugin user page. */
 export type PluginUserPageLink = z.output<typeof pluginUserPageLinkSchema>;
+/** Optional cursor token for one plugin user page reader. */
+export declare const pluginUserPageCursorSchema: z.ZodOptional<z.ZodString>;
+/** Optional filter token for one plugin user page reader. */
+export declare const pluginUserPageFilterSchema: z.ZodOptional<z.ZodString>;
+/** Optional free-text query for one plugin user page reader. */
+export declare const pluginUserPageQuerySchema: z.ZodOptional<z.ZodString>;
 /** Validated query state passed to one plugin user page reader. */
 export declare const pluginUserPageInputSchema: z.ZodObject<{
     cursor: z.ZodOptional<z.ZodString>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sentry/junior-plugin-api",
-  "version": "0.179.0",
+  "version": "0.181.0",
   "private": false,
   "publishConfig": {
     "access": "public"
@@ -26,7 +26,8 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "oxlint": "^1.66.0",
+    "@oxlint/plugins": "1.79.0",
+    "oxlint": "^1.79.0",
     "tsup": "^8.5.1",
     "typescript": "^6.0.3"
   },

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 {
@@ -128,8 +130,8 @@ export function createSlackSource(input: {
     visibility: input.visibility,
     teamId: input.teamId,
     channelId: input.channelId,
-    ...(input.messageTs ? { messageTs: input.messageTs } : {}),
-    ...(input.threadTs ? { threadTs: input.threadTs } : {}),
+    ...(input.messageTs ? { messageTs: input.messageTs } : undefined),
+    ...(input.threadTs ? { threadTs: input.threadTs } : undefined),
   };
 }
 

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

@@ -5,12 +5,14 @@ const slackConversationIdSchema = z.string().regex(/^(C|G|D)[A-Z0-9]+$/);
 const localConversationIdSchema = z
   .string()
   .regex(/^local:[a-z0-9_-]+:[a-z0-9][a-z0-9_-]*$/);
-const exactActorUserIdSchema = z
+/** Exact non-blank actor user id that rejects the sentinel "unknown". */
+export const actorUserIdSchema = z
   .string()
   .min(1)
   .refine(
     (value) => value === value.trim() && value.toLowerCase() !== "unknown",
   );
+const exactActorUserIdSchema = actorUserIdSchema;
 
 export const nonBlankStringSchema = z
   .string()
@@ -147,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

@@ -1,8 +1,8 @@
 /**
  * Public plugin background-task contracts.
  *
- * Plugins register small task handlers, while Junior core owns durable
- * scheduling, queue delivery, retries, and the bounded run projection.
+ * Plugins register small task handlers. Junior core owns scheduling, delivery,
+ * retries, and the bounded run projection.
  */
 import { z } from "zod";
 import type { PluginConversationEvents } from "./conversation-events";
@@ -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

package/src/tools.ts

@@ -455,7 +455,7 @@ function createZodTool<
             return outputSchema.parse(result);
           },
         }
-      : {}),
+      : undefined),
   } as PluginToolDefinition<
     z.output<TInputSchema>,
     z.output<TOutputSchema>,

package/src/user-pages.ts

@@ -86,13 +86,26 @@ export const pluginUserPageLinksSchema = z.array(pluginUserPageLinkSchema);
 /** Safe navigation metadata for one registered plugin user page. */
 export type PluginUserPageLink = z.output<typeof pluginUserPageLinkSchema>;
 
+/** Optional cursor token for one plugin user page reader. */
+export const pluginUserPageCursorSchema = nonBlankStringSchema
+  .max(1_000)
+  .optional();
+
+/** Optional filter token for one plugin user page reader. */
+export const pluginUserPageFilterSchema = nonBlankStringSchema
+  .max(64)
+  .optional();
+
+/** Optional free-text query for one plugin user page reader. */
+export const pluginUserPageQuerySchema = z.string().trim().max(200).optional();
+
 /** Validated query state passed to one plugin user page reader. */
 export const pluginUserPageInputSchema = z
   .object({
-    cursor: nonBlankStringSchema.max(1_000).optional(),
-    filter: nonBlankStringSchema.max(64).optional(),
+    cursor: pluginUserPageCursorSchema,
+    filter: pluginUserPageFilterSchema,
     limit: z.number().int().min(1).max(50),
-    query: z.string().trim().max(200).optional(),
+    query: pluginUserPageQuerySchema,
   })
   .strict();