@cloudbase/agent-server 0.0.13 → 1.0.1-alpha.7

package/dist/index.d.ts

@@ -4,8 +4,7 @@ import expressLib, { Express } from 'express';
 import * as _ag_ui_client from '@ag-ui/client';
 import { AbstractAgent, RunAgentInput } from '@ag-ui/client';
 import cors from 'cors';
-import { Logger, SendMessageInput } from '@cloudbase/agent-shared';
-export { LogFn, Logger, createConsoleLogger, noopLogger } from '@cloudbase/agent-shared';
+import { SendMessageInput } from '@cloudbase/agent-shared';
 import { Repeater } from '@repeaterjs/repeater';
 import * as _whatwg_node_server from '@whatwg-node/server';
 import { OpenAI } from 'openai';
@@ -17,10 +16,6 @@ import { OpenAI } from 'openai';
 interface AgentCreatorContext {
     /** The incoming HTTP request (Web Standard Request) */
     request: Request;
-    /** Logger instance for this request (with requestId context). Only available when using AGUI routes. */
-    logger?: Logger;
-    /** Unique request ID for tracing. Only available when using AGUI routes. */
-    requestId?: string;
 }
 type AgentCreatorRet = {
     agent: AbstractAgent | {
@@ -39,20 +34,6 @@ interface ICreateServer {
     cors?: boolean | cors.CorsOptions;
     useAGUI?: boolean;
     aguiOptions?: AGUIOptions;
-    /**
-     * Logger instance for structured logging.
-     *
-     * @default noopLogger (silent - no output)
-     *
-     * @example
-     * // Development: see all logs
-     * createExpressServer({ createAgent, logger: console });
-     *
-     * // Production: structured JSON logs
-     * import pino from 'pino';
-     * createExpressServer({ createAgent, logger: pino({ level: 'info' }) });
-     */
-    logger?: Logger;
 }
 interface IRun extends ICreateServer {
     port?: number | string;
@@ -62,7 +43,7 @@ interface ICreateExpressRoutes extends Omit<ICreateServer, "cors"> {
 }
 declare function run(props: IRun): void;
 declare function createExpressServer(props: ICreateServer): Express;
-declare function createExpressRoutes({ createAgent, basePath: _basePath, express, useAGUI: _useAGUI, aguiOptions, logger: _logger, }: ICreateExpressRoutes): expressLib.Express;
+declare function createExpressRoutes({ createAgent, basePath: _basePath, express, useAGUI: _useAGUI, aguiOptions, }: ICreateExpressRoutes): expressLib.Express;
 interface AGUIOptions {
     runtimeOptions?: Partial<CopilotRuntimeOptions>;
     endpointOptions?: Partial<CreateCopilotRuntimeServerOptions>;
@@ -105,21 +86,10 @@ declare function handler$1(input: RunAgentInput, agent: AbstractAgent): Repeater
     rawEvent?: any;
 }, any, unknown>;
 
-/**
- * Options for createServerAdapter
- */
-interface CreateServerAdapterOptions {
-    /**
-     * Logger instance for structured logging.
-     * @default noopLogger (silent)
-     */
-    logger?: Logger;
-}
-declare function createServerAdapter$1(createAgent: AgentCreator, options?: CreateServerAdapterOptions): _whatwg_node_server.ServerAdapter<{}, _whatwg_node_server.ServerAdapterBaseObject<{}, (request: Request) => Promise<Response>>>;
+declare function createServerAdapter$1(createAgent: AgentCreator): _whatwg_node_server.ServerAdapter<{}, _whatwg_node_server.ServerAdapterBaseObject<{}, (request: Request) => Promise<Response>>>;
 
-type index$3_CreateServerAdapterOptions = CreateServerAdapterOptions;
 declare namespace index$3 {
-  export { type index$3_CreateServerAdapterOptions as CreateServerAdapterOptions, createServerAdapter$1 as createServerAdapter, handler$1 as handler };
+  export { createServerAdapter$1 as createServerAdapter, handler$1 as handler };
 }
 
 declare const serverAdapter: _whatwg_node_server.ServerAdapter<{}, _whatwg_node_server.ServerAdapterBaseObject<{}, () => Response>>;
@@ -149,43 +119,4 @@ declare namespace index {
   export { index$2 as healthz, index$1 as openai, index$4 as sendMessage, index$3 as sendMessageAGUI };
 }
 
-/**
- * Generates a unique request ID for tracing.
- *
- * The request ID is used to:
- * 1. Correlate all logs from a single request
- * 2. Include in error responses for debugging
- * 3. Trace requests across distributed systems
- *
- * @param prefix - Optional prefix for the request ID (default: 'req')
- * @returns A unique request ID string
- *
- * @example
- * generateRequestId() // => 'req-a1b2c3d4-e5f6-7890-abcd-ef1234567890'
- * generateRequestId('agui') // => 'agui-a1b2c3d4-e5f6-7890-abcd-ef1234567890'
- */
-declare function generateRequestId(prefix?: string): string;
-/**
- * Extracts request ID from incoming request headers.
- * Supports common request ID header conventions.
- *
- * Header priority (first found wins):
- * 1. x-request-id
- * 2. x-correlation-id
- * 3. x-trace-id
- *
- * @param headers - Request headers (Headers object or plain object)
- * @returns The request ID from headers, or undefined if not found
- */
-declare function extractRequestId(headers: Headers | Record<string, string | string[] | undefined>): string | undefined;
-/**
- * Gets or generates a request ID.
- * First tries to extract from headers, then generates a new one.
- *
- * @param headers - Request headers
- * @param prefix - Prefix for generated IDs (default: 'req')
- * @returns Request ID (either extracted or generated)
- */
-declare function getOrGenerateRequestId(headers: Headers | Record<string, string | string[] | undefined>, prefix?: string): string;
-
-export { type AgentCreator, type AgentCreatorContext, index as agui, createExpressRoutes, createExpressServer, extractRequestId, generateRequestId, getOrGenerateRequestId, run };
+export { type AgentCreator, type AgentCreatorContext, index as agui, createExpressRoutes, createExpressServer, run };

package/dist/index.js

@@ -30,13 +30,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   agui: () => agui_exports,
-  createConsoleLogger: () => import_agent_shared2.createConsoleLogger,
   createExpressRoutes: () => createExpressRoutes,
   createExpressServer: () => createExpressServer,
-  extractRequestId: () => extractRequestId,
-  generateRequestId: () => generateRequestId,
-  getOrGenerateRequestId: () => getOrGenerateRequestId,
-  noopLogger: () => import_agent_shared2.noopLogger,
   run: () => run
 });
 module.exports = __toCommonJS(index_exports);
@@ -236,46 +231,9 @@ function handler2(input, agent) {
 // src/agui/sendMessageAGUI/server.ts
 var import_server3 = require("@whatwg-node/server");
 var import_client2 = require("@ag-ui/client");
-var import_uuid3 = require("uuid");
-
-// src/logger/index.ts
-var import_agent_shared2 = require("@cloudbase/agent-shared");
-
-// src/logger/request-id.ts
 var import_uuid2 = require("uuid");
-function generateRequestId(prefix = "req") {
-  return `${prefix}-${(0, import_uuid2.v4)()}`;
-}
-function extractRequestId(headers) {
-  const headerNames = ["x-request-id", "x-correlation-id", "x-trace-id"];
-  for (const name of headerNames) {
-    let value;
-    if (headers instanceof Headers) {
-      value = headers.get(name) || void 0;
-    } else {
-      const raw = headers[name];
-      value = Array.isArray(raw) ? raw[0] : raw;
-    }
-    if (value) {
-      return value;
-    }
-  }
-  return void 0;
-}
-function getOrGenerateRequestId(headers, prefix = "req") {
-  return extractRequestId(headers) || generateRequestId(prefix);
-}
-
-// src/agui/sendMessageAGUI/server.ts
-function createServerAdapter2(createAgent, options) {
-  var _a;
-  const { logger: parentLogger = import_agent_shared2.noopLogger } = options ?? {};
-  const adapterLogger = ((_a = parentLogger.child) == null ? void 0 : _a.call(parentLogger, { component: "sendMessageAGUI" })) ?? parentLogger;
+function createServerAdapter2(createAgent) {
   return (0, import_server3.createServerAdapter)(async (request) => {
-    var _a2, _b, _c, _d, _e, _f, _g, _h;
-    const requestId = getOrGenerateRequestId(request.headers, "agui");
-    const logger = ((_a2 = adapterLogger.child) == null ? void 0 : _a2.call(adapterLogger, { requestId })) ?? adapterLogger;
-    (_b = logger.info) == null ? void 0 : _b.call(logger, "Request received");
     const inputRes = await safeAsync(async () => {
       const rawInput = await request.json();
       const inputWithDefaults = {
@@ -284,21 +242,16 @@ function createServerAdapter2(createAgent, options) {
         state: {},
         forwardedProps: {},
         ...rawInput,
-        runId: typeof rawInput.runId === "string" && rawInput.runId ? rawInput.runId : (0, import_uuid3.v4)()
+        runId: typeof rawInput.runId === "string" && rawInput.runId ? rawInput.runId : (0, import_uuid2.v4)()
       };
       return import_client2.RunAgentInputSchema.parse(inputWithDefaults);
     });
     if ("error" in inputRes) {
       const { error } = inputRes;
-      (_c = logger.warn) == null ? void 0 : _c.call(
-        logger,
-        { err: error instanceof Error ? error.message : String(error) },
-        "Input validation failed"
-      );
+      console.error("[AGUI Server] Pre-stream error:", error);
       return new Response(
         JSON.stringify({
-          error: error instanceof Error ? error.message : String(error),
-          requestId
+          error: error instanceof Error ? error.message : String(error)
         }),
         {
           status: 400,
@@ -306,25 +259,8 @@ function createServerAdapter2(createAgent, options) {
         }
       );
     }
-    const input = inputRes.result;
-    const lastUserMessage = input.messages.filter((m) => m.role === "user").pop();
-    (_f = logger.debug) == null ? void 0 : _f.call(
-      logger,
-      {
-        runId: input.runId,
-        threadId: input.threadId,
-        messageCount: input.messages.length,
-        toolCount: ((_d = input.tools) == null ? void 0 : _d.length) ?? 0,
-        tools: (_e = input.tools) == null ? void 0 : _e.map((t) => t.name),
-        lastUserMessage: typeof (lastUserMessage == null ? void 0 : lastUserMessage.content) === "string" ? lastUserMessage.content.slice(0, 200) : void 0
-      },
-      "Input validated"
-    );
-    (_g = logger.trace) == null ? void 0 : _g.call(logger, { input }, "Full request input");
     const createAgentRes = await safeAsync(async () => {
-      const res = await Promise.resolve(
-        createAgent({ request, logger, requestId })
-      );
+      const res = await Promise.resolve(createAgent({ request }));
       return {
         cleanup: res.cleanup,
         agent: "toAGUIAgent" in res.agent ? res.agent.toAGUIAgent() : res.agent
@@ -332,11 +268,10 @@ function createServerAdapter2(createAgent, options) {
     });
     if ("error" in createAgentRes) {
       const { error } = createAgentRes;
-      (_h = logger.error) == null ? void 0 : _h.call(logger, { err: error }, "Agent creation failed");
+      console.error("[AGUI Server] Pre-stream error:", error);
       return new Response(
         JSON.stringify({
-          error: error instanceof Error ? error.message : String(error),
-          requestId
+          error: error instanceof Error ? error.message : String(error)
         }),
         {
           status: 500,
@@ -348,41 +283,31 @@ function createServerAdapter2(createAgent, options) {
     let heartbeat;
     let cleanupCalled = false;
     const safeCleanup = () => {
-      var _a3, _b2, _c2;
+      var _a, _b;
       if (!cleanupCalled) {
         cleanupCalled = true;
         try {
-          (_b2 = (_a3 = createAgentRes.result).cleanup) == null ? void 0 : _b2.call(_a3);
+          (_b = (_a = createAgentRes.result).cleanup) == null ? void 0 : _b.call(_a);
         } catch (e) {
-          (_c2 = logger.error) == null ? void 0 : _c2.call(logger, { err: e }, "Cleanup error");
+          console.error(e);
         }
       }
     };
     const stream = new ReadableStream({
       async start(controller) {
-        var _a3, _b2, _c2, _d2;
         const encoder = new TextEncoder();
         heartbeat = setInterval(() => {
           controller.enqueue(encoder.encode(":ping\n\n"));
         }, 15 * 1e3);
-        let eventCount = 0;
         try {
           for await (const event of events) {
-            eventCount++;
-            (_a3 = logger.debug) == null ? void 0 : _a3.call(
-              logger,
-              { eventType: event.type, eventCount },
-              "Emitting SSE event"
-            );
-            (_b2 = logger.trace) == null ? void 0 : _b2.call(logger, { aguiEvent: event }, "SSE event content");
             const sseChunk = `data: ${JSON.stringify(event)}
 
 `;
             controller.enqueue(encoder.encode(sseChunk));
           }
-          (_c2 = logger.info) == null ? void 0 : _c2.call(logger, { eventCount }, "Request completed");
         } catch (error) {
-          (_d2 = logger.error) == null ? void 0 : _d2.call(logger, { err: error }, "Stream error");
+          console.error("[AGUI Server] Stream error:", error);
           const errorEvent = {
             type: import_client2.EventType.RUN_ERROR,
             message: error instanceof Error ? error.message : String(error)
@@ -399,8 +324,6 @@ function createServerAdapter2(createAgent, options) {
         }
       },
       cancel() {
-        var _a3;
-        (_a3 = logger.info) == null ? void 0 : _a3.call(logger, "Request cancelled by client");
         if (heartbeat) clearInterval(heartbeat);
         safeCleanup();
       }
@@ -439,7 +362,7 @@ __export(openai_exports, {
 });
 
 // src/agui/openai/handler.ts
-var import_uuid4 = require("uuid");
+var import_uuid3 = require("uuid");
 var import_repeater3 = require("@repeaterjs/repeater");
 function handler3(input, agent) {
   var _a;
@@ -451,12 +374,12 @@ function handler3(input, agent) {
         description: tool.function.description,
         parameters: tool.function.parameters
       })),
-      conversationId: (0, import_uuid4.v4)()
+      conversationId: (0, import_uuid3.v4)()
     },
     agent
   );
   return new import_repeater3.Repeater(async (push, stop) => {
-    const id = (0, import_uuid4.v4)();
+    const id = (0, import_uuid3.v4)();
     let tools = [];
     let lastWithToolCall = false;
     let maxIndex = 0;
@@ -653,22 +576,16 @@ function createExpressRoutes({
   basePath: _basePath,
   express,
   useAGUI: _useAGUI,
-  aguiOptions,
-  logger: _logger
+  aguiOptions
 }) {
-  var _a, _b, _c;
   const useAGUI = _useAGUI ?? true;
-  const logger = _logger ?? import_agent_shared2.noopLogger;
   const basePath = _basePath ?? (process.env.TENCENTCLOUD_RUNENV === "SCF" ? "/v1/aibot/bots/:agentId/" : "/");
-  const serverLogger = ((_a = logger.child) == null ? void 0 : _a.call(logger, { component: "server" })) ?? logger;
-  (_b = serverLogger.debug) == null ? void 0 : _b.call(serverLogger, { basePath, useAGUI }, "Initializing server routes");
-  const sendMessageServerAdapter = useAGUI ? sendMessageAGUI_exports.createServerAdapter(createAgent, { logger: serverLogger }) : sendMessage_exports.createServerAdapter(createAgent);
+  const sendMessageServerAdapter = useAGUI ? sendMessageAGUI_exports.createServerAdapter(createAgent) : sendMessage_exports.createServerAdapter(createAgent);
   if (useAGUI) {
     createAGUIRoute({
       basePath,
       express,
       createAgent,
-      logger: serverLogger,
       ...aguiOptions || {}
     });
   }
@@ -677,7 +594,6 @@ function createExpressRoutes({
   express.use(`${basePath}send-message`, sendMessageServerAdapter);
   express.use(`${basePath}healthz`, healthzServerAdapter);
   express.use(`${basePath}chat/completions`, openaiServerAdapter);
-  (_c = serverLogger.info) == null ? void 0 : _c.call(serverLogger, { basePath }, "Server routes initialized");
   return express;
 }
 var AGUIRpcHandlerPromise = null;
@@ -686,13 +602,11 @@ function getAGUIRpcHandler({
   runtimeOptions,
   basePath,
   endpointOptions,
-  request,
-  logger,
-  requestId
+  request
 }) {
   if (AGUIRpcHandlerPromise) return AGUIRpcHandlerPromise;
   AGUIRpcHandlerPromise = (async () => {
-    const { agent } = await createAgent({ request, logger, requestId });
+    const { agent } = await createAgent({ request });
     const templateAgent = "toAGUIAgent" in agent ? agent.toAGUIAgent() : agent;
     templateAgent.clone = agentCloneFn;
     const runtime = new import_runtime.CopilotRuntime({
@@ -715,21 +629,12 @@ function createAGUIRoute({
   basePath,
   createAgent,
   runtimeOptions,
-  endpointOptions,
-  logger
+  endpointOptions
 }) {
-  var _a;
-  const routeLogger = ((_a = logger.child) == null ? void 0 : _a.call(logger, { component: "agui-route" })) ?? logger;
   express.post(`${basePath}agui`, import_express.default.json(), async (req, res) => {
-    var _a2, _b;
     const webRequest = (0, import_server8.normalizeNodeRequest)(req, DefaultFetchAPI);
-    const requestId = getOrGenerateRequestId(webRequest.headers, "agui");
-    const requestLogger = ((_a2 = routeLogger.child) == null ? void 0 : _a2.call(routeLogger, { requestId })) ?? routeLogger;
-    (_b = requestLogger.info) == null ? void 0 : _b.call(requestLogger, { path: `${basePath}agui` }, "Request received");
     const { agent: rawAgent, cleanup } = await createAgent({
-      request: webRequest,
-      logger: requestLogger,
-      requestId
+      request: webRequest
     });
     const preparedAgent = "toAGUIAgent" in rawAgent ? rawAgent.toAGUIAgent() : rawAgent;
     preparedAgent.clone = agentCloneFn;
@@ -738,9 +643,7 @@ function createAGUIRoute({
       basePath,
       runtimeOptions,
       endpointOptions,
-      request: webRequest,
-      logger: requestLogger,
-      requestId
+      request: webRequest
     });
     preparedAgentStorage.run(preparedAgent, () => {
       rpcHandler(req, res);
@@ -756,12 +659,7 @@ function isCorsOptions(cors2) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   agui,
-  createConsoleLogger,
   createExpressRoutes,
   createExpressServer,
-  extractRequestId,
-  generateRequestId,
-  getOrGenerateRequestId,
-  noopLogger,
   run
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudbase/agent-server",
-  "version": "0.0.13",
+  "version": "1.0.1-alpha.7",
   "main": "dist/index.js",
   "files": [
     "dist/",
@@ -21,7 +21,7 @@
     "openai": "6.3.0",
     "uuid": "^10.0.0",
     "zod": "^4.1.12",
-    "@cloudbase/agent-shared": "^0.0.13"
+    "@cloudbase/agent-shared": "^1.0.1-alpha.7"
   },
   "devDependencies": {
     "@types/cors": "^2.8.19",

package/README.md

@@ -1,253 +0,0 @@
-# @cloudbase/agent-server
-
-将 AG-UI 兼容的 Agent 部署为 HTTP 服务。
-
-## 什么是 AG-UI？
-
-[AG-UI](https://ag-ui.com/) 是一个开放、轻量级、基于事件的协议，用于标准化 AI Agent 与用户界面的交互。它让 Agent 可以：
-
-- 实时流式对话
-- 双向状态同步
-- 前端工具集成（Client Tools）
-- 人机协作（Human-in-the-loop）
-
-## 这个包解决什么问题？
-
-- **快速部署 Agent 为 HTTP 服务**：一行代码将 Agent 部署为支持 AG-UI 协议的 HTTP 服务
-- **多端点支持**：自动创建 `/send-message`、`/healthz` 等端点
-- **云函数兼容**：自动适配腾讯云开发 HTTP 云函数环境
-
-### 架构图
-
-```mermaid
-flowchart LR
-    Client[AG-UI 客户端] -->|AG-UI 协议| Server["@cloudbase/agent-server"]
-    Server --> Adapter[Adapter<br/>LangGraph / LangChain]
-    Adapter --> Agent[Agent 框架]
-```
-
-## 配合使用
-
-| 包名 | 作用 |
-|------|------|
-| `@cloudbase/agent-adapter-langgraph` | LangGraph 工作流适配器 |
-| `@cloudbase/agent-adapter-langchain` | LangChain Agent 适配器 |
-| `express` | HTTP 服务框架 |
-
-## 安装
-
-```bash
-pnpm add @cloudbase/agent-server express
-```
-
-## 快速开始
-
-### 方式一：使用 run（最简单）
-
-```typescript
-import { run } from "@cloudbase/agent-server";
-import { LanggraphAgent } from "@cloudbase/agent-adapter-langgraph";
-import { workflow } from "./workflow.js"; // 你的 LangGraph 工作流
-
-run({
-  createAgent: () => ({
-    agent: new LanggraphAgent({ workflow }),
-  }),
-  port: 9000,
-});
-```
-
-### 方式二：使用 createExpressServer
-
-创建一个配置好的 Express 应用：
-
-```typescript
-import { createExpressServer } from "@cloudbase/agent-server";
-import { LanggraphAgent } from "@cloudbase/agent-adapter-langgraph";
-import { workflow } from "./workflow.js";
-
-const app = createExpressServer({
-  createAgent: () => ({
-    agent: new LanggraphAgent({ workflow }),
-  }),
-});
-
-app.listen(9000, () => console.log("Listening on 9000!"));
-```
-
-### 方式三：使用 createExpressRoutes
-
-将路由挂载到现有的 Express 应用：
-
-```typescript
-import { createExpressRoutes } from "@cloudbase/agent-server";
-import { LanggraphAgent } from "@cloudbase/agent-adapter-langgraph";
-import { workflow } from "./workflow.js";
-import express from "express";
-
-const app = express();
-
-createExpressRoutes({
-  createAgent: () => ({
-    agent: new LanggraphAgent({ workflow }),
-  }),
-  express: app,
-});
-
-app.listen(9000, () => console.log("Listening on 9000!"));
-```
-
-## API 参考
-
-### run
-
-创建并启动 HTTP 服务。
-
-```typescript
-run({
-  createAgent,
-  port: 9000,
-});
-```
-
-**参数：**
-
-| 参数 | 类型 | 说明 |
-|------|------|------|
-| `createAgent` | `AgentCreator` | Agent 创建函数，见下方说明 |
-| `port` | `number \| string` | 监听端口 |
-| `basePath` | `string` | 可选，路由基础路径，默认为 `/`，云函数环境默认为 `/v1/aibot/bots/:agentId/` |
-| `cors` | `boolean \| CorsOptions` | 可选，CORS 配置，默认启用 |
-| `logger` | `Logger` | 可选，日志实例，用于记录服务端日志 |
-
-### createExpressServer
-
-创建一个配置好的 Express 应用。
-
-```typescript
-const app = createExpressServer({
-  createAgent,
-  cors: true,       // 可选，默认启用 CORS
-});
-```
-
-**参数：**
-
-| 参数 | 类型 | 说明 |
-|------|------|------|
-| `createAgent` | `AgentCreator` | Agent 创建函数，见下方说明 |
-| `basePath` | `string` | 可选，路由基础路径 |
-| `cors` | `boolean \| CorsOptions` | 可选，CORS 配置，默认启用 |
-| `logger` | `Logger` | 可选，日志实例，用于记录服务端日志 |
-
-### createExpressRoutes
-
-将 AG-UI 路由挂载到现有的 Express 应用。
-
-```typescript
-createExpressRoutes({
-  createAgent,
-  express: app,
-  basePath,         // 可选
-});
-```
-
-**参数：**
-
-| 参数 | 类型 | 说明 |
-|------|------|------|
-| `createAgent` | `AgentCreator` | Agent 创建函数，见下方说明 |
-| `express` | `Express` | Express 应用实例 |
-| `basePath` | `string` | 可选，路由基础路径，默认为 `/`，云函数环境默认为 `/v1/aibot/bots/:agentId/` |
-| `logger` | `Logger` | 可选，日志实例，用于记录服务端日志 |
-
-## 自动创建的端点
-
-| 端点 | 说明 |
-|------|------|
-| `{basePath}send-message` | AG-UI 消息发送端点 |
-| `{basePath}healthz` | 健康检查端点 |
-
-## createAgent 参数
-
-`createAgent` 返回一个对象：
-- `agent`：符合 [AG-UI 协议](https://docs.ag-ui.com) 的 Agent
-- `cleanup`：可选，请求结束后的清理函数
-
-```typescript
-type AgentCreator = (context?: {
-  request: Request;     // 当前 HTTP 请求（Web Standard Request）
-  logger?: Logger;      // 日志实例（带 requestId 上下文）
-  requestId?: string;   // 请求追踪 ID
-}) => AgentCreatorResult | Promise<AgentCreatorResult>; // 支持异步
-
-type AgentCreatorResult = {
-  agent: AbstractAgent | { toAGUIAgent(): AbstractAgent }; // AG-UI 兼容的 Agent
-  cleanup?: () => void; // 可选，清理函数
-};
-```
-
-使用适配器将你的 Agent 框架转换为 AG-UI 兼容的 Agent：
-
-| 适配器 | 包名 | 说明 |
-|--------|------|------|
-| `LanggraphAgent` | `@cloudbase/agent-adapter-langgraph` | LangGraph 工作流适配器 |
-| `LangchainAgent` | `@cloudbase/agent-adapter-langchain` | LangChain Agent 适配器 |
-
-```typescript
-import { LanggraphAgent } from "@cloudbase/agent-adapter-langgraph";
-
-createAgent: () => ({
-  agent: new LanggraphAgent({ workflow }),
-})
-```
-
-**高级用法：** `createAgent` 可以接收请求上下文，也支持异步：
-
-```typescript
-createAgent: async (context) => {
-  console.log("Request ID:", context.requestId);
-  return { agent: new LanggraphAgent({ workflow }) };
-}
-```
-
-## Logger
-
-`logger` 参数用于记录服务端日志。需要实现以下接口：
-
-```typescript
-interface Logger {
-  info?(message: string): void;
-  info?(obj: object, message?: string): void;
-  debug?(message: string): void;
-  debug?(obj: object, message?: string): void;
-  warn?(message: string): void;
-  warn?(obj: object, message?: string): void;
-  error?(message: string): void;
-  error?(obj: object, message?: string): void;
-  trace?(message: string): void;
-  trace?(obj: object, message?: string): void;
-  child?(bindings: object): Logger; // 创建带上下文的子 logger
-}
-```
-
-**示例：**
-
-```typescript
-// 开发环境：使用 console
-run({ createAgent, logger: console, port: 9000 });
-
-// 生产环境：使用 pino
-import pino from "pino";
-run({ createAgent, logger: pino({ level: "info" }), port: 9000 });
-```
-
-## 文档
-
-📚 完整文档请参阅 [云开发 Agent 开发指南](https://docs.cloudbase.net/ai/agent-development/)
-
-## 相关资源
-
-- [AG-UI 协议](https://docs.cloudbase.net/ai/agent-development/ag-ui-protocol)
-- [框架开发指南](https://docs.cloudbase.net/ai/agent-development/frameworks/)
-- [部署指南](https://docs.cloudbase.net/ai/agent-development/deploy/)