@gt-fe/eap-runtime 0.0.28 → 0.0.30

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';
 /**
@@ -788,17 +788,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 +1032,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 +1195,7 @@ export class LangGraphAdapter {
                     silentOutput: raw,
                     ...hydratedUpdate,
                 };
-            });
+            }, { outputFrom: llmSpanOutputFromResult });
         };
     }
     /**

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/trace-span.d.ts

@@ -12,4 +12,18 @@ export declare function completeGraphSpan(state: Record<string, unknown>, spanId
 export declare function withGraphSpan(state: Record<string, unknown>, spec: {
     name: string;
     type: ExecutionNodeEvent['type'];
-}, run: () => Promise<Record<string, unknown>>): Promise<Record<string, unknown>>;
+    extra?: Partial<Omit<ExecutionNodeEvent, 'traceId' | 'name' | 'type' | 'parentNodeId'>>;
+}, run: () => Promise<Record<string, unknown>>, complete?: {
+    outputFrom?: (result: Record<string, unknown>) => unknown;
+}): Promise<Record<string, unknown>>;
+/** llm Span create 时的 input：组装后的 system、工具短目录、本回合 messages。 */
+export declare function llmSpanInput(input: {
+    system?: string;
+    tools?: Array<{
+        name: string;
+        description?: string;
+    }>;
+    messages: unknown;
+}): Record<string, unknown>;
+/** llm Span complete 的 output：本回合新增 assistant（含 toolCalls）或 silentOutput。 */
+export declare function llmSpanOutputFromResult(result: Record<string, unknown>): unknown;

package/dist/graph/trace-span.js

@@ -43,15 +43,17 @@ export async function completeGraphSpan(state, spanId, params, collectorOverride
         warnTraceSpanFailure('completeNode', { spanId, traceId: resolveExecutionTrace(state).traceId }, err);
     }
 }
-export async function withGraphSpan(state, spec, run) {
+export async function withGraphSpan(state, spec, run, complete) {
     const spanId = await startGraphSpan(state, spec);
     try {
         const result = await run();
         const usage = Array.isArray(result['__llmTokenUsage'])
             ? result['__llmTokenUsage'].at(-1)
             : undefined;
+        const output = complete?.outputFrom?.(result);
         await completeGraphSpan(state, spanId, {
             status: 'completed',
+            ...(output !== undefined ? { output } : {}),
             inputTokens: usage?.inputTokens,
             outputTokens: usage?.outputTokens,
             totalTokens: usage?.inputTokens != null || usage?.outputTokens != null
@@ -69,3 +71,69 @@ export async function withGraphSpan(state, spec, run) {
         throw err;
     }
 }
+function spanGraphMessages(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    return raw.map((msg) => {
+        if (typeof msg !== 'object' || msg === null) {
+            return { role: 'user', content: String(msg) };
+        }
+        const m = msg;
+        const out = {
+            role: typeof m['role'] === 'string' ? m['role'] : 'user',
+            content: typeof m['content'] === 'string' ? m['content'] : '',
+        };
+        const toolCalls = m['toolCalls'] ?? m['tool_calls'];
+        if (toolCalls !== undefined)
+            out.toolCalls = toolCalls;
+        const toolCallId = typeof m['toolCallId'] === 'string'
+            ? m['toolCallId']
+            : typeof m['tool_call_id'] === 'string'
+                ? m['tool_call_id']
+                : undefined;
+        if (toolCallId)
+            out.toolCallId = toolCallId;
+        if (typeof m['toolName'] === 'string')
+            out.toolName = m['toolName'];
+        if (typeof m['success'] === 'boolean')
+            out.success = m['success'];
+        const reasoning = typeof m['reasoningContent'] === 'string'
+            ? m['reasoningContent']
+            : typeof m['reasoning_content'] === 'string'
+                ? m['reasoning_content']
+                : undefined;
+        if (reasoning)
+            out.reasoningContent = reasoning;
+        return out;
+    });
+}
+/** llm Span create 时的 input：组装后的 system、工具短目录、本回合 messages。 */
+export function llmSpanInput(input) {
+    const tools = input.tools?.filter((t) => t.name);
+    return {
+        ...(input.system ? { system: input.system } : {}),
+        ...(tools && tools.length > 0 ? { tools } : {}),
+        messages: spanGraphMessages(input.messages),
+    };
+}
+/** llm Span complete 的 output：本回合新增 assistant（含 toolCalls）或 silentOutput。 */
+export function llmSpanOutputFromResult(result) {
+    if (typeof result['silentOutput'] === 'string') {
+        return { content: result['silentOutput'] };
+    }
+    const messages = Array.isArray(result['messages']) ? result['messages'] : [];
+    const added = messages[0];
+    if (!added || typeof added !== 'object')
+        return undefined;
+    const m = added;
+    const out = {
+        content: typeof m['content'] === 'string' ? m['content'] : '',
+    };
+    const toolCalls = m['toolCalls'] ?? m['tool_calls'];
+    if (Array.isArray(toolCalls) && toolCalls.length > 0)
+        out.toolCalls = toolCalls;
+    if (typeof m['reasoningContent'] === 'string' && m['reasoningContent']) {
+        out.reasoningContent = m['reasoningContent'];
+    }
+    return out;
+}

package/dist/runtime/agent-runtime.d.ts

@@ -18,9 +18,10 @@ import type { MessageService } from '../session/message.service.js';
 import type { SessionService, SessionRecord, MessageRecord } from '../session/session.service.js';
 import { type ILlmTurnLog, type LlmTurnIndexEntry, type LlmTurnLogKind, type LlmTurnRecord } from '../debug/llm-turn-log.js';
 import { type SessionCompressionOptions } from '../session/apply-session-compression.js';
+import type { ILLMProvider } from '../graph/nodes/llm-node.js';
 import type { SSEEvent } from '../sse/contracts/sse-emitter.contract.js';
 import type { TaskService } from '../task/task.service.js';
-import type { ExecuteParams, ExecuteResult, ForkParams, ForkOverrides, ForkResult, HitlResponse, ResumeHitlResult, SeedSessionMessagesParams, SeedSessionMessagesResult } from './types.js';
+import type { ExecuteParams, ExecuteResult, ForkParams, ForkOverrides, ForkResult, HitlResponse, ResumeHitlResult, SeedSessionMessagesParams, SeedSessionMessagesResult, GenerateSessionTitleParams, GenerateSessionTitleResult } from './types.js';
 export interface ForkRelationRecord {
     originalTraceId: string;
     forkedTraceId: string;
@@ -50,6 +51,11 @@ export interface AgentRuntimeDeps {
     recordForkRelation?: RecordForkRelation;
     /** 历史压缩；默认开。EAP_RUNTIME_COMPRESSION=0 关闭 */
     sessionCompression?: SessionCompressionOptions;
+    /**
+     * 会话标题 completion。与图引擎共用同一实例。
+     * 未注入时回退 `sessionCompression.provider`。
+     */
+    llmProvider?: ILLMProvider;
     /** 长期记忆注入；默认关。见 EAP_RUNTIME_MEMORY */
     sessionMemory?: import('../session/apply-session-memory.js').SessionMemoryOptions;
     /** 未注入时不启动整图超时（测试桩） */
@@ -114,6 +120,11 @@ export declare class AgentRuntime {
     listConversations(options?: {
         userId?: string;
     }): Promise<SessionRecord[]>;
+    /**
+     * 根据该 sessionId 的 Message 生成会话标题。不写库、不进 execute。
+     * 失败返回 `{ title: null }`。
+     */
+    generateSessionTitle(params: GenerateSessionTitleParams): Promise<GenerateSessionTitleResult>;
     private resolveTurnLog;
     /** 同步执行 Graph（经 InvokeOrchestrator，内含 loadedTools 注入） */
     execute(params: ExecuteParams): Promise<ExecuteResult>;

package/dist/runtime/agent-runtime.js

@@ -18,6 +18,8 @@ import { createFileLlmTurnLogFromEnv, } from '../debug/llm-turn-log.js';
 import { buildHitlWaitingTaskOutput, buildTurnTranscriptFromStreamEvents, loadModelFacingHistory, turnGraphMessagesAfterCompression, extractHitlThreadId, extractStreamReasoning, applyStreamTextDelta, createStreamAssistantBuckets, visibleStreamAssistantText, streamAssistantTexts, messageRecordsToGraphMessages, persistHitlWaitingPlaceholder, persistTurnTranscript, persistUserTurnMessage, resolveCheckpointThreadId, appendTerminalToolResult, } from '../session/persist-turn-messages.js';
 import { iterSessionCompression, withCompressionSummaryModel, } from '../session/apply-session-compression.js';
 import { applySessionMemory } from '../session/apply-session-memory.js';
+import { buildSessionTitleUserPayload, invokeSessionTitle, } from '../session/session-title.js';
+import { EchoLLMProvider } from '../providers/echo-llm-provider.js';
 import { resolveTokenDetail, shouldEmitTokenSse } from '../token/token-detail.js';
 import { AppError, ErrorCodes } from '@gt-fe/eap-contracts';
 import { resolveExecutionContext } from '../governance/governance-client.js';
@@ -192,6 +194,39 @@ export class AgentRuntime {
         }
         return [];
     }
+    /**
+     * 根据该 sessionId 的 Message 生成会话标题。不写库、不进 execute。
+     * 失败返回 `{ title: null }`。
+     */
+    async generateSessionTitle(params) {
+        try {
+            const provider = this.deps.llmProvider ?? this.deps.sessionCompression?.provider;
+            if (!provider || provider instanceof EchoLLMProvider) {
+                return { title: null };
+            }
+            if (!this.deps.messageService) {
+                return { title: null };
+            }
+            const messages = await this.deps.messageService.getMessages(params.sessionId);
+            const payload = buildSessionTitleUserPayload(messages);
+            if (!payload) {
+                return { title: null };
+            }
+            let model = params.model?.trim() ?? '';
+            if (!model && params.agentCode && this.deps.graphLoader) {
+                const resolved = await this.deps.graphLoader.resolveDefaultModel(params.agentCode, params.agentVersion);
+                model = resolved?.trim() ?? '';
+            }
+            const title = await invokeSessionTitle(provider, payload, {
+                model,
+                sessionId: params.sessionId,
+            });
+            return { title };
+        }
+        catch {
+            return { title: null };
+        }
+    }
     resolveTurnLog() {
         return this.deps.turnLog ?? createFileLlmTurnLogFromEnv();
     }

package/dist/runtime/dev-runtime.js

@@ -235,6 +235,7 @@ export function createDevRuntime(options) {
         sessionCompression,
         sessionMemory,
         timeoutManager,
+        llmProvider,
     });
     return {
         invokeOrchestrator,

package/dist/runtime/index.d.ts

@@ -1,4 +1,4 @@
 export { AgentRuntime, createAgentRuntime, type AgentRuntimeDeps, type ForkRelationRecord, type RecordForkRelation, type ConversationDetail, } from './agent-runtime.js';
-export type { ExecuteParams, ExecuteResult, ForkParams, ForkOverrides, ForkResult, HitlResponse, ResumeHitlResult, SSEEvent, } from './types.js';
+export type { ExecuteParams, ExecuteResult, ForkParams, ForkOverrides, ForkResult, HitlResponse, ResumeHitlResult, SSEEvent, GenerateSessionTitleParams, GenerateSessionTitleResult, } from './types.js';
 export { createDevRuntime, type DevRuntime, type CreateDevRuntimeOptions, } from './dev-runtime.js';
 export { assembleRuntimeStorage, resolveRuntimeStorageProfile, resolveDevStorageDirs, type RuntimeStorageProfile, type AssembleRuntimeStorageOptions, type AssembledRuntimeStorage, } from './storage-profile.js';

package/dist/runtime/types.d.ts

@@ -38,6 +38,19 @@ export interface ExecuteParams {
 }
 /** 同步执行结果 */
 export type ExecuteResult = InvokeResponseData;
+/** 会话标题生成入参。不启动图执行。 */
+export interface GenerateSessionTitleParams {
+    sessionId: string;
+    /** 覆盖标题模型；未设则用 Agent `models.default` */
+    model?: string;
+    /** 用于解析 `models.default`；与 execute 的 agentCode 相同 */
+    agentCode?: string;
+    agentVersion?: string;
+}
+/** 已规范到 ≤50 字；失败为 null */
+export interface GenerateSessionTitleResult {
+    title: string | null;
+}
 /** HITL 恢复结果（与 @gt-fe/eap-contracts ResumeHitlResult 对齐） */
 export type { ResumeHitlResult };
 /** HITL 用户响应（与 @gt-fe/eap-contracts ResumeHitlRequest 对齐；userId 必填） */

package/dist/session/apply-session-compression.js

@@ -13,6 +13,7 @@ import { EchoLLMProvider } from '../providers/echo-llm-provider.js';
 import { COMPRESSION_WINDOW_FACTOR, countRounds, DEFAULT_COMPRESSION_CONFIG, } from '../memory/message-compression.service.js';
 import { SlidingWindowCompression } from '../memory/compression/sliding-window.compression.js';
 import { emitRuntimeLog } from '../common/logger.js';
+import { SESSION_TITLE_TURN_NODE_ID } from './session-title.js';
 /** 摘要 LLM 写入 llm_turns 的 nodeId。lastTurnUsage 跳过，避免用摘要占用触发下一轮压缩。 */
 export const COMPRESSION_TURN_NODE_ID = 'session-compression';
 export function isRuntimeCompressionEnabled(explicit, env = process.env) {
@@ -256,8 +257,11 @@ async function lastTurnUsage(turnLog, sessionId) {
     const index = await turnLog.list(sessionId);
     for (let i = index.length - 1; i >= 0; i--) {
         const entry = index[i];
-        if (!entry || entry.nodeId === COMPRESSION_TURN_NODE_ID)
+        if (!entry ||
+            entry.nodeId === COMPRESSION_TURN_NODE_ID ||
+            entry.nodeId === SESSION_TITLE_TURN_NODE_ID) {
             continue;
+        }
         if (typeof entry.used !== 'number')
             continue;
         return { used: entry.used, window: entry.window };

package/dist/session/index.d.ts

@@ -13,3 +13,4 @@ export { CompressionMiddleware, createCompressionMiddleware } from './compressio
 export { applySessionCompression, COMPRESSION_TURN_NODE_ID, withCompressionSummaryModel, runSessionCompression, decideSessionCompression, iterSessionCompression, formatCompressionStartedMessage, formatCompressionCompletedMessage, isRuntimeCompressionEnabled, isRuntimeCompressionPersist, type SessionCompressionOptions, type RunSessionCompressionParams, type RunSessionCompressionResult, type SessionCompressionDecision, type SessionCompressionStep, } from './apply-session-compression.js';
 export type { CompressionMiddlewareConfig } from './compression-middleware.js';
 export { applySessionMemory, isRuntimeMemoryEnabled, type SessionMemoryOptions, } from './apply-session-memory.js';
+export { SESSION_TITLE_MAX_CHARS, SESSION_TITLE_ASSISTANT_CHAR_BUDGET, SESSION_TITLE_TURN_NODE_ID, SESSION_TITLE_USER_CHAR_BUDGET, provisionalSessionTitle, normalizeGeneratedTitle, fitUserTexts, buildSessionTitleUserPayload, invokeSessionTitle, } from './session-title.js';

package/dist/session/index.js

@@ -12,3 +12,4 @@ export { SessionContextService } from './session-context.service.js';
 export { CompressionMiddleware, createCompressionMiddleware } from './compression-middleware.js';
 export { applySessionCompression, COMPRESSION_TURN_NODE_ID, withCompressionSummaryModel, runSessionCompression, decideSessionCompression, iterSessionCompression, formatCompressionStartedMessage, formatCompressionCompletedMessage, isRuntimeCompressionEnabled, isRuntimeCompressionPersist, } from './apply-session-compression.js';
 export { applySessionMemory, isRuntimeMemoryEnabled, } from './apply-session-memory.js';
+export { SESSION_TITLE_MAX_CHARS, SESSION_TITLE_ASSISTANT_CHAR_BUDGET, SESSION_TITLE_TURN_NODE_ID, SESSION_TITLE_USER_CHAR_BUDGET, provisionalSessionTitle, normalizeGeneratedTitle, fitUserTexts, buildSessionTitleUserPayload, invokeSessionTitle, } from './session-title.js';

package/dist/session/session-title.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 会话标题：从 Message 生成短标题字符串。
+ * 不写库、不进 execute。Hosting 负责落 sessions.title。
+ *
+ * @see docs/architecture/session-title-generation.md
+ */
+import type { GraphMessage } from '../graph/contracts/executable-graph.js';
+import type { ILLMProvider } from '../graph/nodes/llm-node.js';
+import type { MessageRecord } from './session.service.js';
+/** 与 `@gt-fe/eap-contracts` `SESSION_TITLE_MAX_CHARS` 同值。 */
+export declare const SESSION_TITLE_MAX_CHARS = 50;
+export declare const SESSION_TITLE_USER_CHAR_BUDGET = 2000;
+export declare const SESSION_TITLE_ASSISTANT_CHAR_BUDGET = 500;
+/** 标题 LLM 写入 llm_turns 的 nodeId。压缩 lastTurnUsage 跳过。 */
+export declare const SESSION_TITLE_TURN_NODE_ID = "session-title";
+export declare function clipChars(text: string, max: number): string;
+/** 临时标题：去换行后截到 50 字。 */
+export declare function provisionalSessionTitle(userText: string): string;
+export declare function normalizeGeneratedTitle(raw: string): string | null;
+/** 超预算时丢掉最早的 user；只剩一条仍超则保留开头。 */
+export declare function fitUserTexts(texts: string[], budget: number): string[];
+export declare function buildSessionTitleUserPayload(messages: MessageRecord[]): string | null;
+export declare function buildSessionTitlePromptMessages(payload: string): GraphMessage[];
+export declare function invokeSessionTitle(provider: ILLMProvider, payload: string, options: {
+    model?: string;
+    sessionId: string;
+}): Promise<string | null>;

package/dist/session/session-title.js

@@ -0,0 +1,86 @@
+/**
+ * 会话标题：从 Message 生成短标题字符串。
+ * 不写库、不进 execute。Hosting 负责落 sessions.title。
+ *
+ * @see docs/architecture/session-title-generation.md
+ */
+import { EchoLLMProvider } from '../providers/echo-llm-provider.js';
+/** 与 `@gt-fe/eap-contracts` `SESSION_TITLE_MAX_CHARS` 同值。 */
+export const SESSION_TITLE_MAX_CHARS = 50;
+export const SESSION_TITLE_USER_CHAR_BUDGET = 2000;
+export const SESSION_TITLE_ASSISTANT_CHAR_BUDGET = 500;
+/** 标题 LLM 写入 llm_turns 的 nodeId。压缩 lastTurnUsage 跳过。 */
+export const SESSION_TITLE_TURN_NODE_ID = 'session-title';
+const TITLE_SYSTEM_PROMPT = '根据对话写一个不超过50个字的会话标题。跟随用户主要语言。只输出标题，不要引号、不要解释。';
+export function clipChars(text, max) {
+    const chars = Array.from(text);
+    return chars.length <= max ? text : chars.slice(0, max).join('');
+}
+/** 临时标题：去换行后截到 50 字。 */
+export function provisionalSessionTitle(userText) {
+    const collapsed = userText.replace(/\s+/g, ' ').trim();
+    return clipChars(collapsed, SESSION_TITLE_MAX_CHARS);
+}
+export function normalizeGeneratedTitle(raw) {
+    const stripped = raw
+        .replace(/^[\s"'「」『』《》]+|[\s"'「」『』《》]+$/g, '')
+        .replace(/\s+/g, ' ')
+        .trim();
+    if (!stripped)
+        return null;
+    return clipChars(stripped, SESSION_TITLE_MAX_CHARS);
+}
+function charLength(text) {
+    return Array.from(text).length;
+}
+/** 超预算时丢掉最早的 user；只剩一条仍超则保留开头。 */
+export function fitUserTexts(texts, budget) {
+    const out = texts.filter((t) => t.length > 0);
+    while (out.length > 1 && out.reduce((n, t) => n + charLength(t), 0) > budget) {
+        out.shift();
+    }
+    if (out.length === 1 && charLength(out[0]) > budget) {
+        out[0] = clipChars(out[0], budget);
+    }
+    return out;
+}
+export function buildSessionTitleUserPayload(messages) {
+    const users = messages
+        .filter((m) => m.role === 'user')
+        .map((m) => m.content.trim())
+        .filter(Boolean);
+    if (users.length === 0)
+        return null;
+    const fitted = fitUserTexts(users, SESSION_TITLE_USER_CHAR_BUDGET);
+    const parts = [...fitted];
+    const lastAssistant = [...messages]
+        .reverse()
+        .find((m) => m.role === 'assistant' && m.content.trim());
+    if (lastAssistant) {
+        parts.push(clipChars(lastAssistant.content.trim(), SESSION_TITLE_ASSISTANT_CHAR_BUDGET));
+    }
+    return parts.join('\n');
+}
+export function buildSessionTitlePromptMessages(payload) {
+    return [
+        { role: 'system', content: TITLE_SYSTEM_PROMPT },
+        { role: 'user', content: payload },
+    ];
+}
+export async function invokeSessionTitle(provider, payload, options) {
+    if (provider instanceof EchoLLMProvider)
+        return null;
+    const rawModel = options.model?.trim() ?? '';
+    const model = rawModel.toLowerCase() === 'default' ? '' : rawModel;
+    const response = await provider.invoke(buildSessionTitlePromptMessages(payload), {
+        model,
+        temperature: 0.2,
+        maxTokens: 64,
+        toolChoice: 'none',
+        turn: {
+            sessionId: options.sessionId,
+            nodeId: SESSION_TITLE_TURN_NODE_ID,
+        },
+    });
+    return normalizeGeneratedTitle(response.content ?? '');
+}

package/package.json

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