@gt-fe/eap-runtime 0.0.12 → 0.0.14

package/README.md

@@ -8,6 +8,7 @@ Enterprise Agent Platform **执行引擎**（LangGraph.js）：Agent Graph 编
 
 | 日期 | 摘要 |
 |------|------|
+| 2026-08-29 | 待办收口：[`docs/TODO.md`](./docs/TODO.md)。压缩主路径未接；窗口展示不在 Runtime；Gateway 须 `tools/list` |
 | 2026-08-24 | 0.0.10：官方 Skill / Harness、`ForkParams`、对话详情、存储两档。依赖 `@eap/contracts@0.0.9`。详见 [CHANGELOG.md](./CHANGELOG.md) |
 | 2026-08-21 | 0.0.9：Gateway `/mcp` JSON-RPC 补 `Accept`；`tools/call` 透传工具版本。详见 [CHANGELOG.md](./CHANGELOG.md) |
 | 2026-08-19 | 0.0.8：Skill 子图 SSE 闭环；`ExecuteParams.traceId`；`tool.called` 改为 Tool 节点开始执行。依赖 `@eap/contracts@0.0.8`。详见 [CHANGELOG.md](./CHANGELOG.md) |
@@ -28,6 +29,7 @@ Enterprise Agent Platform **执行引擎**（LangGraph.js）：Agent Graph 编
 | 环境变量总表 | [`docs/governance/governance-env-config.md`](../docs/governance/governance-env-config.md) |
 | 预装联调契约 | [`docs/contracts/preload-hosting-runtime-contract.md`](../docs/contracts/preload-hosting-runtime-contract.md) |
 | 预装加载与请求流转 | [`docs/contracts/runtime-preinstall-load-flow.md`](../docs/contracts/runtime-preinstall-load-flow.md) |
+| Runtime 待办 | [`docs/TODO.md`](./docs/TODO.md) | 压缩主路径、窗口展示、Gateway `tools/list` |
 | 技能 FS 待办 | [`docs/TODO-skill-fs.md`](./docs/TODO-skill-fs.md) |
 | 本地 Agent 闭环 | [`docs/workflows/local-agent-dev-loop.md`](../docs/workflows/local-agent-dev-loop.md) |
 
@@ -131,7 +133,7 @@ dev-tools (eap chat / eap dev)
 
 - **引擎**：`LangGraphAdapter`（`IStateGraphEngine`）将平台 Graph DSL 编成 LangGraph StateGraph
 - **节点**：`llm`、`tool`、`subgraph`（Skill）、并行/条件边、HITL 等待
-- **Skill 子图**：节点可带内嵌 `subgraphDsl`；或仅 `skillId`，从 state.`skillDefinitions` 取 `workflow` 执行；技能 `prompt` 经 `activeSkillPrompt` 注入子图入口 LLM
+- **Skill 子图**：节点可带内嵌 `subgraphDsl`；或仅 `skillId`，从 state.`skillDefinitions` 取 `workflow` 执行。技能正文用短目录 + `read_file`，不灌 system
 - **权限**：子图执行前 `skill:{skillId}:use`（Governance）
 - **流式**：`stream()` 产出 RuntimeEvent，再映射为 SSE（`response.chunk`、`tool.*`、`task.*` 等）
 

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

@@ -22,7 +22,7 @@ import type { TokenStatsService } from '../../token/token-stats.service.js';
 import type { TokenBudgetGuard } from '../../token/token-budget-guard.js';
 import type { SessionBudgetChecker } from '../../token/session-budget-checker.js';
 import type { InvokeRequest, InvokeResponse } from '../routes/agent.routes.js';
-import type { GraphLoader } from '../../registry/graph-loader.js';
+import { type GraphLoader } from '../../registry/graph-loader.js';
 import type { ICheckpointSaver } from '../../checkpoint/contracts/checkpoint-saver.contract.js';
 import type { ITraceCollector } from '../../contracts/trace-collector.js';
 /**

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

@@ -20,6 +20,7 @@ import { SessionBudgetExhaustedError } from '../../token/session-budget-checker.
 import { TokenBudgetExhaustedError } from '../../token/token-budget-guard.js';
 import { resolveExecutionContext } from '../../governance/governance-client.js';
 import { resolveSkillInputFromInvokeInput } from '../../registry/skill-io-guard.js';
+import { resolveAgentSystemPromptFromLoader } from '../../registry/graph-loader.js';
 import { toLoadedToolMap } from '../../tool/loaded-tool-definition.js';
 import { toLoadedSkillMap } from '../../tool/system-prompt-builder.js';
 import { assembleLoadedTools } from '../../tool/harness-primitives.js';
@@ -181,6 +182,7 @@ export class InvokeOrchestrator {
             const agentDir = this.graphLoader
                 ? (await this.graphLoader.resolveAgentDir(agentCode, req.agentVersion)) ?? undefined
                 : undefined;
+            const agentSystemPrompt = await resolveAgentSystemPromptFromLoader(this.graphLoader, agentCode, req.agentVersion);
             // 组装 GraphState：有 Checkpoint 历史则只追加本轮 user，避免双重 append
             const history = messageRecordsToGraphMessages(sessionContext.messages);
             const messages = await buildTurnGraphMessages({
@@ -208,6 +210,7 @@ export class InvokeOrchestrator {
                 skillInput,
                 promptRoots,
                 agentDir,
+                agentSystemPrompt,
                 traceId: resolveTraceId(req),
                 traceCollector: this.traceCollector,
             });

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

@@ -28,7 +28,7 @@ import type { TokenStatsService } from '../../token/token-stats.service.js';
 import type { TokenBudgetGuard } from '../../token/token-budget-guard.js';
 import type { SessionBudgetChecker } from '../../token/session-budget-checker.js';
 import type { StreamRequest } from '../routes/agent.routes.js';
-import type { GraphLoader } from '../../registry/graph-loader.js';
+import { type GraphLoader } from '../../registry/graph-loader.js';
 import type { ICheckpointSaver } from '../../checkpoint/contracts/checkpoint-saver.contract.js';
 import type { ITraceCollector } from '../../contracts/trace-collector.js';
 /**

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

@@ -25,7 +25,8 @@ import { TokenBudgetExhaustedError } from '../../token/token-budget-guard.js';
 import { SSEEmitter } from '../../sse/sse-emitter.js';
 import { resolveExecutionContext } from '../../governance/governance-client.js';
 import { resolveSkillInputFromInvokeInput } from '../../registry/skill-io-guard.js';
-import { ErrorCodes } from '@gt-fe/eap-contracts';
+import { ErrorCodes } from '@eap/contracts';
+import { resolveAgentSystemPromptFromLoader } from '../../registry/graph-loader.js';
 import { classifyRuntimeError } from '../../utils/http-error.js';
 import { toLoadedToolMap } from '../../tool/loaded-tool-definition.js';
 import { toLoadedSkillMap } from '../../tool/system-prompt-builder.js';
@@ -203,6 +204,7 @@ export class StreamOrchestrator {
         const agentDir = this.graphLoader
             ? (await this.graphLoader.resolveAgentDir(agentCode, req.agentVersion)) ?? undefined
             : undefined;
+        const agentSystemPrompt = await resolveAgentSystemPromptFromLoader(this.graphLoader, agentCode, req.agentVersion);
         // 组装 GraphState：有 Checkpoint 历史则只追加本轮 user，避免双重 append
         const history = messageRecordsToGraphMessages(sessionContext.messages);
         const messages = await buildTurnGraphMessages({
@@ -236,6 +238,7 @@ export class StreamOrchestrator {
                 skillInput,
                 promptRoots,
                 agentDir,
+                agentSystemPrompt,
                 traceId: resolveTraceId(req),
                 traceCollector: this.traceCollector,
             });

package/dist/api/routes/agent.routes.d.ts

@@ -4,12 +4,12 @@
  * 生产环境由 Hosting 提供对外 HTTP；本模块供 `EAP_DEV_HTTP=1` 本地调试。
  */
 import type { ServerResponse } from 'node:http';
-import type { InvokeRequest as ContractInvokeRequest, InvokeResponse as ContractInvokeResponse } from '@gt-fe/eap-contracts';
+import type { InvokeRequest as ContractInvokeRequest, InvokeResponse as ContractInvokeResponse } from '@eap/contracts';
 import type { ITaskManager } from '../../task/task.service.js';
 import type { SessionService } from '../../session/session.service.js';
 import type { IStateGraphEngine } from '../../graph/contracts/executable-graph.js';
 import type { SSEEmitter } from '../../sse/sse-emitter.js';
-export type { InvokeConfig, InvokeResponseData } from '@gt-fe/eap-contracts';
+export type { InvokeConfig, InvokeResponseData } from '@eap/contracts';
 /**
  * dev HTTP 层 Invoke 请求（扩展 userId，Hosting 从 auth 注入）
  */

package/dist/common/index.d.ts

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

package/dist/common/index.js

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

package/dist/common/logger.d.ts

@@ -1,5 +1,9 @@
 /**
- * 结构化日志接口 — A2
+ * 结构化 stdout JSON 日志。
+ *
+ * EAP_LOG_LEVEL=debug|info|warn|error，默认 info。
+ * info 不写 prompt / messages / systemPrompt；正文在 llm_turns。
+ * 关联字段：correlationId、taskId、sessionId、agentCode。
  */
 export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
 export interface LogEntry {
@@ -7,8 +11,13 @@ export interface LogEntry {
     timestamp: string;
     module: string;
     message: string;
+    correlationId?: string;
+    taskId?: string;
+    sessionId?: string;
+    agentCode?: string;
+    userId?: string;
+    event?: string;
     context?: Record<string, unknown>;
-    error?: Error;
 }
 export interface ILogger {
     debug(message: string, context?: Record<string, unknown>): void;
@@ -16,6 +25,10 @@ export interface ILogger {
     warn(message: string, context?: Record<string, unknown>): void;
     error(message: string, context?: Record<string, unknown>): void;
 }
+export declare function resolveLogLevel(env?: NodeJS.ProcessEnv): LogLevel;
+export declare function shouldLog(level: LogLevel, min?: LogLevel): boolean;
+export declare function formatLogEntry(level: LogLevel, module: string, message: string, context?: Record<string, unknown>): LogEntry;
+export declare function emitRuntimeLog(level: LogLevel, module: string, message: string, context?: Record<string, unknown>): void;
 export declare class ConsoleLogger implements ILogger {
     private readonly module;
     constructor(module: string);
@@ -23,9 +36,8 @@ export declare class ConsoleLogger implements ILogger {
     info(message: string, context?: Record<string, unknown>): void;
     warn(message: string, context?: Record<string, unknown>): void;
     error(message: string, context?: Record<string, unknown>): void;
-    private log;
 }
-/** ponytail: 空实现，测试用 */
+/** 测试用空实现 */
 export declare class NoopLogger implements ILogger {
     debug(): void;
     info(): void;

package/dist/common/logger.js

@@ -1,35 +1,101 @@
 /**
- * 结构化日志接口 — A2
+ * 结构化 stdout JSON 日志。
+ *
+ * EAP_LOG_LEVEL=debug|info|warn|error，默认 info。
+ * info 不写 prompt / messages / systemPrompt；正文在 llm_turns。
+ * 关联字段：correlationId、taskId、sessionId、agentCode。
  */
+const LEVEL_RANK = {
+    debug: 10,
+    info: 20,
+    warn: 30,
+    error: 40,
+};
+const PROMPT_KEYS = new Set([
+    'systemPrompt',
+    'systemSections',
+    'messages',
+    'prompt',
+    'developerPrompt',
+    'agentPrompt',
+    'nodePrompt',
+    'agentSystemPrompt',
+    'apiKey',
+    'content',
+    'body',
+]);
+const ID_KEYS = ['correlationId', 'taskId', 'sessionId', 'agentCode', 'userId'];
+export function resolveLogLevel(env = process.env) {
+    const raw = env.EAP_LOG_LEVEL?.trim().toLowerCase();
+    if (raw === 'debug' || raw === 'info' || raw === 'warn' || raw === 'error')
+        return raw;
+    return 'info';
+}
+export function shouldLog(level, min = resolveLogLevel()) {
+    return LEVEL_RANK[level] >= LEVEL_RANK[min];
+}
+function asId(value) {
+    return typeof value === 'string' && value.trim() ? value : undefined;
+}
+function stripPromptFields(context, level) {
+    if (!context)
+        return undefined;
+    const out = {};
+    for (const [key, value] of Object.entries(context)) {
+        if (key === 'event' || ID_KEYS.includes(key))
+            continue;
+        if (level !== 'debug' && PROMPT_KEYS.has(key))
+            continue;
+        out[key] = value;
+    }
+    return Object.keys(out).length > 0 ? out : undefined;
+}
+export function formatLogEntry(level, module, message, context) {
+    const safe = stripPromptFields(context, level);
+    const event = asId(context?.event) ?? asId(safe?.event);
+    const entry = {
+        level,
+        timestamp: new Date().toISOString(),
+        module,
+        message,
+        correlationId: asId(context?.correlationId),
+        taskId: asId(context?.taskId),
+        sessionId: asId(context?.sessionId),
+        agentCode: asId(context?.agentCode),
+        userId: asId(context?.userId),
+        ...(event ? { event } : {}),
+        ...(safe ? { context: safe } : {}),
+    };
+    return entry;
+}
+export function emitRuntimeLog(level, module, message, context) {
+    if (!shouldLog(level))
+        return;
+    const line = JSON.stringify(formatLogEntry(level, module, message, context));
+    if (level === 'error')
+        console.error(line);
+    else
+        console.log(line);
+}
 export class ConsoleLogger {
     module;
     constructor(module) {
         this.module = module;
     }
     debug(message, context) {
-        this.log('debug', message, context);
+        emitRuntimeLog('debug', this.module, message, context);
     }
     info(message, context) {
-        this.log('info', message, context);
+        emitRuntimeLog('info', this.module, message, context);
     }
     warn(message, context) {
-        this.log('warn', message, context);
+        emitRuntimeLog('warn', this.module, message, context);
     }
     error(message, context) {
-        this.log('error', message, context);
-    }
-    log(level, message, context) {
-        const entry = {
-            level,
-            timestamp: new Date().toISOString(),
-            module: this.module,
-            message,
-            ...(context && { context }),
-        };
-        console[level](JSON.stringify(entry));
+        emitRuntimeLog('error', this.module, message, context);
     }
 }
-/** ponytail: 空实现，测试用 */
+/** 测试用空实现 */
 export class NoopLogger {
     debug() { }
     info() { }

package/dist/common/runtime-package-version.d.ts

@@ -0,0 +1,2 @@
+/** 当前加载的 Runtime 包版本（`package.json`；overlay 为 `@gt-fe/eap-runtime` 的 version） */
+export declare const RUNTIME_PACKAGE_VERSION: string;

package/dist/common/runtime-package-version.js

@@ -0,0 +1,5 @@
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+const pkg = require('../../package.json');
+/** 当前加载的 Runtime 包版本（`package.json`；overlay 为 `@gt-fe/eap-runtime` 的 version） */
+export const RUNTIME_PACKAGE_VERSION = typeof pkg.version === 'string' && pkg.version.trim() ? pkg.version.trim() : 'unknown';

package/dist/common/types.d.ts

@@ -1,8 +1,8 @@
 /**
  * eap-runtime 内部共享类型定义
  *
- * 本文件定义 Runtime 模块内部使用的类型，与 @gt-fe/eap-contracts 中的公共协议类型互补但不重复。
- * - @gt-fe/eap-contracts 定义跨模块的公共协议（如 Task 实体、Session 实体、Agent Manifest）
+ * 本文件定义 Runtime 模块内部使用的类型，与 @eap/contracts 中的公共协议类型互补但不重复。
+ * - @eap/contracts 定义跨模块的公共协议（如 Task 实体、Session 实体、Agent Manifest）
  * - 本文件定义 Runtime 执行引擎内部流转的配置、上下文、枚举等
  */
 /**
@@ -32,7 +32,7 @@ export declare const DEFAULT_RUNTIME_CONFIG: RuntimeConfig;
 /**
  * 执行上下文 — 贯穿 Graph 执行生命周期（Runtime 内部）
  *
- * 平台级 ExecutionContext（@gt-fe/eap-contracts）由 Hosting/eap dev 注入；
+ * 平台级 ExecutionContext（@eap/contracts）由 Hosting/eap dev 注入；
  * 本类型在 Task 创建后组装，供引擎子服务使用。
  */
 export interface RuntimeRunContext {
@@ -62,7 +62,7 @@ export type TaskStatus = 'pending' | 'running' | 'waiting_hitl' | 'success' | 'f
 /**
  * Runtime 执行上下文绑定状态（非平台 Session 生命周期）
  *
- * 平台 Session 三态（active/paused/closed）由 Hosting 管理，见 @gt-fe/eap-contracts。
+ * 平台 Session 三态（active/paused/closed）由 Hosting 管理，见 @eap/contracts。
  * Runtime 仅在引擎内标记执行上下文是否仍可绑定：`active` | `archived`。
  */
 export type ExecutionSessionBindingStatus = 'active' | 'archived';
@@ -77,7 +77,7 @@ export type MessageRole = 'user' | 'assistant' | 'system' | 'tool';
 /**
  * 单次 LLM/Tool 调用的 Token 消耗记录
  *
- * 与 @gt-fe/eap-contracts.TokenUsage 的区别：
+ * 与 @eap/contracts.TokenUsage 的区别：
  * - contracts 版本是 Task 级聚合结果（含 byNode/byModel）
  * - 本类型是单次调用粒度的原始记录，用于 Runtime 内部累计和 stats.node_token 事件
  */

package/dist/common/types.js

@@ -1,8 +1,8 @@
 /**
  * eap-runtime 内部共享类型定义
  *
- * 本文件定义 Runtime 模块内部使用的类型，与 @gt-fe/eap-contracts 中的公共协议类型互补但不重复。
- * - @gt-fe/eap-contracts 定义跨模块的公共协议（如 Task 实体、Session 实体、Agent Manifest）
+ * 本文件定义 Runtime 模块内部使用的类型，与 @eap/contracts 中的公共协议类型互补但不重复。
+ * - @eap/contracts 定义跨模块的公共协议（如 Task 实体、Session 实体、Agent Manifest）
  * - 本文件定义 Runtime 执行引擎内部流转的配置、上下文、枚举等
  */
 /** RuntimeConfig 默认值 */

package/dist/contracts/permission-checker.d.ts

@@ -1,7 +1,7 @@
 /**
  * 权限校验器接口（对齐 06-governance R16.8）
  */
-import type { ExecutionContext, GovernancePermissionCheckParams, GovernancePermissionCheckResult } from '@gt-fe/eap-contracts';
+import type { ExecutionContext, GovernancePermissionCheckParams, GovernancePermissionCheckResult } from '@eap/contracts';
 /**
  * IPermissionChecker — Runtime 执行期权限校验
  */

package/dist/debug/llm-turn-log.d.ts

@@ -41,6 +41,16 @@ export interface LlmTurnRecord extends LlmTurnContext {
         error?: string;
     };
     latencyMs: number;
+    /** 本轮 prompt inputTokens / 模型上下文窗；parts 为字符比例拆分；缺 window 则省略 window */
+    context?: {
+        used: number;
+        window?: number;
+        parts?: {
+            system: number;
+            messages: number;
+            tools: number;
+        };
+    };
 }
 export interface LlmTurnIndexEntry {
     id: string;
@@ -53,6 +63,8 @@ export interface LlmTurnIndexEntry {
     file: string;
     inputTokens: number;
     outputTokens: number;
+    used?: number;
+    window?: number;
 }
 export type LlmTurnLogKind = 'memory' | 'file' | 'postgres';
 export interface ILlmTurnLog {

package/dist/debug/llm-turn-log.js

@@ -21,6 +21,7 @@ export function toLlmTurnIndexEntry(record, file) {
         file: file ?? `${sanitize(record.id)}.json`,
         inputTokens: record.response.inputTokens,
         outputTokens: record.response.outputTokens,
+        ...(record.context ?? {}),
     };
 }
 export function maskApiKey(key) {

package/dist/governance/governance-client.d.ts

@@ -1,7 +1,7 @@
 /**
  * 治理服务 HTTP 客户端（06-governance validateToken / checkPermission）
  */
-import type { ExecutionContext, GovernancePermissionCheckParams, GovernancePermissionCheckResult } from '@gt-fe/eap-contracts';
+import type { ExecutionContext, GovernancePermissionCheckParams, GovernancePermissionCheckResult } from '@eap/contracts';
 export interface HttpGovernanceClientOptions {
     baseUrl: string;
     timeout?: number;

package/dist/governance/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * 权限校验 — 对齐 06-governance R16.8
  */
-export type { CallerType, ExecutionContext, GovernancePermissionCheckParams, GovernancePermissionCheckResult, PermissionAction, PermissionDenyReason, PermissionResourceType, } from '@gt-fe/eap-contracts';
+export type { CallerType, ExecutionContext, GovernancePermissionCheckParams, GovernancePermissionCheckResult, PermissionAction, PermissionDenyReason, PermissionResourceType, } from '@eap/contracts';
 export type { IGovernanceClient } from './governance-client.js';
 export { HttpGovernanceClient, AllowAllGovernanceClient, resolveExecutionContext, } from './governance-client.js';
 export { assertToolPermission, assertSkillPermission, permissionMessage, PermissionDeniedError, GovernanceUnavailableError, } from './permission-guard.js';

package/dist/governance/permission-guard.d.ts

@@ -1,7 +1,7 @@
 /**
  * 执行期 Tool 权限守卫
  */
-import type { ExecutionContext, PermissionDenyReason } from '@gt-fe/eap-contracts';
+import type { ExecutionContext, PermissionDenyReason } from '@eap/contracts';
 import type { IGovernanceClient } from './governance-client.js';
 export declare class GovernanceUnavailableError extends Error {
     readonly reason: PermissionDenyReason;

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

@@ -15,6 +15,8 @@ import { type ILLMProvider } from '../nodes/llm-node.js';
 import type { IToolExecutor } from '../../tool/tool-executor.interface.js';
 import type { IGovernanceClient } from '../../governance/governance-client.js';
 import { type ConditionEvaluatorFn } from '../condition-evaluator.js';
+/** 图未写 `config.maxIterations` 时的 recursionLimit。`agent ⇄ tools` 一圈约 2，50 ≈ 24 次工具往返。 */
+export declare const DEFAULT_GRAPH_RECURSION_LIMIT = 50;
 /**
  * LangGraphAdapter — 基于 @langchain/langgraph 的 IStateGraphEngine 实现
  *
@@ -118,7 +120,7 @@ export declare class LangGraphAdapter implements IStateGraphEngine {
     private createLLMNodeFunction;
     /**
      * 子图节点：优先 config.subgraphDsl；否则按 skillId 从 state.skillDefinitions.workflow 解析。
-     * 技能 prompt 由 SubGraphCompiler 写入 activeSkillPrompt，供入口 LLM 拼接。
+     * 技能正文用短目录 + read_file，不灌 system。
      */
     private createSubGraphNodeFunction;
     /**