@gt-fe/eap-runtime 0.0.28 → 0.0.29

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.29",
   "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/",