@gt-fe/eap-runtime 0.0.23 → 0.0.25

package/README.md

@@ -8,6 +8,7 @@ Enterprise Agent Platform **执行引擎**（LangGraph.js）：Agent Graph 编
 
 | 日期 | 摘要 |
 |------|------|
+| 2026-09-14 | 会话滑动窗口压缩默认开；`EAP_RUNTIME_COMPRESSION=0` 关闭 |
 | 2026-09-08 | [`docs/TODO.md`](./docs/TODO.md) 改为主路径状态（已落地 / 不在本包），不是排期 |
 | 2026-08-29 | 待办收口：[`docs/TODO.md`](./docs/TODO.md)。此后压缩已挂主路径（默认关）；窗口展示不在 Runtime；Gateway 须 `tools/list` |
 | 2026-08-24 | 0.0.10：官方 Skill / Harness、`ForkParams`、对话详情、存储两档。依赖 `@eap/contracts@0.0.9`。详见 [CHANGELOG.md](./CHANGELOG.md) |

package/dist/api/handlers/invoke.handler.d.ts

@@ -22,6 +22,7 @@ import type { TokenStatsService } from '../../token/token-stats.service.js';
 import type { TokenBudgetGuard } from '../../token/token-budget-guard.js';
 import type { SessionBudgetChecker } from '../../token/session-budget-checker.js';
 import type { InvokeRequest, InvokeResponse } from '../routes/agent.routes.js';
+import type { TaskTimeoutManager } from '../../task/task-timeout.js';
 import { type GraphLoader } from '../../registry/graph-loader.js';
 import type { ICheckpointSaver } from '../../checkpoint/contracts/checkpoint-saver.contract.js';
 import type { ITraceCollector } from '../../contracts/trace-collector.js';
@@ -46,6 +47,8 @@ export interface InvokeOrchestratorDeps {
     traceCollector?: ITraceCollector;
     sessionCompression?: SessionCompressionOptions;
     sessionMemory?: SessionMemoryOptions;
+    /** 未注入时不启动整图超时（测试桩） */
+    timeoutManager?: TaskTimeoutManager;
 }
 /**
  * InvokeOrchestrator — 同步调用全流程编排
@@ -66,6 +69,7 @@ export declare class InvokeOrchestrator {
     private readonly traceCollector?;
     private readonly sessionCompression?;
     private readonly sessionMemory?;
+    private readonly timeoutManager?;
     constructor(deps: InvokeOrchestratorDeps);
     /**
      * 执行同步调用编排

package/dist/api/handlers/invoke.handler.js

@@ -15,12 +15,17 @@
  * @see requirements.md Requirement 11 AC1-AC2
  */
 import { randomUUID } from 'node:crypto';
-import { buildHitlWaitingTaskOutput, buildTurnGraphMessages, messageRecordsToGraphMessages, persistHitlWaitingPlaceholder, persistTurnTranscript, persistUserTurnMessage, resolveCheckpointThreadId, sessionVisibleGraphMessages, } from '../../session/persist-turn-messages.js';
+import { buildHitlWaitingTaskOutput, loadModelFacingHistory, messageRecordsToGraphMessages, persistGraphMessageBaseline, turnGraphMessagesAfterCompression, persistHitlWaitingPlaceholder, persistTurnTranscript, persistUserTurnMessage, resolveCheckpointThreadId, sessionVisibleGraphMessages, } from '../../session/persist-turn-messages.js';
 import { SessionBudgetExhaustedError } from '../../token/session-budget-checker.js';
 import { TokenBudgetExhaustedError } from '../../token/token-budget-guard.js';
 import { recordTaskTokenUsages, tokenUsagesFromLlmChannel, } from '../../token/record-task-token-usage.js';
 import { resolveExecutionContext } from '../../governance/governance-client.js';
 import { resolveSkillInputFromInvokeInput } from '../../registry/skill-io-guard.js';
+import { AppError, ErrorCodes } from '@gt-fe/eap-contracts';
+import { classifyRuntimeError } from '../../utils/http-error.js';
+import { DEFAULT_GRAPH_TIMEOUT_MS } from '../../common/types.js';
+import { resolveTaskTimeoutMs } from '../../task/resolve-task-timeout.js';
+import { runWithExecutionTrace } from '../../graph/execution-trace-context.js';
 import { resolveAgentSystemPromptFromLoader } from '../../registry/graph-loader.js';
 import { toLoadedToolMap } from '../../tool/loaded-tool-definition.js';
 import { toLoadedSkillMap } from '../../tool/system-prompt-builder.js';
@@ -28,7 +33,7 @@ import { assembleLoadedTools } from '../../tool/harness-primitives.js';
 import { resolveAgentCode } from '../../common/agent-code.js';
 import { unwrapHitlPaused } from '../../graph/hitl/hitl-handler.js';
 import { resolveTraceId } from '../../common/trace-id.js';
-import { applySessionCompression, withCompressionSummaryModel, } from '../../session/apply-session-compression.js';
+import { runSessionCompression, withCompressionSummaryModel, } from '../../session/apply-session-compression.js';
 import { applySessionMemory, } from '../../session/apply-session-memory.js';
 // ─────────────────────────────────────────────
 // Default Graph DSL fallback
@@ -44,7 +49,7 @@ const DEFAULT_GRAPH_DSL = {
         { from: '__start__', to: 'llm' },
         { from: 'llm', to: '__end__' },
     ],
-    config: { timeout: 60000 },
+    config: { timeout: DEFAULT_GRAPH_TIMEOUT_MS },
 };
 // ─────────────────────────────────────────────
 // InvokeOrchestrator
@@ -68,6 +73,7 @@ export class InvokeOrchestrator {
     traceCollector;
     sessionCompression;
     sessionMemory;
+    timeoutManager;
     constructor(deps) {
         this.sessionContextService = deps.sessionContextService;
         this.taskService = deps.taskService;
@@ -81,6 +87,7 @@ export class InvokeOrchestrator {
         this.traceCollector = deps.traceCollector;
         this.sessionCompression = deps.sessionCompression;
         this.sessionMemory = deps.sessionMemory;
+        this.timeoutManager = deps.timeoutManager;
     }
     /**
      * 执行同步调用编排
@@ -143,8 +150,12 @@ export class InvokeOrchestrator {
                 throw error;
             }
         }
-        // ─── Step 3: 创建 Task（Hosting 传入 taskId 时复用）───
-        const timeout = req.config?.timeout ?? 60000;
+        // ─── Step 3: 加载图并创建 Task（Hosting 传入 taskId 时复用）───
+        const loadOpts = { agentVersion: req.agentVersion };
+        const graphDsl = this.graphLoader
+            ? await this.graphLoader.loadGraph(agentCode, loadOpts)
+            : DEFAULT_GRAPH_DSL;
+        const timeout = resolveTaskTimeoutMs(req.config?.timeout, graphDsl.config?.timeout);
         const task = await this.taskService.create({
             id: req.taskId,
             agentId: agentCode,
@@ -156,6 +167,9 @@ export class InvokeOrchestrator {
         });
         // ─── Step 4: 启动 Task (pending → running) ───
         await this.taskService.updateStatus(task.id, 'running');
+        const abortSignal = this.timeoutManager?.startTimer(task.id, timeout, async () => {
+            await this.taskService.tryUpdateStatus(task.id, 'running', 'timeout', 'Task execution timed out');
+        });
         // ─── Step 4b: 持久化本轮 user（多轮短期记忆）───
         await persistUserTurnMessage(this.messageService, {
             sessionId,
@@ -166,12 +180,9 @@ export class InvokeOrchestrator {
         // ─── Step 5: 构建/执行 Graph ───
         let graphResult;
         let finishPoints;
+        let persistBaseline = 0;
         try {
             // 构建图 — 每次请求创建独立 StateGraph 实例，确保请求间无共享可变状态
-            const loadOpts = { agentVersion: req.agentVersion };
-            const graphDsl = this.graphLoader
-                ? await this.graphLoader.loadGraph(agentCode, loadOpts)
-                : DEFAULT_GRAPH_DSL;
             const graph = await this.graphEngine.buildGraph(graphDsl);
             finishPoints = graph.finishPoints;
             const loadedToolsBase = this.graphLoader
@@ -192,32 +203,45 @@ export class InvokeOrchestrator {
                 ? (await this.graphLoader.resolveAgentDir(agentCode, req.agentVersion)) ?? undefined
                 : undefined;
             const agentSystemPrompt = await resolveAgentSystemPromptFromLoader(this.graphLoader, agentCode, req.agentVersion);
-            // 组装 GraphState：有 Checkpoint 历史则只追加本轮 user，避免双重 append
+            // 模型上下文：Checkpoint 已有 messages 则压它；压成功用 __set 写回最新 Checkpoint。Message 库不改。
+            const facing = await loadModelFacingHistory({
+                sessionHistory: messageRecordsToGraphMessages(sessionContext.messages),
+                checkpointSaver: this.checkpointSaver,
+                threadId: sessionId,
+            });
+            const compression = await runSessionCompression({
+                history: facing.messages,
+                sessionId,
+                userId: effectiveUserId,
+                taskId: task.id,
+                options: await withCompressionSummaryModel(this.sessionCompression, () => this.graphLoader
+                    ? this.graphLoader.resolveDefaultModel(agentCode, req.agentVersion)
+                    : Promise.resolve(undefined)),
+            });
             const history = await applySessionMemory({
-                history: await applySessionCompression({
-                    history: messageRecordsToGraphMessages(sessionContext.messages),
-                    sessionId,
-                    userId: effectiveUserId,
-                    taskId: task.id,
-                    options: await withCompressionSummaryModel(this.sessionCompression, () => this.graphLoader
-                        ? this.graphLoader.resolveDefaultModel(agentCode, req.agentVersion)
-                        : Promise.resolve(undefined)),
-                }),
+                history: compression.messages,
                 userId: effectiveUserId,
                 agentCode,
                 query: typeof req.input === 'string' ? req.input : undefined,
                 options: this.sessionMemory,
             });
-            const messages = await buildTurnGraphMessages({
+            const { messages, replaceCheckpointMessages } = turnGraphMessagesAfterCompression({
                 history,
                 input: req.input,
-                checkpointSaver: this.checkpointSaver,
-                threadId: sessionId,
+                fromCheckpoint: facing.fromCheckpoint,
+                compressed: compression.compressed,
+            });
+            persistBaseline = persistGraphMessageBaseline({
+                fromCheckpoint: facing.fromCheckpoint,
+                replaceCheckpointMessages,
+                graphInputCount: messages.length,
+                modelFacingCount: facing.messages.length,
             });
             const skillInput = resolveSkillInputFromInvokeInput(req.input);
             // 同步执行图
-            graphResult = await this.graphEngine.invoke(graph, {
+            graphResult = await runWithExecutionTrace({ abortSignal }, () => this.graphEngine.invoke(graph, {
                 messages,
+                replaceCheckpointMessages,
                 userId: effectiveUserId,
                 delegationToken: ctx.delegationToken,
                 agentCode,
@@ -238,7 +262,9 @@ export class InvokeOrchestrator {
                 agentSystemPrompt,
                 traceId: resolveTraceId(req),
                 traceCollector: this.traceCollector,
-            });
+                abortSignal,
+                abortDeadlineMs: Date.now() + timeout,
+            }));
         }
         catch (error) {
             const usages = await this.persistInvokeUsages(task.id, sessionId);
@@ -286,7 +312,7 @@ export class InvokeOrchestrator {
             }
             // ─── 错误处理：Timeout ───
             if (this.isTimeoutError(error)) {
-                await this.taskService.updateStatus(task.id, 'timeout');
+                await this.taskService.tryUpdateStatus(task.id, 'running', 'timeout');
                 return this.buildResponse(traceId, {
                     taskId: task.id,
                     sessionId,
@@ -297,7 +323,9 @@ export class InvokeOrchestrator {
                 });
             }
             // ─── 错误处理：通用错误 ───
-            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            const classified = classifyRuntimeError(error);
+            const fuse = classified.code === ErrorCodes.GRAPH_MAX_ITERATIONS ? classified : undefined;
+            const errorMessage = fuse?.message ?? (error instanceof Error ? error.message : 'Unknown error');
             await this.taskService.updateStatus(task.id, 'failed', errorMessage);
             return this.buildErrorResponse(traceId, {
                 taskId: task.id,
@@ -306,7 +334,10 @@ export class InvokeOrchestrator {
                 tokenUsage,
                 duration: Date.now() - startTime,
                 status: 'failed',
-            });
+            }, fuse ?? error);
+        }
+        finally {
+            this.timeoutManager?.clearTimer(task.id);
         }
         // ─── Step 6: 记录 Token 消耗 ───
         //
@@ -352,12 +383,11 @@ export class InvokeOrchestrator {
         // ─── Step 7: 完成 Task (running → success) ───
         await this.taskService.updateStatus(task.id, 'success', graphResult.output);
         // ─── Step 7b: 持久化本轮 transcript（统一顺序：assistant tool_calls → tool → assistant 文本）───
-        // 按 Session 已有行数切 Graph 增量。多段正文收成一条后 Session 比 Graph 短，切点可能提前；finishPoints 只含一个实际节点 id 时靠最后一条纯文本仍落到 merge。
-        const initialMessagesCount = sessionContext.messages.length + 1;
+        // 切点是入图 messages 基线（压缩 `__set` 后 Graph 短于 Session 全文）。user 已在 4b 写入。
         const allMessages = Array.isArray(graphResult.finalState?.messages)
             ? graphResult.finalState.messages
             : [];
-        const newMessages = sessionVisibleGraphMessages(allMessages.slice(initialMessagesCount), finishPoints);
+        const newMessages = sessionVisibleGraphMessages(allMessages.slice(persistBaseline), finishPoints);
         const duration = Date.now() - startTime;
         await persistTurnTranscript(this.messageService, {
             sessionId,
@@ -387,15 +417,17 @@ export class InvokeOrchestrator {
     buildResponse(traceId, data) {
         return { code: 'ok', data, traceId };
     }
-    buildErrorResponse(traceId, data) {
-        return { code: data.status === 'token_exhausted' ? 'runtime.budget.task_exhausted' : 'runtime.graph.execution_error', data, traceId };
+    buildErrorResponse(traceId, data, error) {
+        if (data.status === 'token_exhausted') {
+            return { code: 'runtime.budget.task_exhausted', data, traceId };
+        }
+        if (error instanceof AppError) {
+            return { code: error.code, data, traceId };
+        }
+        return { code: 'runtime.graph.execution_error', data, traceId };
     }
     isTimeoutError(error) {
-        if (error instanceof Error) {
-            const msg = error.message.toLowerCase();
-            return msg.includes('timeout') || msg.includes('timed out');
-        }
-        return false;
+        return error instanceof Error && /timed out/i.test(error.message);
     }
     async persistInvokeUsages(taskId, sessionId) {
         if (!this.checkpointSaver)

package/dist/api/handlers/stream.handler.d.ts

@@ -33,6 +33,7 @@ import type { StreamRequest } from '../routes/agent.routes.js';
 import { type GraphLoader } from '../../registry/graph-loader.js';
 import type { ICheckpointSaver } from '../../checkpoint/contracts/checkpoint-saver.contract.js';
 import type { ITraceCollector } from '../../contracts/trace-collector.js';
+import type { TaskTimeoutManager } from '../../task/task-timeout.js';
 /**
  * StreamOrchestrator 构造器依赖
  */
@@ -52,6 +53,8 @@ export interface StreamOrchestratorDeps {
     traceCollector?: ITraceCollector;
     sessionCompression?: SessionCompressionOptions;
     sessionMemory?: SessionMemoryOptions;
+    /** 未注入时不启动整图超时（测试桩） */
+    timeoutManager?: TaskTimeoutManager;
 }
 /**
  * StreamOrchestrator — 流式调用全流程编排
@@ -72,6 +75,7 @@ export declare class StreamOrchestrator {
     private readonly traceCollector?;
     private readonly sessionCompression?;
     private readonly sessionMemory?;
+    private readonly timeoutManager?;
     constructor(deps: StreamOrchestratorDeps);
     /**
      * 执行流式调用编排

package/dist/api/handlers/stream.handler.js

@@ -19,7 +19,7 @@
  * @see design.md §1.5 /stream 内部执行逻辑
  * @see requirements.md Requirement 11 AC2
  */
-import { buildHitlWaitingTaskOutput, buildTurnGraphMessages, buildTurnTranscriptFromStreamEvents, extractStreamReasoning, applyStreamTextDelta, createStreamAssistantBuckets, visibleStreamAssistantText, streamAssistantTexts, messageRecordsToGraphMessages, persistHitlWaitingPlaceholder, persistTurnTranscript, persistUserTurnMessage, appendTerminalToolResult, } from '../../session/persist-turn-messages.js';
+import { buildHitlWaitingTaskOutput, buildTurnTranscriptFromStreamEvents, loadModelFacingHistory, turnGraphMessagesAfterCompression, extractStreamReasoning, applyStreamTextDelta, createStreamAssistantBuckets, visibleStreamAssistantText, streamAssistantTexts, messageRecordsToGraphMessages, persistHitlWaitingPlaceholder, persistTurnTranscript, persistUserTurnMessage, appendTerminalToolResult, } from '../../session/persist-turn-messages.js';
 import { SessionBudgetExhaustedError } from '../../token/session-budget-checker.js';
 import { TokenBudgetExhaustedError } from '../../token/token-budget-guard.js';
 import { recordTaskTokenUsages } from '../../token/record-task-token-usage.js';
@@ -39,6 +39,9 @@ import { resolveAgentCode } from '../../common/agent-code.js';
 import { unwrapHitlPaused } from './invoke.handler.js';
 import { buildHitlWaitedPayload } from '../../graph/hitl/hitl-handler.js';
 import { resolveTraceId } from '../../common/trace-id.js';
+import { DEFAULT_GRAPH_TIMEOUT_MS } from '../../common/types.js';
+import { resolveTaskTimeoutMs } from '../../task/resolve-task-timeout.js';
+import { runWithExecutionTrace } from '../../graph/execution-trace-context.js';
 // ─────────────────────────────────────────────
 // Placeholder Graph DSL (Agent Registry 接入前)
 // ─────────────────────────────────────────────
@@ -53,7 +56,7 @@ const DEFAULT_GRAPH_DSL = {
         { from: '__start__', to: 'llm' },
         { from: 'llm', to: '__end__' },
     ],
-    config: { timeout: 60000 },
+    config: { timeout: DEFAULT_GRAPH_TIMEOUT_MS },
 };
 // ─────────────────────────────────────────────
 // StreamOrchestrator
@@ -77,6 +80,7 @@ export class StreamOrchestrator {
     traceCollector;
     sessionCompression;
     sessionMemory;
+    timeoutManager;
     constructor(deps) {
         this.sessionContextService = deps.sessionContextService;
         this.taskService = deps.taskService;
@@ -90,6 +94,7 @@ export class StreamOrchestrator {
         this.traceCollector = deps.traceCollector;
         this.sessionCompression = deps.sessionCompression;
         this.sessionMemory = deps.sessionMemory;
+        this.timeoutManager = deps.timeoutManager;
     }
     /**
      * 执行流式调用编排
@@ -166,8 +171,12 @@ export class StreamOrchestrator {
                 userId,
             }));
         }
-        // ─── Step 3: 创建 Task（Hosting 传入 taskId 时复用）───
-        const timeout = req.config?.timeout ?? 60000;
+        // ─── Step 3: 加载图并创建 Task（Hosting 传入 taskId 时复用）───
+        const loadOpts = { agentVersion: req.agentVersion };
+        const graphDsl = this.graphLoader
+            ? await this.graphLoader.loadGraph(agentCode, loadOpts)
+            : DEFAULT_GRAPH_DSL;
+        const timeout = resolveTaskTimeoutMs(req.config?.timeout, graphDsl.config?.timeout);
         const task = await this.taskService.create({
             id: req.taskId,
             agentId: agentCode,
@@ -180,6 +189,9 @@ export class StreamOrchestrator {
         const taskId = task.id;
         // ─── Step 4: 启动 Task (pending → running) ───
         await this.taskService.updateStatus(taskId, 'running');
+        const abortSignal = this.timeoutManager?.startTimer(taskId, timeout, async () => {
+            await this.taskService.tryUpdateStatus(taskId, 'running', 'timeout', 'Task execution timed out');
+        });
         // ─── Step 4b: 持久化本轮 user（多轮短期记忆）───
         await persistUserTurnMessage(this.messageService, {
             sessionId,
@@ -193,10 +205,6 @@ export class StreamOrchestrator {
             sessionId,
         }));
         // ─── Step 5: 构建 Graph — 每次请求创建独立 StateGraph 实例，确保请求间无共享可变状态 ───
-        const loadOpts = { agentVersion: req.agentVersion };
-        const graphDsl = this.graphLoader
-            ? await this.graphLoader.loadGraph(agentCode, loadOpts)
-            : DEFAULT_GRAPH_DSL;
         const graph = await this.graphEngine.buildGraph(graphDsl);
         const loadedToolsBase = this.graphLoader
             ? toLoadedToolMap(await this.graphLoader.loadToolDefinitions(agentCode, loadOpts))
@@ -213,8 +221,14 @@ export class StreamOrchestrator {
             ? (await this.graphLoader.resolveAgentDir(agentCode, req.agentVersion)) ?? undefined
             : undefined;
         const agentSystemPrompt = await resolveAgentSystemPromptFromLoader(this.graphLoader, agentCode, req.agentVersion);
-        // 组装 GraphState：有 Checkpoint 历史则只追加本轮 user，避免双重 append
-        let history = messageRecordsToGraphMessages(sessionContext.messages);
+        // 模型上下文：Checkpoint 已有 messages 则压它；压成功用 __set 写回最新 Checkpoint。Message 库不改。
+        const facing = await loadModelFacingHistory({
+            sessionHistory: messageRecordsToGraphMessages(sessionContext.messages),
+            checkpointSaver: this.checkpointSaver,
+            threadId: sessionId,
+        });
+        let history = facing.messages;
+        let compressed = false;
         const compressionOptions = await withCompressionSummaryModel(this.sessionCompression, () => this.graphLoader
             ? this.graphLoader.resolveDefaultModel(agentCode, req.agentVersion)
             : Promise.resolve(undefined));
@@ -229,6 +243,9 @@ export class StreamOrchestrator {
                 history = step.messages;
                 continue;
             }
+            if (step.kind === 'completed') {
+                compressed = step.payload.success === true;
+            }
             emitter.emit(this.buildSSEEvent(step.kind === 'started' ? 'session.compression.started' : 'session.compression.completed', correlationId, taskId, { ...step.payload }));
         }
         history = await applySessionMemory({
@@ -239,11 +256,11 @@ export class StreamOrchestrator {
             options: this.sessionMemory,
         });
         const tokenDetail = resolveTokenDetail(req.config?.tokenDetail);
-        const messages = await buildTurnGraphMessages({
+        const { messages, replaceCheckpointMessages } = turnGraphMessagesAfterCompression({
             history,
             input: req.input,
-            checkpointSaver: this.checkpointSaver,
-            threadId: sessionId,
+            fromCheckpoint: facing.fromCheckpoint,
+            compressed,
         });
         const skillInput = resolveSkillInputFromInvokeInput(req.input);
         const assistantBuckets = createStreamAssistantBuckets();
@@ -253,8 +270,9 @@ export class StreamOrchestrator {
         const toolResults = [];
         // ─── Step 6: Graph.stream() 流式执行 ───
         try {
-            const eventStream = this.graphEngine.stream(graph, {
+            const eventStream = runWithExecutionTrace({ abortSignal }, () => this.graphEngine.stream(graph, {
                 messages,
+                replaceCheckpointMessages,
                 userId,
                 delegationToken: executionContext.delegationToken,
                 agentCode,
@@ -275,7 +293,9 @@ export class StreamOrchestrator {
                 agentSystemPrompt,
                 traceId: resolveTraceId(req),
                 traceCollector: this.traceCollector,
-            });
+                abortSignal,
+                abortDeadlineMs: Date.now() + timeout,
+            }));
             // 逐事件转发到 SSE；顺带把节点 token 记入 TokenStatsService（stream 原先未 record → 结尾全 0）
             for await (const runtimeEvent of eventStream) {
                 // 连接已断开则提前退出
@@ -347,7 +367,7 @@ export class StreamOrchestrator {
             // ─── 错误处理：Timeout ───
             if (this.isTimeoutError(error)) {
                 await recordTaskTokenUsages(this.taskService, taskId, this.tokenStatsService.list(taskId));
-                await this.taskService.updateStatus(taskId, 'timeout');
+                await this.taskService.tryUpdateStatus(taskId, 'running', 'timeout');
                 emitter.emit(this.buildSSEEvent('task.error', correlationId, taskId, {
                     code: ErrorCodes.TASK_TIMEOUT,
                     message: 'Task execution timed out',
@@ -363,6 +383,9 @@ export class StreamOrchestrator {
             this.emitErrorAndClose(emitter, correlationId, taskId, error);
             return;
         }
+        finally {
+            this.timeoutManager?.clearTimer(taskId);
+        }
         // ─── Step 7: 发送结束事件序列 ───
         // Emit: response.final（带完整 assistant 文本，供客户端兜底）
         const tokenStats = this.tokenStatsService.getTaskStats(taskId);
@@ -454,10 +477,6 @@ export class StreamOrchestrator {
         emitter.close();
     }
     isTimeoutError(error) {
-        if (error instanceof Error) {
-            const msg = error.message.toLowerCase();
-            return msg.includes('timeout') || msg.includes('timed out');
-        }
-        return false;
+        return error instanceof Error && /timed out/i.test(error.message);
     }
 }

package/dist/api/routes/agent.routes.js

@@ -3,6 +3,7 @@
  *
  * 生产环境由 Hosting 提供对外 HTTP；本模块供 `EAP_DEV_HTTP=1` 本地调试。
  */
+import { classifyRuntimeError } from '../../utils/http-error.js';
 // ─────────────────────────────────────────────
 // Route Handlers
 // ─────────────────────────────────────────────
@@ -85,18 +86,18 @@ export function createAgentRouteHandlers(deps) {
             };
         }
         catch (error) {
-            // 错误处理
             const duration = Date.now() - startTime;
-            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            const classified = classifyRuntimeError(error);
+            const output = classified.exposeMessage ? classified.message : '系统内部错误';
             return {
-                code: 'runtime.graph.execution_error',
+                code: classified.code,
                 data: {
                     taskId: '',
                     sessionId: sessionId ?? '',
-                    output: '',
+                    output,
                     tokenUsage: { input: 0, output: 0, total: 0 },
                     duration,
-                    status: 'failed',
+                    status: classified.code === 'runtime.task.timeout' ? 'timeout' : 'failed',
                 },
                 traceId: '',
             };

package/dist/checkpoint/checkpoint-ref-notify.js

@@ -12,7 +12,7 @@ function pickString(...values) {
     return undefined;
 }
 function omitTraceCollector(record) {
-    const { traceCollector: _drop, ...rest } = record;
+    const { traceCollector: _drop, abortSignal: _abort, abortDeadlineMs: _deadline, ...rest } = record;
     return rest;
 }
 /** 去掉不可序列化的 collector，再交给 Saver。 */

package/dist/common/types.d.ts

@@ -12,6 +12,8 @@
  * - detail: 每次 LLM 调用输出 stats.node_token_usage + 结束时汇总
  */
 export type TokenDetailLevel = 'none' | 'summary' | 'detail';
+/** 未写请求/图 timeout 时的整图缺省（毫秒）。20 分钟，须大于单次 LLM HTTP 缺省 180s。 */
+export declare const DEFAULT_GRAPH_TIMEOUT_MS = 1200000;
 /**
  * Runtime 执行引擎配置
  *
@@ -20,9 +22,11 @@ export type TokenDetailLevel = 'none' | 'summary' | 'detail';
 export interface RuntimeConfig {
     /** Token 统计输出粒度 */
     tokenDetail: TokenDetailLevel;
-    /** Task 执行超时时间（毫秒） */
+    /** Task 执行超时时间（毫秒）。未写请求/图 timeout 时为 {@link DEFAULT_GRAPH_TIMEOUT_MS} */
     timeout: number;
-    /** ReAct 循环最大迭代次数 */
+    /**
+     * @deprecated Runtime 忽略。图级 / 请求级步数不是限长手段。整图限长用 timeout。
+     */
     maxIterations: number;
     /** SSE 心跳间隔（毫秒），默认 30000 */
     heartbeatInterval: number;

package/dist/common/types.js

@@ -5,10 +5,12 @@
  * - @gt-fe/eap-contracts 定义跨模块的公共协议（如 Task 实体、Session 实体、Agent Manifest）
  * - 本文件定义 Runtime 执行引擎内部流转的配置、上下文、枚举等
  */
+/** 未写请求/图 timeout 时的整图缺省（毫秒）。20 分钟，须大于单次 LLM HTTP 缺省 180s。 */
+export const DEFAULT_GRAPH_TIMEOUT_MS = 1_200_000;
 /** RuntimeConfig 默认值 */
 export const DEFAULT_RUNTIME_CONFIG = {
     tokenDetail: 'detail',
-    timeout: 60000,
+    timeout: DEFAULT_GRAPH_TIMEOUT_MS,
     maxIterations: 10,
     heartbeatInterval: 30000,
 };

package/dist/graph/adapters/langgraph.adapter.d.ts

@@ -17,12 +17,14 @@ import type { IToolExecutor } from '../../tool/tool-executor.interface.js';
 import type { IGovernanceClient } from '../../governance/governance-client.js';
 import { type ConditionEvaluatorFn } from '../condition-evaluator.js';
 import type { ExecutionInterceptors } from '../../execution/interceptors.js';
-/** 图未写 `config.maxIterations` 时的 recursionLimit。`agent ⇄ tools` 一圈约 2，50 ≈ 24 次工具往返。 */
-export declare const DEFAULT_GRAPH_RECURSION_LIMIT = 50;
 /**
- * LangGraph `recursionLimit` 计 superstep（每进一个节点 +1），不是 ReAct 圈数。
- * 图上 `config.maxIterations` 优先；缺省 {@link DEFAULT_GRAPH_RECURSION_LIMIT}。
+ * 传给 LangGraph 的 `recursionLimit`：一轮调度（superstep）+1。
+ * 同一步里并行的多个节点只 +1。ReAct 的 llm 再 tool 大约 +2。
+ * 不读图级 / 请求级 `maxIterations`。整图运行时长用 `timeout`。
+ * 配了 Token 配额才会因预算停止。
  */
+export declare const DEFAULT_GRAPH_RECURSION_LIMIT = 5000;
+export declare function isGraphRecursionError(error: unknown): boolean;
 /** 并行节点各自返回 [id] 时合并进同一路径；末项相同不重复。 */
 export declare function mergeHistoryPath(current: unknown, update: unknown): string[];
 /**