@gt-fe/eap-runtime 0.0.21 → 0.0.22

package/README.md

@@ -164,7 +164,7 @@ DSL / 契约细节见 `.kiro/specs/04-runtime-core/design.md` §1.4 与 `src/gra
 |------|------|------|
 | `EAP_PREINSTALL_ROOT` | — | 预装根；也可用 `GraphLoader({ preinstallRoot })` |
 | `EAP_PRELOAD_REQUIRE_READY` | 关 | 缺 `.ready` → `runtime.preload.missing` |
-| `EAP_PRELOAD_REQUIRE_CHECKSUM` | 关 | snapshot 须含 sha256 或 artifacts。加载期比对文件摘要，不匹配则 warn、不中断 |
+| `EAP_PRELOAD_REQUIRE_CHECKSUM` | 关 | snapshot 须含 sha256 或 artifacts。开启时摘要不匹配抛 `RUNTIME_PRELOAD_PACKAGE_CORRUPT`；未开仍 warn、不中断 |
 | `EAP_PRELOAD_USER_SKILL_OVERRIDE` | 关 | `users` 优先于 `shared` |
 | `EAP_PRELOAD_VALIDATE_SKILL_IO` | 关 | 校验 Skill `inputDef.required`（`state.skillInput`） |
 | `EAP_PRELOAD_DEFINITION_CACHE` | 有预装时开 | 定义缓存；`0`/`false` 关闭，`1`/`true` 强制开 |

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

@@ -28,7 +28,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, } from '../../session/apply-session-compression.js';
+import { applySessionCompression, withCompressionSummaryModel, } from '../../session/apply-session-compression.js';
 import { applySessionMemory, } from '../../session/apply-session-memory.js';
 // ─────────────────────────────────────────────
 // Default Graph DSL fallback
@@ -199,7 +199,9 @@ export class InvokeOrchestrator {
                     sessionId,
                     userId: effectiveUserId,
                     taskId: task.id,
-                    options: this.sessionCompression,
+                    options: await withCompressionSummaryModel(this.sessionCompression, () => this.graphLoader
+                        ? this.graphLoader.resolveDefaultModel(agentCode, req.agentVersion)
+                        : Promise.resolve(undefined)),
                 }),
                 userId: effectiveUserId,
                 agentCode,
@@ -356,6 +358,7 @@ export class InvokeOrchestrator {
             ? graphResult.finalState.messages
             : [];
         const newMessages = sessionVisibleGraphMessages(allMessages.slice(initialMessagesCount), finishPoints);
+        const duration = Date.now() - startTime;
         await persistTurnTranscript(this.messageService, {
             sessionId,
             taskId: task.id,
@@ -363,9 +366,9 @@ export class InvokeOrchestrator {
             messages: newMessages,
             fallbackAssistantContent: graphResult.output ?? '',
             assistantTokenCount: tokenUsage.output,
+            assistantDurationMs: duration,
         });
         // ─── Step 8: 返回 InvokeResponse ───
-        const duration = Date.now() - startTime;
         // 从本轮 Graph 执行结果中提取 tool 事件明细（供 CLI / UI 渲染 ReAct 循环）
         const toolEvents = extractToolEvents(newMessages);
         return this.buildResponse(traceId, {

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

@@ -23,7 +23,7 @@ import { buildHitlWaitingTaskOutput, buildTurnGraphMessages, buildTurnTranscript
 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';
-import { iterSessionCompression, } from '../../session/apply-session-compression.js';
+import { iterSessionCompression, withCompressionSummaryModel, } from '../../session/apply-session-compression.js';
 import { applySessionMemory, } from '../../session/apply-session-memory.js';
 import { resolveTokenDetail, shouldEmitTokenSse } from '../../token/token-detail.js';
 import { SSEEmitter } from '../../sse/sse-emitter.js';
@@ -215,12 +215,15 @@ export class StreamOrchestrator {
         const agentSystemPrompt = await resolveAgentSystemPromptFromLoader(this.graphLoader, agentCode, req.agentVersion);
         // 组装 GraphState：有 Checkpoint 历史则只追加本轮 user，避免双重 append
         let history = messageRecordsToGraphMessages(sessionContext.messages);
+        const compressionOptions = await withCompressionSummaryModel(this.sessionCompression, () => this.graphLoader
+            ? this.graphLoader.resolveDefaultModel(agentCode, req.agentVersion)
+            : Promise.resolve(undefined));
         for await (const step of iterSessionCompression({
             history,
             sessionId,
             userId,
             taskId,
-            options: this.sessionCompression,
+            options: compressionOptions,
         })) {
             if (step.kind === 'history') {
                 history = step.messages;
@@ -405,6 +408,7 @@ export class StreamOrchestrator {
                 assistantReasoningContent,
             }),
             assistantTokenCount: tokenStats.total.output ?? 0,
+            assistantDurationMs: duration,
         });
         // 关闭 SSE 连接
         emitter.close();

package/dist/checkpoint/file-checkpoint-saver.d.ts

@@ -1,9 +1,12 @@
 /**
  * FileCheckpointSaver — 本地 JSON 文件存储
  * 适用场景：本地开发、单机部署
+ * 目录名对 threadId 做 encodeURIComponent：子图槽 `sessionId#父节点id` 不会变成带 `#` 的目录。
  */
 import type { ICheckpointSaver } from './contracts/checkpoint-saver.contract.js';
 import type { CheckpointData } from '../graph/contracts/executable-graph.js';
+/** 存储键可含 `#`（子图槽）；目录名百分号编码，避免 URL/Markdown 把 `#` 当片段。 */
+export declare function checkpointFileThreadDir(baseDir: string, threadId: string): string;
 export declare class FileCheckpointSaver implements ICheckpointSaver {
     private readonly baseDir;
     constructor(baseDir: string);
@@ -11,6 +14,7 @@ export declare class FileCheckpointSaver implements ICheckpointSaver {
     load(threadId: string): Promise<CheckpointData | null>;
     loadByCheckpointId(checkpointId: string, threadId?: string): Promise<CheckpointData | null>;
     list(threadId: string): Promise<CheckpointData[]>;
+    private readLatestId;
     private readCheckpoint;
     /**
      * Fork: 从指定 Checkpoint 创建新的执行线程

package/dist/checkpoint/file-checkpoint-saver.js

@@ -1,36 +1,51 @@
 /**
  * FileCheckpointSaver — 本地 JSON 文件存储
  * 适用场景：本地开发、单机部署
+ * 目录名对 threadId 做 encodeURIComponent：子图槽 `sessionId#父节点id` 不会变成带 `#` 的目录。
  */
 import { readdir, readFile, writeFile, mkdir } from 'node:fs/promises';
 import { join } from 'node:path';
 import { stringifyJsonSafe } from './checkpoint-serializer.js';
+/** 存储键可含 `#`（子图槽）；目录名百分号编码，避免 URL/Markdown 把 `#` 当片段。 */
+export function checkpointFileThreadDir(baseDir, threadId) {
+    return join(baseDir, encodeURIComponent(threadId));
+}
+function threadDirCandidates(baseDir, threadId) {
+    const encoded = checkpointFileThreadDir(baseDir, threadId);
+    const raw = join(baseDir, threadId);
+    return encoded === raw ? [encoded] : [encoded, raw];
+}
 export class FileCheckpointSaver {
     baseDir;
     constructor(baseDir) {
         this.baseDir = baseDir;
     }
     async save(threadId, data) {
-        const dir = join(this.baseDir, threadId);
+        const dir = checkpointFileThreadDir(this.baseDir, threadId);
         await mkdir(dir, { recursive: true });
         await writeFile(join(dir, `${data.checkpointId}.json`), stringifyJsonSafe(data));
         // 更新 latest 指针
         await writeFile(join(dir, 'latest.json'), JSON.stringify({ checkpointId: data.checkpointId }));
     }
     async load(threadId) {
-        try {
-            const latestRaw = await readFile(join(this.baseDir, threadId, 'latest.json'), 'utf-8');
-            const { checkpointId } = JSON.parse(latestRaw);
-            return this.loadByCheckpointId(checkpointId, threadId);
-        }
-        catch {
-            return null;
+        for (const dir of threadDirCandidates(this.baseDir, threadId)) {
+            const checkpointId = await this.readLatestId(dir);
+            if (!checkpointId)
+                continue;
+            const data = await this.readCheckpoint(join(dir, `${checkpointId}.json`));
+            if (data)
+                return data;
         }
+        return null;
     }
     async loadByCheckpointId(checkpointId, threadId) {
-        // If threadId provided, look directly; otherwise scan all thread dirs
         if (threadId) {
-            return this.readCheckpoint(join(this.baseDir, threadId, `${checkpointId}.json`));
+            for (const dir of threadDirCandidates(this.baseDir, threadId)) {
+                const data = await this.readCheckpoint(join(dir, `${checkpointId}.json`));
+                if (data)
+                    return data;
+            }
+            return null;
         }
         // ponytail: brute scan — upgrade to index file if perf matters
         try {
@@ -45,21 +60,35 @@ export class FileCheckpointSaver {
         return null;
     }
     async list(threadId) {
-        const dir = join(this.baseDir, threadId);
-        try {
-            const files = await readdir(dir);
-            const results = [];
-            for (const f of files) {
-                if (f === 'latest.json' || !f.endsWith('.json'))
-                    continue;
-                const data = await this.readCheckpoint(join(dir, f));
-                if (data)
-                    results.push(data);
+        for (const dir of threadDirCandidates(this.baseDir, threadId)) {
+            try {
+                const files = await readdir(dir);
+                const results = [];
+                for (const f of files) {
+                    if (f === 'latest.json' || !f.endsWith('.json'))
+                        continue;
+                    const data = await this.readCheckpoint(join(dir, f));
+                    if (data)
+                        results.push(data);
+                }
+                if (results.length > 0) {
+                    return results.sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+                }
+            }
+            catch {
+                // try next candidate
             }
-            return results.sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+        }
+        return [];
+    }
+    async readLatestId(dir) {
+        try {
+            const latestRaw = await readFile(join(dir, 'latest.json'), 'utf-8');
+            const { checkpointId } = JSON.parse(latestRaw);
+            return typeof checkpointId === 'string' && checkpointId.trim() ? checkpointId : null;
         }
         catch {
-            return [];
+            return null;
         }
     }
     async readCheckpoint(filePath) {

package/dist/checkpoint/index.d.ts

@@ -6,7 +6,7 @@ export { restoreCheckpoint } from './restore-checkpoint.js';
 export { notifyCheckpointRef, stripCheckpointCollectors } from './checkpoint-ref-notify.js';
 export { createCheckpointData, serializeCheckpoint, deserializeCheckpoint, stringifyJsonSafe, toJsonSafe, } from './checkpoint-serializer.js';
 export type { CreateCheckpointParams } from './checkpoint-serializer.js';
-export { FileCheckpointSaver } from './file-checkpoint-saver.js';
+export { FileCheckpointSaver, checkpointFileThreadDir } from './file-checkpoint-saver.js';
 export { InMemoryCheckpointSaver } from './in-memory-checkpoint-saver.js';
 export { MongoCheckpointSaver } from './mongo-checkpoint-saver.js';
 export type { IMongoCollection, CheckpointDocument } from './mongo-checkpoint-saver.js';

package/dist/checkpoint/index.js

@@ -5,7 +5,7 @@ export { CompositeCheckpointSaver } from './composite-checkpoint-saver.js';
 export { restoreCheckpoint } from './restore-checkpoint.js';
 export { notifyCheckpointRef, stripCheckpointCollectors } from './checkpoint-ref-notify.js';
 export { createCheckpointData, serializeCheckpoint, deserializeCheckpoint, stringifyJsonSafe, toJsonSafe, } from './checkpoint-serializer.js';
-export { FileCheckpointSaver } from './file-checkpoint-saver.js';
+export { FileCheckpointSaver, checkpointFileThreadDir } from './file-checkpoint-saver.js';
 export { InMemoryCheckpointSaver } from './in-memory-checkpoint-saver.js';
 export { MongoCheckpointSaver } from './mongo-checkpoint-saver.js';
 export { PostgresCheckpointSaver } from './pg-checkpoint-saver.js';

package/dist/graph/adapters/langgraph-checkpointer.d.ts

@@ -29,6 +29,7 @@ export declare class LangGraphCheckpointer extends BaseCheckpointSaver {
     putWrites(config: RunnableConfig, writes: PendingWrite[], taskId: string): Promise<void>;
     list(config: RunnableConfig, options?: ListOptions): AsyncIterableIterator<CheckpointTuple>;
     private extractThreadId;
+    private extractCheckpointNs;
     private checkpointDataToTuple;
     /**
      * 优先还原 put() 时写入的 engineSnapshot；旧数据兜底补齐 pending_sends=[]。
@@ -37,4 +38,14 @@ export declare class LangGraphCheckpointer extends BaseCheckpointSaver {
     private checkpointToData;
     private extractExtraState;
 }
+/**
+ * ICheckpointSaver 仍按一个 threadId 分槽。
+ * 父图 ns 为空，槽位=threadId（HITL/多轮仍等于 sessionId）。
+ * 子图 ns 非空，槽位=threadId#ns，不覆盖父 latest。
+ */
+export declare function checkpointStorageThreadId(threadId: string, checkpointNs?: string): string;
+/** 在上一份路径后追加当前节点 id；空 id 或与末项相同则不追加。 */
+export declare function nextHistoryPath(previous: string[] | undefined, currentNodeId: string): string[];
+/** 优先用图状态 channel；旧 checkpoint 没有该 channel 时退回按 currentNode 追加。 */
+export declare function historyPathFromChannel(channel: unknown, previousHistoryPath: string[] | undefined, currentNodeId: string): string[];
 export {};

package/dist/graph/adapters/langgraph-checkpointer.js

@@ -33,7 +33,7 @@ export class LangGraphCheckpointer extends BaseCheckpointSaver {
             data = await this.saver.loadByCheckpointId(checkpointId);
         }
         else {
-            data = await this.saver.load(threadId);
+            data = await this.saver.load(checkpointStorageThreadId(threadId, this.extractCheckpointNs(config)));
         }
         if (!data) {
             return undefined;
@@ -42,8 +42,10 @@ export class LangGraphCheckpointer extends BaseCheckpointSaver {
     }
     async put(config, checkpoint, metadata, _newVersions) {
         const threadId = this.extractThreadId(config) ?? `thread-${Date.now()}`;
-        const data = this.checkpointToData(threadId, checkpoint, metadata);
-        await this.saver.save(threadId, stripCheckpointCollectors(data));
+        const storageThreadId = checkpointStorageThreadId(threadId, this.extractCheckpointNs(config));
+        const previous = await this.saver.load(storageThreadId);
+        const data = this.checkpointToData(storageThreadId, checkpoint, previous?.historyPath);
+        await this.saver.save(storageThreadId, stripCheckpointCollectors(data));
         await notifyCheckpointRef(data);
         return {
             ...config,
@@ -80,7 +82,7 @@ export class LangGraphCheckpointer extends BaseCheckpointSaver {
         if (!threadId) {
             return;
         }
-        let checkpoints = await this.saver.list(threadId);
+        let checkpoints = await this.saver.list(checkpointStorageThreadId(threadId, this.extractCheckpointNs(config)));
         checkpoints.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
         if (options?.before) {
             const beforeId = options.before.configurable?.['checkpoint_id'];
@@ -101,6 +103,9 @@ export class LangGraphCheckpointer extends BaseCheckpointSaver {
     extractThreadId(config) {
         return config.configurable?.['thread_id'];
     }
+    extractCheckpointNs(config) {
+        return String(config.configurable?.['checkpoint_ns'] ?? '').trim();
+    }
     checkpointDataToTuple(data, config) {
         const checkpoint = this.restoreLangGraphCheckpoint(data);
         const metadata = {
@@ -112,7 +117,7 @@ export class LangGraphCheckpointer extends BaseCheckpointSaver {
             ...config,
             configurable: {
                 ...config.configurable,
-                thread_id: data.threadId,
+                thread_id: this.extractThreadId(config) ?? data.threadId,
                 checkpoint_id: data.checkpointId,
             },
         };
@@ -162,20 +167,20 @@ export class LangGraphCheckpointer extends BaseCheckpointSaver {
             channel_values: {
                 messages: data.state.messages ?? [],
                 currentNode: data.currentNodeId,
+                historyPath: data.historyPath ?? [],
                 ...this.extractExtraState(data),
             },
-            channel_versions: { messages: 1, currentNode: 1 },
+            channel_versions: { messages: 1, currentNode: 1, historyPath: 1 },
             versions_seen: {},
             pending_sends: [],
         };
     }
-    checkpointToData(threadId, checkpoint, metadata) {
+    checkpointToData(threadId, checkpoint, previousHistoryPath) {
         const messages = Array.isArray(checkpoint.channel_values['messages'])
             ? checkpoint.channel_values['messages']
             : [];
         const currentNodeId = checkpoint.channel_values['currentNode'] ?? '';
-        const step = Number.isFinite(metadata.step) ? Math.max(0, Math.min(metadata.step, 1000)) : 0;
-        const historyPath = Array.from({ length: step }, () => 'node');
+        const historyPath = historyPathFromChannel(checkpoint.channel_values['historyPath'], previousHistoryPath, currentNodeId);
         const raw = checkpoint;
         return {
             checkpointId: checkpoint.id,
@@ -211,3 +216,37 @@ export class LangGraphCheckpointer extends BaseCheckpointSaver {
         return rest;
     }
 }
+/**
+ * ICheckpointSaver 仍按一个 threadId 分槽。
+ * 父图 ns 为空，槽位=threadId（HITL/多轮仍等于 sessionId）。
+ * 子图 ns 非空，槽位=threadId#ns，不覆盖父 latest。
+ */
+export function checkpointStorageThreadId(threadId, checkpointNs) {
+    const ns = (checkpointNs ?? '').trim().replace(/[/\\]/g, '_');
+    if (!ns)
+        return threadId;
+    return `${threadId}#${ns}`;
+}
+/** 在上一份路径后追加当前节点 id；空 id 或与末项相同则不追加。 */
+export function nextHistoryPath(previous, currentNodeId) {
+    const path = Array.isArray(previous) ? [...previous] : [];
+    const id = currentNodeId.trim();
+    if (!id)
+        return path;
+    if (path[path.length - 1] === id)
+        return path;
+    path.push(id);
+    if (path.length > 1000)
+        return path.slice(path.length - 1000);
+    return path;
+}
+/** 优先用图状态 channel；旧 checkpoint 没有该 channel 时退回按 currentNode 追加。 */
+export function historyPathFromChannel(channel, previousHistoryPath, currentNodeId) {
+    if (Array.isArray(channel) && channel.length > 0) {
+        const path = channel.filter((id) => typeof id === 'string' && id.trim().length > 0);
+        if (path.length > 0) {
+            return path.length > 1000 ? path.slice(path.length - 1000) : path;
+        }
+    }
+    return nextHistoryPath(previousHistoryPath, currentNodeId);
+}

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

@@ -19,6 +19,12 @@ 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}。
+ */
+/** 并行节点各自返回 [id] 时合并进同一路径；末项相同不重复。 */
+export declare function mergeHistoryPath(current: unknown, update: unknown): string[];
 /**
  * LangGraphAdapter — 基于 @langchain/langgraph 的 IStateGraphEngine 实现
  *
@@ -112,10 +118,12 @@ export declare class LangGraphAdapter implements IStateGraphEngine {
      * 本方法无 DSL，无法编译出可用 `_engineInstance`。
      */
     restore(checkpointData: CheckpointData): Promise<ExecutableGraph>;
+    private checkpointConfigurable;
     /**
      * 根据节点类型创建对应的执行函数
      */
     private createNodeFunction;
+    private createNodeFunctionBody;
     private createSkillBindNodeFunction;
     private buildSkillCatalog;
     private createToolNodeFunction;

package/dist/graph/adapters/langgraph.adapter.js

@@ -9,6 +9,7 @@
  */
 import { StateGraph, START, END, } from '@langchain/langgraph';
 import { resolveCheckpointThreadId } from '../../session/persist-turn-messages.js';
+import { checkpointStorageThreadId } from './langgraph-checkpointer.js';
 import { LangGraphCheckpointer } from './langgraph-checkpointer.js';
 import { SubGraphCompiler } from './subgraph-compiler.js';
 import { assertEmbeddedSubgraphsAreFlat } from './graph-nesting.js';
@@ -44,6 +45,24 @@ export const DEFAULT_GRAPH_RECURSION_LIMIT = 50;
  * LangGraph `recursionLimit` 计 superstep（每进一个节点 +1），不是 ReAct 圈数。
  * 图上 `config.maxIterations` 优先；缺省 {@link DEFAULT_GRAPH_RECURSION_LIMIT}。
  */
+/** 并行节点各自返回 [id] 时合并进同一路径；末项相同不重复。 */
+export function mergeHistoryPath(current, update) {
+    const path = Array.isArray(current)
+        ? current.filter((id) => typeof id === 'string' && id.trim().length > 0)
+        : [];
+    const add = Array.isArray(update) ? update : [];
+    for (const raw of add) {
+        if (typeof raw !== 'string')
+            continue;
+        const id = raw.trim();
+        if (!id)
+            continue;
+        if (path[path.length - 1] === id)
+            continue;
+        path.push(id);
+    }
+    return path.length > 1000 ? path.slice(path.length - 1000) : path;
+}
 function langGraphRunOptions(dsl, extra) {
     const raw = dsl.config?.maxIterations;
     const recursionLimit = typeof raw === 'number' && Number.isFinite(raw) && raw > 0
@@ -365,6 +384,10 @@ export class LangGraphAdapter {
                     value: (_current, update) => update,
                     default: () => '',
                 },
+                historyPath: {
+                    value: (current, update) => mergeHistoryPath(current, update),
+                    default: () => [],
+                },
                 // ── 运行期上下文（ephemeral）：由 invoke/stream 入口注入，节点只读 ──
                 userId: ephemeral(''),
                 // agentId 已废弃：channel 保留仅为旧 Checkpoint 反序列化兼容，新代码只写 agentCode
@@ -375,6 +398,7 @@ export class LangGraphAdapter {
                 correlationId: ephemeral(''),
                 taskId: ephemeral(''),
                 sessionId: ephemeral(''),
+                checkpointNs: ephemeral(undefined),
                 skillIsolateContext: ephemeral(undefined),
                 loadedTools: ephemeral(undefined),
                 loadedSkills: ephemeral(undefined),
@@ -511,13 +535,7 @@ export class LangGraphAdapter {
         const producer = runWithExecutionTrace({ ...traceCtx, stream: streamBag }, () => (async () => {
             try {
                 const streamIterator = await ref.compiled.stream(input, langGraphRunOptions(ref.dsl, {
-                    configurable: {
-                        thread_id: resolveCheckpointThreadId({
-                            sessionId: typeof state.sessionId === 'string' ? state.sessionId : undefined,
-                            taskId: state.taskId,
-                            graphId: graph.id,
-                        }),
-                    },
+                    configurable: this.checkpointConfigurable(state, graph),
                     streamMode: 'updates',
                 }));
                 for await (const update of streamIterator) {
@@ -557,13 +575,7 @@ export class LangGraphAdapter {
         const traceCtx = executionTraceFromState(state);
         // 只补 collector/traceId。子图套娃时外层 stream 袋经 ?? 保留。
         const result = await runWithExecutionTrace(traceCtx, () => ref.compiled.invoke(input, langGraphRunOptions(ref.dsl, {
-            configurable: {
-                thread_id: resolveCheckpointThreadId({
-                    sessionId: typeof state.sessionId === 'string' ? state.sessionId : undefined,
-                    taskId: state.taskId,
-                    graphId: graph.id,
-                }),
-            },
+            configurable: this.checkpointConfigurable(state, graph),
         })));
         const duration = Date.now() - startTime;
         const messages = Array.isArray(result['messages']) ? result['messages'] : [];
@@ -656,10 +668,35 @@ export class LangGraphAdapter {
     // ─────────────────────────────────────────────
     // Private helpers
     // ─────────────────────────────────────────────
+    checkpointConfigurable(state, graph) {
+        const thread_id = resolveCheckpointThreadId({
+            sessionId: typeof state.sessionId === 'string' ? state.sessionId : undefined,
+            taskId: state.taskId,
+            graphId: graph.id,
+        });
+        const ns = typeof state.checkpointNs === 'string' ? state.checkpointNs.trim() : '';
+        // 子图是独立 compile 再 invoke，LangGraph put 不一定带回 checkpoint_ns；槽位编进 thread_id。
+        return { thread_id: checkpointStorageThreadId(thread_id, ns) };
+    }
     /**
      * 根据节点类型创建对应的执行函数
      */
     createNodeFunction(node) {
+        const impl = this.createNodeFunctionBody(node);
+        return async (state) => {
+            const update = await impl(state);
+            const patch = update && typeof update === 'object' ? { ...update } : {};
+            const currentNode = typeof patch['currentNode'] === 'string' && String(patch['currentNode']).trim()
+                ? String(patch['currentNode']).trim()
+                : node.id;
+            if (!Array.isArray(patch['historyPath'])) {
+                patch['historyPath'] = [currentNode];
+            }
+            patch['currentNode'] = currentNode;
+            return patch;
+        };
+    }
+    createNodeFunctionBody(node) {
         switch (node.type) {
             case 'llm':
                 return this.createLLMNodeFunction(node);
@@ -1366,7 +1403,10 @@ export class LangGraphAdapter {
                 if (msg.role === 'assistant' && Array.isArray(msg.toolCalls) && msg.toolCalls.length > 0) {
                     // tool.called 由 Tool 节点在真正执行时发出，此处不再把 LLM function-call 当执行开始
                     // 子图节点的 updates 是内层已 stream 过的回写，不要再发空 reasoning chunk
-                    if (subgraphNodeIds.has(nodeId) || silentNodeIds.has(nodeId)) {
+                    if (silentNodeIds.has(nodeId)) {
+                        continue;
+                    }
+                    if (subgraphNodeIds.has(nodeId) && streamedTextThisTurn) {
                         continue;
                     }
                     const hasText = typeof msg.content === 'string' && msg.content.trim().length > 0;
@@ -1393,7 +1433,9 @@ export class LangGraphAdapter {
                     continue;
                 }
                 if (msg.role === 'assistant' && typeof msg.content === 'string' && msg.content.length > 0) {
-                    if (silentNodeIds.has(nodeId) || subgraphNodeIds.has(nodeId))
+                    if (silentNodeIds.has(nodeId))
+                        continue;
+                    if (subgraphNodeIds.has(nodeId) && streamedTextThisTurn)
                         continue;
                     // 已通过 onChunk 推送过 token，避免整段重复
                     if (streamedTextThisTurn) {

package/dist/graph/adapters/skill-isolate.d.ts

@@ -1,17 +1,13 @@
 /**
  * Skill 子图可选隔离（实验口）。仅节点 `isolateContext: true`。
  * 只把本轮输入给子图，回写最后一条带正文的 assistant；没有则不回写。
- * 隔离时不写父 session Checkpoint。
- * 子图内 HITL 未按隔离线程设计：skillIsolateContext 为 true 时禁止 interrupt。
+ * 子图 Checkpoint / HITL 走 `sessionId#父节点id`，不写父 latest。
  */
 import type { GraphMessage } from '../contracts/executable-graph.js';
 import type { GraphNode } from '../contracts/executable-graph.js';
-export declare const SKILL_ISOLATE_HITL_MESSAGE = "Skill isolateContext \u4E0D\u80FD\u4E0E\u5B50\u56FE\u5185\u4EBA\u5DE5\u786E\u8BA4\u4E00\u8D77\u4F7F\u7528\u3002\u5173\u6389 isolate\uFF0C\u6216\u4E0D\u8981\u5728\u8BE5 Skill \u91CC\u4F7F\u7528 require_confirmation / beforeTool ask\u3002";
 /** 只认节点配置。进程环境变量不会给所有 subgraph 开隔离。 */
 export declare function isSkillContextIsolated(node: GraphNode | undefined): boolean;
 export declare function isolatedSkillMessages(parentMessages: GraphMessage[], skillInput: unknown): GraphMessage[];
 /** 只回写最后一条带正文的 assistant；没有则空数组，避免把 tool 行丢给父图。 */
 export declare function isolatedSkillOutput(added: GraphMessage[]): GraphMessage[];
 export declare function isIsolatedSkillState(state: Record<string, unknown> | undefined): boolean;
-/** 隔离子图即将 HITL 时拒绝，避免写错父线程 Checkpoint。 */
-export declare function assertIsolatedSkillAllowsHitl(state: Record<string, unknown> | undefined): void;

package/dist/graph/adapters/skill-isolate.js

@@ -1,11 +1,8 @@
 /**
  * Skill 子图可选隔离（实验口）。仅节点 `isolateContext: true`。
  * 只把本轮输入给子图，回写最后一条带正文的 assistant；没有则不回写。
- * 隔离时不写父 session Checkpoint。
- * 子图内 HITL 未按隔离线程设计：skillIsolateContext 为 true 时禁止 interrupt。
+ * 子图 Checkpoint / HITL 走 `sessionId#父节点id`，不写父 latest。
  */
-import { AppError, ErrorCodes } from '@gt-fe/eap-contracts';
-export const SKILL_ISOLATE_HITL_MESSAGE = 'Skill isolateContext 不能与子图内人工确认一起使用。关掉 isolate，或不要在该 Skill 里使用 require_confirmation / beforeTool ask。';
 /** 只认节点配置。进程环境变量不会给所有 subgraph 开隔离。 */
 export function isSkillContextIsolated(node) {
     return node?.config?.['isolateContext'] === true;
@@ -40,11 +37,3 @@ export function isolatedSkillOutput(added) {
 export function isIsolatedSkillState(state) {
     return state?.['skillIsolateContext'] === true;
 }
-/** 隔离子图即将 HITL 时拒绝，避免写错父线程 Checkpoint。 */
-export function assertIsolatedSkillAllowsHitl(state) {
-    if (!isIsolatedSkillState(state))
-        return;
-    throw new AppError(ErrorCodes.GRAPH_EXECUTION_ERROR, SKILL_ISOLATE_HITL_MESSAGE, {
-        exposeMessage: true,
-    });
-}