@gt-fe/eap-cli 0.2.22 → 0.2.25

package/dist/templates/agent-api-orchestration/eap.config.json

@@ -1,15 +1,11 @@
 {
-  "version": "0.2.22",
+  "version": "0.2.25",
   "localToolDirectories": [
     "./tools"
   ],
   "localSkillDirectories": [
     "./skills"
   ],
-  "platform": {
-    "foundationServiceUrl": "https://eap-foundation-test.gtcloud.cn",
-    "portalUrl": "https://developer-portal-test.gtcloud.cn"
-  },
   "runtime": {
     "deploymentContext": "dev",
     "governance": {

package/dist/templates/agent-api-orchestration/graph.json

@@ -1,35 +1,35 @@
-{
-  "description": "用于演示 Agent API 编排的最小模型流程（含 RAG 多源检索）。",
-  "state": {
-    "userRequest": "string",
-    "response": "string"
-  },
-  "nodes": [
-    {
-      "id": "rag",
-      "type": "rag",
-      "config": {
-        "maxIterations": 5
-      }
-    },
-    {
-      "id": "respond",
-      "type": "llm",
-      "config": {
-        "disableTools": true,
-        "systemPrompt": "你是企业知识与数据问答助手，请根据用户的问题直接回答。"
-      }
-    }
-  ],
-  "edges": [
-    { "from": "__start__", "to": "rag" },
-    { "from": "rag", "to": "respond" },
-    { "from": "respond", "to": "__end__" }
-  ],
-  "entryPoint": "rag",
-  "finishPoints": ["__end__"],
-  "config": {
-    "maxRetries": 3,
-    "checkpointStore": "memory"
-  }
-}
+{
+  "description": "用于演示 Agent API 编排的最小模型流程（含 RAG 多源检索）。",
+  "state": {
+    "userRequest": "string",
+    "response": "string"
+  },
+  "nodes": [
+    {
+      "id": "rag",
+      "type": "rag",
+      "config": {
+        "maxIterations": 5
+      }
+    },
+    {
+      "id": "respond",
+      "type": "llm",
+      "config": {
+        "disableTools": true,
+        "systemPrompt": "你是企业知识与数据问答助手，请根据用户的问题直接回答。"
+      }
+    }
+  ],
+  "edges": [
+    { "from": "__start__", "to": "rag" },
+    { "from": "rag", "to": "respond" },
+    { "from": "respond", "to": "__end__" }
+  ],
+  "entryPoint": "rag",
+  "finishPoints": ["__end__"],
+  "config": {
+    "maxRetries": 3,
+    "checkpointStore": "memory"
+  }
+}

package/dist/templates/agent-api-orchestration/package.json

@@ -14,7 +14,7 @@
     "type-check": "tsc --noEmit"
   },
   "dependencies": {
-    "@gt-fe/eap-sdk": "^0.2.22",
+    "@gt-fe/eap-sdk": "^0.2.25",
     "dotenv": "^17.2.2",
     "express": "^4.21.2"
   },

package/dist/templates/agent-api-orchestration/src/embedded-agent.ts

@@ -9,7 +9,7 @@ import {
 import { dirname, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
-import { loadTemplateRuntime, resolveTemplateRuntimeRoot } from './project-config.js';
+import { loadTemplateRuntime, resolveTemplatePlatformConfig, resolveTemplateRuntimeRoot } from './project-config.js';
 export { AgentResourceService, createAgentResourceService } from './http/services/resource-service.js';
 export { createAgentApp, createAgentHttpServer, startAgentHttpServer } from './http/index.js';
 export type { AgentHttpStartOptions } from './http/index.js';
@@ -31,18 +31,13 @@ export interface EmbeddedAgentOptions {
 /**
  * 创建一个使用模板项目配置的内嵌 Agent。
  *
- * platform.portalUrl 和 platform.foundationServiceUrl 来自 eap.config.json；
+ * 项目配置地址优先于环境变量；缺省时使用测试环境，生产部署由宿主注入地址；
  * 凭证优先使用宿主显式传入的 Provider；只有开发模式才回退到 EAP_SDK_TOKEN。
  */
 export async function createEmbeddedAgent(options: EmbeddedAgentOptions = {}): Promise<Agent> {
   const runtimeRoot = options.runtimeRoot ?? resolveTemplateRuntimeRoot(entryDirectory);
   const loadedRuntime = loadTemplateRuntime(entryDirectory, runtimeRoot);
-  const platform = {
-    portalEndpoint: loadedRuntime.config.platform.portalUrl.trim(),
-    ...(loadedRuntime.config.platform.foundationServiceUrl?.trim()
-      ? { foundationEndpoint: loadedRuntime.config.platform.foundationServiceUrl.trim() }
-      : {}),
-  };
+  const platform = resolveTemplatePlatformConfig(loadedRuntime.config.platform);
   // 凭证优先级：宿主显式注入的 credentialProvider > EAP_SDK_TOKEN 环境变量回退。
   // 显式注入用于生产托管；EAP_SDK_TOKEN 用于本地演示（npm run dev / 本地起 dist 冒烟）。
   const provider =
@@ -89,4 +84,4 @@ export function createSdkTokenProvider(token?: string): AgentCredentialProvider
       return { value };
     },
   };
-}
+}

package/dist/templates/agent-api-orchestration/src/platform-user.ts

@@ -5,7 +5,9 @@ import {
 import { dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
-import { loadTemplatePlatformConfig } from './project-config.js';
+import { loadTemplateRuntime, resolveTemplatePlatformConfig, resolveTemplateRuntimeRoot } from './project-config.js';
+
+let cachedPlatformConfig: ReturnType<typeof resolveTemplatePlatformConfig> | undefined;
 
 /**
  * 演示宿主已经拿到前端用户 Token 时，如何通过 SDK 查询用户信息。
@@ -17,12 +19,7 @@ export async function resolveTokenUser(token: string): Promise<PlatformIdentity>
   const requestToken = token.trim();
   if (!requestToken) throw new Error('token 不能为空');
 
-  const { portalEndpoint, foundationEndpoint } = loadTemplatePlatformConfig(
-    dirname(fileURLToPath(import.meta.url)),
-  );
-  if (!foundationEndpoint) {
-    throw new Error('请在 eap.config.json 的 platform.foundationServiceUrl 中配置 Foundation 地址后再查询 Token 用户信息');
-  }
+  const { portalEndpoint, foundationEndpoint } = getTemplatePlatformConfig();
 
   // PlatformClient 的 portalEndpoint 是必填配置；查询用户实际走 foundation。
   const client = createPlatformClient({
@@ -34,3 +31,11 @@ export async function resolveTokenUser(token: string): Promise<PlatformIdentity>
   // SDK 会校验 Token 有效性、调用方类型，并返回 userId / roles / permissions。
   return client.resolveTokenUser(requestToken);
 }
+
+function getTemplatePlatformConfig(): ReturnType<typeof resolveTemplatePlatformConfig> {
+  if (cachedPlatformConfig) return cachedPlatformConfig;
+  const moduleDirectory = dirname(fileURLToPath(import.meta.url));
+  const runtime = loadTemplateRuntime(moduleDirectory, resolveTemplateRuntimeRoot(moduleDirectory));
+  cachedPlatformConfig = resolveTemplatePlatformConfig(runtime.config.platform);
+  return cachedPlatformConfig;
+}

package/dist/templates/agent-api-orchestration/src/project-config.ts

@@ -1,6 +1,8 @@
 import {
   loadAgentRuntime,
+  resolvePlatformEndpoints,
   type LoadedAgentRuntime,
+  type PlatformEndpointConfig,
 } from '@gt-fe/eap-sdk';
 import { resolve } from 'node:path';
 
@@ -31,15 +33,10 @@ export function resolveTemplateRuntimeRoot(moduleDirectory: string): string {
   );
 }
 
-export function loadTemplatePlatformConfig(
-  moduleDirectory: string,
-  runtimeRoot?: string,
-): TemplatePlatformConfig {
-  const { config } = loadTemplateRuntime(moduleDirectory, runtimeRoot);
-  const portalEndpoint = config.platform.portalUrl.trim();
-  const foundationEndpoint = config.platform.foundationServiceUrl?.trim() || undefined;
+export function resolveTemplatePlatformConfig(project?: PlatformEndpointConfig): TemplatePlatformConfig {
+  const { portalEndpoint, foundationEndpoint } = resolvePlatformEndpoints({ project });
   return {
     portalEndpoint,
-    ...(foundationEndpoint ? { foundationEndpoint } : {}),
+    foundationEndpoint,
   };
 }

package/dist/templates/dag-workflow/README.md

@@ -1,102 +1,102 @@
-# DAG 工作流
-
-`split` 两条普通出边同时进入 `branch-report` 与 `branch-task`，再在 `merge` 汇合。本模板按无环图交付。
-
-并行扇出就是多条普通边。条件分支把这两条出边改成 `conditionalEdges`，一次只走一条。装配 Skill 见 `skills/README.md`。整图超时：图上未写 `config.timeout` 时为 20 分钟。
-
-## 图结构
-
-```text
-╭───────────╮    ┌──────────────┐
-│ __start__ ├───▶│ split / code │
-╰───────────╯    └──────┬───────┘
-                 ┌──────┴──────┐
-                 ▼             ▼
-    ┌──────────────────┐    ┌──────────────────┐
-    │ branch-report    │    │ branch-task      │
-    │ llm disableTools │    │ llm disableTools │
-    └────────┬─────────┘    └────────┬─────────┘
-             └──────────┬────────────┘
-                        ▼
-             ┌─────────────────┐    ╭─────────╮
-             │ merge / llm ·   ├───▶│ __end__ │
-             │  disableTools   │    ╰─────────╯
-             └─────────────────┘
-```
-
-```mermaid
-flowchart TB
-  start((__start__)) --> split[split / code]
-  split --> report["branch-report / llm · disableTools"]
-  split --> task["branch-task / llm · disableTools"]
-  report --> merge["merge / llm · disableTools"]
-  task --> merge
-  merge --> finish((__end__))
-```
-
-**适用**：多步骤、独立分支同时推进后再汇合。
-
-**不适用**：一次只走一条分支。把 `split` 的两条普通出边改成 `conditionalEdges`。
-
-Session 只保留 `merge` 的正文（`finishPoints: ["merge"]`）。两条分支的意见在 llm-turns / Trace，不写成两条助手消息。
-
-## 1. 配置
-
-本地 `eap chat` 不要求 `eap login`。`runtime.llm` 会设置 `EAP_LLM_MODE=local`，用 `eap.config.json` 里的网关和 Token，不走 Foundation 模型路由。`platform.foundationServiceUrl` 默认是测试环境地址，给登录/发布用；纯本地可改为 `null`。
-
-把 `runtime.llm.models.*.apiKey` 的 `sk-example-token` 换成与 `baseUrl` 一致的有效 Token，不要提交真实密钥。图中 LLM 均设 `disableTools`，无 Tool 节点。
-
-| 项 | 要求 |
-|----|------|
-| `runtime.llm.models.*.apiKey` | 模板占位 `sk-example-token`，运行前替换 |
-| `baseUrl` | 默认 `https://gtaiapi.gtcloud.cn/v1`。须与 Key 所属网关一致 |
-| 生效 | 修改 `eap.config.json` 后重新启动 `eap chat` |
-
-## 2. 占位符与密钥
-
-模型密钥写在 `eap.config.json` 的 `runtime.llm.models.*.apiKey`，模板占位 `sk-example-token`。
-
-| 环境 | 处理 |
-|------|------|
-| 本地 | 替换占位 Token；不要提交真实密钥 |
-| 生产 | 不使用 `runtime.llm`。模型密钥由 Foundation 模型路由持有 |
-
-华为云 UCS「配置项与密钥」：配置项（ConfigMap）只存放非敏感值；密钥（Secret）仅当该 Pod 必须持有敏感值，且须挂载。禁止将 API Key 写入配置项。
-
-## 3. 运行
-
-```bash
-eap validate --strict
-eap chat
-```
-
-`eap chat` 须在交互式终端中运行。启动摘要应为 `Runtime openai-http · mcp · dev`。
-
-试跑：`用户登录后要导出月报，请给出说明和待办。` 预期两个分支都执行，再由 merge 汇总。Session 只保留 merge 这一条用户可见回复（`finishPoints`）。终端与 Playground 在**同一轮**里按节点分块展示，块上标节点 id，不把两路 token 交错拼成一串；`--verbose` 与 llm-turns 可看分支全文。
-
-可选：`eap chat --verbose`；`eap dev` 启动 Playground。
-
-## 4. 项目结构
-
-```text
-.
-|-- agent.manifest.json
-|-- graph.json
-|-- eap.config.json
-|-- eap.lock.yaml
-|-- package.json
-|-- .gitignore
-`-- skills/README.md
-```
-
-发布与部署以 Portal / Hosting 合同为准。
-
-## 5. 故障排除
-
-| 现象 | 处理 |
-|------|------|
-| `LLM API error 401` | Key 无效，或与 `baseUrl` 所属网关不一致 |
-| 提示先执行 `eap login` | 升级 CLI。本地 `eap chat` 不要求登录 |
-| 启动失败，提示 `no API key resolved` | 把 `eap.config.json` 的 `sk-example-token` 换成有效 Token |
-| 校验失败，提示节点 type 非法 | 扇出用普通边，不要发明节点类型 |
-| 请求进入 Foundation 模型路由 | `platform.foundationServiceUrl` 设为 `null`，并取消 `FOUNDATION_SERVICE_URL` |
+# DAG 工作流
+
+`split` 两条普通出边同时进入 `branch-report` 与 `branch-task`，再在 `merge` 汇合。本模板按无环图交付。
+
+并行扇出就是多条普通边。条件分支把这两条出边改成 `conditionalEdges`，一次只走一条。装配 Skill 见 `skills/README.md`。整图超时：图上未写 `config.timeout` 时为 20 分钟。
+
+## 图结构
+
+```text
+╭───────────╮    ┌──────────────┐
+│ __start__ ├───▶│ split / code │
+╰───────────╯    └──────┬───────┘
+                 ┌──────┴──────┐
+                 ▼             ▼
+    ┌──────────────────┐    ┌──────────────────┐
+    │ branch-report    │    │ branch-task      │
+    │ llm disableTools │    │ llm disableTools │
+    └────────┬─────────┘    └────────┬─────────┘
+             └──────────┬────────────┘
+                        ▼
+             ┌─────────────────┐    ╭─────────╮
+             │ merge / llm ·   ├───▶│ __end__ │
+             │  disableTools   │    ╰─────────╯
+             └─────────────────┘
+```
+
+```mermaid
+flowchart TB
+  start((__start__)) --> split[split / code]
+  split --> report["branch-report / llm · disableTools"]
+  split --> task["branch-task / llm · disableTools"]
+  report --> merge["merge / llm · disableTools"]
+  task --> merge
+  merge --> finish((__end__))
+```
+
+**适用**：多步骤、独立分支同时推进后再汇合。
+
+**不适用**：一次只走一条分支。把 `split` 的两条普通出边改成 `conditionalEdges`。
+
+Session 只保留 `merge` 的正文（`finishPoints: ["merge"]`）。两条分支的意见在 llm-turns / Trace，不写成两条助手消息。
+
+## 1. 配置
+
+本地 `eap chat` 不要求 `eap login`。`runtime.llm` 会设置 `EAP_LLM_MODE=local`，用 `eap.config.json` 里的网关和 Token，不走 Foundation 模型路由。CLI 登录和发布使用全局 `eap use test|prod` 选择的平台地址。
+
+把 `runtime.llm.models.*.apiKey` 的 `sk-example-token` 换成与 `baseUrl` 一致的有效 Token，不要提交真实密钥。图中 LLM 均设 `disableTools`，无 Tool 节点。
+
+| 项 | 要求 |
+|----|------|
+| `runtime.llm.models.*.apiKey` | 模板占位 `sk-example-token`，运行前替换 |
+| `baseUrl` | 默认 `https://gtaiapi.gtcloud.cn/v1`。须与 Key 所属网关一致 |
+| 生效 | 修改 `eap.config.json` 后重新启动 `eap chat` |
+
+## 2. 占位符与密钥
+
+模型密钥写在 `eap.config.json` 的 `runtime.llm.models.*.apiKey`，模板占位 `sk-example-token`。
+
+| 环境 | 处理 |
+|------|------|
+| 本地 | 替换占位 Token；不要提交真实密钥 |
+| 生产 | 不使用 `runtime.llm`。模型密钥由 Foundation 模型路由持有 |
+
+华为云 UCS「配置项与密钥」：配置项（ConfigMap）只存放非敏感值；密钥（Secret）仅当该 Pod 必须持有敏感值，且须挂载。禁止将 API Key 写入配置项。
+
+## 3. 运行
+
+```bash
+eap validate --strict
+eap chat
+```
+
+`eap chat` 须在交互式终端中运行。启动摘要应为 `Runtime openai-http · mcp · dev`。
+
+试跑：`用户登录后要导出月报，请给出说明和待办。` 预期两个分支都执行，再由 merge 汇总。Session 只保留 merge 这一条用户可见回复（`finishPoints`）。终端与 Playground 在**同一轮**里按节点分块展示，块上标节点 id，不把两路 token 交错拼成一串；`--verbose` 与 llm-turns 可看分支全文。
+
+可选：`eap chat --verbose`；`eap dev` 启动 Playground。
+
+## 4. 项目结构
+
+```text
+.
+|-- agent.manifest.json
+|-- graph.json
+|-- eap.config.json
+|-- eap.lock.yaml
+|-- package.json
+|-- .gitignore
+`-- skills/README.md
+```
+
+发布与部署以 Portal / Hosting 合同为准。
+
+## 5. 故障排除
+
+| 现象 | 处理 |
+|------|------|
+| `LLM API error 401` | Key 无效，或与 `baseUrl` 所属网关不一致 |
+| 提示先执行 `eap login` | 升级 CLI。本地 `eap chat` 不要求登录 |
+| 启动失败，提示 `no API key resolved` | 把 `eap.config.json` 的 `sk-example-token` 换成有效 Token |
+| 校验失败，提示节点 type 非法 | 扇出用普通边，不要发明节点类型 |
+| 请求进入 Foundation 模型路由 | 配置 `FOUNDATION_SERVICE_URL` |

package/dist/templates/dag-workflow/agent.manifest.json

@@ -1,19 +1,19 @@
-{
-  "code": "my-agent",
-  "name": "my-agent",
-  "version": "1.0.0",
-  "description": "DAG 工作流：并行扇出后合并",
-  "toolRefs": [],
-  "skillRefs": [],
-  "prompts": {
-    "system": "对请求同时从报告和任务两个视角处理，再合并。用中文回答。"
-  },
-  "models": {
-    "default": "DeepSeek-V4-Pro",
-    "allowed": ["DeepSeek-V4-Pro", "DeepSeek-V4-Flash"]
-  },
-  "metadata": {
-    "owner": "agent-template",
-    "tags": ["template"]
-  }
-}
+{
+  "code": "my-agent",
+  "name": "my-agent",
+  "version": "1.0.0",
+  "description": "DAG 工作流：并行扇出后合并",
+  "toolRefs": [],
+  "skillRefs": [],
+  "prompts": {
+    "system": "对请求同时从报告和任务两个视角处理，再合并。用中文回答。"
+  },
+  "models": {
+    "default": "DeepSeek-V4-Pro",
+    "allowed": ["DeepSeek-V4-Pro", "DeepSeek-V4-Flash"]
+  },
+  "metadata": {
+    "owner": "agent-template",
+    "tags": ["template"]
+  }
+}

package/dist/templates/dag-workflow/eap.config.json

@@ -1,15 +1,11 @@
 {
-  "version": "0.2.22",
+  "version": "0.2.25",
   "localToolDirectories": [
     "./tools"
   ],
   "localSkillDirectories": [
     "./skills"
   ],
-  "platform": {
-    "foundationServiceUrl": "https://eap-foundation-test.gtcloud.cn",
-    "portalUrl": "https://developer-portal-test.gtcloud.cn"
-  },
   "runtime": {
     "deploymentContext": "dev",
     "governance": {

package/dist/templates/dag-workflow/gitignore

@@ -1,51 +1,51 @@
-# OS files
-.DS_Store
-Thumbs.db
-Desktop.ini
-
-# Editor and IDE files
-.idea/
-.vscode/
-*.swp
-*.swo
-
-# Dependencies
-node_modules/
-.pnpm-store/
-
-# Lock files
-package-lock.json
-
-# Build outputs
-dist/
-build/
-out/
-.output/
-.history
-
-# Logs
-*.log
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-pnpm-debug.log*
-
-# Test coverage
-coverage/
-
-# Turbo
-.turbo/
-
-# Environment
-.env
-.env.local
-.env.*.local
-
-# Temporary files
-tmp/
-temp/
-.cache/
-.run/
-
-# Generated Agent state
-.eap/
+# OS files
+.DS_Store
+Thumbs.db
+Desktop.ini
+
+# Editor and IDE files
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Dependencies
+node_modules/
+.pnpm-store/
+
+# Lock files
+package-lock.json
+
+# Build outputs
+dist/
+build/
+out/
+.output/
+.history
+
+# Logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+# Test coverage
+coverage/
+
+# Turbo
+.turbo/
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# Temporary files
+tmp/
+temp/
+.cache/
+.run/
+
+# Generated Agent state
+.eap/