@gt-fe/eap-runtime 0.0.32 → 0.0.34

package/dist/tool/system-prompt-builder.js

@@ -7,8 +7,8 @@
  * ```
  * [平台规则常量]          ← 代码内置，安全约束 + 行为准则（最高优先级）
  * [当前时间]              ← 运行时动态注入（自然周等时间规则的判定基准）
- * [Agent 身份]            ← agentName / agentCode（目录身份，不是 prompts.system）
- * [可用工具短目录]        ← 名称 + 一句话用途；完整 schema 仍走 API tools
+ * [Agent 身份]            ← 展示名 agentName，缺省 agentCode（对用户说话，不是路由键）
+ * [可用技能短目录]        ← 展示名 + skillId + SKILL.md 路径（技能不是 function）
  * [Agent 基线]            ← agent.manifest.json prompts.system；非 silent LLM
  * [节点提示词]            ← Graph LLM 节点 config.systemPrompt / systemPromptFile
  * ```
@@ -16,7 +16,7 @@
  * 基线只走 GraphState.agentSystemPrompt，不写进节点 config。无图时节点无增量。
  * silent 节点不带基线。技能正文不灌 system。
  *
- * 工具 schema 走 API 的 tools 参数（见 loadedToolsToApiTools）；system 短目录给模型发现用，不是对用户报菜名。
+ * 工具只走 API 的 tools 参数（见 loadedToolsToApiTools），不写入 system。
  *
  * @see docs/status/module-status-and-backlog.md RT-5
  */
@@ -86,6 +86,22 @@ function trimPrompt(value) {
     const trimmed = value.trim();
     return trimmed ? trimmed : undefined;
 }
+/** 对人展示的名称。有展示名用展示名，否则用编码。 */
+export function spokenName(displayName, code) {
+    const name = displayName?.trim();
+    if (name)
+        return name;
+    const id = code?.trim();
+    return id || undefined;
+}
+/** 短目录标题：展示名在前，调用键在行内。名称与编码相同则只写编码。 */
+export function catalogEntryTitle(code, displayName, codePhrase) {
+    const id = code.trim();
+    const name = displayName?.trim();
+    if (name && name !== id)
+        return `**${name}**（${codePhrase}）`;
+    return `**${id}**`;
+}
 /**
  * 非 silent LLM 才带 Agent 基线；节点提示词空则省略。
  * silent 只保留节点增量（选技能 / JSON）。
@@ -103,7 +119,7 @@ export function resolveLlmPromptInputs(input) {
  * SystemPromptBuilder — 系统提示词拼接
  *
  * 具名段拼接（无模板引擎）。顺序固定，段标题用于排查。
- * 工具短目录进 system；完整 schema 走 API tools 参数。
+ * 工具只走 API tools 参数，不进 system。技能短目录进 system（技能不是 function）。
  * Agent 基线与节点提示词整段透传，不做 {{ }} 替换。
  */
 export class SystemPromptBuilder {
@@ -125,7 +141,6 @@ export class SystemPromptBuilder {
             add('user', '当前用户', `## 当前用户\n用户标识：${context.userId.trim()}。用户说「我 / 我的」时使用此标识，不要向用户再要一遍。`);
         }
         add('jail', '文件与命令权限', this.buildJail(context));
-        add('tools-catalog', '可用工具', context.toolCatalog);
         add('skills-catalog', '可用技能', context.skillCatalog);
         add('agent', 'Agent 基线', context.agentPrompt);
         add('node', '节点提示词', context.nodePrompt);
@@ -154,7 +169,7 @@ export class SystemPromptBuilder {
         return lines.join('\n');
     }
     buildAgentIdentity(context) {
-        const name = context.agentName ?? context.agentCode;
+        const name = spokenName(context.agentName, context.agentCode);
         return name ? `## Agent 身份\n你的名称是「${name}」。` : '';
     }
     buildJail(context) {
@@ -246,6 +261,21 @@ export function naturalTimeWindows(now = new Date()) {
         lastMonth: `${formatDay(lastMonthStart)} ~ ${formatDay(lastMonthEnd)}`,
     };
 }
+/** 展示名 + skillId，供 system「可用技能」段。read_file 仍用 skillId。 */
+export function buildSkillCatalog(defs) {
+    if (!defs)
+        return undefined;
+    const rows = Object.values(defs).map((skill) => {
+        const desc = (skill.description ?? '').replace(/\s+/g, ' ').trim();
+        const entry = skill.entryFile ?? (skill.bundlePath ? `${skill.bundlePath}/SKILL.md` : '');
+        const title = catalogEntryTitle(skill.skillId, skill.name, `skillId ${skill.skillId}`);
+        const pathLine = entry ? `\n  SKILL.md: ${entry}` : '';
+        return `- ${title}${desc ? `：${desc}` : ''}${pathLine}`;
+    });
+    if (rows.length === 0)
+        return undefined;
+    return `# 可用技能\n要用某个技能时，调用 read_file 读取其 SKILL.md。脚本和参考文档默认在同一目录。\n${rows.join('\n')}`;
+}
 /**
  * 将平台的 LoadedToolMap 转为 OpenAI API 的 tools 参数
  *
@@ -256,26 +286,6 @@ export function naturalTimeWindows(now = new Date()) {
  * @param skillTools - 可选，当前 Skill 所需的工具名称列表（过滤子集）
  * @returns OpenAI API tools 参数数组
  */
-/** 名称 + 一句话用途，供 system「可用工具」段。schema 仍走 loadedToolsToApiTools。 */
-export function buildToolCatalog(loadedTools) {
-    if (!loadedTools)
-        return undefined;
-    const rows = Object.values(loadedTools).map((tool) => {
-        const desc = (tool.manifest.description ?? '').replace(/\s+/g, ' ').trim();
-        const displayName = tool.manifest.name?.trim();
-        const title = displayName && displayName !== tool.name
-            ? `${tool.name}（${displayName}）`
-            : tool.name;
-        return `- **${title}**${desc ? `：${desc}` : ''}`;
-    });
-    if (rows.length === 0)
-        return undefined;
-    return [
-        '# 可用工具',
-        '调用时使用 function calling，不要假装没有这些工具。这是给你发现用的短目录，不是对用户报菜名。',
-        rows.join('\n'),
-    ].join('\n');
-}
 export function loadedToolsToApiTools(loadedTools, skillTools) {
     if (!loadedTools)
         return [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gt-fe/eap-runtime",
-  "version": "0.0.32",
+  "version": "0.0.34",
   "description": "Enterprise Agent Platform — Runtime核心：Graph执行引擎、Task生命周期、Session管理、Checkpoint持久化",
   "type": "module",
   "main": "dist/index.js",