@gt-fe/eap-cli 0.2.11 → 0.2.12

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

@@ -1,443 +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;
-});
+/**
+ * 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;
+});