@gt-fe/eap-runtime 0.0.32 → 0.0.34

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

@@ -81,7 +81,6 @@ export declare class InvokeOrchestrator {
     execute(req: InvokeRequest, userId: string): Promise<InvokeResponse>;
     private buildResponse;
     private buildErrorResponse;
-    private isTimeoutError;
     private persistInvokeUsages;
 }
 /** @deprecated 请直接从 `graph/hitl/hitl-handler` 导入；此处保留 re-export 兼容旧测试引用 */

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

@@ -26,8 +26,9 @@ 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 { taskAbortKindOf } from '../../task/task-abort.js';
 import { runWithExecutionTrace } from '../../graph/execution-trace-context.js';
-import { resolveAgentSystemPromptFromLoader } from '../../registry/graph-loader.js';
+import { resolveAgentDisplayNameFromLoader, resolveAgentSystemPromptFromLoader, } from '../../registry/graph-loader.js';
 import { toLoadedToolMap } from '../../tool/loaded-tool-definition.js';
 import { toLoadedSkillMap } from '../../tool/system-prompt-builder.js';
 import { assembleLoadedTools } from '../../tool/harness-primitives.js';
@@ -204,6 +205,7 @@ export class InvokeOrchestrator {
                 ? (await this.graphLoader.resolveAgentDir(agentCode, req.agentVersion)) ?? undefined
                 : undefined;
             const agentSystemPrompt = await resolveAgentSystemPromptFromLoader(this.graphLoader, agentCode, req.agentVersion);
+            const agentName = await resolveAgentDisplayNameFromLoader(this.graphLoader, agentCode, req.agentVersion);
             // 模型上下文：Checkpoint 已有 messages 则压它；压成功用 __set 写回最新 Checkpoint。Message 库不改。
             const facing = await loadModelFacingHistory({
                 sessionHistory: messageRecordsToGraphMessages(sessionContext.messages),
@@ -261,6 +263,7 @@ export class InvokeOrchestrator {
                 promptRoots,
                 agentDir,
                 agentSystemPrompt,
+                agentName,
                 traceId: resolveTraceId(req),
                 traceCollector: this.traceCollector,
                 abortSignal,
@@ -311,8 +314,8 @@ export class InvokeOrchestrator {
                     status: 'token_exhausted',
                 });
             }
-            // ─── 错误处理：Timeout ───
-            if (this.isTimeoutError(error)) {
+            const abortKind = taskAbortKindOf(error, abortSignal);
+            if (abortKind === 'timeout') {
                 await this.taskService.tryUpdateStatus(task.id, 'running', 'timeout');
                 return this.buildResponse(traceId, {
                     taskId: task.id,
@@ -323,6 +326,25 @@ export class InvokeOrchestrator {
                     status: 'timeout',
                 });
             }
+            if (abortKind === 'cancelled') {
+                const moved = await this.taskService.tryUpdateStatus(task.id, 'running', 'cancelled');
+                if (!moved) {
+                    await this.taskService.tryUpdateStatus(task.id, 'waiting_hitl', 'cancelled');
+                }
+                // @gt-fe/eap-contracts 的 InvokeStatus 还没有 cancelled。这次不改包，响应体仍写 cancelled。
+                return {
+                    code: 'runtime.task.cancelled',
+                    data: {
+                        taskId: task.id,
+                        sessionId,
+                        output: 'Task cancelled',
+                        tokenUsage,
+                        duration: Date.now() - startTime,
+                        status: 'cancelled',
+                    },
+                    traceId,
+                };
+            }
             // ─── 错误处理：通用错误 ───
             const classified = classifyRuntimeError(error);
             const fuse = classified.code === ErrorCodes.GRAPH_MAX_ITERATIONS ? classified : undefined;
@@ -430,9 +452,6 @@ export class InvokeOrchestrator {
         }
         return { code: 'runtime.graph.execution_error', data, traceId };
     }
-    isTimeoutError(error) {
-        return error instanceof Error && /timed out/i.test(error.message);
-    }
     async persistInvokeUsages(taskId, sessionId) {
         if (!this.checkpointSaver)
             return [];

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

@@ -98,5 +98,4 @@ export declare class StreamOrchestrator {
      * 发射错误事件并关闭连接
      */
     private emitErrorAndClose;
-    private isTimeoutError;
 }

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, buildTurnTranscriptFromStreamEvents, loadModelFacingHistory, turnGraphMessagesAfterCompression, extractStreamReasoning, applyStreamTextDelta, createStreamAssistantBuckets, visibleStreamAssistantText, streamAssistantTexts, messageRecordsToGraphMessages, persistHitlWaitingPlaceholder, persistTurnTranscript, persistUserTurnMessage, appendTerminalToolResult, } from '../../session/persist-turn-messages.js';
+import { buildHitlWaitingTaskOutput, buildTurnTranscriptFromStreamEvents, loadModelFacingHistory, turnGraphMessagesAfterCompression, applyStreamReasoningEvent, applyStreamTextDelta, createStreamAssistantBuckets, createStreamReasoningState, resolvedStreamReasoning, visibleStreamAssistantText, streamAssistantTexts, messageRecordsToGraphMessages, persistHitlWaitingPlaceholder, persistTurnTranscript, persistUserTurnMessage, appendTerminalToolResult, } from '../../session/persist-turn-messages.js';
 import { collectPublicArtifactLinks, collectPublicArtifactLinksFromEvent, injectPublicArtifactLinks, mergeArtifactLinks, } from '../../tool/inject-public-artifact-links.js';
 import { SessionBudgetExhaustedError } from '../../token/session-budget-checker.js';
 import { TokenBudgetExhaustedError } from '../../token/token-budget-guard.js';
@@ -31,7 +31,7 @@ import { SSEEmitter } from '../../sse/sse-emitter.js';
 import { resolveExecutionContext } from '../../governance/governance-client.js';
 import { resolveSkillInputFromInvokeInput } from '../../registry/skill-io-guard.js';
 import { ErrorCodes } from '@gt-fe/eap-contracts';
-import { resolveAgentSystemPromptFromLoader } from '../../registry/graph-loader.js';
+import { resolveAgentDisplayNameFromLoader, resolveAgentSystemPromptFromLoader, } from '../../registry/graph-loader.js';
 import { classifyRuntimeError } from '../../utils/http-error.js';
 import { toLoadedToolMap } from '../../tool/loaded-tool-definition.js';
 import { toLoadedSkillMap } from '../../tool/system-prompt-builder.js';
@@ -42,6 +42,7 @@ 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 { taskAbortKindOf } from '../../task/task-abort.js';
 import { runWithExecutionTrace } from '../../graph/execution-trace-context.js';
 // ─────────────────────────────────────────────
 // Placeholder Graph DSL (Agent Registry 接入前)
@@ -222,6 +223,7 @@ export class StreamOrchestrator {
             ? (await this.graphLoader.resolveAgentDir(agentCode, req.agentVersion)) ?? undefined
             : undefined;
         const agentSystemPrompt = await resolveAgentSystemPromptFromLoader(this.graphLoader, agentCode, req.agentVersion);
+        const agentName = await resolveAgentDisplayNameFromLoader(this.graphLoader, agentCode, req.agentVersion);
         // 模型上下文：Checkpoint 已有 messages 则压它；压成功用 __set 写回最新 Checkpoint。Message 库不改。
         const facing = await loadModelFacingHistory({
             sessionHistory: messageRecordsToGraphMessages(sessionContext.messages),
@@ -265,8 +267,8 @@ export class StreamOrchestrator {
         });
         const skillInput = resolveSkillInputFromInvokeInput(req.input);
         const assistantBuckets = createStreamAssistantBuckets();
+        const reasoningState = createStreamReasoningState();
         let toolCallReasoningContent;
-        let assistantReasoningContent;
         const pendingToolCalls = [];
         const toolResults = [];
         const artifactLinks = [];
@@ -293,6 +295,7 @@ export class StreamOrchestrator {
                 promptRoots,
                 agentDir,
                 agentSystemPrompt,
+                agentName,
                 traceId: resolveTraceId(req),
                 traceCollector: this.traceCollector,
                 abortSignal,
@@ -323,15 +326,11 @@ export class StreamOrchestrator {
                             arguments: p.arguments ?? {},
                         });
                     }
-                    if (typeof p.reasoningContent === 'string' && p.reasoningContent) {
-                        toolCallReasoningContent = p.reasoningContent;
-                    }
+                    toolCallReasoningContent = resolvedStreamReasoning(reasoningState);
                 }
                 appendTerminalToolResult(runtimeEvent.type, runtimeEvent.payload, toolResults);
                 collectPublicArtifactLinksFromEvent(runtimeEvent.type, runtimeEvent.payload, artifactLinks);
-                const streamedReasoning = extractStreamReasoning(runtimeEvent.type, runtimeEvent.payload);
-                if (streamedReasoning)
-                    assistantReasoningContent = streamedReasoning;
+                applyStreamReasoningEvent(reasoningState, runtimeEvent.type, runtimeEvent.payload);
                 applyStreamTextDelta(assistantBuckets, runtimeEvent.type, runtimeEvent.payload);
                 if (shouldEmitTokenSse(tokenDetail, runtimeEvent.type)) {
                     emitter.emit(this.runtimeEventToSSE(runtimeEvent, correlationId, taskId));
@@ -367,13 +366,21 @@ export class StreamOrchestrator {
                 this.emitErrorAndClose(emitter, correlationId, taskId, error);
                 return;
             }
-            // ─── 错误处理：Timeout ───
-            if (this.isTimeoutError(error)) {
+            const abortKind = taskAbortKindOf(error, abortSignal);
+            if (abortKind === 'timeout' || abortKind === 'cancelled') {
                 await recordTaskTokenUsages(this.taskService, taskId, this.tokenStatsService.list(taskId));
-                await this.taskService.tryUpdateStatus(taskId, 'running', 'timeout');
+                if (abortKind === 'timeout') {
+                    await this.taskService.tryUpdateStatus(taskId, 'running', 'timeout');
+                }
+                else {
+                    const moved = await this.taskService.tryUpdateStatus(taskId, 'running', 'cancelled');
+                    if (!moved) {
+                        await this.taskService.tryUpdateStatus(taskId, 'waiting_hitl', 'cancelled');
+                    }
+                }
                 emitter.emit(this.buildSSEEvent('task.error', correlationId, taskId, {
-                    code: ErrorCodes.TASK_TIMEOUT,
-                    message: 'Task execution timed out',
+                    code: abortKind === 'timeout' ? ErrorCodes.TASK_TIMEOUT : 'runtime.task.cancelled',
+                    message: abortKind === 'timeout' ? 'Task execution timed out' : 'Task cancelled',
                     recoverable: false,
                 }));
                 emitter.close();
@@ -439,7 +446,7 @@ export class StreamOrchestrator {
                 assistantText: injected,
                 finishPoints: graph.finishPoints,
                 toolCallReasoningContent,
-                assistantReasoningContent,
+                assistantReasoningContent: resolvedStreamReasoning(reasoningState),
             }),
             assistantTokenCount: tokenStats.total.output ?? 0,
             assistantDurationMs: duration,
@@ -487,7 +494,4 @@ export class StreamOrchestrator {
         }));
         emitter.close();
     }
-    isTimeoutError(error) {
-        return error instanceof Error && /timed out/i.test(error.message);
-    }
 }

package/dist/common/types.d.ts

@@ -58,11 +58,12 @@ export interface RuntimeRunContext {
 /**
  * Task 执行状态（Runtime 内部使用）
  *
- * 状态流转：pending → running → success | failed | timeout | token_exhausted | waiting_hitl
+ * 状态流转：pending → running → success | failed | timeout | token_exhausted | cancelled | waiting_hitl
  *
- * waiting_hitl：等待人工介入确认，可通过 HITL API 恢复为 running
+ * waiting_hitl：等待人工介入确认，可通过 HITL API 恢复为 running。
+ * cancelled：调用方停止这一轮（Hosting `POST /tasks/:id/cancel`），不是超时。
  */
-export type TaskStatus = 'pending' | 'running' | 'waiting_hitl' | 'success' | 'failed' | 'timeout' | 'token_exhausted';
+export type TaskStatus = 'pending' | 'running' | 'waiting_hitl' | 'success' | 'failed' | 'timeout' | 'token_exhausted' | 'cancelled';
 /**
  * Runtime 执行上下文绑定状态（非平台 Session 生命周期）
  *

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

@@ -127,7 +127,6 @@ export declare class LangGraphAdapter implements IStateGraphEngine {
     private createNodeFunction;
     private createNodeFunctionBody;
     private createSkillBindNodeFunction;
-    private buildSkillCatalog;
     private createToolNodeFunction;
     private createLLMNodeFunction;
     /**

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

@@ -23,7 +23,7 @@ import { ToolResultInjector } from '../../tool/tool-result-injector.js';
 import { fileArtifactFromToolOutput } from '../../tool/file-artifact.js';
 import { EchoLLMProvider } from '../../providers/echo-llm-provider.js';
 import { ConditionEvaluator } from '../condition-evaluator.js';
-import { SystemPromptBuilder, buildToolCatalog, loadedToolsToApiTools, resolveLlmPromptInputs } from '../../tool/system-prompt-builder.js';
+import { SystemPromptBuilder, buildSkillCatalog, loadedToolsToApiTools, resolveLlmPromptInputs, spokenName } from '../../tool/system-prompt-builder.js';
 import { resolveJailFromState, resolveJailRoots } from '../../tool/harness-primitives.js';
 import os from 'node:os';
 import { bindSelectedSkill } from '../nodes/skill-bind-node.js';
@@ -39,6 +39,81 @@ import { recordSkillEntrySpan, skillEntryInvocationFromTool } from './skill-entr
 import { llmSpanInput, llmSpanOutputFromResult, withGraphSpan } from '../trace-span.js';
 import { executionTraceFromState, getExecutionStream, getExecutionTrace, runWithExecutionTrace, } from '../execution-trace-context.js';
 import { isRetryableToolFailure, resolveToolRetryConfig, sleepToolRetry, toolRetryDelayMs, } from '../../tool/tool-retry.js';
+function emitReasoningStartedIfNeeded(live, model, timestamp) {
+    if (live.reasoningStartedThisTurn)
+        return;
+    live.reasoningStartedThisTurn = true;
+    live.iteration += 1;
+    live.sink({
+        type: 'reasoning.started',
+        taskId: undefined,
+        correlationId: undefined,
+        timestamp,
+        payload: {
+            iterationCount: live.iteration,
+            model,
+        },
+    });
+}
+function nodeGraphExtra(live, nodeId) {
+    return {
+        node: nodeId,
+        ...(live.graphId ? { graphId: live.graphId } : {}),
+    };
+}
+function emitLlmStreamDelta(live, nodeId, model, delta) {
+    const timestamp = new Date().toISOString();
+    const extra = nodeGraphExtra(live, nodeId);
+    if (delta.reasoningContent) {
+        emitReasoningStartedIfNeeded(live, model, timestamp);
+        live.sink({
+            type: 'reasoning.chunk',
+            taskId: undefined,
+            correlationId: undefined,
+            timestamp,
+            payload: {
+                content: delta.reasoningContent,
+                index: live.reasoningChunkIndex++,
+                ...extra,
+            },
+        });
+    }
+    if (delta.content) {
+        emitReasoningStartedIfNeeded(live, model, timestamp);
+        live.streamedTextThisTurn = true;
+        live.sink({
+            type: 'response.chunk',
+            taskId: undefined,
+            correlationId: undefined,
+            timestamp,
+            payload: {
+                content: delta.content,
+                index: live.chunkIndex++,
+                ...extra,
+            },
+        });
+    }
+}
+function emitReasoningCompletedIfAny(live, nodeId, next) {
+    if (!live)
+        return;
+    const added = Array.isArray(next.messages) ? next.messages[0] : undefined;
+    const reasoning = added && typeof added === 'object' && typeof added.reasoningContent === 'string'
+        ? added.reasoningContent
+        : '';
+    if (!reasoning)
+        return;
+    live.sink({
+        type: 'reasoning.completed',
+        taskId: undefined,
+        correlationId: undefined,
+        timestamp: new Date().toISOString(),
+        payload: {
+            content: reasoning,
+            ...nodeGraphExtra(live, nodeId),
+        },
+    });
+}
 /**
  * 传给 LangGraph 的 `recursionLimit`：一轮调度（superstep）+1。
  * 同一步里并行的多个节点只 +1。ReAct 的 llm 再 tool 大约 +2。
@@ -306,6 +381,7 @@ export class LangGraphAdapter {
                     alreadyInSkillSpan: progress.inSkillSubgraph,
                 });
                 if (catalogSkill) {
+                    const skillName = spokenName(progress.skillName, catalogSkill.skillId) ?? catalogSkill.skillId;
                     stream.sink({
                         type: 'skill.started',
                         taskId,
@@ -313,7 +389,7 @@ export class LangGraphAdapter {
                         timestamp,
                         payload: {
                             skillId: catalogSkill.skillId,
-                            skillName: progress.skillName || catalogSkill.skillId,
+                            skillName,
                             path: catalogSkill.path,
                             ...(progress.skillSpace ? { skillSpace: progress.skillSpace } : {}),
                             ...(progress.skillVersion ? { skillVersion: progress.skillVersion } : {}),
@@ -326,7 +402,7 @@ export class LangGraphAdapter {
                         timestamp,
                         payload: {
                             skillId: catalogSkill.skillId,
-                            skillName: catalogSkill.skillId,
+                            skillName,
                         },
                     });
                 }
@@ -460,6 +536,7 @@ export class LangGraphAdapter {
                 // agentId 已废弃：channel 保留仅为旧 Checkpoint 反序列化兼容，新代码只写 agentCode
                 agentId: ephemeral(''),
                 agentCode: ephemeral(''),
+                agentName: ephemeral(undefined),
                 agentVersion: ephemeral(undefined),
                 delegationToken: ephemeral(''),
                 correlationId: ephemeral(''),
@@ -594,15 +671,25 @@ export class LangGraphAdapter {
             sink: enqueue,
             eventContext: { taskId: state.taskId, correlationId: state.correlationId },
             chunkIndex: 0,
+            reasoningChunkIndex: 0,
             iteration: 0,
             reasoningStartedThisTurn: false,
             streamedTextThisTurn: false,
+            graphId: graph.id,
         };
         const traceCtx = executionTraceFromState(state);
         const graphSignal = graphAbortSignal(state);
+        let graphIterator;
+        const stopGraphIterator = () => {
+            const iterator = graphIterator;
+            if (!iterator?.return)
+                return;
+            void iterator.return().catch(() => undefined);
+        };
         const onGraphAbort = () => {
             failure = graphSignal ? abortReason(graphSignal) : new Error('aborted');
             finished = true;
+            stopGraphIterator();
             signal();
         };
         graphSignal?.addEventListener('abort', onGraphAbort, { once: true });
@@ -617,9 +704,19 @@ export class LangGraphAdapter {
                 const streamIterator = await withGraphAbort(Promise.resolve(ref.compiled.stream(input, langGraphRunOptions({
                     configurable: this.checkpointConfigurable(state, graph),
                     streamMode: 'updates',
+                    ...(graphSignal ? { signal: graphSignal } : {}),
                 }))), graphSignal);
-                for await (const update of streamIterator) {
-                    for (const event of this.convertUpdatesToEvents(update, graph.id, () => streamBag.chunkIndex++, ref.silentNodeIds, ref.subgraphNodeIds)) {
+                const iterator = streamIterator[Symbol.asyncIterator]();
+                graphIterator = iterator;
+                while (true) {
+                    if (graphSignal?.aborted) {
+                        failure = failure ?? abortReason(graphSignal);
+                        break;
+                    }
+                    const next = await iterator.next();
+                    if (next.done)
+                        break;
+                    for (const event of this.convertUpdatesToEvents(next.value, graph.id, () => streamBag.chunkIndex++, ref.silentNodeIds, ref.subgraphNodeIds)) {
                         enqueue(event);
                     }
                 }
@@ -665,6 +762,7 @@ export class LangGraphAdapter {
                 abortDeadlineMs,
             }, () => ref.compiled.invoke(input, langGraphRunOptions({
                 configurable: this.checkpointConfigurable(state, graph),
+                ...(abortSignal ? { signal: abortSignal } : {}),
             }))), abortSignal);
         }
         catch (error) {
@@ -856,7 +954,7 @@ export class LangGraphAdapter {
                     correlationId: undefined,
                     timestamp: new Date().toISOString(),
                     payload: {
-                        skillName: patch.skillName || patch.activatedSkill,
+                        skillName: spokenName(patch.skillName, patch.activatedSkill) ?? patch.activatedSkill,
                         skillId: patch.activatedSkill,
                         confidence: 1,
                     },
@@ -898,20 +996,6 @@ export class LangGraphAdapter {
             };
         };
     }
-    buildSkillCatalog(defs) {
-        if (!defs)
-            return undefined;
-        const rows = Object.values(defs).map((skill) => {
-            const desc = (skill.description ?? '').replace(/\s+/g, ' ').trim();
-            const entry = skill.entryFile ?? (skill.bundlePath ? `${skill.bundlePath}/SKILL.md` : '');
-            const title = skill.name && skill.name !== skill.skillId ? `${skill.skillId}（${skill.name}）` : skill.skillId;
-            const pathLine = entry ? `\n  SKILL.md: ${entry}` : '';
-            return `- **${title}**${desc ? `：${desc}` : ''}${pathLine}`;
-        });
-        if (rows.length === 0)
-            return undefined;
-        return `# 可用技能\n要用某个技能时，调用 read_file 读取其 SKILL.md。脚本和参考文档默认在同一目录。\n${rows.join('\n')}`;
-    }
     createToolNodeFunction(node) {
         const toolName = node.config?.['tool'] ?? node.id;
         const defaultArgs = node.config?.['arguments'] ?? {};
@@ -1061,6 +1145,7 @@ export class LangGraphAdapter {
             const resolvedPrompt = resolveGraphPrompt(baseConfig.systemPrompt, promptRoots);
             const loadedToolsBase = state['loadedTools'];
             const agentCode = typeof state['agentCode'] === 'string' ? state['agentCode'] : undefined;
+            const agentName = typeof state['agentName'] === 'string' ? state['agentName'] : undefined;
             const skillDefs = state['skillDefinitions'];
             const execCtx = state['executionContext'];
             const userId = (typeof execCtx?.userId === 'string' && execCtx.userId) || state['userId'];
@@ -1092,8 +1177,7 @@ export class LangGraphAdapter {
                 const toolNames = loadedTools ? Object.keys(loadedTools) : [];
                 console.log(`[LLM-DEBUG] node=${node.id} loadedTools=${toolNames.length}:`, toolNames);
             }
-            const catalog = includeSkillCatalog ? this.buildSkillCatalog(skillDefs) : undefined;
-            const toolCatalog = disableTools ? undefined : buildToolCatalog(loadedTools);
+            const catalog = includeSkillCatalog ? buildSkillCatalog(skillDefs) : undefined;
             const jail = resolveJailFromState({
                 agentDir: state['agentDir'],
                 userId,
@@ -1122,7 +1206,7 @@ export class LangGraphAdapter {
                 agentPrompt: promptInputs.agentPrompt,
                 nodePrompt: promptInputs.nodePrompt,
                 skillCatalog: catalog,
-                toolCatalog,
+                agentName,
                 agentCode,
                 userId,
                 workingDirectory,
@@ -1151,39 +1235,14 @@ export class LangGraphAdapter {
             if (stream) {
                 stream.reasoningStartedThisTurn = false;
                 stream.streamedTextThisTurn = false;
+                stream.reasoningChunkIndex = 0;
             }
             const llmNode = new LLMNode(node.id, finalConfig, this.llmProvider, enableStream, enableStream
-                ? (text) => {
+                ? (delta) => {
                     const live = getExecutionStream();
-                    if (!live || !text)
+                    if (!live)
                         return;
-                    const timestamp = new Date().toISOString();
-                    if (!live.reasoningStartedThisTurn) {
-                        live.reasoningStartedThisTurn = true;
-                        live.iteration += 1;
-                        live.sink({
-                            type: 'reasoning.started',
-                            taskId: undefined,
-                            correlationId: undefined,
-                            timestamp,
-                            payload: {
-                                iterationCount: live.iteration,
-                                model: finalConfig.model,
-                            },
-                        });
-                    }
-                    live.streamedTextThisTurn = true;
-                    live.sink({
-                        type: 'response.chunk',
-                        taskId: undefined,
-                        correlationId: undefined,
-                        timestamp,
-                        payload: {
-                            content: text,
-                            index: live.chunkIndex++,
-                            node: node.id,
-                        },
-                    });
+                    emitLlmStreamDelta(live, node.id, finalConfig.model, delta);
                 }
                 : undefined, this.interceptors);
             const toolsForSpan = disableTools || !loadedTools
@@ -1207,6 +1266,9 @@ export class LangGraphAdapter {
                 },
             }, async () => {
                 const next = await llmNode.execute(state);
+                if (enableStream) {
+                    emitReasoningCompletedIfAny(getExecutionStream(), node.id, next);
+                }
                 const hydratedUpdate = loadedTools && loadedTools !== loadedToolsBase ? { loadedTools } : {};
                 if (!silent)
                     return { ...next, ...hydratedUpdate };
@@ -1552,23 +1614,17 @@ export class LangGraphAdapter {
                         continue;
                     }
                     const hasText = typeof msg.content === 'string' && msg.content.trim().length > 0;
-                    if ((hasText || msg.reasoningContent) &&
-                        (!streamedTextThisTurn || msg.reasoningContent)) {
-                        if (streamedTextThisTurn && !msg.reasoningContent)
-                            continue;
+                    if (hasText && !streamedTextThisTurn) {
                         yield {
                             type: 'response.chunk',
                             taskId: undefined,
                             correlationId: undefined,
                             timestamp,
                             payload: {
-                                content: streamedTextThisTurn ? '' : (msg.content ?? ''),
+                                content: msg.content ?? '',
                                 index: nextChunkIndex(),
                                 node: nodeId,
                                 graphId,
-                                ...(msg.reasoningContent
-                                    ? { reasoningContent: msg.reasoningContent }
-                                    : {}),
                             },
                         };
                     }
@@ -1579,26 +1635,8 @@ export class LangGraphAdapter {
                         continue;
                     if (subgraphNodeIds.has(nodeId) && streamedTextThisTurn)
                         continue;
-                    // 已通过 onChunk 推送过 token，避免整段重复
-                    if (streamedTextThisTurn) {
-                        // token 已流过：仍补发一条带 reasoning 的标记 chunk（空 content），供落库回传
-                        if (msg.reasoningContent) {
-                            yield {
-                                type: 'response.chunk',
-                                taskId: undefined,
-                                correlationId: undefined,
-                                timestamp,
-                                payload: {
-                                    content: '',
-                                    index: nextChunkIndex(),
-                                    node: nodeId,
-                                    graphId,
-                                    reasoningContent: msg.reasoningContent,
-                                },
-                            };
-                        }
+                    if (streamedTextThisTurn)
                         continue;
-                    }
                     yield {
                         type: 'response.chunk',
                         taskId: undefined,
@@ -1609,9 +1647,6 @@ export class LangGraphAdapter {
                             index: nextChunkIndex(),
                             node: nodeId,
                             graphId,
-                            ...(msg.reasoningContent
-                                ? { reasoningContent: msg.reasoningContent }
-                                : {}),
                         },
                     };
                     continue;

package/dist/graph/adapters/skill-entry-span.js

@@ -10,6 +10,7 @@
  */
 import { classifySkillFile, classifySkillSpace, isReadTool, } from './skill-read.js';
 import { completeGraphSpan, startGraphSpan } from '../trace-span.js';
+import { spokenName } from '../../tool/system-prompt-builder.js';
 function declaredSkillVersion(skillId, version) {
     const raw = version?.trim();
     if (!raw || raw === skillId)
@@ -27,9 +28,10 @@ export function skillTraceIdentity(state, skillId, fallbackPath) {
     const bundle = info?.bundlePath || fallbackPath;
     const skillSpace = bundle ? classifySkillSpace(bundle, { agentDir, userId }) : undefined;
     const skillVersion = declaredSkillVersion(skillId, info?.version);
+    const skillName = spokenName(info?.name, undefined);
     return {
         skillId,
-        ...(info?.name ? { skillName: info.name } : {}),
+        ...(skillName ? { skillName } : {}),
         ...(skillVersion ? { skillVersion } : {}),
         ...(skillSpace ? { skillSpace } : {}),
     };
@@ -39,6 +41,7 @@ export function skillSpanFields(identity, extra) {
         ...(identity.skillVersion ? { version: identity.skillVersion } : {}),
         input: {
             skillId: identity.skillId,
+            ...(identity.skillName ? { skillName: identity.skillName } : {}),
             ...(identity.skillSpace ? { skillSpace: identity.skillSpace } : {}),
             ...(extra?.path ? { path: extra.path } : {}),
             ...(extra?.source ? { source: extra.source } : {}),