@fllf/agent-sdk 0.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/llm/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EACH,aAAa,EACb,sBAAsB,EACtB,QAAQ,EACR,uBAAuB,EACvB,gBAAgB,EAChB,iBAAiB,EACjB,wBAAwB,EACxB,eAAe,EACf,iBAAiB,GACpB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,YAAY,EACR,WAAW,EACX,SAAS,EACT,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,uBAAuB,EACvB,wBAAwB,EACxB,UAAU,GACb,MAAM,SAAS,CAAC"}

package/dist/llm/index.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModelProviderFactory = exports.normalizeLLMError = exports.LLMTimeoutError = exports.LLMStructuredOutputError = exports.LLMRateLimitError = exports.LLMProviderError = exports.LLMInvalidResponseError = exports.LLMError = exports.LLMAuthenticationError = exports.LLMAbortError = exports.LLM = void 0;
+var LLM_1 = require("./LLM");
+Object.defineProperty(exports, "LLM", { enumerable: true, get: function () { return LLM_1.LLM; } });
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "LLMAbortError", { enumerable: true, get: function () { return errors_1.LLMAbortError; } });
+Object.defineProperty(exports, "LLMAuthenticationError", { enumerable: true, get: function () { return errors_1.LLMAuthenticationError; } });
+Object.defineProperty(exports, "LLMError", { enumerable: true, get: function () { return errors_1.LLMError; } });
+Object.defineProperty(exports, "LLMInvalidResponseError", { enumerable: true, get: function () { return errors_1.LLMInvalidResponseError; } });
+Object.defineProperty(exports, "LLMProviderError", { enumerable: true, get: function () { return errors_1.LLMProviderError; } });
+Object.defineProperty(exports, "LLMRateLimitError", { enumerable: true, get: function () { return errors_1.LLMRateLimitError; } });
+Object.defineProperty(exports, "LLMStructuredOutputError", { enumerable: true, get: function () { return errors_1.LLMStructuredOutputError; } });
+Object.defineProperty(exports, "LLMTimeoutError", { enumerable: true, get: function () { return errors_1.LLMTimeoutError; } });
+Object.defineProperty(exports, "normalizeLLMError", { enumerable: true, get: function () { return errors_1.normalizeLLMError; } });
+var factory_1 = require("./factory");
+Object.defineProperty(exports, "ModelProviderFactory", { enumerable: true, get: function () { return factory_1.ModelProviderFactory; } });
+//# sourceMappingURL=index.js.map

package/dist/llm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/llm/index.ts"],"names":[],"mappings":";;;AAAA,6BAA4B;AAAnB,0FAAA,GAAG,OAAA;AACZ,mCAUkB;AATd,uGAAA,aAAa,OAAA;AACb,gHAAA,sBAAsB,OAAA;AACtB,kGAAA,QAAQ,OAAA;AACR,iHAAA,uBAAuB,OAAA;AACvB,0GAAA,gBAAgB,OAAA;AAChB,2GAAA,iBAAiB,OAAA;AACjB,kHAAA,wBAAwB,OAAA;AACxB,yGAAA,eAAe,OAAA;AACf,2GAAA,iBAAiB,OAAA;AAErB,qCAAiD;AAAxC,+GAAA,oBAAoB,OAAA"}

package/dist/llm/providers/base.d.ts

@@ -0,0 +1,3 @@
+import type { ChatModel } from '../types';
+export type ModelProvider<TClient = unknown> = ChatModel<TClient>;
+//# sourceMappingURL=base.d.ts.map

package/dist/llm/providers/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/llm/providers/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,MAAM,MAAM,aAAa,CAAC,OAAO,GAAG,OAAO,IAAI,SAAS,CAAC,OAAO,CAAC,CAAC"}

package/dist/llm/providers/base.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=base.js.map

package/dist/llm/providers/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/llm/providers/base.ts"],"names":[],"mappings":""}

package/dist/llm/providers/local.d.ts

@@ -0,0 +1,6 @@
+import type { ProviderConfig } from '../types';
+import { OpenAICompatibleProvider } from './openai-compatible';
+export declare class LocalProvider extends OpenAICompatibleProvider {
+    constructor(config?: ProviderConfig);
+}
+//# sourceMappingURL=local.d.ts.map

package/dist/llm/providers/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../../src/llm/providers/local.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAM/D,qBAAa,aAAc,SAAQ,wBAAwB;gBAC3C,MAAM,GAAE,cAAmB;CAQ1C"}

package/dist/llm/providers/local.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalProvider = void 0;
+const openai_compatible_1 = require("./openai-compatible");
+const DEFAULT_LOCAL_BASE_URL = 'http://127.0.0.1:11434/v1';
+const DEFAULT_LOCAL_MODEL = 'llama3';
+const DEFAULT_LOCAL_API_KEY = 'local-key';
+class LocalProvider extends openai_compatible_1.OpenAICompatibleProvider {
+    constructor(config = {}) {
+        super('local', {
+            ...config,
+            apiKey: config.apiKey ?? process.env.LOCAL_API_KEY ?? DEFAULT_LOCAL_API_KEY,
+            baseURL: config.baseURL ?? process.env.LOCAL_BASE_URL ?? DEFAULT_LOCAL_BASE_URL,
+            model: config.model ?? process.env.LOCAL_MODEL ?? DEFAULT_LOCAL_MODEL,
+        });
+    }
+}
+exports.LocalProvider = LocalProvider;
+//# sourceMappingURL=local.js.map

package/dist/llm/providers/local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.js","sourceRoot":"","sources":["../../../src/llm/providers/local.ts"],"names":[],"mappings":";;;AACA,2DAA+D;AAE/D,MAAM,sBAAsB,GAAG,2BAA2B,CAAC;AAC3D,MAAM,mBAAmB,GAAG,QAAQ,CAAC;AACrC,MAAM,qBAAqB,GAAG,WAAW,CAAC;AAE1C,MAAa,aAAc,SAAQ,4CAAwB;IACvD,YAAY,SAAyB,EAAE;QACnC,KAAK,CAAC,OAAO,EAAE;YACX,GAAG,MAAM;YACT,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,qBAAqB;YAC3E,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,sBAAsB;YAC/E,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,mBAAmB;SACxE,CAAC,CAAC;IACP,CAAC;CACJ;AATD,sCASC"}

package/dist/llm/providers/openai-compatible.d.ts

@@ -0,0 +1,13 @@
+import OpenAI from 'openai';
+import type { ChatRequest, ChatResponse, ChatStreamChunk, ModelCapabilities, ModelProviderName, ProviderConfig } from '../types';
+import type { ModelProvider } from './base';
+export declare class OpenAICompatibleProvider implements ModelProvider<OpenAI> {
+    readonly name: ModelProviderName;
+    readonly model: string;
+    readonly client: OpenAI;
+    constructor(name: ModelProviderName, config: ProviderConfig);
+    capabilities(): ModelCapabilities;
+    chat(request: ChatRequest): Promise<ChatResponse>;
+    stream(request: ChatRequest): AsyncIterable<ChatStreamChunk>;
+}
+//# sourceMappingURL=openai-compatible.d.ts.map

package/dist/llm/providers/openai-compatible.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-compatible.d.ts","sourceRoot":"","sources":["../../../src/llm/providers/openai-compatible.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,KAAK,EAER,WAAW,EACX,YAAY,EACZ,eAAe,EAEf,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EAEjB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAW5C,qBAAa,wBAAyB,YAAW,aAAa,CAAC,MAAM,CAAC;IAClE,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,IAAI,EAAE,iBAAiB,EAAE,MAAM,EAAE,cAAc;IAkB3D,YAAY,IAAI,iBAAiB;IAS3B,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IA4BhD,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,aAAa,CAAC,eAAe,CAAC;CActE"}

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

@@ -0,0 +1,176 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAICompatibleProvider = void 0;
+const openai_1 = __importDefault(require("openai"));
+class OpenAICompatibleProvider {
+    name;
+    model;
+    client;
+    constructor(name, config) {
+        if (!config.apiKey) {
+            throw new Error(`${name} provider requires an apiKey.`);
+        }
+        this.name = name;
+        this.model = config.model ?? 'gpt-4o-mini';
+        const clientOptions = {
+            apiKey: config.apiKey,
+        };
+        if (config.baseURL) {
+            clientOptions.baseURL = config.baseURL;
+        }
+        this.client = new openai_1.default(clientOptions);
+    }
+    capabilities() {
+        return {
+            streaming: true,
+            toolCalling: true,
+            structuredOutput: true,
+            vision: true,
+        };
+    }
+    async chat(request) {
+        const body = {
+            ...buildOpenAIChatBody(request, this.model),
+            stream: false,
+        };
+        const completion = request.signal
+            ? await this.client.chat.completions.create(body, { signal: request.signal })
+            : await this.client.chat.completions.create(body);
+        const choice = completion.choices[0];
+        const message = choice?.message;
+        const response = {
+            role: 'assistant',
+            content: message?.content ?? '',
+            toolCalls: (message?.tool_calls ?? []).map(toChatToolCall),
+            raw: completion,
+        };
+        const usage = toTokenUsage(completion.usage);
+        if (usage !== undefined) {
+            response.usage = usage;
+        }
+        return response;
+    }
+    async *stream(request) {
+        const body = {
+            ...buildOpenAIChatBody(request, this.model),
+            stream: true,
+        };
+        const stream = request.signal
+            ? await this.client.chat.completions.create(body, { signal: request.signal })
+            : await this.client.chat.completions.create(body);
+        for await (const chunk of stream) {
+            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,
+            },
+        };
+    }
+    return body;
+}
+function toOpenAIMessage(message) {
+    if (message.role === 'tool') {
+        return {
+            role: 'tool',
+            content: message.content,
+            tool_call_id: message.toolCallId ?? '',
+        };
+    }
+    if (message.role === 'assistant' && message.toolCalls?.length) {
+        return {
+            role: 'assistant',
+            content: message.content,
+            tool_calls: message.toolCalls.map((toolCall) => ({
+                id: toolCall.id,
+                type: 'function',
+                function: {
+                    name: toolCall.name,
+                    arguments: JSON.stringify(toolCall.arguments),
+                },
+            })),
+        };
+    }
+    return {
+        role: message.role,
+        content: message.content,
+    };
+}
+function toChatToolCall(toolCall) {
+    if (toolCall.type !== 'function') {
+        return {
+            id: toolCall.id,
+            name: toolCall.type,
+            arguments: {},
+        };
+    }
+    return {
+        id: toolCall.id,
+        name: toolCall.function.name,
+        arguments: parseToolArguments(toolCall.function.arguments),
+    };
+}
+function toChatStreamChunk(chunk) {
+    const delta = chunk.choices[0]?.delta;
+    const streamChunk = {
+        raw: chunk,
+    };
+    if (delta?.content !== undefined && delta.content !== null) {
+        streamChunk.contentDelta = delta.content;
+    }
+    if (delta?.tool_calls !== undefined && delta.tool_calls.length > 0) {
+        streamChunk.toolCallDelta = delta.tool_calls;
+    }
+    return streamChunk;
+}
+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);
+}
+function toTokenUsage(usage) {
+    if (!usage) {
+        return undefined;
+    }
+    return {
+        promptTokens: usage.prompt_tokens,
+        completionTokens: usage.completion_tokens,
+        totalTokens: usage.total_tokens,
+    };
+}
+//# sourceMappingURL=openai-compatible.js.map

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

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

package/dist/llm/providers/openai.d.ts

@@ -0,0 +1,6 @@
+import type { ProviderConfig } from '../types';
+import { OpenAICompatibleProvider } from './openai-compatible';
+export declare class OpenAIProvider extends OpenAICompatibleProvider {
+    constructor(config?: ProviderConfig);
+}
+//# sourceMappingURL=openai.d.ts.map

package/dist/llm/providers/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../src/llm/providers/openai.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,qBAAa,cAAe,SAAQ,wBAAwB;gBAC5C,MAAM,GAAE,cAAmB;CAkB1C"}

package/dist/llm/providers/openai.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAIProvider = void 0;
+const openai_compatible_1 = require("./openai-compatible");
+class OpenAIProvider extends openai_compatible_1.OpenAICompatibleProvider {
+    constructor(config = {}) {
+        const resolvedConfig = {
+            ...config,
+            model: config.model ?? process.env.OPENAI_MODEL ?? 'gpt-4o-mini',
+        };
+        const apiKey = config.apiKey ?? process.env.OPENAI_API_KEY;
+        if (apiKey !== undefined) {
+            resolvedConfig.apiKey = apiKey;
+        }
+        const baseURL = config.baseURL ?? process.env.OPENAI_BASE_URL;
+        if (baseURL !== undefined) {
+            resolvedConfig.baseURL = baseURL;
+        }
+        super('openai', resolvedConfig);
+    }
+}
+exports.OpenAIProvider = OpenAIProvider;
+//# sourceMappingURL=openai.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openai.js","sourceRoot":"","sources":["../../../src/llm/providers/openai.ts"],"names":[],"mappings":";;;AACA,2DAA+D;AAE/D,MAAa,cAAe,SAAQ,4CAAwB;IACxD,YAAY,SAAyB,EAAE;QACnC,MAAM,cAAc,GAAmB;YACnC,GAAG,MAAM;YACT,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,aAAa;SACnE,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;QAC3D,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACvB,cAAc,CAAC,MAAM,GAAG,MAAM,CAAC;QACnC,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;QAC9D,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YACxB,cAAc,CAAC,OAAO,GAAG,OAAO,CAAC;QACrC,CAAC;QAED,KAAK,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IACpC,CAAC;CACJ;AAnBD,wCAmBC"}

package/dist/llm/types.d.ts

@@ -0,0 +1,116 @@
+import type { MessageRole } from '../messages/types';
+import type { TraceContext } from '../observability';
+import type { ZodType } from 'zod';
+export type ModelProviderName = 'openai' | 'local' | (string & {});
+export interface ProviderConfig {
+    apiKey?: string;
+    baseURL?: string;
+    model?: string;
+}
+export interface LLMRuntimeConfig {
+    /**
+     * 单次模型请求的超时时间。设置为 0 或 undefined 表示不由框架主动超时。
+     */
+    timeoutMs?: number;
+    /**
+     * 失败后的最大重试次数，不包含第一次请求。
+     */
+    maxRetries?: number;
+    retryDelayMs?: number;
+    retryMaxDelayMs?: number;
+}
+export interface LLMConfig extends ProviderConfig, LLMRuntimeConfig {
+    provider?: ModelProviderName;
+}
+export interface ChatToolSchema {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        strict?: boolean;
+        parameters: Record<string, unknown>;
+    };
+}
+export interface ChatToolCall {
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+}
+export interface ChatMessage {
+    role: MessageRole;
+    content: string;
+    toolCallId?: string | undefined;
+    toolCalls?: ChatToolCall[] | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}
+export interface ChatRequest {
+    messages: ChatMessage[];
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    tools?: ChatToolSchema[];
+    toolChoice?: 'auto' | 'none' | 'required';
+    responseFormat?: ChatResponseFormat;
+    signal?: AbortSignal | undefined;
+    timeoutMs?: number;
+    maxRetries?: number;
+    retryDelayMs?: number;
+    retryMaxDelayMs?: number;
+    trace?: TraceContext;
+    metadata?: Record<string, unknown>;
+}
+export interface ChatResponseFormat {
+    type: 'json_schema';
+    jsonSchema: {
+        name: string;
+        description?: string;
+        schema: Record<string, unknown>;
+        strict?: boolean;
+    };
+}
+export interface TokenUsage {
+    promptTokens?: number | undefined;
+    completionTokens?: number | undefined;
+    totalTokens?: number | undefined;
+}
+export interface ChatResponse {
+    role: 'assistant';
+    content: string;
+    toolCalls: ChatToolCall[];
+    usage?: TokenUsage | undefined;
+    raw?: unknown;
+}
+export interface ChatStreamChunk {
+    contentDelta?: string;
+    toolCallDelta?: unknown;
+    raw?: unknown;
+}
+export interface ModelCapabilities {
+    streaming: boolean;
+    toolCalling: boolean;
+    structuredOutput: boolean;
+    vision: boolean;
+    maxContextTokens?: number;
+}
+export interface StructuredOutputRequest<T> extends Omit<ChatRequest, 'responseFormat'> {
+    schema: ZodType<T>;
+    name?: string;
+    description?: string;
+}
+export interface StructuredOutputResponse<T> {
+    value: T;
+    response: ChatResponse;
+}
+/**
+ * ChatModel 是 Agent 层唯一依赖的模型接口。
+ * 任何厂商 SDK 都应该被 provider 适配到这个接口，而不是泄漏到 Agent 里。
+ */
+export interface ChatModel<TClient = unknown> {
+    readonly name: ModelProviderName;
+    readonly model: string;
+    readonly client?: TClient | undefined;
+    capabilities(model?: string): ModelCapabilities;
+    chat(request: ChatRequest): Promise<ChatResponse>;
+    stream?(request: ChatRequest): AsyncIterable<ChatStreamChunk>;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/llm/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/llm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/llm/types.ts"],"names":[],"mappings":""}

package/dist/messages/index.d.ts

@@ -0,0 +1,3 @@
+export { Message } from './message';
+export type { MessageMetadata, MessageOptions, MessageRole, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/messages/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/messages/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EACR,eAAe,EACf,cAAc,EACd,WAAW,GACd,MAAM,SAAS,CAAC"}

package/dist/messages/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Message = void 0;
+var message_1 = require("./message");
+Object.defineProperty(exports, "Message", { enumerable: true, get: function () { return message_1.Message; } });
+//# sourceMappingURL=index.js.map

package/dist/messages/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/messages/index.ts"],"names":[],"mappings":";;;AAAA,qCAAoC;AAA3B,kGAAA,OAAO,OAAA"}

package/dist/messages/message.d.ts

@@ -0,0 +1,25 @@
+import type { ChatMessage } from '../llm/types';
+import type { MessageMetadata, MessageOptions, MessageRole } from './types';
+export declare class Message {
+    readonly content: string;
+    readonly role: MessageRole;
+    readonly timestamp: Date;
+    readonly metadata: Readonly<MessageMetadata>;
+    constructor(content: string, role: MessageRole, options?: MessageOptions);
+    /**
+     * ChatModel 只需要稳定的消息结构，不需要关心 Message 类的时间戳等运行时信息。
+     * 因此这里把领域对象转换为 LLM 层的纯数据对象。
+     */
+    toChatMessage(): ChatMessage;
+    /**
+     * 保留一个简单对象格式，方便调试、测试和序列化。
+     */
+    toJSON(): {
+        role: MessageRole;
+        content: string;
+        timestamp: string;
+        metadata: MessageMetadata;
+    };
+    toString(): string;
+}
+//# sourceMappingURL=message.d.ts.map

package/dist/messages/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../src/messages/message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE5E,qBAAa,OAAO;IAChB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;gBAEjC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,GAAE,cAAmB;IAO5E;;;OAGG;IACH,aAAa,IAAI,WAAW;IAmB5B;;OAEG;IACH,MAAM,IAAI;QACN,IAAI,EAAE,WAAW,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,eAAe,CAAC;KAC7B;IASD,QAAQ,IAAI,MAAM;CAGrB"}

package/dist/messages/message.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Message = void 0;
+class Message {
+    content;
+    role;
+    timestamp;
+    metadata;
+    constructor(content, role, options = {}) {
+        this.content = content;
+        this.role = role;
+        this.timestamp = options.timestamp ?? new Date();
+        this.metadata = freezeMetadata(cloneMetadata(options.metadata));
+    }
+    /**
+     * ChatModel 只需要稳定的消息结构，不需要关心 Message 类的时间戳等运行时信息。
+     * 因此这里把领域对象转换为 LLM 层的纯数据对象。
+     */
+    toChatMessage() {
+        const metadata = cloneMetadata(this.metadata);
+        const message = {
+            role: this.role,
+            content: this.content,
+            metadata,
+        };
+        if (metadata.toolCallId !== undefined) {
+            message.toolCallId = metadata.toolCallId;
+        }
+        if (metadata.toolCalls !== undefined) {
+            message.toolCalls = metadata.toolCalls;
+        }
+        return message;
+    }
+    /**
+     * 保留一个简单对象格式，方便调试、测试和序列化。
+     */
+    toJSON() {
+        return {
+            role: this.role,
+            content: this.content,
+            timestamp: this.timestamp.toISOString(),
+            metadata: cloneMetadata(this.metadata),
+        };
+    }
+    toString() {
+        return `[${this.role}] ${this.content}`;
+    }
+}
+exports.Message = Message;
+function cloneMetadata(metadata) {
+    return cloneValue(metadata ?? {});
+}
+function cloneValue(value, seen = new WeakMap()) {
+    if (value === null || typeof value !== 'object') {
+        return value;
+    }
+    const cached = seen.get(value);
+    if (cached !== undefined) {
+        return cached;
+    }
+    if (value instanceof Date) {
+        return new Date(value.getTime());
+    }
+    if (Array.isArray(value)) {
+        const cloned = [];
+        seen.set(value, cloned);
+        for (const item of value) {
+            cloned.push(cloneValue(item, seen));
+        }
+        return cloned;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    if (prototype !== Object.prototype && prototype !== null) {
+        return value;
+    }
+    const cloned = {};
+    seen.set(value, cloned);
+    for (const [key, child] of Object.entries(value)) {
+        cloned[key] = cloneValue(child, seen);
+    }
+    return cloned;
+}
+function freezeMetadata(metadata) {
+    return freezeValue(metadata);
+}
+function freezeValue(value, seen = new WeakSet()) {
+    if (value === null || typeof value !== 'object') {
+        return value;
+    }
+    const objectValue = value;
+    if (seen.has(objectValue)) {
+        return value;
+    }
+    seen.add(objectValue);
+    if (Array.isArray(value)) {
+        for (const item of value) {
+            freezeValue(item, seen);
+        }
+        return Object.freeze(value);
+    }
+    const prototype = Object.getPrototypeOf(value);
+    if (prototype === Object.prototype || prototype === null) {
+        for (const child of Object.values(value)) {
+            freezeValue(child, seen);
+        }
+        return Object.freeze(value);
+    }
+    return value;
+}
+//# sourceMappingURL=message.js.map

package/dist/messages/message.js.map

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

package/dist/messages/types.d.ts

@@ -0,0 +1,20 @@
+import type { ChatToolCall } from '../llm/types';
+export type MessageRole = 'user' | 'assistant' | 'system' | 'tool';
+export interface MessageMetadata {
+    /**
+     * tool role 消息需要指明自己响应的是哪个 tool call。
+     * 这个字段会在 OpenAI-compatible provider 中映射为 tool_call_id。
+     */
+    toolCallId?: string;
+    /**
+     * assistant 消息可以携带模型要求执行的工具调用。
+     * 把它放进元数据里，可以让 MessageHistory 保存完整推理轨迹。
+     */
+    toolCalls?: ChatToolCall[];
+    [key: string]: unknown;
+}
+export interface MessageOptions {
+    timestamp?: Date;
+    metadata?: MessageMetadata;
+}
+//# sourceMappingURL=types.d.ts.map