@faapi/faapi 5.3.0 → 6.0.0

package/dist/index.d.ts

@@ -419,15 +419,24 @@ interface AgentConfig {
      * 可见性过滤（authHooks）：LLM 可见 tools 清单组装完成后调用，
      * 返回过滤后的数组（含 agent-as-tool 项）。每次 agent.run / stream 生效——
      * 无权 tool 不进 LLM 视野，比执行时拒绝省一轮 LLM 调用。
+     *
+     * tools 为 OpenAI chat completions 规范形（`type: 'function'` +
+     * `function: { name, description?, parameters? }`），按 `tool.function.name` 过滤。
      */
     filterTools?: (tools: Array<{
-        name: string;
-        description?: string;
-        input: Record<string, unknown>;
+        type: 'function';
+        function: {
+            name: string;
+            description?: string;
+            parameters?: Record<string, unknown>;
+        };
     }>, ctx: FaapiContext | undefined) => Array<{
-        name: string;
-        description?: string;
-        input: Record<string, unknown>;
+        type: 'function';
+        function: {
+            name: string;
+            description?: string;
+            parameters?: Record<string, unknown>;
+        };
     }>;
 }
 /**
@@ -1368,6 +1377,17 @@ interface InjectOptions {
     path?: string;
     headers?: Record<string, string>;
     query?: Record<string, string>;
+    /**
+     * 请求体，语义按类型区分（与 fastify inject 约定一致）：
+     * - `string` / `Buffer` / `Uint8Array`：原样透传不二次编码（默认 content-type
+     *   分别为 `text/plain` / `application/octet-stream`）
+     * - 其他值（对象/数组等）：`JSON.stringify` 后发送，默认 content-type `application/json`
+     *
+     * 调用方显式传入的 `content-type` 头优先于默认值（string body +
+     * `application/x-www-form-urlencoded` 可直接测 form 表单路由）。
+     * 注意不要把 `JSON.stringify` 的结果当对象传——那会作为原始文本再被服务端
+     * JSON 解析一次，得到字符串而非对象。
+     */
     body?: unknown;
 }
 interface InjectResponse {

package/dist/index.js

@@ -5890,13 +5890,28 @@ async function createAppBase(options) {
           reject(new Error("No request handler found"));
           return;
         }
-        const mockReq = Readable3.from(body !== void 0 ? [Buffer.from(JSON.stringify(body))] : []);
+        let payload;
+        let defaultContentType;
+        if (body !== void 0) {
+          if (typeof body === "string") {
+            payload = Buffer.from(body, "utf-8");
+            defaultContentType = "text/plain";
+          } else if (body instanceof Uint8Array) {
+            payload = Buffer.from(body);
+            defaultContentType = "application/octet-stream";
+          } else {
+            payload = Buffer.from(JSON.stringify(body));
+            defaultContentType = "application/json";
+          }
+        }
+        const mockReq = Readable3.from(payload !== void 0 ? [payload] : []);
         mockReq.method = method;
         mockReq.url = `${reqPath}${queryStr}`;
+        const hasCallerContentType = "content-type" in reqHeaders || "Content-Type" in reqHeaders;
         mockReq.headers = {
           ...reqHeaders,
           host: "localhost",
-          "content-type": body !== void 0 ? "application/json" : void 0
+          ...payload !== void 0 && !hasCallerContentType ? { "content-type": defaultContentType } : {}
         };
         mockReq.socket = { remoteAddress: "127.0.0.1" };
         handler(