@sentry/junior-plugin-api 0.75.0 → 0.76.1

package/src/tasks.ts

@@ -0,0 +1,68 @@
+/**
+ * Public plugin background-task contracts.
+ *
+ * Plugins register small task handlers, while Junior core owns durable
+ * scheduling, queue delivery, retries, and the bounded run projection.
+ */
+import { z } from "zod";
+import type { PluginContext, PluginEmbedder, PluginModel } from "./context";
+import { destinationSchema, requesterSchema, sourceSchema } from "./schemas";
+import type { PluginState } from "./state";
+
+/** One normalized transcript entry from the completed run exposed to plugin tasks. */
+export const pluginRunTranscriptEntrySchema = z.discriminatedUnion("type", [
+  z
+    .object({
+      type: z.literal("message"),
+      role: z.enum(["user", "assistant"]),
+      text: z.string().min(1),
+    })
+    .strict(),
+  z
+    .object({
+      type: z.literal("toolResult"),
+      toolName: z.string().min(1),
+      isError: z.boolean(),
+      text: z.string().min(1).optional(),
+    })
+    .strict(),
+]);
+
+/** Runtime-owned completed-run projection exposed to plugin tasks. */
+export const pluginRunContextSchema = z
+  .object({
+    completedAtMs: z.number().finite(),
+    conversationId: z.string().min(1),
+    destination: destinationSchema,
+    requester: requesterSchema.optional(),
+    runId: z.string().min(1),
+    source: sourceSchema,
+    transcript: z.array(pluginRunTranscriptEntrySchema),
+  })
+  .strict();
+
+export type PluginRunTranscriptEntry = z.output<
+  typeof pluginRunTranscriptEntrySchema
+>;
+
+export type PluginRunContext = z.output<typeof pluginRunContextSchema>;
+
+/** Runtime context passed to a plugin-owned background task. */
+export interface PluginTaskContext extends PluginContext {
+  embedder: PluginEmbedder;
+  id: string;
+  model: PluginModel;
+  name: string;
+  run: {
+    load(): Promise<PluginRunContext>;
+  };
+  state: PluginState;
+}
+
+/** Plugin task handler registered by name in a plugin manifest module. */
+export interface PluginTaskDefinition {
+  run(ctx: PluginTaskContext): Promise<void> | void;
+}
+
+/** Task handlers keyed by the plugin-owned task name. */
+export type PluginTasks = Record<string, PluginTaskDefinition>;

package/src/tools.ts

@@ -1,6 +1,8 @@
 import type {
   PluginContext,
   LocalInvocationContext,
+  PluginEmbedder,
+  PluginModel,
   Requester,
   SlackInvocationContext,
 } from "./context";
@@ -62,10 +64,20 @@ export interface BeforeToolExecuteHookContext extends PluginContext {
   };
 }
 
+export interface PluginToolExecuteOptions {
+  /**
+   * @deprecated Internal compatibility escape hatch for legacy tool bridges.
+   * Plugin tools should use typed input fields and runtime hook context instead.
+   */
+  experimental_context?: unknown;
+  /** Stable runtime tool-call id; durable create tools should derive idempotency keys from it. */
+  toolCallId?: string;
+}
+
 export type PluginToolExecute<TInput = unknown> = {
   bivarianceHack(
     input: TInput,
-    options: { experimental_context?: unknown },
+    options: PluginToolExecuteOptions,
   ): Promise<unknown> | unknown;
 }["bivarianceHack"];
 
@@ -111,6 +123,8 @@ interface BaseToolRegistrationHookContext extends PluginContext {
    * Do not parse as Slack unless the value starts with `slack:`.
    */
   conversationId?: string;
+  embedder: PluginEmbedder;
+  model: PluginModel;
   state: PluginState;
   userText?: string;
 }

package/dist/database.d.ts

@@ -1,13 +0,0 @@
-import type { PgDatabase } from "drizzle-orm/pg-core";
-import type { PgQueryResultHKT } from "drizzle-orm/pg-core/session";
-export type PluginDrizzleDatabase = PgDatabase<PgQueryResultHKT, Record<string, never>>;
-export interface PluginDb {
-    delete: PluginDrizzleDatabase["delete"];
-    execute(statement: string, params?: readonly unknown[]): Promise<void>;
-    insert: PluginDrizzleDatabase["insert"];
-    query<T = unknown>(statement: string, params?: readonly unknown[]): Promise<T[]>;
-    select: PluginDrizzleDatabase["select"];
-    transaction<T>(callback: (tx: PluginDb) => Promise<T>): Promise<T>;
-    update: PluginDrizzleDatabase["update"];
-}
-export type PluginDatabaseConfig = Record<string, never>;

package/src/database.ts

@@ -1,22 +0,0 @@
-import type { PgDatabase } from "drizzle-orm/pg-core";
-import type { PgQueryResultHKT } from "drizzle-orm/pg-core/session";
-
-export type PluginDrizzleDatabase = PgDatabase<
-  PgQueryResultHKT,
-  Record<string, never>
->;
-
-export interface PluginDb {
-  delete: PluginDrizzleDatabase["delete"];
-  execute(statement: string, params?: readonly unknown[]): Promise<void>;
-  insert: PluginDrizzleDatabase["insert"];
-  query<T = unknown>(
-    statement: string,
-    params?: readonly unknown[],
-  ): Promise<T[]>;
-  select: PluginDrizzleDatabase["select"];
-  transaction<T>(callback: (tx: PluginDb) => Promise<T>): Promise<T>;
-  update: PluginDrizzleDatabase["update"];
-}
-
-export type PluginDatabaseConfig = Record<string, never>;