@sentry/junior 0.74.1 → 0.76.0

package/dist/build/copy-build-content.d.ts

@@ -1,4 +1,4 @@
-/** Copy app directory and plugin manifests into the server output. */
+/** Copy app and declared plugin package content into the server output. */
 export declare function copyAppAndPluginContent(cwd: string, serverRoot: string, packageNames?: unknown): void;
 /** Copy extra file patterns into server output for files the bundler cannot trace. */
 export declare function copyIncludedFiles(cwd: string, serverRoot: string, patterns?: unknown): void;

package/dist/build/virtual-config.d.ts

@@ -9,12 +9,12 @@ export interface RuntimePluginModule {
 export declare function renderVirtualConfig(options: {
     plugins?: PluginCatalogConfig;
     pluginModule?: RuntimePluginModule;
-    pluginHookRegistrations?: string[];
+    pluginRuntimeRegistrations?: string[];
 }): string;
 /** Inject a virtual module so createApp() can read the plugin list at runtime. */
 export declare function injectVirtualConfig(nitro: Nitro, options?: {
     loadPluginSet?: () => Promise<JuniorPluginSet | undefined>;
     pluginModule?: RuntimePluginModule;
     plugins?: PluginCatalogConfig;
-    pluginHookRegistrations?: string[];
+    pluginRuntimeRegistrations?: string[];
 }): void;

package/dist/chat/agent-dispatch/context.d.ts

@@ -1,7 +1,6 @@
-import type { HeartbeatHookContext } from "@sentry/junior-plugin-api";
+import type { HeartbeatHookContext, PluginRegistration } from "@sentry/junior-plugin-api";
 /** Build the plugin-scoped heartbeat context that gates durable dispatch access. */
 export declare function createHeartbeatContext(args: {
-    legacyStatePrefixes?: string[];
     nowMs: number;
-    plugin: string;
+    plugin: string | PluginRegistration;
 }): HeartbeatHookContext;

package/dist/chat/agent-dispatch/runner.d.ts

@@ -1,10 +1,12 @@
 import { generateAssistantReply as generateAssistantReplyImpl } from "@/chat/respond";
 import type { SandboxEgressTracePropagationConfig } from "@/chat/sandbox/egress-tracing";
+import { scheduleSessionCompletedPluginTasks } from "@/chat/plugins/task-runner";
 import { scheduleDispatchCallback } from "./signing";
 import type { DispatchCallback } from "./types";
 export interface AgentDispatchRunnerDeps {
     generateAssistantReply?: typeof generateAssistantReplyImpl;
     scheduleCallback?: typeof scheduleDispatchCallback;
+    scheduleSessionCompletedPluginTasks?: typeof scheduleSessionCompletedPluginTasks;
     tracePropagation?: SandboxEgressTracePropagationConfig;
 }
 /** Run one serverless slice for a core-owned agent dispatch. */

package/dist/chat/agent-dispatch/types.d.ts

@@ -1,4 +1,4 @@
-import type { DispatchOptions, SlackDestination } from "@sentry/junior-plugin-api";
+import type { DispatchOptions, Source, SlackDestination } from "@sentry/junior-plugin-api";
 import type { CredentialSubject, CredentialSystemActor } from "@/chat/credentials/context";
 export type DispatchStatus = "pending" | "running" | "awaiting_resume" | "completed" | "failed" | "blocked";
 export type SlackDispatchOptions = Omit<DispatchOptions, "destination"> & {
@@ -23,6 +23,7 @@ export interface DispatchRecord {
     metadata?: Record<string, string>;
     plugin: string;
     resultMessageTs?: string;
+    source: Source;
     status: DispatchStatus;
     updatedAtMs: number;
     version: number;

package/dist/chat/config.d.ts

@@ -7,6 +7,7 @@ export type AdvisorThinkingLevel = (typeof ADVISOR_THINKING_LEVELS)[number];
 export declare const FUNCTION_TIMEOUT_BUFFER_SECONDS = 20;
 export interface BotConfig {
     advisor: AdvisorConfig;
+    embeddingModelId: string;
     fastModelId: string;
     loadingMessages: string[];
     modelId: string;
@@ -19,11 +20,13 @@ export interface AdvisorConfig {
     modelId: string;
     thinkingLevel: AdvisorThinkingLevel;
 }
+export type SqlDriver = "neon" | "postgres";
 export interface ChatConfig {
     bot: BotConfig;
     functionMaxDurationSeconds: number;
     sql: {
         databaseUrl?: string;
+        driver: SqlDriver;
     };
     slack: {
         botToken?: string;

package/dist/chat/credentials/state-adapter-token-store.d.ts

@@ -6,4 +6,6 @@ export declare class StateAdapterTokenStore implements UserTokenStore {
     get(userId: string, provider: string): Promise<StoredTokens | undefined>;
     set(userId: string, provider: string, tokens: StoredTokens): Promise<void>;
     delete(userId: string, provider: string): Promise<void>;
+    /** Wait for the per-slot refresh gate so rotated refresh tokens are used once. */
+    withRefresh<T>(userId: string, provider: string, callback: () => Promise<T>): Promise<T>;
 }

package/dist/chat/credentials/subject.d.ts

@@ -1,15 +1,15 @@
-import type { AgentPluginCredentialSubject } from "@sentry/junior-plugin-api";
+import type { PluginCredentialSubject } from "@sentry/junior-plugin-api";
 import type { CredentialSubject } from "@/chat/credentials/context";
 /** Create a delegated user credential subject for a verified Slack DM turn. */
 export declare function createSlackDirectCredentialSubject(input: {
     channelId: string | undefined;
     teamId: string | undefined;
     userId: string | undefined;
-}): AgentPluginCredentialSubject | undefined;
+}): PluginCredentialSubject | undefined;
 /** Bind a delegated user subject to the Slack DM destination being dispatched. */
 export declare function bindSlackDirectCredentialSubject(input: {
     channelId: string;
-    subject: AgentPluginCredentialSubject;
+    subject: PluginCredentialSubject;
     teamId: string;
 }): CredentialSubject | undefined;
 /** Verify that a delegated subject was signed for the dispatch destination. */

package/dist/chat/credentials/user-token-store.d.ts

@@ -1,17 +1,22 @@
-export interface StoredProviderAccount {
-    id: string;
-    label?: string;
-    url?: string;
-}
-export interface StoredTokens {
-    account?: StoredProviderAccount;
-    accessToken: string;
-    refreshToken: string;
-    expiresAt?: number;
-    scope?: string;
-}
+import { type PluginProviderAccount, type PluginStoredTokens } from "@sentry/junior-plugin-api";
+export declare const storedTokensSchema: import("zod").ZodObject<{
+    account: import("zod").ZodOptional<import("zod").ZodObject<{
+        id: import("zod").ZodString;
+        label: import("zod").ZodOptional<import("zod").ZodString>;
+        url: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strict>>;
+    accessToken: import("zod").ZodString;
+    expiresAt: import("zod").ZodOptional<import("zod").ZodNumber>;
+    refreshToken: import("zod").ZodString;
+    refreshTokenExpiresAt: import("zod").ZodOptional<import("zod").ZodNumber>;
+    scope: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strict>;
+export type StoredProviderAccount = PluginProviderAccount;
+export type StoredTokens = PluginStoredTokens;
 export interface UserTokenStore {
     get(userId: string, provider: string): Promise<StoredTokens | undefined>;
     set(userId: string, provider: string, tokens: StoredTokens): Promise<void>;
     delete(userId: string, provider: string): Promise<void>;
+    /** Run refresh-token rotation for one user/provider slot, or throw after a bounded wait. */
+    withRefresh<T>(userId: string, provider: string, callback: () => Promise<T>): Promise<T>;
 }

package/dist/chat/db.d.ts

@@ -0,0 +1,8 @@
+import type { ConversationStore } from "@/chat/conversations/store";
+import type { JuniorDatabase } from "@/chat/sql/db";
+/** Return the process Drizzle database. */
+export declare function getDb(): JuniorDatabase;
+/** Return the SQL-backed conversation store. */
+export declare function getConversationStore(): ConversationStore;
+/** Close the process SQL database when it has been opened. */
+export declare function closeDb(): Promise<void>;

package/dist/chat/mcp/auth-store.d.ts

@@ -1,6 +1,6 @@
 import type { OAuthClientInformationMixed, OAuthTokens } from "@modelcontextprotocol/sdk/shared/auth.js";
 import type { OAuthDiscoveryState } from "@modelcontextprotocol/sdk/client/auth.js";
-import type { Destination } from "@sentry/junior-plugin-api";
+import { type Destination, type Source } from "@sentry/junior-plugin-api";
 import type { ThreadArtifactsState } from "@/chat/state/artifacts";
 export interface McpAuthSessionState {
     authSessionId: string;
@@ -8,6 +8,7 @@ export interface McpAuthSessionState {
     userId: string;
     conversationId: string;
     destination?: Destination;
+    source?: Source;
     sessionId: string;
     userMessage: string;
     channelId?: string;

package/dist/chat/mcp/oauth.d.ts

@@ -1,4 +1,4 @@
-import type { Destination } from "@sentry/junior-plugin-api";
+import type { Destination, Source } from "@sentry/junior-plugin-api";
 import type { ThreadArtifactsState } from "@/chat/state/artifacts";
 import { type McpAuthSessionState } from "./auth-store";
 import { StateBackedMcpOAuthClientProvider } from "./oauth-provider";
@@ -7,6 +7,7 @@ export declare function createMcpOAuthClientProvider(input: {
     provider: string;
     conversationId: string;
     destination?: Destination;
+    source?: Source;
     sessionId: string;
     userId: string;
     userMessage: string;

package/dist/chat/oauth-flow.d.ts

@@ -1,4 +1,4 @@
-import type { Destination } from "@sentry/junior-plugin-api";
+import { type Destination, type Source } from "@sentry/junior-plugin-api";
 import type { ChannelConfigurationService } from "@/chat/configuration/types";
 type PrivateDeliveryResult = "in_context" | "fallback_dm" | false;
 export type OAuthStatePayload = {
@@ -6,6 +6,7 @@ export type OAuthStatePayload = {
     provider: string;
     channelId?: string;
     destination?: Destination;
+    source?: Source;
     threadTs?: string;
     pendingMessage?: string;
     configuration?: Record<string, unknown>;
@@ -17,6 +18,7 @@ type OAuthFlowInput = {
     requesterId: string;
     channelId?: string;
     destination?: Destination;
+    source?: Source;
     threadTs?: string;
     userMessage?: string;
     channelConfiguration?: ChannelConfigurationService;

package/dist/chat/pi/client.d.ts

@@ -9,11 +9,8 @@ export declare const MISSING_GATEWAY_CREDENTIALS_ERROR = "Missing AI gateway cre
  * the bearer token string directly.
  */
 export declare function getGatewayApiKey(): string | undefined;
-/**
- * Let pi-ai read AI_GATEWAY_API_KEY from env itself and only override the
- * token when auth comes from VERCEL_OIDC_TOKEN.
- */
-export declare function getPiGatewayApiKeyOverride(): string | undefined;
+/** Return the Gateway credential shape expected by Pi Agent getApiKey hooks. */
+export declare function getPiGatewayApiKey(): string | undefined;
 /**
  * Look up a gateway model by id. Throws `Unknown AI Gateway model id: …` if
  * the id is not in pi-ai's registry — callers at the config boundary can use
@@ -35,7 +32,7 @@ export declare function completeText(params: {
     message: import("@earendil-works/pi-ai").AssistantMessage;
     text: string;
 }>;
-/** Execute a schema-constrained completion using the traced text path above. */
+/** Execute a schema-constrained completion using the AI SDK structured output path. */
 export declare function completeObject<TSchema extends ZodTypeAny>(params: {
     modelId: string;
     schema: TSchema;
@@ -48,5 +45,16 @@ export declare function completeObject<TSchema extends ZodTypeAny>(params: {
     metadata?: Record<string, unknown>;
 }): Promise<{
     object: z.infer<TSchema>;
-    text: string;
+}>;
+/** Generate text embeddings through the host-owned AI Gateway provider. */
+export declare function embedTexts(params: {
+    modelId: string;
+    texts: string[];
+    signal?: AbortSignal;
+    metadata?: Record<string, unknown>;
+}): Promise<{
+    dimensions: number;
+    model: string;
+    provider: string;
+    vectors: number[][];
 }>;

package/dist/chat/plugins/agent-hooks.d.ts

@@ -1,10 +1,11 @@
-import type { AgentPluginConversations, AgentPluginRoute, PluginOperationalReport, SlackConversationLink, JuniorPluginRegistration } from "@sentry/junior-plugin-api";
+import type { PluginConversations, PluginRoute, PluginOperationalReport, SlackConversationLink, PluginRegistration } from "@sentry/junior-plugin-api";
+import type { PluginPromptContributionContext } from "@/chat/plugins/prompt";
 import type { ToolDefinition } from "@/chat/tools/definition";
 import type { ToolRuntimeContext } from "@/chat/tools/types";
 import type { SandboxInstance } from "@/chat/sandbox/workspace";
 import type { Requester } from "@/chat/requester";
 /** Signal that a plugin intentionally denied a tool execution. */
-export declare class AgentPluginHookDeniedError extends Error {
+export declare class PluginHookDeniedError extends Error {
     constructor(message: string);
 }
 export interface ToolHookInput {
@@ -15,28 +16,34 @@ export interface ToolHookResult {
     env: Record<string, string>;
     input: Record<string, unknown>;
 }
-export interface AgentPluginRouteRegistration extends AgentPluginRoute {
+export interface PluginRouteRegistration extends PluginRoute {
     pluginName: string;
 }
-export interface AgentPluginHookRunner {
+export interface PluginHookRunner {
     beforeToolExecute(input: ToolHookInput): Promise<ToolHookResult>;
     prepareSandbox(sandbox: SandboxInstance): Promise<void>;
 }
 /** Validate plugin identity before it can affect process-wide hooks. */
-export declare function validateAgentPlugins(plugins: JuniorPluginRegistration[]): void;
+export declare function validatePlugins(plugins: PluginRegistration[]): void;
 /** Replace runtime hook plugins and return the previous list for rollback. */
-export declare function setAgentPlugins(plugins: JuniorPluginRegistration[]): JuniorPluginRegistration[];
+export declare function setPlugins(nextPlugins: PluginRegistration[]): PluginRegistration[];
 /** Return the current runtime hook plugins without exposing mutable state. */
-export declare function getAgentPlugins(): JuniorPluginRegistration[];
+export declare function getPlugins(): PluginRegistration[];
+/** Collect stable plugin prompt contributions for the static system prompt. */
+export declare function getPluginSystemPromptContributions(source: ToolRuntimeContext["source"]): Promise<PluginPromptContributionContext[]>;
+/** Collect request-scoped plugin prompt contributions. */
+export declare function getPluginUserPromptContributions(args: {
+    context: Pick<ToolRuntimeContext, "conversationId" | "destination" | "requester" | "source" | "userText">;
+}): Promise<PluginPromptContributionContext[]>;
 /** Collect turn-scoped tools exposed by plugins. */
-export declare function getAgentPluginTools(context: ToolRuntimeContext): Record<string, ToolDefinition<any>>;
+export declare function getPluginTools(context: ToolRuntimeContext): Record<string, ToolDefinition<any>>;
 /** Collect route handlers exposed by plugins for app-level mounting. */
-export declare function getAgentPluginRoutes(): AgentPluginRouteRegistration[];
+export declare function getPluginRoutes(): PluginRouteRegistration[];
 /** Resolve the first plugin conversation URL for finalized Slack footers. */
-export declare function getAgentPluginSlackConversationLink(conversationId: string): SlackConversationLink | undefined;
+export declare function getPluginSlackConversationLink(conversationId: string): SlackConversationLink | undefined;
 /** Collect read-only operational summaries exposed by plugins. */
-export declare function getAgentPluginOperationalReports(nowMs: number, conversations: AgentPluginConversations): Promise<PluginOperationalReport[]>;
+export declare function getPluginOperationalReports(nowMs: number, conversations: PluginConversations): Promise<PluginOperationalReport[]>;
 /** Create one runner over runtime hook plugins registered by the app. */
-export declare function createAgentPluginHookRunner(input?: {
+export declare function createPluginHookRunner(input?: {
     requester?: Requester;
-}): AgentPluginHookRunner;
+}): PluginHookRunner;

package/dist/chat/plugins/auth/oauth-request.d.ts

@@ -1,3 +1,4 @@
+import { z } from "zod";
 type OAuthTokenRequestInput = {
     clientId: string;
     clientSecret: string;
@@ -5,16 +6,19 @@ type OAuthTokenRequestInput = {
     tokenAuthMethod?: "body" | "basic";
     tokenExtraHeaders?: Record<string, string>;
 };
+declare const parsedOAuthTokenResponseSchema: z.ZodObject<{
+    accessToken: z.ZodString;
+    refreshToken: z.ZodString;
+    expiresAt: z.ZodOptional<z.ZodNumber>;
+    refreshTokenExpiresAt: z.ZodOptional<z.ZodNumber>;
+    scope: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type OAuthTokenResponse = z.output<typeof parsedOAuthTokenResponseSchema>;
 export declare function buildOAuthTokenRequest(input: OAuthTokenRequestInput): {
     headers: Record<string, string>;
     body: BodyInit;
 };
-export declare function parseOAuthTokenResponse(data: Record<string, unknown>, requestedScope?: string, options?: {
+export declare function parseOAuthTokenResponse(data: unknown, requestedScope?: string, options?: {
     treatEmptyScopeAsUnreported?: boolean;
-}): {
-    accessToken: string;
-    refreshToken: string;
-    expiresAt?: number;
-    scope?: string;
-};
+}): OAuthTokenResponse;
 export {};

package/dist/chat/plugins/credential-hooks.d.ts

@@ -1,4 +1,4 @@
-import { type AgentPluginCredentialResult, type AgentPluginGrant, type AgentPluginProviderAccount } from "@sentry/junior-plugin-api";
+import { type PluginCredentialResult, type PluginGrant, type PluginProviderAccount } from "@sentry/junior-plugin-api";
 import type { StoredTokens, UserTokenStore } from "@/chat/credentials/user-token-store";
 export interface EgressGrantInput {
     bodyText?: string;
@@ -7,9 +7,9 @@ export interface EgressGrantInput {
     upstreamUrl: URL;
 }
 /** Ask a plugin which grant an outbound request needs. */
-export declare function selectPluginGrant(input: EgressGrantInput): Promise<AgentPluginGrant | undefined>;
+export declare function selectPluginGrant(input: EgressGrantInput): Promise<PluginGrant | undefined>;
 export interface EgressResponseInput {
-    grant: AgentPluginGrant;
+    grant: PluginGrant;
     method: string;
     provider: string;
     response: {
@@ -40,7 +40,7 @@ export interface IssueCredentialInput {
         type: "user";
         userId: string;
     };
-    grant: AgentPluginGrant;
+    grant: PluginGrant;
     provider: string;
     userTokenStore: UserTokenStore;
 }
@@ -48,6 +48,6 @@ export interface IssueCredentialInput {
 export declare function resolvePluginOAuthAccount(input: {
     provider: string;
     tokens: StoredTokens;
-}): Promise<AgentPluginProviderAccount | undefined>;
+}): Promise<PluginProviderAccount | undefined>;
 /** Ask a plugin to issue headers or describe why the selected grant is unavailable. */
-export declare function issuePluginCredential(input: IssueCredentialInput): Promise<AgentPluginCredentialResult>;
+export declare function issuePluginCredential(input: IssueCredentialInput): Promise<PluginCredentialResult>;

package/dist/chat/plugins/logging.d.ts

@@ -1,3 +1,3 @@
-import type { AgentPluginLogger } from "@sentry/junior-plugin-api";
+import type { PluginLogger } from "@sentry/junior-plugin-api";
 /** Create the host logger exposed to plugin hooks. */
-export declare function createAgentPluginLogger(plugin: string): AgentPluginLogger;
+export declare function createPluginLogger(plugin: string): PluginLogger;

package/dist/chat/plugins/model.d.ts

@@ -0,0 +1,9 @@
+import type { PluginEmbedder, PluginModel, PluginModelConfig } from "@sentry/junior-plugin-api";
+/** Create the host-owned structured model capability exposed to plugins. */
+export declare function createPluginModel(pluginName: string, options?: PluginModelConfig, runtime?: {
+    signal?: AbortSignal;
+}): PluginModel;
+/** Create the host-owned embedding capability exposed to prompt hooks. */
+export declare function createPluginEmbedder(pluginName: string, runtime?: {
+    signal?: AbortSignal;
+}): PluginEmbedder;

package/dist/chat/plugins/package-discovery.d.ts

@@ -2,8 +2,9 @@ export interface InstalledPluginPackageContent {
     packageNames: string[];
     packages: {
         dir: string;
+        hasMigrationsDir: boolean;
         hasSkillsDir: boolean;
-        name: string;
+        packageName: string;
     }[];
     manifestRoots: string[];
     skillRoots: string[];

package/dist/chat/plugins/prompt.d.ts

@@ -0,0 +1,5 @@
+export interface PluginPromptContributionContext {
+    id: string;
+    pluginName: string;
+    text: string;
+}

package/dist/chat/plugins/registry.d.ts

@@ -10,6 +10,10 @@ export declare function getPluginPackageContent(): InstalledPluginPackageContent
 export declare function getPluginCatalogSignature(): string;
 export declare function getPluginCapabilityProviders(): CapabilityProviderDefinition[];
 export declare function getPluginProviders(): PluginDefinition[];
+export declare function getPluginMigrationRoots(): {
+    dir: string;
+    pluginName: string;
+}[];
 export declare function getPluginMcpProviders(): PluginDefinition[];
 export declare function getPluginRuntimeDependencies(): PluginRuntimeDependency[];
 export declare function getPluginRuntimePostinstall(): PluginRuntimePostinstallCommand[];

package/dist/chat/plugins/state.d.ts

@@ -1,6 +1,4 @@
-import type { AgentPluginState } from "@sentry/junior-plugin-api";
-export interface PluginStateOptions {
-    legacyStatePrefixes?: string[];
-}
+import type { PluginState } from "@sentry/junior-plugin-api";
+import type { StateAdapter } from "chat";
 /** Create a durable state namespace scoped to one plugin. */
-export declare function createPluginState(plugin: string, options?: PluginStateOptions): AgentPluginState;
+export declare function createPluginState(plugin: string, adapter?: StateAdapter): PluginState;

package/dist/chat/plugins/task-callback.d.ts

@@ -0,0 +1,5 @@
+export declare const PLUGIN_TASK_DEV_CONSUMER_GROUP = "junior_plugin_tasks_dev";
+/** Create the Vercel Queue push callback for plugin background tasks. */
+export declare function createVercelPluginTaskCallback(): (request: Request) => Promise<Response>;
+/** Register the Vercel Queue local-dev consumer for plugin background tasks. */
+export declare function registerVercelPluginTaskDevConsumer(): (() => void) | undefined;

package/dist/chat/plugins/task-message.d.ts

@@ -0,0 +1,23 @@
+import { z } from "zod";
+export declare const pluginTaskParamsSchema: z.ZodObject<{
+    conversationId: z.ZodString;
+    sessionId: z.ZodString;
+}, z.core.$strict>;
+export type PluginTaskParams = z.output<typeof pluginTaskParamsSchema>;
+export declare const pluginTaskQueueMessageSchema: z.ZodObject<{
+    name: z.ZodString;
+    params: z.ZodObject<{
+        conversationId: z.ZodString;
+        sessionId: z.ZodString;
+    }, z.core.$strict>;
+    plugin: z.ZodString;
+}, z.core.$strict>;
+export type PluginTaskQueueMessage = z.output<typeof pluginTaskQueueMessageSchema>;
+/** Build the stable task id used for queue idempotency and tracing. */
+export declare function pluginTaskId(args: {
+    name: string;
+    params: PluginTaskParams;
+    plugin: string;
+}): string;
+/** Parse the bounded queue payload accepted by the plugin task callback. */
+export declare function parsePluginTaskQueueMessage(value: unknown): PluginTaskQueueMessage | undefined;

package/dist/chat/plugins/task-queue.d.ts

@@ -0,0 +1,5 @@
+import { type PluginTaskQueueMessage } from "./task-message";
+export declare const PLUGIN_TASK_QUEUE_TOPIC = "junior_plugin_tasks";
+export declare const PLUGIN_TASK_QUEUE_RETENTION_SECONDS: number;
+/** Send one plugin task wakeup through Vercel Queues. */
+export declare function sendVercelPluginTask(message: PluginTaskQueueMessage): Promise<void>;

package/dist/chat/plugins/task-runner.d.ts

@@ -0,0 +1,12 @@
+import { type PluginTaskParams, type PluginTaskQueueMessage } from "./task-message";
+export interface ScheduleSessionCompletedPluginTasksOptions {
+    send?: (message: PluginTaskQueueMessage) => Promise<void>;
+}
+interface ProcessPluginTaskOptions {
+    signal?: AbortSignal;
+}
+/** Schedule all plugin tasks interested in a completed agent-run session. */
+export declare function scheduleSessionCompletedPluginTasks(params: PluginTaskParams, options?: ScheduleSessionCompletedPluginTasksOptions): Promise<void>;
+/** Execute one parsed plugin task request. */
+export declare function processPluginTask(message: PluginTaskQueueMessage, options?: ProcessPluginTaskOptions): Promise<void>;
+export {};

package/dist/chat/plugins/task-signing.d.ts

@@ -0,0 +1,31 @@
+import { z } from "zod";
+import { type PluginTaskQueueMessage } from "./task-message";
+export declare const PLUGIN_TASK_QUEUE_SIGNATURE_MAX_SKEW_MS: number;
+export type PluginTaskQueueRejectReason = "expired" | "malformed" | "signature_mismatch";
+type VerificationResult = {
+    message: PluginTaskQueueMessage;
+    status: "verified";
+} | {
+    reason: PluginTaskQueueRejectReason;
+    status: "rejected";
+} | {
+    reason: "invalid_clock" | "missing_secret";
+    status: "unavailable";
+};
+declare const signedPluginTaskQueueMessageSchema: z.ZodObject<{
+    name: z.ZodString;
+    params: z.ZodObject<{
+        conversationId: z.ZodString;
+        sessionId: z.ZodString;
+    }, z.core.$strict>;
+    plugin: z.ZodString;
+    signature: z.ZodString;
+    signatureVersion: z.ZodLiteral<"v1">;
+    signedAtMs: z.ZodNumber;
+}, z.core.$strict>;
+type SignedPluginTaskQueueMessage = z.output<typeof signedPluginTaskQueueMessageSchema>;
+/** Sign a plugin task payload before it crosses the public queue callback. */
+export declare function signPluginTaskQueueMessage(message: PluginTaskQueueMessage, nowMs?: number): SignedPluginTaskQueueMessage;
+/** Verify a plugin task payload from the public queue callback route. */
+export declare function verifyPluginTaskQueueMessage(value: unknown, nowMs?: number): VerificationResult;
+export {};

package/dist/chat/plugins/types.d.ts

@@ -143,6 +143,7 @@ export interface PluginBrokerDeps {
 export interface PluginDefinition {
     manifest: PluginManifest;
     dir: string;
+    migrationsDir?: string;
     skillsDir?: string;
 }
 export interface InlinePluginManifestDefinition {

package/dist/chat/plugins/validation.d.ts

@@ -0,0 +1,5 @@
+import type { PluginRegistration } from "@sentry/junior-plugin-api";
+/** Validate hook registrations against the loaded plugin manifest catalog. */
+export declare function validatePluginRegistrations(registrations: PluginRegistration[]): void;
+/** Validate credential hook registrations against the loaded plugin manifests. */
+export declare function validatePluginEgressCredentialHooks(registrations: PluginRegistration[]): void;

package/dist/chat/prompt.d.ts

@@ -2,7 +2,8 @@ import type { SlackConversationContext } from "@/chat/slack/conversation-context
 import type { ThreadArtifactsState } from "@/chat/state/artifacts";
 import type { SkillMetadata, SkillInvocation } from "@/chat/skills";
 import type { ActiveMcpCatalogSummary } from "@/chat/tools/skill/mcp-tool-summary";
-import type { Source } from "@sentry/junior-plugin-api";
+import type { PluginPromptContributionContext } from "@/chat/plugins/prompt";
+import type { Destination, Source } from "@sentry/junior-plugin-api";
 export declare const JUNIOR_PERSONALITY: string;
 export declare const JUNIOR_WORLD: string | null;
 interface ToolPromptContext {
@@ -10,15 +11,28 @@ interface ToolPromptContext {
     promptGuidelines?: string[];
     promptSnippet?: string;
 }
+/** Render plugin system prompt additions under a core-owned wrapper. */
+export declare function buildPluginSystemPromptContributions(contributions: PluginPromptContributionContext[]): string | null;
 type TurnContextPromptInput = {
     availableSkills: SkillMetadata[];
     activeMcpCatalogs?: ActiveMcpCatalogSummary[];
     includeSessionContext?: boolean;
+    pluginPromptContributions?: PluginPromptContributionContext[];
     toolGuidance?: ToolPromptContext[];
     runtime?: {
         conversationId?: string;
         slackConversation?: SlackConversationContext;
     };
+    dispatch?: {
+        actor?: {
+            id: string;
+            type: string;
+        };
+        destination: Destination;
+        metadata?: Record<string, string>;
+        plugin?: string;
+        source: Source;
+    };
     invocation: SkillInvocation | null;
     requester?: {
         userName?: string;

package/dist/chat/requester.d.ts

@@ -2,8 +2,7 @@
  * Canonical requester identity.
  *
  * Runtime requesters are platform-scoped actors. Stored Slack requester parsing
- * remains explicit so legacy durable records can resume without repairing
- * malformed team or user ids.
+ * remains explicit so durable conversation metadata is not repaired on read.
  */
 import { z } from "zod";
 export declare const storedSlackRequesterSchema: z.ZodObject<{
@@ -34,6 +33,8 @@ export interface SlackRequesterProfile {
     userName?: string;
 }
 export type StoredSlackRequester = z.output<typeof storedSlackRequesterSchema>;
+/** Parse a serialized runtime requester that crossed a durable boundary. */
+export declare function parseRequester(value: unknown): Requester | undefined;
 interface RequesterInput {
     email?: string;
     fullName?: string;
@@ -58,9 +59,9 @@ export declare function createSlackRequester(teamId: string, userId: string, pro
 export declare function parseStoredSlackRequester(value: unknown): StoredSlackRequester | undefined;
 /** Convert a runtime Slack requester into its durable session shape. */
 export declare function toStoredSlackRequester(requester: SlackRequester): StoredSlackRequester;
-/** Rebuild a runtime requester from durable Slack requester state. */
-export declare function createRequesterFromStoredSlackRequester(args: {
-    requester?: StoredSlackRequester;
+/** Resolve a Slack resume requester from stored runtime identity and the active actor. */
+export declare function createSlackResumeRequester(args: {
+    requester?: Requester;
     teamId: string;
     userId: string;
 }): SlackRequester;

package/dist/chat/respond-helpers.d.ts

@@ -59,6 +59,8 @@ export declare function isToolResultMessage(value: unknown): value is ToolResult
 export declare function normalizeToolNameFromResult(result: unknown): string | undefined;
 /** Check whether a tool result carries an error flag. */
 export declare function isToolResultError(result: unknown): boolean;
+/** Extract tool names that completed successfully from raw Pi messages. */
+export declare function getSuccessfulToolCalls(messages: readonly unknown[]): string[];
 /** Type guard for Pi SDK assistant messages. */
 export declare function isAssistantMessage(value: unknown): value is AssistantMessage;
 /** Extract role string from a raw Pi message. */