@novu/framework 2.13.1-rc.72c80d5b17 → 2.13.1

package/dist/esm/index.d.ts

@@ -1,9 +1,9 @@
-export { C as Client, N as NovuRequestHandler, S as ServeHandlerOptions, a as agent, w as workflow } from './index-C0oUWDlb.js';
-export { C as ClientOptions, a as CronExpression, E as ExecuteInput, S as SeverityLevelEnum, W as Workflow } from './health-check.types-0Rv-l8yD.js';
-export { Actions, Button, Card, CardChild, CardElement, CardLink, CardText, Divider, Select, SelectOption, TextInput } from 'chat';
-export { A as Agent, a as AgentAction, b as AgentActionContext, c as AgentAttachment, d as AgentContext, e as AgentContextPayload, f as AgentContextValue, g as AgentConversation, h as AgentDeliveryError, i as AgentError, j as AgentHandlerContext, k as AgentHandlers, l as AgentHistoryEntry, m as AgentMessage, n as AgentMessageAuthor, o as AgentMessageContext, p as AgentPlatformContext, q as AgentReaction, r as AgentReactionContext, s as AgentResolveContext, t as AgentSubscriber, u as AgentSubscriberAccess, v as AgentToolCall, F as FileRef, M as MessageContent, R as ReplyHandle, T as ToolApprovalCard, w as ToolApprovalConfig, x as ToolApprovalDecision, y as toAgentError } from './agent.types-HUDhyXrV.js';
+export { C as Client, N as NovuRequestHandler, S as ServeHandlerOptions, a as agent, i as isFromWorkflow, w as workflow } from './index-BvRGmHFw.js';
+export { C as ClientOptions, a as CronExpression, E as ExecuteInput, S as SeverityLevelEnum, W as Workflow } from './health-check.types-DORn4djx.js';
+export { Actions, Button, Card, CardChild, CardElement, CardLink, CardText, Divider, Image, ImageElement, Select, SelectOption, TextInput } from 'chat';
+export { A as Agent, a as AgentAction, b as AgentActionContext, c as AgentAttachment, d as AgentContext, e as AgentContextPayload, f as AgentContextValue, g as AgentConversation, h as AgentDeliveryError, i as AgentError, j as AgentHandlerContext, k as AgentHandlers, l as AgentHistoryEntry, m as AgentHumanResponse, n as AgentMessage, o as AgentMessageAuthor, p as AgentMessageContext, q as AgentNotification, r as AgentPlatformContext, s as AgentReaction, t as AgentReactionContext, u as AgentResolveContext, v as AgentSubscriber, w as AgentSubscriberAccess, x as AgentToolCall, F as FileRef, H as HumanAskApproveOptions, y as HumanChooseOptions, z as HumanInteractionKind, B as HumanTellOptions, M as MessageContent, R as ReplyHandle, T as ToolApprovalCard, C as ToolApprovalConfig, D as ToolApprovalDecision, E as toAgentError } from './agent.types-DFLG1_vb.js';
 export { AnyStepResolver, ChatStepResolver, EmailStepResolver, InAppStepResolver, PushStepResolver, SmsStepResolver, StepResolverContext, ToolStepResolver, step } from './step-resolver.js';
-export { C as ContextResolved, E as EnvironmentSystemVariables, S as Subscriber, p as providerSchemas } from './subscriber.types-g7VnI_ZQ.js';
+export { C as ContextResolved, E as EnvironmentSystemVariables, S as Subscriber, p as providerSchemas } from './subscriber.types-Drf26WPA.js';
 import './util.types-DaFfsxgy.js';
 import './base.schema.types-BApIn9jr.js';
 import 'json-schema-to-ts';

package/dist/esm/index.js

@@ -1 +1 @@
-import{b as k,c as o,d as p,e as s}from"./chunk-CGZ5P44A.js";import{a as t}from"./chunk-YLCLZVYS.js";import"./chunk-XIVU4VDS.js";import{M as l,N as m,O as n,V as r}from"./chunk-FMKD6TON.js";import{a,b,c,d,e,f,p as g,q as h,r as i}from"./chunk-X5AZIKIR.js";import"./chunk-RBTQQ5IZ.js";import{a as q}from"./chunk-SPS3KBKF.js";import{f as j}from"./chunk-VY27ZAO7.js";import"./chunk-W6DIBD4Z.js";import"./chunk-FHYMHX3T.js";export{a as Actions,m as AgentDeliveryError,l as AgentError,b as Button,c as Card,d as CardLink,e as CardText,k as Client,j as CronExpression,f as Divider,o as NovuRequestHandler,g as Select,h as SelectOption,r as SeverityLevelEnum,i as TextInput,p as agent,q as providerSchemas,t as step,n as toAgentError,s as workflow};
+import{b as m,c as q,d as r,e as u}from"./chunk-PBC7WR2R.js";import{a as v}from"./chunk-YLCLZVYS.js";import"./chunk-XIVU4VDS.js";import{N as n,O as o,P as p,W as t}from"./chunk-4ETX7FIT.js";import{a,b,c,d,e,f,i as g,p as h,q as i,r as j}from"./chunk-X5AZIKIR.js";import"./chunk-RBTQQ5IZ.js";import{a as s}from"./chunk-IREH6K2M.js";import{f as k}from"./chunk-VY27ZAO7.js";import{b as l}from"./chunk-PU74XQ2P.js";import"./chunk-FHYMHX3T.js";export{a as Actions,o as AgentDeliveryError,n as AgentError,b as Button,c as Card,d as CardLink,e as CardText,m as Client,k as CronExpression,f as Divider,g as Image,q as NovuRequestHandler,h as Select,i as SelectOption,t as SeverityLevelEnum,j as TextInput,r as agent,l as isFromWorkflow,s as providerSchemas,v as step,p as toAgentError,u as workflow};

package/dist/esm/internal/index.d.ts

@@ -1,10 +1,10 @@
-import { P as PostActionEnum } from '../health-check.types-0Rv-l8yD.js';
-export { b as CancelEventTriggerResponse, c as ChannelPreference, C as ClientOptions, d as CodeResult, a as CronExpression, D as DiscoverAgentOutput, e as DiscoverOutput, f as DiscoverProviderOutput, g as DiscoverStepOutput, h as DiscoverWorkflowOutput, i as Event, j as EventTriggerParams, k as EventTriggerResponse, l as EventTriggerResult, m as Execute, E as ExecuteInput, n as ExecuteOutput, o as ExecuteOutputMetadata, p as ExecuteOutputOptions, G as GetActionEnum, H as HealthCheck, L as Logger, S as SeverityLevelEnum, q as State, r as StepType, W as Workflow, s as WorkflowChannelEnum, t as WorkflowOptions, u as WorkflowPreference, v as WorkflowPreferences } from '../health-check.types-0Rv-l8yD.js';
-export { e as ActionStep, A as ActionStepEnum, f as ChannelStep, c as ChannelStepEnum, g as ChatOutput, h as ChatOutputUnvalidated, i as ChatResult, a as ContextPayload, C as ContextResolved, j as ContextValue, k as CustomStep, D as DelayDynamicOutput, l as DelayDynamicOutputUnvalidated, m as DelayOutput, n as DelayOutputUnvalidated, o as DelayRegularOutput, q as DelayRegularOutputUnvalidated, r as DelayResult, s as DelayTimedOutput, t as DelayTimedOutputUnvalidated, u as DigestOutput, v as DigestOutputUnvalidated, w as DigestRegularOutput, x as DigestRegularOutputUnvalidated, y as DigestResult, z as DigestTimedOutput, B as DigestTimedOutputUnvalidated, F as EmailOutput, G as EmailOutputUnvalidated, H as EmailResult, E as EnvironmentSystemVariables, I as InAppOutput, J as InAppOutputUnvalidated, K as InAppResult, L as JobStatusEnum, P as PushOutput, M as PushOutputUnvalidated, N as PushResult, O as Skip, Q as SmsOutput, R as SmsOutputUnvalidated, T as SmsResult, b as Step, U as StepContext, d as StepOptions, V as StepOutput, S as Subscriber, X as ThrottleOutput, Y as ThrottleOutputUnvalidated, Z as ThrottleResult, _ as ToolOutput, $ as ToolOutputUnvalidated, a0 as actionStepSchemas, a1 as channelStepSchemas } from '../subscriber.types-g7VnI_ZQ.js';
+import { P as PostActionEnum } from '../health-check.types-DORn4djx.js';
+export { b as CancelEventTriggerResponse, c as ChannelPreference, C as ClientOptions, d as CodeResult, a as CronExpression, D as DiscoverAgentOutput, e as DiscoverOutput, f as DiscoverProviderOutput, g as DiscoverStepOutput, h as DiscoverWorkflowOutput, i as Event, j as EventTriggerParams, k as EventTriggerResponse, l as EventTriggerResult, m as Execute, E as ExecuteInput, n as ExecuteOutput, o as ExecuteOutputMetadata, p as ExecuteOutputOptions, G as GetActionEnum, H as HealthCheck, L as Logger, S as SeverityLevelEnum, q as State, r as StepType, W as Workflow, s as WorkflowChannelEnum, t as WorkflowOptions, u as WorkflowPreference, v as WorkflowPreferences } from '../health-check.types-DORn4djx.js';
+export { e as ActionStep, A as ActionStepEnum, f as ChannelStep, c as ChannelStepEnum, g as ChatOutput, h as ChatOutputUnvalidated, i as ChatResult, a as ContextPayload, C as ContextResolved, j as ContextValue, k as CustomStep, D as DelayDynamicOutput, l as DelayDynamicOutputUnvalidated, m as DelayOutput, n as DelayOutputUnvalidated, o as DelayRegularOutput, q as DelayRegularOutputUnvalidated, r as DelayResult, s as DelayTimedOutput, t as DelayTimedOutputUnvalidated, u as DigestOutput, v as DigestOutputUnvalidated, w as DigestRegularOutput, x as DigestRegularOutputUnvalidated, y as DigestResult, z as DigestTimedOutput, B as DigestTimedOutputUnvalidated, F as EmailOutput, G as EmailOutputUnvalidated, H as EmailResult, E as EnvironmentSystemVariables, I as InAppOutput, J as InAppOutputUnvalidated, K as InAppResult, L as JobStatusEnum, P as PushOutput, M as PushOutputUnvalidated, N as PushResult, O as Skip, Q as SmsOutput, R as SmsOutputUnvalidated, T as SmsResult, b as Step, U as StepContext, d as StepOptions, V as StepOutput, S as Subscriber, X as ThrottleOutput, Y as ThrottleOutputUnvalidated, Z as ThrottleResult, _ as ToolOutput, $ as ToolOutputUnvalidated, a0 as actionStepSchemas, a1 as channelStepSchemas } from '../subscriber.types-Drf26WPA.js';
 import { Filter, LiquidOptions, Liquid } from 'liquidjs';
 import { Emoji } from 'chat';
-import { j as AgentHandlerContext, D as ToolResult, E as ToolApprovalRequestPayload, T as ToolApprovalCard, R as ReplyHandle, o as AgentMessageContext, G as AgentEventEnum, a as AgentAction, m as AgentMessage, q as AgentReaction, g as AgentConversation, t as AgentSubscriber, e as AgentContextPayload, l as AgentHistoryEntry, p as AgentPlatformContext, H as TypingControl, J as ToolApprovalControl, K as AgentBridgeRequest, w as ToolApprovalConfig, M as MessageContent, F as FileRef, L as AgentReplyPayload, S as SentMessageInfo, z as TriggerRecipientsPayload } from '../agent.types-HUDhyXrV.js';
-export { N as DeleteMessagePayload, O as EditPayload, P as MetadataSignal, Q as ParsedApprovalAction, U as ReplyContent, V as Signal, X as TriggerSignal, Y as buildApprovalActionId, Z as parseApprovalActionId } from '../agent.types-HUDhyXrV.js';
+import { j as AgentHandlerContext, L as ToolResult, N as ToolApprovalRequestPayload, T as ToolApprovalCard, R as ReplyHandle, p as AgentMessageContext, O as AgentEventEnum, a as AgentAction, n as AgentMessage, s as AgentReaction, g as AgentConversation, v as AgentSubscriber, e as AgentContextPayload, q as AgentNotification, l as AgentHistoryEntry, r as AgentPlatformContext, m as AgentHumanResponse, P as TypingControl, Q as ToolApprovalControl, S as AgentBridgeRequest, C as ToolApprovalConfig, M as MessageContent, F as FileRef, U as ReplyContent, V as Signal, X as AddReactionPayload, Y as DeleteMessagePayload, Z as SentMessageInfo, _ as TypingOp, G as TriggerRecipientsPayload, H as HumanAskApproveOptions, y as HumanChooseOptions, B as HumanTellOptions } from '../agent.types-DFLG1_vb.js';
+export { $ as AgentReplyPayload, a0 as EditPayload, a1 as HumanSignal, a2 as MetadataSignal, a3 as ParsedApprovalAction, a4 as TriggerSignal, a5 as buildApprovalActionId, a6 as parseApprovalActionId } from '../agent.types-DFLG1_vb.js';
 export { a as FromSchema, F as FromSchemaUnvalidated, J as JsonSchema, S as Schema, Z as ZodSchema, b as ZodSchemaMinimal } from '../base.schema.types-BApIn9jr.js';
 export { S as SupportedFrameworkName } from '../server.types-Cc6o5eYH.js';
 export { A as Awaitable, C as ConditionalPartial, D as DeepPartial, b as DeepRequired, E as Either, I as Indexable, c as PickOptional, d as PickOptionalKeys, e as PickRequired, P as PickRequiredKeys, a as Prettify } from '../util.types-DaFfsxgy.js';
@@ -137,6 +137,257 @@ declare enum ResourceEnum {
     STEP = "step"
 }
 
+type AgentMessageRole = 'user' | 'assistant';
+type AgentToolSource = {
+    type: 'builtin';
+} | {
+    type: 'custom';
+} | {
+    type: 'mcp';
+    serverName: string;
+};
+type AgentToolResultContent = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'citation';
+    url: string;
+    title?: string;
+    excerpts?: string[];
+} | {
+    type: 'json';
+    value: unknown;
+} | {
+    type: 'media';
+    mediaType: string;
+    data: string;
+    name?: string;
+} | {
+    type: 'unknown';
+    providerType: string;
+    data: Record<string, unknown>;
+};
+type AgentMessageContent = {
+    markdown: string;
+} | {
+    card: Record<string, unknown>;
+};
+interface AgentFileRef {
+    fileId: string;
+    name?: string;
+    mediaType?: string;
+    /** Transitional: inline base64 payload until the pre-upload path ships. Same 5 MB limit as the reply API. */
+    data?: string;
+    /** Transitional: publicly-accessible URL until the pre-upload path ships. Same limits as the reply API. */
+    url?: string;
+}
+
+declare const AGENT_EVENT_PROTOCOL_VERSION: 1;
+interface AgentEventUsage {
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+}
+type AgentRunOutcome = 'completed' | 'paused' | 'aborted';
+type AgentFinishReason = 'stop' | 'length' | 'refused' | 'other';
+interface AgentApprovalRequest {
+    approvalId: string;
+    toolUseId: string;
+    toolName: string;
+    input?: Record<string, unknown>;
+    source?: AgentToolSource;
+    /**
+     * Server-minted platform action ids for headless / card UIs to echo back.
+     * Clients must not invent these — grammars differ across runtimes.
+     */
+    approveActionId?: string;
+    denyActionId?: string;
+    /** Server-minted always-allow-this-tool action id. Echo via respondToAction / card click. */
+    trustToolActionId?: string;
+    /** Server-minted always-allow-MCP-server action id (MCP tools only). */
+    trustServerActionId?: string;
+}
+type AgentSignal = {
+    type: 'metadata';
+    action: 'set';
+    key: string;
+    value: unknown;
+} | {
+    type: 'metadata';
+    action: 'delete';
+    key: string;
+} | {
+    type: 'metadata';
+    action: 'clear';
+} | {
+    type: 'trigger';
+    workflowId: string;
+    to?: unknown;
+    payload?: Record<string, unknown>;
+} | {
+    type: 'human';
+    kind: 'ask' | 'approve' | 'choose' | 'tell';
+    prompt: string;
+    requestId: string;
+    options?: string[];
+    from?: string;
+    ttlSeconds?: number;
+    to?: string | string[];
+};
+type AgentEvent = {
+    type: 'run-start';
+} | {
+    type: 'run-finish';
+    outcome: AgentRunOutcome;
+    finishReason?: AgentFinishReason;
+    usage?: AgentEventUsage;
+    approvals?: AgentApprovalRequest[];
+} | {
+    type: 'run-error';
+    message: string;
+    code?: string;
+} | {
+    type: 'step-start';
+    name?: string;
+    index?: number;
+} | {
+    type: 'step-end';
+    name?: string;
+    index?: number;
+    usage?: AgentEventUsage;
+} | {
+    type: 'message';
+    messageId: string;
+    /** Who authored this durable message. Streaming events stay assistant-only and omit role. */
+    role: AgentMessageRole;
+    content: AgentMessageContent;
+    files?: AgentFileRef[];
+} | {
+    type: 'message-start';
+    messageId: string;
+} | {
+    type: 'message-delta';
+    messageId: string;
+    delta: string;
+} | {
+    type: 'message-end';
+    messageId: string;
+    content?: AgentMessageContent;
+    files?: AgentFileRef[];
+} | {
+    type: 'thinking-start';
+    thinkingId: string;
+} | {
+    type: 'thinking-delta';
+    thinkingId: string;
+    delta: string;
+} | {
+    type: 'thinking-end';
+    thinkingId: string;
+} | {
+    type: 'source';
+    messageId: string;
+    sourceType: 'url' | 'document';
+    url?: string;
+    title?: string;
+    filename?: string;
+} | {
+    type: 'tool-use-start';
+    toolUseId: string;
+    toolName: string;
+    source?: AgentToolSource;
+} | {
+    type: 'tool-use-delta';
+    toolUseId: string;
+    delta: string;
+} | {
+    type: 'tool-use-done';
+    toolUseId: string;
+    toolName: string;
+    input?: Record<string, unknown>;
+    source?: AgentToolSource;
+} | {
+    type: 'tool-use-result';
+    toolUseId: string;
+    content: AgentToolResultContent[];
+    isError?: boolean;
+} | ({
+    type: 'tool-approval-request';
+    /** Stable assistant message id used to preserve the approval's timeline position during history replay. */
+    messageId?: string;
+    /** When true, no companion message carries the approval UI. The consumer should render its default approval card. */
+    deliverCard?: boolean;
+} & AgentApprovalRequest) | {
+    type: 'tool-approval-response';
+    approvalId: string;
+    decision: 'approved' | 'denied';
+    reason?: string;
+    automatic?: boolean;
+} | {
+    type: 'mcp-connection-request';
+    actionId: string;
+    mcpId: string;
+    displayName: string;
+    authorizeUrl: string;
+    authorizeUrlWithAutoApprove?: string;
+} | {
+    type: 'mcp-connection-result';
+    actionId: string;
+    mcpId: string;
+    status: 'connected' | 'failed';
+    message?: string;
+} | {
+    type: 'resolve';
+    summary?: string;
+} | {
+    type: 'signal';
+    signal: AgentSignal;
+} | {
+    type: 'channel.typing';
+    state: 'on' | 'off';
+    status?: string;
+} | {
+    type: 'channel.edit';
+    messageId: string;
+    content: AgentMessageContent;
+    files?: AgentFileRef[];
+} | {
+    type: 'channel.delete';
+    messageId: string;
+} | {
+    type: 'channel.reaction';
+    messageId: string;
+    emoji: string;
+    op: 'add' | 'remove';
+} | {
+    type: 'connection.error';
+    source: 'mcp';
+    serverName: string;
+    reason: 'authentication' | 'connection';
+    message: string;
+} | {
+    type: 'provider-event';
+    provider: string;
+    event: string;
+    data: unknown;
+} | {
+    type: 'custom';
+    name: string;
+    data: unknown;
+};
+interface AgentEventEnvelope {
+    version: typeof AGENT_EVENT_PROTOCOL_VERSION;
+    conversationId: string;
+    /** Public `conv_*` identifier. Clients receive only this id, never `conversationId`. */
+    conversationIdentifier?: string;
+    agentId: string;
+    runId: string;
+    turnId: string;
+    sequence: number;
+    timestamp: string;
+    event: AgentEvent;
+}
+
 /**
  * Check if the object is a native error.
  *
@@ -431,18 +682,46 @@ interface AgentRuntimeContext extends AgentHandlerContext {
     asMessageContext(): AgentMessageContext;
 }
 
-interface ReplyPoster {
-    post(body: AgentReplyPayload): Promise<SentMessageInfo | null>;
+/** Pending side effects queued between replies, drained atomically before each turn action. */
+interface SideEffectsSnapshot {
+    toolApprovalRequest: ToolApprovalRequestPayload | null;
+    signals: Signal[];
+    toolResults: ToolResult[];
+    addReactions: AddReactionPayload[];
+    deleteMessages: DeleteMessagePayload[];
+    resolve: {
+        summary?: string;
+    } | null;
+}
+/**
+ * A turn's delivery mechanism. Legacy bridges POST a single `AgentReplyPayload` per action;
+ * SDK-native runs emit one or more `AgentEvent`s to the outbox. `AgentContextImpl` selects one
+ * implementation per run and delegates to it, instead of branching on the mode at every call site.
+ */
+interface TurnTransport {
+    sendReply(reply: ReplyContent, sideEffects: SideEffectsSnapshot): Promise<SentMessageInfo | null>;
+    /**
+     * Returns `'unaddressable'` when the card was rendered but there is no client-addressable
+     * message handle for it (event mode: the sink owns approval-card rendering, so there is no
+     * id it could later resolve an edit/delete against).
+     */
+    sendApprovalCard(card: ToolApprovalCard, sideEffects: SideEffectsSnapshot): Promise<SentMessageInfo | null | 'unaddressable'>;
+    editMessage(messageId: string, reply: ReplyContent): Promise<SentMessageInfo | null>;
+    deleteMessage(messageId: string): Promise<void>;
+    setTyping(op: TypingOp): Promise<void>;
+    flushSideEffects(sideEffects: SideEffectsSnapshot): Promise<void>;
+    emitCustom(name: string, data: unknown): Promise<void>;
+    queueRunStart(): void;
+    emitRunFinish(outcome: AgentRunOutcome): Promise<void>;
+    reportTurnError(message?: string): Promise<void>;
 }
 declare class ReplyHandleImpl implements ReplyHandle {
-    private readonly conversationId;
-    private readonly integrationIdentifier;
-    private readonly poster;
+    private readonly transport;
     messageId: string;
     platformThreadId: string;
     /** @internal set when the handler calls `edit()`; dispatch skips default approval card cleanup. */
     editedByHandler: boolean;
-    constructor(messageId: string, platformThreadId: string, conversationId: string, integrationIdentifier: string, poster: ReplyPoster);
+    constructor(messageId: string, platformThreadId: string, transport: TurnTransport);
     edit(content: MessageContent, options?: {
         files?: FileRef[];
     }): Promise<ReplyHandle>;
@@ -457,9 +736,11 @@ declare class AgentContextImpl implements AgentRuntimeContext {
     readonly conversation: AgentConversation;
     readonly subscriber: AgentSubscriber | null;
     readonly context: AgentContextPayload | null;
+    readonly notification: AgentNotification | null;
     readonly history: AgentHistoryEntry[];
     readonly platform: string;
     readonly platformContext: AgentPlatformContext;
+    readonly humanResponse: AgentHumanResponse | null;
     readonly typing: TypingControl;
     readonly toolApproval: ToolApprovalControl;
     readonly metadata: {
@@ -477,11 +758,7 @@ declare class AgentContextImpl implements AgentRuntimeContext {
     private _resolveSignal;
     private _metadataState;
     private readonly _toolApprovalConfig?;
-    private readonly _replyUrl;
-    private readonly _conversationId;
-    private readonly _integrationIdentifier;
-    private readonly _secretKey;
-    private readonly _poster;
+    private readonly _transport;
     constructor(request: AgentBridgeRequest, secretKey: string, toolApprovalConfig?: ToolApprovalConfig);
     asMessageContext(): AgentMessageContext;
     reply(content: MessageContent, options?: {
@@ -490,29 +767,49 @@ declare class AgentContextImpl implements AgentRuntimeContext {
     replyApprovalCard(card: ToolApprovalCard): Promise<ReplyHandle>;
     /** @internal Build a handle to an already-posted message (used to resume an approval). */
     createReplyHandle(messageId: string): ReplyHandleImpl;
+    emit(event: {
+        name: string;
+        data: unknown;
+    }): Promise<void>;
     resolve(summary?: string): void;
     trigger(workflowId: string, opts?: {
         to?: TriggerRecipientsPayload;
         payload?: Record<string, unknown>;
     }): void;
+    ask(question: string, opts?: HumanAskApproveOptions): string;
+    approve(action: string, opts?: HumanAskApproveOptions): string;
+    choose(question: string, options: string[], opts?: HumanChooseOptions): string;
+    tell(message: string, opts?: HumanTellOptions): string;
+    private queueHumanSignal;
     /** @internal Queue a gated tool call for the ledger; flushed with the next reply. */
     emitToolApprovalRequest(request: ToolApprovalRequestPayload): void;
     /** @internal Queue a tool-call outcome to be recorded in history; flushed with the next reply. */
     emitToolResult(result: ToolResult): void;
     addReaction(messageId: string, emojiName: Emoji): void;
     deleteMessage(messageId: string): void;
+    /** @internal Enqueue run-start before handler execution; flushed with the first emit. */
+    queueRunStart(): void;
+    /** @internal Enqueue and flush run-finish as the terminal success event. */
+    emitRunFinish(options: {
+        outcome: AgentRunOutcome;
+    }): Promise<void>;
     /** Best-effort failure report to Novu. Never throws. */
-    reportTurnError(): Promise<void>;
+    reportTurnError(message?: string): Promise<void>;
     /**
      * Flush any remaining signals that weren't sent with reply().
      * Called internally after onResolve returns.
      */
     flush(): Promise<void>;
     private _hasPendingSideEffects;
-    private _drainSideEffects;
-    private _post;
+    /** Atomically drains all queued side effects into a snapshot for the transport to deliver. */
+    private _drainSideEffectsSnapshot;
 }
 
+/** Maximum outbound body length included before the payload. */
+declare const WORKFLOW_ORIGIN_LINE_MAX_CHARS = 500;
+declare function buildWorkflowOriginLine(workflowIdentifier: string, messageContent: string): string;
+declare function buildWorkflowOriginInjection(workflowIdentifier: string, messageContent: string, payload: Record<string, unknown>): string;
+
 /**
  * Creates a configured Liquid instance with Novu's default settings.
  *
@@ -525,4 +822,4 @@ declare function createLiquidEngine(options?: LiquidOptions): Liquid;
 declare function repairJsonString(value: string): string;
 declare function compileJsonControlValues(values: Record<string, unknown>, context: Record<string, unknown>, liquidEngine?: ReturnType<typeof createLiquidEngine>): Promise<Record<string, unknown>>;
 
-export { AgentBridgeRequest, AgentContextImpl, AgentEventEnum, AgentReplyPayload, type AgentRuntimeContext, BadRequestError, BridgeError, ConflictError, ErrorCodeEnum, ExecutionEventControlsInvalidError, ExecutionEventPayloadInvalidError, ExecutionProviderOutputInvalidError, ExecutionStateControlsInvalidError, ExecutionStateCorruptError, ExecutionStateOutputInvalidError, ExecutionStateResultInvalidError, FILTER_VALIDATORS, ForbiddenError, FrameworkError, HttpHeaderKeysEnum, HttpMethodEnum, HttpQueryKeysEnum, HttpStatusEnum, InvalidActionError, type LiquidFilterIssue, MethodNotAllowedError, MissingSecretKeyError, NotFoundError, NovuApiEndpointsEnum, PlatformError, PostActionEnum, ProviderExecutionFailedError, ProviderNotFoundError, ResourceConflictError, ResourceEnum, ResourceExecutionFailed, ResourceNotFoundError, SIGNATURE_TIMESTAMP_TOLERANCE, SIGNATURE_TIMESTAMP_TOLERANCE_MINUTES, SentMessageInfo, ServerError, SignatureExpiredError, SignatureInvalidError, SignatureMismatchError, SignatureNotFoundError, SignatureVersionInvalidError, SigningKeyNotFoundError, StepAlreadyExistsError, StepControlCompilationFailedError, StepExecutionFailedError, StepNotFoundError, ToolApprovalRequestPayload, ToolResult, UnauthorizedError, WorkflowAlreadyExistsError, WorkflowNotFoundError, WorkflowPayloadInvalidError, compileJsonControlValues, createLiquidEngine, digest, isFrameworkError, isNativeError, pluralize, repairJsonString, toSentence, toSentenceArgsValidator };
+export { AgentBridgeRequest, AgentContextImpl, type AgentEvent, AgentEventEnum, type AgentEventEnvelope, type AgentRuntimeContext, BadRequestError, BridgeError, ConflictError, DeleteMessagePayload, ErrorCodeEnum, ExecutionEventControlsInvalidError, ExecutionEventPayloadInvalidError, ExecutionProviderOutputInvalidError, ExecutionStateControlsInvalidError, ExecutionStateCorruptError, ExecutionStateOutputInvalidError, ExecutionStateResultInvalidError, FILTER_VALIDATORS, ForbiddenError, FrameworkError, HttpHeaderKeysEnum, HttpMethodEnum, HttpQueryKeysEnum, HttpStatusEnum, InvalidActionError, type LiquidFilterIssue, MethodNotAllowedError, MissingSecretKeyError, NotFoundError, NovuApiEndpointsEnum, PlatformError, PostActionEnum, ProviderExecutionFailedError, ProviderNotFoundError, ReplyContent, ResourceConflictError, ResourceEnum, ResourceExecutionFailed, ResourceNotFoundError, SIGNATURE_TIMESTAMP_TOLERANCE, SIGNATURE_TIMESTAMP_TOLERANCE_MINUTES, SentMessageInfo, ServerError, Signal, SignatureExpiredError, SignatureInvalidError, SignatureMismatchError, SignatureNotFoundError, SignatureVersionInvalidError, SigningKeyNotFoundError, StepAlreadyExistsError, StepControlCompilationFailedError, StepExecutionFailedError, StepNotFoundError, ToolApprovalRequestPayload, ToolResult, UnauthorizedError, WORKFLOW_ORIGIN_LINE_MAX_CHARS, WorkflowAlreadyExistsError, WorkflowNotFoundError, WorkflowPayloadInvalidError, buildWorkflowOriginInjection, buildWorkflowOriginLine, compileJsonControlValues, createLiquidEngine, digest, isFrameworkError, isNativeError, pluralize, repairJsonString, toSentence, toSentenceArgsValidator };

package/dist/esm/internal/index.js

@@ -1 +1 @@
-import{A as le,B as me,C as ge,D as ce,E as de,F as ue,H as fe,I as xe,J as ye,K as o,L as r,P as p,S as m,U as Ae,V as Se,a as D,b,c as j,d as B,e as _,f as z,g as G,h as H,i as K,j as Q,k as U,m as W,n as X,o as Y,p as Z,q as $,r as ee,s as re,t as oe,u as te,v as ne,w as ie,x as ae,y as pe,z as se}from"../chunk-FMKD6TON.js";import"../chunk-X5AZIKIR.js";import"../chunk-RBTQQ5IZ.js";import{e as g,f as c}from"../chunk-SPS3KBKF.js";import{a as f,b as x,c as y,d as A,e as S,f as R,g as E,h as I,i as q,j as v,k as w,l as J,m as L,n as P,o as T,p as V,q as h,r as k,s as C,t as F,u as O,v as M,w as N}from"../chunk-VY27ZAO7.js";import{d as s,e as l}from"../chunk-W6DIBD4Z.js";import"../chunk-FHYMHX3T.js";var Ee={toSentence:o};import{jsonrepair as t}from"jsonrepair";function d(e){return t(e)}async function u(e,n,i=r()){let a=await i.parseAndRender(JSON.stringify(e),n);try{return JSON.parse(t(a))}catch{throw new Error("Rendered template output is not valid JSON")}}export{P as ActionStepEnum,m as AgentContextImpl,p as AgentEventEnum,C as BadRequestError,D as BridgeError,L as ChannelStepEnum,M as ConflictError,R as CronExpression,E as ErrorCodeEnum,B as ExecutionEventControlsInvalidError,j as ExecutionEventPayloadInvalidError,K as ExecutionProviderOutputInvalidError,_ as ExecutionStateControlsInvalidError,b as ExecutionStateCorruptError,z as ExecutionStateOutputInvalidError,G as ExecutionStateResultInvalidError,Ee as FILTER_VALIDATORS,N as ForbiddenError,h as FrameworkError,x as GetActionEnum,I as HttpHeaderKeysEnum,q as HttpMethodEnum,v as HttpQueryKeysEnum,w as HttpStatusEnum,X as InvalidActionError,Ae as JobStatusEnum,W as MethodNotAllowedError,Y as MissingSecretKeyError,k as NotFoundError,y as NovuApiEndpointsEnum,Z as PlatformError,f as PostActionEnum,te as ProviderExecutionFailedError,oe as ProviderNotFoundError,$ as ResourceConflictError,J as ResourceEnum,re as ResourceExecutionFailed,ee as ResourceNotFoundError,S as SIGNATURE_TIMESTAMP_TOLERANCE,A as SIGNATURE_TIMESTAMP_TOLERANCE_MINUTES,O as ServerError,Se as SeverityLevelEnum,pe as SignatureExpiredError,ae as SignatureInvalidError,ne as SignatureMismatchError,ie as SignatureNotFoundError,le as SignatureVersionInvalidError,se as SigningKeyNotFoundError,ge as StepAlreadyExistsError,H as StepControlCompilationFailedError,ce as StepExecutionFailedError,me as StepNotFoundError,F as UnauthorizedError,ue as WorkflowAlreadyExistsError,T as WorkflowChannelEnum,de as WorkflowNotFoundError,Q as WorkflowPayloadInvalidError,g as actionStepSchemas,s as buildApprovalActionId,c as channelStepSchemas,u as compileJsonControlValues,r as createLiquidEngine,fe as digest,U as isFrameworkError,V as isNativeError,l as parseApprovalActionId,xe as pluralize,d as repairJsonString,ye as toSentence,o as toSentenceArgsValidator};
+import{A as ue,B as ce,C as de,D as fe,E as xe,F as Ae,I as ye,J as Re,K as Se,L as r,M as o,Q as a,T as m,V as ve,W as Ee,a as j,b as D,c as H,d as B,e as G,f as K,g as X,h as z,i as Q,j as U,k as Y,m as Z,n as $,o as ee,p as oe,q as re,r as te,s as ne,t as ie,u as pe,v as ae,w as se,x as le,y as me,z as ge}from"../chunk-4ETX7FIT.js";import"../chunk-X5AZIKIR.js";import"../chunk-RBTQQ5IZ.js";import{e as g,f as u}from"../chunk-IREH6K2M.js";import{a as y,b as R,c as S,d as v,e as E,f as I,g as L,h as w,i as O,j as k,k as q,l as J,m as C,n as F,o as P,p as T,q as V,r as h,s as N,t as _,u as M,v as W,w as b}from"../chunk-VY27ZAO7.js";import{a as c,b as d,c as f}from"../chunk-QZ6TSYCK.js";import{e as s,f as l}from"../chunk-PU74XQ2P.js";import"../chunk-FHYMHX3T.js";var Le={toSentence:r};import{jsonrepair as t}from"jsonrepair";function x(e){return t(e)}async function A(e,n,i=o()){let p=await i.parseAndRender(JSON.stringify(e),n);try{return JSON.parse(t(p))}catch{throw new Error("Rendered template output is not valid JSON")}}export{F as ActionStepEnum,m as AgentContextImpl,a as AgentEventEnum,N as BadRequestError,j as BridgeError,C as ChannelStepEnum,W as ConflictError,I as CronExpression,L as ErrorCodeEnum,B as ExecutionEventControlsInvalidError,H as ExecutionEventPayloadInvalidError,Q as ExecutionProviderOutputInvalidError,G as ExecutionStateControlsInvalidError,D as ExecutionStateCorruptError,K as ExecutionStateOutputInvalidError,X as ExecutionStateResultInvalidError,Le as FILTER_VALIDATORS,b as ForbiddenError,V as FrameworkError,R as GetActionEnum,w as HttpHeaderKeysEnum,O as HttpMethodEnum,k as HttpQueryKeysEnum,q as HttpStatusEnum,$ as InvalidActionError,ve as JobStatusEnum,Z as MethodNotAllowedError,ee as MissingSecretKeyError,h as NotFoundError,S as NovuApiEndpointsEnum,oe as PlatformError,y as PostActionEnum,pe as ProviderExecutionFailedError,ie as ProviderNotFoundError,re as ResourceConflictError,J as ResourceEnum,ne as ResourceExecutionFailed,te as ResourceNotFoundError,E as SIGNATURE_TIMESTAMP_TOLERANCE,v as SIGNATURE_TIMESTAMP_TOLERANCE_MINUTES,M as ServerError,Ee as SeverityLevelEnum,me as SignatureExpiredError,le as SignatureInvalidError,ae as SignatureMismatchError,se as SignatureNotFoundError,ue as SignatureVersionInvalidError,ge as SigningKeyNotFoundError,de as StepAlreadyExistsError,z as StepControlCompilationFailedError,fe as StepExecutionFailedError,ce as StepNotFoundError,_ as UnauthorizedError,c as WORKFLOW_ORIGIN_LINE_MAX_CHARS,Ae as WorkflowAlreadyExistsError,P as WorkflowChannelEnum,xe as WorkflowNotFoundError,U as WorkflowPayloadInvalidError,g as actionStepSchemas,s as buildApprovalActionId,f as buildWorkflowOriginInjection,d as buildWorkflowOriginLine,u as channelStepSchemas,A as compileJsonControlValues,o as createLiquidEngine,ye as digest,Y as isFrameworkError,T as isNativeError,l as parseApprovalActionId,Re as pluralize,x as repairJsonString,Se as toSentence,r as toSentenceArgsValidator};

package/dist/esm/langchain/index.d.ts

@@ -1,5 +1,5 @@
 import { BaseMessage } from '@langchain/core/messages';
-import { l as AgentHistoryEntry, M as MessageContent, k as AgentHandlers, m as AgentMessage, o as AgentMessageContext, x as ToolApprovalDecision, b as AgentActionContext, R as ReplyHandle, A as Agent } from '../agent.types-HUDhyXrV.js';
+import { l as AgentHistoryEntry, j as AgentHandlerContext, M as MessageContent, k as AgentHandlers, n as AgentMessage, p as AgentMessageContext, D as ToolApprovalDecision, b as AgentActionContext, R as ReplyHandle, A as Agent } from '../agent.types-DFLG1_vb.js';
 import { LanguageModelLike } from '@langchain/core/language_models/base';
 import { RunnableConfig } from '@langchain/core/runnables';
 import { StructuredToolInterface } from '@langchain/core/tools';
@@ -14,10 +14,13 @@ interface ToolResultPayload {
 }
 
 /**
- * Convert `ctx.history` into LangChain `BaseMessage[]` for `createAgent().invoke(...)`.
+ * Convert conversation context into LangChain `BaseMessage[]` for `createAgent().invoke(...)`.
  *
- * History already includes the current incoming message — do not append the handler's
- * `message` argument on top of it.
+ * Pass `ctx` to prepend `ctx.notification` as an `AIMessage`. Pass `ctx.history` to skip that
+ * injection (e.g. after `isFromWorkflow`). History already includes the current inbound message.
+ *
+ * Returning a `LangChainAgentConfig` hydrates unreachable attachment URLs for you.
+ * If you invoke the agent yourself, wrap this result in `hydrateUnreachableAttachmentUrls`.
  *
  * @param system - Optional system prompt prepended as a `SystemMessage`. Omit it when the
  *   agent already receives a prompt (e.g. via `createAgent({ prompt })`) to avoid duplication.
@@ -25,6 +28,17 @@ interface ToolResultPayload {
  *   with a fresh result are replayed as resolved call+result pairs.
  */
 declare function toLangChainMessages(history: AgentHistoryEntry[], system?: string, freshResults?: Map<string, ToolResultPayload>): BaseMessage[];
+declare function toLangChainMessages(ctx: Pick<AgentHandlerContext, 'history' | 'notification'>, system?: string, freshResults?: Map<string, ToolResultPayload>): BaseMessage[];
+
+/**
+ * Replace attachment URLs a hosted model cannot fetch with inline base64.
+ * HTTPS public URLs are left as-is so production signed S3 links stay URL-based.
+ * Over-budget downloads are omitted so one large file cannot abort the turn.
+ *
+ * Novu calls this automatically when you return a `LangChainAgentConfig`.
+ * Call it yourself before `createAgent().invoke(...)` when you map history.
+ */
+declare function hydrateUnreachableAttachmentUrls(messages: BaseMessage[]): Promise<BaseMessage[]>;
 
 /** A tool call surfaced to `needsApproval` before it executes. */
 interface LangChainToolCall {
@@ -40,7 +54,11 @@ interface LangChainToolCall {
  * `ctx.history` — no LangGraph checkpointer required.
  */
 interface LangChainAgentConfig {
-    /** Chat model instance or `"provider:model"` identifier passed to `createAgent`. */
+    /**
+     * Chat model instance or `"provider:model"` identifier passed to `createAgent`.
+     * On Next.js, model strings require LangChain packages in `serverExternalPackages`
+     * (scaffolded by `novu connect --runtime langchain`).
+     */
     model: string | LanguageModelLike;
     /** Tools available to the agent. */
     tools?: StructuredToolInterface[];
@@ -117,4 +135,4 @@ declare class NovuToolApprovalRequired extends Error {
     });
 }
 
-export { type LangChainAgentConfig, type LangChainAgentHandlers, type LangChainInvokeResult, type LangChainResult, type LangChainToolCall, NovuToolApprovalRequired, agent, toLangChainMessages };
+export { type LangChainAgentConfig, type LangChainAgentHandlers, type LangChainInvokeResult, type LangChainResult, type LangChainToolCall, NovuToolApprovalRequired, agent, hydrateUnreachableAttachmentUrls, toLangChainMessages };

package/dist/esm/langchain/index.js

@@ -1 +1 @@
-import{b as g,c as I,f as T}from"../chunk-W6DIBD4Z.js";import"../chunk-FHYMHX3T.js";import{AIMessage as J,HumanMessage as V,SystemMessage as G}from"@langchain/core/messages";import{AIMessage as D,ToolMessage as w}from"@langchain/core/messages";var M="tool_approval_request",h="tool_approval_decision",x="tool_result",U=JSON.stringify({type:"execution-denied"});function m(e){var t;let o=e.toolData;if(!(!o||typeof o.approvalId!="string"||typeof o.toolCallId!="string"))return{approvalId:o.approvalId,toolCallId:o.toolCallId,name:(t=o.toolName)!=null?t:"tool",input:o.input}}function E(e){let o=e.toolData;if(!(!o||typeof o.approvalId!="string"||typeof o.approved!="boolean"))return{approvalId:o.approvalId,approved:o.approved}}function L(e){let o=e.toolData;if(!(!o||typeof o.toolCallId!="string"))return{toolCallId:o.toolCallId,toolName:o.toolName,output:o.output}}function N(e,o){let t=new Set,n=new Map,r=new Map;for(let a of e)if(a.type===M){let s=m(a);s&&r.set(s.approvalId,s.toolCallId)}else if(a.type===h){let s=E(a);s&&!s.approved&&t.add(s.approvalId)}else if(a.type===x){let s=L(a);s&&n.set(s.toolCallId,s)}if(o)for(let[a,s]of o)n.set(a,s);return{deniedApprovalIds:t,toolResults:n,approvalIdToToolCallId:r}}function j(e,o){return o.deniedApprovalIds.has(e.approvalId)?"denied":o.toolResults.has(e.toolCallId)?"resolved":"in-flight"}function R(e){var o;return new D({content:"",tool_calls:[{id:e.toolCallId,name:e.name,args:(o=e.input)!=null?o:{},type:"tool_call"}]})}function $(e){return typeof e=="string"?e:JSON.stringify(e)}function Y(e){var o;return new w({content:$(e.output),tool_call_id:e.toolCallId,name:(o=e.toolName)!=null?o:"tool"})}function z(e){return new w({content:U,tool_call_id:e.toolCallId,name:e.name,status:"error"})}function S(e,o){let t=m(e);if(!t)return[];let n=j(t,o);switch(n){case"denied":return[R(t),z(t)];case"resolved":{let r=o.toolResults.get(t.toolCallId);return r?[R(t),Y(r)]:[]}case"in-flight":return[];default:return n}}function P(e){let o=new Set,t=new Set,n=[];for(let r of e)if(r.type===M){let a=m(r);a&&n.push({approvalId:a.approvalId,toolCallId:a.toolCallId,toolName:a.name,input:a.input})}else if(r.type===h){let a=E(r);a!=null&&a.approved&&o.add(a.approvalId)}else if(r.type===x){let a=L(r);a&&t.add(a.toolCallId)}return n.filter(r=>o.has(r.approvalId)&&!t.has(r.toolCallId)).map(({toolCallId:r,toolName:a,input:s})=>({toolCallId:r,toolName:a,input:s}))}var Q="message",X="tool_approval_request";function _(e){return e==="agent"||e==="assistant"}function F(e){let o=new Set;for(let t of e)!_(t.role)&&t.role!=="system"&&t.senderName&&o.add(t.senderName);return o.size}function K(e,o){if(!e.content.trim())return;if(_(e.role))return new J(e.content);let n=o&&e.senderName?`${e.senderName}: ${e.content}`:e.content;return new V(n)}function W(e,o,t){switch(e.type){case Q:{let n=K(e,o);return n?[n]:[]}case X:return S(e,t);default:return[]}}function y(e,o,t){let n=F(e)>1,r=N(e,t),a=e.flatMap(s=>W(s,n,r));return o?[new G(o),...a]:a}import{isAIMessage as ie,isBaseMessage as q}from"@langchain/core/messages";import{createAgent as pe}from"langchain";import{isBaseMessage as Z}from"@langchain/core/messages";import{createMiddleware as ee}from"langchain";var d=class extends Error{constructor(o){super(`Tool "${o.toolName}" requires approval`),this.name="NovuToolApprovalRequired",this.toolCallId=o.toolCallId,this.toolName=o.toolName,this.input=o.input}},oe=10;function k(e){let o=e;for(let t=0;t<oe&&o!=null;t+=1){if(o instanceof d)return o;o=o.cause}}function H(e){return ee({name:"novu-tool-approval",wrapToolCall:async(o,t)=>{let{id:n,name:r,args:a}=o.toolCall,s=a!=null?a:{};if(e({id:n,name:r,args:s}))throw new d({toolCallId:n!=null?n:r,toolName:r,input:s});return t(o)}})}async function B(e,o,t){let n={id:o.toolCallId,name:o.toolName,input:o.input};await T(e,n,t)}function te(e){return Z(e)?e.content:e}function ne(e){let o=new Map;for(let t of e!=null?e:[])o.set(t.name,t);return o}async function O(e,o){var a;let t=P(o.history),n=new Map;if(t.length===0)return n;let r=ne(e);for(let s of t){let l=r.get(s.toolName);if(!l)continue;let i=te(await l.invoke((a=s.input)!=null?a:{}));n.set(s.toolCallId,{toolCallId:s.toolCallId,toolName:s.toolName,output:i}),o.emitToolResult({toolCallId:s.toolCallId,toolName:s.toolName,output:i,preview:`Tool "${s.toolName}" result`})}return n}import{isToolMessage as ae}from"@langchain/core/messages";function re(e){var t;let o=new Set;for(let n of e.history)n.type==="tool_approval_request"&&((t=n.toolData)!=null&&t.toolCallId)&&o.add(n.toolData.toolCallId);return o}function se(e,o){var n;let t=new Set(o);for(let r of e.history)r.type==="tool_result"&&((n=r.toolData)!=null&&n.toolCallId)&&t.add(r.toolData.toolCallId);return t}function le(e){return typeof e=="string"?e:JSON.stringify(e)}function A(e,o,t=new Set){var a;let n=re(o);if(n.size===0)return;let r=se(o,t);for(let s of e){if(!ae(s))continue;let l=s.tool_call_id;!n.has(l)||r.has(l)||(r.add(l),o.emitToolResult({toolCallId:l,toolName:s.name,output:le(s.content),preview:`Tool "${(a=s.name)!=null?a:l}" result`}))}}function b(e){if(typeof e!="object"||e===null)return!1;let o=e.model;return typeof o=="string"||typeof o=="object"&&o!==null}function ue(e){return typeof e=="object"&&e!==null&&Array.isArray(e.messages)}function f(e){return typeof e!="object"||e===null||I(e)?!1:q(e)||b(e)||ue(e)}function de(e){return typeof e=="string"?e:e.map(o=>{let t=o;return t.type==="text"&&typeof t.text=="string"?t.text:""}).join("")}function C(e){for(let o=e.length-1;o>=0;o-=1){let t=e[o];if(ie(t))return de(t.content).trim()}return""}async function v(e,o,t){var r;if(!e){await o.typing.stop();return}let n=t&&(r=await t(e))!=null?r:e;await o.reply(n)}async function ge(e,o,t){var i;let n=await O(e.tools,o),r=y(o.history,void 0,n),a=[];e.needsApproval&&a.push(H(e.needsApproval)),e.middleware&&a.push(...e.middleware);let s=pe({model:e.model,tools:(i=e.tools)!=null?i:[],...e.system?{prompt:e.system}:{},...a.length>0?{middleware:a}:{}}),l;try{l=await s.invoke({messages:r},e.invokeConfig)}catch(p){let u=k(p);if(u){await B(o,u,t);return}throw p}A(l.messages,o,new Set(n.keys())),await v(C(l.messages),o,e.formatReply)}async function c(e,o,t){if(b(e)){await ge(e,o,t);return}if(q(e)){await v(C([e]),o);return}A(e.messages,o),await v(C(e.messages),o)}var fe={text:"",platformMessageId:"",author:{userId:"",fullName:"",userName:"",isBot:!1},timestamp:""};function ce(e){return typeof e=="object"&&e!==null&&"messageId"in e&&"platformThreadId"in e}function me(e,o){let t=typeof o=="function"?{onMessage:o}:o;if(typeof t.onMessage!="function")throw new Error(`agent('${e}') requires an onMessage handler`);return t}function ye(e,o){if(!e)throw new Error("agent() requires a non-empty agentId");let t=me(e,o),n=t.toolApproval,r=typeof t.onToolApproval=="function",a=async l=>{let i=g(l),p=await t.onMessage(fe,i.asMessageContext());f(p)&&await c(p,i,n)},s={onMessage:async(l,i)=>{let p=await t.onMessage(l,i);if(f(p)){await c(p,g(i),n);return}return p},onToolApproval:async(l,i)=>{let p=g(i);if(t.onToolApproval){let u=await t.onToolApproval(l,i);if(f(u)){await c(u,p,n);return}u!=null&&!ce(u)&&await p.reply(u)}await a(i)},...n&&{toolApproval:n},...t.onAction&&{onAction:t.onAction},...t.onReaction&&{onReaction:t.onReaction},...t.onResolve&&{onResolve:t.onResolve},...t.onError&&{onError:t.onError}};return{id:e,handlers:s,userOnToolApproval:r}}export{d as NovuToolApprovalRequired,ye as agent,y as toLangChainMessages};
+import{a as R,b as M,c as x,d as P,f as L}from"../chunk-YZ3P3MMZ.js";import{c as w}from"../chunk-QZ6TSYCK.js";import{a as I,d as g,g as T}from"../chunk-PU74XQ2P.js";import"../chunk-FHYMHX3T.js";import{AIMessage as j,HumanMessage as D,SystemMessage as te}from"@langchain/core/messages";import{AIMessage as Q,ToolMessage as H}from"@langchain/core/messages";var S="tool_approval_request",k="tool_approval_decision",N="tool_result",X=JSON.stringify({type:"execution-denied"});function m(e){var o;let t=e.toolData;if(!(!t||typeof t.approvalId!="string"||typeof t.toolCallId!="string"))return{approvalId:t.approvalId,toolCallId:t.toolCallId,name:(o=t.toolName)!=null?o:"tool",input:t.input}}function _(e){let t=e.toolData;if(!(!t||typeof t.approvalId!="string"||typeof t.approved!="boolean"))return{approvalId:t.approvalId,approved:t.approved}}function B(e){let t=e.toolData;if(!(!t||typeof t.toolCallId!="string"))return{toolCallId:t.toolCallId,toolName:t.toolName,output:t.output}}function b(e,t){let o=new Set,n=new Map,a=new Map;for(let r of e)if(r.type===S){let s=m(r);s&&a.set(s.approvalId,s.toolCallId)}else if(r.type===k){let s=_(r);s&&!s.approved&&o.add(s.approvalId)}else if(r.type===N){let s=B(r);s&&n.set(s.toolCallId,s)}if(t)for(let[r,s]of t)n.set(r,s);return{deniedApprovalIds:o,toolResults:n,approvalIdToToolCallId:a}}function W(e,t){return t.deniedApprovalIds.has(e.approvalId)?"denied":t.toolResults.has(e.toolCallId)?"resolved":"in-flight"}function E(e){var t;return new Q({content:"",tool_calls:[{id:e.toolCallId,name:e.name,args:(t=e.input)!=null?t:{},type:"tool_call"}]})}function K(e){return typeof e=="string"?e:JSON.stringify(e)}function Z(e){var t;return new H({content:K(e.output),tool_call_id:e.toolCallId,name:(t=e.toolName)!=null?t:"tool"})}function ee(e){return new H({content:X,tool_call_id:e.toolCallId,name:e.name,status:"error"})}function O(e,t){let o=m(e);if(!o)return[];let n=W(o,t);switch(n){case"denied":return[E(o),ee(o)];case"resolved":{let a=t.toolResults.get(o.toolCallId);return a?[E(o),Z(a)]:[]}case"in-flight":return[];default:return n}}function U(e){let t=new Set,o=new Set,n=[];for(let a of e)if(a.type===S){let r=m(a);r&&n.push({approvalId:r.approvalId,toolCallId:r.toolCallId,toolName:r.name,input:r.input})}else if(a.type===k){let r=_(a);r!=null&&r.approved&&t.add(r.approvalId)}else if(a.type===N){let r=B(a);r&&o.add(r.toolCallId)}return n.filter(a=>t.has(a.approvalId)&&!o.has(a.toolCallId)).map(({toolCallId:a,toolName:r,input:s})=>({toolCallId:a,toolName:r,input:s}))}function q(e){return x(e).map(t=>M(t.mediaType)?{type:"image",url:t.url,mimeType:t.mediaType}:{type:"file",url:t.url,mimeType:t.mediaType,...t.name?{metadata:{title:t.name}}:{}})}var oe="message",ne="tool_approval_request";function $(e){return e==="agent"||e==="assistant"}function ae(e){let t=new Set;for(let o of e)!$(o.role)&&o.role!=="system"&&o.senderName&&t.add(o.senderName);return t.size}function re(e,t){let o=$(e.role),n=!!e.content.trim(),a=o?[]:q(e);if(!n&&a.length===0)return;if(o)return new j(e.content);let r=t&&e.senderName?`${e.senderName}: ${e.content}`:e.content;if(a.length===0)return new D(r);let s=n?[...a,{type:"text",text:r}]:a;return new D({content:s})}function se(e,t,o){switch(e.type){case oe:{let n=re(e,t);return n?[n]:[]}case ne:return O(e,o);default:return[]}}function y(e,t,o){let{history:n,notification:a}=R(e),r=ae(n)>1,s=b(n,o),l=n.flatMap(p=>se(p,r,s)),i=a?[new j(w(a.workflowId,a.body,a.payload)),...l]:l;return t?[new te(t),...i]:i}import{HumanMessage as le,isHumanMessage as ie}from"@langchain/core/messages";async function pe(e){if(!e||typeof e!="object")return e;let t=e;if(t.type!=="image"&&t.type!=="file"||typeof t.url!="string"||P(t.url))return e;let o=await L(t.url);if(!o)return null;let{url:n,...a}=t;return{...a,data:o}}async function A(e){return Promise.all(e.map(async t=>{if(!ie(t)||!Array.isArray(t.content))return t;let o=(await Promise.all(t.content.map(n=>pe(n)))).filter(n=>n!=null);return new le({content:o})}))}import{isAIMessage as ve,isBaseMessage as V}from"@langchain/core/messages";import{createAgent as he}from"langchain";import{isBaseMessage as ue}from"@langchain/core/messages";import{createMiddleware as de}from"langchain";var d=class extends Error{constructor(t){super(`Tool "${t.toolName}" requires approval`),this.name="NovuToolApprovalRequired",this.toolCallId=t.toolCallId,this.toolName=t.toolName,this.input=t.input}},ge=10;function Y(e){let t=e;for(let o=0;o<ge&&t!=null;o+=1){if(t instanceof d)return t;t=t.cause}}function z(e){return de({name:"novu-tool-approval",wrapToolCall:async(t,o)=>{let{id:n,name:a,args:r}=t.toolCall,s=r!=null?r:{};if(e({id:n,name:a,args:s}))throw new d({toolCallId:n!=null?n:a,toolName:a,input:s});return o(t)}})}async function F(e,t,o){let n={id:t.toolCallId,name:t.toolName,input:t.input};await T(e,n,o)}function ce(e){return ue(e)?e.content:e}function fe(e){let t=new Map;for(let o of e!=null?e:[])t.set(o.name,o);return t}async function J(e,t){var r;let o=U(t.history),n=new Map;if(o.length===0)return n;let a=fe(e);for(let s of o){let l=a.get(s.toolName);if(!l)continue;let i=ce(await l.invoke((r=s.input)!=null?r:{}));n.set(s.toolCallId,{toolCallId:s.toolCallId,toolName:s.toolName,output:i}),t.emitToolResult({toolCallId:s.toolCallId,toolName:s.toolName,output:i,preview:`Tool "${s.toolName}" result`})}return n}import{isToolMessage as me}from"@langchain/core/messages";function ye(e){var o;let t=new Set;for(let n of e.history)n.type==="tool_approval_request"&&((o=n.toolData)!=null&&o.toolCallId)&&t.add(n.toolData.toolCallId);return t}function Ae(e,t){var n;let o=new Set(t);for(let a of e.history)a.type==="tool_result"&&((n=a.toolData)!=null&&n.toolCallId)&&o.add(a.toolData.toolCallId);return o}function Ce(e){return typeof e=="string"?e:JSON.stringify(e)}function C(e,t,o=new Set){var r;let n=ye(t);if(n.size===0)return;let a=Ae(t,o);for(let s of e){if(!me(s))continue;let l=s.tool_call_id;!n.has(l)||a.has(l)||(a.add(l),t.emitToolResult({toolCallId:l,toolName:s.name,output:Ce(s.content),preview:`Tool "${(r=s.name)!=null?r:l}" result`}))}}function G(e){if(typeof e!="object"||e===null)return!1;let t=e.model;return typeof t=="string"||typeof t=="object"&&t!==null}function Ie(e){return typeof e=="object"&&e!==null&&Array.isArray(e.messages)}function c(e){return typeof e!="object"||e===null||I(e)?!1:V(e)||G(e)||Ie(e)}function Te(e){return typeof e=="string"?e:e.map(t=>{let o=t;return o.type==="text"&&typeof o.text=="string"?o.text:""}).join("")}function v(e){for(let t=e.length-1;t>=0;t-=1){let o=e[t];if(ve(o))return Te(o.content).trim()}return""}async function h(e,t,o){var a;if(!e){await t.typing.stop();return}let n=o&&(a=await o(e))!=null?a:e;await t.reply(n)}async function Re(e,t,o){var i;let n=await J(e.tools,t),a=await A(y(t,void 0,n)),r=[];e.needsApproval&&r.push(z(e.needsApproval)),e.middleware&&r.push(...e.middleware);let s=he({model:e.model,tools:(i=e.tools)!=null?i:[],...e.system?{prompt:e.system}:{},...r.length>0?{middleware:r}:{}}),l;try{l=await s.invoke({messages:a},e.invokeConfig)}catch(p){let u=Y(p);if(u){await F(t,u,o);return}throw p}C(l.messages,t,new Set(n.keys())),await h(v(l.messages),t,e.formatReply)}async function f(e,t,o){if(G(e)){await Re(e,t,o);return}if(V(e)){await h(v([e]),t);return}C(e.messages,t),await h(v(e.messages),t)}var we={text:"",platformMessageId:"",author:{userId:"",fullName:"",userName:"",isBot:!1},timestamp:""};function Me(e){return typeof e=="object"&&e!==null&&"messageId"in e&&"platformThreadId"in e}function xe(e,t){let o=typeof t=="function"?{onMessage:t}:t;if(typeof o.onMessage!="function")throw new Error(`agent('${e}') requires an onMessage handler`);return o}function Pe(e,t){if(!e)throw new Error("agent() requires a non-empty agentId");let o=xe(e,t),n=o.toolApproval,a=typeof o.onToolApproval=="function",r=async l=>{let i=g(l),p=await o.onMessage(we,i.asMessageContext());c(p)&&await f(p,i,n)},s={onMessage:async(l,i)=>{let p=await o.onMessage(l,i);if(c(p)){await f(p,g(i),n);return}return p},onToolApproval:async(l,i)=>{let p=g(i);if(o.onToolApproval){let u=await o.onToolApproval(l,i);if(c(u)){await f(u,p,n);return}u!=null&&!Me(u)&&await p.reply(u)}await r(i)},...n&&{toolApproval:n},...o.onAction&&{onAction:o.onAction},...o.onReaction&&{onReaction:o.onReaction},...o.onResolve&&{onResolve:o.onResolve},...o.onError&&{onError:o.onError}};return{id:e,handlers:s,userOnToolApproval:a}}export{d as NovuToolApprovalRequired,Pe as agent,A as hydrateUnreachableAttachmentUrls,y as toLangChainMessages};

package/dist/esm/servers/express.d.ts

@@ -1,10 +1,10 @@
-import { S as ServeHandlerOptions } from '../index-C0oUWDlb.js';
-export { C as Client, N as NovuRequestHandler, a as agent, w as workflow } from '../index-C0oUWDlb.js';
-export { C as ClientOptions, a as CronExpression, E as ExecuteInput, S as SeverityLevelEnum, W as Workflow } from '../health-check.types-0Rv-l8yD.js';
-export { C as ContextResolved, E as EnvironmentSystemVariables, S as Subscriber, p as providerSchemas } from '../subscriber.types-g7VnI_ZQ.js';
+import { S as ServeHandlerOptions } from '../index-BvRGmHFw.js';
+export { C as Client, N as NovuRequestHandler, a as agent, i as isFromWorkflow, w as workflow } from '../index-BvRGmHFw.js';
+export { C as ClientOptions, a as CronExpression, E as ExecuteInput, S as SeverityLevelEnum, W as Workflow } from '../health-check.types-DORn4djx.js';
+export { C as ContextResolved, E as EnvironmentSystemVariables, S as Subscriber, p as providerSchemas } from '../subscriber.types-Drf26WPA.js';
 import { S as SupportedFrameworkName } from '../server.types-Cc6o5eYH.js';
-export { Actions, Button, Card, CardChild, CardElement, CardLink, CardText, Divider, Select, SelectOption, TextInput } from 'chat';
-export { A as Agent, a as AgentAction, b as AgentActionContext, c as AgentAttachment, d as AgentContext, e as AgentContextPayload, f as AgentContextValue, g as AgentConversation, h as AgentDeliveryError, i as AgentError, j as AgentHandlerContext, k as AgentHandlers, l as AgentHistoryEntry, m as AgentMessage, n as AgentMessageAuthor, o as AgentMessageContext, p as AgentPlatformContext, q as AgentReaction, r as AgentReactionContext, s as AgentResolveContext, t as AgentSubscriber, u as AgentSubscriberAccess, v as AgentToolCall, F as FileRef, M as MessageContent, R as ReplyHandle, T as ToolApprovalCard, w as ToolApprovalConfig, x as ToolApprovalDecision, y as toAgentError } from '../agent.types-HUDhyXrV.js';
+export { Actions, Button, Card, CardChild, CardElement, CardLink, CardText, Divider, Image, ImageElement, Select, SelectOption, TextInput } from 'chat';
+export { A as Agent, a as AgentAction, b as AgentActionContext, c as AgentAttachment, d as AgentContext, e as AgentContextPayload, f as AgentContextValue, g as AgentConversation, h as AgentDeliveryError, i as AgentError, j as AgentHandlerContext, k as AgentHandlers, l as AgentHistoryEntry, m as AgentHumanResponse, n as AgentMessage, o as AgentMessageAuthor, p as AgentMessageContext, q as AgentNotification, r as AgentPlatformContext, s as AgentReaction, t as AgentReactionContext, u as AgentResolveContext, v as AgentSubscriber, w as AgentSubscriberAccess, x as AgentToolCall, F as FileRef, H as HumanAskApproveOptions, y as HumanChooseOptions, z as HumanInteractionKind, B as HumanTellOptions, M as MessageContent, R as ReplyHandle, T as ToolApprovalCard, C as ToolApprovalConfig, D as ToolApprovalDecision, E as toAgentError } from '../agent.types-DFLG1_vb.js';
 export { AnyStepResolver, ChatStepResolver, EmailStepResolver, InAppStepResolver, PushStepResolver, SmsStepResolver, StepResolverContext, ToolStepResolver, step } from '../step-resolver.js';
 import '../util.types-DaFfsxgy.js';
 import '../base.schema.types-BApIn9jr.js';

package/dist/esm/servers/express.js

@@ -1 +1 @@
-import{b as x,c as a,d as V,e as O}from"../chunk-CGZ5P44A.js";import{a as $}from"../chunk-YLCLZVYS.js";import"../chunk-XIVU4VDS.js";import{M as A,N,O as R,V as k}from"../chunk-FMKD6TON.js";import{a as y,b as h,c,d as m,e as f,f as H,p as v,q as w,r as E}from"../chunk-X5AZIKIR.js";import"../chunk-RBTQQ5IZ.js";import{a as b}from"../chunk-SPS3KBKF.js";import{f as S}from"../chunk-VY27ZAO7.js";import"../chunk-W6DIBD4Z.js";import"../chunk-FHYMHX3T.js";var l="express",U=p=>new a({frameworkName:l,...p,handler:(t,o)=>({body:()=>t.body,headers:e=>{let r=t.headers[e];return Array.isArray(r)?r[0]:r},method:()=>t.method||"GET",url:()=>{let e=t.headers.host||"",r=e!=null&&e.includes("://")?"":`${t.protocol||"https"}://`;return new URL(t.originalUrl||t.url||"",`${r}${e||""}`)},queryString:e=>{let r=t.query[e];return Array.isArray(r)?r[0]:r},transformResponse:({body:e,headers:r,status:s})=>(Object.entries(r).forEach(([n,d])=>{o.setHeader(n,d)}),o.status(s).send(e))})}).createHandler();export{y as Actions,N as AgentDeliveryError,A as AgentError,h as Button,c as Card,m as CardLink,f as CardText,x as Client,S as CronExpression,H as Divider,a as NovuRequestHandler,v as Select,w as SelectOption,k as SeverityLevelEnum,E as TextInput,V as agent,l as frameworkName,b as providerSchemas,U as serve,$ as step,R as toAgentError,O as workflow};
+import{b as N,c as a,d as k,e as i}from"../chunk-PBC7WR2R.js";import{a as F}from"../chunk-YLCLZVYS.js";import"../chunk-XIVU4VDS.js";import{N as R,O as V,P as b,W as $}from"../chunk-4ETX7FIT.js";import{a as y,b as h,c,d as m,e as f,f as H,i as v,p as w,q as E,r as S}from"../chunk-X5AZIKIR.js";import"../chunk-RBTQQ5IZ.js";import{a as O}from"../chunk-IREH6K2M.js";import{f as x}from"../chunk-VY27ZAO7.js";import{b as A}from"../chunk-PU74XQ2P.js";import"../chunk-FHYMHX3T.js";var l="express",q=p=>new a({frameworkName:l,...p,handler:(t,o)=>({body:()=>t.body,headers:e=>{let r=t.headers[e];return Array.isArray(r)?r[0]:r},method:()=>t.method||"GET",url:()=>{let e=t.headers.host||"",r=e!=null&&e.includes("://")?"":`${t.protocol||"https"}://`;return new URL(t.originalUrl||t.url||"",`${r}${e||""}`)},queryString:e=>{let r=t.query[e];return Array.isArray(r)?r[0]:r},transformResponse:({body:e,headers:r,status:s})=>(Object.entries(r).forEach(([n,d])=>{o.setHeader(n,d)}),o.status(s).send(e))})}).createHandler();export{y as Actions,V as AgentDeliveryError,R as AgentError,h as Button,c as Card,m as CardLink,f as CardText,N as Client,x as CronExpression,H as Divider,v as Image,a as NovuRequestHandler,w as Select,E as SelectOption,$ as SeverityLevelEnum,S as TextInput,k as agent,l as frameworkName,A as isFromWorkflow,O as providerSchemas,q as serve,F as step,b as toAgentError,i as workflow};