@lqc123qwe/car-runtime 1.9.0 → 1.11.0

package/dist/runtime-core/llm.d.ts

@@ -0,0 +1,76 @@
+import { CredentialService } from './credentials.ts';
+import type { Disposable, LlmAdapter, LlmChunk, LlmRequest } from './types.ts';
+import type { PluginContext } from '../kernel/context.ts';
+export declare class AdapterRegistry {
+    #private;
+    /** 注册（幂等语义：同 id 重复注册显式报错——冲突链定位风格） */
+    register(adapter: LlmAdapter, opts?: {
+        default?: boolean;
+    }): Disposable;
+    /** 解析：显式 id > 默认适配器；无可用适配器显式报错（禁静默降级） */
+    get(id?: string): LlmAdapter;
+    list(): Array<{
+        id: string;
+        isDefault: boolean;
+    }>;
+}
+/** 首个 finishReason 定格；适配器后续给出不同值 = 契约违规显式抛错（不改写不吞没） */
+export declare function withFinishReasonGuard(stream: AsyncIterable<LlmChunk>): AsyncIterable<LlmChunk>;
+export declare class RuntimeCore {
+    #private;
+    readonly registry: AdapterRegistry;
+    readonly credentials: CredentialService;
+    constructor(credentials?: CredentialService);
+    /** 绑定插件作用域：服务注册 + 适配器注册进入 Effect 可逆通道（宿主传 Context——根作用域 effect 同纪律） */
+    bindContext(ctx: Pick<PluginContext, 'provide' | 'effect'>): void;
+    /** §3.2.M8.2：registerLlmAdapter(adapter): Disposable——Effect 可逆（卸载回卷后可重注册） */
+    registerLlmAdapter(adapter: LlmAdapter, opts?: {
+        default?: boolean;
+    }): Disposable;
+    /** §3.2.M8.2：chat(req): AsyncIterable<LlmChunk>——统一入口 + finishReason 守卫 */
+    chat(req: LlmRequest): AsyncIterable<LlmChunk>;
+}
+/**
+ * D-12a TLS 强制门（openai-compat / anthropic 共用，口径不变）：https 直接通过；
+ * http 仅豁免 loopback——本地模型服务（Ollama 等）与本地 E2E；非回环地址维持 TLS 强制
+ * （§3.2.M8.4）。豁免集显式列举，不扩大到局域网。
+ */
+export declare function assertTlsOrLoopback(baseUrl: string): void;
+export interface OpenAICompatOptions {
+    id?: string;
+    baseUrl: string;
+    /** 凭据服务与 provider 名（Bearer token 来源） */
+    credentials?: CredentialService;
+    provider?: string;
+    fetchImpl?: typeof fetch;
+    /** §3.5.4 基线：总 120s / 首字节 30s / 2 次退避 1s-2s（测试可注入缩短） */
+    timeoutMs?: number;
+    firstByteMs?: number;
+    retries?: number;
+    backoffMs?: number[];
+    /** 测试注入睡眠（退避可观测；缺省真实定时器） */
+    sleep?: (ms: number) => Promise<void>;
+}
+export declare function createOpenAICompatAdapter(opts: OpenAICompatOptions): LlmAdapter & {
+    id: string;
+};
+export interface AnthropicAdapterOptions {
+    id?: string;
+    /** API 源（如 https://api.anthropic.com；请求路径 = {baseUrl}/v1/messages，与官方 SDK base_url 同约定） */
+    baseUrl: string;
+    /** 凭据服务与 provider 名（x-api-key 来源；provider 缺省 'anthropic' → ANTHROPIC_API_KEY） */
+    credentials?: CredentialService;
+    provider?: string;
+    fetchImpl?: typeof fetch;
+    /** §3.5.4 基线：总 120s / 首字节 30s / 2 次退避 1s-2s（与 openai-compat 同款） */
+    timeoutMs?: number;
+    firstByteMs?: number;
+    retries?: number;
+    backoffMs?: number[];
+    sleep?: (ms: number) => Promise<void>;
+    /** D-20：Anthropic API max_tokens 必填——req.maxTokens 缺席时取此缺省（provider 差异登记，缺省 4096） */
+    defaultMaxTokens?: number;
+}
+export declare function createAnthropicAdapter(opts: AnthropicAdapterOptions): LlmAdapter & {
+    id: string;
+};