@gt-fe/eap-runtime 0.0.23 → 0.0.25

package/dist/session/persist-turn-messages.js

@@ -305,31 +305,149 @@ function extractReasoningContent(reasoning) {
  * - Session 级 Checkpoint 持有图内 messages（含 reasoning）
  * - 当 Checkpoint 已有历史时，只追加本轮 user，避免双重 append
  * - Checkpoint 缺失/无 messages 时，回退 Session 全量历史
+ * - 压缩针对 Checkpoint（无则 Session）中的模型上下文；压成功且来自 Checkpoint 时由调用方设 `replaceCheckpointMessages`
  */
 export async function buildTurnGraphMessages(params) {
-    const newUser = { role: 'user', content: params.input };
-    const history = params.history;
-    if (!params.checkpointSaver || !params.threadId || history.length === 0) {
-        return [...history, newUser];
+    const facing = await loadModelFacingHistory({
+        sessionHistory: params.history,
+        checkpointSaver: params.checkpointSaver,
+        threadId: params.threadId,
+    });
+    return turnGraphMessagesAfterCompression({
+        history: facing.messages,
+        input: params.input,
+        fromCheckpoint: facing.fromCheckpoint,
+        compressed: false,
+    }).messages;
+}
+/**
+ * 模型上下文：Checkpoint 已有 messages 用它，否则用 Session 历史。
+ * 压缩必须压这份列表，不能只压 Session 再在有 Checkpoint 时丢掉。
+ */
+export async function loadModelFacingHistory(params) {
+    const sessionHistory = params.sessionHistory ?? [];
+    if (!params.checkpointSaver || !params.threadId) {
+        return { messages: sessionHistory, fromCheckpoint: false };
     }
     const cp = await params.checkpointSaver.load(params.threadId);
-    if (checkpointHasMessages(cp)) {
-        return [newUser];
+    const checkpointMessages = graphMessagesFromCheckpoint(cp);
+    if (checkpointMessages.length > 0) {
+        return { messages: checkpointMessages, fromCheckpoint: true };
     }
-    return [...history, newUser];
+    return { messages: sessionHistory, fromCheckpoint: false };
 }
-function checkpointHasMessages(cp) {
+/**
+ * 压缩后的入图列表。来自 Checkpoint 且本轮压成功：整表 `__set` 覆盖，写入最新 Checkpoint。
+ * 未压且来自 Checkpoint：只追加本轮 user。无 Checkpoint：历史 + 本轮 user。
+ */
+export function turnGraphMessagesAfterCompression(params) {
+    const newUser = { role: 'user', content: params.input };
+    if (params.fromCheckpoint && params.compressed) {
+        return {
+            messages: [...params.history, newUser],
+            replaceCheckpointMessages: true,
+        };
+    }
+    if (params.fromCheckpoint) {
+        return { messages: [newUser], replaceCheckpointMessages: false };
+    }
+    return {
+        messages: [...params.history, newUser],
+        replaceCheckpointMessages: false,
+    };
+}
+/**
+ * invoke 从 Graph 最终 messages 切本轮增量的起点。
+ * 覆盖（`__set`）或无 Checkpoint：入图数组长度（已含本轮 user）。
+ * 追加到已有 Checkpoint：模型上下文条数 + 入图条数（通常 1 条 user）。
+ */
+export function persistGraphMessageBaseline(params) {
+    if (params.replaceCheckpointMessages || !params.fromCheckpoint) {
+        return params.graphInputCount;
+    }
+    return params.modelFacingCount + params.graphInputCount;
+}
+export function graphMessagesFromCheckpoint(cp) {
     if (!cp)
-        return false;
-    if (Array.isArray(cp.state?.messages) && cp.state.messages.length > 0)
-        return true;
+        return [];
     const channelValues = cp.engineSnapshot?.['channel_values'];
     if (channelValues && typeof channelValues === 'object') {
         const messages = channelValues['messages'];
-        if (Array.isArray(messages) && messages.length > 0)
-            return true;
+        if (Array.isArray(messages) && messages.length > 0) {
+            return unknownListToGraphMessages(messages);
+        }
+    }
+    if (Array.isArray(cp.state?.messages) && cp.state.messages.length > 0) {
+        return unknownListToGraphMessages(cp.state.messages);
+    }
+    return [];
+}
+function unknownListToGraphMessages(raw) {
+    return raw.map((msg) => unknownToGraphMessage(msg));
+}
+function unknownToGraphMessage(msg) {
+    if (typeof msg !== 'object' || msg === null) {
+        return { role: 'user', content: String(msg) };
     }
-    return false;
+    const m = msg;
+    const nested = m.kwargs && typeof m.kwargs === 'object' ? m.kwargs : undefined;
+    const lcName = Array.isArray(m.id) ? m.id[m.id.length - 1] : undefined;
+    const typeHint = m.type === 'constructor' ? undefined : m.type;
+    const role = graphRoleFromUnknown(m.role ?? nested?.role ?? nested?.type ?? typeHint ?? lcName);
+    const content = messageContentToString(m.content ?? nested?.content);
+    const toolCalls = (m.toolCalls ?? m.tool_calls ?? nested?.tool_calls);
+    const toolCallId = (typeof m.toolCallId === 'string' && m.toolCallId) ||
+        (typeof m.tool_call_id === 'string' && m.tool_call_id) ||
+        (typeof nested?.tool_call_id === 'string' && nested.tool_call_id) ||
+        undefined;
+    const toolName = (typeof m.toolName === 'string' && m.toolName) ||
+        (typeof nested?.name === 'string' && nested.name) ||
+        undefined;
+    const success = typeof m.success === 'boolean' ? m.success : undefined;
+    const reasoningContent = (typeof m.reasoningContent === 'string' && m.reasoningContent) ||
+        (typeof m.reasoning_content === 'string' && m.reasoning_content) ||
+        undefined;
+    return {
+        role,
+        content,
+        ...(toolCalls ? { toolCalls } : {}),
+        ...(toolCallId ? { toolCallId } : {}),
+        ...(toolName ? { toolName } : {}),
+        ...(success !== undefined ? { success } : {}),
+        ...(reasoningContent ? { reasoningContent } : {}),
+    };
+}
+function graphRoleFromUnknown(raw) {
+    if (raw === 'user' || raw === 'assistant' || raw === 'system' || raw === 'tool')
+        return raw;
+    if (raw === 'human' || raw === 'HumanMessage')
+        return 'user';
+    if (raw === 'ai' || raw === 'AIMessage')
+        return 'assistant';
+    if (raw === 'system' || raw === 'SystemMessage')
+        return 'system';
+    if (raw === 'tool' || raw === 'ToolMessage')
+        return 'tool';
+    return 'user';
+}
+function messageContentToString(content) {
+    if (typeof content === 'string')
+        return content;
+    if (Array.isArray(content)) {
+        return content
+            .map((part) => {
+            if (typeof part === 'string')
+                return part;
+            if (part && typeof part === 'object' && typeof part.text === 'string') {
+                return part.text;
+            }
+            return '';
+        })
+            .join('');
+    }
+    if (content == null)
+        return '';
+    return String(content);
 }
 export function buildHitlWaitingTaskOutput(params) {
     return {
@@ -362,7 +480,7 @@ export function extractHitlThreadId(output) {
  * 与 LangGraph put / 子图内 HITL interrupt 同一把钥匙。
  *
  * 注意：session 级 thread + 全量 Session 历史同时注入会导致 messages 双重 append。
- * 组装本轮 Graph 输入请用 {@link buildTurnGraphMessages}（有 Checkpoint 历史则只追加 user）。
+ * 组装本轮 Graph 输入请用 {@link loadModelFacingHistory} 与 {@link turnGraphMessagesAfterCompression}。
  */
 export function resolveCheckpointThreadId(params) {
     if (params.sessionId)

package/dist/sse/events/response-events.d.ts

@@ -5,7 +5,7 @@
  * - response.final
  *
  * 可选事件：
- * - response.max_iterations_reached
+ * - response.max_iterations_reached（契约保留；调度步上限走 task.error / runtime.graph.max_iterations，不发本事件）
  *
  * @see design.md §1.6 SSE事件协议定义
  */
@@ -16,7 +16,7 @@ export interface ResponseFinalPayload {
     /** 回复格式（如 text, markdown, json） */
     format: string;
 }
-/** 达到最大迭代次数 */
+/** 契约保留。整图调度步上限不发此事件。 */
 export interface ResponseMaxIterationsReachedPayload {
     /** 最大迭代次数 */
     maxIterations: number;

package/dist/sse/events/response-events.js

@@ -5,7 +5,7 @@
  * - response.final
  *
  * 可选事件：
- * - response.max_iterations_reached
+ * - response.max_iterations_reached（契约保留；调度步上限走 task.error / runtime.graph.max_iterations，不发本事件）
  *
  * @see design.md §1.6 SSE事件协议定义
  */

package/dist/task/contracts/task-manager.contract.d.ts

@@ -46,6 +46,8 @@ export interface TaskRecord {
     correlationId: string;
     /** 用户输入 */
     input: unknown;
+    /** 整图超时（毫秒）。未写入旧记录时 resume 用平台缺省 */
+    timeout?: number;
     /** 执行输出 */
     output: unknown | null;
     /** 当前状态 */

package/dist/task/index.d.ts

@@ -3,5 +3,6 @@ export { TaskService, InMemoryTaskRepository } from './task.service.js';
 export type { ITaskRepository } from './task.service.js';
 export { TaskTimeoutManager } from './task-timeout.js';
 export type { TaskTimeoutManagerOptions } from './task-timeout.js';
+export { resolveTaskTimeoutMs } from './resolve-task-timeout.js';
 export { TaskProgressTracker } from './task-progress-tracker.js';
 export type { TaskProgressInfo } from './task-progress-tracker.js';

package/dist/task/index.js

@@ -2,4 +2,5 @@
 export * from './contracts/index.js';
 export { TaskService, InMemoryTaskRepository } from './task.service.js';
 export { TaskTimeoutManager } from './task-timeout.js';
+export { resolveTaskTimeoutMs } from './resolve-task-timeout.js';
 export { TaskProgressTracker } from './task-progress-tracker.js';

package/dist/task/resolve-task-timeout.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 整图超时：请求 config.timeout，否则图 config.timeout，否则平台缺省 1200000 毫秒（20 分钟）。
+ * 官方模板图上不写 timeout，用平台缺省。LLM HTTP 超时、HITL 等待另算。
+ */
+/** 请求显式值优先，否则图配置，否则 {@link DEFAULT_GRAPH_TIMEOUT_MS}。 */
+export declare function resolveTaskTimeoutMs(requestTimeout?: number, graphTimeout?: number): number;

package/dist/task/resolve-task-timeout.js

@@ -0,0 +1,16 @@
+/**
+ * 整图超时：请求 config.timeout，否则图 config.timeout，否则平台缺省 1200000 毫秒（20 分钟）。
+ * 官方模板图上不写 timeout，用平台缺省。LLM HTTP 超时、HITL 等待另算。
+ */
+import { DEFAULT_GRAPH_TIMEOUT_MS } from '../common/types.js';
+function positiveMs(value) {
+    if (typeof value !== 'number' || !Number.isFinite(value) || value <= 0)
+        return undefined;
+    return Math.trunc(value);
+}
+/** 请求显式值优先，否则图配置，否则 {@link DEFAULT_GRAPH_TIMEOUT_MS}。 */
+export function resolveTaskTimeoutMs(requestTimeout, graphTimeout) {
+    return (positiveMs(requestTimeout) ??
+        positiveMs(graphTimeout) ??
+        DEFAULT_GRAPH_TIMEOUT_MS);
+}

package/dist/task/task-timeout.d.ts

@@ -13,7 +13,7 @@
  * TaskTimeoutManager 配置选项
  */
 export interface TaskTimeoutManagerOptions {
-    /** 默认超时时间（毫秒），默认 60000 (60s) */
+    /** 默认超时时间（毫秒），默认 {@link DEFAULT_GRAPH_TIMEOUT_MS} */
     defaultTimeoutMs?: number;
 }
 /**

package/dist/task/task-timeout.js

@@ -9,11 +9,12 @@
  * @see design.md §1.1 任务管理 — Task级超时
  * @see requirements.md Requirement 7 AC4
  */
+import { DEFAULT_GRAPH_TIMEOUT_MS } from '../common/types.js';
 // ─────────────────────────────────────────────
 // Default Constants
 // ─────────────────────────────────────────────
-/** 默认超时：60 秒 */
-const DEFAULT_TIMEOUT_MS = 60_000;
+/** 默认超时：与图/请求缺省同一常数 */
+const DEFAULT_TIMEOUT_MS = DEFAULT_GRAPH_TIMEOUT_MS;
 /** 最大允许超时：3600 秒（1 小时） */
 const MAX_TIMEOUT_MS = 3_600_000;
 // ─────────────────────────────────────────────

package/dist/task/task.service.js

@@ -84,6 +84,7 @@ export class TaskService {
             userId: params.userId,
             correlationId: params.correlationId,
             input: params.input,
+            timeout: params.timeout,
             output: null,
             status: 'pending',
             traceId: null,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gt-fe/eap-runtime",
-  "version": "0.0.23",
+  "version": "0.0.25",
   "description": "Enterprise Agent Platform — Runtime核心：Graph执行引擎、Task生命周期、Session管理、Checkpoint持久化",
   "type": "module",
   "main": "dist/index.js",
@@ -20,7 +20,7 @@
     "ioredis": "^5.4.0",
     "pg": "^8.13.0",
     "yaml": "^2.6.1",
-    "@gt-fe/eap-contracts": "0.0.13"
+    "@gt-fe/eap-contracts": "0.0.14"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",