@novu/framework 2.13.1-rc.852194fa77 → 2.13.2-rc.dc9caee828

package/dist/cjs/internal/index.d.cts

@@ -1,10 +1,10 @@
-import { P as PostActionEnum } from '../health-check.types-B6RuXNc8.cjs';
-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-B6RuXNc8.cjs';
-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-_eHz1E0m.cjs';
+import { P as PostActionEnum } from '../health-check.types-C2XZ-Tpt.cjs';
+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-C2XZ-Tpt.cjs';
+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-BanvmGul.cjs';
 import { Filter, LiquidOptions, Liquid } from 'liquidjs';
 import { Emoji } from 'chat';
-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-CQKSD7NC.cjs';
-export { V as AgentReplyPayload, X as EditPayload, Y as MetadataSignal, Z as ParsedApprovalAction, _ as TriggerSignal, $ as buildApprovalActionId, a0 as parseApprovalActionId } from '../agent.types-CQKSD7NC.cjs';
+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-crcJBtCy.cjs';
+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-crcJBtCy.cjs';
 export { a as FromSchema, F as FromSchemaUnvalidated, J as JsonSchema, S as Schema, Z as ZodSchema, b as ZodSchemaMinimal } from '../base.schema.types-BApIn9jr.cjs';
 export { S as SupportedFrameworkName } from '../server.types-Cc6o5eYH.cjs';
 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.cjs';
@@ -137,14 +137,115 @@ declare enum ResourceEnum {
     STEP = "step"
 }
 
-declare const RUNTIME_CONTEXT_BRAND: unique symbol;
-interface AgentRuntimeContext extends AgentHandlerContext {
-    readonly [RUNTIME_CONTEXT_BRAND]: true;
-    emitToolResult(result: ToolResult): void;
-    emitToolApprovalRequest(request: ToolApprovalRequestPayload): void;
-    replyApprovalCard(card: ToolApprovalCard): Promise<ReplyHandle>;
-    asMessageContext(): AgentMessageContext;
-}
+/**
+ * Novu-owned card JSON on the agent wire.
+ *
+ * Matches the full Chat SDK kit agents emit (`section` / `fields` / `table` /
+ * `button` / `select` / `radio_select`) plus Novu fields on buttons
+ * (`actionType`, `callbackUrl`, `disabled`). Chat SDK stays the authoring
+ * frontend (`@novu/framework`); this type is the contract `@novu/js` and the
+ * event protocol share. The dashboard Maily editor still authors the smaller
+ * `@novu/shared` v1 subset (link-buttons only).
+ *
+ * Compatibility locks in `packages/framework/src/resources/agent/card-element-compat.test-d.ts`:
+ * `chat.CardElement` and `@novu/stateless` `CardElement` must assign to this type.
+ * Do not add `chat` or `@novu/stateless` as a dependency here.
+ */
+type CardElementTextElement = {
+    type: 'text';
+    content: string;
+    style?: 'plain' | 'bold' | 'muted';
+};
+type CardElementImageElement = {
+    type: 'image';
+    url: string;
+    alt?: string;
+};
+type CardElementDividerElement = {
+    type: 'divider';
+};
+/** Presentational inline hyperlink (Chat SDK `CardLink`). */
+type CardElementLinkElement = {
+    type: 'link';
+    label: string;
+    url: string;
+};
+type CardElementLinkButtonElement = {
+    type: 'link-button';
+    label: string;
+    url: string;
+    style?: 'primary' | 'danger' | 'default';
+    /** Optional author-provided id; platform serializers use it (e.g. Slack `action_id`). */
+    id?: string;
+};
+/** Interactive action button (Chat SDK `Button`). Drives `sendAction` in web chat. */
+type CardElementButtonElement = {
+    type: 'button';
+    id: string;
+    label: string;
+    style?: 'primary' | 'danger' | 'default';
+    actionType?: 'action' | 'modal';
+    callbackUrl?: string;
+    value?: string;
+    disabled?: boolean;
+};
+type CardElementSelectOptionElement = {
+    label: string;
+    value: string;
+    description?: string;
+};
+/** Chat SDK `Select`. */
+type CardElementSelectElement = {
+    type: 'select';
+    id: string;
+    label: string;
+    options: CardElementSelectOptionElement[];
+    initialOption?: string;
+    optional?: boolean;
+    placeholder?: string;
+};
+/** Chat SDK `RadioSelect`. */
+type CardElementRadioSelectElement = {
+    type: 'radio_select';
+    id: string;
+    label: string;
+    options: CardElementSelectOptionElement[];
+    initialOption?: string;
+    optional?: boolean;
+};
+type CardElementActionChild = CardElementLinkButtonElement | CardElementButtonElement | CardElementSelectElement | CardElementRadioSelectElement;
+type CardElementActionsElement = {
+    type: 'actions';
+    children: CardElementActionChild[];
+};
+type CardElementFieldElement = {
+    type: 'field';
+    label: string;
+    value: string;
+};
+type CardElementFieldsElement = {
+    type: 'fields';
+    children: CardElementFieldElement[];
+};
+type CardElementTableElement = {
+    type: 'table';
+    headers: string[];
+    rows: string[][];
+    align?: Array<'left' | 'center' | 'right'>;
+};
+type CardElementSectionElement = {
+    type: 'section';
+    children: CardElementChild[];
+};
+/** Includes top-level `button` — agents emit that shape, not only `actions` wrappers. */
+type CardElementChild = CardElementTextElement | CardElementImageElement | CardElementDividerElement | CardElementLinkElement | CardElementButtonElement | CardElementActionsElement | CardElementSectionElement | CardElementFieldsElement | CardElementTableElement;
+type CardElement = {
+    type: 'card';
+    title?: string;
+    subtitle?: string;
+    imageUrl?: string;
+    children: CardElementChild[];
+};
 
 type AgentMessageRole = 'user' | 'assistant';
 type AgentToolSource = {
@@ -179,7 +280,7 @@ type AgentToolResultContent = {
 type AgentMessageContent = {
     markdown: string;
 } | {
-    card: Record<string, unknown>;
+    card: CardElement;
 };
 interface AgentFileRef {
     fileId: string;
@@ -233,6 +334,15 @@ type AgentSignal = {
     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';
@@ -673,6 +783,15 @@ type FilterValidators = {
 };
 declare const FILTER_VALIDATORS: FilterValidators;
 
+declare const RUNTIME_CONTEXT_BRAND: unique symbol;
+interface AgentRuntimeContext extends AgentHandlerContext {
+    readonly [RUNTIME_CONTEXT_BRAND]: true;
+    emitToolResult(result: ToolResult): void;
+    emitToolApprovalRequest(request: ToolApprovalRequestPayload): void;
+    replyApprovalCard(card: ToolApprovalCard): Promise<ReplyHandle>;
+    asMessageContext(): AgentMessageContext;
+}
+
 /** Pending side effects queued between replies, drained atomically before each turn action. */
 interface SideEffectsSnapshot {
     toolApprovalRequest: ToolApprovalRequestPayload | null;
@@ -731,6 +850,7 @@ declare class AgentContextImpl implements AgentRuntimeContext {
     readonly history: AgentHistoryEntry[];
     readonly platform: string;
     readonly platformContext: AgentPlatformContext;
+    readonly humanResponse: AgentHumanResponse | null;
     readonly typing: TypingControl;
     readonly toolApproval: ToolApprovalControl;
     readonly metadata: {
@@ -766,6 +886,11 @@ declare class AgentContextImpl implements AgentRuntimeContext {
         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. */

package/dist/cjs/langchain/index.d.cts

@@ -1,5 +1,5 @@
 import { BaseMessage } from '@langchain/core/messages';
-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-CQKSD7NC.cjs';
+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-crcJBtCy.cjs';
 import { LanguageModelLike } from '@langchain/core/language_models/base';
 import { RunnableConfig } from '@langchain/core/runnables';
 import { StructuredToolInterface } from '@langchain/core/tools';