@novu/framework 2.11.0 → 2.11.2-alpha.0

package/dist/cjs/ai-sdk/index.d.cts

@@ -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-DdgaVUb7.cjs';
+import { streamText, generateText, ModelMessage } from 'ai';
+import { A as Awaitable } from '../util.types-DaFfsxgy.cjs';
+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 };