@sentry/junior 0.74.1 → 0.76.0

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";
@@ -8,6 +8,7 @@ import { type SandboxAcquiredState } from "@/chat/sandbox/sandbox";
 import type { SandboxEgressTracePropagationConfig } from "@/chat/sandbox/egress-tracing";
 import type { AssistantStatusSpec } from "@/chat/slack/assistant-thread/status";
 import type { SlackConversationContext } from "@/chat/slack/conversation-context";
+import { type ToolExecutionReport } from "@/chat/tools/agent-tools";
 import { type AssistantReply, type AgentTurnDiagnostics } from "@/chat/services/turn-result";
 import type { AgentTurnSurface } from "@/chat/state/turn-session";
 import type { CredentialContext } from "@/chat/credentials/context";
@@ -18,9 +19,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;
@@ -71,7 +81,8 @@ export interface ReplyRequestContext {
     onToolInvocation?: (invocation: {
         toolName: string;
         params: Record<string, unknown>;
-    }) => void;
+    }) => void | Promise<void>;
+    onToolResult?: (result: ToolExecutionReport) => void | Promise<void>;
 }
 export type AssistantReplyRequestContext = ReplyRequestContext;
 export interface ReplyRequestAttachment {

package/dist/chat/runtime/agent-continue-runner.d.ts

@@ -6,6 +6,10 @@ export interface AgentContinueRunnerOptions {
     generateReply?: typeof generateAssistantReply;
     resumeTurn?: typeof resumeSlackTurn;
     scheduleAgentContinue?: (request: AgentContinueRequest) => Promise<void>;
+    scheduleSessionCompletedPluginTasks?: (params: {
+        conversationId: string;
+        sessionId: string;
+    }) => Promise<void>;
 }
 /**
  * Continue one paused Slack agent run from durable conversation state.

package/dist/chat/runtime/reply-executor.d.ts

@@ -8,7 +8,7 @@
  */
 import type { Message, Thread } from "chat";
 import type { SlackAdapter } from "@chat-adapter/slack";
-import type { Destination } from "@sentry/junior-plugin-api";
+import { type Destination } from "@sentry/junior-plugin-api";
 import { generateAssistantReply as generateAssistantReplyImpl } from "@/chat/respond";
 import type { PreparedTurnState } from "@/chat/runtime/turn-preparation";
 import { type PrepareTurnStateInput, type QueuedTurnMessage, type TurnToolInvocation } from "@/chat/runtime/turn-input";
@@ -26,6 +26,10 @@ export interface ReplyExecutorServices {
     }) => Promise<AgentContinueRequest | undefined>;
     lookupSlackUser: typeof lookupSlackUser;
     scheduleAgentContinue: (request: AgentContinueRequest) => Promise<void>;
+    scheduleSessionCompletedPluginTasks: (params: {
+        conversationId: string;
+        sessionId: string;
+    }) => Promise<void>;
 }
 interface ReplyExecutorDeps {
     getSlackAdapter: () => SlackAdapter;

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

@@ -1,4 +1,5 @@
 import { generateAssistantReply, type AssistantReply, type AssistantReplyRequestContext } from "@/chat/respond";
+import type { Source } from "@sentry/junior-plugin-api";
 /** Error raised when another worker already owns the resume lock. */
 export declare class ResumeTurnBusyError extends Error {
     constructor(lockKey: string);
@@ -8,10 +9,14 @@ interface ResumeSlackTurnArgs {
     channelId: string;
     threadTs: string;
     messageTs?: string;
-    replyContext?: AssistantReplyRequestContext;
+    replyContext?: ResumeReplyContext;
     lockKey?: string;
     initialText?: string;
     generateReply?: typeof generateAssistantReply;
+    scheduleSessionCompletedPluginTasks?: (params: {
+        conversationId: string;
+        sessionId: string;
+    }) => Promise<void>;
     onSuccess?: (reply: AssistantReply) => Promise<void>;
     onFailure?: (error: unknown) => Promise<void>;
     onAuthPause?: (error: unknown) => Promise<void>;
@@ -20,6 +25,9 @@ interface ResumeSlackTurnArgs {
     beforeStart?: () => Promise<Partial<ResumeSlackTurnArgs> | false | void>;
     replyTimeoutMs?: number;
 }
+type ResumeReplyContext = AssistantReplyRequestContext & {
+    source: Source;
+};
 /**
  * Resume a paused Slack turn under the normal thread lock.
  *
@@ -35,7 +43,7 @@ export declare function resumeAuthorizedRequest(args: {
     threadTs: string;
     messageTs?: string;
     connectedText: string;
-    replyContext?: AssistantReplyRequestContext;
+    replyContext?: ResumeReplyContext;
     lockKey?: string;
     generateReply?: typeof generateAssistantReply;
     onSuccess?: (reply: AssistantReply) => Promise<void>;

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

@@ -1,2 +1,3 @@
 /** Sentry SDK re-export. Isolates the concrete package to a single file. */
+export { captureException, continueTrace, flush, getClient, getGlobalScope, init, setTag, setUser, startInactiveSpan, startSpan, vercelAIIntegration, withActiveSpan, withScope, } from "@sentry/node";
 export * from "@sentry/node";

package/dist/chat/services/mcp-auth-orchestration.d.ts

@@ -1,5 +1,5 @@
 import type { OAuthClientProvider } from "@modelcontextprotocol/sdk/client/auth.js";
-import type { Destination } from "@sentry/junior-plugin-api";
+import type { Destination, Source } from "@sentry/junior-plugin-api";
 import { AuthorizationPauseError, type AuthorizationFlowMode } from "@/chat/services/auth-pause";
 import type { ThreadArtifactsState } from "@/chat/state/artifacts";
 import type { ConversationPendingAuthState } from "@/chat/state/conversation";
@@ -14,6 +14,7 @@ export interface McpAuthOrchestrationInput {
     requesterId?: string;
     channelId?: string;
     destination?: Destination;
+    source?: Source;
     threadTs?: string;
     toolChannelId?: string;
     userMessage: string;

package/dist/chat/services/plugin-auth-orchestration.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 { UserTokenStore } from "@/chat/credentials/user-token-store";
 import { AuthorizationPauseError, type AuthorizationFlowMode } from "@/chat/services/auth-pause";
@@ -17,6 +17,7 @@ export interface PluginAuthOrchestrationInput {
     requesterId?: string;
     channelId?: string;
     destination?: Destination;
+    source?: Source;
     threadTs?: string;
     userMessage: string;
     channelConfiguration?: ChannelConfigurationService;

package/dist/chat/services/subscribed-decision.d.ts

@@ -31,10 +31,10 @@ export interface SubscribedDecisionResult {
 }
 declare const replyDecisionSchema: z.ZodObject<{
     should_reply: z.ZodBoolean;
-    should_unsubscribe: z.ZodOptional<z.ZodBoolean>;
+    should_unsubscribe: z.ZodBoolean;
     confidence: z.ZodNumber;
     reason: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
+}, z.core.$strict>;
 /** Fast heuristic check before the LLM classifier — skips messages directed at another party. */
 export declare function getSubscribedReplyPreflightDecision(args: {
     botUserName: string;

package/dist/chat/services/turn-session-record.d.ts

@@ -1,6 +1,5 @@
 import { type AgentTurnSessionRecord, type AgentTurnSurface } from "@/chat/state/turn-session";
-import type { StoredSlackRequester } from "@/chat/requester";
-import type { Destination } from "@sentry/junior-plugin-api";
+import type { Destination, Requester, Source } from "@sentry/junior-plugin-api";
 import type { PiMessage } from "@/chat/pi/messages";
 import { type AgentTurnUsage } from "@/chat/usage";
 export declare const AGENT_CONTINUE_MAX_SLICES = 48;
@@ -29,12 +28,13 @@ export declare function persistRunningSessionRecord(args: {
     channelName?: string;
     conversationId: string;
     destination?: Destination;
+    source?: Source;
     sessionId: string;
     sliceId: number;
     messages: PiMessage[];
     loadedSkillNames?: string[];
     logContext: SessionRecordLogContext;
-    requester?: StoredSlackRequester;
+    requester?: Requester;
     surface?: AgentTurnSurface;
     turnStartMessageIndex?: number;
 }): Promise<boolean>;
@@ -45,12 +45,13 @@ export declare function persistCompletedSessionRecord(args: {
     currentDurationMs?: number;
     currentUsage?: AgentTurnUsage;
     destination?: Destination;
+    source?: Source;
     sessionId: string;
     sliceId: number;
     allMessages: PiMessage[];
     loadedSkillNames?: string[];
     logContext: SessionRecordLogContext;
-    requester?: StoredSlackRequester;
+    requester?: Requester;
     surface?: AgentTurnSurface;
     turnStartMessageIndex?: number;
 }): Promise<void>;
@@ -66,11 +67,12 @@ export declare function persistAuthPauseSessionRecord(args: {
     currentDurationMs?: number;
     currentUsage?: AgentTurnUsage;
     destination?: Destination;
+    source?: Source;
     messages: PiMessage[];
     loadedSkillNames?: string[];
     errorMessage: string;
     logContext: SessionRecordLogContext;
-    requester?: StoredSlackRequester;
+    requester?: Requester;
     surface?: AgentTurnSurface;
 }): Promise<AgentTurnSessionRecord | undefined>;
 /**
@@ -85,11 +87,12 @@ export declare function persistTimeoutSessionRecord(args: {
     currentDurationMs?: number;
     currentUsage?: AgentTurnUsage;
     destination?: Destination;
+    source?: Source;
     messages: PiMessage[];
     loadedSkillNames?: string[];
     errorMessage: string;
     logContext: SessionRecordLogContext;
-    requester?: StoredSlackRequester;
+    requester?: Requester;
     surface?: AgentTurnSurface;
 }): Promise<AgentTurnSessionRecord | undefined>;
 /**
@@ -103,11 +106,12 @@ export declare function persistYieldSessionRecord(args: {
     currentDurationMs?: number;
     currentUsage?: AgentTurnUsage;
     destination?: Destination;
+    source?: Source;
     messages: PiMessage[];
     loadedSkillNames?: string[];
     errorMessage: string;
     logContext: SessionRecordLogContext;
-    requester?: StoredSlackRequester;
+    requester?: Requester;
     surface?: AgentTurnSurface;
 }): Promise<AgentTurnSessionRecord | undefined>;
 export {};

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/state/turn-session.d.ts

@@ -1,6 +1,6 @@
-import type { Destination } from "@sentry/junior-plugin-api";
+import { type Destination, type Source } from "@sentry/junior-plugin-api";
 import type { PiMessage } from "@/chat/pi/messages";
-import { type StoredSlackRequester } from "@/chat/requester";
+import { type Requester } from "@/chat/requester";
 import type { AgentTurnUsage } from "@/chat/usage";
 import type { ConversationStore } from "@/chat/conversations/store";
 export type AgentTurnSessionStatus = "running" | "awaiting_resume" | "completed" | "failed" | "abandoned";
@@ -13,11 +13,12 @@ export interface AgentTurnSessionRecord {
     cumulativeDurationMs: number;
     cumulativeUsage?: AgentTurnUsage;
     destination?: Destination;
+    source?: Source;
     errorMessage?: string;
     lastProgressAtMs: number;
     loadedSkillNames?: string[];
     piMessages: PiMessage[];
-    requester?: StoredSlackRequester;
+    requester?: Requester;
     resumeReason?: AgentTurnResumeReason;
     resumedFromSliceId?: number;
     sessionId: string;
@@ -39,6 +40,7 @@ export declare function upsertAgentTurnSessionRecord(args: {
     cumulativeDurationMs?: number;
     cumulativeUsage?: AgentTurnUsage;
     destination?: Destination;
+    source?: Source;
     lastProgressAtMs?: number;
     loadedSkillNames?: string[];
     conversationStore?: ConversationStore;
@@ -47,7 +49,7 @@ export declare function upsertAgentTurnSessionRecord(args: {
     state: AgentTurnSessionStatus;
     surface?: AgentTurnSurface;
     piMessages: PiMessage[];
-    requester?: StoredSlackRequester;
+    requester?: Requester;
     resumeReason?: AgentTurnResumeReason;
     errorMessage?: string;
     resumedFromSliceId?: number;
@@ -62,10 +64,11 @@ export declare function recordAgentTurnSessionSummary(args: {
     cumulativeDurationMs?: number;
     cumulativeUsage?: AgentTurnUsage;
     destination?: Destination;
+    source?: Source;
     lastProgressAtMs?: number;
     loadedSkillNames?: string[];
     conversationStore?: ConversationStore;
-    requester?: StoredSlackRequester;
+    requester?: Requester;
     resumeReason?: AgentTurnResumeReason;
     sessionId: string;
     sliceId: number;

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,13 @@ 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";
+export interface ToolExecutionReport {
+    error?: string;
+    ok: boolean;
+    params: Record<string, unknown>;
+    result?: unknown;
+    toolName: string;
+}
 /** 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 | Promise<void>, agentHooks?: PluginHookRunner, conversationPrivacy?: ConversationPrivacy, onToolResult?: (report: ToolExecutionReport) => void | Promise<void>): AgentTool[];

package/dist/chat/tools/slack/context.d.ts

@@ -3,10 +3,10 @@ import type { SlackDestination } from "@sentry/junior-plugin-api";
 import type { SlackSource } from "@sentry/junior-plugin-api";
 import type { SlackRequester } from "@/chat/requester";
 export interface SlackToolContext {
-    destination?: SlackDestination;
+    destination: SlackDestination;
     source: SlackSource;
     requester?: SlackRequester;
-    destinationChannelId?: string;
+    destinationChannelId: string;
     messageTs?: string;
     sourceChannelId: string;
     teamId: string;

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";
@@ -43,11 +44,13 @@ interface BaseToolRuntimeContext {
      * Do not parse as Slack unless the value starts with `slack:`.
      */
     conversationId?: string;
-    /** Runtime-owned default outbound destination, if this invocation has one. */
-    destination?: Destination;
+    /** Runtime-owned default outbound destination for this invocation. */
+    destination: Destination;
     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>;
@@ -55,12 +58,12 @@ interface BaseToolRuntimeContext {
     sandbox: SandboxWorkspace;
 }
 interface SlackToolRuntimeContext extends BaseToolRuntimeContext {
-    destination?: SlackDestination;
+    destination: SlackDestination;
     requester?: SlackRequester;
     source: SlackSource;
 }
 interface LocalToolRuntimeContext extends BaseToolRuntimeContext {
-    destination?: LocalDestination;
+    destination: LocalDestination;
     requester?: LocalRequester;
     source: LocalSource;
     slack?: never;

package/dist/chat/vercel-queue-client.d.ts

@@ -0,0 +1,3 @@
+import { QueueClient } from "@vercel/queue";
+/** Create a Vercel Queue client that also works in local and eval runtimes. */
+export declare function createVercelQueueClient(): QueueClient;

package/dist/{chunk-YOHFWWBV.js → chunk-2ECJXSVQ.js}

@@ -1,109 +1,10 @@
+import {
+  createVercelQueueClient
+} from "./chunk-KNFROR7R.js";
 import {
   destinationKey,
   parseDestination
-} from "./chunk-YRDS7VKO.js";
-
-// src/plugins.ts
-function cloneManifests(manifests) {
-  return manifests ? structuredClone(manifests) : void 0;
-}
-function cloneInlineManifests(registrations) {
-  const inlineManifests = registrations.flatMap(
-    (plugin) => plugin.manifest ? [
-      {
-        manifest: {
-          ...structuredClone(plugin.manifest),
-          capabilities: plugin.manifest.capabilities?.map(
-            (capability) => capability.includes(".") ? capability : `${plugin.manifest.name}.${capability}`
-          ) ?? [],
-          configKeys: plugin.manifest.configKeys?.map(
-            (key) => key.includes(".") ? key : `${plugin.manifest.name}.${key}`
-          ) ?? [],
-          ...plugin.manifest.target ? {
-            target: {
-              ...plugin.manifest.target,
-              configKey: plugin.manifest.target.configKey.includes(".") ? plugin.manifest.target.configKey : `${plugin.manifest.name}.${plugin.manifest.target.configKey}`
-            }
-          } : {}
-        },
-        ...plugin.packageName ? { packageName: plugin.packageName } : {}
-      }
-    ] : []
-  );
-  return inlineManifests.length > 0 ? inlineManifests : void 0;
-}
-function assertUniquePluginNames(registrations) {
-  const seen = /* @__PURE__ */ new Set();
-  for (const plugin of registrations) {
-    if (seen.has(plugin.name)) {
-      throw new Error(`Duplicate plugin registration name "${plugin.name}"`);
-    }
-    seen.add(plugin.name);
-  }
-}
-function assertUniquePackageNames(packageNames) {
-  const seen = /* @__PURE__ */ new Set();
-  for (const packageName of packageNames) {
-    if (seen.has(packageName)) {
-      throw new Error(`Duplicate plugin package name "${packageName}"`);
-    }
-    seen.add(packageName);
-  }
-}
-function normalizePluginInput(input) {
-  if (typeof input === "string") {
-    return { packageName: input };
-  }
-  return { registration: input };
-}
-function defineJuniorPlugins(inputs, options = {}) {
-  const normalized = inputs.map(normalizePluginInput);
-  const packageNames = normalized.flatMap(
-    (input) => input.packageName ? [input.packageName] : []
-  );
-  const registrations = normalized.flatMap(
-    (input) => input.registration ? [input.registration] : []
-  );
-  assertUniquePackageNames(packageNames);
-  assertUniquePluginNames(registrations);
-  const manifests = cloneManifests(options.manifests);
-  return {
-    packageNames,
-    registrations: registrations.map((plugin) => ({ ...plugin })),
-    ...manifests ? { manifests } : {}
-  };
-}
-function pluginCatalogConfigFromPluginSet(pluginSet) {
-  if (!pluginSet) {
-    return void 0;
-  }
-  const packages = [
-    .../* @__PURE__ */ new Set([
-      ...pluginSet.packageNames,
-      ...pluginSet.registrations.flatMap(
-        (plugin) => plugin.packageName ? [plugin.packageName] : []
-      )
-    ])
-  ];
-  const manifests = cloneManifests(pluginSet.manifests);
-  const inlineManifests = cloneInlineManifests(pluginSet.registrations);
-  if (packages.length === 0 && !manifests && !inlineManifests) {
-    return void 0;
-  }
-  return {
-    ...inlineManifests ? { inlineManifests } : {},
-    ...packages.length > 0 ? { packages } : {},
-    ...manifests ? { manifests } : {}
-  };
-}
-function pluginHookRegistrationsFromPluginSet(pluginSet) {
-  return pluginSet?.registrations.filter(
-    (plugin) => plugin.hooks || plugin.legacyStatePrefixes
-  ) ?? [];
-}
-
-// src/chat/task-execution/vercel-queue.ts
-import { QueueClient } from "@vercel/queue";
+} from "./chunk-Q6XFTRV5.js";
 
 // src/chat/task-execution/queue-signing.ts
 import { createHmac, timingSafeEqual } from "crypto";
@@ -207,7 +108,7 @@ function toDelaySeconds(options) {
 }
 function createVercelConversationWorkQueue(options = {}) {
   const topic = resolveConversationWorkQueueTopic(options);
-  const client = options.client ?? new QueueClient();
+  const client = options.client ?? createVercelQueueClient();
   return {
     async send(message, sendOptions) {
       const result = await client.send(
@@ -229,9 +130,6 @@ function getVercelConversationWorkQueue() {
 }
 
 export {
-  defineJuniorPlugins,
-  pluginCatalogConfigFromPluginSet,
-  pluginHookRegistrationsFromPluginSet,
   verifyConversationQueueMessage,
   resolveConversationWorkQueueTopic,
   getVercelConversationWorkQueue