@fllf/agent-sdk 0.1.2 → 0.1.3

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

@@ -0,0 +1 @@
+{"version":3,"file":"base-executor.d.ts","sourceRoot":"","sources":["../../src/executors/base-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,WAAW,EACX,WAAW,EACd,MAAM,QAAQ,CAAC;AAChB,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,EACR,YAAY,EACZ,aAAa,EACb,WAAW,EACd,MAAM,QAAQ,CAAC;AAKhB,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAExE,8BAAsB,YAAa,YAAW,aAAa;IACvD,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAEzD,SAAS,CAAC,iBAAiB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;IAQ3D,SAAS,CAAC,sBAAsB,CAC5B,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,OAAO;cAQM,yBAAyB,CACrC,OAAO,EAAE,YAAY,EACrB,WAAW,EAAE,OAAO,GACrB,OAAO,CAAC,OAAO,EAAE,CAAC;cAOL,iBAAiB,CAC7B,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,OAAO,EAAE,GACpB,OAAO,CAAC,WAAW,EAAE,CAAC;IAIzB,SAAS,CAAC,gBAAgB,CACtB,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,GAAE,yBAA8B,GACxC,WAAW;cAIE,cAAc,CAC1B,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,OAAO,EAAE,GACpB,OAAO,CAAC,OAAO,EAAE,CAAC;CAIxB"}

package/dist/executors/base-executor.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseExecutor = void 0;
+const messages_1 = require("../messages");
+const chat_request_builder_1 = require("./chat-request-builder");
+class BaseExecutor {
+    createUserMessage(context) {
+        return new messages_1.Message(context.input, 'user', context.options.metadata ? { metadata: context.options.metadata } : {});
+    }
+    createAssistantMessage(content, metadata) {
+        return new messages_1.Message(content, 'assistant', metadata ? { metadata } : {});
+    }
+    async getHistoryWithUserMessage(context, userMessage) {
+        return [
+            ...(await context.history.get()),
+            userMessage,
+        ];
+    }
+    async buildChatMessages(context, messages) {
+        return await (0, chat_request_builder_1.buildChatMessages)(context, messages);
+    }
+    buildChatRequest(context, messages, options = {}) {
+        return (0, chat_request_builder_1.buildChatRequest)(context, messages, options);
+    }
+    async commitMessages(context, messages) {
+        await context.history.addMany(messages);
+        return await context.history.get();
+    }
+}
+exports.BaseExecutor = BaseExecutor;
+//# sourceMappingURL=base-executor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base-executor.js","sourceRoot":"","sources":["../../src/executors/base-executor.ts"],"names":[],"mappings":";;;AAIA,0CAAsC;AAMtC,iEAGgC;AAGhC,MAAsB,YAAY;IAGpB,iBAAiB,CAAC,OAAqB;QAC7C,OAAO,IAAI,kBAAO,CACd,OAAO,CAAC,KAAK,EACb,MAAM,EACN,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CACzE,CAAC;IACN,CAAC;IAES,sBAAsB,CAC5B,OAAe,EACf,QAAkC;QAElC,OAAO,IAAI,kBAAO,CACd,OAAO,EACP,WAAW,EACX,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAC/B,CAAC;IACN,CAAC;IAES,KAAK,CAAC,yBAAyB,CACrC,OAAqB,EACrB,WAAoB;QAEpB,OAAO;YACH,GAAG,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;YAChC,WAAW;SACd,CAAC;IACN,CAAC;IAES,KAAK,CAAC,iBAAiB,CAC7B,OAAqB,EACrB,QAAmB;QAEnB,OAAO,MAAM,IAAA,wCAAiB,EAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACtD,CAAC;IAES,gBAAgB,CACtB,OAAqB,EACrB,QAAuB,EACvB,UAAqC,EAAE;QAEvC,OAAO,IAAA,uCAAgB,EAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;IAES,KAAK,CAAC,cAAc,CAC1B,OAAqB,EACrB,QAAmB;QAEnB,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACxC,OAAO,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IACvC,CAAC;CACJ;AAtDD,oCAsDC"}

package/dist/executors/base.d.ts

@@ -1,9 +1,9 @@
 import type { Config } from '../config';
-import type { MessageHistory } from '../history';
-import type { ChatModel, TokenUsage } from '../llm';
-import type { Message } from '../messages';
+import type { ContextCompressor, MessageHistory } from '../history';
+import type { ChatModel, ChatToolCall, TokenUsage } from '../llm';
+import type { Message, MessageContent } from '../messages';
 import type { Observer } from '../observability';
-import type { ToolRegistry } from '../tools';
+import type { ToolCallOutcome, ToolRegistry } from '../tools';
 export interface AgentRunOptions {
     sessionId?: string;
     model?: string;
@@ -29,7 +29,7 @@ export interface AgentContext {
     runId: string;
     agentName: string;
     sessionId: string;
-    input: string;
+    input: MessageContent;
     options: AgentRunOptions;
     llm: ChatModel;
     history: MessageHistory;
@@ -37,8 +37,39 @@ export interface AgentContext {
     observer: Observer | undefined;
     systemPrompt: string | undefined;
     config: Config;
+    /**
+     * 可选的历史压缩策略：超出 maxInputTokens 时把被截断的旧消息
+     * 压缩成摘要注入，而不是直接丢弃。未配置时保持纯截断行为。
+     */
+    contextCompressor?: ContextCompressor | undefined;
 }
 export interface AgentExecutor {
     run(context: AgentContext): Promise<AgentResult>;
 }
+export type AgentStreamEventType = 'agent:start' | 'agent:text_delta' | 'agent:tool_call' | 'agent:tool_result' | 'agent:end' | 'agent:error';
+export interface AgentStreamEvent {
+    type: AgentStreamEventType;
+    runId: string;
+    timestamp: Date;
+    agentName?: string | undefined;
+    sessionId?: string | undefined;
+    delta?: string | undefined;
+    output?: string | undefined;
+    message?: Message | undefined;
+    /**
+     * agent:tool_call 事件携带模型请求的工具调用。
+     */
+    toolCall?: ChatToolCall | undefined;
+    /**
+     * agent:tool_result 事件携带工具执行结果（含 isError 标记）。
+     */
+    toolResult?: ToolCallOutcome | undefined;
+    usage?: TokenUsage | undefined;
+    raw?: unknown;
+    error?: unknown;
+    metadata?: Record<string, unknown> | undefined;
+}
+export interface StreamingAgentExecutor extends AgentExecutor {
+    stream(context: AgentContext): AsyncIterable<AgentStreamEvent>;
+}
 //# sourceMappingURL=base.d.ts.map

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

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

package/dist/executors/chat-request-builder.d.ts

@@ -0,0 +1,10 @@
+import type { ChatMessage, ChatRequest } from '../llm';
+import { Message } from '../messages';
+import type { AgentContext } from './base';
+export interface ChatRequestBuilderOptions {
+    includeTools?: boolean;
+    toolChoice?: ChatRequest['toolChoice'];
+}
+export declare function buildChatMessages(context: AgentContext, messages: Message[]): Promise<ChatMessage[]>;
+export declare function buildChatRequest(context: AgentContext, messages: ChatMessage[], options?: ChatRequestBuilderOptions): ChatRequest;
+//# sourceMappingURL=chat-request-builder.d.ts.map

package/dist/executors/chat-request-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-request-builder.d.ts","sourceRoot":"","sources":["../../src/executors/chat-request-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,WAAW,EACX,WAAW,EACd,MAAM,QAAQ,CAAC;AAKhB,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAE3C,MAAM,WAAW,yBAAyB;IACtC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC;CAC1C;AAED,wBAAsB,iBAAiB,CACnC,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,OAAO,EAAE,GACpB,OAAO,CAAC,WAAW,EAAE,CAAC,CAwCxB;AAED,wBAAgB,gBAAgB,CAC5B,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,GAAE,yBAA8B,GACxC,WAAW,CA0Cb"}

package/dist/executors/chat-request-builder.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildChatMessages = buildChatMessages;
+exports.buildChatRequest = buildChatRequest;
+const history_1 = require("../history");
+const messages_1 = require("../messages");
+async function buildChatMessages(context, messages) {
+    const systemPrompt = context.options.systemPrompt ?? context.systemPrompt;
+    const systemMessage = systemPrompt ? new messages_1.Message(systemPrompt, 'system') : undefined;
+    let conversationMessages = messages;
+    const maxInputTokens = context.config.maxInputTokens;
+    if (maxInputTokens !== undefined) {
+        // system prompt 不参与截断，从预算中扣除它的占用。
+        const systemBudget = systemMessage
+            ? Math.ceil(systemPrompt.length / 4) + 8
+            : 0;
+        const { kept, dropped } = (0, history_1.splitByTokenBudget)(messages, Math.max(1, maxInputTokens - systemBudget));
+        conversationMessages = kept;
+        // 配置了 compressor 时不直接丢弃旧消息，而是压缩成前缀摘要注入；
+        // compressor 返回 []（含失败降级）时等价纯截断。
+        const compressor = context.contextCompressor;
+        if (compressor !== undefined && dropped.length > 0) {
+            const prefix = await compressor.compress({
+                dropped,
+                kept,
+                llm: context.llm,
+                signal: context.options.signal,
+            });
+            if (prefix.length > 0) {
+                // kept 已由截断修复过配对；再跑一次修复兜底
+                // compressor 返回以 tool 消息开头的非法前缀。
+                conversationMessages = (0, history_1.withRepairedLeadingToolContext)([...prefix, ...kept]);
+            }
+        }
+    }
+    return [
+        ...(systemMessage ? [systemMessage.toChatMessage()] : []),
+        ...conversationMessages.map((message) => message.toChatMessage()),
+    ];
+}
+function buildChatRequest(context, messages, options = {}) {
+    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;
+    }
+    // 未显式配置时不下发 temperature，保留 provider/模型自身默认值。
+    const temperature = context.options.temperature ?? context.config.temperature;
+    if (temperature !== undefined) {
+        request.temperature = temperature;
+    }
+    const maxTokens = context.options.maxTokens ?? context.config.maxTokens;
+    if (maxTokens !== undefined) {
+        request.maxTokens = maxTokens;
+    }
+    if (options.includeTools) {
+        const tools = context.tools.toToolSchemas();
+        if (tools.length > 0) {
+            request.tools = tools;
+            request.toolChoice = options.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;
+    }
+}
+//# sourceMappingURL=chat-request-builder.js.map

package/dist/executors/chat-request-builder.js.map

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

package/dist/executors/index.d.ts

@@ -1,4 +1,7 @@
-export type { AgentContext, AgentExecutor, AgentResult, AgentRunOptions, } from './base';
+export type { AgentContext, AgentExecutor, AgentResult, AgentRunOptions, AgentStreamEvent, AgentStreamEventType, StreamingAgentExecutor, } from './base';
+export { BaseExecutor } from './base-executor';
+export { buildChatMessages, buildChatRequest, } from './chat-request-builder';
+export type { ChatRequestBuilderOptions } from './chat-request-builder';
 export { RagExecutor } from './rag-executor';
 export type { RagExecutorOptions } from './rag-executor';
 export { SimpleChatExecutor } from './simple-chat-executor';

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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/executors/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACR,YAAY,EACZ,aAAa,EACb,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,GACzB,MAAM,QAAQ,CAAC;AAChB,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EACH,iBAAiB,EACjB,gBAAgB,GACnB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACxE,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

@@ -1,6 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ToolCallingExecutor = exports.SimpleChatExecutor = exports.RagExecutor = void 0;
+exports.ToolCallingExecutor = exports.SimpleChatExecutor = exports.RagExecutor = exports.buildChatRequest = exports.buildChatMessages = exports.BaseExecutor = void 0;
+var base_executor_1 = require("./base-executor");
+Object.defineProperty(exports, "BaseExecutor", { enumerable: true, get: function () { return base_executor_1.BaseExecutor; } });
+var chat_request_builder_1 = require("./chat-request-builder");
+Object.defineProperty(exports, "buildChatMessages", { enumerable: true, get: function () { return chat_request_builder_1.buildChatMessages; } });
+Object.defineProperty(exports, "buildChatRequest", { enumerable: true, get: function () { return chat_request_builder_1.buildChatRequest; } });
 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");

package/dist/executors/index.js.map

@@ -1 +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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/executors/index.ts"],"names":[],"mappings":";;;AASA,iDAA+C;AAAtC,6GAAA,YAAY,OAAA;AACrB,+DAGgC;AAF5B,yHAAA,iBAAiB,OAAA;AACjB,wHAAA,gBAAgB,OAAA;AAGpB,+CAA6C;AAApC,2GAAA,WAAW,OAAA;AAEpB,+DAA4D;AAAnD,0HAAA,kBAAkB,OAAA;AAC3B,iEAA8D;AAArD,4HAAA,mBAAmB,OAAA"}

package/dist/executors/rag-executor.js

@@ -12,7 +12,7 @@ class RagExecutor {
         this.requireCitations = options.requireCitations;
     }
     async run(context) {
-        const answer = await this.pipeline.answer(context.input, this.buildAnswerOptions(context));
+        const answer = await this.pipeline.answer((0, messages_1.contentToText)(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: {

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

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

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

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

@@ -1 +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"}
+{"version":3,"file":"simple-chat-executor.d.ts","sourceRoot":"","sources":["../../src/executors/simple-chat-executor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACR,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,sBAAsB,EACzB,MAAM,QAAQ,CAAC;AAChB,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,qBAAa,kBAAmB,SAAQ,YAAa,YAAW,sBAAsB;IAC5E,GAAG,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAuB/C,MAAM,CAAC,OAAO,EAAE,YAAY,GAAG,aAAa,CAAC,gBAAgB,CAAC;CA4DxE"}

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

@@ -1,21 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SimpleChatExecutor = void 0;
-const messages_1 = require("../messages");
-class SimpleChatExecutor {
+const errors_1 = require("../errors");
+const base_executor_1 = require("./base-executor");
+class SimpleChatExecutor extends base_executor_1.BaseExecutor {
     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 userMessage = this.createUserMessage(context);
+        const messages = await this.getHistoryWithUserMessage(context, userMessage);
+        const request = this.buildChatRequest(context, await this.buildChatMessages(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 assistantMessage = this.createAssistantMessage(response.content);
+        const committedMessages = await this.commitMessages(context, [userMessage, assistantMessage]);
         const result = {
             output: response.content,
-            messages: await context.history.get(),
+            messages: committedMessages,
             raw: response.raw,
         };
         if (response.usage !== undefined) {
@@ -23,55 +21,59 @@ class SimpleChatExecutor {
         }
         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: {
+    async *stream(context) {
+        if (!context.llm.stream) {
+            throw new errors_1.AgentExecutionError('SimpleChatExecutor requires a streaming ChatModel.', {
+                code: 'streaming_model_unsupported',
+                metadata: {
+                    agentName: context.agentName,
+                    model: context.llm.model,
+                    provider: context.llm.name,
+                },
+            });
+        }
+        const userMessage = this.createUserMessage(context);
+        const messages = await this.getHistoryWithUserMessage(context, userMessage);
+        const request = this.buildChatRequest(context, await this.buildChatMessages(context, messages));
+        let output = '';
+        let raw;
+        for await (const chunk of context.llm.stream(request)) {
+            if (chunk.raw !== undefined) {
+                raw = chunk.raw;
+            }
+            if (chunk.contentDelta === undefined || chunk.contentDelta.length === 0) {
+                continue;
+            }
+            output += chunk.contentDelta;
+            const event = {
+                type: 'agent:text_delta',
+                runId: context.runId,
+                timestamp: new Date(),
+                agentName: context.agentName,
+                sessionId: context.sessionId,
+                delta: chunk.contentDelta,
+            };
+            if (chunk.raw !== undefined) {
+                event.raw = chunk.raw;
+            }
+            yield event;
+        }
+        const assistantMessage = this.createAssistantMessage(output);
+        await this.commitMessages(context, [userMessage, assistantMessage]);
+        const endEvent = {
+            type: 'agent:end',
             runId: context.runId,
-            observer: context.observer,
+            timestamp: new Date(),
             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;
+            output,
+            message: assistantMessage,
+        };
+        if (raw !== undefined) {
+            endEvent.raw = raw;
+        }
+        yield endEvent;
     }
 }
+exports.SimpleChatExecutor = SimpleChatExecutor;
 //# sourceMappingURL=simple-chat-executor.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"simple-chat-executor.js","sourceRoot":"","sources":["../../src/executors/simple-chat-executor.ts"],"names":[],"mappings":";;;AACA,0CAAsC;AAGtC,MAAa,kBAAkB;IAC3B,KAAK,CAAC,GAAG,CAAC,OAAqB;QAC3B,MAAM,WAAW,GAAG,IAAI,kBAAO,CAC3B,OAAO,CAAC,KAAK,EACb,MAAM,EACN,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CACzE,CAAC;QAEF,MAAM,QAAQ,GAAG;YACb,GAAG,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;YAChC,WAAW;SACd,CAAC;QACF,MAAM,OAAO,GAAG,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACpD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEjD,MAAM,gBAAgB,GAAG,IAAI,kBAAO,CAAC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QACpE,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC,CAAC;QAE/D,MAAM,MAAM,GAAgB;YACxB,MAAM,EAAE,QAAQ,CAAC,OAAO;YACxB,QAAQ,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE;YACrC,GAAG,EAAE,QAAQ,CAAC,GAAG;SACpB,CAAC;QAEF,IAAI,QAAQ,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC/B,MAAM,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;QAClC,CAAC;QAED,OAAO,MAAM,CAAC;IAClB,CAAC;CACJ;AA9BD,gDA8BC;AAED,SAAS,gBAAgB,CAAC,OAAqB,EAAE,OAAkB;IAC/D,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,YAAY,CAAC;IAC1E,MAAM,QAAQ,GAAG;QACb,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,kBAAO,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9E,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;KACvD,CAAC;IAEF,MAAM,OAAO,GAAgB;QACzB,QAAQ;QACR,KAAK,EAAE;YACH,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,SAAS,EAAE,OAAO,CAAC,SAAS;SAC/B;KACJ,CAAC;IACF,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC;IACnE,IAAI,KAAK,EAAE,CAAC;QACR,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;IAC1B,CAAC;IAED,OAAO,CAAC,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC;IAEhF,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC;IACxE,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IAClC,CAAC;IAED,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACzB,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;IAC5C,CAAC;IAED,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAEtC,OAAO,OAAO,CAAC;AACnB,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAqB,EAAE,OAAoB;IACpE,2CAA2C;IAC3C,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC;IAC/E,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IAClC,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC;IAC3E,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,CAAC,UAAU,GAAG,UAAU,CAAC;IACpC,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC;IACjF,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,CAAC,YAAY,GAAG,YAAY,CAAC;IACxC,CAAC;IAED,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC;IAC1F,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,CAAC,eAAe,GAAG,eAAe,CAAC;IAC9C,CAAC;AACL,CAAC"}
+{"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

@@ -1,10 +1,28 @@
-import type { AgentContext, AgentExecutor, AgentResult } from './base';
+import type { AgentContext, AgentResult, AgentStreamEvent, StreamingAgentExecutor } from './base';
 export interface ToolCallingExecutorOptions {
     maxIterations?: number;
+    /**
+     * 迭代预算用尽时的策略：
+     * - finalize（默认）：追加一轮不带工具的请求，让模型给出文字收尾，
+     *   完整轨迹会写入 history。
+     * - throw：抛出 AgentExecutionError，但已执行的轨迹仍会写入 history，
+     *   避免丢失用户消息和工具调用记录。
+     */
+    onMaxIterations?: 'finalize' | 'throw';
 }
-export declare class ToolCallingExecutor implements AgentExecutor {
+export declare class ToolCallingExecutor implements StreamingAgentExecutor {
     private readonly maxIterations;
+    private readonly onMaxIterations;
     constructor(options?: ToolCallingExecutorOptions);
     run(context: AgentContext): Promise<AgentResult>;
+    stream(context: AgentContext): AsyncIterable<AgentStreamEvent>;
+    /**
+     * 执行一轮模型请求。模型支持流式时边流边发 text_delta 事件，
+     * 否则退化为一次非流式请求并整体发出。两种情况都返回聚合后的完整响应。
+     */
+    private streamOneTurn;
+    private createTextDeltaEvent;
+    private createEndEvent;
+    private handleMaxIterations;
 }
 //# sourceMappingURL=tool-calling-executor.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"tool-calling-executor.d.ts","sourceRoot":"","sources":["../../src/executors/tool-calling-executor.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACR,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,sBAAsB,EACzB,MAAM,QAAQ,CAAC;AAMhB,MAAM,WAAW,0BAA0B;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC;CAC1C;AAeD,qBAAa,mBAAoB,YAAW,sBAAsB;IAC9D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAuB;gBAE3C,OAAO,GAAE,0BAA+B;IAK9C,GAAG,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAsB/C,MAAM,CAAC,OAAO,EAAE,YAAY,GAAG,aAAa,CAAC,gBAAgB,CAAC;IAmDrE;;;OAGG;YACY,aAAa;IA2B5B,OAAO,CAAC,oBAAoB;YAoBd,cAAc;YA6Bd,mBAAmB;CAiBpC"}