@gt-fe/eap-cli 0.2.1 → 0.2.3

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

@@ -10,7 +10,7 @@
   },
   "models": {
     "default": "DeepSeek-V4-Pro",
-    "allowed": ["DeepSeek-V4-Pro"]
+    "allowed": ["DeepSeek-V4-Pro", "DeepSeek-V4-Flash"]
   },
   "metadata": {
     "owner": "agent-api-orchestration-template",

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

@@ -1,9 +1,13 @@
 {
-  "version": "0.2.1",
-  "localToolDirectories": ["./tools"],
-  "localSkillDirectories": ["./skills"],
+  "version": "0.2.3",
+  "localToolDirectories": [
+    "./tools"
+  ],
+  "localSkillDirectories": [
+    "./skills"
+  ],
   "platform": {
-    "foundationServiceUrl": null,
+    "foundationServiceUrl": "https://eap-foundation-test.gtcloud.cn",
     "portalUrl": "https://developer-portal-test.gtcloud.cn"
   },
   "runtime": {
@@ -24,11 +28,11 @@
       "models": {
         "DeepSeek-V4-Pro": {
           "baseUrl": "https://gtaiapi.gtcloud.cn/v1",
-          "apiKey": "${OPENAI_API_KEY}"
+          "apiKey": "sk-example-token"
         },
         "DeepSeek-V4-Flash": {
           "baseUrl": "https://gtaiapi.gtcloud.cn/v1",
-          "apiKey": "${OPENAI_API_KEY}"
+          "apiKey": "sk-example-token"
         }
       }
     }

package/dist/templates/agent-api-orchestration/gitignore

@@ -1,6 +1,3 @@
 node_modules/
 dist/
 .eap/
-.env
-.env.local
-.env.production

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

@@ -1,45 +1,30 @@
-{
-  "description": "用于演示 Agent API 编排的最小模型流程（含 RAG 多源检索）。",
-  "state": {
-    "userRequest": "string",
-    "response": "string"
-  },
-  "nodes": [
-    {
-      "id": "rag",
-      "type": "rag",
-      "config": {
-        "model": "DeepSeek-V4-Pro",
-        "totalK": 10,
-        "maxIterations": 5,
-        "retrievalSources": {
-          "sources": [
-            { "type": "local-file", "id": "共享资料", "source": "./docs" }
-          ]
-        }
-      }
-    },
-    {
-      "id": "respond",
-      "type": "llm",
-      "config": {
-        "model": "DeepSeek-V4-Pro",
-        "disableTools": true,
-        "systemPrompt": "你是企业知识与数据问答助手。上游 rag 节点已完成多源检索并把结果放在上下文中（[rag] 消息），请仅依据检索到的内容回答；检索结果不足以回答时明确说明，并标注信息来源。"
-      }
-    }
-  ],
-  "edges": [
-    { "from": "__start__", "to": "rag" },
-    { "from": "rag", "to": "respond" },
-    { "from": "respond", "to": "__end__" }
-  ],
-  "entryPoint": "rag",
-  "finishPoints": ["__end__"],
-  "config": {
-    "maxIterations": 50,
-    "maxRetries": 3,
-    "timeout": 120000,
-    "checkpointStore": "memory"
-  }
-}
+{
+  "description": "用于演示 Agent API 编排的最小模型流程（含 RAG 多源检索）。",
+  "state": {
+    "userRequest": "string",
+    "response": "string"
+  },
+  "nodes": [
+    {
+      "id": "respond",
+      "type": "llm",
+      "config": {
+        "model": "DeepSeek-V4-Pro",
+        "disableTools": true,
+        "systemPrompt": "你是企业知识与数据问答助手，请根据用户的问题直接回答。"
+      }
+    }
+  ],
+  "edges": [
+    { "from": "__start__", "to": "respond" },
+    { "from": "respond", "to": "__end__" }
+  ],
+  "entryPoint": "respond",
+  "finishPoints": ["__end__"],
+  "config": {
+    "maxIterations": 50,
+    "maxRetries": 3,
+    "timeout": 120000,
+    "checkpointStore": "memory"
+  }
+}

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

@@ -14,14 +14,14 @@
     "type-check": "tsc --noEmit"
   },
   "dependencies": {
-    "@gt-fe/eap-sdk": "^0.2.1",
+    "@gt-fe/eap-sdk": "^0.2.3",
     "dotenv": "^17.2.2",
     "express": "^4.21.2"
   },
   "devDependencies": {
     "@types/express": "^4.17.21",
     "@types/node": "^22.0.0",
-    "esbuild": "^0.25.0",
+    "esbuild": "^0.28.2",
     "tsx": "^4.19.2",
     "typescript": "^5.5.0"
   },

package/dist/templates/agent-api-orchestration/scripts/api-test.mjs

@@ -0,0 +1,443 @@
+/**
+ * Agent API 接口测试脚本（可直接运行）
+ *
+ * 用法：
+ *   node scripts/api-test.mjs
+ *
+ * 可选环境变量：
+ *   BASE_URL    服务地址，默认 http://127.0.0.1:3000
+ *   AGENT_CODE  Agent code，默认 agent-test
+ *   TEST_MESSAGE  发送给 Agent 的测试消息，默认“你好，请用一句话介绍你自己”
+ *
+ * 会依次覆盖：健康检查、能力发现、会话增查、消息发送（同步调用）、
+ * 历史消息查询、无会话同步调用、流式对话、归档、恢复（预期 501）。
+ * 每个用例独立 try/catch，失败不中断后续用例，最后打印汇总。
+ */
+
+const BASE_URL = (process.env.BASE_URL || "http://127.0.0.1:3000").replace(
+  /\/+$/,
+  "",
+);
+const AGENT_CODE = process.env.AGENT_CODE || "agent-test";
+const TEST_MESSAGE = process.env.TEST_MESSAGE || "你好，请用一句话介绍你自己";
+
+const api = (path) => `${BASE_URL}/api/v1/agents/${AGENT_CODE}${path}`;
+
+let step = 0;
+let passed = 0;
+let failed = 0;
+const failures = [];
+
+// ---------- 工具函数 ----------
+
+function header(title) {
+  console.log("\n" + "═".repeat(70));
+  console.log(`  ${title}`);
+  console.log("═".repeat(70));
+}
+
+function log(label, value) {
+  console.log(`  ▶ ${label}`);
+  if (value !== undefined) console.log(pretty(value, 2));
+}
+
+function ok(msg) {
+  passed += 1;
+  console.log(`  ✅ [PASS] ${msg}`);
+}
+
+function fail(msg, detail) {
+  failed += 1;
+  failures.push({ msg, detail });
+  console.log(`  ❌ [FAIL] ${msg}`);
+  if (detail !== undefined) console.log(pretty(detail, 2));
+}
+
+function pretty(value, indent = 0) {
+  const text =
+    typeof value === "string" ? value : JSON.stringify(value, null, indent);
+  const lines = text.split("\n");
+  const head = lines.slice(0, 40);
+  let out = "    " + head.join("\n    ");
+  if (lines.length > 40) out += `\n    ... (共 ${lines.length} 行，已截断)`;
+  return out;
+}
+
+function truncate(value, max = 800) {
+  const text =
+    value == null
+      ? ""
+      : typeof value === "string"
+        ? value
+        : JSON.stringify(value);
+  return text.length > max
+    ? text.slice(0, max) + `... (共 ${text.length} 字符)`
+    : text;
+}
+
+async function request(
+  method,
+  url,
+  { body, headers = {}, timeout = 30000 } = {},
+) {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeout);
+  try {
+    const response = await fetch(url, {
+      method,
+      headers: { "Content-Type": "application/json", ...headers },
+      ...(body !== undefined ? { body: JSON.stringify(body) } : {}),
+      signal: controller.signal,
+    });
+    const text = await response.text();
+    let data;
+    try {
+      data = text ? JSON.parse(text) : null;
+    } catch {
+      data = text;
+    }
+    return { status: response.status, data, ok: response.ok };
+  } catch (error) {
+    const message =
+      error?.name === "AbortError"
+        ? `请求超时（${timeout}ms）`
+        : (error?.message ?? String(error));
+    return { status: 0, data: null, ok: false, error: message };
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+/** 消费 SSE 流，返回 [{ event, data }]，data 已解析为 JSON。 */
+async function consumeSse(url, { body, timeout = 120000 } = {}) {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeout);
+  const events = [];
+  try {
+    const response = await fetch(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body),
+      signal: controller.signal,
+    });
+    if (!response.ok || !response.body) {
+      const text = await response.text();
+      return { status: response.status, events, raw: text };
+    }
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      buffer += decoder.decode(value, { stream: true });
+      const frames = buffer.split("\n\n");
+      buffer = frames.pop() ?? "";
+      for (const frame of frames) {
+        const eventLine = frame.split("\n").find((l) => l.startsWith("event:"));
+        const dataLine = frame.split("\n").find((l) => l.startsWith("data:"));
+        if (!dataLine) continue;
+        const type = eventLine ? eventLine.slice(6).trim() : "message";
+        let data;
+        try {
+          data = JSON.parse(dataLine.slice(5).trim());
+        } catch {
+          data = dataLine.slice(5).trim();
+        }
+        events.push({ event: type, data });
+      }
+    }
+    return { status: response.status, events };
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+function assert(condition, message) {
+  if (!condition) throw new Error(message);
+}
+
+// ---------- 测试用例 ----------
+
+async function testHealth() {
+  const name = "健康检查";
+  header(`${name} · GET /health`);
+  const { status, data } = await request("GET", `${BASE_URL}/health`);
+  log("响应", data);
+  try {
+    assert(status === 200, `期望 200，实际 ${status}`);
+    assert(
+      data?.status === "ok",
+      `期望 status=ok，实际 ${JSON.stringify(data)}`,
+    );
+    assert(
+      data?.agentCode === AGENT_CODE,
+      `期望 agentCode=${AGENT_CODE}，实际 ${data?.agentCode}`,
+    );
+    ok(name);
+  } catch (e) {
+    fail(name, e.message);
+  }
+}
+
+async function testCapability() {
+  const name = "能力发现";
+  header(`${name} · GET ${api("")}`);
+  const { status, data } = await request("GET", api(""));
+  log("响应（截断）", truncate(data, 1200));
+  try {
+    assert(status === 200, `期望 200，实际 ${status}`);
+    assert(
+      data?.agent?.code === AGENT_CODE,
+      `期望 agent.code=${AGENT_CODE}，实际 ${data?.agent?.code}`,
+    );
+    assert(
+      data?.capabilities?.stream === true,
+      "期望 capabilities.stream=true",
+    );
+    assert(Array.isArray(data?.graph?.nodes), "期望 graph.nodes 为数组");
+    ok(
+      `${name}（版本 ${data?.agent?.version}，节点 ${data?.graph?.nodes?.length ?? 0} 个）`,
+    );
+  } catch (e) {
+    fail(name, e.message);
+  }
+}
+
+async function testCreateSession() {
+  const name = "创建会话";
+  header(`${name} · POST ${api("/sessions")}`);
+  const { status, data } = await request("POST", api("/sessions"), {
+    body: { userId: "test-user", title: "接口测试会话" },
+  });
+  log("响应", data);
+  try {
+    assert(status === 201, `期望 201，实际 ${status}`);
+    assert(data?.id, `期望返回 session.id，实际 ${JSON.stringify(data)}`);
+    ok(name);
+    return data.id;
+  } catch (e) {
+    fail(name, e.message);
+    return undefined;
+  }
+}
+
+async function testListSessions() {
+  const name = "查询会话列表";
+  header(`${name} · GET ${api("/sessions?limit=20&offset=0")}`);
+  const { status, data } = await request(
+    "GET",
+    `${api("/sessions")}?limit=20&offset=0`,
+  );
+  log("响应", data);
+  try {
+    assert(status === 200, `期望 200，实际 ${status}`);
+    assert(
+      Array.isArray(data?.items) || Array.isArray(data),
+      `期望返回会话列表，实际 ${JSON.stringify(data)}`,
+    );
+    ok(name);
+  } catch (e) {
+    fail(name, e.message);
+  }
+}
+
+async function testGetSession(sessionId) {
+  const name = "查询会话详情";
+  header(`${name} · GET ${api(`/sessions/${sessionId}`)}`);
+  const { status, data } = await request("GET", api(`/sessions/${sessionId}`));
+  log("响应", data);
+  try {
+    assert(status === 200, `期望 200，实际 ${status}`);
+    assert(data?.id === sessionId, `期望 id=${sessionId}，实际 ${data?.id}`);
+    ok(name);
+  } catch (e) {
+    fail(name, e.message);
+  }
+}
+
+async function testSendMessage(sessionId) {
+  const name = "发送消息（同步调用）";
+  header(`${name} · POST ${api(`/sessions/${sessionId}/messages`)}`);
+  const { status, data } = await request(
+    "POST",
+    api(`/sessions/${sessionId}/messages`),
+    {
+      body: { content: TEST_MESSAGE },
+      timeout: 120000,
+    },
+  );
+  log("响应", truncate(data, 1200));
+  try {
+    assert(status === 200, `期望 200，实际 ${status}`);
+    const output = data?.output;
+    log("Agent 回复", truncate(output, 1200));
+    assert(
+      data?.status === "success",
+      `期望 status=success，实际 ${data?.status}${output ? `（${truncate(output, 200)}）` : ""}`,
+    );
+    ok(name);
+  } catch (e) {
+    fail(name, e.message);
+  }
+}
+
+async function testListMessages(sessionId) {
+  const name = "查询历史消息";
+  header(`${name} · GET ${api(`/sessions/${sessionId}/messages`)}`);
+  const { status, data } = await request(
+    "GET",
+    api(`/sessions/${sessionId}/messages`),
+  );
+  log("响应", data);
+  try {
+    assert(status === 200, `期望 200，实际 ${status}`);
+    ok(name);
+  } catch (e) {
+    fail(name, e.message);
+  }
+}
+
+async function testStatelessInvoke() {
+  const name = "无会话同步调用";
+  header(`${name} · POST ${api("/invoke")}`);
+  const { status, data } = await request("POST", api("/invoke"), {
+    body: { content: TEST_MESSAGE },
+    timeout: 120000,
+  });
+  log("响应", truncate(data, 800));
+  log("Agent 回复", truncate(data?.output, 1200));
+  try {
+    assert(status === 200, `期望 200，实际 ${status}`);
+    assert(
+      data?.status === "success",
+      `期望 status=success，实际 ${data?.status}${data?.output ? `（${truncate(data.output, 200)}）` : ""}`,
+    );
+    ok(name);
+  } catch (e) {
+    fail(name, e.message);
+  }
+}
+
+async function testStream(sessionId) {
+  const name = "流式对话";
+  header(`${name} · POST ${api(`/sessions/${sessionId}/stream`)}`);
+  const { status, events, raw } = await consumeSse(
+    api(`/sessions/${sessionId}/stream`),
+    {
+      body: { content: "继续，用一句话补充说明" },
+    },
+  );
+  try {
+    assert(status === 200, `期望 200，实际 ${status}`);
+    assert(events.length > 0, "期望至少收到 1 个 SSE 事件");
+    log(
+      `共收到 ${events.length} 个事件，类型分布：`,
+      countBy(events.map((e) => e.event)),
+    );
+    const chunks = events
+      .filter((e) => e.event === "response.chunk")
+      .map((e) => e.data?.delta ?? e.data?.text ?? e.data?.content);
+    log("流式文本片段（前 20 个）", chunks.slice(0, 20));
+    const text = chunks.filter(Boolean).join("");
+    log("流式回复全文", truncate(text, 1200));
+    const errorEvent = events.find(
+      (e) => e.event === "error" || e.event === "task.error",
+    );
+    assert(!errorEvent, `流中收到错误事件：${truncate(errorEvent?.data, 300)}`);
+    ok(name);
+  } catch (e) {
+    if (raw) log("原始响应", truncate(raw, 800));
+    fail(name, e.message);
+  }
+}
+
+async function testArchive(sessionId) {
+  const name = "归档会话";
+  header(`${name} · POST ${api(`/sessions/${sessionId}/archive`)}`);
+  const { status, data } = await request(
+    "POST",
+    api(`/sessions/${sessionId}/archive`),
+  );
+  log("响应", data);
+  try {
+    assert(status === 200, `期望 200，实际 ${status}`);
+    ok(name);
+  } catch (e) {
+    fail(name, e.message);
+  }
+}
+
+async function testRestore(sessionId) {
+  const name = "恢复会话（预期 501）";
+  header(`${name} · POST ${api(`/sessions/${sessionId}/restore`)}`);
+  const { status, data } = await request(
+    "POST",
+    api(`/sessions/${sessionId}/restore`),
+  );
+  log("响应", data);
+  try {
+    assert(status === 501, `期望 501 not_supported，实际 ${status}`);
+    ok(name);
+  } catch (e) {
+    fail(name, e.message);
+  }
+}
+
+function countBy(items) {
+  return items.reduce(
+    (acc, item) => ((acc[item] = (acc[item] ?? 0) + 1), acc),
+    {},
+  );
+}
+
+// ---------- 汇总 ----------
+
+function summary() {
+  header("测试汇总");
+  const total = passed + failed;
+  console.log(`  总计 ${total} 项 · 通过 ${passed} · 失败 ${failed}`);
+  if (failures.length) {
+    console.log("\n  失败明细：");
+    for (const f of failures) {
+      console.log(
+        `    ✗ ${f.msg}${f.detail ? " — " + truncate(f.detail, 300) : ""}`,
+      );
+    }
+  }
+  console.log("\n" + "─".repeat(70));
+  process.exitCode = failed ? 1 : 0;
+}
+
+// ---------- 主流程 ----------
+
+async function main() {
+  header(`Agent API 接口测试`);
+  console.log(`  服务地址：${BASE_URL}`);
+  console.log(`  Agent code：${AGENT_CODE}`);
+  console.log(`  测试消息：${TEST_MESSAGE}`);
+
+  const sessionId = await testCreateSession();
+  if (!sessionId) {
+    summary();
+    return;
+  }
+
+  await testHealth();
+  await testCapability();
+  await testListSessions();
+  await testGetSession(sessionId);
+  await testSendMessage(sessionId);
+  await testListMessages(sessionId);
+  await testStatelessInvoke();
+  await testStream(sessionId);
+  await testArchive(sessionId);
+  await testRestore(sessionId);
+
+  summary();
+}
+
+main().catch((error) => {
+  console.error("测试脚本执行异常：", error);
+  process.exitCode = 1;
+});

package/dist/templates/agent-api-orchestration/scripts/build-runtime.mjs

@@ -8,10 +8,8 @@ const root = resolve(dirname(fileURLToPath(import.meta.url)), '..');
 // --dev 使用项目根的 .eap/runtime；生产构建使用 dist/.eap/runtime。
 const isDev = process.argv.includes('--dev');
 
-// dev 使用项目根 .env.local；构建使用项目根 .env.production，均回退 .env。
-config({
-  path: [resolve(root, isDev ? '.env.local' : '.env.production'), resolve(root, '.env')],
-});
+// 统一读取项目根 .env。
+config({ path: resolve(root, '.env') });
 
 // 生产输出目录必须位于 dist 下，便于与 dist/index.js 一起发布。
 const runtimeBase = isDev ? root : resolve(root, 'dist');

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

@@ -1,5 +1,6 @@
 import {
   createAgent,
+  resolveProjectRuntimeEnvironment,
   type Agent,
   type AgentCredentialProvider,
   type AgentResourceManager,
@@ -54,11 +55,22 @@ export async function createEmbeddedAgent(options: EmbeddedAgentOptions = {}): P
   };
   const deploymentRoot = resolve(runtimeRoot, '..', '..');
 
+  // 把 eap.config.json 里的 runtime.llm.models 映射成运行时识别的本地模型连接
+  // （EAP_LLM_MODE=local + EAP_LLM_CONNECTIONS）。漏掉这一步时，运行时会因为拿不到
+  // 本地网关而退回 EchoLLMProvider，表现为 [echo:model] 回显用户输入而非真实对话。
+  const projectRoot = resolve(entryDirectory, '..');
+  const runtimeEnvironment = resolveProjectRuntimeEnvironment({
+    root: projectRoot,
+    preinstallRoot: runtimeRoot,
+  }).environment;
+
   return createAgent({
     runtimeRoot,
     deploymentContext: isDev ? 'dev' : 'server',
     embeddedConfig,
     environment: {
+      ...runtimeEnvironment,
+      // 模板以物化 Runtime 目录为基准，覆盖 SDK 相对项目根算出的路径。
       EAP_DATA_DIR: resolve(runtimeRoot, '..'),
       EAP_CHECKPOINT_DIR: resolve(deploymentRoot, loadedRuntime.config.runtime.storage.checkpointDir),
     },

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

@@ -15,15 +15,8 @@ export type { ResourceApplyAndReloadResult } from './http/services/resource-serv
 // 入口文件的位置决定 Runtime 的相对路径，不依赖启动命令所在的当前目录。
 const entryDirectory = dirname(fileURLToPath(import.meta.url));
 const projectRoot = resolve(entryDirectory, '..');
-const isDev = process.argv.includes('--dev');
-
-// 开发态读取 .env.local，生产态读取 .env.production；两者都以 .env 作为最后的回退。
-config({
-  path: [
-    resolve(projectRoot, isDev ? '.env.local' : '.env.production'),
-    resolve(projectRoot, '.env'),
-  ],
-});
+// 统一读取项目根 .env。
+config({ path: resolve(projectRoot, '.env') });
 
 // 默认导出实例用于模板开发演示（npm run dev）；生产宿主应调用
 // createEmbeddedAgent({ credentialProvider })，显式注入凭证。