@gt-fe/eap-runtime 0.0.8 → 0.0.11

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

@@ -14,9 +14,11 @@ import { HitlHandler } from '../graph/hitl/hitl-handler.js';
 import type { GraphLoader } from '../registry/graph-loader.js';
 import type { SessionContextService } from '../session/session-context.service.js';
 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 { SSEEvent } from '../sse/contracts/sse-emitter.contract.js';
 import type { TaskService } from '../task/task.service.js';
-import type { ExecuteParams, ExecuteResult, ForkOverrides, ForkResult, HitlResponse, ResumeHitlResult, SeedSessionMessagesParams, SeedSessionMessagesResult } from './types.js';
+import type { ExecuteParams, ExecuteResult, ForkParams, ForkOverrides, ForkResult, HitlResponse, ResumeHitlResult, SeedSessionMessagesParams, SeedSessionMessagesResult } from './types.js';
 export interface ForkRelationRecord {
     originalTraceId: string;
     forkedTraceId: string;
@@ -34,6 +36,10 @@ export interface AgentRuntimeDeps {
     graphLoader?: GraphLoader;
     /** 多轮短期记忆写回；未注入时 AgentRuntime.stream 跳过持久化 */
     messageService?: MessageService;
+    /** 会话查询（getConversation）；未注入时仅返回 messages/llmTurns */
+    sessionService?: SessionService;
+    /** 每步 LLM 入参/响应落盘；未注入时按环境默认 `.eap/llm-turns` */
+    turnLog?: ILlmTurnLog;
     /**
      * Hosting 注入的 Trace 采集器。与 ExecuteParams.traceId 同时存在时，
      * Skill/Tool 节点会 createNode/completeNode。不注入则只发 SSE，不写 Span。
@@ -41,6 +47,27 @@ export interface AgentRuntimeDeps {
     traceCollector?: ITraceCollector;
     recordForkRelation?: RecordForkRelation;
 }
+/** 一次对话详情：消息 + 每步 LLM 入参/响应。File / 内存 / Postgres 同一套结构。 */
+export interface ConversationDetail {
+    sessionId: string;
+    session: SessionRecord | null;
+    messages: MessageRecord[];
+    llmTurns: LlmTurnRecord[];
+    llmTurnIndex: LlmTurnIndexEntry[];
+    tokens: {
+        input: number;
+        output: number;
+        total: number;
+        byNode: Record<string, {
+            input: number;
+            output: number;
+        }>;
+    };
+    storage: {
+        llmTurnKind?: LlmTurnLogKind;
+        llmTurnDir?: string;
+    };
+}
 /**
  * AgentRuntime — 管理 Graph 执行的 SDK 门面
  */
@@ -69,6 +96,17 @@ export declare class AgentRuntime {
      * @throws PARAMS_INVALID messageService 未注入（无存储无法写入）
      */
     seedSessionMessages(params: SeedSessionMessagesParams): Promise<SeedSessionMessagesResult>;
+    /**
+     * 查询一次对话详情：会话元数据、消息、每步 LLM 落盘（入参、响应、URL、模型、脱敏 sk、提示词）。
+     * 本地默认读 `.eap/sessions` + `.eap/llm-turns/{sessionId}/`。
+     */
+    getConversation(sessionId: string): Promise<ConversationDetail>;
+    listLlmTurns(sessionId: string): Promise<LlmTurnIndexEntry[]>;
+    getLlmTurn(sessionId: string, turnId: string): Promise<LlmTurnRecord | null>;
+    listConversations(options?: {
+        userId?: string;
+    }): Promise<SessionRecord[]>;
+    private resolveTurnLog;
     /** 同步执行 Graph（经 InvokeOrchestrator，内含 loadedTools 注入） */
     execute(params: ExecuteParams): Promise<ExecuteResult>;
     /**
@@ -92,9 +130,10 @@ export declare class AgentRuntime {
      */
     streamResumeHitl(taskId: string, response: HitlResponse): AsyncIterable<SSEEvent>;
     /**
-     * 从 Checkpoint Fork 并真实重新执行
+     * 从 Checkpoint Fork 并真实重新执行。
+     * taskId / traceId 由上层发号；Runtime 不 createFlow、不另发 Task 号。
      */
-    fork(checkpointId: string, overrides?: ForkOverrides): Promise<ForkResult>;
+    fork(params: ForkParams): Promise<ForkResult>;
     private prepareHitlResume;
     private rebuildExecutableGraph;
     private handleHitlTimeout;

package/dist/runtime/agent-runtime.js

@@ -7,10 +7,12 @@
  * @see 04-runtime-core/design.md §1.5 / §1.7
  */
 import { randomUUID } from 'node:crypto';
-import { HitlAlreadyTimedOutError, HitlNotWaitingError, buildHitlWaitedPayload, isHitlDeadlinePassed, readPersistedHitlWaiting, unwrapHitlPaused, } from '../graph/hitl/hitl-handler.js';
-import { toLoadedSkillMap, mergeSkillScriptTools } from '../tool/system-prompt-builder.js';
+import { HITL_TIMEOUT_ERROR_CODE, HITL_TIMEOUT_MESSAGE, HitlAlreadyTimedOutError, HitlNotWaitingError, buildHitlWaitedPayload, isHitlDeadlinePassed, readPersistedHitlWaiting, unwrapHitlPaused, } from '../graph/hitl/hitl-handler.js';
+import { toLoadedSkillMap } from '../tool/system-prompt-builder.js';
+import { assembleLoadedTools } from '../tool/harness-primitives.js';
+import { createFileLlmTurnLogFromEnv, } from '../debug/llm-turn-log.js';
 import { buildHitlWaitingTaskOutput, buildTurnGraphMessages, buildTurnTranscriptFromStreamEvents, extractHitlThreadId, extractStreamReasoning, extractStreamTextDelta, messageRecordsToGraphMessages, persistHitlWaitingPlaceholder, persistTurnTranscript, persistUserTurnMessage, } from '../session/persist-turn-messages.js';
-import { AppError, ErrorCodes } from '@gt-fe/eap-contracts';
+import { AppError, ErrorCodes } from '@eap/contracts';
 import { resolveExecutionContext } from '../governance/governance-client.js';
 import { resolveAgentCode } from '../common/agent-code.js';
 import { resolveTraceId } from '../common/trace-id.js';
@@ -42,6 +44,7 @@ export class AgentRuntime {
         if (typeof this.deps.hitlHandler.setTimeoutListener === 'function') {
             this.deps.hitlHandler.setTimeoutListener((event) => this.handleHitlTimeout(event));
         }
+        this.deps.hitlHandler.setTraceCollector?.(this.deps.traceCollector);
     }
     /** 从 GraphLoader 解析 tool manifest 映射（invoke/stream/resume/fork 共用） */
     async resolveLoadedTools(agentCode, agentVersion) {
@@ -126,6 +129,64 @@ export class AgentRuntime {
         })));
         return { sessionId, seeded: true };
     }
+    /**
+     * 查询一次对话详情：会话元数据、消息、每步 LLM 落盘（入参、响应、URL、模型、脱敏 sk、提示词）。
+     * 本地默认读 `.eap/sessions` + `.eap/llm-turns/{sessionId}/`。
+     */
+    async getConversation(sessionId) {
+        const turnLog = this.resolveTurnLog();
+        const [session, messages, llmTurnIndex] = await Promise.all([
+            this.deps.sessionService
+                ? this.deps.sessionService.findSession(sessionId).catch(() => null)
+                : Promise.resolve(null),
+            this.deps.messageService
+                ? this.deps.messageService.getMessages(sessionId)
+                : Promise.resolve([]),
+            turnLog ? turnLog.list(sessionId) : Promise.resolve([]),
+        ]);
+        const llmTurns = [];
+        if (turnLog) {
+            for (const entry of llmTurnIndex) {
+                const record = await turnLog.read(sessionId, entry.id);
+                if (record)
+                    llmTurns.push(record);
+            }
+        }
+        const tokens = summarizeTurnTokens(llmTurns);
+        return {
+            sessionId,
+            session,
+            messages,
+            llmTurns,
+            llmTurnIndex,
+            tokens,
+            storage: { llmTurnKind: turnLog?.kind, llmTurnDir: turnLog?.baseDir },
+        };
+    }
+    async listLlmTurns(sessionId) {
+        const turnLog = this.resolveTurnLog();
+        if (!turnLog)
+            return [];
+        return turnLog.list(sessionId);
+    }
+    async getLlmTurn(sessionId, turnId) {
+        const turnLog = this.resolveTurnLog();
+        if (!turnLog)
+            return null;
+        return turnLog.read(sessionId, turnId);
+    }
+    async listConversations(options) {
+        if (options?.userId && this.deps.sessionService) {
+            return this.deps.sessionService.listSessions(options.userId);
+        }
+        if (this.deps.sessionService) {
+            return this.deps.sessionService.listAllSessions();
+        }
+        return [];
+    }
+    resolveTurnLog() {
+        return this.deps.turnLog ?? createFileLlmTurnLogFromEnv();
+    }
     /** 同步执行 Graph（经 InvokeOrchestrator，内含 loadedTools 注入） */
     async execute(params) {
         const agentCode = resolveAgentCode(params);
@@ -203,11 +264,13 @@ export class AgentRuntime {
             })
             : undefined;
         const skillDefinitions = toLoadedSkillMap(loadedSkills);
-        // Skill scripts 虚拟 Tool 并入 loadedTools（同名不覆盖平台 Tool）
-        const loadedTools = mergeSkillScriptTools(loadedToolsBase, loadedSkills);
+        const loadedTools = assembleLoadedTools(loadedToolsBase);
         const promptRoots = this.deps.graphLoader
             ? await this.deps.graphLoader.resolvePromptRoots(agentCode, params.agentVersion)
             : [];
+        const agentDir = this.deps.graphLoader
+            ? (await this.deps.graphLoader.resolveAgentDir(agentCode, params.agentVersion)) ?? undefined
+            : undefined;
         const history = messageRecordsToGraphMessages(sessionContext.messages);
         const messages = await buildTurnGraphMessages({
             history,
@@ -237,6 +300,7 @@ export class AgentRuntime {
                 loadedSkills,
                 skillDefinitions,
                 promptRoots,
+                agentDir,
                 skillInput: resolveSkillInputFromInvokeInput(params.input),
                 traceId: resolveTraceId(params),
                 traceCollector: this.deps.traceCollector,
@@ -382,7 +446,7 @@ export class AgentRuntime {
         }
         catch (err) {
             if (err instanceof HitlAlreadyTimedOutError) {
-                throw new AppError(ErrorCodes.TASK_HITL_TIMEOUT, `Task ${taskId} HITL wait exceeded deadline`, { exposeMessage: true });
+                throw new AppError(ErrorCodes.TASK_HITL_TIMEOUT, HITL_TIMEOUT_MESSAGE, { exposeMessage: true });
             }
             if (err instanceof HitlNotWaitingError) {
                 throw new AppError(ErrorCodes.TASK_HITL_INVALID_STATE, `Task ${taskId} is not waiting for HITL`, { exposeMessage: true });
@@ -405,8 +469,8 @@ export class AgentRuntime {
         const agentVersion = (typeof resumedState.agentVersion === 'string' && resumedState.agentVersion) ||
             undefined;
         const graph = await this.rebuildExecutableGraph(agentCode, agentVersion);
-        const loadedTools = resumedState.loadedTools ??
-            (await this.resolveLoadedTools(agentCode, agentVersion));
+        const loadedTools = assembleLoadedTools(resumedState.loadedTools ??
+            (await this.resolveLoadedTools(agentCode, agentVersion)));
         const skillFromState = resumedState.skillDefinitions;
         const skillBundle = skillFromState
             ? {
@@ -422,6 +486,10 @@ export class AgentRuntime {
             taskId,
             correlationId: resumedState.correlationId ?? correlationId,
             agentVersion: agentVersion ?? resumedState.agentVersion,
+            agentDir: (typeof resumedState.agentDir === 'string' && resumedState.agentDir) ||
+                (this.deps.graphLoader
+                    ? (await this.deps.graphLoader.resolveAgentDir(agentCode, agentVersion)) ?? undefined
+                    : undefined),
             activatedSkill: resumedState.activatedSkill,
             skillRoute: resumedState.skillRoute ??
                 (typeof resumedState.activatedSkill === 'string' && resumedState.activatedSkill
@@ -536,16 +604,23 @@ export class AgentRuntime {
         }
     }
     /**
-     * 从 Checkpoint Fork 并真实重新执行
+     * 从 Checkpoint Fork 并真实重新执行。
+     * taskId / traceId 由上层发号；Runtime 不 createFlow、不另发 Task 号。
      */
-    async fork(checkpointId, overrides = {}) {
+    async fork(params) {
+        const { checkpointId, taskId, traceId } = params;
+        if (!taskId?.trim() || !traceId?.trim()) {
+            throw new AppError(ErrorCodes.PARAMS_INVALID, 'fork requires non-empty taskId and traceId from the caller', { exposeMessage: true });
+        }
+        const overrides = {
+            ...params.overrides,
+            executionContext: params.executionContext ?? params.overrides?.executionContext,
+        };
         const source = await this.deps.checkpointSaver.loadByCheckpointId(checkpointId);
         if (!source) {
             throw new AppError(ErrorCodes.HOSTING_CHECKPOINT_NOT_FOUND, `Checkpoint not found: ${checkpointId}`, { exposeMessage: true });
         }
-        // 优先级：overrides（agentCode > 废弃 agentId）> Checkpoint state
         const agentCode = overrides.agentCode ??
-            overrides.agentId ??
             source.state.agentCode ??
             source.state.agentId ??
             'unknown-agent';
@@ -556,8 +631,9 @@ export class AgentRuntime {
             source.checkpointId;
         const newThreadId = randomUUID();
         const forkedCheckpoint = await this.deps.checkpointSaver.fork(checkpointId, newThreadId, overrides);
-        const correlationId = randomUUID();
+        const correlationId = overrides.executionContext?.correlationId ?? randomUUID();
         const task = await this.deps.taskService.create({
+            id: taskId,
             agentId: agentCode,
             sessionId,
             userId,
@@ -566,48 +642,46 @@ export class AgentRuntime {
             timeout: 600_000,
         });
         await this.deps.taskService.updateStatus(task.id, 'running');
-        let newTraceId = randomUUID();
-        if (this.deps.traceCollector) {
-            newTraceId = await this.deps.traceCollector.createFlow({
-                traceId: newTraceId,
-                agentId: agentCode,
-                agentCode,
-                sessionId,
-                userId,
-                correlationId,
-                callType: 'fork',
-                metadata: { checkpointId, originalTraceId },
-            });
-        }
         const agentVersion = overrides.agentVersion ??
             (typeof source.state.agentVersion === 'string' ? source.state.agentVersion : undefined);
         const graph = await this.rebuildExecutableGraph(agentCode, agentVersion);
         const loadedToolsBase = await this.resolveLoadedTools(agentCode, agentVersion);
         const skillBundle = await this.resolveLoadedSkills(agentCode, userId, agentVersion);
-        const loadedTools = mergeSkillScriptTools(loadedToolsBase, skillBundle.loadedSkills);
+        const loadedTools = assembleLoadedTools(loadedToolsBase);
+        const agentDir = (typeof forkedCheckpoint.state.agentDir === 'string' && forkedCheckpoint.state.agentDir) ||
+            (this.deps.graphLoader
+                ? (await this.deps.graphLoader.resolveAgentDir(agentCode, agentVersion)) ?? undefined
+                : undefined);
         try {
             const result = await this.deps.graphEngine.invoke(graph, {
                 ...forkedCheckpoint.state,
                 agentVersion,
+                agentDir,
                 userId,
                 delegationToken: overrides.executionContext?.delegationToken,
                 executionContext: overrides.executionContext,
                 loadedTools,
                 ...skillBundle,
-                traceId: newTraceId,
+                taskId: task.id,
+                traceId,
                 traceCollector: this.deps.traceCollector,
             });
             await this.deps.taskService.updateStatus(task.id, 'success', result.output);
             if (this.deps.recordForkRelation) {
-                await this.deps.recordForkRelation({
-                    originalTraceId,
-                    forkedTraceId: newTraceId,
-                    checkpointId,
-                    overrides,
-                });
+                try {
+                    await this.deps.recordForkRelation({
+                        originalTraceId,
+                        forkedTraceId: traceId,
+                        checkpointId,
+                        overrides,
+                    });
+                }
+                catch {
+                    // Fork 关系上报失败不阻断执行结果
+                }
             }
             return {
-                newTraceId,
+                newTraceId: traceId,
                 originalTraceId,
                 newTaskId: task.id,
                 checkpointId,
@@ -618,14 +692,14 @@ export class AgentRuntime {
                     output_tokens: result.tokenUsage.output,
                     total_tokens: result.tokenUsage.total,
                 },
-                compareUrl: `/traces/compare?traceId1=${originalTraceId}&traceId2=${newTraceId}`,
+                compareUrl: `/traces/compare?traceId1=${originalTraceId}&traceId2=${traceId}`,
             };
         }
         catch (err) {
             const message = err instanceof Error ? err.message : 'Unknown error';
             await this.deps.taskService.updateStatus(task.id, 'failed', message);
             return {
-                newTraceId,
+                newTraceId: traceId,
                 originalTraceId,
                 newTaskId: task.id,
                 checkpointId,
@@ -679,7 +753,7 @@ export class AgentRuntime {
                 toolSpanId: persisted.toolSpanId,
                 skillSpanId: persisted.skillSpanId,
             });
-            throw new AppError(ErrorCodes.TASK_HITL_TIMEOUT, `Task ${taskId} HITL wait exceeded deadline`, { exposeMessage: true });
+            throw new AppError(ErrorCodes.TASK_HITL_TIMEOUT, HITL_TIMEOUT_MESSAGE, { exposeMessage: true });
         }
         return {
             task,
@@ -719,7 +793,7 @@ export class AgentRuntime {
             return;
         }
         const collector = this.deps.traceCollector;
-        const error = event.behavior === 'cancel' ? 'HITL cancelled by timeout' : 'HITL wait timed out';
+        const error = HITL_TIMEOUT_MESSAGE;
         if (collector) {
             if (event.toolSpanId) {
                 try {
@@ -746,6 +820,7 @@ export class AgentRuntime {
                 toolCallId: event.toolCallId,
                 toolName: event.toolName,
                 error,
+                errorCode: HITL_TIMEOUT_ERROR_CODE,
             });
         }
         catch {
@@ -771,6 +846,21 @@ export class AgentRuntime {
         };
     }
 }
+function summarizeTurnTokens(turns) {
+    const byNode = {};
+    let input = 0;
+    let output = 0;
+    for (const turn of turns) {
+        input += turn.response.inputTokens ?? 0;
+        output += turn.response.outputTokens ?? 0;
+        const nodeId = turn.nodeId ?? 'llm';
+        const bucket = byNode[nodeId] ?? { input: 0, output: 0 };
+        bucket.input += turn.response.inputTokens ?? 0;
+        bucket.output += turn.response.outputTokens ?? 0;
+        byNode[nodeId] = bucket;
+    }
+    return { input, output, total: input + output, byNode };
+}
 /** 工厂：从运行时依赖组装 AgentRuntime */
 export function createAgentRuntime(deps) {
     return new AgentRuntime(deps);

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

@@ -18,7 +18,7 @@
  *
  * 装配策略（与 server.ts 一致）：
  * - LLM Provider: Routing > HttpLLMProvider(OpenAI) > Echo 兜底
- * - Tool Executor: mock（显式）/ DevToolExecutor（dev+mcp，缺配置失败）/ 通用路由
+ * - Tool Executor: DevToolExecutor（dev+mcp，缺配置失败）/ 通用路由
  * - Governance: AllowAll(本地闭环默认) / HttpGovernance(显式 GOVERNANCE_DISABLED=0)
  * - 存储: EAP_RUNTIME_STORAGE_PROFILE（默认 dev = File Session/Message/Checkpoint）
  * - Registry: 本地闭环不装配，由 GraphLoader.deploymentSnapshot 兜底
@@ -27,6 +27,7 @@ import { InvokeOrchestrator, StreamOrchestrator, SessionService, MessageService,
 import { type AgentRuntime } from './agent-runtime.js';
 import type { RuntimeStorageProfile } from './storage-profile.js';
 import type { HitlResponse, ResumeHitlResult, SSEEvent } from './types.js';
+import type { ILlmTurnLog } from '../debug/llm-turn-log.js';
 /** createDevRuntime 返回值（CLI 嵌入用，可选字段后续扩展） */
 export interface DevRuntime {
     invokeOrchestrator: InvokeOrchestrator;
@@ -39,6 +40,7 @@ export interface DevRuntime {
     streamResumeHitl: (taskId: string, response: HitlResponse) => AsyncIterable<SSEEvent>;
     sessionService: SessionService;
     messageService: MessageService;
+    turnLog?: ILlmTurnLog;
     sessionContextService: SessionContextService;
     taskService: TaskService;
     tokenStatsService: TokenStatsService;
@@ -53,9 +55,10 @@ export interface DevRuntime {
         llmDefaultModel: string;
         governanceKind: 'AllowAll' | 'Http';
         storageProfile: RuntimeStorageProfile;
-        sessionStoreKind: 'file' | 'in-memory';
-        messageStoreKind: 'memory' | 'file' | 'postgres';
-        checkpointKind: 'memory' | 'file' | 'redis+pg' | 'pg';
+        sessionStoreKind: 'file' | 'hosting';
+        messageStoreKind: 'file' | 'postgres';
+        checkpointKind: 'file' | 'redis+pg';
+        llmTurnKind: 'file' | 'postgres';
         foundationConfigured: boolean;
         skillHotReload: boolean;
     };

package/dist/runtime/dev-runtime.js

@@ -18,7 +18,7 @@
  *
  * 装配策略（与 server.ts 一致）：
  * - LLM Provider: Routing > HttpLLMProvider(OpenAI) > Echo 兜底
- * - Tool Executor: mock（显式）/ DevToolExecutor（dev+mcp，缺配置失败）/ 通用路由
+ * - Tool Executor: DevToolExecutor（dev+mcp，缺配置失败）/ 通用路由
  * - Governance: AllowAll(本地闭环默认) / HttpGovernance(显式 GOVERNANCE_DISABLED=0)
  * - 存储: EAP_RUNTIME_STORAGE_PROFILE（默认 dev = File Session/Message/Checkpoint）
  * - Registry: 本地闭环不装配，由 GraphLoader.deploymentSnapshot 兜底
@@ -28,10 +28,10 @@ import { HttpLLMProvider } from '../providers/http-llm-provider.js';
 import { createLocalLlmProvider, requireLocalLlmConnections } from '../providers/local-llm-provider.js';
 import { RoutingLLMProvider } from '../providers/routing-llm-provider.js';
 import { createToolExecutor } from '../tool/create-tool-executor.js';
-import { MockToolExecutor } from '../tool/mock-tool-executor.js';
 import { DevToolExecutor } from '../tool/dev-tool-executor.js';
+import { withHarnessPrimitives } from '../tool/harness-primitives.js';
 import { AllowAllGovernanceClient, HttpGovernanceClient, } from '../governance/index.js';
-import { InvokeOrchestrator, StreamOrchestrator, SessionService, MessageService, SessionContextService, TaskService, LangGraphAdapter, HitlHandler, TokenBudgetService, InMemoryTokenBudgetRepository, TokenStatsService, TokenBudgetGuard, SessionBudgetChecker, createAgentRegistryClient, GraphLoader, } from '../index.js';
+import { InvokeOrchestrator, StreamOrchestrator, SessionService, MessageService, SessionContextService, TaskService, LangGraphAdapter, HitlHandler, TokenBudgetService, TokenStatsService, TokenBudgetGuard, SessionBudgetChecker, createAgentRegistryClient, GraphLoader, } from '../index.js';
 import { createAgentRuntime } from './agent-runtime.js';
 import { assembleRuntimeStorage } from './storage-profile.js';
 import { resolveSkillHotReload, watchPreinstallSkillRoot, watchSkillRoots } from '../registry/skill-tree.js';
@@ -46,43 +46,42 @@ export function createDevRuntime() {
     const foundationConfigured = Boolean(process.env.FOUNDATION_SERVICE_URL && process.env.FOUNDATION_SERVICE_URL.trim().length > 0);
     const toolExecutionMode = (process.env.EAP_TOOL_EXECUTION_MODE ?? 'mcp').toLowerCase();
     const deploymentContext = process.env.EAP_DEPLOYMENT_CONTEXT ?? 'server';
-    // ── 存储 profile（默认 dev：File Session/Message/Checkpoint）──
-    // 兼容旧变量：EAP_SESSION_STORE=memory → 强制 test（全内存）
-    const legacySessionStore = process.env.EAP_SESSION_STORE?.toLowerCase();
+    // ── 存储：未配库默认文件；配齐 DATABASE + Redis 则 Redis+PG ──
     const storage = assembleRuntimeStorage({
-        defaultProfile: legacySessionStore === 'memory' || legacySessionStore === 'in-memory' ? 'test' : 'dev',
-        profile: legacySessionStore === 'memory' || legacySessionStore === 'in-memory'
-            ? 'test'
-            : undefined,
+        defaultProfile: 'dev',
     });
+    const turnLog = process.env.EAP_LLM_TURN_LOG === '0' ? undefined : storage.turnLog;
     // ── LLM Provider（本地 eap.config runtime.llm 优先，再 Foundation 路由，再环境直连）──
     let llmProviderKind;
     let llmProvider;
     const localLlm = process.env.EAP_LLM_MODE === 'local';
     if (localLlm || (!foundationConfigured && process.env.OPENAI_API_KEY)) {
         llmProvider = localLlm
-            ? createLocalLlmProvider(requireLocalLlmConnections())
+            ? createLocalLlmProvider(requireLocalLlmConnections(), turnLog)
             : new HttpLLMProvider({
                 apiKey: process.env.OPENAI_API_KEY ?? '',
                 baseUrl: process.env.OPENAI_BASE_URL,
                 defaultModel: process.env.EAP_DEFAULT_MODEL,
+                turnLog,
             });
         llmProviderKind = 'openai-http';
     }
     else if (foundationConfigured) {
-        llmProvider = new RoutingLLMProvider({ foundationUrl });
+        llmProvider = new RoutingLLMProvider({ foundationUrl, turnLog });
         llmProviderKind = 'routing';
     }
     else {
-        llmProvider = createDefaultLLMProvider();
+        llmProvider = createDefaultLLMProvider(turnLog);
         llmProviderKind = 'echo';
     }
-    // ── Tool Executor（显式 mock → dev+mcp 直连，缺配置失败 → 通用路由）──
-    const toolExecutor = toolExecutionMode === 'mock'
-        ? new MockToolExecutor({ toolsDir: process.env.EAP_LOCAL_TOOLS_DIR })
-        : toolExecutionMode === 'mcp' && deploymentContext === 'dev'
-            ? new DevToolExecutor()
-            : createToolExecutor({ foundationUrl, deploymentContext });
+    // ── Tool Executor（dev+mcp 直连，缺配置失败 → 通用路由）──
+    const needsHarnessWrap = toolExecutionMode === 'mcp' && deploymentContext === 'dev';
+    const innerExecutor = toolExecutionMode === 'mcp' && deploymentContext === 'dev'
+        ? new DevToolExecutor()
+        : createToolExecutor({ foundationUrl, deploymentContext });
+    const toolExecutor = needsHarnessWrap
+        ? withHarnessPrimitives(innerExecutor)
+        : innerExecutor;
     // ── Governance ──
     const governanceClient = process.env.GOVERNANCE_DISABLED === '1' || !foundationConfigured
         ? new AllowAllGovernanceClient()
@@ -99,7 +98,7 @@ export function createDevRuntime() {
     const sessionContextService = new SessionContextService(sessionService, messageService);
     // ── Task / Token ──
     const taskService = new TaskService();
-    const budgetService = new TokenBudgetService(new InMemoryTokenBudgetRepository());
+    const budgetService = new TokenBudgetService(storage.tokenBudgetRepository);
     const tokenStatsService = new TokenStatsService();
     const tokenBudgetGuard = new TokenBudgetGuard(budgetService);
     const sessionBudgetChecker = new SessionBudgetChecker(budgetService);
@@ -168,6 +167,8 @@ export function createDevRuntime() {
         hitlHandler,
         graphLoader,
         messageService,
+        sessionService,
+        turnLog,
     });
     return {
         invokeOrchestrator,
@@ -177,6 +178,7 @@ export function createDevRuntime() {
         streamResumeHitl: (taskId, response) => agentRuntime.streamResumeHitl(taskId, response),
         sessionService,
         messageService,
+        turnLog,
         sessionContextService,
         taskService,
         tokenStatsService,
@@ -189,9 +191,10 @@ export function createDevRuntime() {
             llmDefaultModel: process.env.EAP_DEFAULT_MODEL ?? 'DeepSeek-V4-Pro',
             governanceKind: governanceClient instanceof AllowAllGovernanceClient ? 'AllowAll' : 'Http',
             storageProfile: storage.profile,
-            sessionStoreKind: storage.diagnostics.sessionKind === 'file' ? 'file' : 'in-memory',
+            sessionStoreKind: storage.diagnostics.sessionKind,
             messageStoreKind: storage.diagnostics.messageKind,
             checkpointKind: storage.diagnostics.checkpointKind,
+            llmTurnKind: storage.diagnostics.llmTurnKind,
             foundationConfigured,
             skillHotReload,
         },

package/dist/runtime/index.d.ts

@@ -1,4 +1,4 @@
-export { AgentRuntime, createAgentRuntime, type AgentRuntimeDeps, type ForkRelationRecord, type RecordForkRelation, } from './agent-runtime.js';
-export type { ExecuteParams, ExecuteResult, ForkOverrides, ForkResult, HitlResponse, ResumeHitlResult, SSEEvent, } from './types.js';
+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 { createDevRuntime, type DevRuntime, } from './dev-runtime.js';
-export { assembleRuntimeStorage, resolveRuntimeStorageProfile, type RuntimeStorageProfile, type AssembleRuntimeStorageOptions, type AssembledRuntimeStorage, } from './storage-profile.js';
+export { assembleRuntimeStorage, resolveRuntimeStorageProfile, resolveDevStorageDirs, type RuntimeStorageProfile, type AssembleRuntimeStorageOptions, type AssembledRuntimeStorage, } from './storage-profile.js';

package/dist/runtime/index.js

@@ -1,3 +1,3 @@
 export { AgentRuntime, createAgentRuntime, } from './agent-runtime.js';
 export { createDevRuntime, } from './dev-runtime.js';
-export { assembleRuntimeStorage, resolveRuntimeStorageProfile, } from './storage-profile.js';
+export { assembleRuntimeStorage, resolveRuntimeStorageProfile, resolveDevStorageDirs, } from './storage-profile.js';

package/dist/runtime/storage-profile.d.ts

@@ -9,11 +9,13 @@ import type { ICheckpointSaver } from '../checkpoint/contracts/checkpoint-saver.
 import { type IPgPool } from '../checkpoint/pg-checkpoint-saver.js';
 import type { ISessionRepository } from '../session/session.service.js';
 import type { IFullMessageRepository } from '../session/message.service.js';
+import type { ILlmTurnLog } from '../debug/llm-turn-log.js';
+import { type ITokenBudgetRepository } from '../token/token-budget.service.js';
 export type RuntimeStorageProfile = 'test' | 'dev' | 'integration' | 'production';
 export interface AssembleRuntimeStorageOptions {
     /** 显式 profile；缺省读 EAP_RUNTIME_STORAGE_PROFILE */
     profile?: RuntimeStorageProfile;
-    /** 未指定 profile 时的默认值（dev-runtime → dev；embedded → integration） */
+    /** 未指定 profile 且未配库时的默认值（本地 CLI → `dev` 文件） */
     defaultProfile: RuntimeStorageProfile;
     /** File Checkpoint / Session / Message 根目录 */
     checkpointDir?: string;
@@ -31,20 +33,27 @@ export interface AssembledRuntimeStorage {
     /** undefined = SessionService 默认 InMemory */
     sessionRepository?: ISessionRepository;
     messageRepository: IFullMessageRepository;
+    turnLog: ILlmTurnLog;
+    tokenBudgetRepository: ITokenBudgetRepository;
     diagnostics: {
         profile: RuntimeStorageProfile;
-        checkpointKind: 'memory' | 'file' | 'redis+pg' | 'pg';
-        sessionKind: 'memory' | 'file';
-        messageKind: 'memory' | 'file' | 'postgres';
+        checkpointKind: 'file' | 'redis+pg';
+        sessionKind: 'file' | 'hosting';
+        messageKind: 'file' | 'postgres';
+        llmTurnKind: 'file' | 'postgres';
+        tokenBudgetKind: 'process' | 'postgres';
     };
 }
 export declare function resolveRuntimeStorageProfile(explicit: RuntimeStorageProfile | undefined, defaultProfile: RuntimeStorageProfile, env?: NodeJS.ProcessEnv): RuntimeStorageProfile;
+/** 本地 File 存储默认落工程 `.eap/`，可用 EAP_DATA_DIR / EAP_*_DIR 覆盖。 */
+export declare function resolveDevStorageDirs(env?: NodeJS.ProcessEnv, cwd?: string): {
+    checkpointDir: string;
+    sessionDir: string;
+    messageDir: string;
+};
 /**
- * 按 profile 装配 Checkpoint / Session / Message 存储
- *
- * - test: 全内存
- * - dev: File Checkpoint + File Session + File Message
- * - integration/production: Message=PG；Checkpoint=Redis 热 + PG 备；
- *   Session 仓储不落 PG（sessionId 权威在 Hosting.sessions，Runtime 内存采纳）
+ * 按 profile 装配 Checkpoint / Message / Token / LLM 回合存储。
+ * `dev`：文件。其余 profile：Redis + PostgreSQL（缺配置则抛错）。
+ * 未设 profile 时：已配置 DB 或 Redis 则按 Redis+PostgreSQL；否则使用 defaultProfile。
  */
 export declare function assembleRuntimeStorage(options: AssembleRuntimeStorageOptions, env?: NodeJS.ProcessEnv): AssembledRuntimeStorage;