@faapi/faapi 6.12.0 → 6.14.0

package/dist/{routeTypes-m9wZHWyo.d.ts → routeTypes-C7yHYxPg.d.ts}

@@ -86,6 +86,15 @@ interface AgentCore {
     model?: string;
     /** 最大对话轮数(config 块字面量提取),未声明时为 `undefined`;声明了但非数字字面量在构建期抛错 */
     maxTurns?: number;
+    /**
+     * agent-as-tool 派发交接单说明(config 块字面量提取),未声明时为 `undefined`;
+     * 声明了但非字面量在构建期抛错
+     *
+     * 该 agent 被其他 agent 当 tool 派发时(`agents` 列表引用),工具 `input` 字段的
+     * schema description——告诉主控 LLM 该传什么样的交接单;未声明时 `@faapi/agent`
+     * 的 `buildToolDefinitions` 用框架默认文案
+     */
+    inputDescription?: string;
 }
 /**
  * Agent 完整元数据(文件型 agent)
@@ -105,7 +114,7 @@ interface AgentCore {
  * - `name` — `@agent` JSDoc 覆盖值,或 `pathMeta.name`(目录推导)
  * - `filePath` / `hasRun` — 由 `pathMeta` 透传
  * - `description` — JSDoc 注释块自由文本(对 LLM 可见)
- * - `systemPrompt` / `tools` / `agents` / `model` / `maxTurns` — config 块字面量提取
+ * - `systemPrompt` / `tools` / `agents` / `model` / `maxTurns` / `inputDescription` — config 块字面量提取
  */
 interface AgentMetadata extends AgentCore {
     /** 源码相对路径(从 `pathMeta` 透传),`loadAgentModule` 据此加载 `handler.js` 提取 `run` */
@@ -752,7 +761,9 @@ type TaskFailedHandler = (info: TaskFailedInfo) => Promise<void> | void;
  *
  * 设计要点：
  * - writer 内部用 ReadableStream + TextEncoder，send 时 enqueue，close 时 close controller
- * - response 预设 text/event-stream、no-cache、keep-alive 头，状态码默认 200
+ * - response 预设 text/event-stream、no-cache、keep-alive、X-Accel-Buffering: no 头，状态码默认 200
+ *   （X-Accel-Buffering: no 让 nginx 按响应跳过 proxy_buffering，SSE 小包不被攒到流结束才下发；
+ *   非 nginx 反代不识别该头，当普通自定义头透传）
  * - close 后再 send 静默忽略，避免 handler 异步流程中误写已关闭的流
  * - sendError 向流写入 event: error 后关闭，用于流式输出中报错的优雅终止
  *

package/dist/testing.d.ts

@@ -1,4 +1,4 @@
-import { a as FaapiContext, F as FaapiMiddleware, I as InjectorMap, R as RouteManifest, W as WsRouteManifest, C as CorsOptions, H as HelmetOptions } from './routeTypes-m9wZHWyo.js';
+import { a as FaapiContext, F as FaapiMiddleware, I as InjectorMap, R as RouteManifest, W as WsRouteManifest, C as CorsOptions, H as HelmetOptions } from './routeTypes-C7yHYxPg.js';
 import { Server } from 'node:http';
 import { WebSocket } from 'ws';
 

package/dist/testing.js

@@ -123,7 +123,9 @@ function createSseWriter() {
     headers: {
       "Content-Type": "text/event-stream",
       "Cache-Control": "no-cache",
-      Connection: "keep-alive"
+      Connection: "keep-alive",
+      // nginx 认到该头后按响应跳过 proxy_buffering；其他反代/客户端忽略，无副作用
+      "X-Accel-Buffering": "no"
     }
   });
   const writer = {