@librechat/agents-types 1.9.94 → 1.9.96

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@librechat/agents-types",
-  "version": "1.9.94",
+  "version": "1.9.96",
   "description": "Type definitions for @librechat/agents",
   "types": "index.d.ts",
   "scripts": {

package/stream.ts

@@ -1,8 +1,9 @@
 // src/types/stream.ts
+import type OpenAITypes from 'openai';
 import type { MessageContentImageUrl, MessageContentText, ToolMessage, BaseMessage } from '@langchain/core/messages';
 import type { ToolCall, ToolCallChunk } from '@langchain/core/messages/tool';
 import type { LLMResult, Generation } from '@langchain/core/outputs';
-import { StepTypes, ContentTypes } from '@/common/enum';
+import { StepTypes, ContentTypes, GraphEvents } from '@/common/enum';
 
 export type HandleLLMEnd = (output: LLMResult, runId: string, parentRunId?: string, tags?: string[]) => void;
 
@@ -54,7 +55,7 @@ export type RunStep = {
   index: number; // #new
   stepIndex?: number; // #new
   stepDetails: StepDetails;
-  usage: null | {
+  usage?: null | {
     // Define usage structure if it's ever non-null
     // prompt_tokens: number; // #new
     // completion_tokens: number; // #new
@@ -178,13 +179,40 @@ export interface MessageDelta {
   tool_call_ids?: string[];
 }
 
+/**
+ * Represents a reasoning delta i.e. any changed fields on a message during
+ * streaming.
+ */
+export interface ReasoningDeltaEvent {
+  /**
+   * The identifier of the message, which can be referenced in API endpoints.
+   */
+  id: string;
+
+  /**
+   * The delta containing the fields that have changed.
+   */
+  delta: ReasoningDelta;
+}
+
+/**
+ * The reasoning delta containing the fields that have changed on the Message.
+ */
+export interface ReasoningDelta {
+  /**
+   * The content of the message in array of text and/or images.
+   */
+  content?: MessageContentComplex[];
+}
+
 export type MessageDeltaUpdate = { type: ContentTypes.TEXT; text: string; tool_call_ids?: string[] };
+export type ReasoningDeltaUpdate = { type: ContentTypes.THINK; think: string; };
 
-export type ContentType = 'text' | 'image_url' | 'tool_call' | string;
+export type ContentType = 'text' | 'image_url' | 'tool_call' | 'think' | string;
 
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 export type MessageContentComplex = (MessageContentText | MessageContentImageUrl | (Record<string, any> & {
-  type?: 'text' | 'image_url' | string;
+  type?: 'text' | 'image_url' | 'think' | string;
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 }) | (Record<string, any> & {
   type?: never;
@@ -192,3 +220,18 @@ export type MessageContentComplex = (MessageContentText | MessageContentImageUrl
   tool_call_ids?: string[];
 };
 // #new
+
+export type CustomChunk = Partial<OpenAITypes.ChatCompletionChunk> & {
+  choices?: Partial<Array<Partial<OpenAITypes.Chat.Completions.ChatCompletionChunk.Choice> & {
+    delta?: Partial<OpenAITypes.Chat.Completions.ChatCompletionChunk.Choice.Delta> & {
+      reasoning?: string | null;
+      reasoning_content?: string | null;
+    };
+  }>>;
+}
+
+export type SplitStreamHandlers = Partial<{
+  [GraphEvents.ON_RUN_STEP]: ({ event, data}: { event: GraphEvents, data: RunStep }) => void;
+  [GraphEvents.ON_MESSAGE_DELTA]: ({ event, data}: { event: GraphEvents, data: MessageDeltaEvent }) => void;
+  [GraphEvents.ON_REASONING_DELTA]: ({ event, data}: { event: GraphEvents, data: ReasoningDeltaEvent }) => void;
+}>