/** * HTTP Transport Provider * * 协议无关的 Provider 基类,负责: * - 读取 ServiceProfile / runtimeProfile * - 初始化认证、HTTP 客户端、Hook 系统 * - 提供请求预处理、hook 执行、兼容层调用、错误治理等通用能力 * * 各协议具体行为(OpenAI Chat、Responses、Anthropic、Gemini 等)通过子类覆写钩子实现。 */ import { BaseProvider } from './base-provider.js'; import type { HttpClient } from '../utils/http-client.js'; import type { IAuthProvider } from '../../auth/auth-interface.js'; import type { OpenAIStandardConfig } from '../api/provider-config.js'; import type { ProviderContext, ServiceProfile } from '../api/provider-types.js'; import type { UnknownObject } from '../../../types/common-types.js'; import type { ModuleDependencies } from '../../../modules/pipeline/interfaces/pipeline-interfaces.js'; import type { HttpProtocolClient, ProtocolRequestPayload } from '../../../client/http-protocol-client.js'; type ProtocolClient = HttpProtocolClient; export type ProviderConfigInternal = OpenAIStandardConfig['config'] & { endpoint?: string; defaultModel?: string; headers?: Record; responses?: Record; authCapabilities?: { required?: string[]; optional?: string[]; }; }; export declare class HttpTransportProvider extends BaseProvider { readonly type: string; protected authProvider: IAuthProvider | null; protected httpClient: HttpClient; protected serviceProfile: ServiceProfile; protected protocolClient: ProtocolClient; private readonly vercelAiSdkAnthropicTransport?; private readonly vercelAiSdkOpenAiTransport?; private readonly openAiResponsesSdkTransport?; private requestExecutor; private injectedConfig; private formatUnknownError; private logNonBlockingError; constructor(config: OpenAIStandardConfig, dependencies: ModuleDependencies, moduleType: string, protocolClient?: HttpProtocolClient); /** * 确保认证提供者完成初始化(避免 ApiKeyAuthProvider 未初始化导致的报错) */ protected onInitialize(): Promise; setConfig(cfg: unknown): void; getConfig(): unknown; protected getServiceProfile(): ServiceProfile; protected createAuthProvider(): IAuthProvider; protected createHttpClient(): void; private createRequestExecutorDeps; private resolveTransportBackend; private resolvePreparedRequestExecutor; protected preprocessRequest(request: UnknownObject): Promise; protected postprocessResponse(response: unknown, context: ProviderContext): Promise; protected sendRequestInternal(request: UnknownObject): Promise; protected wantsUpstreamSse(request: UnknownObject, context: ProviderContext): boolean; protected applyStreamModeHeaders(headers: Record, wantsSse: boolean): Record; protected prepareSseRequestBody(body: UnknownObject, context?: ProviderContext): void; protected wrapUpstreamSseResponse(stream: NodeJS.ReadableStream, _context: ProviderContext): Promise; protected performHealthCheck(url: string): Promise; private normalizeHttpError; private resolveProfileBusinessResponseError; /** * 为特定请求确定最终 endpoint(默认使用配置值,可由子类覆写) */ protected resolveRequestEndpoint(request: UnknownObject, defaultEndpoint: string): string; /** * 构造最终发送到上游的请求体,默认实现包含模型/令牌治理,可由子类覆写 */ protected buildHttpRequestBody(request: UnknownObject): UnknownObject; private resolveFamilyProfile; /** * 允许子类在 Hook 运行完后对头部做最终调整 */ protected finalizeRequestHeaders(headers: Record, request: UnknownObject): Promise>; private validateConfig; protected buildRequestHeaders(): Promise>; private isAntigravityTransportRuntime; protected getEffectiveBaseUrl(): string; protected getBaseUrlCandidates(_context: ProviderContext): string[] | undefined; protected getEffectiveEndpoint(): string; protected createProviderContext(): ProviderContext; /** * 检查是否为 Gemini 系列传输 */ private isGeminiFamilyTransport; private normalizeQwenAuthResourceBaseUrl; private getRuntimeDetector; private resolveAuthResourceBaseUrlOverride; } export {};