@ai-setting/roy-agent-cli 1.3.18 → 1.3.22

package/dist/core/src/env/llm/types.d.ts

@@ -1,771 +0,0 @@
-import { z } from "zod";
-/**
- * LLM Message
- */
-export interface LLMMessage {
-    /** 消息角色 */
-    role: "system" | "user" | "assistant" | "tool";
-    /** 消息内容 */
-    content: string;
-    /** 工具调用（仅 assistant 角色） */
-    toolCalls?: ToolCall[];
-    /** 工具调用 ID（仅 tool 角色） */
-    toolCallId?: string;
-    /** 名称（用于 function 调用） */
-    name?: string;
-}
-/**
- * Tool Call (OpenAI format)
- */
-export interface ToolCall {
-    /** 工具调用 ID */
-    id: string;
-    /** 工具名称 */
-    name: string;
-    /** 工具参数（JSON 字符串） */
-    arguments: string;
-    /** OpenAI 格式的 function 对象 */
-    function?: {
-        /** 函数名称 */
-        name: string;
-        /** 函数参数（JSON 字符串） */
-        arguments: string;
-    };
-}
-/**
- * Tool Result
- */
-export interface ToolResult {
-    /** 对应的工具调用 ID */
-    toolCallId: string;
-    /** 工具执行结果 */
-    result: string;
-    /** 是否为错误 */
-    isError?: boolean;
-}
-/**
- * Usage Information
- */
-export interface UsageInfo {
-    /** Prompt Token 数 */
-    promptTokens: number;
-    /** Completion Token 数 */
-    completionTokens: number;
-    /** 总 Token 数 */
-    totalTokens: number;
-}
-/**
- * LLM Output
- */
-export interface LLMOutput {
-    /** 生成的内容 */
-    content: string;
-    /** 推理/思考内容（支持 reasoning 模型的输出） */
-    reasoning?: string;
-    /** 完成原因 */
-    finishReason: "stop" | "length" | "content-filter" | "tool-calls" | "function-call";
-    /** 工具调用 */
-    toolCalls?: ToolCall[];
-    /** Usage 信息 */
-    usage?: UsageInfo;
-    /** 生成模型 */
-    model?: string;
-}
-/**
- * Provider 类型
- */
-export type ProviderType = "openai" | "anthropic" | "google" | "openai-compatible";
-/**
- * Provider 能力配置
- */
-export interface ProviderCapabilities {
-    /** 支持推理（CoT） */
-    reasoning?: boolean;
-    /** 支持工具调用 */
-    toolcall?: boolean;
-    /** 混合内容字段（用于解析推理内容） */
-    interleaved?: {
-        /** 字段名 */
-        field: string;
-    };
-    /** 文本内思考标签配置 */
-    thinkingInText?: {
-        /** 是否启用 */
-        enabled?: boolean;
-        /** 标签列表 */
-        tags?: string[];
-        /** 是否从输出中移除标签内容 */
-        removeFromOutput?: boolean;
-    };
-}
-/**
- * 模型限制配置
- */
-export interface ModelLimits {
-    /** 上下文窗口大小（Token 数） */
-    contextWindow: number;
-    /** 压缩阈值（0-1），超过此比例触发上下文压缩 */
-    compactionThreshold?: number;
-    /** 最大输出 Token 数 */
-    maxOutputTokens?: number;
-}
-/**
- * Provider 配置
- */
-export interface ProviderConfig {
-    /** Provider 类型 */
-    provider: ProviderType | string;
-    /** Provider 名称 */
-    name?: string;
-    /** Provider 描述 */
-    description?: string;
-    /** API Key */
-    apiKey: string;
-    /** Base URL（可选，用于代理或兼容 API） */
-    baseURL?: string;
-    /** 支持的模型列表 */
-    models?: string[];
-    /** Provider 默认模型 */
-    defaultModel?: string;
-    /** Provider 默认温度参数 */
-    temperature?: number;
-    /** Provider 默认最大 Token 数 */
-    maxTokens?: number;
-    /** Provider 能力配置 */
-    capabilities?: ProviderCapabilities;
-    /** 模型限制配置（按模型 ID 索引） */
-    limits?: Record<string, ModelLimits>;
-    /** Provider 特定选项（如 __dangerous__） */
-    providerOptions?: Record<string, unknown>;
-    /** 其他配置 */
-    options?: Record<string, unknown>;
-}
-/**
- * LLM Provider 实例（由 AI SDK 创建）
- */
-export interface LLMProvider {
-    /** Provider ID */
-    id: string;
-    /** Provider 实例 */
-    provider: unknown;
-    /** 支持的模型 */
-    models: string[];
-    /** Provider 配置 */
-    config?: ProviderConfig;
-}
-/**
- * 全局默认配置
- */
-export interface LLMDefaultConfig {
-    /** 默认温度参数 */
-    temperature?: number;
-    /** 默认最大 Token 数 */
-    maxTokens?: number;
-}
-/**
- * LLM Config
- */
-export interface LLMConfig {
-    /** 全局默认配置 */
-    default?: LLMDefaultConfig;
-    /** 默认模型 */
-    defaultModel?: string;
-    /** Provider 配置映射 */
-    providers: Record<string, ProviderConfig>;
-    /** 默认 Provider */
-    defaultProvider: string;
-    /** 温度参数（全局覆盖） */
-    temperature?: number;
-    /** 最大 Token 数（全局覆盖） */
-    maxTokens?: number;
-    /** Top P（全局覆盖） */
-    topP?: number;
-    /** 是否流式输出 */
-    stream?: boolean;
-    /** 其他配置 */
-    options?: Record<string, unknown>;
-}
-/**
- * ProviderCapabilities Zod Schema
- */
-export declare const ProviderCapabilitiesSchema: z.ZodObject<{
-    reasoning: z.ZodOptional<z.ZodBoolean>;
-    toolcall: z.ZodOptional<z.ZodBoolean>;
-    interleaved: z.ZodOptional<z.ZodObject<{
-        field: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        field?: string;
-    }, {
-        field?: string;
-    }>>;
-    thinkingInText: z.ZodOptional<z.ZodObject<{
-        enabled: z.ZodOptional<z.ZodBoolean>;
-        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        removeFromOutput: z.ZodOptional<z.ZodBoolean>;
-    }, "strip", z.ZodTypeAny, {
-        enabled?: boolean;
-        tags?: string[];
-        removeFromOutput?: boolean;
-    }, {
-        enabled?: boolean;
-        tags?: string[];
-        removeFromOutput?: boolean;
-    }>>;
-}, "strip", z.ZodTypeAny, {
-    reasoning?: boolean;
-    toolcall?: boolean;
-    interleaved?: {
-        field?: string;
-    };
-    thinkingInText?: {
-        enabled?: boolean;
-        tags?: string[];
-        removeFromOutput?: boolean;
-    };
-}, {
-    reasoning?: boolean;
-    toolcall?: boolean;
-    interleaved?: {
-        field?: string;
-    };
-    thinkingInText?: {
-        enabled?: boolean;
-        tags?: string[];
-        removeFromOutput?: boolean;
-    };
-}>;
-/**
- * ModelLimits Zod Schema
- */
-export declare const ModelLimitsSchema: z.ZodObject<{
-    contextWindow: z.ZodNumber;
-    compactionThreshold: z.ZodOptional<z.ZodNumber>;
-    maxOutputTokens: z.ZodOptional<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-    contextWindow?: number;
-    compactionThreshold?: number;
-    maxOutputTokens?: number;
-}, {
-    contextWindow?: number;
-    compactionThreshold?: number;
-    maxOutputTokens?: number;
-}>;
-/**
- * ProviderConfig Zod Schema
- */
-export declare const ProviderConfigSchema: z.ZodObject<{
-    provider: z.ZodString;
-    name: z.ZodOptional<z.ZodString>;
-    description: z.ZodOptional<z.ZodString>;
-    apiKey: z.ZodString;
-    baseURL: z.ZodOptional<z.ZodString>;
-    models: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    defaultModel: z.ZodOptional<z.ZodString>;
-    temperature: z.ZodOptional<z.ZodNumber>;
-    maxTokens: z.ZodOptional<z.ZodNumber>;
-    capabilities: z.ZodOptional<z.ZodObject<{
-        reasoning: z.ZodOptional<z.ZodBoolean>;
-        toolcall: z.ZodOptional<z.ZodBoolean>;
-        interleaved: z.ZodOptional<z.ZodObject<{
-            field: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            field?: string;
-        }, {
-            field?: string;
-        }>>;
-        thinkingInText: z.ZodOptional<z.ZodObject<{
-            enabled: z.ZodOptional<z.ZodBoolean>;
-            tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-            removeFromOutput: z.ZodOptional<z.ZodBoolean>;
-        }, "strip", z.ZodTypeAny, {
-            enabled?: boolean;
-            tags?: string[];
-            removeFromOutput?: boolean;
-        }, {
-            enabled?: boolean;
-            tags?: string[];
-            removeFromOutput?: boolean;
-        }>>;
-    }, "strip", z.ZodTypeAny, {
-        reasoning?: boolean;
-        toolcall?: boolean;
-        interleaved?: {
-            field?: string;
-        };
-        thinkingInText?: {
-            enabled?: boolean;
-            tags?: string[];
-            removeFromOutput?: boolean;
-        };
-    }, {
-        reasoning?: boolean;
-        toolcall?: boolean;
-        interleaved?: {
-            field?: string;
-        };
-        thinkingInText?: {
-            enabled?: boolean;
-            tags?: string[];
-            removeFromOutput?: boolean;
-        };
-    }>>;
-    limits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
-        contextWindow: z.ZodNumber;
-        compactionThreshold: z.ZodOptional<z.ZodNumber>;
-        maxOutputTokens: z.ZodOptional<z.ZodNumber>;
-    }, "strip", z.ZodTypeAny, {
-        contextWindow?: number;
-        compactionThreshold?: number;
-        maxOutputTokens?: number;
-    }, {
-        contextWindow?: number;
-        compactionThreshold?: number;
-        maxOutputTokens?: number;
-    }>>>;
-    providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, "strip", z.ZodTypeAny, {
-    name?: string;
-    options?: Record<string, unknown>;
-    provider?: string;
-    description?: string;
-    apiKey?: string;
-    baseURL?: string;
-    models?: string[];
-    defaultModel?: string;
-    temperature?: number;
-    maxTokens?: number;
-    capabilities?: {
-        reasoning?: boolean;
-        toolcall?: boolean;
-        interleaved?: {
-            field?: string;
-        };
-        thinkingInText?: {
-            enabled?: boolean;
-            tags?: string[];
-            removeFromOutput?: boolean;
-        };
-    };
-    limits?: Record<string, {
-        contextWindow?: number;
-        compactionThreshold?: number;
-        maxOutputTokens?: number;
-    }>;
-    providerOptions?: Record<string, unknown>;
-}, {
-    name?: string;
-    options?: Record<string, unknown>;
-    provider?: string;
-    description?: string;
-    apiKey?: string;
-    baseURL?: string;
-    models?: string[];
-    defaultModel?: string;
-    temperature?: number;
-    maxTokens?: number;
-    capabilities?: {
-        reasoning?: boolean;
-        toolcall?: boolean;
-        interleaved?: {
-            field?: string;
-        };
-        thinkingInText?: {
-            enabled?: boolean;
-            tags?: string[];
-            removeFromOutput?: boolean;
-        };
-    };
-    limits?: Record<string, {
-        contextWindow?: number;
-        compactionThreshold?: number;
-        maxOutputTokens?: number;
-    }>;
-    providerOptions?: Record<string, unknown>;
-}>;
-/**
- * LLMDefaultConfig Zod Schema
- */
-export declare const LLMDefaultConfigSchema: z.ZodObject<{
-    temperature: z.ZodOptional<z.ZodNumber>;
-    maxTokens: z.ZodOptional<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-    temperature?: number;
-    maxTokens?: number;
-}, {
-    temperature?: number;
-    maxTokens?: number;
-}>;
-/**
- * LLMConfig Zod Schema
- */
-export declare const LLMConfigSchema: z.ZodObject<{
-    default: z.ZodOptional<z.ZodObject<{
-        temperature: z.ZodOptional<z.ZodNumber>;
-        maxTokens: z.ZodOptional<z.ZodNumber>;
-    }, "strip", z.ZodTypeAny, {
-        temperature?: number;
-        maxTokens?: number;
-    }, {
-        temperature?: number;
-        maxTokens?: number;
-    }>>;
-    defaultModel: z.ZodOptional<z.ZodString>;
-    providers: z.ZodRecord<z.ZodString, z.ZodObject<{
-        provider: z.ZodString;
-        name: z.ZodOptional<z.ZodString>;
-        description: z.ZodOptional<z.ZodString>;
-        apiKey: z.ZodString;
-        baseURL: z.ZodOptional<z.ZodString>;
-        models: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        defaultModel: z.ZodOptional<z.ZodString>;
-        temperature: z.ZodOptional<z.ZodNumber>;
-        maxTokens: z.ZodOptional<z.ZodNumber>;
-        capabilities: z.ZodOptional<z.ZodObject<{
-            reasoning: z.ZodOptional<z.ZodBoolean>;
-            toolcall: z.ZodOptional<z.ZodBoolean>;
-            interleaved: z.ZodOptional<z.ZodObject<{
-                field: z.ZodString;
-            }, "strip", z.ZodTypeAny, {
-                field?: string;
-            }, {
-                field?: string;
-            }>>;
-            thinkingInText: z.ZodOptional<z.ZodObject<{
-                enabled: z.ZodOptional<z.ZodBoolean>;
-                tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-                removeFromOutput: z.ZodOptional<z.ZodBoolean>;
-            }, "strip", z.ZodTypeAny, {
-                enabled?: boolean;
-                tags?: string[];
-                removeFromOutput?: boolean;
-            }, {
-                enabled?: boolean;
-                tags?: string[];
-                removeFromOutput?: boolean;
-            }>>;
-        }, "strip", z.ZodTypeAny, {
-            reasoning?: boolean;
-            toolcall?: boolean;
-            interleaved?: {
-                field?: string;
-            };
-            thinkingInText?: {
-                enabled?: boolean;
-                tags?: string[];
-                removeFromOutput?: boolean;
-            };
-        }, {
-            reasoning?: boolean;
-            toolcall?: boolean;
-            interleaved?: {
-                field?: string;
-            };
-            thinkingInText?: {
-                enabled?: boolean;
-                tags?: string[];
-                removeFromOutput?: boolean;
-            };
-        }>>;
-        limits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
-            contextWindow: z.ZodNumber;
-            compactionThreshold: z.ZodOptional<z.ZodNumber>;
-            maxOutputTokens: z.ZodOptional<z.ZodNumber>;
-        }, "strip", z.ZodTypeAny, {
-            contextWindow?: number;
-            compactionThreshold?: number;
-            maxOutputTokens?: number;
-        }, {
-            contextWindow?: number;
-            compactionThreshold?: number;
-            maxOutputTokens?: number;
-        }>>>;
-        providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    }, "strip", z.ZodTypeAny, {
-        name?: string;
-        options?: Record<string, unknown>;
-        provider?: string;
-        description?: string;
-        apiKey?: string;
-        baseURL?: string;
-        models?: string[];
-        defaultModel?: string;
-        temperature?: number;
-        maxTokens?: number;
-        capabilities?: {
-            reasoning?: boolean;
-            toolcall?: boolean;
-            interleaved?: {
-                field?: string;
-            };
-            thinkingInText?: {
-                enabled?: boolean;
-                tags?: string[];
-                removeFromOutput?: boolean;
-            };
-        };
-        limits?: Record<string, {
-            contextWindow?: number;
-            compactionThreshold?: number;
-            maxOutputTokens?: number;
-        }>;
-        providerOptions?: Record<string, unknown>;
-    }, {
-        name?: string;
-        options?: Record<string, unknown>;
-        provider?: string;
-        description?: string;
-        apiKey?: string;
-        baseURL?: string;
-        models?: string[];
-        defaultModel?: string;
-        temperature?: number;
-        maxTokens?: number;
-        capabilities?: {
-            reasoning?: boolean;
-            toolcall?: boolean;
-            interleaved?: {
-                field?: string;
-            };
-            thinkingInText?: {
-                enabled?: boolean;
-                tags?: string[];
-                removeFromOutput?: boolean;
-            };
-        };
-        limits?: Record<string, {
-            contextWindow?: number;
-            compactionThreshold?: number;
-            maxOutputTokens?: number;
-        }>;
-        providerOptions?: Record<string, unknown>;
-    }>>;
-    defaultProvider: z.ZodString;
-    temperature: z.ZodDefault<z.ZodNumber>;
-    maxTokens: z.ZodOptional<z.ZodNumber>;
-    topP: z.ZodOptional<z.ZodNumber>;
-    stream: z.ZodDefault<z.ZodBoolean>;
-    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, "strip", z.ZodTypeAny, {
-    options?: Record<string, unknown>;
-    defaultModel?: string;
-    temperature?: number;
-    maxTokens?: number;
-    default?: {
-        temperature?: number;
-        maxTokens?: number;
-    };
-    providers?: Record<string, {
-        name?: string;
-        options?: Record<string, unknown>;
-        provider?: string;
-        description?: string;
-        apiKey?: string;
-        baseURL?: string;
-        models?: string[];
-        defaultModel?: string;
-        temperature?: number;
-        maxTokens?: number;
-        capabilities?: {
-            reasoning?: boolean;
-            toolcall?: boolean;
-            interleaved?: {
-                field?: string;
-            };
-            thinkingInText?: {
-                enabled?: boolean;
-                tags?: string[];
-                removeFromOutput?: boolean;
-            };
-        };
-        limits?: Record<string, {
-            contextWindow?: number;
-            compactionThreshold?: number;
-            maxOutputTokens?: number;
-        }>;
-        providerOptions?: Record<string, unknown>;
-    }>;
-    defaultProvider?: string;
-    topP?: number;
-    stream?: boolean;
-}, {
-    options?: Record<string, unknown>;
-    defaultModel?: string;
-    temperature?: number;
-    maxTokens?: number;
-    default?: {
-        temperature?: number;
-        maxTokens?: number;
-    };
-    providers?: Record<string, {
-        name?: string;
-        options?: Record<string, unknown>;
-        provider?: string;
-        description?: string;
-        apiKey?: string;
-        baseURL?: string;
-        models?: string[];
-        defaultModel?: string;
-        temperature?: number;
-        maxTokens?: number;
-        capabilities?: {
-            reasoning?: boolean;
-            toolcall?: boolean;
-            interleaved?: {
-                field?: string;
-            };
-            thinkingInText?: {
-                enabled?: boolean;
-                tags?: string[];
-                removeFromOutput?: boolean;
-            };
-        };
-        limits?: Record<string, {
-            contextWindow?: number;
-            compactionThreshold?: number;
-            maxOutputTokens?: number;
-        }>;
-        providerOptions?: Record<string, unknown>;
-    }>;
-    defaultProvider?: string;
-    topP?: number;
-    stream?: boolean;
-}>;
-/**
- * LLM Invoke 请求
- */
-export interface LLMInvokeRequest {
-    /** 消息列表 */
-    messages: LLMMessage[];
-    /** Provider ID（可选，默认使用配置的默认 Provider） */
-    providerId?: string;
-    /** 模型（可选，默认使用配置的默认模型） */
-    model?: string;
-    /** 工具列表 */
-    tools?: ToolInfo[];
-    /** 温度参数 */
-    temperature?: number;
-    /** 最大 Token 数 */
-    maxTokens?: number;
-    /** Top P */
-    topP?: number;
-    /** 工具选择策略 */
-    toolChoice?: "auto" | "none" | {
-        type: "function";
-        function: {
-            name: string;
-        };
-    };
-    /** 停止序列 */
-    stopSequences?: string[];
-    /** Abort Signal */
-    abortSignal?: AbortSignal;
-    /** 调用上下文（用于事件元数据） */
-    context?: LLMInvokeContext;
-    /** 跳过上下文阈值检查（用于 SummaryAgent 等内部调用，避免循环触发压缩） */
-    skipThresholdCheck?: boolean;
-}
-/**
- * LLM Invoke 结果
- */
-export interface LLMInvokeResult {
-    /** LLM 输出 */
-    output: LLMOutput;
-    /** 使用的 Provider ID */
-    providerId: string;
-    /** 使用的模型 */
-    model: string;
-    /** 调用延迟（毫秒） */
-    latencyMs: number;
-}
-/**
- * Stream 事件类型
- */
-export type StreamEventType = "start" | "text" | "reasoning" | "tool-call" | "tool-result" | "finish" | "error";
-/**
- * Stream 事件
- */
-export interface StreamEvent {
-    /** 事件类型 */
-    type: StreamEventType;
-    /** 文本内容（type=text 时） */
-    content?: string;
-    /** Delta 内容（type=text 时） */
-    delta?: string;
-    /** 推理内容（type=reasoning 时） */
-    reasoning?: string;
-    /** 工具调用（type=tool-call 时） */
-    toolCall?: {
-        id: string;
-        name: string;
-        arguments: string;
-    };
-    /** 工具结果（type=tool-result 时） */
-    toolResult?: {
-        id: string;
-        result: string;
-    };
-    /** 完成原因（type=finish 时） */
-    finishReason?: "stop" | "length" | "content-filter" | "tool-calls";
-    /** Usage 信息（type=finish 时） */
-    usage?: UsageInfo;
-    /** 错误信息（type=error 时） */
-    error?: string;
-}
-/**
- * Tool Info（用于 LLM 工具调用）
- */
-export interface ToolInfo {
-    /** 工具名称 */
-    name: string;
-    /** 工具描述 */
-    description?: string;
-    /** 工具参数 Schema */
-    parameters: Record<string, unknown>;
-}
-/**
- * LLM 调用上下文（用于事件元数据）
- */
-export interface LLMInvokeContext {
-    /** Session ID */
-    sessionId?: string;
-    /** Message ID */
-    messageId?: string;
-}
-/**
- * LLM 流式事件类型（用于通过 env.pushEnvEvent 发布）
- *
- * 这些事件会被包装成 EnvEvent 格式发布，事件类型为 `llm.${event.type}`
- */
-export type LLMStreamEvent = {
-    type: "start";
-    metadata: {
-        model: string;
-    };
-} | {
-    type: "text";
-    content: string;
-    delta: string;
-} | {
-    type: "reasoning";
-    content: string;
-} | {
-    type: "tool_call";
-    toolCall: {
-        id: string;
-        name: string;
-        arguments: string;
-    };
-} | {
-    type: "completed";
-    content: string;
-    metadata: {
-        model: string;
-        usage?: UsageInfo;
-    };
-} | {
-    type: "error";
-    error: string;
-};
-//# sourceMappingURL=types.d.ts.map