ai-protocol-adapters 1.0.0-alpha.2 → 1.0.0-alpha.4

package/README.md

@@ -1,6 +1,6 @@
-# @ai-protocol/adapters
+# ai-protocol-adapters
 
-[![npm version](https://badge.fury.io/js/@ai-protocol%2Fadapters.svg)](https://badge.fury.io/js/@ai-protocol%2Fadapters)
+[![npm version](https://badge.fury.io/js/ai-protocol-adapters.svg)](https://badge.fury.io/js/ai-protocol-adapters)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)
 
@@ -19,15 +19,15 @@
 ## 📦 安装
 
 ```bash
-npm install @ai-protocol/adapters
+npm install ai-protocol-adapters
 ```
 
 ```bash
-yarn add @ai-protocol/adapters
+yarn add ai-protocol-adapters
 ```
 
 ```bash
-pnpm add @ai-protocol/adapters
+pnpm add ai-protocol-adapters
 ```
 
 ## 🚀 快速开始
@@ -35,7 +35,7 @@ pnpm add @ai-protocol/adapters
 ### 基础使用
 
 ```typescript
-import { StreamingProtocolAdapter } from '@ai-protocol/adapters'
+import { StreamingProtocolAdapter } from 'ai-protocol-adapters'
 
 // 创建适配器实例
 const adapter = new StreamingProtocolAdapter({
@@ -103,7 +103,7 @@ const { openaiRequest } = adapter.convertAnthropicToOpenAI(glmRequest)
 ### 自定义日志器
 
 ```typescript
-import { setGlobalLogger, StreamingProtocolAdapter } from '@ai-protocol/adapters'
+import { setGlobalLogger, StreamingProtocolAdapter } from 'ai-protocol-adapters'
 
 // 使用自定义日志器
 setGlobalLogger({

package/dist/index.d.mts

@@ -2646,9 +2646,9 @@ declare const AnthropicImageSourceSchema: z.ZodObject<{
 declare const AnthropicContentBlockBaseSchema: z.ZodObject<{
     type: z.ZodEnum<["text", "image", "tool_use", "tool_result"]>;
 }, "strip", z.ZodTypeAny, {
-    type?: "text" | "image" | "tool_use" | "tool_result";
+    type?: "text" | "tool_use" | "image" | "tool_result";
 }, {
-    type?: "text" | "image" | "tool_use" | "tool_result";
+    type?: "text" | "tool_use" | "image" | "tool_result";
 }>;
 declare const AnthropicTextContentBlockSchema: z.ZodObject<{} & {
     type: z.ZodLiteral<"text">;
@@ -3784,7 +3784,7 @@ declare const AnthropicResponseSchema: z.ZodObject<{
         cache_read_input_tokens?: number;
     };
     stop_sequence?: string;
-    stop_reason?: "end_turn" | "max_tokens" | "tool_use" | "stop_sequence";
+    stop_reason?: "end_turn" | "tool_use" | "max_tokens" | "stop_sequence";
 }, {
     role?: "assistant";
     content?: ({
@@ -3828,7 +3828,7 @@ declare const AnthropicResponseSchema: z.ZodObject<{
         cache_read_input_tokens?: number;
     };
     stop_sequence?: string;
-    stop_reason?: "end_turn" | "max_tokens" | "tool_use" | "stop_sequence";
+    stop_reason?: "end_turn" | "tool_use" | "max_tokens" | "stop_sequence";
 }>;
 declare const AnthropicStreamEventBaseSchema: z.ZodObject<{
     type: z.ZodString;
@@ -4160,7 +4160,7 @@ declare const AnthropicMessageStartEventSchema: z.ZodObject<{} & {
             cache_read_input_tokens?: number;
         };
         stop_sequence?: string;
-        stop_reason?: "end_turn" | "max_tokens" | "tool_use" | "stop_sequence";
+        stop_reason?: "end_turn" | "tool_use" | "max_tokens" | "stop_sequence";
     }, {
         role?: "assistant";
         content?: ({
@@ -4204,7 +4204,7 @@ declare const AnthropicMessageStartEventSchema: z.ZodObject<{} & {
             cache_read_input_tokens?: number;
         };
         stop_sequence?: string;
-        stop_reason?: "end_turn" | "max_tokens" | "tool_use" | "stop_sequence";
+        stop_reason?: "end_turn" | "tool_use" | "max_tokens" | "stop_sequence";
     }>;
 }, "strip", z.ZodTypeAny, {
     message?: {
@@ -4250,7 +4250,7 @@ declare const AnthropicMessageStartEventSchema: z.ZodObject<{} & {
             cache_read_input_tokens?: number;
         };
         stop_sequence?: string;
-        stop_reason?: "end_turn" | "max_tokens" | "tool_use" | "stop_sequence";
+        stop_reason?: "end_turn" | "tool_use" | "max_tokens" | "stop_sequence";
     };
     type?: "message_start";
 }, {
@@ -4297,7 +4297,7 @@ declare const AnthropicMessageStartEventSchema: z.ZodObject<{} & {
             cache_read_input_tokens?: number;
         };
         stop_sequence?: string;
-        stop_reason?: "end_turn" | "max_tokens" | "tool_use" | "stop_sequence";
+        stop_reason?: "end_turn" | "tool_use" | "max_tokens" | "stop_sequence";
     };
     type?: "message_start";
 }>;
@@ -4560,10 +4560,10 @@ declare const AnthropicMessageDeltaEventSchema: z.ZodObject<{} & {
         stop_sequence: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, "strip", z.ZodTypeAny, {
         stop_sequence?: string;
-        stop_reason?: "end_turn" | "max_tokens" | "tool_use" | "stop_sequence";
+        stop_reason?: "end_turn" | "tool_use" | "max_tokens" | "stop_sequence";
     }, {
         stop_sequence?: string;
-        stop_reason?: "end_turn" | "max_tokens" | "tool_use" | "stop_sequence";
+        stop_reason?: "end_turn" | "tool_use" | "max_tokens" | "stop_sequence";
     }>;
     usage: z.ZodObject<{
         input_tokens: z.ZodOptional<z.ZodNumber>;
@@ -4585,7 +4585,7 @@ declare const AnthropicMessageDeltaEventSchema: z.ZodObject<{} & {
     type?: "message_delta";
     delta?: {
         stop_sequence?: string;
-        stop_reason?: "end_turn" | "max_tokens" | "tool_use" | "stop_sequence";
+        stop_reason?: "end_turn" | "tool_use" | "max_tokens" | "stop_sequence";
     };
     usage?: {
         input_tokens?: number;
@@ -4597,7 +4597,7 @@ declare const AnthropicMessageDeltaEventSchema: z.ZodObject<{} & {
     type?: "message_delta";
     delta?: {
         stop_sequence?: string;
-        stop_reason?: "end_turn" | "max_tokens" | "tool_use" | "stop_sequence";
+        stop_reason?: "end_turn" | "tool_use" | "max_tokens" | "stop_sequence";
     };
     usage?: {
         input_tokens?: number;
@@ -4968,7 +4968,7 @@ declare const AnthropicStreamEventSchema: z.ZodUnion<[z.ZodObject<{} & {
             cache_read_input_tokens?: number;
         };
         stop_sequence?: string;
-        stop_reason?: "end_turn" | "max_tokens" | "tool_use" | "stop_sequence";
+        stop_reason?: "end_turn" | "tool_use" | "max_tokens" | "stop_sequence";
     }, {
         role?: "assistant";
         content?: ({
@@ -5012,7 +5012,7 @@ declare const AnthropicStreamEventSchema: z.ZodUnion<[z.ZodObject<{} & {
             cache_read_input_tokens?: number;
         };
         stop_sequence?: string;
-        stop_reason?: "end_turn" | "max_tokens" | "tool_use" | "stop_sequence";
+        stop_reason?: "end_turn" | "tool_use" | "max_tokens" | "stop_sequence";
     }>;
 }, "strip", z.ZodTypeAny, {
     message?: {
@@ -5058,7 +5058,7 @@ declare const AnthropicStreamEventSchema: z.ZodUnion<[z.ZodObject<{} & {
             cache_read_input_tokens?: number;
         };
         stop_sequence?: string;
-        stop_reason?: "end_turn" | "max_tokens" | "tool_use" | "stop_sequence";
+        stop_reason?: "end_turn" | "tool_use" | "max_tokens" | "stop_sequence";
     };
     type?: "message_start";
 }, {
@@ -5105,7 +5105,7 @@ declare const AnthropicStreamEventSchema: z.ZodUnion<[z.ZodObject<{} & {
             cache_read_input_tokens?: number;
         };
         stop_sequence?: string;
-        stop_reason?: "end_turn" | "max_tokens" | "tool_use" | "stop_sequence";
+        stop_reason?: "end_turn" | "tool_use" | "max_tokens" | "stop_sequence";
     };
     type?: "message_start";
 }>, z.ZodObject<{} & {
@@ -5364,10 +5364,10 @@ declare const AnthropicStreamEventSchema: z.ZodUnion<[z.ZodObject<{} & {
         stop_sequence: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, "strip", z.ZodTypeAny, {
         stop_sequence?: string;
-        stop_reason?: "end_turn" | "max_tokens" | "tool_use" | "stop_sequence";
+        stop_reason?: "end_turn" | "tool_use" | "max_tokens" | "stop_sequence";
     }, {
         stop_sequence?: string;
-        stop_reason?: "end_turn" | "max_tokens" | "tool_use" | "stop_sequence";
+        stop_reason?: "end_turn" | "tool_use" | "max_tokens" | "stop_sequence";
     }>;
     usage: z.ZodObject<{
         input_tokens: z.ZodOptional<z.ZodNumber>;
@@ -5389,7 +5389,7 @@ declare const AnthropicStreamEventSchema: z.ZodUnion<[z.ZodObject<{} & {
     type?: "message_delta";
     delta?: {
         stop_sequence?: string;
-        stop_reason?: "end_turn" | "max_tokens" | "tool_use" | "stop_sequence";
+        stop_reason?: "end_turn" | "tool_use" | "max_tokens" | "stop_sequence";
     };
     usage?: {
         input_tokens?: number;
@@ -5401,7 +5401,7 @@ declare const AnthropicStreamEventSchema: z.ZodUnion<[z.ZodObject<{} & {
     type?: "message_delta";
     delta?: {
         stop_sequence?: string;
-        stop_reason?: "end_turn" | "max_tokens" | "tool_use" | "stop_sequence";
+        stop_reason?: "end_turn" | "tool_use" | "max_tokens" | "stop_sequence";
     };
     usage?: {
         input_tokens?: number;
@@ -5572,7 +5572,7 @@ declare const validateAnthropicResponse: (data: unknown) => {
         cache_read_input_tokens?: number;
     };
     stop_sequence?: string;
-    stop_reason?: "end_turn" | "max_tokens" | "tool_use" | "stop_sequence";
+    stop_reason?: "end_turn" | "tool_use" | "max_tokens" | "stop_sequence";
 };
 declare const validateAnthropicStreamEvent: (data: unknown) => {
     message?: {
@@ -5618,7 +5618,7 @@ declare const validateAnthropicStreamEvent: (data: unknown) => {
             cache_read_input_tokens?: number;
         };
         stop_sequence?: string;
-        stop_reason?: "end_turn" | "max_tokens" | "tool_use" | "stop_sequence";
+        stop_reason?: "end_turn" | "tool_use" | "max_tokens" | "stop_sequence";
     };
     type?: "message_start";
 } | {
@@ -5672,7 +5672,7 @@ declare const validateAnthropicStreamEvent: (data: unknown) => {
     type?: "message_delta";
     delta?: {
         stop_sequence?: string;
-        stop_reason?: "end_turn" | "max_tokens" | "tool_use" | "stop_sequence";
+        stop_reason?: "end_turn" | "tool_use" | "max_tokens" | "stop_sequence";
     };
     usage?: {
         input_tokens?: number;
@@ -6029,6 +6029,89 @@ declare class FormatValidator {
     };
 }
 
+/**
+ * 流式处理相关类型定义
+ */
+
+/**
+ * 流式转换配置选项
+ */
+interface StreamConversionOptions {
+    /** 模型名称 */
+    modelName?: string;
+    /** 消息ID */
+    messageId?: string;
+    /** 缓冲区超时时间（毫秒） */
+    bufferTimeout?: number;
+    /** 是否启用错误恢复 */
+    errorRecovery?: boolean;
+    /** 最大重试次数 */
+    maxRetries?: number;
+    /** 块处理回调 */
+    onChunkProcessed?: (chunk: string, events: string[]) => void;
+    /** 错误回调 */
+    onError?: (error: Error, context: StreamErrorContext) => void;
+    /** 调试模式 */
+    debug?: boolean;
+}
+/**
+ * 流式错误上下文
+ */
+interface StreamErrorContext {
+    chunk: string;
+    state: IncrementalConversionState;
+    attempt?: number;
+    totalRetries?: number;
+}
+/**
+ * 流式转换器接口
+ */
+interface IStreamConverter {
+    /**
+     * 获取初始事件
+     */
+    getInitialEvents(): string[];
+    /**
+     * 处理单个数据块
+     */
+    processChunk(chunk: string): string[];
+    /**
+     * 结束流处理
+     */
+    finalize(): string[];
+    /**
+     * 获取当前状态
+     */
+    getState(): IncrementalConversionState;
+    /**
+     * 重置状态
+     */
+    reset(): void;
+    /**
+     * 获取统计信息
+     */
+    getStats(): StreamStats;
+}
+/**
+ * 流式处理统计信息
+ */
+interface StreamStats {
+    /** 处理的块数量 */
+    chunksProcessed: number;
+    /** 生成的事件数量 */
+    eventsGenerated: number;
+    /** 错误数量 */
+    errors: number;
+    /** 重试次数 */
+    retries: number;
+    /** 处理开始时间 */
+    startTime: number;
+    /** 最后更新时间 */
+    lastUpdateTime: number;
+    /** 缓冲区大小 */
+    bufferSize: number;
+}
+
 /**
  * O2A SSE适配器配置
  */
@@ -6103,6 +6186,20 @@ declare class O2ASSEAdapter {
         errors: string[];
         warnings: string[];
     };
+    /**
+     * 将 OpenAI Response 流直接转换为 Anthropic SSE 流
+     * 这是新增的核心流式处理方法，支持实时转换
+     */
+    convertResponseStream(openaiResponse: Response, options?: StreamConversionOptions): ReadableStream<string>;
+    /**
+     * 将 ReadableStream 转换为 Anthropic SSE 流
+     */
+    convertReadableStream(openaiStream: ReadableStream<Uint8Array>, options?: StreamConversionOptions): ReadableStream<string>;
+    /**
+     * 创建流式转换器实例
+     * 提供更精细的流处理控制
+     */
+    createStreamConverter(options?: StreamConversionOptions): IStreamConverter;
     /**
      * 应用增强功能到SSE转换
      * 包括输入验证、输出修复等
@@ -6135,6 +6232,21 @@ declare const O2ASSEAdapterStatic: {
         errors: string[];
         warnings: string[];
     };
+    /**
+     * 转换 Response 流为 Anthropic SSE（静态方法）
+     * 新增：直接处理 Response 对象的流式转换
+     */
+    convertResponseStream: (openaiResponse: Response, options?: StreamConversionOptions) => ReadableStream<string>;
+    /**
+     * 转换 ReadableStream 为 Anthropic SSE（静态方法）
+     * 新增：处理任意 ReadableStream<Uint8Array> 的流式转换
+     */
+    convertReadableStream: (openaiStream: ReadableStream<Uint8Array>, options?: StreamConversionOptions) => ReadableStream<string>;
+    /**
+     * 创建流式转换器（静态方法）
+     * 新增：提供更精细的流处理控制
+     */
+    createStreamConverter: (options?: StreamConversionOptions) => IStreamConverter;
 };
 
 /**
@@ -6363,7 +6475,7 @@ declare const validateO2AConversion: (openaiData: unknown, convertedData: unknow
         cache_read_input_tokens?: number;
     };
     stop_sequence?: string;
-    stop_reason?: "end_turn" | "max_tokens" | "tool_use" | "stop_sequence";
+    stop_reason?: "end_turn" | "tool_use" | "max_tokens" | "stop_sequence";
 }>;
 declare const validateStreamConversion: (inputChunks: unknown[], outputEvents: unknown[], direction: "openai-to-anthropic" | "anthropic-to-openai", useHealing?: boolean) => ConversionResult<unknown[]>;
 
@@ -6624,7 +6736,7 @@ declare const healO2AResponse: (data: unknown, maxAttempts?: number) => Promise<
         cache_read_input_tokens?: number;
     };
     stop_sequence?: string;
-    stop_reason?: "end_turn" | "max_tokens" | "tool_use" | "stop_sequence";
+    stop_reason?: "end_turn" | "tool_use" | "max_tokens" | "stop_sequence";
 }>>;
 
 /**
@@ -7155,7 +7267,7 @@ interface Logger {
 declare function getGlobalLogger(): Logger;
 
 /**
- * @ai-protocol/adapters - Universal AI Protocol Converter
+ * ai-protocol-adapters - Universal AI Protocol Converter
  * OpenAI ⇄ Anthropic with full TypeScript support
  */