ai-protocol-adapters 1.0.0-alpha.16 → 1.0.0-alpha.18

package/dist/index.d.mts

@@ -5606,6 +5606,11 @@ interface A2ORequestAdapterConfig {
         logLevel: 'none' | 'error' | 'warn' | 'info' | 'debug';
         enableMetrics: boolean;
     };
+    imageProxy: {
+        enabled: boolean;
+        timeout: number;
+        maxSize: number;
+    };
 }
 
 /**
@@ -5626,9 +5631,9 @@ declare class A2ORequestAdapter {
      */
     convertAnthropicRequestToOpenAIEnhanced(anthropicRequest: unknown): Promise<ConversionResult$2<OpenAIRequest>>;
     /**
-     * 执行核心转换逻辑（原有逻辑保持不变）
+     * 执行核心转换逻辑（支持图片代理）
      */
-    private performCoreConversion;
+    performCoreConversion(anthropicRequest: ClaudeRequest): Promise<any>;
     /**
      * 转换Anthropic请求格式为OpenAI兼容格式 - 原有方法保持兼容
      */
@@ -5723,8 +5728,35 @@ declare const A2ORequestAdapterStatic: {
      * 获取工具映射（静态方法，已弃用）
      */
     getToolMapping: (claudeToolName: string) => string | undefined;
+    /**
+     * 转换Anthropic请求格式为OpenAI兼容格式（异步版本，支持图片URL自动下载）
+     * 解决GitHub Copilot等API不支持外部图片URL的问题
+     * @param anthropicRequest Claude格式的请求
+     * @param downloadImageUrls 是否下载图片URL并转换为base64（默认true）
+     */
+    convertAnthropicRequestToOpenAIAsync: (anthropicRequest: ClaudeRequest, downloadImageUrls?: boolean) => Promise<OpenAIRequest>;
 };
 
+/**
+ * 从URL下载图片并转换为base64 data URI
+ * @param url 图片URL
+ * @param options 下载选项
+ * @returns base64 data URI (例如: "data:image/jpeg;base64,/9j/4AAQ...")
+ */
+declare function downloadImageAsBase64(url: string, options?: {
+    timeout?: number;
+    maxSize?: number;
+    userAgent?: string;
+}): Promise<string>;
+/**
+ * 判断URL是否是外部URL（http/https开头）
+ */
+declare function isExternalUrl(url: string): boolean;
+/**
+ * 判断URL是否已经是base64 data URI
+ */
+declare function isBase64DataUri(url: string): boolean;
+
 /**
  * A2O格式验证器
  * 专门处理Claude和OpenAI请求格式的验证
@@ -7333,4 +7365,4 @@ declare const FEATURES: {
     readonly externalPackageVerified: true;
 };
 
-export { A2ORequestAdapter, A2ORequestAdapterStatic, ADAPTERS_VERSION, type AnthropicContentBlock, AnthropicContentBlockBaseSchema, AnthropicContentBlockDeltaEventSchema, AnthropicContentBlockSchema, AnthropicContentBlockStartEventSchema, AnthropicContentBlockStopEventSchema, AnthropicErrorEventSchema, type AnthropicImageContentBlock, AnthropicImageContentBlockSchema, AnthropicImageSourceSchema, type AnthropicMessage, AnthropicMessageDeltaEventSchema, AnthropicMessageSchema, AnthropicMessageStartEventSchema, AnthropicMessageStopEventSchema, AnthropicMetadataSchema, AnthropicPingEventSchema, type AnthropicRequest, AnthropicRequestSchema, type AnthropicResponse, AnthropicResponseSchema, type AnthropicSDKConfig, AnthropicSDKWrapper, type AnthropicStreamEvent, AnthropicStreamEventBaseSchema, AnthropicStreamEventSchema, AnthropicSystemMessageSchema, type AnthropicTextContentBlock, AnthropicTextContentBlockSchema, type AnthropicTool, AnthropicToolInputSchemaSchema, type AnthropicToolResultContentBlock, AnthropicToolResultContentBlockSchema, AnthropicToolSchema, type AnthropicToolUseContentBlock, AnthropicToolUseContentBlockSchema, type AnthropicUsage, AnthropicUsageSchema, type BaseSDKClient, A2ORequestAdapter as ClaudeToOpenAIConverter, type ConversionFixResult, ConversionFixer, type ConversionResult$1 as ConversionResult, type ConversionState, ConversionValidator, type ConvertedRequest, type ConvertedResponse, EMERGENCY_HEALING_STRATEGIES, type EnhancedAdapterOptions, type EnhancedConversionResult, ErrorDetector, type ErrorInfo, ErrorRecovery, type ErrorSeverity, type ErrorType, FEATURES, FormatValidator, type HealingContext, type HealingResult, type HealingRule, StandardProtocolAdapter as NonStreamingIOConverter, O2ASSEAdapter, O2ASSEAdapterStatic, type OpenAIChoice, OpenAIChoiceSchema, OpenAIFunctionParametersSchema, OpenAIFunctionSchema, type OpenAIMessage, OpenAIMessageContentSchema, OpenAIMessageSchema, type OpenAIRequest$1 as OpenAIRequest, OpenAIRequestSchema, type OpenAIResponse$1 as OpenAIResponse, OpenAIResponseSchema, type OpenAISDKConfig, OpenAISDKWrapper, type OpenAIStreamChunk, OpenAIStreamChunkSchema, O2ASSEAdapter as OpenAIToClaudeSSEConverter, type OpenAITool, type OpenAIToolCall, OpenAIToolCallSchema, OpenAIToolSchema, type OpenAIUsage, OpenAIUsageSchema, ProtocolHealer, RECOVERY_STRATEGIES, REQUEST_HEALING_STRATEGIES, RESPONSE_HEALING_STRATEGIES, type RecoveryResult, type RecoveryStrategy, type RequestOptions, type SDKConfig, SDKFactory, type SDKProvider, type SDKResponse, type SDKStreamEvent, SSEEventGenerator, STREAM_HEALING_STRATEGIES, type ConversionResult as SchemaConversionResult, StandardProtocolAdapter as StandardGateway, StandardProtocolAdapter, type StandardProtocolAdapterOptions, StreamingProtocolAdapter as StreamingGateway, StreamingProtocolAdapter as StreamingIOConverter, StreamingProtocolAdapter, type StreamingProtocolAdapterOptions, type UnifiedSDKConfig, type ValidationResult, attemptRecovery, conversionValidator, createAnthropicSDK, createOpenAISDK, createValidator, errorRecovery, getAllHealingStrategies, getGlobalLogger, getRecoveryRecommendations, getStrategiesForContext, healA2ORequest, healO2ARequest, healO2AResponse, healingValidate, isRecoverable, protocolHealer, safeValidate, sdkFactory, selectSDKByModel, strictValidate, validateA2OConversion, validateAnthropicRequest, validateAnthropicResponse, validateAnthropicStreamEvent, validateBatch, validateO2AConversion, validateOpenAIRequest, validateOpenAIResponse, validateOpenAIStreamChunk, validateSDKConfig, validateStreamConversion };
+export { A2ORequestAdapter, A2ORequestAdapterStatic, ADAPTERS_VERSION, type AnthropicContentBlock, AnthropicContentBlockBaseSchema, AnthropicContentBlockDeltaEventSchema, AnthropicContentBlockSchema, AnthropicContentBlockStartEventSchema, AnthropicContentBlockStopEventSchema, AnthropicErrorEventSchema, type AnthropicImageContentBlock, AnthropicImageContentBlockSchema, AnthropicImageSourceSchema, type AnthropicMessage, AnthropicMessageDeltaEventSchema, AnthropicMessageSchema, AnthropicMessageStartEventSchema, AnthropicMessageStopEventSchema, AnthropicMetadataSchema, AnthropicPingEventSchema, type AnthropicRequest, AnthropicRequestSchema, type AnthropicResponse, AnthropicResponseSchema, type AnthropicSDKConfig, AnthropicSDKWrapper, type AnthropicStreamEvent, AnthropicStreamEventBaseSchema, AnthropicStreamEventSchema, AnthropicSystemMessageSchema, type AnthropicTextContentBlock, AnthropicTextContentBlockSchema, type AnthropicTool, AnthropicToolInputSchemaSchema, type AnthropicToolResultContentBlock, AnthropicToolResultContentBlockSchema, AnthropicToolSchema, type AnthropicToolUseContentBlock, AnthropicToolUseContentBlockSchema, type AnthropicUsage, AnthropicUsageSchema, type BaseSDKClient, A2ORequestAdapter as ClaudeToOpenAIConverter, type ConversionFixResult, ConversionFixer, type ConversionResult$1 as ConversionResult, type ConversionState, ConversionValidator, type ConvertedRequest, type ConvertedResponse, EMERGENCY_HEALING_STRATEGIES, type EnhancedAdapterOptions, type EnhancedConversionResult, ErrorDetector, type ErrorInfo, ErrorRecovery, type ErrorSeverity, type ErrorType, FEATURES, FormatValidator, type HealingContext, type HealingResult, type HealingRule, StandardProtocolAdapter as NonStreamingIOConverter, O2ASSEAdapter, O2ASSEAdapterStatic, type OpenAIChoice, OpenAIChoiceSchema, OpenAIFunctionParametersSchema, OpenAIFunctionSchema, type OpenAIMessage, OpenAIMessageContentSchema, OpenAIMessageSchema, type OpenAIRequest$1 as OpenAIRequest, OpenAIRequestSchema, type OpenAIResponse$1 as OpenAIResponse, OpenAIResponseSchema, type OpenAISDKConfig, OpenAISDKWrapper, type OpenAIStreamChunk, OpenAIStreamChunkSchema, O2ASSEAdapter as OpenAIToClaudeSSEConverter, type OpenAITool, type OpenAIToolCall, OpenAIToolCallSchema, OpenAIToolSchema, type OpenAIUsage, OpenAIUsageSchema, ProtocolHealer, RECOVERY_STRATEGIES, REQUEST_HEALING_STRATEGIES, RESPONSE_HEALING_STRATEGIES, type RecoveryResult, type RecoveryStrategy, type RequestOptions, type SDKConfig, SDKFactory, type SDKProvider, type SDKResponse, type SDKStreamEvent, SSEEventGenerator, STREAM_HEALING_STRATEGIES, type ConversionResult as SchemaConversionResult, StandardProtocolAdapter as StandardGateway, StandardProtocolAdapter, type StandardProtocolAdapterOptions, StreamingProtocolAdapter as StreamingGateway, StreamingProtocolAdapter as StreamingIOConverter, StreamingProtocolAdapter, type StreamingProtocolAdapterOptions, type UnifiedSDKConfig, type ValidationResult, attemptRecovery, conversionValidator, createAnthropicSDK, createOpenAISDK, createValidator, downloadImageAsBase64, errorRecovery, getAllHealingStrategies, getGlobalLogger, getRecoveryRecommendations, getStrategiesForContext, healA2ORequest, healO2ARequest, healO2AResponse, healingValidate, isBase64DataUri, isExternalUrl, isRecoverable, protocolHealer, safeValidate, sdkFactory, selectSDKByModel, strictValidate, validateA2OConversion, validateAnthropicRequest, validateAnthropicResponse, validateAnthropicStreamEvent, validateBatch, validateO2AConversion, validateOpenAIRequest, validateOpenAIResponse, validateOpenAIStreamChunk, validateSDKConfig, validateStreamConversion };

package/dist/index.d.ts

@@ -5606,6 +5606,11 @@ interface A2ORequestAdapterConfig {
         logLevel: 'none' | 'error' | 'warn' | 'info' | 'debug';
         enableMetrics: boolean;
     };
+    imageProxy: {
+        enabled: boolean;
+        timeout: number;
+        maxSize: number;
+    };
 }
 
 /**
@@ -5626,9 +5631,9 @@ declare class A2ORequestAdapter {
      */
     convertAnthropicRequestToOpenAIEnhanced(anthropicRequest: unknown): Promise<ConversionResult$2<OpenAIRequest>>;
     /**
-     * 执行核心转换逻辑（原有逻辑保持不变）
+     * 执行核心转换逻辑（支持图片代理）
      */
-    private performCoreConversion;
+    performCoreConversion(anthropicRequest: ClaudeRequest): Promise<any>;
     /**
      * 转换Anthropic请求格式为OpenAI兼容格式 - 原有方法保持兼容
      */
@@ -5723,8 +5728,35 @@ declare const A2ORequestAdapterStatic: {
      * 获取工具映射（静态方法，已弃用）
      */
     getToolMapping: (claudeToolName: string) => string | undefined;
+    /**
+     * 转换Anthropic请求格式为OpenAI兼容格式（异步版本，支持图片URL自动下载）
+     * 解决GitHub Copilot等API不支持外部图片URL的问题
+     * @param anthropicRequest Claude格式的请求
+     * @param downloadImageUrls 是否下载图片URL并转换为base64（默认true）
+     */
+    convertAnthropicRequestToOpenAIAsync: (anthropicRequest: ClaudeRequest, downloadImageUrls?: boolean) => Promise<OpenAIRequest>;
 };
 
+/**
+ * 从URL下载图片并转换为base64 data URI
+ * @param url 图片URL
+ * @param options 下载选项
+ * @returns base64 data URI (例如: "data:image/jpeg;base64,/9j/4AAQ...")
+ */
+declare function downloadImageAsBase64(url: string, options?: {
+    timeout?: number;
+    maxSize?: number;
+    userAgent?: string;
+}): Promise<string>;
+/**
+ * 判断URL是否是外部URL（http/https开头）
+ */
+declare function isExternalUrl(url: string): boolean;
+/**
+ * 判断URL是否已经是base64 data URI
+ */
+declare function isBase64DataUri(url: string): boolean;
+
 /**
  * A2O格式验证器
  * 专门处理Claude和OpenAI请求格式的验证
@@ -7333,4 +7365,4 @@ declare const FEATURES: {
     readonly externalPackageVerified: true;
 };
 
-export { A2ORequestAdapter, A2ORequestAdapterStatic, ADAPTERS_VERSION, type AnthropicContentBlock, AnthropicContentBlockBaseSchema, AnthropicContentBlockDeltaEventSchema, AnthropicContentBlockSchema, AnthropicContentBlockStartEventSchema, AnthropicContentBlockStopEventSchema, AnthropicErrorEventSchema, type AnthropicImageContentBlock, AnthropicImageContentBlockSchema, AnthropicImageSourceSchema, type AnthropicMessage, AnthropicMessageDeltaEventSchema, AnthropicMessageSchema, AnthropicMessageStartEventSchema, AnthropicMessageStopEventSchema, AnthropicMetadataSchema, AnthropicPingEventSchema, type AnthropicRequest, AnthropicRequestSchema, type AnthropicResponse, AnthropicResponseSchema, type AnthropicSDKConfig, AnthropicSDKWrapper, type AnthropicStreamEvent, AnthropicStreamEventBaseSchema, AnthropicStreamEventSchema, AnthropicSystemMessageSchema, type AnthropicTextContentBlock, AnthropicTextContentBlockSchema, type AnthropicTool, AnthropicToolInputSchemaSchema, type AnthropicToolResultContentBlock, AnthropicToolResultContentBlockSchema, AnthropicToolSchema, type AnthropicToolUseContentBlock, AnthropicToolUseContentBlockSchema, type AnthropicUsage, AnthropicUsageSchema, type BaseSDKClient, A2ORequestAdapter as ClaudeToOpenAIConverter, type ConversionFixResult, ConversionFixer, type ConversionResult$1 as ConversionResult, type ConversionState, ConversionValidator, type ConvertedRequest, type ConvertedResponse, EMERGENCY_HEALING_STRATEGIES, type EnhancedAdapterOptions, type EnhancedConversionResult, ErrorDetector, type ErrorInfo, ErrorRecovery, type ErrorSeverity, type ErrorType, FEATURES, FormatValidator, type HealingContext, type HealingResult, type HealingRule, StandardProtocolAdapter as NonStreamingIOConverter, O2ASSEAdapter, O2ASSEAdapterStatic, type OpenAIChoice, OpenAIChoiceSchema, OpenAIFunctionParametersSchema, OpenAIFunctionSchema, type OpenAIMessage, OpenAIMessageContentSchema, OpenAIMessageSchema, type OpenAIRequest$1 as OpenAIRequest, OpenAIRequestSchema, type OpenAIResponse$1 as OpenAIResponse, OpenAIResponseSchema, type OpenAISDKConfig, OpenAISDKWrapper, type OpenAIStreamChunk, OpenAIStreamChunkSchema, O2ASSEAdapter as OpenAIToClaudeSSEConverter, type OpenAITool, type OpenAIToolCall, OpenAIToolCallSchema, OpenAIToolSchema, type OpenAIUsage, OpenAIUsageSchema, ProtocolHealer, RECOVERY_STRATEGIES, REQUEST_HEALING_STRATEGIES, RESPONSE_HEALING_STRATEGIES, type RecoveryResult, type RecoveryStrategy, type RequestOptions, type SDKConfig, SDKFactory, type SDKProvider, type SDKResponse, type SDKStreamEvent, SSEEventGenerator, STREAM_HEALING_STRATEGIES, type ConversionResult as SchemaConversionResult, StandardProtocolAdapter as StandardGateway, StandardProtocolAdapter, type StandardProtocolAdapterOptions, StreamingProtocolAdapter as StreamingGateway, StreamingProtocolAdapter as StreamingIOConverter, StreamingProtocolAdapter, type StreamingProtocolAdapterOptions, type UnifiedSDKConfig, type ValidationResult, attemptRecovery, conversionValidator, createAnthropicSDK, createOpenAISDK, createValidator, errorRecovery, getAllHealingStrategies, getGlobalLogger, getRecoveryRecommendations, getStrategiesForContext, healA2ORequest, healO2ARequest, healO2AResponse, healingValidate, isRecoverable, protocolHealer, safeValidate, sdkFactory, selectSDKByModel, strictValidate, validateA2OConversion, validateAnthropicRequest, validateAnthropicResponse, validateAnthropicStreamEvent, validateBatch, validateO2AConversion, validateOpenAIRequest, validateOpenAIResponse, validateOpenAIStreamChunk, validateSDKConfig, validateStreamConversion };
+export { A2ORequestAdapter, A2ORequestAdapterStatic, ADAPTERS_VERSION, type AnthropicContentBlock, AnthropicContentBlockBaseSchema, AnthropicContentBlockDeltaEventSchema, AnthropicContentBlockSchema, AnthropicContentBlockStartEventSchema, AnthropicContentBlockStopEventSchema, AnthropicErrorEventSchema, type AnthropicImageContentBlock, AnthropicImageContentBlockSchema, AnthropicImageSourceSchema, type AnthropicMessage, AnthropicMessageDeltaEventSchema, AnthropicMessageSchema, AnthropicMessageStartEventSchema, AnthropicMessageStopEventSchema, AnthropicMetadataSchema, AnthropicPingEventSchema, type AnthropicRequest, AnthropicRequestSchema, type AnthropicResponse, AnthropicResponseSchema, type AnthropicSDKConfig, AnthropicSDKWrapper, type AnthropicStreamEvent, AnthropicStreamEventBaseSchema, AnthropicStreamEventSchema, AnthropicSystemMessageSchema, type AnthropicTextContentBlock, AnthropicTextContentBlockSchema, type AnthropicTool, AnthropicToolInputSchemaSchema, type AnthropicToolResultContentBlock, AnthropicToolResultContentBlockSchema, AnthropicToolSchema, type AnthropicToolUseContentBlock, AnthropicToolUseContentBlockSchema, type AnthropicUsage, AnthropicUsageSchema, type BaseSDKClient, A2ORequestAdapter as ClaudeToOpenAIConverter, type ConversionFixResult, ConversionFixer, type ConversionResult$1 as ConversionResult, type ConversionState, ConversionValidator, type ConvertedRequest, type ConvertedResponse, EMERGENCY_HEALING_STRATEGIES, type EnhancedAdapterOptions, type EnhancedConversionResult, ErrorDetector, type ErrorInfo, ErrorRecovery, type ErrorSeverity, type ErrorType, FEATURES, FormatValidator, type HealingContext, type HealingResult, type HealingRule, StandardProtocolAdapter as NonStreamingIOConverter, O2ASSEAdapter, O2ASSEAdapterStatic, type OpenAIChoice, OpenAIChoiceSchema, OpenAIFunctionParametersSchema, OpenAIFunctionSchema, type OpenAIMessage, OpenAIMessageContentSchema, OpenAIMessageSchema, type OpenAIRequest$1 as OpenAIRequest, OpenAIRequestSchema, type OpenAIResponse$1 as OpenAIResponse, OpenAIResponseSchema, type OpenAISDKConfig, OpenAISDKWrapper, type OpenAIStreamChunk, OpenAIStreamChunkSchema, O2ASSEAdapter as OpenAIToClaudeSSEConverter, type OpenAITool, type OpenAIToolCall, OpenAIToolCallSchema, OpenAIToolSchema, type OpenAIUsage, OpenAIUsageSchema, ProtocolHealer, RECOVERY_STRATEGIES, REQUEST_HEALING_STRATEGIES, RESPONSE_HEALING_STRATEGIES, type RecoveryResult, type RecoveryStrategy, type RequestOptions, type SDKConfig, SDKFactory, type SDKProvider, type SDKResponse, type SDKStreamEvent, SSEEventGenerator, STREAM_HEALING_STRATEGIES, type ConversionResult as SchemaConversionResult, StandardProtocolAdapter as StandardGateway, StandardProtocolAdapter, type StandardProtocolAdapterOptions, StreamingProtocolAdapter as StreamingGateway, StreamingProtocolAdapter as StreamingIOConverter, StreamingProtocolAdapter, type StreamingProtocolAdapterOptions, type UnifiedSDKConfig, type ValidationResult, attemptRecovery, conversionValidator, createAnthropicSDK, createOpenAISDK, createValidator, downloadImageAsBase64, errorRecovery, getAllHealingStrategies, getGlobalLogger, getRecoveryRecommendations, getStrategiesForContext, healA2ORequest, healO2ARequest, healO2AResponse, healingValidate, isBase64DataUri, isExternalUrl, isRecoverable, protocolHealer, safeValidate, sdkFactory, selectSDKByModel, strictValidate, validateA2OConversion, validateAnthropicRequest, validateAnthropicResponse, validateAnthropicStreamEvent, validateBatch, validateO2AConversion, validateOpenAIRequest, validateOpenAIResponse, validateOpenAIStreamChunk, validateSDKConfig, validateStreamConversion };

package/dist/index.js

@@ -453,6 +453,7 @@ __export(index_exports, {
   createAnthropicSDK: () => createAnthropicSDK,
   createOpenAISDK: () => createOpenAISDK,
   createValidator: () => createValidator,
+  downloadImageAsBase64: () => downloadImageAsBase64,
   errorRecovery: () => errorRecovery,
   getAllHealingStrategies: () => getAllHealingStrategies,
   getGlobalLogger: () => getGlobalLogger,
@@ -462,6 +463,8 @@ __export(index_exports, {
   healO2ARequest: () => healO2ARequest,
   healO2AResponse: () => healO2AResponse,
   healingValidate: () => healingValidate,
+  isBase64DataUri: () => isBase64DataUri,
+  isExternalUrl: () => isExternalUrl,
   isRecoverable: () => isRecoverable,
   protocolHealer: () => protocolHealer,
   safeValidate: () => safeValidate,
@@ -532,6 +535,14 @@ var DEFAULT_CONFIG = {
     enabled: false,
     logLevel: "warn",
     enableMetrics: false
+  },
+  imageProxy: {
+    enabled: true,
+    // 默认启用图片代理（解决GitHub Copilot等不支持外部URL的问题）
+    timeout: 1e4,
+    // 10秒超时
+    maxSize: 10 * 1024 * 1024
+    // 10MB最大文件大小
   }
 };
 var SUPPORTED_IMAGE_TYPES = [
@@ -556,6 +567,61 @@ var TOOL_CONVERSION = {
   UNKNOWN_TOOL_FALLBACK: "unknown_tool"
 };
 
+// src/core/a2o-request-adapter/image-proxy.ts
+var SUPPORTED_IMAGE_MIME_TYPES = [
+  "image/jpeg",
+  "image/png",
+  "image/gif",
+  "image/webp"
+];
+async function downloadImageAsBase64(url, options = {}) {
+  const {
+    timeout = 1e4,
+    maxSize = 10 * 1024 * 1024,
+    // 10MB
+    userAgent = "ai-protocol-adapters/1.0"
+  } = options;
+  try {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeout);
+    const response = await fetch(url, {
+      signal: controller.signal,
+      headers: {
+        "User-Agent": userAgent
+      }
+    });
+    clearTimeout(timeoutId);
+    if (!response.ok) {
+      throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+    }
+    const contentType = response.headers.get("content-type");
+    if (!contentType || !SUPPORTED_IMAGE_MIME_TYPES.some((type) => contentType.includes(type))) {
+      throw new Error(`Unsupported content type: ${contentType}`);
+    }
+    const contentLength = response.headers.get("content-length");
+    if (contentLength && parseInt(contentLength) > maxSize) {
+      throw new Error(`Image too large: ${contentLength} bytes (max: ${maxSize} bytes)`);
+    }
+    const arrayBuffer = await response.arrayBuffer();
+    if (arrayBuffer.byteLength > maxSize) {
+      throw new Error(`Image too large: ${arrayBuffer.byteLength} bytes (max: ${maxSize} bytes)`);
+    }
+    const base64 = Buffer.from(arrayBuffer).toString("base64");
+    return `data:${contentType};base64,${base64}`;
+  } catch (error) {
+    if (error.name === "AbortError") {
+      throw new Error(`Image download timeout after ${timeout}ms`);
+    }
+    throw new Error(`Failed to download image from ${url}: ${error.message}`);
+  }
+}
+function isExternalUrl(url) {
+  return url.startsWith("http://") || url.startsWith("https://");
+}
+function isBase64DataUri(url) {
+  return url.startsWith("data:");
+}
+
 // src/core/a2o-request-adapter/message-converter.ts
 var MessageConverter = class {
   /**
@@ -695,9 +761,23 @@ var MessageConverter = class {
   }
   /**
    * 转换图片内容格式
+   * 支持两种格式：URL 和 base64
    */
   static convertImageContent(item) {
-    if (item.source && item.source.type === "base64" && item.source.data && item.source.media_type) {
+    if (!item.source) {
+      return null;
+    }
+    if (item.source.type === "url" && item.source.url) {
+      return {
+        type: "image_url",
+        image_url: {
+          url: item.source.url,
+          detail: "auto"
+          // OpenAI 支持的可选参数
+        }
+      };
+    }
+    if (item.source.type === "base64" && item.source.data && item.source.media_type) {
       if (!SUPPORTED_IMAGE_TYPES.includes(item.source.media_type)) {
         console.warn(`\u4E0D\u652F\u6301\u7684\u56FE\u7247\u683C\u5F0F: ${item.source.media_type}`);
         return null;
@@ -706,7 +786,8 @@ var MessageConverter = class {
       return {
         type: "image_url",
         image_url: {
-          url: dataUri
+          url: dataUri,
+          detail: "auto"
         }
       };
     }
@@ -802,6 +883,170 @@ var MessageConverter = class {
     }
     return null;
   }
+  /**
+   * 异步转换图片内容格式（支持URL自动下载转base64）
+   * @param item 图片内容项
+   * @param downloadUrls 是否下载URL并转换为base64（默认true）
+   */
+  static async convertImageContentAsync(item, downloadUrls = true) {
+    if (!item.source) {
+      return null;
+    }
+    if (item.source.type === "url" && item.source.url) {
+      const url = item.source.url;
+      if (isBase64DataUri(url)) {
+        return {
+          type: "image_url",
+          image_url: {
+            url,
+            detail: "auto"
+          }
+        };
+      }
+      if (downloadUrls && isExternalUrl(url)) {
+        try {
+          console.log(`[MessageConverter] Downloading image from URL: ${url}`);
+          const base64DataUri = await downloadImageAsBase64(url);
+          console.log(`[MessageConverter] Successfully converted image to base64`);
+          return {
+            type: "image_url",
+            image_url: {
+              url: base64DataUri,
+              detail: "auto"
+            }
+          };
+        } catch (error) {
+          console.error(`[MessageConverter] Failed to download image: ${error.message}`);
+          return {
+            type: "image_url",
+            image_url: {
+              url,
+              detail: "auto"
+            }
+          };
+        }
+      }
+      return {
+        type: "image_url",
+        image_url: {
+          url,
+          detail: "auto"
+        }
+      };
+    }
+    if (item.source.type === "base64" && item.source.data && item.source.media_type) {
+      if (!SUPPORTED_IMAGE_TYPES.includes(item.source.media_type)) {
+        console.warn(`\u4E0D\u652F\u6301\u7684\u56FE\u7247\u683C\u5F0F: ${item.source.media_type}`);
+        return null;
+      }
+      const dataUri = `data:${item.source.media_type};base64,${item.source.data}`;
+      return {
+        type: "image_url",
+        image_url: {
+          url: dataUri,
+          detail: "auto"
+        }
+      };
+    }
+    return null;
+  }
+  /**
+   * 异步处理消息内容（支持图片URL下载）
+   */
+  static async processMessageContentAsync(content, downloadUrls = true) {
+    const textContent = [];
+    const toolUses = [];
+    const toolResults = [];
+    for (const item of content) {
+      if (item.type) {
+        switch (item.type) {
+          case "text":
+            if (item.text) {
+              textContent.push({ type: "text", text: item.text });
+            }
+            break;
+          case "tool_use":
+            toolUses.push(item);
+            break;
+          case "tool_result":
+            toolResults.push(item);
+            break;
+          case "image":
+            const imageContent = await this.convertImageContentAsync(item, downloadUrls);
+            if (imageContent) {
+              textContent.push(imageContent);
+            }
+            break;
+        }
+      }
+    }
+    return { textContent, toolUses, toolResults };
+  }
+  /**
+   * 异步转换消息格式（支持图片URL自动下载）
+   * @param messages Claude格式的消息数组
+   * @param system 系统消息
+   * @param downloadImageUrls 是否下载图片URL并转换为base64（默认true，解决GitHub Copilot等API不支持外部URL的问题）
+   */
+  static async convertMessagesAsync(messages, system, downloadImageUrls = true) {
+    const debugEnabled = process.env.AI_PROTOCOL_DEBUG === "true";
+    if (debugEnabled) {
+      console.debug(
+        `[MessageConverter] convertMessagesAsync called (downloadImageUrls: ${downloadImageUrls})`
+      );
+    }
+    const context = this.createConversionContext(messages);
+    const convertedMessages = [];
+    for (const msg of messages) {
+      if (Array.isArray(msg.content)) {
+        const processedMessages = await this.processComplexMessageAsync(msg, context, downloadImageUrls);
+        convertedMessages.push(...processedMessages);
+      } else {
+        const safeMsg = { ...msg };
+        if (safeMsg.content === null || safeMsg.content === void 0) {
+          safeMsg.content = "";
+        }
+        convertedMessages.push(safeMsg);
+      }
+    }
+    const systemMessage = this.processSystemMessage(system);
+    if (systemMessage) {
+      return [systemMessage, ...convertedMessages];
+    }
+    return convertedMessages;
+  }
+  /**
+   * 异步处理复杂消息（支持图片URL下载）
+   */
+  static async processComplexMessageAsync(msg, context, downloadUrls) {
+    const { textContent, toolUses, toolResults } = await this.processMessageContentAsync(
+      msg.content,
+      downloadUrls
+    );
+    const result = [];
+    if (msg.role === "user") {
+      const toolMessages = this.createToolResultMessages(toolResults, context.toolIdToNameMap);
+      result.push(...toolMessages);
+      const textMessage = this.createTextMessage("user", textContent);
+      if (textMessage) {
+        result.push(textMessage);
+      }
+    } else if (msg.role === "assistant") {
+      if (toolUses.length > 0) {
+        const assistantMessage = this.createAssistantMessageWithToolCalls(textContent, toolUses);
+        result.push(assistantMessage);
+        toolUses.forEach((toolUse) => {
+          context.toolIdToNameMap.set(toolUse.id, toolUse.name);
+        });
+      } else {
+        const textMessage = this.createTextMessage("assistant", textContent);
+        if (textMessage) {
+          result.push(textMessage);
+        }
+      }
+    }
+    return result;
+  }
 };
 
 // src/core/a2o-request-adapter/tool-converter.ts
@@ -3454,15 +3699,21 @@ var A2ORequestAdapter = class {
     }
   }
   /**
-   * 执行核心转换逻辑（原有逻辑保持不变）
+   * 执行核心转换逻辑（支持图片代理）
    */
   async performCoreConversion(anthropicRequest) {
     if (this.config.enableFormatValidation) {
       FormatValidator.validateClaudeRequest(anthropicRequest);
     }
+    const messages = this.config.imageProxy.enabled ? await MessageConverter.convertMessagesAsync(
+      anthropicRequest.messages,
+      anthropicRequest.system,
+      true
+      // 启用图片下载
+    ) : MessageConverter.convertMessages(anthropicRequest.messages, anthropicRequest.system);
     const openaiRequest = {
       model: anthropicRequest.model,
-      messages: MessageConverter.convertMessages(anthropicRequest.messages, anthropicRequest.system),
+      messages,
       max_tokens: anthropicRequest.max_tokens,
       temperature: anthropicRequest.temperature,
       stream: anthropicRequest.stream
@@ -3772,6 +4023,36 @@ var A2ORequestAdapterStatic = {
    */
   getToolMapping: (claudeToolName) => {
     return claudeToolName;
+  },
+  /**
+   * 转换Anthropic请求格式为OpenAI兼容格式（异步版本，支持图片URL自动下载）
+   * 解决GitHub Copilot等API不支持外部图片URL的问题
+   * @param anthropicRequest Claude格式的请求
+   * @param downloadImageUrls 是否下载图片URL并转换为base64（默认true）
+   */
+  convertAnthropicRequestToOpenAIAsync: async (anthropicRequest, downloadImageUrls = true) => {
+    const adapter = new A2ORequestAdapter({
+      debugMode: false,
+      maxDescriptionLength: 100,
+      enableToolNameValidation: true,
+      enableFormatValidation: true,
+      validation: { enabled: true, strict: false },
+      healing: { enabled: true, maxAttempts: 2, enableCustomRules: true },
+      recovery: { enabled: false, maxRetries: 0, backoffMs: 1e3 },
+      monitoring: { enabled: false, logLevel: "none", enableMetrics: false },
+      imageProxy: {
+        enabled: downloadImageUrls,
+        timeout: 1e4,
+        maxSize: 10 * 1024 * 1024
+      }
+    });
+    try {
+      const result = await adapter.performCoreConversion(anthropicRequest);
+      return result;
+    } catch (error) {
+      console.warn(`[A2ORequestAdapterStatic] Async conversion failed: ${error?.message || error}`);
+      return adapter.performBasicConversion(anthropicRequest, true);
+    }
   }
 };
 
@@ -6658,6 +6939,7 @@ var FEATURES = {
   createAnthropicSDK,
   createOpenAISDK,
   createValidator,
+  downloadImageAsBase64,
   errorRecovery,
   getAllHealingStrategies,
   getGlobalLogger,
@@ -6667,6 +6949,8 @@ var FEATURES = {
   healO2ARequest,
   healO2AResponse,
   healingValidate,
+  isBase64DataUri,
+  isExternalUrl,
   isRecoverable,
   protocolHealer,
   safeValidate,

package/dist/index.mjs

@@ -425,6 +425,14 @@ var DEFAULT_CONFIG = {
     enabled: false,
     logLevel: "warn",
     enableMetrics: false
+  },
+  imageProxy: {
+    enabled: true,
+    // 默认启用图片代理（解决GitHub Copilot等不支持外部URL的问题）
+    timeout: 1e4,
+    // 10秒超时
+    maxSize: 10 * 1024 * 1024
+    // 10MB最大文件大小
   }
 };
 var SUPPORTED_IMAGE_TYPES = [
@@ -449,6 +457,61 @@ var TOOL_CONVERSION = {
   UNKNOWN_TOOL_FALLBACK: "unknown_tool"
 };
 
+// src/core/a2o-request-adapter/image-proxy.ts
+var SUPPORTED_IMAGE_MIME_TYPES = [
+  "image/jpeg",
+  "image/png",
+  "image/gif",
+  "image/webp"
+];
+async function downloadImageAsBase64(url, options = {}) {
+  const {
+    timeout = 1e4,
+    maxSize = 10 * 1024 * 1024,
+    // 10MB
+    userAgent = "ai-protocol-adapters/1.0"
+  } = options;
+  try {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeout);
+    const response = await fetch(url, {
+      signal: controller.signal,
+      headers: {
+        "User-Agent": userAgent
+      }
+    });
+    clearTimeout(timeoutId);
+    if (!response.ok) {
+      throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+    }
+    const contentType = response.headers.get("content-type");
+    if (!contentType || !SUPPORTED_IMAGE_MIME_TYPES.some((type) => contentType.includes(type))) {
+      throw new Error(`Unsupported content type: ${contentType}`);
+    }
+    const contentLength = response.headers.get("content-length");
+    if (contentLength && parseInt(contentLength) > maxSize) {
+      throw new Error(`Image too large: ${contentLength} bytes (max: ${maxSize} bytes)`);
+    }
+    const arrayBuffer = await response.arrayBuffer();
+    if (arrayBuffer.byteLength > maxSize) {
+      throw new Error(`Image too large: ${arrayBuffer.byteLength} bytes (max: ${maxSize} bytes)`);
+    }
+    const base64 = Buffer.from(arrayBuffer).toString("base64");
+    return `data:${contentType};base64,${base64}`;
+  } catch (error) {
+    if (error.name === "AbortError") {
+      throw new Error(`Image download timeout after ${timeout}ms`);
+    }
+    throw new Error(`Failed to download image from ${url}: ${error.message}`);
+  }
+}
+function isExternalUrl(url) {
+  return url.startsWith("http://") || url.startsWith("https://");
+}
+function isBase64DataUri(url) {
+  return url.startsWith("data:");
+}
+
 // src/core/a2o-request-adapter/message-converter.ts
 var MessageConverter = class {
   /**
@@ -588,9 +651,23 @@ var MessageConverter = class {
   }
   /**
    * 转换图片内容格式
+   * 支持两种格式：URL 和 base64
    */
   static convertImageContent(item) {
-    if (item.source && item.source.type === "base64" && item.source.data && item.source.media_type) {
+    if (!item.source) {
+      return null;
+    }
+    if (item.source.type === "url" && item.source.url) {
+      return {
+        type: "image_url",
+        image_url: {
+          url: item.source.url,
+          detail: "auto"
+          // OpenAI 支持的可选参数
+        }
+      };
+    }
+    if (item.source.type === "base64" && item.source.data && item.source.media_type) {
       if (!SUPPORTED_IMAGE_TYPES.includes(item.source.media_type)) {
         console.warn(`\u4E0D\u652F\u6301\u7684\u56FE\u7247\u683C\u5F0F: ${item.source.media_type}`);
         return null;
@@ -599,7 +676,8 @@ var MessageConverter = class {
       return {
         type: "image_url",
         image_url: {
-          url: dataUri
+          url: dataUri,
+          detail: "auto"
         }
       };
     }
@@ -695,6 +773,170 @@ var MessageConverter = class {
     }
     return null;
   }
+  /**
+   * 异步转换图片内容格式（支持URL自动下载转base64）
+   * @param item 图片内容项
+   * @param downloadUrls 是否下载URL并转换为base64（默认true）
+   */
+  static async convertImageContentAsync(item, downloadUrls = true) {
+    if (!item.source) {
+      return null;
+    }
+    if (item.source.type === "url" && item.source.url) {
+      const url = item.source.url;
+      if (isBase64DataUri(url)) {
+        return {
+          type: "image_url",
+          image_url: {
+            url,
+            detail: "auto"
+          }
+        };
+      }
+      if (downloadUrls && isExternalUrl(url)) {
+        try {
+          console.log(`[MessageConverter] Downloading image from URL: ${url}`);
+          const base64DataUri = await downloadImageAsBase64(url);
+          console.log(`[MessageConverter] Successfully converted image to base64`);
+          return {
+            type: "image_url",
+            image_url: {
+              url: base64DataUri,
+              detail: "auto"
+            }
+          };
+        } catch (error) {
+          console.error(`[MessageConverter] Failed to download image: ${error.message}`);
+          return {
+            type: "image_url",
+            image_url: {
+              url,
+              detail: "auto"
+            }
+          };
+        }
+      }
+      return {
+        type: "image_url",
+        image_url: {
+          url,
+          detail: "auto"
+        }
+      };
+    }
+    if (item.source.type === "base64" && item.source.data && item.source.media_type) {
+      if (!SUPPORTED_IMAGE_TYPES.includes(item.source.media_type)) {
+        console.warn(`\u4E0D\u652F\u6301\u7684\u56FE\u7247\u683C\u5F0F: ${item.source.media_type}`);
+        return null;
+      }
+      const dataUri = `data:${item.source.media_type};base64,${item.source.data}`;
+      return {
+        type: "image_url",
+        image_url: {
+          url: dataUri,
+          detail: "auto"
+        }
+      };
+    }
+    return null;
+  }
+  /**
+   * 异步处理消息内容（支持图片URL下载）
+   */
+  static async processMessageContentAsync(content, downloadUrls = true) {
+    const textContent = [];
+    const toolUses = [];
+    const toolResults = [];
+    for (const item of content) {
+      if (item.type) {
+        switch (item.type) {
+          case "text":
+            if (item.text) {
+              textContent.push({ type: "text", text: item.text });
+            }
+            break;
+          case "tool_use":
+            toolUses.push(item);
+            break;
+          case "tool_result":
+            toolResults.push(item);
+            break;
+          case "image":
+            const imageContent = await this.convertImageContentAsync(item, downloadUrls);
+            if (imageContent) {
+              textContent.push(imageContent);
+            }
+            break;
+        }
+      }
+    }
+    return { textContent, toolUses, toolResults };
+  }
+  /**
+   * 异步转换消息格式（支持图片URL自动下载）
+   * @param messages Claude格式的消息数组
+   * @param system 系统消息
+   * @param downloadImageUrls 是否下载图片URL并转换为base64（默认true，解决GitHub Copilot等API不支持外部URL的问题）
+   */
+  static async convertMessagesAsync(messages, system, downloadImageUrls = true) {
+    const debugEnabled = process.env.AI_PROTOCOL_DEBUG === "true";
+    if (debugEnabled) {
+      console.debug(
+        `[MessageConverter] convertMessagesAsync called (downloadImageUrls: ${downloadImageUrls})`
+      );
+    }
+    const context = this.createConversionContext(messages);
+    const convertedMessages = [];
+    for (const msg of messages) {
+      if (Array.isArray(msg.content)) {
+        const processedMessages = await this.processComplexMessageAsync(msg, context, downloadImageUrls);
+        convertedMessages.push(...processedMessages);
+      } else {
+        const safeMsg = { ...msg };
+        if (safeMsg.content === null || safeMsg.content === void 0) {
+          safeMsg.content = "";
+        }
+        convertedMessages.push(safeMsg);
+      }
+    }
+    const systemMessage = this.processSystemMessage(system);
+    if (systemMessage) {
+      return [systemMessage, ...convertedMessages];
+    }
+    return convertedMessages;
+  }
+  /**
+   * 异步处理复杂消息（支持图片URL下载）
+   */
+  static async processComplexMessageAsync(msg, context, downloadUrls) {
+    const { textContent, toolUses, toolResults } = await this.processMessageContentAsync(
+      msg.content,
+      downloadUrls
+    );
+    const result = [];
+    if (msg.role === "user") {
+      const toolMessages = this.createToolResultMessages(toolResults, context.toolIdToNameMap);
+      result.push(...toolMessages);
+      const textMessage = this.createTextMessage("user", textContent);
+      if (textMessage) {
+        result.push(textMessage);
+      }
+    } else if (msg.role === "assistant") {
+      if (toolUses.length > 0) {
+        const assistantMessage = this.createAssistantMessageWithToolCalls(textContent, toolUses);
+        result.push(assistantMessage);
+        toolUses.forEach((toolUse) => {
+          context.toolIdToNameMap.set(toolUse.id, toolUse.name);
+        });
+      } else {
+        const textMessage = this.createTextMessage("assistant", textContent);
+        if (textMessage) {
+          result.push(textMessage);
+        }
+      }
+    }
+    return result;
+  }
 };
 
 // src/core/a2o-request-adapter/tool-converter.ts
@@ -3347,15 +3589,21 @@ var A2ORequestAdapter = class {
     }
   }
   /**
-   * 执行核心转换逻辑（原有逻辑保持不变）
+   * 执行核心转换逻辑（支持图片代理）
    */
   async performCoreConversion(anthropicRequest) {
     if (this.config.enableFormatValidation) {
       FormatValidator.validateClaudeRequest(anthropicRequest);
     }
+    const messages = this.config.imageProxy.enabled ? await MessageConverter.convertMessagesAsync(
+      anthropicRequest.messages,
+      anthropicRequest.system,
+      true
+      // 启用图片下载
+    ) : MessageConverter.convertMessages(anthropicRequest.messages, anthropicRequest.system);
     const openaiRequest = {
       model: anthropicRequest.model,
-      messages: MessageConverter.convertMessages(anthropicRequest.messages, anthropicRequest.system),
+      messages,
       max_tokens: anthropicRequest.max_tokens,
       temperature: anthropicRequest.temperature,
       stream: anthropicRequest.stream
@@ -3665,6 +3913,36 @@ var A2ORequestAdapterStatic = {
    */
   getToolMapping: (claudeToolName) => {
     return claudeToolName;
+  },
+  /**
+   * 转换Anthropic请求格式为OpenAI兼容格式（异步版本，支持图片URL自动下载）
+   * 解决GitHub Copilot等API不支持外部图片URL的问题
+   * @param anthropicRequest Claude格式的请求
+   * @param downloadImageUrls 是否下载图片URL并转换为base64（默认true）
+   */
+  convertAnthropicRequestToOpenAIAsync: async (anthropicRequest, downloadImageUrls = true) => {
+    const adapter = new A2ORequestAdapter({
+      debugMode: false,
+      maxDescriptionLength: 100,
+      enableToolNameValidation: true,
+      enableFormatValidation: true,
+      validation: { enabled: true, strict: false },
+      healing: { enabled: true, maxAttempts: 2, enableCustomRules: true },
+      recovery: { enabled: false, maxRetries: 0, backoffMs: 1e3 },
+      monitoring: { enabled: false, logLevel: "none", enableMetrics: false },
+      imageProxy: {
+        enabled: downloadImageUrls,
+        timeout: 1e4,
+        maxSize: 10 * 1024 * 1024
+      }
+    });
+    try {
+      const result = await adapter.performCoreConversion(anthropicRequest);
+      return result;
+    } catch (error) {
+      console.warn(`[A2ORequestAdapterStatic] Async conversion failed: ${error?.message || error}`);
+      return adapter.performBasicConversion(anthropicRequest, true);
+    }
   }
 };
 
@@ -6550,6 +6828,7 @@ export {
   createAnthropicSDK,
   createOpenAISDK,
   createValidator,
+  downloadImageAsBase64,
   errorRecovery,
   getAllHealingStrategies,
   getGlobalLogger,
@@ -6559,6 +6838,8 @@ export {
   healO2ARequest,
   healO2AResponse,
   healingValidate,
+  isBase64DataUri,
+  isExternalUrl,
   isRecoverable,
   protocolHealer,
   safeValidate,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-protocol-adapters",
-  "version": "1.0.0-alpha.16",
+  "version": "1.0.0-alpha.18",
   "description": "Universal AI Protocol Converter - OpenAI ⇄ Anthropic with full TypeScript support",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",