@cloudbase/agent-adapter-llm 0.0.22

package/dist/index.d.ts

@@ -0,0 +1,298 @@
+import { AbstractAgent, RunAgentInput, BaseEvent, Message, Tool, EventType } from '@ag-ui/client';
+import { Observable } from 'rxjs';
+import OpenAI from 'openai';
+import Anthropic from '@anthropic-ai/sdk';
+
+/**
+ * LLMAgent - Direct LLM integration with AGUI protocol
+ * Supports OpenAI and Anthropic models with streaming message conversion
+ */
+
+type ModelProvider = OpenAI | Anthropic;
+interface LLMAgentConfig {
+    agentId?: string;
+    name?: string;
+    description?: string;
+    threadId?: string;
+    model: ModelProvider;
+    modelName: string;
+    systemPrompt?: string;
+    temperature?: number;
+    maxTokens?: number;
+    maxToolRounds?: number;
+    onToolCall?: (toolCall: {
+        id: string;
+        name: string;
+        arguments: string;
+    }) => void;
+    onToolResult?: (result: {
+        toolCallId: string;
+        result: any;
+        error?: string;
+    }) => void;
+}
+/**
+ * LLMAgent - Direct model integration with AGUI protocol
+ *
+ * Example:
+ * ```typescript
+ * import OpenAI from 'openai';
+ * import { LLMAgent } from '@cloudbase/agent-adapter-llm';
+ *
+ * const openai = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });
+ * const agent = new LLMAgent({
+ *   agentId: 'my-agent',
+ *   model: openai,
+ *   modelName: 'gpt-4o-mini',
+ *   systemPrompt: 'You are a helpful assistant.'
+ * });
+ * ```
+ */
+declare class LLMAgent extends AbstractAgent {
+    private model;
+    private modelType;
+    private modelName;
+    private systemPrompt?;
+    private temperature?;
+    private maxTokens?;
+    private maxToolRounds;
+    private onToolCall?;
+    private onToolResult?;
+    name: string;
+    constructor(config: LLMAgentConfig);
+    run(input: RunAgentInput): Observable<BaseEvent>;
+    private _run;
+    private runOpenAI;
+    private runAnthropic;
+    /**
+     * Run model once (single round, no tool execution)
+     */
+    private runOnce;
+    /**
+     * Execute tools
+     */
+    private executeTools;
+    /**
+     * Execute tool function
+     */
+    private executeToolFunction;
+    /**
+     * Convert tool results to messages
+     */
+    private toolResultsToMessages;
+    /**
+     * Extract text content from events
+     */
+    private extractTextFromEvents;
+}
+
+/**
+ * OpenAI Converter - AGUI Protocol to OpenAI Format
+ */
+
+/**
+ * Convert AGUI messages to OpenAI chat completion format
+ */
+declare function convertMessagesToOpenAI(messages: Message[], systemPrompt?: string): OpenAI.Chat.ChatCompletionMessageParam[];
+/**
+ * Convert AGUI tools to OpenAI function calling format
+ */
+declare function convertToolsToOpenAI(tools?: Tool[]): OpenAI.Chat.ChatCompletionTool[] | undefined;
+/**
+ * Create OpenAI streaming request options
+ */
+declare function createOpenAIStreamOptions(config: {
+    modelName: string;
+    messages: OpenAI.Chat.ChatCompletionMessageParam[];
+    tools?: OpenAI.Chat.ChatCompletionTool[];
+    temperature?: number;
+    maxTokens?: number;
+    user?: string;
+}): OpenAI.Chat.ChatCompletionCreateParamsStreaming;
+
+/**
+ * Anthropic Converter - AGUI Protocol to Anthropic Format
+ */
+
+/**
+ * Convert AGUI messages to Anthropic message format
+ */
+declare function convertMessagesToAnthropic(messages: Message[]): Anthropic.MessageParam[];
+/**
+ * Convert AGUI tools to Anthropic tools format
+ */
+declare function convertToolsToAnthropic(tools?: Tool[]): Anthropic.Tool[] | undefined;
+/**
+ * Create Anthropic streaming request options
+ */
+declare function createAnthropicStreamOptions(config: {
+    modelName: string;
+    messages: Anthropic.MessageParam[];
+    tools?: Anthropic.Tool[];
+    systemPrompt?: string;
+    temperature?: number;
+    maxTokens?: number;
+}): Anthropic.MessageCreateParamsStreaming;
+
+/**
+ * OpenAI Stream Processor - Convert OpenAI streaming responses to AGUI events
+ */
+
+interface StreamContext$1 {
+    threadId: string;
+    runId: string;
+    messageId: string;
+}
+/**
+ * Process OpenAI streaming chunk and emit AGUI events
+ */
+declare function processOpenAIStream(stream: AsyncIterable<OpenAI.Chat.Completions.ChatCompletionChunk>, context: StreamContext$1): AsyncGenerator<{
+    type: EventType;
+    threadId: string;
+    runId: string;
+    toolCallId: any;
+    content?: undefined;
+    messageId?: undefined;
+    role?: undefined;
+    delta?: undefined;
+    toolCallName?: undefined;
+} | {
+    type: EventType;
+    threadId: string;
+    runId: string;
+    toolCallId: any;
+    content: string;
+    messageId?: undefined;
+    role?: undefined;
+    delta?: undefined;
+    toolCallName?: undefined;
+} | {
+    type: EventType;
+    threadId: string;
+    runId: string;
+    messageId: string;
+    toolCallId?: undefined;
+    content?: undefined;
+    role?: undefined;
+    delta?: undefined;
+    toolCallName?: undefined;
+} | {
+    type: EventType;
+    threadId: string;
+    runId: string;
+    messageId: string;
+    role: string;
+    toolCallId?: undefined;
+    content?: undefined;
+    delta?: undefined;
+    toolCallName?: undefined;
+} | {
+    type: EventType;
+    threadId: string;
+    runId: string;
+    messageId: string;
+    delta: string;
+    toolCallId?: undefined;
+    content?: undefined;
+    role?: undefined;
+    toolCallName?: undefined;
+} | {
+    type: EventType;
+    threadId: string;
+    runId: string;
+    toolCallId: string;
+    toolCallName: string;
+    content?: undefined;
+    messageId?: undefined;
+    role?: undefined;
+    delta?: undefined;
+} | {
+    type: EventType;
+    threadId: string;
+    runId: string;
+    toolCallId: string;
+    delta: string;
+    content?: undefined;
+    messageId?: undefined;
+    role?: undefined;
+    toolCallName?: undefined;
+}, void, unknown>;
+
+/**
+ * Anthropic Stream Processor - Convert Anthropic streaming responses to AGUI events
+ */
+
+interface StreamContext {
+    threadId: string;
+    runId: string;
+    messageId: string;
+}
+/**
+ * Process Anthropic streaming events and emit AGUI events
+ */
+declare function processAnthropicStream(stream: AsyncIterable<Anthropic.MessageStreamEvent>, context: StreamContext): AsyncGenerator<{
+    type: EventType;
+    threadId: string;
+    runId: string;
+    messageId: string;
+    role: string;
+    toolCallId?: undefined;
+    toolCallName?: undefined;
+    delta?: undefined;
+} | {
+    type: EventType;
+    threadId: string;
+    runId: string;
+    toolCallId: string;
+    toolCallName: string;
+    messageId?: undefined;
+    role?: undefined;
+    delta?: undefined;
+} | {
+    type: EventType;
+    threadId: string;
+    runId: string;
+    messageId: string;
+    delta: string;
+    role?: undefined;
+    toolCallId?: undefined;
+    toolCallName?: undefined;
+} | {
+    type: EventType;
+    threadId: string;
+    runId: string;
+    toolCallId: string;
+    delta: string;
+    messageId?: undefined;
+    role?: undefined;
+    toolCallName?: undefined;
+} | {
+    type: EventType;
+    threadId: string;
+    runId: string;
+    toolCallId: string;
+    messageId?: undefined;
+    role?: undefined;
+    toolCallName?: undefined;
+    delta?: undefined;
+} | {
+    type: EventType;
+    threadId: string;
+    runId: string;
+    messageId: string;
+    role?: undefined;
+    toolCallId?: undefined;
+    toolCallName?: undefined;
+    delta?: undefined;
+} | {
+    type: EventType;
+    threadId: string;
+    runId: string;
+    messageId?: undefined;
+    role?: undefined;
+    toolCallId?: undefined;
+    toolCallName?: undefined;
+    delta?: undefined;
+}, void, unknown>;
+
+export { LLMAgent, type LLMAgentConfig, type ModelProvider, convertMessagesToAnthropic, convertMessagesToOpenAI, convertToolsToAnthropic, convertToolsToOpenAI, createAnthropicStreamOptions, createOpenAIStreamOptions, processAnthropicStream, processOpenAIStream };