@novu/framework 2.13.0 → 2.13.1-rc.852194fa77

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

@@ -1,10 +1,10 @@
-import { P as PostActionEnum } from '../health-check.types-BNocZ4Wk.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-BNocZ4Wk.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 actionStepSchemas, $ as channelStepSchemas } from '../subscriber.types-CmybpXhA.js';
+import { P as PostActionEnum } from '../health-check.types-CL5-B_D4.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-CL5-B_D4.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-D4PvRIKR.js';
 import { Filter, LiquidOptions, Liquid } from 'liquidjs';
 import { Emoji } from 'chat';
-import { h as AgentHandlerContext, z as ToolResult, B as ToolApprovalRequestPayload, T as ToolApprovalCard, R as ReplyHandle, m as AgentMessageContext, C as AgentEventEnum, a as AgentAction, k as AgentMessage, o as AgentReaction, e as AgentConversation, r as AgentSubscriber, j as AgentHistoryEntry, n as AgentPlatformContext, D as TypingControl, E as ToolApprovalControl, G as AgentBridgeRequest, t as ToolApprovalConfig, M as MessageContent, F as FileRef, H as AgentReplyPayload, S as SentMessageInfo, w as TriggerRecipientsPayload } from '../agent.types-E3sxq6xr.js';
-export { J as DeleteMessagePayload, K as EditPayload, L as MetadataSignal, P as ParsedApprovalAction, N as ReplyContent, O as Signal, Q as TriggerSignal, U as buildApprovalActionId, V as parseApprovalActionId } from '../agent.types-E3sxq6xr.js';
+import { j as AgentHandlerContext, E as ToolResult, G as ToolApprovalRequestPayload, T as ToolApprovalCard, R as ReplyHandle, o as AgentMessageContext, H as AgentEventEnum, a as AgentAction, m as AgentMessage, r as AgentReaction, g as AgentConversation, u as AgentSubscriber, e as AgentContextPayload, p as AgentNotification, l as AgentHistoryEntry, q as AgentPlatformContext, J as TypingControl, K as ToolApprovalControl, L as AgentBridgeRequest, x as ToolApprovalConfig, M as MessageContent, F as FileRef, N as ReplyContent, S as Signal, O as AddReactionPayload, P as DeleteMessagePayload, Q as SentMessageInfo, U as TypingOp, B as TriggerRecipientsPayload } from '../agent.types-C17NUGxY.js';
+export { V as AgentReplyPayload, X as EditPayload, Y as MetadataSignal, Z as ParsedApprovalAction, _ as TriggerSignal, $ as buildApprovalActionId, a0 as parseApprovalActionId } from '../agent.types-C17NUGxY.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,248 @@ 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 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 +673,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>;
@@ -456,6 +726,8 @@ declare class AgentContextImpl implements AgentRuntimeContext {
     readonly reaction: AgentReaction | null;
     readonly conversation: AgentConversation;
     readonly subscriber: AgentSubscriber | null;
+    readonly context: AgentContextPayload | null;
+    readonly notification: AgentNotification | null;
     readonly history: AgentHistoryEntry[];
     readonly platform: string;
     readonly platformContext: AgentPlatformContext;
@@ -476,11 +748,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?: {
@@ -489,6 +757,10 @@ 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;
@@ -500,18 +772,29 @@ declare class AgentContextImpl implements AgentRuntimeContext {
     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.
  *
@@ -521,4 +804,7 @@ declare class AgentContextImpl implements AgentRuntimeContext {
  */
 declare function createLiquidEngine(options?: LiquidOptions): Liquid;
 
-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, createLiquidEngine, digest, isFrameworkError, isNativeError, pluralize, toSentence, toSentenceArgsValidator };
+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, 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 oe,B as re,C as ae,D as pe,E as ne,F as ie,H as le,I as se,J as me,K as e,L as t,P as o,S as p,U as ge,V as fe,a as C,b as M,c as D,d as b,e as k,f as B,g as O,h as _,i as j,j as w,k as z,m as G,n as H,o as J,p as K,q as N,r as Q,s as U,t as W,u as X,v as Y,w as Z,x as $,y as ee,z as te}from"../chunk-LHU5A7DI.js";import"../chunk-46AHJTS7.js";import"../chunk-XEHQJMMQ.js";import{e as n,f as i}from"../chunk-CANJPWLT.js";import{a as l,b as s,c as m,d as g,e as f,f as x,g as d,h as c,i as u,j as A,k as y,l as S,m as I,n as R,o as v,p as q,q as E,r as F,s as L,t as P,u as T,v as V,w as h}from"../chunk-FRWG7YTE.js";import{d as r,e as a}from"../chunk-W6DIBD4Z.js";import"../chunk-FHYMHX3T.js";var de={toSentence:e};export{R as ActionStepEnum,p as AgentContextImpl,o as AgentEventEnum,L as BadRequestError,C as BridgeError,I as ChannelStepEnum,V as ConflictError,x as CronExpression,d as ErrorCodeEnum,b as ExecutionEventControlsInvalidError,D as ExecutionEventPayloadInvalidError,j as ExecutionProviderOutputInvalidError,k as ExecutionStateControlsInvalidError,M as ExecutionStateCorruptError,B as ExecutionStateOutputInvalidError,O as ExecutionStateResultInvalidError,de as FILTER_VALIDATORS,h as ForbiddenError,E as FrameworkError,s as GetActionEnum,c as HttpHeaderKeysEnum,u as HttpMethodEnum,A as HttpQueryKeysEnum,y as HttpStatusEnum,H as InvalidActionError,ge as JobStatusEnum,G as MethodNotAllowedError,J as MissingSecretKeyError,F as NotFoundError,m as NovuApiEndpointsEnum,K as PlatformError,l as PostActionEnum,X as ProviderExecutionFailedError,W as ProviderNotFoundError,N as ResourceConflictError,S as ResourceEnum,U as ResourceExecutionFailed,Q as ResourceNotFoundError,f as SIGNATURE_TIMESTAMP_TOLERANCE,g as SIGNATURE_TIMESTAMP_TOLERANCE_MINUTES,T as ServerError,fe as SeverityLevelEnum,ee as SignatureExpiredError,$ as SignatureInvalidError,Y as SignatureMismatchError,Z as SignatureNotFoundError,oe as SignatureVersionInvalidError,te as SigningKeyNotFoundError,ae as StepAlreadyExistsError,_ as StepControlCompilationFailedError,pe as StepExecutionFailedError,re as StepNotFoundError,P as UnauthorizedError,ie as WorkflowAlreadyExistsError,v as WorkflowChannelEnum,ne as WorkflowNotFoundError,w as WorkflowPayloadInvalidError,n as actionStepSchemas,r as buildApprovalActionId,i as channelStepSchemas,t as createLiquidEngine,le as digest,z as isFrameworkError,q as isNativeError,a as parseApprovalActionId,se as pluralize,me as toSentence,e 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 B,d as G,e as H,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-Q3ALQWIF.js";import"../chunk-X5AZIKIR.js";import"../chunk-RBTQQ5IZ.js";import{e as g,f as u}from"../chunk-UXO4RWZV.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,G as ExecutionEventControlsInvalidError,B as ExecutionEventPayloadInvalidError,Q as ExecutionProviderOutputInvalidError,H 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/jsx-dev-runtime.js

@@ -1 +1 @@
-import"./chunk-2GCKOQK4.js";import"./chunk-3ZWME5KT.js";import{A as x,B as e,C as j,z as s}from"./chunk-XEHQJMMQ.js";import"./chunk-FHYMHX3T.js";export{j as Fragment,s as jsx,e as jsxDEV,x as jsxs};
+import"./chunk-2GCKOQK4.js";import"./chunk-7C3QBYLB.js";import{A as x,B as e,C as j,z as s}from"./chunk-RBTQQ5IZ.js";import"./chunk-FHYMHX3T.js";export{j as Fragment,s as jsx,e as jsxDEV,x as jsxs};

package/dist/esm/{jsx-runtime-P2HN3TPO.js → jsx-runtime-5ZWEWA4A.js}

@@ -1 +1 @@
-import"./chunk-3ZWME5KT.js";import{A as c,B as d,C as e,D as f,E as g,F as h,y as a,z as b}from"./chunk-XEHQJMMQ.js";import"./chunk-FHYMHX3T.js";export{e as Fragment,a as isCardLinkProps,h as isJSX,b as jsx,d as jsxDEV,c as jsxs,f as toCardElement,g as toModalElement};
+import"./chunk-7C3QBYLB.js";import{A as c,B as d,C as e,D as f,E as g,F as h,y as a,z as b}from"./chunk-RBTQQ5IZ.js";import"./chunk-FHYMHX3T.js";export{e as Fragment,a as isCardLinkProps,h as isJSX,b as jsx,d as jsxDEV,c as jsxs,f as toCardElement,g as toModalElement};

package/dist/esm/jsx-runtime.js

@@ -1 +1 @@
-import"./chunk-2GCKOQK4.js";import"./chunk-3ZWME5KT.js";import{A as b,B as c,C as d,z as a}from"./chunk-XEHQJMMQ.js";import"./chunk-FHYMHX3T.js";export{d as Fragment,a as jsx,c as jsxDEV,b as jsxs};
+import"./chunk-2GCKOQK4.js";import"./chunk-7C3QBYLB.js";import{A as b,B as c,C as d,z as a}from"./chunk-RBTQQ5IZ.js";import"./chunk-FHYMHX3T.js";export{d as Fragment,a as jsx,c as jsxDEV,b as jsxs};

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

@@ -1,6 +1,7 @@
 import { BaseMessage } from '@langchain/core/messages';
-import { j as AgentHistoryEntry, i as AgentHandlers, k as AgentMessage, m as AgentMessageContext, M as MessageContent, u as ToolApprovalDecision, b as AgentActionContext, R as ReplyHandle, A as Agent } from '../agent.types-E3sxq6xr.js';
+import { l as AgentHistoryEntry, j as AgentHandlerContext, M as MessageContent, k as AgentHandlers, m as AgentMessage, o as AgentMessageContext, y as ToolApprovalDecision, b as AgentActionContext, R as ReplyHandle, A as Agent } from '../agent.types-C17NUGxY.js';
 import { LanguageModelLike } from '@langchain/core/language_models/base';
+import { RunnableConfig } from '@langchain/core/runnables';
 import { StructuredToolInterface } from '@langchain/core/tools';
 import { AgentMiddleware } from 'langchain';
 import { A as Awaitable } from '../util.types-DaFfsxgy.js';
@@ -13,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.
@@ -24,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 {
@@ -39,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[];
@@ -49,6 +68,19 @@ interface LangChainAgentConfig {
     needsApproval?: (toolCall: LangChainToolCall) => boolean;
     /** Extra LangChain middleware, appended after Novu's approval middleware. */
     middleware?: AgentMiddleware[];
+    /**
+     * Run config forwarded as the second argument to `agent.invoke(...)` (e.g.
+     * `signal`, `configurable`, `context`, `recursionLimit`, `callbacks`). Use this
+     * to control the LangGraph run for a turn.
+     */
+    invokeConfig?: RunnableConfig;
+    /**
+     * Optional post-run reply formatter. Receives the model's final text and returns
+     * the content to deliver — a string or a {@link MessageContent} card. Return
+     * `void`/`undefined` to deliver the final text unchanged. Runs only when the
+     * model produced a non-empty final text.
+     */
+    formatReply?: (finalText: string) => Awaitable<MessageContent | void>;
 }
 /**
  * Result of a LangChain agent/graph you invoked yourself (e.g. `await agent.invoke(...)`).
@@ -103,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,s=new Map;for(let a of e)if(a.type===M){let r=m(a);r&&s.set(r.approvalId,r.toolCallId)}else if(a.type===h){let r=E(a);r&&!r.approved&&t.add(r.approvalId)}else if(a.type===x){let r=L(a);r&&n.set(r.toolCallId,r)}if(o)for(let[a,r]of o)n.set(a,r);return{deniedApprovalIds:t,toolResults:n,approvalIdToToolCallId:s}}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 s=o.toolResults.get(t.toolCallId);return s?[R(t),Y(s)]:[]}case"in-flight":return[];default:return n}}function P(e){let o=new Set,t=new Set,n=[];for(let s of e)if(s.type===M){let a=m(s);a&&n.push({approvalId:a.approvalId,toolCallId:a.toolCallId,toolName:a.name,input:a.input})}else if(s.type===h){let a=E(s);a!=null&&a.approved&&o.add(a.approvalId)}else if(s.type===x){let a=L(s);a&&t.add(a.toolCallId)}return n.filter(s=>o.has(s.approvalId)&&!t.has(s.toolCallId)).map(({toolCallId:s,toolName:a,input:r})=>({toolCallId:s,toolName:a,input:r}))}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,s=N(e,t),a=e.flatMap(r=>W(r,n,s));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 H(e){let o=e;for(let t=0;t<oe&&o!=null;t+=1){if(o instanceof d)return o;o=o.cause}}function k(e){return ee({name:"novu-tool-approval",wrapToolCall:async(o,t)=>{let{id:n,name:s,args:a}=o.toolCall,r=a!=null?a:{};if(e({id:n,name:s,args:r}))throw new d({toolCallId:n!=null?n:s,toolName:s,input:r});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 s=ne(e);for(let r of t){let l=s.get(r.toolName);if(!l)continue;let i=te(await l.invoke((a=r.input)!=null?a:{}));n.set(r.toolCallId,{toolCallId:r.toolCallId,toolName:r.toolName,output:i}),o.emitToolResult({toolCallId:r.toolCallId,toolName:r.toolName,output:i,preview:`Tool "${r.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 s of e.history)s.type==="tool_result"&&((n=s.toolData)!=null&&n.toolCallId)&&t.add(s.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 s=se(o,t);for(let r of e){if(!ae(r))continue;let l=r.tool_call_id;!n.has(l)||s.has(l)||(s.add(l),o.emitToolResult({toolCallId:l,toolName:r.name,output:le(r.content),preview:`Tool "${(a=r.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){if(!e){await o.typing.stop();return}await o.reply(e)}async function ge(e,o,t){var i;let n=await O(e.tools,o),s=y(o.history,void 0,n),a=[];e.needsApproval&&a.push(k(e.needsApproval)),e.middleware&&a.push(...e.middleware);let r=pe({model:e.model,tools:(i=e.tools)!=null?i:[],...e.system?{prompt:e.system}:{},...a.length>0?{middleware:a}:{}}),l;try{l=await r.invoke({messages:s})}catch(p){let u=H(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)}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,s=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)},r={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:r,userOnToolApproval:s}}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,11 +1,11 @@
-import { S as ServeHandlerOptions } from '../index-CWldA6G5.js';
-export { C as Client, N as NovuRequestHandler, a as agent, w as workflow } from '../index-CWldA6G5.js';
-export { C as ClientOptions, a as CronExpression, E as ExecuteInput, S as SeverityLevelEnum, W as Workflow } from '../health-check.types-BNocZ4Wk.js';
-export { C as ContextResolved, E as EnvironmentSystemVariables, S as Subscriber, p as providerSchemas } from '../subscriber.types-CmybpXhA.js';
+import { S as ServeHandlerOptions } from '../index-CYtGHJJu.js';
+export { C as Client, N as NovuRequestHandler, a as agent, i as isFromWorkflow, w as workflow } from '../index-CYtGHJJu.js';
+export { C as ClientOptions, a as CronExpression, E as ExecuteInput, S as SeverityLevelEnum, W as Workflow } from '../health-check.types-CL5-B_D4.js';
+export { C as ContextResolved, E as EnvironmentSystemVariables, S as Subscriber, p as providerSchemas } from '../subscriber.types-D4PvRIKR.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 AgentConversation, f as AgentDeliveryError, g as AgentError, h as AgentHandlerContext, i as AgentHandlers, j as AgentHistoryEntry, k as AgentMessage, l as AgentMessageAuthor, m as AgentMessageContext, n as AgentPlatformContext, o as AgentReaction, p as AgentReactionContext, q as AgentResolveContext, r as AgentSubscriber, s as AgentToolCall, F as FileRef, M as MessageContent, R as ReplyHandle, T as ToolApprovalCard, t as ToolApprovalConfig, u as ToolApprovalDecision, v as toAgentError } from '../agent.types-E3sxq6xr.js';
-export { AnyStepResolver, ChatStepResolver, EmailStepResolver, InAppStepResolver, PushStepResolver, SmsStepResolver, StepResolverContext, step } from '../step-resolver.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 AgentMessage, n as AgentMessageAuthor, o as AgentMessageContext, p as AgentNotification, q as AgentPlatformContext, r as AgentReaction, s as AgentReactionContext, t as AgentResolveContext, u as AgentSubscriber, v as AgentSubscriberAccess, w as AgentToolCall, F as FileRef, M as MessageContent, R as ReplyHandle, T as ToolApprovalCard, x as ToolApprovalConfig, y as ToolApprovalDecision, z as toAgentError } from '../agent.types-C17NUGxY.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';
 import 'json-schema-to-ts';

package/dist/esm/servers/express.js

@@ -1 +1 @@
-import{b as x,c as a,d as V,e as O}from"../chunk-WDBIT4NK.js";import{a as $}from"../chunk-2M25EATE.js";import"../chunk-22DBAEUX.js";import{M as A,N,O as R,V as k}from"../chunk-LHU5A7DI.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-46AHJTS7.js";import"../chunk-XEHQJMMQ.js";import{a as b}from"../chunk-CANJPWLT.js";import{f as S}from"../chunk-FRWG7YTE.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-WJUYDVXH.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-Q3ALQWIF.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-UXO4RWZV.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};