@fllf/agent-sdk 0.1.2 → 0.1.3

package/dist/llm/providers/openai-compatible.js

@@ -5,13 +5,21 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OpenAICompatibleProvider = void 0;
 const openai_1 = __importDefault(require("openai"));
+const errors_1 = require("../../errors");
+const content_1 = require("../../messages/content");
+const tool_arguments_1 = require("../tool-arguments");
 class OpenAICompatibleProvider {
     name;
     model;
     client;
     constructor(name, config) {
         if (!config.apiKey) {
-            throw new Error(`${name} provider requires an apiKey.`);
+            throw new errors_1.ConfigError(`${name} provider requires an apiKey.`, {
+                code: 'missing_provider_api_key',
+                metadata: {
+                    providerName: name,
+                },
+            });
         }
         this.name = name;
         this.model = config.model ?? 'gpt-4o-mini';
@@ -31,9 +39,17 @@ class OpenAICompatibleProvider {
             vision: true,
         };
     }
+    /**
+     * OpenAI 官方端点已弃用 max_tokens（o 系列直接报错），
+     * 但部分本地 OpenAI-compatible 服务尚未支持 max_completion_tokens。
+     * 因此只对官方 openai provider 使用新参数。
+     */
+    useMaxCompletionTokens() {
+        return this.name === 'openai';
+    }
     async chat(request) {
         const body = {
-            ...buildOpenAIChatBody(request, this.model),
+            ...this.buildChatBody(request),
             stream: false,
         };
         const completion = request.signal
@@ -47,6 +63,10 @@ class OpenAICompatibleProvider {
             toolCalls: (message?.tool_calls ?? []).map(toChatToolCall),
             raw: completion,
         };
+        const finishReason = toFinishReason(choice?.finish_reason);
+        if (finishReason !== undefined) {
+            response.finishReason = finishReason;
+        }
         const usage = toTokenUsage(completion.usage);
         if (usage !== undefined) {
             response.usage = usage;
@@ -55,8 +75,9 @@ class OpenAICompatibleProvider {
     }
     async *stream(request) {
         const body = {
-            ...buildOpenAIChatBody(request, this.model),
+            ...this.buildChatBody(request),
             stream: true,
+            stream_options: { include_usage: true },
         };
         const stream = request.signal
             ? await this.client.chat.completions.create(body, { signal: request.signal })
@@ -65,50 +86,73 @@ class OpenAICompatibleProvider {
             yield toChatStreamChunk(chunk);
         }
     }
-}
-exports.OpenAICompatibleProvider = OpenAICompatibleProvider;
-function buildOpenAIChatBody(request, defaultModel) {
-    const body = {
-        model: request.model ?? defaultModel,
-        messages: request.messages.map(toOpenAIMessage),
-    };
-    if (request.temperature !== undefined) {
-        body.temperature = request.temperature;
-    }
-    if (request.maxTokens !== undefined) {
-        body.max_tokens = request.maxTokens;
-    }
-    if (request.tools !== undefined) {
-        body.tools = request.tools;
-    }
-    if (request.toolChoice !== undefined) {
-        body.tool_choice = request.toolChoice;
-    }
-    if (request.responseFormat !== undefined) {
-        body.response_format = {
-            type: 'json_schema',
-            json_schema: {
-                name: request.responseFormat.jsonSchema.name,
-                description: request.responseFormat.jsonSchema.description,
-                schema: request.responseFormat.jsonSchema.schema,
-                strict: request.responseFormat.jsonSchema.strict,
-            },
+    buildChatBody(request) {
+        const body = {
+            model: request.model ?? this.model,
+            messages: request.messages.map(toOpenAIMessage),
         };
+        if (request.temperature !== undefined) {
+            body.temperature = request.temperature;
+        }
+        if (request.maxTokens !== undefined) {
+            if (this.useMaxCompletionTokens()) {
+                body.max_completion_tokens = request.maxTokens;
+            }
+            else {
+                body.max_tokens = request.maxTokens;
+            }
+        }
+        if (request.tools !== undefined) {
+            body.tools = request.tools.map((tool) => ({
+                type: 'function',
+                function: {
+                    name: tool.name,
+                    description: tool.description,
+                    strict: tool.strict,
+                    parameters: tool.parameters,
+                },
+            }));
+        }
+        if (request.toolChoice !== undefined) {
+            body.tool_choice = (typeof request.toolChoice === 'object'
+                ? { type: 'function', function: { name: request.toolChoice.name } }
+                : request.toolChoice);
+        }
+        if (request.reasoning !== undefined) {
+            // OpenAI 只认识 minimal/low/medium/high；更高档位就地降级为 high。
+            const effort = request.reasoning.effort;
+            body.reasoning_effort = effort === 'xhigh' || effort === 'max'
+                ? 'high'
+                : effort;
+        }
+        if (request.responseFormat !== undefined) {
+            body.response_format = {
+                type: 'json_schema',
+                json_schema: {
+                    name: request.responseFormat.jsonSchema.name,
+                    description: request.responseFormat.jsonSchema.description,
+                    schema: request.responseFormat.jsonSchema.schema,
+                    strict: request.responseFormat.jsonSchema.strict,
+                },
+            };
+        }
+        return body;
     }
-    return body;
 }
+exports.OpenAICompatibleProvider = OpenAICompatibleProvider;
 function toOpenAIMessage(message) {
     if (message.role === 'tool') {
+        // OpenAI 的 tool 消息只接受字符串 content，非文本 block 降级为占位符。
         return {
             role: 'tool',
-            content: message.content,
+            content: (0, content_1.contentToText)(message.content),
             tool_call_id: message.toolCallId ?? '',
         };
     }
     if (message.role === 'assistant' && message.toolCalls?.length) {
         return {
             role: 'assistant',
-            content: message.content,
+            content: (0, content_1.contentToText)(message.content),
             tool_calls: message.toolCalls.map((toolCall) => ({
                 id: toolCall.id,
                 type: 'function',
@@ -119,9 +163,33 @@ function toOpenAIMessage(message) {
             })),
         };
     }
+    if (message.role === 'user') {
+        return {
+            role: 'user',
+            content: toOpenAIUserContent(message.content),
+        };
+    }
     return {
         role: message.role,
-        content: message.content,
+        content: (0, content_1.contentToText)(message.content),
+    };
+}
+function toOpenAIUserContent(content) {
+    if (typeof content === 'string') {
+        return content;
+    }
+    return content.map(toOpenAIContentPart);
+}
+function toOpenAIContentPart(block) {
+    if (block.type === 'text') {
+        return { type: 'text', text: block.text };
+    }
+    const url = block.source.kind === 'url'
+        ? block.source.url
+        : `data:${block.source.mediaType};base64,${block.source.data}`;
+    return {
+        type: 'image_url',
+        image_url: { url },
     };
 }
 function toChatToolCall(toolCall) {
@@ -135,11 +203,12 @@ function toChatToolCall(toolCall) {
     return {
         id: toolCall.id,
         name: toolCall.function.name,
-        arguments: parseToolArguments(toolCall.function.arguments),
+        arguments: (0, tool_arguments_1.parseToolArguments)(toolCall.function.arguments),
     };
 }
 function toChatStreamChunk(chunk) {
-    const delta = chunk.choices[0]?.delta;
+    const choice = chunk.choices[0];
+    const delta = choice?.delta;
     const streamChunk = {
         raw: chunk,
     };
@@ -147,30 +216,65 @@ function toChatStreamChunk(chunk) {
         streamChunk.contentDelta = delta.content;
     }
     if (delta?.tool_calls !== undefined && delta.tool_calls.length > 0) {
-        streamChunk.toolCallDelta = delta.tool_calls;
+        streamChunk.toolCallDeltas = delta.tool_calls.map(toToolCallDelta);
+    }
+    const finishReason = toFinishReason(choice?.finish_reason);
+    if (finishReason !== undefined) {
+        streamChunk.finishReason = finishReason;
+    }
+    // include_usage 模式下 usage 出现在最后一个 choices 为空的 chunk 上。
+    const usage = toTokenUsage(chunk.usage);
+    if (usage !== undefined) {
+        streamChunk.usage = usage;
     }
     return streamChunk;
 }
-function parseToolArguments(rawArguments) {
-    try {
-        const parsed = JSON.parse(rawArguments);
-        return isRecord(parsed) ? parsed : { value: parsed };
+function toToolCallDelta(delta) {
+    const toolCallDelta = {
+        index: delta.index,
+    };
+    if (delta.id !== undefined) {
+        toolCallDelta.id = delta.id;
     }
-    catch {
-        return { raw: rawArguments };
+    if (delta.function?.name !== undefined) {
+        toolCallDelta.name = delta.function.name;
     }
+    if (delta.function?.arguments !== undefined) {
+        toolCallDelta.argumentsDelta = delta.function.arguments;
+    }
+    return toolCallDelta;
 }
-function isRecord(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
+function toFinishReason(reason) {
+    switch (reason) {
+        case undefined:
+        case null:
+            return undefined;
+        case 'stop':
+            return 'stop';
+        case 'tool_calls':
+        case 'function_call':
+            return 'tool_calls';
+        case 'length':
+            return 'length';
+        case 'content_filter':
+            return 'content_filter';
+        default:
+            return 'other';
+    }
 }
 function toTokenUsage(usage) {
     if (!usage) {
         return undefined;
     }
-    return {
+    const tokenUsage = {
         promptTokens: usage.prompt_tokens,
         completionTokens: usage.completion_tokens,
         totalTokens: usage.total_tokens,
     };
+    const cachedTokens = usage.prompt_tokens_details?.cached_tokens;
+    if (cachedTokens !== undefined) {
+        tokenUsage.cachedPromptTokens = cachedTokens;
+    }
+    return tokenUsage;
 }
 //# sourceMappingURL=openai-compatible.js.map

package/dist/llm/providers/openai-compatible.js.map

@@ -1 +1 @@
-{"version":3,"file":"openai-compatible.js","sourceRoot":"","sources":["../../../src/llm/providers/openai-compatible.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"openai-compatible.js","sourceRoot":"","sources":["../../../src/llm/providers/openai-compatible.ts"],"names":[],"mappings":"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"}

package/dist/llm/stream-accumulator.d.ts

@@ -0,0 +1,17 @@
+import type { ChatResponse, ChatStreamChunk } from './types';
+/**
+ * 把 ChatStreamChunk 序列聚合成一个完整的 ChatResponse。
+ * 消费方不需要理解 provider 的增量协议：逐个 add() 之后调 toResponse()。
+ */
+export declare class ChatStreamAccumulator {
+    private content;
+    private reasoning;
+    private readonly toolCalls;
+    private finishReason;
+    private usage;
+    private raw;
+    add(chunk: ChatStreamChunk): void;
+    toResponse(): ChatResponse;
+    private toChatToolCalls;
+}
+//# sourceMappingURL=stream-accumulator.d.ts.map

package/dist/llm/stream-accumulator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-accumulator.d.ts","sourceRoot":"","sources":["../../src/llm/stream-accumulator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAER,YAAY,EACZ,eAAe,EAGlB,MAAM,SAAS,CAAC;AAQjB;;;GAGG;AACH,qBAAa,qBAAqB;IAC9B,OAAO,CAAC,OAAO,CAAM;IACrB,OAAO,CAAC,SAAS,CAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsC;IAChE,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,GAAG,CAAU;IAErB,GAAG,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAuCjC,UAAU,IAAI,YAAY;IAwB1B,OAAO,CAAC,eAAe;CAW1B"}

package/dist/llm/stream-accumulator.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChatStreamAccumulator = void 0;
+const tool_arguments_1 = require("./tool-arguments");
+/**
+ * 把 ChatStreamChunk 序列聚合成一个完整的 ChatResponse。
+ * 消费方不需要理解 provider 的增量协议：逐个 add() 之后调 toResponse()。
+ */
+class ChatStreamAccumulator {
+    content = '';
+    reasoning = '';
+    toolCalls = new Map();
+    finishReason;
+    usage;
+    raw;
+    add(chunk) {
+        if (chunk.contentDelta !== undefined) {
+            this.content += chunk.contentDelta;
+        }
+        if (chunk.reasoningDelta !== undefined) {
+            this.reasoning += chunk.reasoningDelta;
+        }
+        for (const delta of chunk.toolCallDeltas ?? []) {
+            const pending = this.toolCalls.get(delta.index) ?? {
+                id: undefined,
+                name: undefined,
+                argumentsJson: '',
+            };
+            if (delta.id !== undefined) {
+                pending.id = delta.id;
+            }
+            if (delta.name !== undefined) {
+                pending.name = delta.name;
+            }
+            if (delta.argumentsDelta !== undefined) {
+                pending.argumentsJson += delta.argumentsDelta;
+            }
+            this.toolCalls.set(delta.index, pending);
+        }
+        if (chunk.finishReason !== undefined) {
+            this.finishReason = chunk.finishReason;
+        }
+        if (chunk.usage !== undefined) {
+            this.usage = chunk.usage;
+        }
+        if (chunk.raw !== undefined) {
+            this.raw = chunk.raw;
+        }
+    }
+    toResponse() {
+        const response = {
+            role: 'assistant',
+            content: this.content,
+            toolCalls: this.toChatToolCalls(),
+        };
+        if (this.reasoning.length > 0) {
+            response.reasoning = this.reasoning;
+        }
+        if (this.finishReason !== undefined) {
+            response.finishReason = this.finishReason;
+        }
+        if (this.usage !== undefined) {
+            response.usage = this.usage;
+        }
+        if (this.raw !== undefined) {
+            response.raw = this.raw;
+        }
+        return response;
+    }
+    toChatToolCalls() {
+        return [...this.toolCalls.entries()]
+            .sort(([left], [right]) => left - right)
+            .map(([index, pending]) => ({
+            id: pending.id ?? `tool_call_${index}`,
+            name: pending.name ?? '',
+            arguments: pending.argumentsJson.length > 0
+                ? (0, tool_arguments_1.parseToolArguments)(pending.argumentsJson)
+                : {},
+        }));
+    }
+}
+exports.ChatStreamAccumulator = ChatStreamAccumulator;
+//# sourceMappingURL=stream-accumulator.js.map

package/dist/llm/stream-accumulator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-accumulator.js","sourceRoot":"","sources":["../../src/llm/stream-accumulator.ts"],"names":[],"mappings":"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"}

package/dist/llm/tool-arguments.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 模型返回的工具参数是未可信的 JSON 字符串。
+ * 解析失败时保留原始文本，让工具的 schema 校验产生明确的错误反馈。
+ */
+export declare function parseToolArguments(rawArguments: string): Record<string, unknown>;
+//# sourceMappingURL=tool-arguments.d.ts.map

package/dist/llm/tool-arguments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-arguments.d.ts","sourceRoot":"","sources":["../../src/llm/tool-arguments.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOhF"}

package/dist/llm/tool-arguments.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseToolArguments = parseToolArguments;
+/**
+ * 模型返回的工具参数是未可信的 JSON 字符串。
+ * 解析失败时保留原始文本，让工具的 schema 校验产生明确的错误反馈。
+ */
+function parseToolArguments(rawArguments) {
+    try {
+        const parsed = JSON.parse(rawArguments);
+        return isRecord(parsed) ? parsed : { value: parsed };
+    }
+    catch {
+        return { raw: rawArguments };
+    }
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=tool-arguments.js.map

package/dist/llm/tool-arguments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-arguments.js","sourceRoot":"","sources":["../../src/llm/tool-arguments.ts"],"names":[],"mappings":";;AAIA,gDAOC;AAXD;;;GAGG;AACH,SAAgB,kBAAkB,CAAC,YAAoB;IACnD,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QACxC,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,CAAC;IACjC,CAAC;AACL,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC5B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAChF,CAAC"}

package/dist/llm/types.d.ts

@@ -1,3 +1,4 @@
+import type { MessageContent } from '../messages/content';
 import type { MessageRole } from '../messages/types';
 import type { TraceContext } from '../observability';
 import type { ZodType } from 'zod';
@@ -21,7 +22,25 @@ export interface LLMRuntimeConfig {
 }
 export interface LLMConfig extends ProviderConfig, LLMRuntimeConfig {
     provider?: ModelProviderName;
+    providerRegistry?: ModelProviderResolver;
 }
+export interface ModelProviderResolver {
+    autoDetect(config?: ProviderConfig): ChatModel;
+    create(providerName: ModelProviderName, config?: ProviderConfig): ChatModel;
+}
+/**
+ * provider 中立的工具定义。各 provider 自行映射到自家 wire 格式
+ * （OpenAI 包一层 {type:'function', function}，Anthropic 用 input_schema）。
+ */
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+    strict?: boolean | undefined;
+}
+/**
+ * @deprecated OpenAI 特有形状，仅为兼容保留；请使用 ToolDefinition。
+ */
 export interface ChatToolSchema {
     type: 'function';
     function: {
@@ -38,18 +57,34 @@ export interface ChatToolCall {
 }
 export interface ChatMessage {
     role: MessageRole;
-    content: string;
+    content: MessageContent;
     toolCallId?: string | undefined;
     toolCalls?: ChatToolCall[] | undefined;
+    /**
+     * prompt cache 断点提示。支持缓存的 provider（如 Anthropic 的
+     * cache_control）会在该消息处打断点；其余 provider 忽略。
+     */
+    cacheControl?: 'ephemeral' | undefined;
     metadata?: Record<string, unknown> | undefined;
 }
+export type ReasoningEffort = 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max';
 export interface ChatRequest {
     messages: ChatMessage[];
     model?: string;
     temperature?: number;
     maxTokens?: number;
-    tools?: ChatToolSchema[];
-    toolChoice?: 'auto' | 'none' | 'required';
+    tools?: ToolDefinition[];
+    toolChoice?: 'auto' | 'none' | 'required' | {
+        type: 'tool';
+        name: string;
+    };
+    /**
+     * 推理深度提示。Anthropic 映射为 output_config.effort，
+     * OpenAI 映射为 reasoning_effort；不支持的 provider 忽略。
+     */
+    reasoning?: {
+        effort: ReasoningEffort;
+    };
     responseFormat?: ChatResponseFormat;
     signal?: AbortSignal | undefined;
     timeoutMs?: number;
@@ -72,17 +107,52 @@ export interface TokenUsage {
     promptTokens?: number | undefined;
     completionTokens?: number | undefined;
     totalTokens?: number | undefined;
+    /**
+     * 命中 provider prompt cache 的 prompt token 数（如果 provider 汇报）。
+     */
+    cachedPromptTokens?: number | undefined;
+    /**
+     * 写入 prompt cache 的 token 数（Anthropic cache_creation_input_tokens）。
+     */
+    cacheCreationPromptTokens?: number | undefined;
 }
+export type ChatFinishReason = 'stop' | 'tool_calls' | 'length' | 'content_filter' | 'other';
 export interface ChatResponse {
     role: 'assistant';
     content: string;
     toolCalls: ChatToolCall[];
+    /**
+     * 推理摘要文本（provider 支持且开启时）。
+     */
+    reasoning?: string | undefined;
+    finishReason?: ChatFinishReason | undefined;
     usage?: TokenUsage | undefined;
     raw?: unknown;
 }
+/**
+ * 流式工具调用增量。index 标识同一响应里第几个 tool call，
+ * id/name 只在该 tool call 的第一个增量出现，argumentsDelta 是
+ * JSON 参数字符串的增量片段，需要按 index 聚合后再解析。
+ * 用 ChatStreamAccumulator 可以免去手工拼接。
+ */
+export interface ToolCallDelta {
+    index: number;
+    id?: string | undefined;
+    name?: string | undefined;
+    argumentsDelta?: string | undefined;
+}
 export interface ChatStreamChunk {
     contentDelta?: string;
-    toolCallDelta?: unknown;
+    reasoningDelta?: string;
+    toolCallDeltas?: ToolCallDelta[];
+    /**
+     * 只在最后一个有效 chunk 上出现。
+     */
+    finishReason?: ChatFinishReason;
+    /**
+     * 流结束时的用量统计（provider 支持时才有，通常在最后一个 chunk）。
+     */
+    usage?: TokenUsage;
     raw?: unknown;
 }
 export interface ModelCapabilities {
@@ -90,6 +160,8 @@ export interface ModelCapabilities {
     toolCalling: boolean;
     structuredOutput: boolean;
     vision: boolean;
+    reasoning?: boolean;
+    promptCaching?: boolean;
     maxContextTokens?: number;
 }
 export interface StructuredOutputRequest<T> extends Omit<ChatRequest, 'responseFormat'> {

package/dist/llm/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/llm/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAEnC,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,OAAO,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEnE,MAAM,WAAW,cAAc;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC7B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,SAAU,SAAQ,cAAc,EAAE,gBAAgB;IAC/D,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAChC;AAED,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACvC,CAAC;CACL;AAED,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,SAAS,CAAC,EAAE,YAAY,EAAE,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CAClD;AAED,MAAM,WAAW,WAAW;IACxB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;IAC1C,cAAc,CAAC,EAAE,kBAAkB,CAAC;IACpC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,kBAAkB;IAC/B,IAAI,EAAE,aAAa,CAAC;IACpB,UAAU,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,MAAM,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC;CACL;AAED,MAAM,WAAW,UAAU;IACvB,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAED,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IAC/B,GAAG,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,GAAG,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,uBAAuB,CAAC,CAAC,CAAE,SAAQ,IAAI,CAAC,WAAW,EAAE,gBAAgB,CAAC;IACnF,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB,CAAC,CAAC;IACvC,KAAK,EAAE,CAAC,CAAC;IACT,QAAQ,EAAE,YAAY,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS,CAAC,OAAO,GAAG,OAAO;IACxC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAEtC,YAAY,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAClD,MAAM,CAAC,CAAC,OAAO,EAAE,WAAW,GAAG,aAAa,CAAC,eAAe,CAAC,CAAC;CACjE"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/llm/types.ts"],"names":[],"mappings":"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"}

package/dist/messages/content.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 消息内容的最小 block 模型。
+ * string 仍然是一等公民：纯文本消息不需要包一层数组。
+ * 只有需要图像等非文本内容时才使用 ContentBlock[]。
+ */
+export interface TextBlock {
+    type: 'text';
+    text: string;
+}
+export type ImageBlockSource = {
+    kind: 'url';
+    url: string;
+} | {
+    kind: 'base64';
+    mediaType: string;
+    data: string;
+};
+export interface ImageBlock {
+    type: 'image';
+    source: ImageBlockSource;
+}
+export type ContentBlock = TextBlock | ImageBlock;
+export type MessageContent = string | ContentBlock[];
+export declare function textBlock(text: string): TextBlock;
+export declare function imageUrlBlock(url: string): ImageBlock;
+export declare function imageBase64Block(mediaType: string, data: string): ImageBlock;
+/**
+ * 把内容降级为纯文本。
+ * 用于 toString、输出长度统计，以及不支持多模态的下游（例如 OpenAI 的
+ * assistant/tool 消息只接受字符串 content）。
+ */
+export declare function contentToText(content: MessageContent): string;
+export declare function isContentBlock(value: unknown): value is ContentBlock;
+export declare function isMessageContent(value: unknown): value is MessageContent;
+export declare function assertMessageContent(value: unknown): MessageContent;
+//# sourceMappingURL=content.d.ts.map