@gt-fe/eap-runtime 0.0.12 → 0.0.14

package/dist/registry/preload-errors.d.ts

@@ -1,7 +1,7 @@
 /**
  * 预装加载错误 — 对齐 runtime.preload.* / 联调契约
  */
-import { AppError, type ErrorCode } from '@gt-fe/eap-contracts';
+import { AppError, type ErrorCode } from '@eap/contracts';
 export declare function preloadError(code: ErrorCode, message: string, details?: unknown): AppError;
 export declare function preloadMissing(message: string, details?: unknown): AppError;
 export declare function preloadManifestNotFound(message: string, details?: unknown): AppError;

package/dist/registry/preload-errors.js

@@ -1,7 +1,7 @@
 /**
  * 预装加载错误 — 对齐 runtime.preload.* / 联调契约
  */
-import { AppError, ErrorCodes } from '@gt-fe/eap-contracts';
+import { AppError, ErrorCodes } from '@eap/contracts';
 export function preloadError(code, message, details) {
     return new AppError(code, message, {
         exposeMessage: true,

package/dist/registry/skill-io-guard.js

@@ -1,7 +1,7 @@
 /**
  * Skill inputDef / outputDef 轻量校验（默认开启；EAP_PRELOAD_VALIDATE_SKILL_IO=0 关闭）
  */
-import { AppError, ErrorCodes } from '@gt-fe/eap-contracts';
+import { AppError, ErrorCodes } from '@eap/contracts';
 import { isValidateSkillIo } from './preload-flags.js';
 function asRecord(value) {
     if (value && typeof value === 'object' && !Array.isArray(value)) {

package/dist/registry/skill-tree.js

@@ -10,7 +10,7 @@ import { readdir, stat, access, readFile } from 'node:fs/promises';
 import { watch } from 'node:fs';
 import { constants as fsConstants } from 'node:fs';
 import path from 'node:path';
-import { SKILL_ENTRY_CANDIDATES } from '@gt-fe/eap-contracts';
+import { SKILL_ENTRY_CANDIDATES } from '@eap/contracts';
 const SKILL_CODE = /^[a-z0-9][a-z0-9-]*$/;
 async function exists(p) {
     try {

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

@@ -11,7 +11,7 @@ import type { ICheckpointSaver } from '../checkpoint/contracts/checkpoint-saver.
 import type { ITraceCollector } from '../contracts/trace-collector.js';
 import type { IStateGraphEngine } from '../graph/contracts/state-graph.contract.js';
 import { HitlHandler } from '../graph/hitl/hitl-handler.js';
-import type { GraphLoader } from '../registry/graph-loader.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';
@@ -86,8 +86,8 @@ export declare class AgentRuntime {
      * “Session 历史 + 当前输入”途径。
      *
      * 行为：
-     * - `role` 仅接受 `user` / `assistant`；`system` 应写入 graph.json LLM 节点的
-     *   `config.systemPrompt`（由 SystemPromptBuilder 拼平台规则 + 开发者提示词）；
+     * - `role` 仅接受 `user` / `assistant`；`system` 由 SystemPromptBuilder 拼
+     *   （平台规则 + `prompts.system` 基线 + 节点 `systemPrompt`）；
      *   `tool` 必须与前置 assistant.toolCalls 严格配对，不得单独作为种子。
      * - 幂等语义（exactly-once）：当 session 已存在任何历史消息时，直接返回
      *   `seeded: false`，不重复写入。

package/dist/runtime/agent-runtime.js

@@ -8,11 +8,12 @@
  */
 import { randomUUID } from 'node:crypto';
 import { HITL_TIMEOUT_ERROR_CODE, HITL_TIMEOUT_MESSAGE, HitlAlreadyTimedOutError, HitlNotWaitingError, buildHitlWaitedPayload, isHitlDeadlinePassed, readPersistedHitlWaiting, unwrapHitlPaused, } from '../graph/hitl/hitl-handler.js';
+import { resolveAgentSystemPromptFromLoader } from '../registry/graph-loader.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';
@@ -71,8 +72,8 @@ export class AgentRuntime {
      * “Session 历史 + 当前输入”途径。
      *
      * 行为：
-     * - `role` 仅接受 `user` / `assistant`；`system` 应写入 graph.json LLM 节点的
-     *   `config.systemPrompt`（由 SystemPromptBuilder 拼平台规则 + 开发者提示词）；
+     * - `role` 仅接受 `user` / `assistant`；`system` 由 SystemPromptBuilder 拼
+     *   （平台规则 + `prompts.system` 基线 + 节点 `systemPrompt`）；
      *   `tool` 必须与前置 assistant.toolCalls 严格配对，不得单独作为种子。
      * - 幂等语义（exactly-once）：当 session 已存在任何历史消息时，直接返回
      *   `seeded: false`，不重复写入。
@@ -100,7 +101,7 @@ export class AgentRuntime {
                 throw new AppError(ErrorCodes.PARAMS_INVALID, `seedSessionMessages messages[${index}] must be an object`, { exposeMessage: true });
             }
             if (message.role !== 'user' && message.role !== 'assistant') {
-                throw new AppError(ErrorCodes.PARAMS_INVALID, `seedSessionMessages messages[${index}].role "${String(message.role)}" is not allowed; only 'user' and 'assistant' are accepted (system belongs to config.systemPrompt; tool must pair with prior assistant.toolCalls)`, { exposeMessage: true });
+                throw new AppError(ErrorCodes.PARAMS_INVALID, `seedSessionMessages messages[${index}].role "${String(message.role)}" is not allowed; only 'user' and 'assistant' are accepted (system belongs to SystemPromptBuilder: platform rules + prompts.system + node systemPrompt; tool must pair with prior assistant.toolCalls)`, { exposeMessage: true });
             }
             if (typeof message.content !== 'string' || message.content.length === 0) {
                 throw new AppError(ErrorCodes.PARAMS_INVALID, `seedSessionMessages messages[${index}].content must be a non-empty string`, { exposeMessage: true });
@@ -271,6 +272,7 @@ export class AgentRuntime {
         const agentDir = this.deps.graphLoader
             ? (await this.deps.graphLoader.resolveAgentDir(agentCode, params.agentVersion)) ?? undefined
             : undefined;
+        const agentSystemPrompt = await resolveAgentSystemPromptFromLoader(this.deps.graphLoader, agentCode, params.agentVersion);
         const history = messageRecordsToGraphMessages(sessionContext.messages);
         const messages = await buildTurnGraphMessages({
             history,
@@ -301,6 +303,7 @@ export class AgentRuntime {
                 skillDefinitions,
                 promptRoots,
                 agentDir,
+                agentSystemPrompt,
                 skillInput: resolveSkillInputFromInvokeInput(params.input),
                 traceId: resolveTraceId(params),
                 traceCollector: this.deps.traceCollector,
@@ -490,6 +493,9 @@ export class AgentRuntime {
                 (this.deps.graphLoader
                     ? (await this.deps.graphLoader.resolveAgentDir(agentCode, agentVersion)) ?? undefined
                     : undefined),
+            agentSystemPrompt: (await resolveAgentSystemPromptFromLoader(this.deps.graphLoader, agentCode, agentVersion)) ?? (typeof resumedState.agentSystemPrompt === 'string'
+                ? resumedState.agentSystemPrompt
+                : undefined),
             activatedSkill: resumedState.activatedSkill,
             skillRoute: resumedState.skillRoute ??
                 (typeof resumedState.activatedSkill === 'string' && resumedState.activatedSkill
@@ -652,11 +658,15 @@ export class AgentRuntime {
             (this.deps.graphLoader
                 ? (await this.deps.graphLoader.resolveAgentDir(agentCode, agentVersion)) ?? undefined
                 : undefined);
+        const agentSystemPrompt = (await resolveAgentSystemPromptFromLoader(this.deps.graphLoader, agentCode, agentVersion)) ?? (typeof forkedCheckpoint.state.agentSystemPrompt === 'string'
+            ? forkedCheckpoint.state.agentSystemPrompt
+            : undefined);
         try {
             const result = await this.deps.graphEngine.invoke(graph, {
                 ...forkedCheckpoint.state,
                 agentVersion,
                 agentDir,
+                agentSystemPrompt,
                 userId,
                 delegationToken: overrides.executionContext?.delegationToken,
                 executionContext: overrides.executionContext,

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

@@ -49,6 +49,8 @@ export interface DevRuntime {
     dispose: () => void;
     /** 装配期诊断摘要（CLI 启动时打印，便于排查环境问题） */
     diagnostics: {
+        /** 当前加载的 Runtime 包 version */
+        packageVersion: string;
         deploymentContext: string;
         toolExecutionMode: string;
         llmProviderKind: 'routing' | 'openai-http' | 'echo';

package/dist/runtime/dev-runtime.js

@@ -35,6 +35,7 @@ import { InvokeOrchestrator, StreamOrchestrator, SessionService, MessageService,
 import { createAgentRuntime } from './agent-runtime.js';
 import { assembleRuntimeStorage } from './storage-profile.js';
 import { resolveSkillHotReload, watchPreinstallSkillRoot, watchSkillRoots } from '../registry/skill-tree.js';
+import { RUNTIME_PACKAGE_VERSION } from '../common/runtime-package-version.js';
 /**
  * 装配本地 dev 模式所需的全部 Runtime 依赖
  *
@@ -185,6 +186,7 @@ export function createDevRuntime() {
         graphLoader,
         dispose: stopSkillWatch,
         diagnostics: {
+            packageVersion: RUNTIME_PACKAGE_VERSION,
             deploymentContext,
             toolExecutionMode,
             llmProviderKind,

package/dist/runtime/types.d.ts

@@ -6,7 +6,7 @@
  *
  * @see 04-runtime-core/design.md §1.5
  */
-import type { ExecutionContext, InvokeConfig, ResumeHitlResult } from '@gt-fe/eap-contracts';
+import type { ExecutionContext, InvokeConfig, ResumeHitlResult } from '@eap/contracts';
 import type { InvokeResponseData } from '../api/routes/agent.routes.js';
 import type { GraphMessage } from '../graph/contracts/executable-graph.js';
 import type { SSEEvent } from '../sse/contracts/sse-emitter.contract.js';
@@ -31,7 +31,7 @@ export interface ExecuteParams {
 }
 /** 同步执行结果 */
 export type ExecuteResult = InvokeResponseData;
-/** HITL 恢复结果（与 @gt-fe/eap-contracts ResumeHitlResult 对齐） */
+/** HITL 恢复结果（与 @eap/contracts ResumeHitlResult 对齐） */
 export type { ResumeHitlResult };
 /** HITL 用户响应 */
 export interface HitlResponse {
@@ -91,8 +91,8 @@ export interface ForkResult {
  * 开发者提供的对话上下文（开场白 / few-shot）。
  *
  * 约束（AgentRuntime.seedSessionMessages 强制校验）：
- * - `role` 白名单为 `user` / `assistant`，`system` 走 graph.json 的
- *   `config.systemPrompt`（由 SystemPromptBuilder 拼平台规则），`tool` 必须与
+ * - `role` 白名单为 `user` / `assistant`，`system` 由 SystemPromptBuilder 拼
+ *   （平台规则 + `prompts.system` + 节点 `systemPrompt`），`tool` 必须与
  *   前置 assistant.toolCalls 严格配对，两者禁止作为种子；
  * - 该 session 已有历史时，视作已种入，跳过写入（exactly-once 幂等）。
  */

package/dist/server.js

@@ -7,7 +7,7 @@
  * TODO: Phase 2 将本文件迁移至 dev-tools/cli（作为 `eap dev` 命令实现），
  *       runtime 包不再包含 HTTP 服务代码，仅作为纯库导出。
  */
-import { ErrorCodes } from '@gt-fe/eap-contracts';
+import { ErrorCodes } from '@eap/contracts';
 import { createServer } from 'node:http';
 import { URL } from 'node:url';
 import { resolveExecutionContext } from './governance/index.js';

package/dist/session/compression-middleware.d.ts

@@ -65,11 +65,12 @@ export declare class CompressionMiddleware {
         sessionId: string;
         taskId?: string;
         userId: string;
+        maxContextTokens?: number;
     }): Promise<MessageRecord[]>;
     /**
      * 检查是否需要压缩（不执行）
      */
-    checkCompression(messages: MessageRecord[]): {
+    checkCompression(messages: MessageRecord[], maxContextTokens?: number): {
         needsCompression: boolean;
         currentTokens: number;
         currentRounds: number;

package/dist/session/compression-middleware.js

@@ -65,13 +65,16 @@ export class CompressionMiddleware {
         // 转换为 GraphMessage 格式进行检查
         const graphMessages = this.toGraphMessages(messages);
         // 检查是否需要压缩
-        const checkResult = this.compression.checkCompression(graphMessages);
+        const windowOverride = context.maxContextTokens
+            ? { maxContextTokens: context.maxContextTokens }
+            : undefined;
+        const checkResult = this.compression.checkCompression(graphMessages, windowOverride);
         if (!checkResult.needsCompression) {
             return messages;
         }
         // 执行压缩
         const startTime = Date.now();
-        const compressedMessages = await this.compression.compress(graphMessages);
+        const compressedMessages = await this.compression.compress(graphMessages, windowOverride);
         const duration = Date.now() - startTime;
         // 转换回 MessageRecord 格式
         const compressedRecords = this.toMessageRecords(compressedMessages, messages);
@@ -106,9 +109,9 @@ export class CompressionMiddleware {
     /**
      * 检查是否需要压缩（不执行）
      */
-    checkCompression(messages) {
+    checkCompression(messages, maxContextTokens) {
         const graphMessages = this.toGraphMessages(messages);
-        return this.compression.checkCompression(graphMessages);
+        return this.compression.checkCompression(graphMessages, maxContextTokens ? { maxContextTokens } : undefined);
     }
     /**
      * 获取配置

package/dist/sse/events/skill-events.d.ts

@@ -6,7 +6,7 @@
  * - skill.started / skill.completed / skill.failed（子图执行生命周期）
  *
  * @see design.md §1.6 SSE事件协议定义
- * @see @gt-fe/eap-contracts OPTIONAL_SSE_EVENTS
+ * @see @eap/contracts OPTIONAL_SSE_EVENTS
  */
 /** 技能匹配成功 */
 export interface SkillMatchedPayload {

package/dist/sse/events/skill-events.js

@@ -6,6 +6,6 @@
  * - skill.started / skill.completed / skill.failed（子图执行生命周期）
  *
  * @see design.md §1.6 SSE事件协议定义
- * @see @gt-fe/eap-contracts OPTIONAL_SSE_EVENTS
+ * @see @eap/contracts OPTIONAL_SSE_EVENTS
  */
 export {};

package/dist/sse/events/stats-events.d.ts

@@ -41,4 +41,13 @@ export interface StatsNodeTokenUsagePayload {
     costEstimate: number;
     /** 该节点本次调用耗时（毫秒），可选 */
     durationMs?: number;
+    /** 本轮 prompt 占用的上下文窗 used/window；缺 window 则省略 */
+    used?: number;
+    window?: number;
+    /** 按字符比例把 used 拆到 system/messages/tools；合计 = used */
+    parts?: {
+        system: number;
+        messages: number;
+        tools: number;
+    };
 }

package/dist/token/compression-budget-integration.d.ts

@@ -18,7 +18,7 @@ import type { IMessageRepository } from '../session/session.service.js';
 export interface CompressionBudgetConfig {
     /** 模型 context window 大小 */
     modelContextWindow: number;
-    /** 历史消息占比阈值（超过此比例触发压缩，默认 0.8） */
+    /** 相对模型窗口的触发系数（默认 0.7，与滑动窗口同一公式） */
     historyThreshold?: number;
     /** 压缩后目标占比（默认 0.5） */
     targetRatio?: number;

package/dist/token/compression-budget-integration.js

@@ -9,7 +9,7 @@
  */
 import { createContextBudget } from './context-window-budget.js';
 import { CompressionMiddleware, createCompressionMiddlewareWithLLM, } from '../session/compression-middleware.js';
-import { estimateMessagesTokens } from '../memory/message-compression.service.js';
+import { estimateMessagesTokens, resolveCompressionMaxTokens, } from '../memory/message-compression.service.js';
 // ─────────────────────────────────────────────
 // CompressionBudgetIntegration
 // ─────────────────────────────────────────────
@@ -28,7 +28,7 @@ export class CompressionBudgetIntegration {
     constructor(config, repository, messageRepository) {
         this.config = {
             modelContextWindow: config.modelContextWindow,
-            historyThreshold: config.historyThreshold ?? 0.8,
+            historyThreshold: config.historyThreshold ?? 0.7,
             targetRatio: config.targetRatio ?? 0.5,
             autoCompress: config.autoCompress ?? true,
             llmConfig: config.llmConfig,
@@ -36,13 +36,17 @@ export class CompressionBudgetIntegration {
         // 创建预算管理器
         this.budget = createContextBudget(this.config.modelContextWindow);
         // 创建压缩中间件
+        const compressionConfig = {
+            maxContextTokens: this.config.modelContextWindow,
+        };
         if (this.config.llmConfig?.provider) {
             this.compression = createCompressionMiddlewareWithLLM(this.config.llmConfig.provider, {
                 llmConfig: this.config.llmConfig,
+                compressionConfig,
             }, repository, messageRepository);
         }
         else {
-            this.compression = new CompressionMiddleware({}, undefined, repository, messageRepository);
+            this.compression = new CompressionMiddleware({ compressionConfig }, undefined, repository, messageRepository);
         }
     }
     /**
@@ -55,12 +59,13 @@ export class CompressionBudgetIntegration {
         // 估算当前 Token 数
         const graphMessages = this.toGraphMessages(messages);
         const currentTokens = estimateMessagesTokens(graphMessages);
-        // 获取历史消息的 Token 上限
-        const maxTokens = this.budget.getMaxTokens('history');
-        // 计算使用率
-        const usageRatio = maxTokens > 0 ? currentTokens / maxTokens : 0;
-        // 检查是否超过阈值
-        const needsCompression = usageRatio > this.config.historyThreshold;
+        // 与滑动窗口同一阈值：window × 系数（默认 0.7）；historyThreshold 作为系数覆盖
+        const maxTokens = resolveCompressionMaxTokens(this.config.modelContextWindow, this.config.historyThreshold);
+        // 计算使用率（相对窗口，不是相对阈值）
+        const usageRatio = this.config.modelContextWindow > 0
+            ? currentTokens / this.config.modelContextWindow
+            : 0;
+        const needsCompression = currentTokens > maxTokens;
         // 计算压缩目标
         const targetTokens = needsCompression
             ? Math.floor(maxTokens * this.config.targetRatio)
@@ -96,7 +101,10 @@ export class CompressionBudgetIntegration {
         }
         // 执行压缩
         const startTime = Date.now();
-        const compressedMessages = await this.compression.processMessages(messages, context);
+        const compressedMessages = await this.compression.processMessages(messages, {
+            ...context,
+            maxContextTokens: this.config.modelContextWindow,
+        });
         const duration = Date.now() - startTime;
         // 计算压缩后的 Token 数
         const compressedGraphMessages = this.toGraphMessages(compressedMessages);

package/dist/token/context-window.d.ts

@@ -0,0 +1,42 @@
+/**
+ * 本轮 prompt 占用的上下文窗：used = 本轮 inputTokens，window = ModelRecord.capabilities.maxContextTokens。
+ * 不是账单合计，也不是 max_tokens。
+ * parts 按本轮 system / messages / tools 字符比例把 used 拆开（无独立 tokenizer）。
+ */
+export interface ContextUsageParts {
+    system: number;
+    messages: number;
+    tools: number;
+}
+export interface ContextWindowUsage {
+    used: number;
+    window?: number;
+    parts?: ContextUsageParts;
+}
+export declare function contextWindowUsage(used: number, window: number | undefined): ContextWindowUsage | undefined;
+export declare function splitContextUsage(used: number, sections: {
+    systemChars: number;
+    messageChars: number;
+    toolChars: number;
+}): ContextUsageParts | undefined;
+export declare function turnSectionChars(config: {
+    systemPrompt?: string;
+    tools?: unknown[];
+}, messages: Array<{
+    content?: string;
+    toolCalls?: unknown;
+}>): {
+    systemChars: number;
+    messageChars: number;
+    toolChars: number;
+};
+export declare function buildContextUsage(used: number, window: number | undefined, sections?: {
+    systemChars: number;
+    messageChars: number;
+    toolChars: number;
+}): ContextWindowUsage | undefined;
+export declare function pickContextFields(raw: {
+    used?: unknown;
+    window?: unknown;
+    parts?: unknown;
+}): Partial<ContextWindowUsage>;

package/dist/token/context-window.js

@@ -0,0 +1,73 @@
+/**
+ * 本轮 prompt 占用的上下文窗：used = 本轮 inputTokens，window = ModelRecord.capabilities.maxContextTokens。
+ * 不是账单合计，也不是 max_tokens。
+ * parts 按本轮 system / messages / tools 字符比例把 used 拆开（无独立 tokenizer）。
+ */
+export function contextWindowUsage(used, window) {
+    return buildContextUsage(used, window);
+}
+export function splitContextUsage(used, sections) {
+    if (!(used > 0))
+        return undefined;
+    const systemChars = Math.max(0, sections.systemChars);
+    const messageChars = Math.max(0, sections.messageChars);
+    const toolChars = Math.max(0, sections.toolChars);
+    const total = systemChars + messageChars + toolChars;
+    if (total <= 0)
+        return undefined;
+    const system = Math.floor((used * systemChars) / total);
+    const tools = Math.floor((used * toolChars) / total);
+    const messages = used - system - tools;
+    return { system, messages, tools };
+}
+export function turnSectionChars(config, messages) {
+    const systemChars = (config.systemPrompt ?? '').length;
+    let messageChars = 0;
+    for (const message of messages) {
+        if (message.content)
+            messageChars += message.content.length;
+        if (message.toolCalls)
+            messageChars += jsonChars(message.toolCalls);
+    }
+    const toolChars = config.tools?.length ? jsonChars(config.tools) : 0;
+    return { systemChars, messageChars, toolChars };
+}
+export function buildContextUsage(used, window, sections) {
+    const safeUsed = typeof used === 'number' && Number.isFinite(used) && used >= 0 ? Math.floor(used) : 0;
+    const win = typeof window === 'number' && Number.isFinite(window) && window > 0
+        ? Math.floor(window)
+        : undefined;
+    const parts = sections ? splitContextUsage(safeUsed, sections) : undefined;
+    if (safeUsed === 0 && win == null && !parts)
+        return undefined;
+    return {
+        used: safeUsed,
+        ...(win != null ? { window: win } : {}),
+        ...(parts ? { parts } : {}),
+    };
+}
+export function pickContextFields(raw) {
+    const out = {};
+    if (typeof raw.used === 'number' && Number.isFinite(raw.used))
+        out.used = raw.used;
+    if (typeof raw.window === 'number' && Number.isFinite(raw.window) && raw.window > 0) {
+        out.window = raw.window;
+    }
+    if (raw.parts && typeof raw.parts === 'object' && !Array.isArray(raw.parts)) {
+        const p = raw.parts;
+        if (typeof p.system === 'number'
+            && typeof p.messages === 'number'
+            && typeof p.tools === 'number') {
+            out.parts = { system: p.system, messages: p.messages, tools: p.tools };
+        }
+    }
+    return out;
+}
+function jsonChars(value) {
+    try {
+        return JSON.stringify(value).length;
+    }
+    catch {
+        return 0;
+    }
+}

package/dist/token/index.d.ts

@@ -7,6 +7,7 @@ export { SessionBudgetChecker, SessionBudgetExhaustedError, } from './session-bu
 export type { NodeTokenUsage, TokenBreakdown, TaskTokenSummary, } from './token-stats.service.js';
 export { TokenStatsService } from './token-stats.service.js';
 export type { TokenDetailMode } from './token-detail-mode.js';
+export { contextWindowUsage, buildContextUsage, splitContextUsage, turnSectionChars, pickContextFields, type ContextWindowUsage, type ContextUsageParts, } from './context-window.js';
 export { TokenStatsEmitter } from './token-detail-mode.js';
 export { ContextWindowBudget, createContextBudget, type ContextWindowBudgetConfig, type ContextSource, type SourceAllocation, type BudgetAllocation, DEFAULT_CONTEXT_BUDGET_CONFIG, } from './context-window-budget.js';
 export { CharBasedTokenEstimator, ModelBasedTokenEstimator, createTokenEstimator, type ITokenEstimator, } from './token-estimator.js';

package/dist/token/index.js

@@ -3,6 +3,7 @@ export { PostgresTokenBudgetRepository } from './pg-token-budget.repository.js';
 export { TokenBudgetGuard, TokenBudgetExhaustedError, } from './token-budget-guard.js';
 export { SessionBudgetChecker, SessionBudgetExhaustedError, } from './session-budget-checker.js';
 export { TokenStatsService } from './token-stats.service.js';
+export { contextWindowUsage, buildContextUsage, splitContextUsage, turnSectionChars, pickContextFields, } from './context-window.js';
 export { TokenStatsEmitter } from './token-detail-mode.js';
 // 上下文窗口预算分配
 export { ContextWindowBudget, createContextBudget, DEFAULT_CONTEXT_BUDGET_CONFIG, } from './context-window-budget.js';

package/dist/tool/create-tool-executor.d.ts

@@ -5,7 +5,7 @@
  * `EAP_TOOL_GATEWAY_TRANSPORT=http` 时用 HttpToolExecutor（仅调试）。
  * desktop 经 ToolExecutionRouter 分流 Local / Gateway。
  */
-import type { ILocalToolInstallStore, LocalToolInstallRecord } from '@gt-fe/eap-contracts';
+import type { ILocalToolInstallStore, LocalToolInstallRecord } from '@eap/contracts';
 import { type DeploymentContext } from './tool-execution-router.js';
 import type { IToolExecutor } from './tool-executor.interface.js';
 export declare class EmptyInstallStore implements ILocalToolInstallStore {

package/dist/tool/dev-http-executor.d.ts

@@ -1,6 +1,6 @@
 /**
  * Dev 下按 type:http 清单直连出站（gateway.baseUrl + pathTemplate）。
- * URL 拼接与 host 白名单与 Tool Gateway 共用 @gt-fe/eap-contracts http-outbound。
+ * URL 拼接与 host 白名单与 Tool Gateway 共用 @eap/contracts http-outbound。
  */
 import type { IToolExecutor, ToolCallRequest, ToolCallResult } from './tool-executor.interface.js';
 export interface DevHttpExecution {
@@ -9,6 +9,7 @@ export interface DevHttpExecution {
     baseUrl?: string;
     pathTemplate?: string;
     allowedHosts?: string[];
+    header?: Record<string, string>;
     timeout?: number;
 }
 export declare function resolveHttpExecutionFromRequest(request: ToolCallRequest): DevHttpExecution | null;

package/dist/tool/dev-http-executor.js

@@ -1,8 +1,8 @@
 /**
  * Dev 下按 type:http 清单直连出站（gateway.baseUrl + pathTemplate）。
- * URL 拼接与 host 白名单与 Tool Gateway 共用 @gt-fe/eap-contracts http-outbound。
+ * URL 拼接与 host 白名单与 Tool Gateway 共用 @eap/contracts http-outbound。
  */
-import { assertHttpHostAllowlisted, buildHttpToolUrl as buildSharedHttpToolUrl, ErrorCodes } from '@gt-fe/eap-contracts';
+import { assertHttpHostAllowlisted, buildHttpToolUrl as buildSharedHttpToolUrl, ErrorCodes } from '@eap/contracts';
 import { abortOrTimeoutMessage, DEFAULT_HTTP_TOOL_TIMEOUT_SEC, isAbortError, resolveToolTimeoutSec, toToolTimeoutMs, } from './timeout.js';
 export function resolveHttpExecutionFromRequest(request) {
     const raw = request.execution;
@@ -23,9 +23,20 @@ export function resolveHttpExecutionFromRequest(request) {
         allowedHosts: Array.isArray(e.allowedHosts)
             ? e.allowedHosts.filter((item) => typeof item === 'string')
             : [],
+        header: readHeaderMap(e.header),
         timeout: resolveToolTimeoutSec(e.timeout, DEFAULT_HTTP_TOOL_TIMEOUT_SEC),
     };
 }
+function readHeaderMap(raw) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw))
+        return undefined;
+    const out = {};
+    for (const [key, value] of Object.entries(raw)) {
+        if (typeof value === 'string')
+            out[key] = value;
+    }
+    return Object.keys(out).length > 0 ? out : undefined;
+}
 export function buildHttpToolUrl(spec, args) {
     const url = buildSharedHttpToolUrl(spec.baseUrl ?? '', spec.pathTemplate ?? '', args);
     assertHttpHostAllowlisted(url, spec.allowedHosts ?? []);
@@ -54,6 +65,7 @@ export class DevHttpExecutor {
             const timer = setTimeout(() => controller.abort(), toToolTimeoutMs(timeoutSec, DEFAULT_HTTP_TOOL_TIMEOUT_SEC));
             const headers = {
                 Accept: 'application/json, text/plain;q=0.9',
+                ...(spec.header ?? {}),
             };
             const init = { method, headers, signal: controller.signal };
             if (method !== 'GET' && method !== 'HEAD') {

package/dist/tool/dev-mcp-executor.d.ts

@@ -17,13 +17,23 @@
  * @see docs/workflows/local-agent-dev-loop.md
  * @see runtime/src/tool/local-mcp-client.ts
  */
+import { type McpRuntimeExecution } from '@eap/contracts';
 import { type ILocalMcpClient } from './local-mcp-client.js';
-import type { IToolExecutor, ToolCallRequest, ToolCallResult } from './tool-executor.interface.js';
+import type { IToolExecutor, McpListedTool, ToolCallRequest, ToolCallResult } from './tool-executor.interface.js';
 export interface DevMcpExecutorOptions {
     client?: ILocalMcpClient;
 }
 export declare class DevMcpExecutor implements IToolExecutor {
     private readonly client;
+    private readonly listCache;
     constructor(options?: DevMcpExecutorOptions);
     execute(request: ToolCallRequest): Promise<ToolCallResult>;
+    listTools(request: ToolCallRequest): Promise<McpListedTool[]>;
 }
+/**
+ * 把 tool.manifest.execution（McpExecution 结构，transport 可为 stdio/sse/streamable_http）
+ * 规范化为 LocalMcpClient 消费的 McpRuntimeExecution（transport 只支持 stdio/streamable_http）。
+ *
+ * sse 归并到 streamable_http（LocalMcpClient 的 http 分支已能解析 SSE 响应）。
+ */
+export declare function normalizeMcpExecution(raw: unknown, fallbackToolName: string): McpRuntimeExecution | null;

package/dist/tool/dev-mcp-executor.js

@@ -17,11 +17,12 @@
  * @see docs/workflows/local-agent-dev-loop.md
  * @see runtime/src/tool/local-mcp-client.ts
  */
-import { ErrorCodes } from '@gt-fe/eap-contracts';
+import { ErrorCodes } from '@eap/contracts';
 import { isAbortError } from './timeout.js';
 import { LocalMcpClient } from './local-mcp-client.js';
 export class DevMcpExecutor {
     client;
+    listCache = new Map();
     constructor(options = {}) {
         this.client = options.client ?? new LocalMcpClient();
     }
@@ -64,6 +65,28 @@ export class DevMcpExecutor {
             };
         }
     }
+    async listTools(request) {
+        const execution = normalizeExecution(request.execution, request.toolName);
+        if (!execution) {
+            throw new Error(`Dev MCP: tool "${request.toolName}" has no valid mcp execution config (expect manifest.execution.protocol="mcp")`);
+        }
+        const url = execution.server?.url ?? '';
+        const cmd = execution.server?.command ?? '';
+        const args = (execution.server?.args ?? []).join('\0');
+        const key = `${url || `stdio:${cmd}:${args}`}\0${request.authContext?.userId ?? ''}\0${request.authContext?.agentCode ?? ''}`;
+        const cached = this.listCache.get(key);
+        if (cached)
+            return cached;
+        const pending = this.client.list(execution, { userId: request.authContext?.userId });
+        this.listCache.set(key, pending);
+        try {
+            return await pending;
+        }
+        catch (err) {
+            this.listCache.delete(key);
+            throw err;
+        }
+    }
 }
 /**
  * 把 tool.manifest.execution（McpExecution 结构，transport 可为 stdio/sse/streamable_http）
@@ -71,6 +94,9 @@ export class DevMcpExecutor {
  *
  * sse 归并到 streamable_http（LocalMcpClient 的 http 分支已能解析 SSE 响应）。
  */
+export function normalizeMcpExecution(raw, fallbackToolName) {
+    return normalizeExecution(raw, fallbackToolName);
+}
 function normalizeExecution(raw, fallbackToolName) {
     if (!raw || typeof raw !== 'object')
         return null;