@gt-fe/eap-cli 0.2.12 → 0.2.14

package/dist/templates/single-agent-with-tools/README.md

@@ -1,138 +1,138 @@
-# 单智能体与工具
-
-单 LLM 经 ReAct 循环调用已装配工具。`shouldContinue` 返回 `call_tools` 时进入 `tools` 节点，执行后回到 `agent`。
-
-工具由 `toolRefs` 加载，经模型 API 的 `tools` 参数下发。平台默认另有 `read_file` / `write_file` / `execute_command`（不写进清单）。整图超时：图上未写 `config.timeout` 时为 20 分钟。
-
-预期：Agent 决定进入某个已装配 Skill，按该 Skill 的 workflow 执行后再回到推理。`shouldContinue` 的 `call_tools` 只能进入 `type: tool`，不能进入 subgraph。当前默认图：已装配 Skill 的名称与 SKILL.md 路径注入模型。详见 `skills/README.md`。
-
-## 图结构
-
-```text
-╭───────────╮    ┌─────────────┐
-│ __start__ ├───▶│ agent / llm │
-╰───────────╯    └──────┬──────┘
-                 ┌──────┴──────┐
-     call_tools  │             │ finish
-                 ▼             ▼
-          ┌─────────┐    ╭─────────╮
-          │  tools  │    │ __end__ │
-          └────┬────┘    ╰─────────╯
-               │
-               └──▶ agent
-```
-
-```mermaid
-flowchart LR
-  start((__start__)) --> agent[agent / llm]
-  agent -->|shouldContinue call_tools| tools[tools]
-  tools --> agent
-  agent -->|shouldContinue finish| finish((__end__))
-```
-
-`tools/` 中含三类登记示例。只有写入 `toolRefs` 并出现在 `eap.lock.yaml` 的工具集会被加载。默认装配 `echo-tool` 与 `http-weather`。`web-search` 默认未装配，上线前删除未使用的示例。
-
-| 目录 | `type` | 默认 | 子工具 | 本地密钥 |
-|------|--------|------|--------|----------|
-| `echo-tool` | code / node | 已装配 | `echo-tool` | 无 |
-| `http-weather` | http | 已装配 | `geocode_place`、`get_forecast` | 无。要求 Runtime ≥ 0.0.7 |
-| `web-search` | mcp / streamable_http | 未装配 | `web_search_exa` | `EXA_API_KEY` |
-
-**适用**：模型按用户意图选择工具。
-
-**不适用**：固定一步回复且不调用工具。此类场景使用「固定流程」模板。
-
-## 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，不要提交真实密钥。启用 `web-search` 时再在 `.env.local` 填写 `EXA_API_KEY`。
-
-| 变量 | 是否必填 | 说明 |
-|------|----------|------|
-| `EXA_API_KEY` | 仅启用 `web-search` 时 | 将对应项写入 `toolRefs` 后再填写。未设置时 URL 展开为 `exaApiKey=` |
-
-`.env.local` 已列入 `.gitignore`，不得提交。
-
-| 项 | 要求 |
-|----|------|
-| `runtime.llm.models.*.apiKey` | 模板占位 `sk-example-token`，运行前替换 |
-| `baseUrl` | 默认 `https://gtaiapi.gtcloud.cn/v1`。须与 Key 所属网关一致 |
-| `runtime.tools.mode` | 默认 `mcp`：code / http / mcp 分别走本机 handler、DevHttpExecutor、MCP 直连 |
-| 生效 | 修改配置或 `.env.local` 后重新启动 `eap chat` |
-
-## 2. 占位符与密钥
-
-| 占位符 | 位置 | 本地 | 生产 |
-|--------|------|------|------|
-| `${EXA_API_KEY}` | `tools/web-search` 的 URL | `.env.local`。空值时 Exa 当前仍可能返回结果，不得视为约定 | Portal 登记后由 Tool Gateway 出站注入 |
-
-华为云 UCS「配置项与密钥」：
-
-- **配置项**（ConfigMap）：`FOUNDATION_SERVICE_URL`、`PORT` 等非敏感值。
-- **密钥**（Secret）：仅当该 Pod 必须持有敏感值，且须在工作负载中挂载。
-- 禁止将 API Key 写入配置项，亦不要为展开 `${}` 向 Agent Deployment 注入工具 Token。
-
-`eap.lock.yaml` 只记录资源版本、来源和路径；package/standalone 物化时才生成入口文件摘要。
-
-## 3. 运行
-
-```bash
-eap validate --strict
-eap chat
-```
-
-`eap chat` 须在交互式终端中运行。启动摘要应为 `Runtime openai-http · mcp · dev`。
-
-默认已装配 `echo-tool` 与本地 `http-weather`。验收：`用 echo-tool 回显 ping`；`查上海今天天气`（`geocode_place` 之后 `get_forecast`）。`web-search` 仍须按第 5 节写入 `toolRefs` 并配置 `EXA_API_KEY`。未写入 `toolRefs` 的工具模型看不到，也不会对其发起出站请求。`eap init` 合并时保留这些本地引用。
-
-查一次对话每步 LLM 入参/响应：`eap conversation <sessionId>`。
-
-可选：`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
-`-- tools/
-    |-- echo-tool/          # 默认已装配
-    |-- http-weather/       # 默认已装配（Open-Meteo，无需 Key）
-    `-- web-search/         # 示例，默认未装配
-```
-
-`.eap/` 由运行时物化，不是源码。发布与部署以 Portal / Hosting 合同为准。
-
-## 5. 启用示例工具或增加本地工具
-
-`http-weather` 已在默认 `toolRefs`。启用 `web-search`（会出站到 Exa）：
-
-1. 在 `agent.manifest.json` 的 `toolRefs` 中增加 `{ "code": "web-search", "version": "1.0.0" }`。
-2. 在 `.env.local` 填写 `EXA_API_KEY`。
-3. 执行 `eap install` 刷新 `eap.lock.yaml`。
-4. 重新启动 `eap chat`。
-
-试跑：已配置 `EXA_API_KEY` 后：`搜索公开网页上与某公开人物相关的资料`。
-
-增加自有工具：在 `tools/<code>/` 放置清单及 handler，按同样步骤写入 `toolRefs` 并 `eap install`。
-
-上线前从 `toolRefs`、`eap.lock.yaml` 和 `tools/` 删除不需要的示例目录，勿将示例工具打进发布包。
-
-## 6. 故障排除
-
-| 现象 | 处理 |
-|------|------|
-| `LLM API error 401` | Key 无效，或与 `baseUrl` 所属网关不一致 |
-| 提示先执行 `eap login` | 升级 CLI。本地 `eap chat` 不要求登录 |
-| 启动失败或模型鉴权失败 | 将 `eap.config.json` 中的 `sk-example-token` 替换为有效 Token |
-| 工具返回固定 JSON / 未执行 handler | 清单缺 MCP / HTTP / code handler，会 `NOT_CONFIGURED` |
-| `http-weather` 失败或 `NOT_CONFIGURED` | Runtime ≥ 0.0.7，且清单包含 `allowedHosts` |
-| 未配置 `EXA_API_KEY` 仍有检索结果 | 检查 `.env.local` 是否已有值；空 Key 成功不得视为约定 |
-| 工具 `NOT_CONFIGURED` | 核对 `toolRefs` 与 lock；修改清单后执行 `eap install` |
-| 请求进入 Foundation 模型路由 | `platform.foundationServiceUrl` 设为 `null`，并取消 `FOUNDATION_SERVICE_URL` |
+# 单智能体与工具
+
+单 LLM 经 ReAct 循环调用已装配工具。`shouldContinue` 返回 `call_tools` 时进入 `tools` 节点，执行后回到 `agent`。
+
+工具由 `toolRefs` 加载，经模型 API 的 `tools` 参数下发。平台默认另有 `read_file` / `write_file` / `execute_command`（不写进清单）。整图超时：图上未写 `config.timeout` 时为 20 分钟。
+
+预期：Agent 决定进入某个已装配 Skill，按该 Skill 的 workflow 执行后再回到推理。`shouldContinue` 的 `call_tools` 只能进入 `type: tool`，不能进入 subgraph。当前默认图：已装配 Skill 的名称与 SKILL.md 路径注入模型。详见 `skills/README.md`。
+
+## 图结构
+
+```text
+╭───────────╮    ┌─────────────┐
+│ __start__ ├───▶│ agent / llm │
+╰───────────╯    └──────┬──────┘
+                 ┌──────┴──────┐
+     call_tools  │             │ finish
+                 ▼             ▼
+          ┌─────────┐    ╭─────────╮
+          │  tools  │    │ __end__ │
+          └────┬────┘    ╰─────────╯
+               │
+               └──▶ agent
+```
+
+```mermaid
+flowchart LR
+  start((__start__)) --> agent[agent / llm]
+  agent -->|shouldContinue call_tools| tools[tools]
+  tools --> agent
+  agent -->|shouldContinue finish| finish((__end__))
+```
+
+`tools/` 中含三类登记示例。只有写入 `toolRefs` 并出现在 `eap.lock.yaml` 的工具集会被加载。默认装配 `echo-tool` 与 `http-weather`。`web-search` 默认未装配，上线前删除未使用的示例。
+
+| 目录 | `type` | 默认 | 子工具 | 本地密钥 |
+|------|--------|------|--------|----------|
+| `echo-tool` | code / node | 已装配 | `echo-tool` | 无 |
+| `http-weather` | http | 已装配 | `geocode_place`、`get_forecast` | 无。要求 Runtime ≥ 0.0.7 |
+| `web-search` | mcp / streamable_http | 未装配 | `web_search_exa` | `EXA_API_KEY` |
+
+**适用**：模型按用户意图选择工具。
+
+**不适用**：固定一步回复且不调用工具。此类场景使用「固定流程」模板。
+
+## 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，不要提交真实密钥。启用 `web-search` 时再在 `.env.local` 填写 `EXA_API_KEY`。
+
+| 变量 | 是否必填 | 说明 |
+|------|----------|------|
+| `EXA_API_KEY` | 仅启用 `web-search` 时 | 将对应项写入 `toolRefs` 后再填写。未设置时 URL 展开为 `exaApiKey=` |
+
+`.env.local` 已列入 `.gitignore`，不得提交。
+
+| 项 | 要求 |
+|----|------|
+| `runtime.llm.models.*.apiKey` | 模板占位 `sk-example-token`，运行前替换 |
+| `baseUrl` | 默认 `https://gtaiapi.gtcloud.cn/v1`。须与 Key 所属网关一致 |
+| `runtime.tools.mode` | 默认 `mcp`：code / http / mcp 分别走本机 handler、DevHttpExecutor、MCP 直连 |
+| 生效 | 修改配置或 `.env.local` 后重新启动 `eap chat` |
+
+## 2. 占位符与密钥
+
+| 占位符 | 位置 | 本地 | 生产 |
+|--------|------|------|------|
+| `${EXA_API_KEY}` | `tools/web-search` 的 URL | `.env.local`。空值时 Exa 当前仍可能返回结果，不得视为约定 | Portal 登记后由 Tool Gateway 出站注入 |
+
+华为云 UCS「配置项与密钥」：
+
+- **配置项**（ConfigMap）：`FOUNDATION_SERVICE_URL`、`PORT` 等非敏感值。
+- **密钥**（Secret）：仅当该 Pod 必须持有敏感值，且须在工作负载中挂载。
+- 禁止将 API Key 写入配置项，亦不要为展开 `${}` 向 Agent Deployment 注入工具 Token。
+
+`eap.lock.yaml` 只记录资源版本、来源和路径；package/standalone 物化时才生成入口文件摘要。
+
+## 3. 运行
+
+```bash
+eap validate --strict
+eap chat
+```
+
+`eap chat` 须在交互式终端中运行。启动摘要应为 `Runtime openai-http · mcp · dev`。
+
+默认已装配 `echo-tool` 与本地 `http-weather`。验收：`用 echo-tool 回显 ping`；`查上海今天天气`（`geocode_place` 之后 `get_forecast`）。`web-search` 仍须按第 5 节写入 `toolRefs` 并配置 `EXA_API_KEY`。未写入 `toolRefs` 的工具模型看不到，也不会对其发起出站请求。`eap init` 合并时保留这些本地引用。
+
+查一次对话每步 LLM 入参/响应：`eap conversation <sessionId>`。
+
+可选：`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
+`-- tools/
+    |-- echo-tool/          # 默认已装配
+    |-- http-weather/       # 默认已装配（Open-Meteo，无需 Key）
+    `-- web-search/         # 示例，默认未装配
+```
+
+`.eap/` 由运行时物化，不是源码。发布与部署以 Portal / Hosting 合同为准。
+
+## 5. 启用示例工具或增加本地工具
+
+`http-weather` 已在默认 `toolRefs`。启用 `web-search`（会出站到 Exa）：
+
+1. 在 `agent.manifest.json` 的 `toolRefs` 中增加 `{ "code": "web-search", "version": "1.0.0" }`。
+2. 在 `.env.local` 填写 `EXA_API_KEY`。
+3. 执行 `eap install` 刷新 `eap.lock.yaml`。
+4. 重新启动 `eap chat`。
+
+试跑：已配置 `EXA_API_KEY` 后：`搜索公开网页上与某公开人物相关的资料`。
+
+增加自有工具：在 `tools/<code>/` 放置清单及 handler，按同样步骤写入 `toolRefs` 并 `eap install`。
+
+上线前从 `toolRefs`、`eap.lock.yaml` 和 `tools/` 删除不需要的示例目录，勿将示例工具打进发布包。
+
+## 6. 故障排除
+
+| 现象 | 处理 |
+|------|------|
+| `LLM API error 401` | Key 无效，或与 `baseUrl` 所属网关不一致 |
+| 提示先执行 `eap login` | 升级 CLI。本地 `eap chat` 不要求登录 |
+| 启动失败或模型鉴权失败 | 将 `eap.config.json` 中的 `sk-example-token` 替换为有效 Token |
+| 工具返回固定 JSON / 未执行 handler | 清单缺 MCP / HTTP / code handler，会 `NOT_CONFIGURED` |
+| `http-weather` 失败或 `NOT_CONFIGURED` | Runtime ≥ 0.0.7，且清单包含 `allowedHosts` |
+| 未配置 `EXA_API_KEY` 仍有检索结果 | 检查 `.env.local` 是否已有值；空 Key 成功不得视为约定 |
+| 工具 `NOT_CONFIGURED` | 核对 `toolRefs` 与 lock；修改清单后执行 `eap install` |
+| 请求进入 Foundation 模型路由 | `platform.foundationServiceUrl` 设为 `null`，并取消 `FOUNDATION_SERVICE_URL` |

package/dist/templates/single-agent-with-tools/agent.manifest.json

@@ -1,19 +1,19 @@
-{
-  "code": "my-agent",
-  "name": "my-agent",
-  "version": "1.0.0",
-  "description": "单智能体 ReAct 循环，按需调用本地工具",
-  "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": "单智能体 ReAct 循环，按需调用本地工具",
+  "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/single-agent-with-tools/eap.config.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.2.12",
+  "version": "0.2.14",
   "localToolDirectories": [
     "./tools"
   ],

package/dist/templates/single-agent-with-tools/eap.lock.yaml

@@ -1,5 +1,5 @@
-lockfileVersion: 2
-resources:
-  tools: []
-  skills: []
-  subagents: []
+lockfileVersion: 2
+resources:
+  tools: []
+  skills: []
+  subagents: []

package/dist/templates/single-agent-with-tools/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/

package/dist/templates/single-agent-with-tools/graph.json

@@ -1,41 +1,41 @@
-{
-  "description": "单智能体 ReAct：按需调用已装配工具。",
-  "state": {
-    "userRequest": "string",
-    "response": "string"
-  },
-  "nodes": [
-    {
-      "id": "agent",
-      "type": "llm"
-    },
-    {
-      "id": "tools",
-      "type": "tool",
-      "config": {
-        "tool": "echo-tool"
-      }
-    }
-  ],
-  "edges": [
-    { "from": "__start__", "to": "agent" },
-    { "from": "tools", "to": "agent" }
-  ],
-  "conditionalEdges": [
-    {
-      "from": "agent",
-      "conditionFn": "shouldContinue",
-      "branches": [
-        { "value": "call_tools", "to": "tools" },
-        { "value": "finish", "to": "__end__" }
-      ],
-      "fallback": "__end__"
-    }
-  ],
-  "entryPoint": "agent",
-  "finishPoints": ["__end__"],
-  "config": {
-    "maxRetries": 3,
-    "checkpointStore": "memory"
-  }
-}
+{
+  "description": "单智能体 ReAct：按需调用已装配工具。",
+  "state": {
+    "userRequest": "string",
+    "response": "string"
+  },
+  "nodes": [
+    {
+      "id": "agent",
+      "type": "llm"
+    },
+    {
+      "id": "tools",
+      "type": "tool",
+      "config": {
+        "tool": "echo-tool"
+      }
+    }
+  ],
+  "edges": [
+    { "from": "__start__", "to": "agent" },
+    { "from": "tools", "to": "agent" }
+  ],
+  "conditionalEdges": [
+    {
+      "from": "agent",
+      "conditionFn": "shouldContinue",
+      "branches": [
+        { "value": "call_tools", "to": "tools" },
+        { "value": "finish", "to": "__end__" }
+      ],
+      "fallback": "__end__"
+    }
+  ],
+  "entryPoint": "agent",
+  "finishPoints": ["__end__"],
+  "config": {
+    "maxRetries": 3,
+    "checkpointStore": "memory"
+  }
+}