@novu/framework 2.11.1 → 2.11.2-alpha.0

package/dist/esm/ai-sdk/index.d.ts

@@ -0,0 +1,39 @@
+import { g as AgentHandlers, i as AgentMessage, k as AgentMessageContext, M as MessageContent, s as ToolApprovalDecision, b as AgentActionContext, R as ReplyHandle, A as Agent, h as AgentHistoryEntry } from '../agent.types-Bu3DhlVb.js';
+import { streamText, generateText, ModelMessage } from 'ai';
+import { A as Awaitable } from '../util.types-DaFfsxgy.js';
+import 'chat';
+
+type AiSdkStreamResult = Awaited<ReturnType<typeof streamText>>;
+type AiSdkGenerateResult = Awaited<ReturnType<typeof generateText>>;
+type AiSdkResult = AiSdkStreamResult | AiSdkGenerateResult;
+/**
+ * Handlers for `@novu/framework/ai-sdk` agents.
+ *
+ * Extends {@link AgentHandlers}: same events and config (`toolApproval`, etc.),
+ * but `onMessage` and `onToolApproval` may return an AI SDK result for automatic delivery.
+ */
+type AiSdkAgentHandlers = Omit<AgentHandlers, 'onMessage' | 'onToolApproval'> & {
+    onMessage: (message: AgentMessage, ctx: AgentMessageContext) => Awaitable<MessageContent | AiSdkResult | void>;
+    /**
+     * Optional. Auto-resumes `onMessage` after approve/deny unless you return an
+     * `AiSdkResult` to drive the resume yourself.
+     */
+    onToolApproval?: (decision: ToolApprovalDecision, ctx: AgentActionContext) => Awaitable<MessageContent | AiSdkResult | ReplyHandle | void>;
+};
+
+type AiSdkMessageHandler = AiSdkAgentHandlers['onMessage'];
+declare function agent(id: string, handlers: AiSdkMessageHandler | AiSdkAgentHandlers): Agent;
+
+/**
+ * Convert `ctx.history` into AI SDK `ModelMessage[]` for `streamText` / `generateText`.
+ *
+ * History already includes the current incoming message — do not append the handler's
+ * `message` argument on top of it.
+ *
+ * Pass the system prompt via the top-level `instructions` option of `streamText` /
+ * `generateText`. AI SDK 7 rejects `system` messages inside the `messages` array by default,
+ * so this helper never injects one.
+ */
+declare function toModelMessages(history: AgentHistoryEntry[]): ModelMessage[];
+
+export { type AiSdkAgentHandlers, agent, toModelMessages };

package/dist/esm/ai-sdk/index.js

@@ -0,0 +1 @@
+import{b as d,c as m,f as y}from"../chunk-W6DIBD4Z.js";import"../chunk-FHYMHX3T.js";function x(e){return e.role==="tool"&&Array.isArray(e.content)}function H(e){return typeof e=="object"&&e!==null&&e.type==="tool-result"}function _(e){return typeof e=="object"&&e!==null&&"type"in e&&e.type==="execution-denied"}function q(e){if(e&&typeof e=="object"&&"type"in e&&"value"in e){let t=e;if(t.type==="json"||t.type==="text")return t.value}return e}async function N(e){var o;return((o=await Promise.resolve(e.responseMessages))!=null?o:[]).filter(x).flatMap(n=>n.content).filter(H).filter(n=>!_(n.output)).map(n=>({toolCallId:n.toolCallId,toolName:n.toolName,output:q(n.output)}))}function O(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}async function R(e,t){var s;let o=await N(e);if(o.length===0)return;let n=O(t);for(let r of o)n.has(r.toolCallId)&&t.emitToolResult({toolCallId:r.toolCallId,toolName:r.toolName,output:r.output,preview:`Tool "${(s=r.toolName)!=null?s:r.toolCallId}" result`})}function g(e){return typeof e=="object"&&e!==null&&typeof e.consumeStream=="function"}function h(e){return typeof e=="object"&&e!==null&&"text"in e&&"steps"in e&&"usage"in e&&!g(e)}function c(e){return typeof e!="object"||e===null||m(e)?!1:g(e)||h(e)}function b(e){var o;if(typeof e!="object"||e===null||e.type!=="tool-approval-request")return!1;let t=e;return!t.isAutomatic&&typeof((o=t.toolCall)==null?void 0:o.toolCallId)=="string"}async function D(e){let t=await Promise.resolve(e.content);return Array.isArray(t)?t.filter(b):[]}async function f(e,t,o){g(e)&&await e.consumeStream(),await R(e,t);let n=await D(e);if(n.length>0){let s=n[0],r={id:s.toolCall.toolCallId,name:s.toolCall.toolName,input:s.toolCall.input};await y(t,r,o,s.approvalId);return}await L(e,t)}async function L(e,t){let o=(await Promise.resolve(e.text)).trim();if(!o){await t.typing.stop();return}await t.reply(o)}var j={text:"",platformMessageId:"",author:{userId:"",fullName:"",userName:"",isBot:!1},timestamp:""};function Y(e){return typeof e=="object"&&e!==null&&"messageId"in e&&"platformThreadId"in e}function G(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 U(e,t){if(!e)throw new Error("agent() requires a non-empty agentId");let o=G(e,t),n=o.toolApproval,s=typeof o.onToolApproval=="function",r=async l=>{let i=d(l),p=await o.onMessage(j,i.asMessageContext());c(p)&&await f(p,i,n)},a={onMessage:async(l,i)=>{let p=await o.onMessage(l,i);if(c(p)){await f(p,d(i),n);return}return p},onToolApproval:async(l,i)=>{let p=d(i);if(o.onToolApproval){let u=await o.onToolApproval(l,i);if(c(u)){await f(u,p,n);return}u!=null&&!Y(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}};return{id:e,handlers:a,userOnToolApproval:s}}var V="tool_approval_request",$="tool_approval_decision",z="tool_result";function I(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 T(e){let t=e.toolData;if(!(!t||typeof t.approvalId!="string"||typeof t.approved!="boolean"))return{approvalId:t.approvalId,approved:t.approved}}function M(e){let t=e.toolData;if(!(!t||typeof t.toolCallId!="string"))return{toolCallId:t.toolCallId,toolName:t.toolName,output:t.output}}function C(e){let t=new Set,o=new Map,n=new Map,s=new Set;for(let a of e)if(a.type===V){let l=I(a);l&&(n.set(l.approvalId,l.toolCallId),s.add(l.toolCallId))}else if(a.type===$){let l=T(a);l&&!l.approved&&t.add(l.approvalId)}else if(a.type===z){let l=M(a);l&&o.set(l.toolCallId,l)}let r=new Set;for(let a of o.keys())s.has(a)&&r.add(a);return{deniedApprovalIds:t,toolResults:o,approvalIdToToolCallId:n,pairedAtRequest:r}}function Q(e,t){return t.deniedApprovalIds.has(e.approvalId)?"denied":t.toolResults.has(e.toolCallId)?"resolved":"in-flight"}function A(e,t){var n;let o=[{type:"tool-call",toolCallId:e.toolCallId,toolName:e.name,input:(n=e.input)!=null?n:{}}];return t&&o.push({type:"tool-approval-request",approvalId:e.approvalId,toolCallId:e.toolCallId}),{role:"assistant",content:o}}function B(e){return{role:"tool",content:[{type:"tool-result",toolCallId:e,toolName:"tool",output:{type:"execution-denied"}}]}}function S(e){var t;return{role:"tool",content:[{type:"tool-result",toolCallId:e.toolCallId,toolName:(t=e.toolName)!=null?t:"tool",output:{type:"json",value:e.output}}]}}function v(e,t){return[A(e,!1),t]}function w(e,t){let o=I(e);if(!o)return[];let n=Q(o,t);switch(n){case"denied":return v(o,B(o.toolCallId));case"resolved":{let s=t.toolResults.get(o.toolCallId);return s?v(o,S(s)):[A(o,!1)]}case"in-flight":return[A(o,!0)];default:return n}}function k(e,t){let o=T(e);if(!o||!o.approved)return;let n=t.approvalIdToToolCallId.get(o.approvalId);if(!(n&&t.toolResults.has(n)))return{role:"tool",content:[{type:"tool-approval-response",approvalId:o.approvalId,approved:!0}]}}function P(e,t){let o=M(e);if(o&&!t.pairedAtRequest.has(o.toolCallId))return S(o)}var F="message",J="tool_approval_request",K="tool_approval_decision",W="tool_result";function E(e){return e==="agent"||e==="assistant"}function X(e){let t=new Set;for(let o of e)!E(o.role)&&o.role!=="system"&&o.senderName&&t.add(o.senderName);return t.size}function Z(e,t){if(!e.content.trim())return;let o=E(e.role),n=!o&&t&&e.senderName?`${e.senderName}: ${e.content}`:e.content;return{role:o?"assistant":"user",content:n}}function ee(e,t,o){switch(e.type){case F:{let n=Z(e,t);return n?[n]:[]}case J:return w(e,o);case K:{let n=k(e,o);return n?[n]:[]}case W:{let n=P(e,o);return n?[n]:[]}default:return[]}}function te(e){let t=X(e)>1,o=C(e);return e.flatMap(n=>ee(n,t,o))}export{U as agent,te as toModelMessages};

package/dist/esm/cards.d.ts

@@ -0,0 +1,2 @@
+export { Actions, ActionsElement, Button, ButtonElement, Card, CardChild, CardElement, CardLink, CardText, Divider, DividerElement, LinkElement, Select, SelectElement, SelectOption, SelectOptionElement, TextElement, TextInput, TextInputElement } from 'chat';
+import 'chat/jsx-runtime';

package/dist/esm/cards.js

@@ -0,0 +1 @@
+import{a as e,b as t,c as n,d as l,e as i,f as m,g as r,h as o,i as E}from"./chunk-C3P3ZH2I.js";import"./chunk-3XT6S7TZ.js";import"./chunk-FHYMHX3T.js";export{e as Actions,t as Button,n as Card,l as CardLink,i as CardText,m as Divider,r as Select,o as SelectOption,E as TextInput};