@faapi/faapi 6.8.0 → 6.9.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { A as AppRegistries, R as RouteManifest, F as FaapiContext, C as CorsOptions, T as TaskClient, H as HelmetOptions, L as LoggerOptions, a as LogConfig, b as FaapiMiddleware, I as InjectorMap, c as TaskFailedHandler, d as TaskQueueDeps, e as TaskQueue, f as TaskDriver, g as TaskRegistry, h as TaskManifest, i as ToolMetadata, j as AgentCore, k as AgentMetadata, l as CreateLoggerOptions, m as Logger, W as WsRouteManifest } from './routeTypes-J5pPbjwR.js';
-export { n as AgentHandleFactory, o as AgentHandleStore, p as AgentPathMeta, q as AgentRegistry, r as AgentToolDescriptor, s as FaapiContextConfig, t as FaapiTaskMeta, u as FailOptions, v as Injector, w as LogEntry, x as LogLevel, y as LogSink, z as RouteInfo, B as RouteInputSchema, D as RouteOutputSchema, E as RouteParamSchema, S as SkillRegistry, G as SseEvent, J as SseWriter, K as TaskContext, M as TaskDriverJob, N as TaskDriverProcess, O as TaskDriverRecord, P as TaskFailedInfo, Q as TaskJob, U as TaskJobStatus, V as TaskMetadata, X as TaskModule, Y as TaskRegistriesSnapshot, Z as TaskRegistriesView, _ as ToolCore, $ as ToolPathMeta, a0 as ToolRegistry, a1 as cors, a2 as createAppRegistries, a3 as createTaskRegistriesView, a4 as createTaskRegistry, a5 as helmet, a6 as logger } from './routeTypes-J5pPbjwR.js';
+import { A as AppRegistries, R as RouteManifest, F as FaapiContext, C as CorsOptions, T as TaskClient, H as HelmetOptions, L as LoggerOptions, a as LogConfig, b as FaapiMiddleware, I as InjectorMap, c as TaskFailedHandler, d as TaskQueueDeps, e as TaskQueue, f as TaskDriver, g as TaskRegistry, h as TaskManifest, i as ToolMetadata, j as AgentCore, k as AgentMetadata, l as CreateLoggerOptions, m as Logger, W as WsRouteManifest } from './routeTypes-CuGMDCGB.js';
+export { n as AgentHandleFactory, o as AgentHandleStore, p as AgentPathMeta, q as AgentRegistry, r as AgentToolDescriptor, s as FaapiContextConfig, t as FaapiTaskMeta, u as FailOptions, v as Injector, w as LogEntry, x as LogLevel, y as LogSink, z as RouteInfo, B as RouteInputSchema, D as RouteOutputSchema, E as RouteParamSchema, S as SkillRegistry, G as SseEvent, J as SseWriter, K as TaskContext, M as TaskDriverJob, N as TaskDriverProcess, O as TaskDriverRecord, P as TaskFailedInfo, Q as TaskJob, U as TaskJobStatus, V as TaskMetadata, X as TaskModule, Y as TaskRegistriesSnapshot, Z as TaskRegistriesView, _ as ToolCore, $ as ToolPathMeta, a0 as ToolRegistry, a1 as cors, a2 as createAppRegistries, a3 as createTaskRegistriesView, a4 as createTaskRegistry, a5 as helmet, a6 as logger } from './routeTypes-CuGMDCGB.js';
 import * as node_http from 'node:http';
 import { Server, IncomingMessage, ServerResponse } from 'node:http';
 import { Socket } from 'node:net';
@@ -553,20 +553,26 @@ interface FaapiConfig {
     /** 日志中间件配置 */
     logger?: LoggerOptions | boolean;
     /**
-     * 业务日志器全局配置（与 `logger` 请求日志中间件是两条独立管道，详见 logger/logger.md）
+     * 业务日志器全局配置（详见 logger/logger.md）
      *
-     * - `false`：完全静默（含 error，测试降噪）
+     * - `false`：完全静默（含 error，测试降噪；不影响请求日志，关闭用 `logger: false`）
      * - `true` / 缺省：默认级别（显式 level > LOG_LEVEL env > 'info'）+ console 文本输出
-     * - `LogConfig`：精细配置 level 与 sink（sink 可整体接管接 pino/winston/文件）
+     * - `LogConfig`：精细配置——`sink` 自定义管道（接 pino/winston）或 `dir` egg 风格
+     *   文件输出（app.log 全量 + error.log 仅 error，splitByLevel 按级别四文件），
+     *   两者互斥；`dir` 模式请求日志自动并入（`accessLog` 缺省 true），未显式配置
+     *   level 时不过滤（全量落盘）
      *
-     * 生效范围：`ctx.log` / 参数注入 `log` / `createLogger` / `taskCtx.log`。
+     * 生效范围：`ctx.log` / 参数注入 `log` / `createLogger` / `taskCtx.log`，
+     * `dir`/`accessLog` 模式下含请求日志中间件。
      * 日志全局配置是进程级资源，多 app 同进程时后启动覆盖先启动。
      *
      * ```ts
      * export default {
      *   log: {
-     *     level: 'debug',
-     *     sink: (entry) => pinoLogger[entry.level]({ scope: entry.scope, ...entry.fields }, entry.message),
+     *     // 方式一：egg 风格文件输出（请求日志自动并入）
+     *     dir: 'logs',
+     *     // 方式二：自定义管道接管
+     *     // sink: (entry) => pinoLogger[entry.level]({ scope: entry.scope, ...entry.fields }, entry.message),
      *   },
      * } satisfies FaapiConfig;
      * ```
@@ -1490,12 +1496,13 @@ declare function loadEnv(rootDir: string): void;
  * 设置全局日志配置（进程级，`createAppBase` 启动时以 `config.log` 调用）
  *
  * - `false`：完全静默（含 error，测试降噪场景）
- * - `true` / `{}`：默认级别（显式 level > LOG_LEVEL env > 'info'）+ 默认 console sink
- * - `{ level, sink }`：精细配置；非法 level 抛错（启动期 fail fast）
+ * - `true` / `{}`：默认级别（显式 level > LOG_LEVEL env > 模式默认）+ 默认 console sink
+ * - `{ level, sink }`：自定义管道接管（与 dir 互斥，同时配置抛错）
+ * - `{ dir, splitByLevel?, stdout?, accessLog? }`：egg 风格文件输出（fileSink.md）
  * - `undefined`：重置为默认（编程式多 app 切换全局配置用）
  *
  * LOG_LEVEL env 仅在本函数读取——app 启动路径必经此处（env 非法在启动期报错）；
- * 纯编程式不调本函数时 env 不生效（默认 info）。
+ * 纯编程式不调本函数时 env 不生效。
  */
 declare function configureLogging(config?: LogConfig | boolean | undefined): void;
 /**