@sentry/junior 0.74.0 → 0.75.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/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/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

@@ -19,11 +19,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/conversations/configured.d.ts

@@ -3,3 +3,5 @@ import type { ConversationStore } from "./store";
 export declare function getConfiguredConversationStore(): ConversationStore;
 /** Return whether conversation records use the configured SQL store. */
 export declare function hasConfiguredSqlConversationStore(): boolean;
+/** Close the configured SQL conversation store if one has been created. */
+export declare function closeConfiguredConversationStore(): Promise<void>;

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/plugins/agent-hooks.d.ts

@@ -1,10 +1,10 @@
-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 { 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 +15,28 @@ 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 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/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/db.d.ts

@@ -0,0 +1,31 @@
+import type { PluginDb, PluginRegistration } from "@sentry/junior-plugin-api";
+import type { JuniorSqlMigrationExecutor } from "@/chat/sql/db";
+export interface PluginMigration {
+    checksum: string;
+    filename: string;
+    id: string;
+    pluginName: string;
+    sql: string;
+}
+export interface PluginMigrationRoot {
+    /** Absolute path to the plugin's migrations directory. */
+    dir: string;
+    pluginName: string;
+}
+export interface PluginMigrationResult {
+    existing: number;
+    migrated: number;
+    scanned: number;
+}
+/** Close the configured plugin DB executor if one has been created. */
+export declare function closeConfiguredPluginDb(): Promise<void>;
+/** Adapt the shared Junior SQL executor to the plugin-facing DB surface. */
+export declare function createPluginDbForExecutor(executor: JuniorSqlMigrationExecutor): PluginDb;
+/** Return a configured plugin DB only for plugins that declare database usage. */
+export declare function getPluginDbForRegistration(registration: PluginRegistration): PluginDb | undefined;
+/** Fail early when a plugin declares DB access without SQL config. */
+export declare function validatePluginDatabaseRequirements(registrations: PluginRegistration[]): void;
+/** Read committed SQL migration artifacts for one enabled plugin root. */
+export declare function readPluginMigrations(root: PluginMigrationRoot): PluginMigration[];
+/** Apply plugin-owned SQL migrations after core Junior migrations. */
+export declare function migratePluginSchemas(executor: JuniorSqlMigrationExecutor, migrations: readonly PluginMigration[]): Promise<PluginMigrationResult>;

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/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/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/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,7 @@ 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 { Destination, Source } from "@sentry/junior-plugin-api";
 export declare const JUNIOR_PERSONALITY: string;
 export declare const JUNIOR_WORLD: string | null;
 interface ToolPromptContext {
@@ -19,6 +19,16 @@ type TurnContextPromptInput = {
         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/respond.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 { ChannelConfigurationService } from "@/chat/configuration/types";
 import type { ThreadArtifactsState } from "@/chat/state/artifacts";
 import type { ConversationPendingAuthState } from "@/chat/state/conversation";
@@ -18,9 +18,18 @@ export interface ReplyRequestContext {
     skillDirs?: string[];
     credentialContext?: CredentialContext;
     requester?: Requester;
+    source?: Source;
     slackConversation?: SlackConversationContext;
     destination: Destination;
     surface?: AgentTurnSurface;
+    dispatch?: {
+        actor?: {
+            id: string;
+            type: string;
+        };
+        metadata?: Record<string, string>;
+        plugin?: string;
+    };
     correlation?: {
         conversationId?: string;
         threadId?: string;

package/dist/chat/runtime/slack-runtime.d.ts

@@ -19,9 +19,14 @@ export interface AssistantLifecycleEvent {
     threadTs: string;
     userId?: string;
 }
+export interface SteeringCandidateMessage {
+    activeRequest: boolean;
+    inboundMessageId: string;
+    message: Message;
+}
 export interface ReplyHooks {
     beforeFirstResponsePost?: () => Promise<void>;
-    drainSteeringMessages?: (inject: (messages: Message[]) => Promise<void>) => Promise<Message[]>;
+    drainSteeringMessages?: (inject: (messages: SteeringCandidateMessage[]) => Promise<readonly string[] | void>) => Promise<void>;
     messageContext?: MessageContext;
     onInputCommitted?: () => Promise<void>;
     onToolInvocation?: (invocation: TurnToolInvocation) => void;

package/dist/chat/sandbox/egress-credentials.d.ts

@@ -1,22 +1,22 @@
-import type { AgentPluginAuthorization, AgentPluginGrant } from "@sentry/junior-plugin-api";
+import type { PluginAuthorization, PluginGrant } from "@sentry/junior-plugin-api";
 import { type SandboxEgressCredentialContext, type SandboxEgressCredentialLease } from "@/chat/sandbox/egress-session";
 export type SandboxEgressGrantSelection = {
-    grant: AgentPluginGrant;
+    grant: PluginGrant;
     source: "plugin";
 } | {
-    grant: AgentPluginGrant;
+    grant: PluginGrant;
     source: "broker";
 };
 export type SandboxEgressCredentialErrorKind = "auth_required" | "unavailable";
 /** Signals that egress selected a grant but could not issue credential headers. */
 export declare class SandboxEgressCredentialError extends Error {
-    readonly authorization?: AgentPluginAuthorization;
-    readonly grant: AgentPluginGrant;
+    readonly authorization?: PluginAuthorization;
+    readonly grant: PluginGrant;
     readonly kind: SandboxEgressCredentialErrorKind;
     readonly provider: string;
     constructor(input: {
-        authorization?: AgentPluginAuthorization;
-        grant: AgentPluginGrant;
+        authorization?: PluginAuthorization;
+        grant: PluginGrant;
         kind: SandboxEgressCredentialErrorKind;
         message: string;
         provider: string;
@@ -30,7 +30,7 @@ export declare function selectSandboxEgressGrant(input: {
     upstreamUrl: URL;
 }): Promise<SandboxEgressGrantSelection>;
 /** Resolve the authorization flow attached to a broker-selected egress grant. */
-export declare function authorizationForSandboxEgressGrant(provider: string, selection: SandboxEgressGrantSelection): AgentPluginAuthorization | undefined;
+export declare function authorizationForSandboxEgressGrant(provider: string, selection: SandboxEgressGrantSelection): PluginAuthorization | undefined;
 /** Return a cached or newly issued credential lease for a selected grant. */
 export declare function sandboxEgressCredentialLease(provider: string, selection: SandboxEgressGrantSelection, context: SandboxEgressCredentialContext): Promise<SandboxEgressCredentialLease>;
 /** Return whether a credential lease can modify requests to the target host. */

package/dist/chat/sandbox/sandbox.d.ts

@@ -2,7 +2,7 @@ import { type LogContext } from "@/chat/logging";
 import { type SandboxEgressAuthRequiredSignal, type SandboxEgressPermissionDeniedSignal } from "@/chat/sandbox/egress-session";
 import type { SandboxEgressTracePropagationConfig } from "@/chat/sandbox/egress-tracing";
 import type { CredentialContext } from "@/chat/credentials/context";
-import type { AgentPluginHookRunner } from "@/chat/plugins/agent-hooks";
+import type { PluginHookRunner } from "@/chat/plugins/agent-hooks";
 import type { SandboxInstance } from "@/chat/sandbox/workspace";
 import type { SkillMetadata } from "@/chat/skills";
 interface SandboxExecutionInput {
@@ -49,7 +49,7 @@ export declare function createSandboxExecutor(options?: {
     traceContext?: LogContext;
     tracePropagation?: SandboxEgressTracePropagationConfig;
     credentialEgress?: CredentialContext;
-    agentHooks?: AgentPluginHookRunner;
+    agentHooks?: PluginHookRunner;
     onSandboxAcquired?: (sandbox: SandboxAcquiredState) => void | Promise<void>;
     runBashCustomCommand?: (command: string) => Promise<{
         handled: boolean;

package/dist/chat/sql/db.d.ts

@@ -18,3 +18,6 @@ export interface JuniorSqlMigrationExecutor extends JuniorSqlDatabase {
     execute(statement: string, params?: readonly unknown[]): Promise<void>;
     query<T = unknown>(statement: string, params?: readonly unknown[]): Promise<T[]>;
 }
+export interface JuniorSqlExecutor extends JuniorSqlMigrationExecutor {
+    close(): Promise<void>;
+}

package/dist/chat/sql/executor.d.ts

@@ -0,0 +1,7 @@
+import type { JuniorSqlExecutor } from "./db";
+import type { SqlDriver } from "@/chat/config";
+/** Create the SQL executor appropriate for the configured database URL. */
+export declare function createJuniorSqlExecutor(args: {
+    connectionString: string;
+    driver: SqlDriver;
+}): JuniorSqlExecutor;

package/dist/chat/sql/neon.d.ts

@@ -1,8 +1,6 @@
-import type { JuniorSqlMigrationExecutor } from "./db";
+import type { JuniorSqlExecutor } from "./db";
 /** Neon-backed SQL executor with an owned connection pool lifecycle. */
-export interface NeonJuniorSqlExecutor extends JuniorSqlMigrationExecutor {
-    close(): Promise<void>;
-}
+export type NeonJuniorSqlExecutor = JuniorSqlExecutor;
 /** Create the shared Neon-backed Junior SQL executor. */
 export declare function createNeonJuniorSqlExecutor(args: {
     connectionString: string;

package/dist/chat/sql/postgres.d.ts

@@ -0,0 +1,6 @@
+import type { JuniorSqlExecutor } from "./db";
+/** Create the shared Node Postgres-backed Junior SQL executor. */
+export declare function createPostgresJuniorSqlExecutor(args: {
+    applicationName?: string;
+    connectionString: string;
+}): JuniorSqlExecutor;

package/dist/chat/task-execution/state.d.ts

@@ -146,10 +146,15 @@ export declare function checkInConversationWork(args: {
     nowMs?: number;
     state?: StateAdapter;
 }): Promise<boolean>;
-/** Drain pending mailbox entries after the caller has durably injected them. */
+/**
+ * Drain pending mailbox entries after the caller acknowledges durable handling.
+ *
+ * Returning ids acknowledges only that subset; returning nothing acknowledges
+ * every offered pending entry.
+ */
 export declare function drainConversationMailbox(args: {
     conversationId: string;
-    inject: (messages: InboundMessage[]) => Promise<void>;
+    inject: (messages: InboundMessage[]) => Promise<readonly string[] | void>;
     leaseToken: string;
     nowMs?: number;
     state?: StateAdapter;

package/dist/chat/task-execution/worker.d.ts

@@ -9,7 +9,7 @@ export interface ConversationWorkerContext {
     checkIn(): Promise<boolean>;
     conversationId: string;
     destination: Destination;
-    drainMailbox(inject: (messages: InboundMessage[]) => Promise<void>): Promise<InboundMessage[]>;
+    drainMailbox(inject: (messages: InboundMessage[]) => Promise<readonly string[] | void>): Promise<InboundMessage[]>;
     leaseToken: string;
     shouldYield(): boolean;
 }

package/dist/chat/tools/agent-tools.d.ts

@@ -6,6 +6,6 @@ import type { AssistantStatusSpec } from "@/chat/slack/assistant-thread/status";
 import type { SandboxExecutor } from "@/chat/sandbox/sandbox";
 import type { SkillSandbox } from "@/chat/sandbox/skill-sandbox";
 import type { ToolDefinition } from "@/chat/tools/definition";
-import type { AgentPluginHookRunner } from "@/chat/plugins/agent-hooks";
+import type { PluginHookRunner } from "@/chat/plugins/agent-hooks";
 /** Wrap tool definitions into Pi Agent tool objects with logging, validation, and sandbox execution. */
-export declare function createAgentTools(tools: Record<string, ToolDefinition<any>>, sandbox: SkillSandbox, spanContext: LogContext, onStatus?: (status: AssistantStatusSpec) => void | Promise<void>, sandboxExecutor?: SandboxExecutor, pluginAuthOrchestration?: PluginAuthOrchestration, onToolCall?: (toolName: string, params: Record<string, unknown>) => void, agentHooks?: AgentPluginHookRunner, conversationPrivacy?: ConversationPrivacy): AgentTool[];
+export declare function createAgentTools(tools: Record<string, ToolDefinition<any>>, sandbox: SkillSandbox, spanContext: LogContext, onStatus?: (status: AssistantStatusSpec) => void | Promise<void>, sandboxExecutor?: SandboxExecutor, pluginAuthOrchestration?: PluginAuthOrchestration, onToolCall?: (toolName: string, params: Record<string, unknown>) => void, agentHooks?: PluginHookRunner, conversationPrivacy?: ConversationPrivacy): AgentTool[];

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

@@ -2,6 +2,7 @@ import type { FileUpload } from "chat";
 import type { Destination, LocalDestination, LocalSource, SlackDestination, SlackSource, Source } from "@sentry/junior-plugin-api";
 import type { McpToolManager } from "@/chat/mcp/tool-manager";
 import type { SandboxWorkspace } from "@/chat/sandbox/workspace";
+import type { AgentTurnSurface } from "@/chat/state/turn-session";
 import type { ThreadArtifactsState } from "@/chat/state/artifacts";
 import type { Skill } from "@/chat/skills";
 import type { LoadSkillMetadata } from "@/chat/tools/skill/load-skill";
@@ -48,6 +49,8 @@ interface BaseToolRuntimeContext {
     requester?: Requester;
     /** Runtime-owned source where this invocation came from. */
     source: Source;
+    /** Runtime surface that owns final delivery semantics for this turn. */
+    surface?: AgentTurnSurface;
     userText?: string;
     artifactState?: ThreadArtifactsState;
     configuration?: Record<string, unknown>;

package/dist/{chunk-7Q5YOUUT.js → chunk-2RWFUS5F.js}

@@ -2,15 +2,19 @@ import {
   discoverInstalledPluginPackageContent,
   normalizePluginPackageNames,
   pluginRoots
-} from "./chunk-KVZL5NZS.js";
+} from "./chunk-Q3XNY442.js";
 import {
   parseActorUserId
-} from "./chunk-CYUI7JU5.js";
+} from "./chunk-EIYL7I4S.js";
 import {
   logInfo,
   logWarn,
   setSpanAttributes
-} from "./chunk-3BYAPS6B.js";
+} from "./chunk-OK4KKR7B.js";
+
+// src/chat/plugins/registry.ts
+import { readFileSync, readdirSync, statSync } from "fs";
+import path from "path";
 
 // src/chat/plugins/manifest.ts
 import { z } from "zod";
@@ -1064,10 +1068,6 @@ function parseInlinePluginManifest(manifest, dir, config) {
   });
 }
 
-// src/chat/plugins/registry.ts
-import { readFileSync, readdirSync, statSync } from "fs";
-import path from "path";
-
 // src/chat/plugins/auth/oauth-bearer-broker.ts
 import { randomUUID as randomUUID2 } from "crypto";
 
@@ -1523,6 +1523,7 @@ function createLoadedPluginState(signature) {
   return {
     signature,
     pluginDefinitions: [],
+    pluginMigrationRoots: /* @__PURE__ */ new Map(),
     capabilityToPlugin: /* @__PURE__ */ new Map(),
     domainToPlugin: /* @__PURE__ */ new Map(),
     pluginConfigKeys: /* @__PURE__ */ new Set(),
@@ -1538,7 +1539,7 @@ function providerDomains(manifest) {
     ])
   ].sort((left, right) => left.localeCompare(right));
 }
-function registerPluginManifest(state, manifest, pluginDir, skillsDir) {
+function registerPluginManifest(state, manifest, pluginDir, skillsDir, migrationsDir) {
   if (state.pluginsByName.has(manifest.name)) {
     throw new Error(`Duplicate plugin name "${manifest.name}"`);
   }
@@ -1560,10 +1561,14 @@ function registerPluginManifest(state, manifest, pluginDir, skillsDir) {
   const definition = {
     manifest,
     dir: pluginDir,
+    ...migrationsDir ? { migrationsDir } : {},
     ...skillsDir ? { skillsDir } : {}
   };
   state.pluginDefinitions.push(definition);
   state.pluginsByName.set(manifest.name, definition);
+  if (definition.migrationsDir) {
+    state.pluginMigrationRoots.set(manifest.name, definition.migrationsDir);
+  }
   for (const cap of manifest.capabilities) {
     state.capabilityToPlugin.set(cap, definition);
   }
@@ -1613,6 +1618,14 @@ function getPluginCatalogSource() {
     signature: JSON.stringify({
       inlineManifests,
       manifestRoots,
+      packages: packagedContent.packages.map((pkg) => ({
+        dir: path.resolve(pkg.dir),
+        hasMigrationsDir: pkg.hasMigrationsDir,
+        hasSkillsDir: pkg.hasSkillsDir,
+        packageName: pkg.packageName
+      })).sort(
+        (left, right) => left.packageName.localeCompare(right.packageName)
+      ),
       packagedSkillRoots,
       packageNames: [...packagedContent.packageNames].sort(),
       pluginConfig: pluginConfig ?? {}
@@ -1640,19 +1653,34 @@ function clonePluginCatalogConfig(config) {
   };
 }
 function packageContentByName(packagedContent, packageName) {
-  return packagedContent.packages.find((pkg) => pkg.name === packageName);
+  return packagedContent.packages.find(
+    (pkg) => pkg.packageName === packageName
+  );
 }
 function registerInlineManifests(state, source) {
+  const migrationOwners = /* @__PURE__ */ new Map();
   for (const definition of source.inlineManifests) {
     const pkg = definition.packageName ? packageContentByName(source.packagedContent, definition.packageName) : void 0;
     const dir = pkg?.dir ?? process.cwd();
     const skillsDir = pkg?.hasSkillsDir ? path.join(pkg.dir, "skills") : void 0;
+    const migrationsDir = pkg?.hasMigrationsDir && statSync(path.join(pkg.dir, "migrations"), {
+      throwIfNoEntry: false
+    })?.isDirectory() ? path.join(pkg.dir, "migrations") : void 0;
     const manifest = parseInlinePluginManifest(
       definition.manifest,
       dir,
       pluginConfig
     );
-    registerPluginManifest(state, manifest, dir, skillsDir);
+    if (migrationsDir) {
+      const owner = migrationOwners.get(migrationsDir);
+      if (owner) {
+        throw new Error(
+          `Plugin "${manifest.name}" cannot share migrations directory with plugin "${owner}"`
+        );
+      }
+      migrationOwners.set(migrationsDir, manifest.name);
+    }
+    registerPluginManifest(state, manifest, dir, skillsDir, migrationsDir);
   }
 }
 function discoverConfiguredPluginPackageContent() {
@@ -1801,6 +1829,10 @@ function getPluginCapabilityProviders() {
 function getPluginProviders() {
   return [...ensurePluginsLoaded().pluginDefinitions];
 }
+function getPluginMigrationRoots() {
+  const state = ensurePluginsLoaded();
+  return [...state.pluginMigrationRoots.entries()].map(([pluginName, dir]) => ({ pluginName, dir })).sort((left, right) => left.pluginName.localeCompare(right.pluginName));
+}
 function getPluginMcpProviders() {
   return ensurePluginsLoaded().pluginDefinitions.filter(
     (plugin) => Boolean(plugin.manifest.mcp)
@@ -1897,6 +1929,9 @@ function getPluginDisplayName(provider) {
 function isPluginProvider(provider) {
   return ensurePluginsLoaded().pluginsByName.has(provider);
 }
+function isPluginCapability(capability) {
+  return ensurePluginsLoaded().capabilityToPlugin.has(capability);
+}
 function isPluginConfigKey(key) {
   return ensurePluginsLoaded().pluginConfigKeys.has(key);
 }
@@ -1940,6 +1975,7 @@ export {
   getPluginCatalogSignature,
   getPluginCapabilityProviders,
   getPluginProviders,
+  getPluginMigrationRoots,
   getPluginMcpProviders,
   getPluginRuntimeDependencies,
   getPluginRuntimePostinstall,
@@ -1949,6 +1985,7 @@ export {
   getPluginDefinition,
   getPluginDisplayName,
   isPluginProvider,
+  isPluginCapability,
   isPluginConfigKey,
   createPluginBroker
 };