@faapi/faapi 6.22.0 → 6.23.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { F as FaapiMiddleware, A as AppRegistries, R as RouteManifest, a as FaapiContext, C as CorsOptions, T as TaskClient, H as HelmetOptions, L as LogConfig, I as InjectorMap, b as TaskFailedHandler, W as WsRouteManifest, c as TaskQueueDeps, d as TaskQueue, e as TaskDriver, f as TaskRegistry, g as TaskManifest, h as ToolMetadata, i as AgentCore, j as AgentMetadata, k as CreateLoggerOptions, l as Logger } from './routeTypes-CXWkRx4W.js';
-export { m as AgentHandleFactory, n as AgentHandleStore, o as AgentPathMeta, p as AgentRegistry, q as AgentToolDescriptor, r as FaapiContextConfig, s as FaapiTaskMeta, t as FailOptions, u as Injector, v as LogEntry, w as LogLevel, x as LogSink, y as RouteInfo, z as RouteInputSchema, B as RouteOutputSchema, D as RouteParamSchema, S as SkillRegistry, E as SseEvent, G as SseOptions, 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 } from './routeTypes-CXWkRx4W.js';
+import { F as FaapiMiddleware, A as AppRegistries, R as RouteManifest, a as FaapiContext, C as CorsOptions, T as TaskClient, H as HelmetOptions, L as LogConfig, I as InjectorMap, b as TaskFailedHandler, W as WsRouteManifest, c as TaskQueueDeps, d as TaskQueue, e as TaskDriver, f as TaskRegistry, g as TaskManifest, h as ToolMetadata, i as AgentCore, j as AgentMetadata, k as CreateLoggerOptions, l as Logger } from './routeTypes-CJV5M90s.js';
+export { m as AgentHandleFactory, n as AgentHandleStore, o as AgentPathMeta, p as AgentRegistry, q as AgentToolDescriptor, r as FaapiContextConfig, s as FaapiTaskMeta, t as FailOptions, u as Injector, v as LogEntry, w as LogLevel, x as LogSink, y as RouteInfo, z as RouteInputSchema, B as RouteOutputSchema, D as RouteParamSchema, S as SkillRegistry, E as SseEvent, G as SseOptions, 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 } from './routeTypes-CJV5M90s.js';
 import * as node_http from 'node:http';
 import { Server, IncomingMessage, ServerResponse } from 'node:http';
 import { Socket } from 'node:net';
@@ -251,6 +251,13 @@ interface TaskConfig {
 interface LifecycleContext {
     /** 项目根目录 */
     rootDir: string;
+    /**
+     * 运行时资源根目录绝对路径（<rootDir>/<dist>/resources）
+     *
+     * `src/resources/` 经 dev/build 复制进产物后的位置，onReady 中预加载
+     * prompt 模板等静态文件时定位用（`path.join(resourcesDir, 'prompts/foo.md')`）。
+     */
+    resourcesDir: string;
     /** 当前路由清单 */
     routes: RouteManifest;
     /** 服务器实例（onBoot 钩子触发时已创建但未监听，`listening === false`） */
@@ -843,6 +850,13 @@ interface WsContext {
     headers: Headers;
     /** 业务配置（来自 faapi.config.ts） */
     config: Record<string, unknown>;
+    /**
+     * 运行时资源根目录绝对路径（<rootDir>/<dist>/resources）
+     *
+     * 与 HTTP FaapiContext 同源（握手 ctx 是 FaapiContext 的结构子集），handler
+     * 的 WS 回调里读静态文件用。testing 直调未传时为 undefined。
+     */
+    resourcesDir?: string;
     /** 中间件塞入的用户信息（鉴权等） */
     user?: unknown;
     /** 允许通过 declare module 扩展 */
@@ -1681,6 +1695,21 @@ interface AppBase {
     wsRoutes: WsRouteManifest;
     /** 项目根目录 */
     rootDir: string;
+    /**
+     * 产物输出目录（相对 rootDir，如 '.faapi' 或 'dist'）
+     *
+     * 与 createAppBase 内部解析一致：`options.dist ?? FAAPI_DIST ?? 'dist'`。
+     * 业务方定位任意产物文件时与 rootDir 配合使用。
+     */
+    dist: string;
+    /**
+     * 运行时资源根目录绝对路径（<rootDir>/<dist>/resources）
+     *
+     * `src/resources/` 经 dev/build 复制进产物后的位置，业务方
+     * `path.join(app.resourcesDir, 'prompts/foo.md')` 后自行读取。
+     * 源码无 `src/resources/` 目录时路径仍指向约定位置（读文件由业务方容错）。
+     */
+    resourcesDir: string;
     /** 任务队列客户端（入队/查询；app 实例级，close 时随队列停机） */
     tasks: TaskClient;
     /** 启动 HTTP server，打印路由表，执行 onReady 钩子 */