@gt-fe/eap-runtime 0.0.13 → 0.0.15

package/dist/graph/nodes/llm-node.js

@@ -10,6 +10,8 @@
  * @see requirements.md Requirement 1 AC6, Requirement 9
  */
 import { formatUnknownError } from '../../utils/format-error.js';
+import { buildContextUsage, turnSectionChars } from '../../token/context-window.js';
+import { isAbortError } from '../../tool/timeout.js';
 // ─────────────────────────────────────────────
 // Default retry config
 // ─────────────────────────────────────────────
@@ -94,6 +96,7 @@ export class LLMNode {
         // （即 user 消息重复的根因）。
         //
         // __llmTokenUsage channel 同样是 **数组累加器 reducer**，每次追加一条使用明细。
+        const context = buildContextUsage(response.inputTokens, this.config.maxContextTokens, turnSectionChars(this.config, messages));
         return {
             messages: [assistantMessage],
             currentNode: this.nodeId,
@@ -104,6 +107,7 @@ export class LLMNode {
                     inputTokens: response.inputTokens,
                     outputTokens: response.outputTokens,
                     durationMs,
+                    ...(context ?? {}),
                 },
             ],
         };
@@ -183,6 +187,7 @@ export class LLMNode {
      *
      * 根据 streaming 配置选择 invoke 或 stream 模式。
      * 失败时按 backoff 策略重试，最多重试 maxRetries 次。
+     * AbortError / 「This operation was aborted」（含 LLM HTTP 超时包装）立即失败，不重试。
      */
     async invokeWithRetry(messages) {
         let lastError;
@@ -195,6 +200,9 @@ export class LLMNode {
             }
             catch (error) {
                 lastError = error instanceof Error ? error : new Error(formatUnknownError(error));
+                if (isAbortError(error) || isAbortError(lastError)) {
+                    throw lastError;
+                }
                 // 最后一次尝试不需要等待
                 if (attempt < this.retryConfig.maxRetries) {
                     const delay = this.calculateBackoffDelay(attempt);

package/dist/graph/nodes/skill-bind-node.d.ts

@@ -1,6 +1,6 @@
 /**
- * 可选图胶水：把 silent LLM 的结构化输出写成 activeSkillPrompt / skillRoute。
- * 不是 Graph 节点类型。任何「多本手册互斥」的域图都可选用；字段是约定不是契约。
+ * 可选图胶水：把 silent LLM 的结构化输出写成 skillRoute / activatedSkill。
+ * 不是 Graph 节点类型。技能正文走短目录 + read_file，不灌 system。
  */
 import type { LoadedSkillInfo, LoadedSkillMap } from '../../tool/system-prompt-builder.js';
 export type SkillRoute = 'skill' | 'clarify' | 'none';
@@ -9,7 +9,6 @@ export interface SkillBindPatch {
     activatedSkill: string | null;
     /** 展示名；未选中时为空 */
     skillName?: string;
-    activeSkillPrompt?: string;
     skillInput?: Record<string, unknown>;
     messages: Array<Record<string, unknown>>;
     /** 用户写了 skill 名但清单里没有，才算 unmatched */
@@ -25,7 +24,7 @@ interface SkillSelectPayload {
 export declare function extractJsonObject(text: string): SkillSelectPayload | null;
 export declare function resolveSkillDefinition(defs: LoadedSkillMap | undefined, rawName: string): LoadedSkillInfo | undefined;
 /**
- * 消费选择节点刚写出的 assistant JSON，改写为路由 + Skill 提示词。
+ * 消费选择节点刚写出的 assistant JSON，改写为路由。
  * 返回的 messages 是**整段替换**（调用方须覆盖 messages channel 时改用 replace 语义）。
  */
 export declare function bindSelectedSkill(state: Record<string, unknown>): SkillBindPatch;

package/dist/graph/nodes/skill-bind-node.js

@@ -38,26 +38,8 @@ export function resolveSkillDefinition(defs, rawName) {
             (skill.name && skill.name.toLowerCase() === needle));
     });
 }
-function formatParams(params) {
-    return Object.entries(params)
-        .map(([key, value]) => `- ${key}: ${JSON.stringify(value)}`)
-        .join('\n');
-}
-function buildSkillPrompt(skill, params) {
-    const parts = [`# 技能：${skill.name || skill.skillId}`];
-    if (skill.description) {
-        parts.push(skill.description);
-    }
-    if (params && Object.keys(params).length > 0) {
-        parts.push(`# 提取的参数\n${formatParams(params)}`);
-    }
-    if (skill.prompt?.trim()) {
-        parts.push(skill.prompt.trim());
-    }
-    return parts.join('\n\n');
-}
 /**
- * 消费选择节点刚写出的 assistant JSON，改写为路由 + Skill 提示词。
+ * 消费选择节点刚写出的 assistant JSON，改写为路由。
  * 返回的 messages 是**整段替换**（调用方须覆盖 messages channel 时改用 replace 语义）。
  */
 export function bindSelectedSkill(state) {
@@ -108,7 +90,6 @@ export function bindSelectedSkill(state) {
         skillRoute: 'skill',
         activatedSkill: skill.skillId,
         skillName: skill.name || skill.skillId,
-        activeSkillPrompt: buildSkillPrompt(skill, params),
         skillInput: params,
         messages: nextMessages(),
     };

package/dist/graph/nodes/tool-node.d.ts

@@ -33,6 +33,8 @@ type LangGraphState = Record<string, unknown>;
 export interface ToolNodeProgress {
     toolCallId: string;
     toolName: string;
+    /** 工具集编码；与 toolName 一起给 UI 显示 `toolset/toolName` */
+    toolset?: string;
     status: 'started' | 'completed' | 'error';
     arguments?: Record<string, unknown>;
     content?: string;

package/dist/graph/nodes/tool-node.js

@@ -10,29 +10,18 @@
  * @see requirements.md Requirement 8 AC1, AC3, AC5
  */
 import { resolveJailFromState } from '../../tool/harness-primitives.js';
+import { inferHarnessSkillDir } from '../../tool/skill-dir-infer.js';
 import { isHitlDecision, unwrapHitlPaused } from '../hitl/hitl-handler.js';
 import { ToolConfirmationInterceptor } from '../../tool/tool-confirmation.js';
 import { resolveCheckpointThreadId } from '../../session/persist-turn-messages.js';
 import { resolveTraceId } from '../../common/trace-id.js';
+import { toolsetCodeFromLoaded } from '../../tool/mcp-list.js';
 function skillDirsFromState(state) {
     const defs = state['skillDefinitions'];
     return Object.values(defs ?? {})
         .filter((skill) => Boolean(skill.bundlePath))
         .map((skill) => ({ skillId: skill.skillId, bundlePath: skill.bundlePath }));
 }
-function resolveActiveSkillDir(state) {
-    const defs = state['skillDefinitions'];
-    if (!defs)
-        return undefined;
-    const activated = state['activatedSkill'];
-    if (typeof activated === 'string' && defs[activated]?.bundlePath) {
-        return defs[activated].bundlePath;
-    }
-    const paths = Object.values(defs)
-        .map((skill) => skill.bundlePath)
-        .filter((p) => Boolean(p));
-    return paths.length === 1 ? paths[0] : undefined;
-}
 export class ToolNode {
     orchestrator;
     injector;
@@ -75,12 +64,24 @@ export class ToolNode {
             skillDefinitions: state['skillDefinitions'],
         });
         const jailExtraRoots = jail.extraRoots ?? [];
-        const skillDir = resolveActiveSkillDir(state);
+        const batchCalls = lastAssistantMessage.toolCalls.map((tc) => ({
+            name: tc.name,
+            arguments: tc.arguments,
+        }));
+        const boundSkill = typeof state['activatedSkill'] === 'string' ? state['activatedSkill'] : undefined;
         // 4. 转换为 ToolCallRequest[]（附带 manifest 路由字段）
         const requests = lastAssistantMessage.toolCalls.map((tc) => {
             const loaded = loadedTools?.[tc.name];
             const correlationId = String(state['correlationId'] ?? tc.id);
             const taskId = String(state['taskId'] ?? state['correlationId'] ?? tc.id);
+            const command = typeof tc.arguments?.command === 'string' ? tc.arguments.command : undefined;
+            const skillDir = inferHarnessSkillDir({
+                command,
+                toolCalls: batchCalls,
+                messages,
+                skillDirs,
+                activatedSkill: boundSkill,
+            });
             return {
                 toolCallId: tc.id,
                 toolName: tc.name,
@@ -153,11 +154,13 @@ export class ToolNode {
         const needsHitl = Boolean(this.hitlHandler) &&
             requests.some((req) => confirmationTools.has(req.toolName));
         const runOne = async (req, i) => {
+            const toolset = toolsetCodeFromLoaded(loadedTools?.[req.toolName]);
             const resumingHitl = isHitlDecision(state['hitlChoice']);
             if (!resumingHitl) {
                 emitProgress({
                     toolCallId: req.toolCallId,
                     toolName: req.toolName,
+                    ...(toolset ? { toolset } : {}),
                     status: 'started',
                     arguments: req.arguments,
                 });
@@ -197,6 +200,7 @@ export class ToolNode {
                     emitProgress({
                         toolCallId: result.toolCallId,
                         toolName: result.toolName,
+                        ...(toolset ? { toolset } : {}),
                         status: 'completed',
                         arguments: req.arguments,
                         content: result.content,
@@ -207,6 +211,7 @@ export class ToolNode {
                     emitProgress({
                         toolCallId: result.toolCallId,
                         toolName: result.toolName,
+                        ...(toolset ? { toolset } : {}),
                         status: 'error',
                         arguments: req.arguments,
                         error: result.error ?? 'unknown error',
@@ -243,6 +248,7 @@ export class ToolNode {
                 emitProgress({
                     toolCallId: req.toolCallId,
                     toolName: req.toolName,
+                    ...(toolset ? { toolset } : {}),
                     status: 'error',
                     arguments: req.arguments,
                     error: message,

package/dist/memory/compression/index.d.ts

@@ -3,7 +3,7 @@
  *
  * 提供多种压缩策略用于处理长对话历史。
  */
-export { type CompressionConfig, type CompressionResult, type CompressionRecord, type CompressionStrategy, type CompressionReason, type IMessageCompressionService, DEFAULT_COMPRESSION_CONFIG, estimateTokenCount, estimateMessagesTokens, countRounds, } from '../message-compression.service.js';
+export { type CompressionConfig, type CompressionResult, type CompressionRecord, type CompressionStrategy, type CompressionReason, type IMessageCompressionService, DEFAULT_COMPRESSION_CONFIG, COMPRESSION_WINDOW_FACTOR, COMPRESSION_MAX_TOKENS_FALLBACK, resolveCompressionMaxTokens, mergeCompressionConfig, estimateTokenCount, estimateMessagesTokens, countRounds, } from '../message-compression.service.js';
 export { SlidingWindowCompression, TruncateCompression, type SummarizeFunction, } from './sliding-window.compression.js';
 export { createLLMSummarize, createSimpleSummarize, type LLMCallFunction, } from './llm-summarize.js';
 export { PostgresCompressionRepository, InMemoryCompressionRepository, type ICompressionRepository, } from './compression.repository.js';

package/dist/memory/compression/index.js

@@ -4,7 +4,7 @@
  * 提供多种压缩策略用于处理长对话历史。
  */
 // 压缩接口和工具函数
-export { DEFAULT_COMPRESSION_CONFIG, estimateTokenCount, estimateMessagesTokens, countRounds, } from '../message-compression.service.js';
+export { DEFAULT_COMPRESSION_CONFIG, COMPRESSION_WINDOW_FACTOR, COMPRESSION_MAX_TOKENS_FALLBACK, resolveCompressionMaxTokens, mergeCompressionConfig, estimateTokenCount, estimateMessagesTokens, countRounds, } from '../message-compression.service.js';
 // 滑动窗口压缩策略
 export { SlidingWindowCompression, TruncateCompression, } from './sliding-window.compression.js';
 // LLM 摘要函数

package/dist/memory/compression/sliding-window.compression.js

@@ -9,7 +9,7 @@
  * @see message-compression.service.ts 压缩接口定义
  * @see requirements.md Requirement 4.3
  */
-import { DEFAULT_COMPRESSION_CONFIG, estimateMessagesTokens, countRounds, } from '../message-compression.service.js';
+import { DEFAULT_COMPRESSION_CONFIG, estimateMessagesTokens, countRounds, mergeCompressionConfig, } from '../message-compression.service.js';
 /**
  * 默认摘要函数（占位）
  *
@@ -30,14 +30,14 @@ export class SlidingWindowCompression {
     config;
     summarize;
     constructor(config, summarize) {
-        this.config = { ...DEFAULT_COMPRESSION_CONFIG, ...config };
+        this.config = mergeCompressionConfig(DEFAULT_COMPRESSION_CONFIG, config);
         this.summarize = summarize ?? defaultSummarize;
     }
     /**
      * 检查是否需要压缩
      */
     checkCompression(messages, config) {
-        const mergedConfig = { ...this.config, ...config };
+        const mergedConfig = mergeCompressionConfig(this.config, config);
         const currentTokens = this.estimateTokens(messages);
         const currentRounds = countRounds(messages);
         // 检查 Token 数是否超限
@@ -73,7 +73,7 @@ export class SlidingWindowCompression {
      * 3. 用摘要 + 最近 N 轮替换原始消息
      */
     async compress(messages, config) {
-        const mergedConfig = { ...this.config, ...config };
+        const mergedConfig = mergeCompressionConfig(this.config, config);
         // 1. 找到最近 N 轮的起始位置
         const splitIndex = this.findSplitIndex(messages, mergedConfig.preserveRecentRounds);
         // 如果消息太少，不需要压缩
@@ -134,10 +134,10 @@ export class SlidingWindowCompression {
 export class TruncateCompression {
     config;
     constructor(config) {
-        this.config = { ...DEFAULT_COMPRESSION_CONFIG, ...config };
+        this.config = mergeCompressionConfig(DEFAULT_COMPRESSION_CONFIG, config);
     }
     checkCompression(messages, config) {
-        const mergedConfig = { ...this.config, ...config };
+        const mergedConfig = mergeCompressionConfig(this.config, config);
         const currentTokens = this.estimateTokens(messages);
         const currentRounds = countRounds(messages);
         if (currentTokens > mergedConfig.maxTokens || currentRounds > mergedConfig.maxRounds) {
@@ -155,7 +155,7 @@ export class TruncateCompression {
         };
     }
     async compress(messages, config) {
-        const mergedConfig = { ...this.config, ...config };
+        const mergedConfig = mergeCompressionConfig(this.config, config);
         const preserveCount = mergedConfig.preserveRecentRounds * 2; // 每轮 2 条消息
         if (messages.length <= preserveCount) {
             return messages;

package/dist/memory/index.d.ts

@@ -1,4 +1,4 @@
 export { LongTermMemoryService, InMemoryMemoryRepository, type IMemoryRepository, type MemoryRecord, type MemoryType, type CompressionResult, } from './long-term-memory.service.js';
 export { PostgresMemoryRepository } from './pg-memory.repository.js';
-export { SlidingWindowCompression, TruncateCompression, type IMessageCompressionService, type CompressionConfig, type SummarizeFunction, DEFAULT_COMPRESSION_CONFIG, estimateMessagesTokens, countRounds, } from './compression/index.js';
+export { SlidingWindowCompression, TruncateCompression, type IMessageCompressionService, type CompressionConfig, type SummarizeFunction, DEFAULT_COMPRESSION_CONFIG, COMPRESSION_WINDOW_FACTOR, resolveCompressionMaxTokens, estimateMessagesTokens, countRounds, } from './compression/index.js';
 export { SemanticRetrievalService, InMemoryVectorStore, type RetrievalConfig, type RetrievalStrategy, type RetrievalResult, type IVectorStore, type VectorResult, type EmbeddingFunction, DEFAULT_RETRIEVAL_CONFIG, } from './semantic-retrieval.service.js';

package/dist/memory/index.js

@@ -2,6 +2,6 @@
 export { LongTermMemoryService, InMemoryMemoryRepository, } from './long-term-memory.service.js';
 export { PostgresMemoryRepository } from './pg-memory.repository.js';
 // 消息压缩模块
-export { SlidingWindowCompression, TruncateCompression, DEFAULT_COMPRESSION_CONFIG, estimateMessagesTokens, countRounds, } from './compression/index.js';
+export { SlidingWindowCompression, TruncateCompression, DEFAULT_COMPRESSION_CONFIG, COMPRESSION_WINDOW_FACTOR, resolveCompressionMaxTokens, estimateMessagesTokens, countRounds, } from './compression/index.js';
 // 语义检索模块
 export { SemanticRetrievalService, InMemoryVectorStore, DEFAULT_RETRIEVAL_CONFIG, } from './semantic-retrieval.service.js';

package/dist/memory/message-compression.service.d.ts

@@ -18,8 +18,10 @@ export type CompressionStrategy = 'sliding-window' | 'truncate' | 'headroom';
 export interface CompressionConfig {
     /** 压缩策略（默认 sliding-window） */
     strategy: CompressionStrategy;
-    /** 触发压缩的 Token 上限（默认模型 context window 的 70%） */
+    /** 触发压缩的 Token 上限。有 maxContextTokens 且未显式传 maxTokens 时按 window×系数 */
     maxTokens: number;
+    /** 模型上下文窗。有则 maxTokens = floor(window × COMPRESSION_WINDOW_FACTOR) */
+    maxContextTokens?: number;
     /** 备用：按轮次触发（默认 20 轮） */
     maxRounds: number;
     /** 压缩后保留的最近轮次（默认 5 轮） */
@@ -29,6 +31,15 @@ export interface CompressionConfig {
     /** 用于摘要的模型（可选，默认使用当前 Agent 的模型） */
     summaryModel?: string;
 }
+/** 触发阈值 = 模型窗口 × 此系数（与原先 100000/128000 一致） */
+export declare const COMPRESSION_WINDOW_FACTOR = 0.7;
+/** 无模型窗口时的触发阈值（旧默认，按 128k×0.7） */
+export declare const COMPRESSION_MAX_TOKENS_FALLBACK = 100000;
+export declare function resolveCompressionMaxTokens(window?: number, factor?: number): number;
+/**
+ * 合并压缩配置。未显式传 maxTokens 且有 maxContextTokens 时，按窗口×系数。
+ */
+export declare function mergeCompressionConfig(base: CompressionConfig, override?: Partial<CompressionConfig>): CompressionConfig;
 /**
  * 默认压缩配置
  */

package/dist/memory/message-compression.service.js

@@ -7,12 +7,40 @@
  * @see design.md §1.1 记忆管理
  * @see requirements.md Requirement 4.3
  */
+/** 触发阈值 = 模型窗口 × 此系数（与原先 100000/128000 一致） */
+export const COMPRESSION_WINDOW_FACTOR = 0.7;
+/** 无模型窗口时的触发阈值（旧默认，按 128k×0.7） */
+export const COMPRESSION_MAX_TOKENS_FALLBACK = 100000;
+export function resolveCompressionMaxTokens(window, factor = COMPRESSION_WINDOW_FACTOR) {
+    if (typeof window === 'number' && Number.isFinite(window) && window > 0) {
+        const f = typeof factor === 'number' && Number.isFinite(factor) && factor > 0 && factor <= 1
+            ? factor
+            : COMPRESSION_WINDOW_FACTOR;
+        return Math.max(1, Math.floor(window * f));
+    }
+    return COMPRESSION_MAX_TOKENS_FALLBACK;
+}
+/**
+ * 合并压缩配置。未显式传 maxTokens 且有 maxContextTokens 时，按窗口×系数。
+ */
+export function mergeCompressionConfig(base, override) {
+    if (!override)
+        return { ...base };
+    const merged = { ...base, ...override };
+    if (Object.prototype.hasOwnProperty.call(override, 'maxTokens')) {
+        return merged;
+    }
+    if (override.maxContextTokens) {
+        merged.maxTokens = resolveCompressionMaxTokens(override.maxContextTokens);
+    }
+    return merged;
+}
 /**
  * 默认压缩配置
  */
 export const DEFAULT_COMPRESSION_CONFIG = {
     strategy: 'sliding-window',
-    maxTokens: 100000, // 约 70% of 128k context
+    maxTokens: COMPRESSION_MAX_TOKENS_FALLBACK,
     maxRounds: 20,
     preserveRecentRounds: 5,
     compressionRatio: 0.3,

package/dist/providers/http-llm-provider.d.ts

@@ -9,6 +9,7 @@
 import type { GraphMessage } from '../graph/contracts/executable-graph.js';
 import type { ILLMProvider, LLMNodeConfig, LLMResponse, LLMChunk } from '../graph/nodes/llm-node.js';
 import { type ILlmTurnLog } from '../debug/llm-turn-log.js';
+export declare const DEFAULT_LLM_HTTP_TIMEOUT_MS = 180000;
 export interface HttpLLMProviderConfig {
     apiKey: string;
     baseUrl?: string;

package/dist/providers/http-llm-provider.js

@@ -8,6 +8,8 @@
  */
 import { resolveLlmModelName } from './resolve-llm-model.js';
 import { createFileLlmTurnLogFromEnv, maskApiKey } from '../debug/llm-turn-log.js';
+import { buildContextUsage, turnSectionChars } from '../token/context-window.js';
+export const DEFAULT_LLM_HTTP_TIMEOUT_MS = 180_000;
 export class HttpLLMProvider {
     apiKey;
     baseUrl;
@@ -18,7 +20,7 @@ export class HttpLLMProvider {
         this.apiKey = config.apiKey;
         this.baseUrl = (config.baseUrl ?? 'https://api.openai.com/v1').replace(/\/$/, '');
         this.defaultModel = config.defaultModel ?? 'DeepSeek-V4-Pro';
-        this.timeoutMs = config.timeoutMs ?? 60000;
+        this.timeoutMs = config.timeoutMs ?? DEFAULT_LLM_HTTP_TIMEOUT_MS;
         this.turnLog = 'turnLog' in config ? config.turnLog : createFileLlmTurnLogFromEnv();
     }
     async writeTurn(args) {
@@ -57,6 +59,7 @@ export class HttpLLMProvider {
                     error: args.response.error,
                 },
                 latencyMs: Date.now() - args.startedAt,
+                context: buildContextUsage(args.response.inputTokens, args.config.maxContextTokens, turnSectionChars(args.config, args.messages)),
             });
         }
         catch (err) {

package/dist/providers/index.d.ts

@@ -1,5 +1,5 @@
 export { EchoLLMProvider, createDefaultLLMProvider } from './echo-llm-provider.js';
-export { HttpLLMProvider, type HttpLLMProviderConfig } from './http-llm-provider.js';
+export { HttpLLMProvider, DEFAULT_LLM_HTTP_TIMEOUT_MS, type HttpLLMProviderConfig } from './http-llm-provider.js';
 export { RoutingLLMProvider, type RoutingLLMProviderConfig } from './routing-llm-provider.js';
 export { resolveLlmModelName, canOverrideGraphModel } from './resolve-llm-model.js';
 export { createLocalLlmProvider, requireLocalLlmConnections, resolveLocalLlmConnection, parseLocalLlmConnectionRefs, hydrateLocalLlmConnections, LLM_CONNECTIONS_ENV, } from './local-llm-provider.js';

package/dist/providers/index.js

@@ -1,5 +1,5 @@
 export { EchoLLMProvider, createDefaultLLMProvider } from './echo-llm-provider.js';
-export { HttpLLMProvider } from './http-llm-provider.js';
+export { HttpLLMProvider, DEFAULT_LLM_HTTP_TIMEOUT_MS } from './http-llm-provider.js';
 export { RoutingLLMProvider } from './routing-llm-provider.js';
 export { resolveLlmModelName, canOverrideGraphModel } from './resolve-llm-model.js';
 export { createLocalLlmProvider, requireLocalLlmConnections, resolveLocalLlmConnection, parseLocalLlmConnectionRefs, hydrateLocalLlmConnections, LLM_CONNECTIONS_ENV, } from './local-llm-provider.js';

package/dist/providers/local-llm-provider.d.ts

@@ -9,11 +9,14 @@ export interface LocalLlmConnection {
     baseUrl: string;
     apiKey: string;
     defaults?: ModelCallDefaults;
+    /** HttpLLMProvider 超时（毫秒）；缺省用 DEFAULT_LLM_HTTP_TIMEOUT_MS */
+    timeoutMs?: number;
 }
 export interface LocalLlmConnectionRef {
     baseUrl: string;
     apiKeyEnv: string;
     defaults?: ModelCallDefaults;
+    timeoutMs?: number;
 }
 export interface LocalLlmConnectionRefs {
     default?: LocalLlmConnectionRef;

package/dist/providers/local-llm-provider.js

@@ -4,6 +4,11 @@
  */
 import { mergeModelCallParams } from '@gt-fe/eap-contracts';
 import { HttpLLMProvider } from './http-llm-provider.js';
+function parseTimeoutMs(value) {
+    if (typeof value !== 'number' || !Number.isFinite(value) || value < 1000)
+        return undefined;
+    return Math.min(3_600_000, Math.trunc(value));
+}
 export const LLM_CONNECTIONS_ENV = 'EAP_LLM_CONNECTIONS';
 export function parseLocalLlmConnectionRefs(env = process.env) {
     const raw = env[LLM_CONNECTIONS_ENV]?.trim();
@@ -42,7 +47,13 @@ export function hydrateLocalLlmConnections(refs, env = process.env) {
         const apiKey = env[ref.apiKeyEnv]?.trim();
         if (!apiKey)
             return undefined;
-        return { baseUrl: ref.baseUrl, apiKey, defaults: ref.defaults };
+        const timeoutMs = parseTimeoutMs(ref.timeoutMs);
+        return {
+            baseUrl: ref.baseUrl,
+            apiKey,
+            defaults: ref.defaults,
+            ...(timeoutMs !== undefined ? { timeoutMs } : {}),
+        };
     };
     const byModel = {};
     for (const [name, ref] of Object.entries(refs.byModel ?? {})) {
@@ -97,7 +108,7 @@ class LocalLlmProvider {
     }
     providerFor(model) {
         const connection = resolveLocalLlmConnection(this.connections, model);
-        const cacheKey = `${connection.baseUrl}\0${connection.apiKey}\0${model ?? ''}`;
+        const cacheKey = `${connection.baseUrl}\0${connection.apiKey}\0${model ?? ''}\0${connection.timeoutMs ?? ''}`;
         const cached = this.cache.get(cacheKey);
         if (cached)
             return cached;
@@ -105,6 +116,7 @@ class LocalLlmProvider {
             apiKey: connection.apiKey,
             baseUrl: connection.baseUrl,
             defaultModel: model,
+            timeoutMs: connection.timeoutMs,
             turnLog: this.turnLog,
         });
         this.cache.set(cacheKey, provider);

package/dist/providers/routing-llm-provider.js

@@ -13,7 +13,7 @@
  */
 import { mergeModelCallParams } from '@gt-fe/eap-contracts';
 import { EchoLLMProvider } from './echo-llm-provider.js';
-import { HttpLLMProvider } from './http-llm-provider.js';
+import { DEFAULT_LLM_HTTP_TIMEOUT_MS, HttpLLMProvider } from './http-llm-provider.js';
 export class RoutingLLMProvider {
     foundationUrl;
     fallback;
@@ -35,7 +35,12 @@ export class RoutingLLMProvider {
     }
     withCallDefaults(config, selected) {
         const merged = mergeModelCallParams(config, selected.defaults);
-        return { ...config, ...merged, model: selected.name };
+        return {
+            ...config,
+            ...merged,
+            model: selected.name,
+            maxContextTokens: selected.maxContextTokens ?? config.maxContextTokens,
+        };
     }
     async selectModel(config) {
         try {
@@ -50,11 +55,14 @@ export class RoutingLLMProvider {
             if (res.ok) {
                 const body = await res.json();
                 if (body.data?.name) {
+                    const window = body.data.maxContextTokens
+                        ?? body.data.capabilities?.maxContextTokens;
                     return {
                         name: body.data.name,
                         provider: body.data.provider,
                         connection: body.data.connection ?? null,
                         defaults: body.data.defaults ?? null,
+                        ...(typeof window === 'number' && window > 0 ? { maxContextTokens: window } : {}),
                     };
                 }
             }
@@ -71,7 +79,7 @@ export class RoutingLLMProvider {
                 apiKey: selected.connection.apiKey ?? '',
                 baseUrl: selected.connection.baseUrl,
                 defaultModel: selected.name,
-                timeoutMs: selected.connection.timeoutMs,
+                timeoutMs: selected.connection.timeoutMs ?? DEFAULT_LLM_HTTP_TIMEOUT_MS,
                 turnLog: this.turnLog,
             });
         }
@@ -81,6 +89,7 @@ export class RoutingLLMProvider {
                 apiKey: process.env.OPENAI_API_KEY,
                 baseUrl: process.env.OPENAI_BASE_URL,
                 defaultModel: selected.name,
+                timeoutMs: DEFAULT_LLM_HTTP_TIMEOUT_MS,
                 turnLog: this.turnLog,
             });
         }

package/dist/registry/deployment-snapshot.js

@@ -538,35 +538,37 @@ export class FileSystemDeploymentSnapshot {
                     break;
                 }
             }
-            if (!manifest && entryFile) {
-                const parsed = parseSkillMd(await readFile(entryFile, 'utf8'));
-                if (!parsed)
+            const parsedMd = entryFile
+                ? parseSkillMd(await readFile(entryFile, 'utf8'))
+                : null;
+            if (!manifest) {
+                if (!parsedMd)
                     continue;
                 manifest = {
-                    code: parsed.frontmatter.name,
-                    name: parsed.frontmatter.name,
-                    description: parsed.frontmatter.description,
-                    ...(parsed.frontmatter.license ? { license: parsed.frontmatter.license } : {}),
+                    code: ref.skillId,
+                    name: parsedMd.frontmatter.name,
+                    description: parsedMd.frontmatter.description,
+                    ...(parsedMd.frontmatter.license ? { license: parsedMd.frontmatter.license } : {}),
                 };
                 manifestPath = entryFile;
             }
+            else if (parsedMd) {
+                manifest = {
+                    ...manifest,
+                    name: parsedMd.frontmatter.name,
+                    description: parsedMd.frontmatter.description,
+                    ...(parsedMd.frontmatter.license ? { license: parsedMd.frontmatter.license } : {}),
+                };
+            }
             if (!manifest || !manifestPath)
                 continue;
-            if (!manifest.description && entryFile) {
-                const parsed = parseSkillMd(await readFile(entryFile, 'utf8'));
-                if (parsed?.frontmatter.description) {
-                    manifest = { ...manifest, description: parsed.frontmatter.description };
-                    if (!manifest.name)
-                        manifest.name = parsed.frontmatter.name;
-                }
-            }
             const isUserOverridePath = bundlePath.includes('/users/') || bundlePath.includes('\\users\\');
             const isAuthorOverlay = extraRoots.some((root) => root && isPathInside(root, bundlePath));
             if (ref.sha256 && !isUserOverridePath && !isAuthorOverlay && manifestPath.endsWith('.json')) {
                 const actual = await sha256OfFile(manifestPath);
                 await assertDigestMatch(ref.sha256, actual, `skill ${ref.skillId}`, { path: manifestPath });
             }
-            const skillId = String(manifest.code ?? ref.skillId);
+            const skillId = String(ref.skillId);
             return {
                 skillId,
                 name: String(manifest.name ?? ref.name ?? skillId),

package/dist/registry/graph-loader.d.ts

@@ -17,6 +17,11 @@ export interface LoadAgentOptions {
     /** 跳过读写进程内定义缓存 */
     bypassCache?: boolean;
 }
+export declare function resolveAgentSystemPromptFromLoader(loader: {
+    resolveAgentSystemPrompt?: (agentCode: string, version?: string) => Promise<string | undefined>;
+} | undefined, agentCode: string, version?: string): Promise<string | undefined>;
+/** manifest.prompts.system；空白视为缺省。 */
+export declare function extractAgentSystemPrompt(manifest: unknown): string | undefined;
 export interface GraphLoaderConfig {
     registryClient?: AgentRegistryClient;
     deploymentContext?: DeploymentContext;
@@ -104,6 +109,11 @@ export declare class GraphLoader {
     private cloneCached;
     loadGraph(agentCode: string, options?: LoadAgentOptions): Promise<GraphDSL>;
     private loadGraphFromSource;
+    /**
+     * Agent 基线系统提示词（manifest.prompts.system）。
+     * 每轮 execute/stream 注入 GraphState.agentSystemPrompt；不写进节点 config。
+     */
+    resolveAgentSystemPrompt(agentCode: string, version?: string): Promise<string | undefined>;
     /**
      * 解析 agent tools[] + graph tool 节点 union；
      * server+预装：以预装 manifest 为准；desktop 合并 ILocalToolInstallStore。