@fllf/agent-sdk 0.1.0

package/dist/config/config.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Config = void 0;
+class Config {
+    defaultModel;
+    defaultProvider;
+    temperature;
+    maxTokens;
+    requestTimeoutMs;
+    maxRetries;
+    retryDelayMs;
+    retryMaxDelayMs;
+    debug;
+    logLevel;
+    maxHistoryLength;
+    constructor(options = {}) {
+        this.defaultModel = options.defaultModel;
+        this.defaultProvider = options.defaultProvider;
+        this.temperature = options.temperature ?? 0.7;
+        this.maxTokens = options.maxTokens;
+        this.requestTimeoutMs = options.requestTimeoutMs;
+        this.maxRetries = options.maxRetries;
+        this.retryDelayMs = options.retryDelayMs;
+        this.retryMaxDelayMs = options.retryMaxDelayMs;
+        this.debug = options.debug ?? false;
+        this.logLevel = options.logLevel ?? 'INFO';
+        this.maxHistoryLength = options.maxHistoryLength ?? 100;
+    }
+    /**
+     * 环境变量只负责覆盖运行参数。
+     * 如果没有显式 MODEL，就让 LLM provider 使用自己的默认模型。
+     */
+    static fromEnv() {
+        const options = {};
+        if (process.env.MODEL) {
+            options.defaultModel = process.env.MODEL;
+        }
+        if (process.env.MODEL_PROVIDER) {
+            options.defaultProvider = process.env.MODEL_PROVIDER;
+        }
+        if (process.env.DEBUG !== undefined) {
+            options.debug = process.env.DEBUG.toLowerCase() === 'true';
+        }
+        if (process.env.LOG_LEVEL) {
+            options.logLevel = process.env.LOG_LEVEL;
+        }
+        if (process.env.TEMPERATURE !== undefined) {
+            const temperature = Number.parseFloat(process.env.TEMPERATURE);
+            if (!Number.isNaN(temperature)) {
+                options.temperature = temperature;
+            }
+        }
+        if (process.env.MAX_TOKENS !== undefined) {
+            const maxTokens = Number.parseInt(process.env.MAX_TOKENS, 10);
+            if (!Number.isNaN(maxTokens)) {
+                options.maxTokens = maxTokens;
+            }
+        }
+        if (process.env.REQUEST_TIMEOUT_MS !== undefined) {
+            const requestTimeoutMs = Number.parseInt(process.env.REQUEST_TIMEOUT_MS, 10);
+            if (!Number.isNaN(requestTimeoutMs)) {
+                options.requestTimeoutMs = requestTimeoutMs;
+            }
+        }
+        if (process.env.MAX_RETRIES !== undefined) {
+            const maxRetries = Number.parseInt(process.env.MAX_RETRIES, 10);
+            if (!Number.isNaN(maxRetries)) {
+                options.maxRetries = maxRetries;
+            }
+        }
+        if (process.env.RETRY_DELAY_MS !== undefined) {
+            const retryDelayMs = Number.parseInt(process.env.RETRY_DELAY_MS, 10);
+            if (!Number.isNaN(retryDelayMs)) {
+                options.retryDelayMs = retryDelayMs;
+            }
+        }
+        if (process.env.RETRY_MAX_DELAY_MS !== undefined) {
+            const retryMaxDelayMs = Number.parseInt(process.env.RETRY_MAX_DELAY_MS, 10);
+            if (!Number.isNaN(retryMaxDelayMs)) {
+                options.retryMaxDelayMs = retryMaxDelayMs;
+            }
+        }
+        if (process.env.MAX_HISTORY_LENGTH !== undefined) {
+            const maxHistoryLength = Number.parseInt(process.env.MAX_HISTORY_LENGTH, 10);
+            if (!Number.isNaN(maxHistoryLength)) {
+                options.maxHistoryLength = maxHistoryLength;
+            }
+        }
+        return new Config(options);
+    }
+    toJSON() {
+        const options = {
+            temperature: this.temperature,
+            debug: this.debug,
+            logLevel: this.logLevel,
+            maxHistoryLength: this.maxHistoryLength,
+        };
+        if (this.defaultModel !== undefined) {
+            options.defaultModel = this.defaultModel;
+        }
+        if (this.defaultProvider !== undefined) {
+            options.defaultProvider = this.defaultProvider;
+        }
+        if (this.maxTokens !== undefined) {
+            options.maxTokens = this.maxTokens;
+        }
+        if (this.requestTimeoutMs !== undefined) {
+            options.requestTimeoutMs = this.requestTimeoutMs;
+        }
+        if (this.maxRetries !== undefined) {
+            options.maxRetries = this.maxRetries;
+        }
+        if (this.retryDelayMs !== undefined) {
+            options.retryDelayMs = this.retryDelayMs;
+        }
+        if (this.retryMaxDelayMs !== undefined) {
+            options.retryMaxDelayMs = this.retryMaxDelayMs;
+        }
+        return options;
+    }
+}
+exports.Config = Config;
+//# sourceMappingURL=config.js.map

package/dist/config/config.js.map

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

package/dist/config/index.d.ts

@@ -0,0 +1,3 @@
+export { Config } from './config';
+export type { ConfigOptions } from './config';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC"}

package/dist/config/index.js

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

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":";;;AAAA,mCAAkC;AAAzB,gGAAA,MAAM,OAAA"}

package/dist/executors/base.d.ts

@@ -0,0 +1,44 @@
+import type { Config } from '../config';
+import type { MessageHistory } from '../history';
+import type { ChatModel, TokenUsage } from '../llm';
+import type { Message } from '../messages';
+import type { Observer } from '../observability';
+import type { ToolRegistry } from '../tools';
+export interface AgentRunOptions {
+    sessionId?: string;
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    timeoutMs?: number;
+    maxRetries?: number;
+    retryDelayMs?: number;
+    retryMaxDelayMs?: number;
+    systemPrompt?: string;
+    runId?: string;
+    observer?: Observer;
+    signal?: AbortSignal;
+    metadata?: Record<string, unknown>;
+}
+export interface AgentResult {
+    output: string;
+    messages: Message[];
+    usage?: TokenUsage | undefined;
+    raw?: unknown;
+}
+export interface AgentContext {
+    runId: string;
+    agentName: string;
+    sessionId: string;
+    input: string;
+    options: AgentRunOptions;
+    llm: ChatModel;
+    history: MessageHistory;
+    tools: ToolRegistry;
+    observer: Observer | undefined;
+    systemPrompt: string | undefined;
+    config: Config;
+}
+export interface AgentExecutor {
+    run(context: AgentContext): Promise<AgentResult>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/executors/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/executors/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C,MAAM,WAAW,eAAe;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,WAAW;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IAC/B,GAAG,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,eAAe,CAAC;IACzB,GAAG,EAAE,SAAS,CAAC;IACf,OAAO,EAAE,cAAc,CAAC;IACxB,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC/B,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC1B,GAAG,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACpD"}

package/dist/executors/base.js

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

package/dist/executors/base.js.map

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

package/dist/executors/index.d.ts

@@ -0,0 +1,7 @@
+export type { AgentContext, AgentExecutor, AgentResult, AgentRunOptions, } from './base';
+export { RagExecutor } from './rag-executor';
+export type { RagExecutorOptions } from './rag-executor';
+export { SimpleChatExecutor } from './simple-chat-executor';
+export { ToolCallingExecutor } from './tool-calling-executor';
+export type { ToolCallingExecutorOptions } from './tool-calling-executor';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/executors/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACR,YAAY,EACZ,aAAa,EACb,WAAW,EACX,eAAe,GAClB,MAAM,QAAQ,CAAC;AAChB,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,YAAY,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/executors/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolCallingExecutor = exports.SimpleChatExecutor = exports.RagExecutor = void 0;
+var rag_executor_1 = require("./rag-executor");
+Object.defineProperty(exports, "RagExecutor", { enumerable: true, get: function () { return rag_executor_1.RagExecutor; } });
+var simple_chat_executor_1 = require("./simple-chat-executor");
+Object.defineProperty(exports, "SimpleChatExecutor", { enumerable: true, get: function () { return simple_chat_executor_1.SimpleChatExecutor; } });
+var tool_calling_executor_1 = require("./tool-calling-executor");
+Object.defineProperty(exports, "ToolCallingExecutor", { enumerable: true, get: function () { return tool_calling_executor_1.ToolCallingExecutor; } });
+//# sourceMappingURL=index.js.map

package/dist/executors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/executors/index.ts"],"names":[],"mappings":";;;AAMA,+CAA6C;AAApC,2GAAA,WAAW,OAAA;AAEpB,+DAA4D;AAAnD,0HAAA,kBAAkB,OAAA;AAC3B,iEAA8D;AAArD,4HAAA,mBAAmB,OAAA"}

package/dist/executors/rag-executor.d.ts

@@ -0,0 +1,16 @@
+import type { AnswerOptions, RagPipeline } from '../rag';
+import type { AgentContext, AgentExecutor, AgentResult } from './base';
+export interface RagExecutorOptions {
+    pipeline: RagPipeline;
+    answerOptions?: Omit<AnswerOptions, 'llm' | 'trace'>;
+    requireCitations?: boolean;
+}
+export declare class RagExecutor implements AgentExecutor {
+    private readonly pipeline;
+    private readonly answerOptions;
+    private readonly requireCitations;
+    constructor(options: RagExecutorOptions);
+    run(context: AgentContext): Promise<AgentResult>;
+    private buildAnswerOptions;
+}
+//# sourceMappingURL=rag-executor.d.ts.map

package/dist/executors/rag-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rag-executor.d.ts","sourceRoot":"","sources":["../../src/executors/rag-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,aAAa,EAGb,WAAW,EAEd,MAAM,QAAQ,CAAC;AAEhB,OAAO,KAAK,EACR,YAAY,EACZ,aAAa,EACb,WAAW,EACd,MAAM,QAAQ,CAAC;AAEhB,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,EAAE,WAAW,CAAC;IACtB,aAAa,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,GAAG,OAAO,CAAC,CAAC;IACrD,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,qBAAa,WAAY,YAAW,aAAa;IAC7C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;IACvC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAuC;IACrE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAsB;gBAE3C,OAAO,EAAE,kBAAkB;IAMjC,GAAG,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAmCtD,OAAO,CAAC,kBAAkB;CA8B7B"}

package/dist/executors/rag-executor.js

@@ -0,0 +1,120 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RagExecutor = void 0;
+const messages_1 = require("../messages");
+class RagExecutor {
+    pipeline;
+    answerOptions;
+    requireCitations;
+    constructor(options) {
+        this.pipeline = options.pipeline;
+        this.answerOptions = options.answerOptions ?? {};
+        this.requireCitations = options.requireCitations;
+    }
+    async run(context) {
+        const answer = await this.pipeline.answer(context.input, this.buildAnswerOptions(context));
+        const userMessage = new messages_1.Message(context.input, 'user', context.options.metadata ? { metadata: context.options.metadata } : {});
+        const assistantMessage = new messages_1.Message(answer.answer, 'assistant', {
+            metadata: {
+                rag: {
+                    confidence: answer.confidence,
+                    citations: answer.citations.map(toCitationMetadata),
+                    retrieved: answer.retrieved.map(toRetrievedMetadata),
+                },
+            },
+        });
+        await context.history.addMany([userMessage, assistantMessage]);
+        const result = {
+            output: answer.answer,
+            messages: await context.history.get(),
+            raw: answer,
+        };
+        if (answer.usage !== undefined) {
+            result.usage = answer.usage;
+        }
+        return result;
+    }
+    buildAnswerOptions(context) {
+        const metadata = context.options.metadata;
+        const options = {
+            ...this.answerOptions,
+            llm: context.llm,
+            trace: {
+                runId: context.runId,
+                observer: context.observer,
+                agentName: context.agentName,
+                sessionId: context.sessionId,
+            },
+        };
+        assignIfDefined(options, 'metadata', metadata);
+        assignIfDefined(options, 'tenantId', readString(metadata, 'tenantId'));
+        assignIfDefined(options, 'knowledgeBaseId', readString(metadata, 'knowledgeBaseId'));
+        assignIfDefined(options, 'acl', readStringArray(metadata, 'acl'));
+        assignIfDefined(options, 'documentIds', readStringArray(metadata, 'documentIds'));
+        assignIfDefined(options, 'sources', readStringArray(metadata, 'sources'));
+        assignIfDefined(options, 'metadataFilter', readRecord(metadata, 'metadataFilter'));
+        assignIfDefined(options, 'topK', readNumber(metadata, 'topK'));
+        assignIfDefined(options, 'minScore', readNumber(metadata, 'minScore'));
+        assignIfDefined(options, 'maxContextTokens', readNumber(metadata, 'maxContextTokens'));
+        if (this.requireCitations !== undefined) {
+            options.requireCitations = this.requireCitations;
+        }
+        return options;
+    }
+}
+exports.RagExecutor = RagExecutor;
+function toCitationMetadata(citation) {
+    const metadata = {
+        index: citation.index,
+        chunkId: citation.chunkId,
+        documentId: citation.documentId,
+        source: citation.source,
+    };
+    assignIfDefined(metadata, 'title', citation.title);
+    assignIfDefined(metadata, 'headingPath', citation.headingPath);
+    assignIfDefined(metadata, 'page', citation.page);
+    return metadata;
+}
+function toRetrievedMetadata(retrieved) {
+    const metadata = {
+        chunkId: retrieved.chunk.id,
+        documentId: retrieved.chunk.documentId,
+        source: retrieved.source,
+        score: retrieved.score,
+        documentSource: retrieved.chunk.metadata.source,
+    };
+    assignIfDefined(metadata, 'title', retrieved.chunk.metadata.title);
+    assignIfDefined(metadata, 'headingPath', retrieved.chunk.metadata.headingPath);
+    return metadata;
+}
+function readString(metadata, key) {
+    const value = metadata?.[key];
+    return typeof value === 'string' && value.trim().length > 0 ? value : undefined;
+}
+function readNumber(metadata, key) {
+    const value = metadata?.[key];
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+function readStringArray(metadata, key) {
+    const value = metadata?.[key];
+    if (!Array.isArray(value)) {
+        return undefined;
+    }
+    const strings = value
+        .filter((item) => typeof item === 'string')
+        .filter((item) => item.trim().length > 0);
+    return strings.length > 0 ? strings : undefined;
+}
+function readRecord(metadata, key) {
+    const value = metadata?.[key];
+    return isRecord(value) ? value : undefined;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function assignIfDefined(target, key, value) {
+    if (value !== undefined) {
+        target[key] = value;
+    }
+}
+//# sourceMappingURL=rag-executor.js.map

package/dist/executors/rag-executor.js.map

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

package/dist/executors/simple-chat-executor.d.ts

@@ -0,0 +1,5 @@
+import type { AgentContext, AgentExecutor, AgentResult } from './base';
+export declare class SimpleChatExecutor implements AgentExecutor {
+    run(context: AgentContext): Promise<AgentResult>;
+}
+//# sourceMappingURL=simple-chat-executor.d.ts.map

package/dist/executors/simple-chat-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple-chat-executor.d.ts","sourceRoot":"","sources":["../../src/executors/simple-chat-executor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAEvE,qBAAa,kBAAmB,YAAW,aAAa;IAC9C,GAAG,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;CA6BzD"}

package/dist/executors/simple-chat-executor.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SimpleChatExecutor = void 0;
+const messages_1 = require("../messages");
+class SimpleChatExecutor {
+    async run(context) {
+        const userMessage = new messages_1.Message(context.input, 'user', context.options.metadata ? { metadata: context.options.metadata } : {});
+        const messages = [
+            ...(await context.history.get()),
+            userMessage,
+        ];
+        const request = buildChatRequest(context, messages);
+        const response = await context.llm.chat(request);
+        const assistantMessage = new messages_1.Message(response.content, 'assistant');
+        await context.history.addMany([userMessage, assistantMessage]);
+        const result = {
+            output: response.content,
+            messages: await context.history.get(),
+            raw: response.raw,
+        };
+        if (response.usage !== undefined) {
+            result.usage = response.usage;
+        }
+        return result;
+    }
+}
+exports.SimpleChatExecutor = SimpleChatExecutor;
+function buildChatRequest(context, history) {
+    const systemPrompt = context.options.systemPrompt ?? context.systemPrompt;
+    const messages = [
+        ...(systemPrompt ? [new messages_1.Message(systemPrompt, 'system').toChatMessage()] : []),
+        ...history.map((message) => message.toChatMessage()),
+    ];
+    const request = {
+        messages,
+        trace: {
+            runId: context.runId,
+            observer: context.observer,
+            agentName: context.agentName,
+            sessionId: context.sessionId,
+        },
+    };
+    const model = context.options.model ?? context.config.defaultModel;
+    if (model) {
+        request.model = model;
+    }
+    request.temperature = context.options.temperature ?? context.config.temperature;
+    const maxTokens = context.options.maxTokens ?? context.config.maxTokens;
+    if (maxTokens !== undefined) {
+        request.maxTokens = maxTokens;
+    }
+    if (context.options.signal) {
+        request.signal = context.options.signal;
+    }
+    applyRuntimeOptions(context, request);
+    return request;
+}
+function applyRuntimeOptions(context, request) {
+    // 单次 run 的 options 优先级高于 Agent 的默认 config。
+    const timeoutMs = context.options.timeoutMs ?? context.config.requestTimeoutMs;
+    if (timeoutMs !== undefined) {
+        request.timeoutMs = timeoutMs;
+    }
+    const maxRetries = context.options.maxRetries ?? context.config.maxRetries;
+    if (maxRetries !== undefined) {
+        request.maxRetries = maxRetries;
+    }
+    const retryDelayMs = context.options.retryDelayMs ?? context.config.retryDelayMs;
+    if (retryDelayMs !== undefined) {
+        request.retryDelayMs = retryDelayMs;
+    }
+    const retryMaxDelayMs = context.options.retryMaxDelayMs ?? context.config.retryMaxDelayMs;
+    if (retryMaxDelayMs !== undefined) {
+        request.retryMaxDelayMs = retryMaxDelayMs;
+    }
+}
+//# sourceMappingURL=simple-chat-executor.js.map

package/dist/executors/simple-chat-executor.js.map

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

package/dist/executors/tool-calling-executor.d.ts

@@ -0,0 +1,10 @@
+import type { AgentContext, AgentExecutor, AgentResult } from './base';
+export interface ToolCallingExecutorOptions {
+    maxIterations?: number;
+}
+export declare class ToolCallingExecutor implements AgentExecutor {
+    private readonly maxIterations;
+    constructor(options?: ToolCallingExecutorOptions);
+    run(context: AgentContext): Promise<AgentResult>;
+}
+//# sourceMappingURL=tool-calling-executor.d.ts.map

package/dist/executors/tool-calling-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-calling-executor.d.ts","sourceRoot":"","sources":["../../src/executors/tool-calling-executor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAEvE,MAAM,WAAW,0BAA0B;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,mBAAoB,YAAW,aAAa;IACrD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;gBAE3B,OAAO,GAAE,0BAA+B;IAI9C,GAAG,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;CA+DzD"}

package/dist/executors/tool-calling-executor.js

@@ -0,0 +1,151 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolCallingExecutor = void 0;
+const messages_1 = require("../messages");
+const tools_1 = require("../tools");
+class ToolCallingExecutor {
+    maxIterations;
+    constructor(options = {}) {
+        this.maxIterations = options.maxIterations ?? 5;
+    }
+    async run(context) {
+        const userMessage = new messages_1.Message(context.input, 'user', context.options.metadata ? { metadata: context.options.metadata } : {});
+        const runMessages = [userMessage];
+        const toolExecutor = new tools_1.ToolExecutor(context.tools, {
+            runId: context.runId,
+            observer: context.observer,
+            agentName: context.agentName,
+            sessionId: context.sessionId,
+        });
+        const messages = await buildInitialMessages(context, userMessage);
+        let usage;
+        let raw;
+        for (let iteration = 0; iteration < this.maxIterations; iteration += 1) {
+            const response = await context.llm.chat(buildChatRequest(context, messages));
+            usage = mergeTokenUsage(usage, response.usage);
+            raw = response.raw;
+            if (response.toolCalls.length === 0) {
+                const assistantMessage = new messages_1.Message(response.content, 'assistant');
+                runMessages.push(assistantMessage);
+                await context.history.addMany(runMessages);
+                const result = {
+                    output: response.content,
+                    messages: await context.history.get(),
+                    raw,
+                };
+                if (usage !== undefined) {
+                    result.usage = usage;
+                }
+                return result;
+            }
+            const assistantMessage = new messages_1.Message(response.content, 'assistant', {
+                metadata: { toolCalls: response.toolCalls },
+            });
+            runMessages.push(assistantMessage);
+            messages.push(assistantMessage.toChatMessage());
+            for (const toolCall of response.toolCalls) {
+                const result = await toolExecutor.execute(toolCall);
+                const toolMessage = new messages_1.Message(result, 'tool', {
+                    metadata: {
+                        toolCallId: toolCall.id,
+                        toolName: toolCall.name,
+                    },
+                });
+                runMessages.push(toolMessage);
+                messages.push(toolMessage.toChatMessage());
+            }
+        }
+        throw new Error(`Tool calling exceeded max iterations: ${this.maxIterations}`);
+    }
+}
+exports.ToolCallingExecutor = ToolCallingExecutor;
+async function buildInitialMessages(context, userMessage) {
+    const systemPrompt = context.options.systemPrompt ?? context.systemPrompt;
+    const history = await context.history.get();
+    return [
+        ...(systemPrompt ? [new messages_1.Message(systemPrompt, 'system').toChatMessage()] : []),
+        ...history.map((message) => message.toChatMessage()),
+        userMessage.toChatMessage(),
+    ];
+}
+function buildChatRequest(context, messages) {
+    const request = {
+        messages,
+        trace: {
+            runId: context.runId,
+            observer: context.observer,
+            agentName: context.agentName,
+            sessionId: context.sessionId,
+        },
+    };
+    const model = context.options.model ?? context.config.defaultModel;
+    if (model) {
+        request.model = model;
+    }
+    request.temperature = context.options.temperature ?? context.config.temperature;
+    const maxTokens = context.options.maxTokens ?? context.config.maxTokens;
+    if (maxTokens !== undefined) {
+        request.maxTokens = maxTokens;
+    }
+    const tools = context.tools.toOpenAISchemas();
+    if (tools.length > 0) {
+        request.tools = tools;
+        request.toolChoice = 'auto';
+    }
+    if (context.options.signal) {
+        request.signal = context.options.signal;
+    }
+    applyRuntimeOptions(context, request);
+    return request;
+}
+function applyRuntimeOptions(context, request) {
+    // 单次 run 的 options 优先级高于 Agent 的默认 config。
+    const timeoutMs = context.options.timeoutMs ?? context.config.requestTimeoutMs;
+    if (timeoutMs !== undefined) {
+        request.timeoutMs = timeoutMs;
+    }
+    const maxRetries = context.options.maxRetries ?? context.config.maxRetries;
+    if (maxRetries !== undefined) {
+        request.maxRetries = maxRetries;
+    }
+    const retryDelayMs = context.options.retryDelayMs ?? context.config.retryDelayMs;
+    if (retryDelayMs !== undefined) {
+        request.retryDelayMs = retryDelayMs;
+    }
+    const retryMaxDelayMs = context.options.retryMaxDelayMs ?? context.config.retryMaxDelayMs;
+    if (retryMaxDelayMs !== undefined) {
+        request.retryMaxDelayMs = retryMaxDelayMs;
+    }
+}
+function mergeTokenUsage(current, next) {
+    if (next === undefined) {
+        return current;
+    }
+    if (current === undefined) {
+        return { ...next };
+    }
+    const merged = {};
+    const promptTokens = addOptionalNumbers(current.promptTokens, next.promptTokens);
+    const completionTokens = addOptionalNumbers(current.completionTokens, next.completionTokens);
+    const totalTokens = addOptionalNumbers(current.totalTokens, next.totalTokens);
+    if (promptTokens !== undefined) {
+        merged.promptTokens = promptTokens;
+    }
+    if (completionTokens !== undefined) {
+        merged.completionTokens = completionTokens;
+    }
+    if (totalTokens !== undefined) {
+        merged.totalTokens = totalTokens;
+    }
+    return merged;
+}
+function addOptionalNumbers(left, right) {
+    if (left === undefined) {
+        return right;
+    }
+    if (right === undefined) {
+        return left;
+    }
+    return left + right;
+}
+//# sourceMappingURL=tool-calling-executor.js.map