@gt-fe/eap-runtime 0.0.29 → 0.0.31

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

@@ -16,6 +16,7 @@
  */
 import { randomUUID } from 'node:crypto';
 import { buildHitlWaitingTaskOutput, loadModelFacingHistory, messageRecordsToGraphMessages, persistGraphMessageBaseline, turnGraphMessagesAfterCompression, persistHitlWaitingPlaceholder, persistTurnTranscript, persistUserTurnMessage, resolveCheckpointThreadId, sessionVisibleGraphMessages, } from '../../session/persist-turn-messages.js';
+import { applyInjectedAssistant, collectPublicArtifactLinks, injectPublicArtifactLinks, } from '../../tool/inject-public-artifact-links.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';
@@ -380,21 +381,24 @@ 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 文本）───
         // 切点是入图 messages 基线（压缩 `__set` 后 Graph 短于 Session 全文）。user 已在 4b 写入。
         const allMessages = Array.isArray(graphResult.finalState?.messages)
             ? graphResult.finalState.messages
             : [];
         const newMessages = sessionVisibleGraphMessages(allMessages.slice(persistBaseline), finishPoints);
+        const links = collectPublicArtifactLinks(allMessages);
+        const { injected } = injectPublicArtifactLinks(graphResult.output ?? '', links);
+        const persisted = applyInjectedAssistant(newMessages, injected, links);
+        // ─── Step 7: 完成 Task (running → success) ───
+        await this.taskService.updateStatus(task.id, 'success', injected);
         const duration = Date.now() - startTime;
         await persistTurnTranscript(this.messageService, {
             sessionId,
             taskId: task.id,
             correlationId,
-            messages: newMessages,
-            fallbackAssistantContent: graphResult.output ?? '',
+            messages: persisted,
+            fallbackAssistantContent: injected,
             assistantTokenCount: tokenUsage.output,
             assistantDurationMs: duration,
         });
@@ -404,7 +408,7 @@ export class InvokeOrchestrator {
         return this.buildResponse(traceId, {
             taskId: task.id,
             sessionId,
-            output: graphResult.output,
+            output: injected,
             tokenUsage,
             duration,
             status: 'success',

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

@@ -20,6 +20,7 @@
  * @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 { 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';
 import { recordTaskTokenUsages } from '../../token/record-task-token-usage.js';
@@ -268,6 +269,7 @@ export class StreamOrchestrator {
         let assistantReasoningContent;
         const pendingToolCalls = [];
         const toolResults = [];
+        const artifactLinks = [];
         // ─── Step 6: Graph.stream() 流式执行 ───
         try {
             const eventStream = runWithExecutionTrace({ abortSignal }, () => this.graphEngine.stream(graph, {
@@ -326,6 +328,7 @@ export class StreamOrchestrator {
                     }
                 }
                 appendTerminalToolResult(runtimeEvent.type, runtimeEvent.payload, toolResults);
+                collectPublicArtifactLinksFromEvent(runtimeEvent.type, runtimeEvent.payload, artifactLinks);
                 const streamedReasoning = extractStreamReasoning(runtimeEvent.type, runtimeEvent.payload);
                 if (streamedReasoning)
                     assistantReasoningContent = streamedReasoning;
@@ -387,10 +390,18 @@ export class StreamOrchestrator {
             this.timeoutManager?.clearTimer(taskId);
         }
         // ─── Step 7: 发送结束事件序列 ───
-        // Emit: response.final（带完整 assistant 文本，供客户端兜底）
         const tokenStats = this.tokenStatsService.getTaskStats(taskId);
+        const visible = visibleStreamAssistantText(assistantBuckets);
+        const links = mergeArtifactLinks(artifactLinks, collectPublicArtifactLinks(toolResults));
+        const { injected, suffix } = injectPublicArtifactLinks(visible, links);
+        if (suffix) {
+            emitter.emit(this.buildSSEEvent('response.chunk', correlationId, taskId, {
+                content: suffix,
+                format: 'text',
+            }));
+        }
         emitter.emit(this.buildSSEEvent('response.final', correlationId, taskId, {
-            content: visibleStreamAssistantText(assistantBuckets),
+            content: injected,
             format: 'text',
         }));
         const totalTokens = (tokenStats.total.input ?? 0) + (tokenStats.total.output ?? 0);
@@ -424,8 +435,8 @@ export class StreamOrchestrator {
             messages: buildTurnTranscriptFromStreamEvents({
                 pendingToolCalls,
                 toolResults,
-                assistantTexts: streamAssistantTexts(assistantBuckets),
-                assistantText: visibleStreamAssistantText(assistantBuckets),
+                assistantTexts: suffix ? undefined : streamAssistantTexts(assistantBuckets),
+                assistantText: injected,
                 finishPoints: graph.finishPoints,
                 toolCallReasoningContent,
                 assistantReasoningContent,

package/dist/common/index.d.ts

@@ -4,3 +4,4 @@ export * from './health.js';
 export * from './agent-code.js';
 export * from './trace-id.js';
 export { RUNTIME_PACKAGE_VERSION } from './runtime-package-version.js';
+export { userRoot, USERS_DIR_NAME, MISSING_USER_DIR } from './user-root.js';

package/dist/common/index.js

@@ -4,3 +4,4 @@ export * from './health.js';
 export * from './agent-code.js';
 export * from './trace-id.js';
 export { RUNTIME_PACKAGE_VERSION } from './runtime-package-version.js';
+export { userRoot, USERS_DIR_NAME, MISSING_USER_DIR } from './user-root.js';

package/dist/common/user-root.d.ts

@@ -0,0 +1,8 @@
+export declare const MISSING_USER_DIR = "\u7F3A\u5C11\u7528\u6237\u76EE\u5F55\uFF0C\u62D2\u7EDD\u8BE5\u64CD\u4F5C";
+/** `agents/<code>/users/`：与 `<ver>` 平级，不是版本目录。 */
+export declare const USERS_DIR_NAME = "users";
+/**
+ * jail 写根：`dirname(agentDir)/users/<userId>`。
+ * `agentDir` 仍是版本目录 `agents/<code>/<ver>`。
+ */
+export declare function userRoot(agentDir: string, userId: string): string;

package/dist/common/user-root.js

@@ -0,0 +1,19 @@
+import path from 'node:path';
+export const MISSING_USER_DIR = '缺少用户目录，拒绝该操作';
+/** `agents/<code>/users/`：与 `<ver>` 平级，不是版本目录。 */
+export const USERS_DIR_NAME = 'users';
+/**
+ * jail 写根：`dirname(agentDir)/users/<userId>`。
+ * `agentDir` 仍是版本目录 `agents/<code>/<ver>`。
+ */
+export function userRoot(agentDir, userId) {
+    const dir = agentDir.trim();
+    const uid = userId.trim();
+    if (!dir || !uid) {
+        throw new Error(MISSING_USER_DIR);
+    }
+    if (uid === '.' || uid === '..' || /[\\/]/.test(uid)) {
+        throw new Error('非法用户标识');
+    }
+    return path.resolve(path.dirname(dir), USERS_DIR_NAME, uid);
+}

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

@@ -36,7 +36,7 @@ import { pickContextFields } from '../../token/context-window.js';
 import { isHitlDecision, lastAssistantHasUnansweredToolCalls } from '../hitl/hitl-handler.js';
 import { classifySkillRead } from './skill-read.js';
 import { skillEntryInvocationFromTool } from './skill-entry-span.js';
-import { withGraphSpan } from '../trace-span.js';
+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';
 /**
@@ -374,6 +374,8 @@ export class LangGraphAdapter {
                     ...(progress.toolset ? { toolset: progress.toolset } : {}),
                     content: progress.content,
                     success: true,
+                    ...(progress.file ? { file: progress.file } : {}),
+                    ...(progress.files?.length ? { files: progress.files } : {}),
                     ...loc,
                 },
             });
@@ -390,6 +392,9 @@ export class LangGraphAdapter {
                     ...(progress.toolset ? { toolset: progress.toolset } : {}),
                     error: progress.error ?? 'Unknown error',
                     willRetry: progress.willRetry === true,
+                    ...(progress.content ? { content: progress.content } : {}),
+                    ...(progress.file ? { file: progress.file } : {}),
+                    ...(progress.files?.length ? { files: progress.files } : {}),
                     ...loc,
                 },
             });
@@ -788,17 +793,30 @@ export class LangGraphAdapter {
             case 'tool':
                 return this.createToolNodeFunction(node);
             case 'condition':
-                return async (state) => withGraphSpan(state, { name: node.id, type: 'condition' }, async () => {
+                return async (state) => {
                     const conditionExpr = node.config?.['conditionExpr']
                         ?? node.config?.['conditionFn'];
-                    if (conditionExpr) {
-                        const branchValues = node.config?.['branchValues']
-                            ?? this.extractBranchValuesFromDsl(node.id);
-                        const result = await this.conditionEvaluator.evaluate(conditionExpr, state, branchValues, node.config?.['fallback'] ?? '__default__');
-                        return { currentNode: node.id, __conditionResult: result };
-                    }
-                    return { currentNode: node.id };
-                });
+                    const branchValues = node.config?.['branchValues']
+                        ?? this.extractBranchValuesFromDsl(node.id);
+                    const fallback = node.config?.['fallback'] ?? '__default__';
+                    return withGraphSpan(state, {
+                        name: node.id,
+                        type: 'condition',
+                        extra: {
+                            input: {
+                                conditionExpr: conditionExpr ?? null,
+                                branchValues,
+                                fallback,
+                            },
+                        },
+                    }, async () => {
+                        if (conditionExpr) {
+                            const result = await this.conditionEvaluator.evaluate(conditionExpr, state, branchValues, fallback);
+                            return { currentNode: node.id, __conditionResult: result };
+                        }
+                        return { currentNode: node.id };
+                    }, { outputFrom: (result) => result['__conditionResult'] });
+                };
             case 'subgraph':
                 return this.createSubGraphNodeFunction(node);
             case 'human':
@@ -1019,136 +1037,155 @@ export class LangGraphAdapter {
                 lastAssistantHasUnansweredToolCalls(rawMessages)) {
                 return { currentNode: node.id };
             }
-            return withGraphSpan(state, { name: node.id, type: 'llm' }, async () => {
-                const promptRoots = Array.isArray(state['promptRoots']) ? state['promptRoots'] : [];
-                const resolvedPrompt = resolveGraphPrompt(baseConfig.systemPrompt, promptRoots);
-                const loadedToolsBase = state['loadedTools'];
-                const agentCode = typeof state['agentCode'] === 'string' ? state['agentCode'] : undefined;
-                const skillDefs = state['skillDefinitions'];
-                const execCtx = state['executionContext'];
-                const userId = (typeof execCtx?.userId === 'string' && execCtx.userId) || state['userId'];
-                const loadedTools = disableTools
-                    ? loadedToolsBase
-                    : await hydrateMcpTools(loadedToolsBase, this.toolExecutor, {
-                        authContext: {
-                            userId: String(userId ?? ''),
-                            delegationToken: String(execCtx?.delegationToken ?? state['delegationToken'] ?? ''),
-                            agentCode: String(agentCode ?? ''),
-                        },
-                        correlationId: typeof state['correlationId'] === 'string' ? state['correlationId'] : undefined,
-                        taskId: typeof state['taskId'] === 'string' ? state['taskId'] : undefined,
-                        onListFailure: ({ toolset, error }) => {
-                            this.emitToolExecutionEvents({
-                                toolCallId: `mcp-list:${toolset}`,
-                                toolName: MCP_LIST_TOOL_NAME,
-                                toolset,
-                                status: 'error',
-                                error,
-                            });
-                        },
-                    });
-                if (loadedTools && loadedTools !== loadedToolsBase) {
-                    state['loadedTools'] = loadedTools;
-                }
-                // [DEBUG] 打印 loadedTools 实际状态
-                if (process.env.EAP_LLM_DEBUG === '1') {
-                    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 jail = resolveJailFromState({
-                    agentDir: state['agentDir'],
-                    userId,
-                    executionContext: execCtx,
-                    loadedTools,
-                    skillDefinitions: skillDefs,
-                });
-                if (this.overlayExtraRoots.length > 0) {
-                    jail.extraRoots = [...(jail.extraRoots ?? []), ...this.overlayExtraRoots];
-                }
-                const workingDirectory = jail.workdir;
-                const jailRoots = resolveJailRoots(jail);
-                const skillDirs = Object.values(skillDefs ?? {})
-                    .filter((skill) => Boolean(skill.bundlePath))
-                    .map((skill) => ({
-                    skillId: skill.skillId,
-                    bundlePath: skill.bundlePath,
-                    entryFile: skill.entryFile,
-                }));
-                const promptInputs = resolveLlmPromptInputs({
-                    silent,
-                    agentSystemPrompt: state['agentSystemPrompt'],
-                    nodePrompt: resolvedPrompt,
+            const promptRoots = Array.isArray(state['promptRoots']) ? state['promptRoots'] : [];
+            const resolvedPrompt = resolveGraphPrompt(baseConfig.systemPrompt, promptRoots);
+            const loadedToolsBase = state['loadedTools'];
+            const agentCode = typeof state['agentCode'] === 'string' ? state['agentCode'] : undefined;
+            const skillDefs = state['skillDefinitions'];
+            const execCtx = state['executionContext'];
+            const userId = (typeof execCtx?.userId === 'string' && execCtx.userId) || state['userId'];
+            const loadedTools = disableTools
+                ? loadedToolsBase
+                : await hydrateMcpTools(loadedToolsBase, this.toolExecutor, {
+                    authContext: {
+                        userId: String(userId ?? ''),
+                        delegationToken: String(execCtx?.delegationToken ?? state['delegationToken'] ?? ''),
+                        agentCode: String(agentCode ?? ''),
+                    },
+                    correlationId: typeof state['correlationId'] === 'string' ? state['correlationId'] : undefined,
+                    taskId: typeof state['taskId'] === 'string' ? state['taskId'] : undefined,
+                    onListFailure: ({ toolset, error }) => {
+                        this.emitToolExecutionEvents({
+                            toolCallId: `mcp-list:${toolset}`,
+                            toolName: MCP_LIST_TOOL_NAME,
+                            toolset,
+                            status: 'error',
+                            error,
+                        });
+                    },
                 });
-                const assembled = this.systemPromptBuilder.build({
-                    agentPrompt: promptInputs.agentPrompt,
-                    nodePrompt: promptInputs.nodePrompt,
-                    skillCatalog: catalog,
-                    toolCatalog,
+            if (loadedTools && loadedTools !== loadedToolsBase) {
+                state['loadedTools'] = loadedTools;
+            }
+            // [DEBUG] 打印 loadedTools 实际状态
+            if (process.env.EAP_LLM_DEBUG === '1') {
+                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 jail = resolveJailFromState({
+                agentDir: state['agentDir'],
+                userId,
+                executionContext: execCtx,
+                loadedTools,
+                skillDefinitions: skillDefs,
+            });
+            if (this.overlayExtraRoots.length > 0) {
+                jail.extraRoots = [...(jail.extraRoots ?? []), ...this.overlayExtraRoots];
+            }
+            const workingDirectory = jail.workdir;
+            const jailRoots = resolveJailRoots(jail);
+            const skillDirs = Object.values(skillDefs ?? {})
+                .filter((skill) => Boolean(skill.bundlePath))
+                .map((skill) => ({
+                skillId: skill.skillId,
+                bundlePath: skill.bundlePath,
+                entryFile: skill.entryFile,
+            }));
+            const promptInputs = resolveLlmPromptInputs({
+                silent,
+                agentSystemPrompt: state['agentSystemPrompt'],
+                nodePrompt: resolvedPrompt,
+            });
+            const assembled = this.systemPromptBuilder.build({
+                agentPrompt: promptInputs.agentPrompt,
+                nodePrompt: promptInputs.nodePrompt,
+                skillCatalog: catalog,
+                toolCatalog,
+                agentCode,
+                userId,
+                workingDirectory,
+                os: { platform: os.platform(), release: os.release() },
+                jailRoots,
+                skillDirs,
+            });
+            const apiTools = disableTools ? [] : loadedToolsToApiTools(loadedTools);
+            const finalConfig = {
+                ...baseConfig,
+                systemPrompt: assembled.text,
+                systemSections: assembled.sections,
+                turn: {
+                    sessionId: typeof state['sessionId'] === 'string' ? state['sessionId'] : undefined,
+                    taskId: typeof state['taskId'] === 'string' ? state['taskId'] : undefined,
+                    nodeId: node.id,
                     agentCode,
-                    userId,
-                    workingDirectory,
-                    os: { platform: os.platform(), release: os.release() },
-                    jailRoots,
-                    skillDirs,
-                });
-                const apiTools = disableTools ? [] : loadedToolsToApiTools(loadedTools);
-                const finalConfig = {
-                    ...baseConfig,
-                    systemPrompt: assembled.text,
-                    systemSections: assembled.sections,
-                    turn: {
-                        sessionId: typeof state['sessionId'] === 'string' ? state['sessionId'] : undefined,
-                        taskId: typeof state['taskId'] === 'string' ? state['taskId'] : undefined,
-                        nodeId: node.id,
-                        agentCode,
-                        correlationId: typeof state['correlationId'] === 'string' ? state['correlationId'] : undefined,
-                    },
-                    tools: disableTools ? undefined : (apiTools.length > 0 ? apiTools : baseConfig.tools),
-                    toolChoice: disableTools ? 'none' : baseConfig.toolChoice,
-                };
-                // 流式旁路：有本次 stream 袋时启用 LLM token 推送；silent 节点不推给用户
-                const stream = getExecutionStream();
-                const enableStream = Boolean(stream) && !silent;
-                if (stream) {
-                    stream.reasoningStartedThisTurn = false;
-                    stream.streamedTextThisTurn = false;
-                }
-                const llmNode = new LLMNode(node.id, finalConfig, this.llmProvider, enableStream, enableStream
-                    ? (text) => {
-                        const live = getExecutionStream();
-                        if (!live || !text)
-                            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;
+                    correlationId: typeof state['correlationId'] === 'string' ? state['correlationId'] : undefined,
+                },
+                tools: disableTools ? undefined : (apiTools.length > 0 ? apiTools : baseConfig.tools),
+                toolChoice: disableTools ? 'none' : baseConfig.toolChoice,
+            };
+            // 流式旁路：有本次 stream 袋时启用 LLM token 推送；silent 节点不推给用户
+            const stream = getExecutionStream();
+            const enableStream = Boolean(stream) && !silent;
+            if (stream) {
+                stream.reasoningStartedThisTurn = false;
+                stream.streamedTextThisTurn = false;
+            }
+            const llmNode = new LLMNode(node.id, finalConfig, this.llmProvider, enableStream, enableStream
+                ? (text) => {
+                    const live = getExecutionStream();
+                    if (!live || !text)
+                        return;
+                    const timestamp = new Date().toISOString();
+                    if (!live.reasoningStartedThisTurn) {
+                        live.reasoningStartedThisTurn = true;
+                        live.iteration += 1;
                         live.sink({
-                            type: 'response.chunk',
+                            type: 'reasoning.started',
                             taskId: undefined,
                             correlationId: undefined,
                             timestamp,
                             payload: {
-                                content: text,
-                                index: live.chunkIndex++,
-                                node: node.id,
+                                iterationCount: live.iteration,
+                                model: finalConfig.model,
                             },
                         });
                     }
-                    : undefined, this.interceptors);
+                    live.streamedTextThisTurn = true;
+                    live.sink({
+                        type: 'response.chunk',
+                        taskId: undefined,
+                        correlationId: undefined,
+                        timestamp,
+                        payload: {
+                            content: text,
+                            index: live.chunkIndex++,
+                            node: node.id,
+                        },
+                    });
+                }
+                : undefined, this.interceptors);
+            const toolsForSpan = disableTools || !loadedTools
+                ? undefined
+                : Object.values(loadedTools).map((t) => ({
+                    name: t.name,
+                    ...(t.manifest.description?.trim()
+                        ? { description: t.manifest.description.trim() }
+                        : {}),
+                }));
+            // 组装后再 createNode：input 必须是发给模型的 system/tools/messages；completeNode 不能补 input。
+            return withGraphSpan(state, {
+                name: node.id,
+                type: 'llm',
+                extra: {
+                    input: llmSpanInput({
+                        system: assembled.text,
+                        tools: toolsForSpan,
+                        messages: state['messages'],
+                    }),
+                },
+            }, async () => {
                 const next = await llmNode.execute(state);
                 const hydratedUpdate = loadedTools && loadedTools !== loadedToolsBase ? { loadedTools } : {};
                 if (!silent)
@@ -1163,7 +1200,7 @@ export class LangGraphAdapter {
                     silentOutput: raw,
                     ...hydratedUpdate,
                 };
-            });
+            }, { outputFrom: llmSpanOutputFromResult });
         };
     }
     /**
@@ -1560,10 +1597,20 @@ export class LangGraphAdapter {
                     continue;
                 }
                 if (msg.role === 'tool') {
-                    // tool.result / tool.error 由 Tool 节点旁路发出，此处只补 file.created
+                    // tool.result / tool.error 由 Tool 节点旁路发出（已带 file/files）；此处再补 file.created
                     const raw = typeof msg.content === 'string' ? msg.content : '';
-                    const file = msg.file ?? fileArtifactFromToolOutput(raw);
-                    if (file) {
+                    const files = [
+                        ...(msg.file ? [msg.file] : []),
+                        ...(msg.files ?? []),
+                    ];
+                    if (files.length === 0) {
+                        const parsed = fileArtifactFromToolOutput(raw);
+                        if (parsed)
+                            files.push(parsed);
+                    }
+                    for (const file of files) {
+                        if (!file?.url)
+                            continue;
                         yield {
                             type: 'file.created',
                             taskId: undefined,
@@ -1630,6 +1677,7 @@ export class LangGraphAdapter {
                 success: typeof m['success'] === 'boolean' ? m['success'] : undefined,
                 reasoningContent: typeof m['reasoningContent'] === 'string' ? m['reasoningContent'] : undefined,
                 file: readFileArtifact(m['file']),
+                files: readFileArtifactList(m['files']),
             };
         });
     }
@@ -1647,3 +1695,14 @@ function readFileArtifact(value) {
         url: rec.url,
     };
 }
+function readFileArtifactList(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    const out = [];
+    for (const item of value) {
+        const file = readFileArtifact(item);
+        if (file)
+            out.push(file);
+    }
+    return out.length > 0 ? out : undefined;
+}

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

@@ -1,5 +1,6 @@
 import { realpathSync } from 'node:fs';
 import path from 'node:path';
+import { userRoot } from '../../common/user-root.js';
 function tryRealpath(p) {
     try {
         return realpathSync(p);
@@ -49,12 +50,20 @@ export function classifySkillSpace(bundleOrFilePath, opts) {
             return 'agent';
         const uid = opts?.userId?.trim();
         if (uid) {
-            const user = `${root}/users/${uid}/skills`;
-            if (target === user || target.startsWith(`${user}/`))
-                return 'user';
+            try {
+                const user = normalizeForMatch(path.join(userRoot(agentDir, uid), 'skills'));
+                if (target === user || target.startsWith(`${user}/`))
+                    return 'user';
+            }
+            catch {
+                // 非法 userId 时不按用户槽判定
+            }
         }
-        if (new RegExp(`^${escapeRegExp(root)}/users/[^/]+/skills(/|$)`).test(target))
+        const usersRoot = normalizeForMatch(path.join(path.dirname(agentDir), 'users'));
+        if ((target === usersRoot || target.startsWith(`${usersRoot}/`)) &&
+            /(^|\/)skills(\/|$)/.test(target.slice(usersRoot.length))) {
             return 'user';
+        }
         return 'local';
     }
     if (/(^|\/)preinstall\/skills(\/|$)/i.test(target))

package/dist/graph/contracts/executable-graph.d.ts

@@ -276,13 +276,19 @@ export interface GraphMessage {
      * 多轮请求必须原样回传，否则上游会 400。
      */
     reasoningContent?: string;
-    /** 工具产出的文件；仅 Runtime 发 file.created，不进模型正文 */
+    /** 工具产出的文件；SSE tool.result / tool.error 与 file.created 共用，不进模型正文 */
     file?: {
         fileName: string;
         fileType: string;
         size: number;
         url: string;
     };
+    files?: Array<{
+        fileName: string;
+        fileType: string;
+        size: number;
+        url: string;
+    }>;
 }
 /** Tool 调用信息 */
 export interface ToolCallInfo {

package/dist/graph/hitl/hitl-handler.js

@@ -289,6 +289,12 @@ export class HitlHandler {
             name: extras.toolName ?? 'hitl',
             type: 'hitl',
             parentSpanId: extras.toolSpanId ?? skillSpanId,
+            extra: {
+                input: {
+                    question: config.question,
+                    options: config.options,
+                },
+            },
         });
         const persisted = {
             taskId,

package/dist/graph/nodes/tool-node.d.ts

@@ -10,7 +10,7 @@
  * @see requirements.md Requirement 8 AC1, AC3, AC5
  */
 import type { NodeRetryConfig } from '../contracts/executable-graph.js';
-import type { AuthContext } from '../../tool/tool-executor.interface.js';
+import type { AuthContext, ToolCallResult } from '../../tool/tool-executor.interface.js';
 import type { ToolOrchestrator } from '../../tool/tool-orchestrator.js';
 import type { ToolResultInjector } from '../../tool/tool-result-injector.js';
 import type { SkillDirRef } from '../adapters/skill-read.js';
@@ -41,6 +41,9 @@ export interface ToolNodeProgress {
     arguments?: Record<string, unknown>;
     content?: string;
     error?: string;
+    /** 与 ToolCallResult.file / files 同形；completed 与失败终态都带 */
+    file?: ToolCallResult['file'];
+    files?: ToolCallResult['files'];
     executionTime?: number;
     node?: string;
     skillId?: string;