@tachu/extensions 1.0.0-alpha.6 → 1.0.0-rc.0

package/dist/tools/web-fetch/types.js

@@ -1,7 +1,7 @@
 /**
  * Web Fetch 工具与 `/v1/extract` 共享的类型（客户端本地复刻，不依赖 `@tachu/web-fetch-server`）。
  *
- * @see docs/adr/decisions/0003b-web-fetch-types.md
+ * @see packages/web-fetch-server/src/0003b-web-fetch-types.md
  */
 export {};
 //# sourceMappingURL=types.js.map

package/dist/tools/web-search/errors.d.ts

@@ -3,7 +3,7 @@ import type { ErrorResponseBody } from "../web-fetch/types";
 /**
  * `web-search` 工具在客户端抛出的错误类型（语义上与 {@link ../web-fetch/errors.WebFetchClientError} 一致）。
  *
- * @see docs/adr/decisions/0003d-web-fetch-errors.md §2.2 / §4
+ * @see packages/web-fetch-server/src/0003d-web-fetch-errors.md §2.2 / §4
  */
 export declare class WebSearchClientError extends Error {
     readonly code: WebFetchClientErrorCode;
@@ -18,14 +18,14 @@ export declare class WebSearchClientError extends Error {
  * 将 `/v1/search` 的错误响应映射为 {@link WebSearchClientError}。
  * 对 `PROVIDER_NOT_CONFIGURED`（503）提供面向运维的中文指引。
  *
- * @see docs/adr/decisions/0003d-web-fetch-errors.md §2.2
+ * @see packages/web-fetch-server/src/0003d-web-fetch-errors.md §2.2
  */
 export declare function mapSearchServerErrorToClient(httpStatus: number, body: ErrorResponseBody | null, ctx: {
     endpoint: string;
 }): WebSearchClientError;
 /**
  * 客户端整体超时（`TIMEOUT_WEB_SEARCH`）。
- * @see docs/adr/decisions/0003d-web-fetch-errors.md §2.3
+ * @see packages/web-fetch-server/src/0003d-web-fetch-errors.md §2.3
  */
 export declare function getSearchTimeoutError(timeoutMs: number): WebSearchClientError;
 /** 将 {@link WebFetchClientError} 转为本工具统一抛出的错误类型。 */

package/dist/tools/web-search/errors.js

@@ -2,7 +2,7 @@ import { mapServerErrorToClient, } from "../web-fetch/errors";
 /**
  * `web-search` 工具在客户端抛出的错误类型（语义上与 {@link ../web-fetch/errors.WebFetchClientError} 一致）。
  *
- * @see docs/adr/decisions/0003d-web-fetch-errors.md §2.2 / §4
+ * @see packages/web-fetch-server/src/0003d-web-fetch-errors.md §2.2 / §4
  */
 export class WebSearchClientError extends Error {
     code;
@@ -20,7 +20,7 @@ export class WebSearchClientError extends Error {
  * 将 `/v1/search` 的错误响应映射为 {@link WebSearchClientError}。
  * 对 `PROVIDER_NOT_CONFIGURED`（503）提供面向运维的中文指引。
  *
- * @see docs/adr/decisions/0003d-web-fetch-errors.md §2.2
+ * @see packages/web-fetch-server/src/0003d-web-fetch-errors.md §2.2
  */
 export function mapSearchServerErrorToClient(httpStatus, body, ctx) {
     const mapped = mapServerErrorToClient(httpStatus, body, ctx);
@@ -33,7 +33,7 @@ export function mapSearchServerErrorToClient(httpStatus, body, ctx) {
 }
 /**
  * 客户端整体超时（`TIMEOUT_WEB_SEARCH`）。
- * @see docs/adr/decisions/0003d-web-fetch-errors.md §2.3
+ * @see packages/web-fetch-server/src/0003d-web-fetch-errors.md §2.3
  */
 export function getSearchTimeoutError(timeoutMs) {
     return new WebSearchClientError("TIMEOUT_WEB_SEARCH", "搜索超时。请缩短查询词或减少 fetchTopN 后重试。", { timeoutMs });

package/dist/tools/web-search/executor.d.ts

@@ -3,8 +3,8 @@ import type { WebSearchToolInput, WebSearchToolOutput } from "./types";
 /**
  * 调用 Web Fetch Server `POST /v1/search`。
  *
- * @see docs/adr/decisions/0003a-web-fetch-api-contract.md §Endpoint 3
- * @see docs/adr/decisions/0003d-web-fetch-errors.md §2.2
+ * @see packages/web-fetch-server/src/0003a-web-fetch-api-contract.md §Endpoint 3
+ * @see packages/web-fetch-server/src/0003d-web-fetch-errors.md §2.2
  */
 export declare function executeWebSearch(input: WebSearchToolInput, ctx: ToolExecutionContext): Promise<WebSearchToolOutput>;
 //# sourceMappingURL=executor.d.ts.map

package/dist/tools/web-search/executor.js

@@ -136,8 +136,8 @@ function tryParseErrorBody(text) {
 /**
  * 调用 Web Fetch Server `POST /v1/search`。
  *
- * @see docs/adr/decisions/0003a-web-fetch-api-contract.md §Endpoint 3
- * @see docs/adr/decisions/0003d-web-fetch-errors.md §2.2
+ * @see packages/web-fetch-server/src/0003a-web-fetch-api-contract.md §Endpoint 3
+ * @see packages/web-fetch-server/src/0003d-web-fetch-errors.md §2.2
  */
 export async function executeWebSearch(input, ctx) {
     assertNotAborted(ctx.abortSignal);

package/dist/tools/web-search/types.d.ts

@@ -1,12 +1,12 @@
 /**
  * Web Search 工具类型（客户端本地复刻，不依赖 `@tachu/web-fetch-server`）。
  *
- * @see docs/adr/decisions/0003b-web-fetch-types.md §2 / §6.2
+ * @see packages/web-fetch-server/src/0003b-web-fetch-types.md §2 / §6.2
  */
 import type { ExtractRequest, ExtractResponse } from "../web-fetch/types";
 /**
  * POST /v1/search 请求体。
- * @see docs/adr/decisions/0003a-web-fetch-api-contract.md §Endpoint 3
+ * @see packages/web-fetch-server/src/0003a-web-fetch-api-contract.md §Endpoint 3
  */
 export interface SearchRequest {
     query: string;
@@ -40,7 +40,7 @@ export interface SearchResultItem {
 }
 /**
  * `web-search` 工具入参（`timeoutMs` 仅客户端使用）。
- * @see docs/adr/decisions/0003b-web-fetch-types.md §6.2
+ * @see packages/web-fetch-server/src/0003b-web-fetch-types.md §6.2
  */
 export interface WebSearchToolInput {
     query: string;
@@ -59,7 +59,7 @@ export interface WebSearchToolInput {
 }
 /**
  * `web-search` 工具成功出参（不含 `searchedAtMs` / `traceId` 等追踪字段）。
- * @see docs/adr/decisions/0003b-web-fetch-types.md §6.2
+ * @see packages/web-fetch-server/src/0003b-web-fetch-types.md §6.2
  */
 export interface WebSearchToolOutput {
     query: string;

package/dist/tools/web-search/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/web-search/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/web-search/types.ts"],"names":[],"mappings":"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"}

package/dist/tools/web-search/types.js

@@ -1,7 +1,7 @@
 /**
  * Web Search 工具类型（客户端本地复刻，不依赖 `@tachu/web-fetch-server`）。
  *
- * @see docs/adr/decisions/0003b-web-fetch-types.md §2 / §6.2
+ * @see packages/web-fetch-server/src/0003b-web-fetch-types.md §2 / §6.2
  */
 export {};
 //# sourceMappingURL=types.js.map

package/dist/transformers/document-to-text.d.ts

@@ -5,19 +5,19 @@ import type { InputEnvelope, InputMetadata, InputTransformer, ModelCapabilities
 export declare class DocumentToTextTransformer implements InputTransformer {
     readonly modality = "document";
     /**
-     * 判断是否需要文档降级。
-     *
-     * @param metadata 输入元信息
-     * @param modelCapabilities 模型能力
-     * @returns true 表示需要转换
-     */
+    * 判断是否需要文档降级。
+    *
+    * @param metadata 输入元信息
+    * @param modelCapabilities 模型能力
+    * @returns true 表示需要转换
+    */
     canHandle(metadata: InputMetadata, modelCapabilities: ModelCapabilities): boolean;
     /**
-     * 将文档转换为文本信封。
-     *
-     * @param envelope 输入信封
-     * @returns 文本信封
-     */
+    * 将文档转换为文本信封。
+    *
+    * @param envelope 输入信封
+    * @returns 文本信封
+    */
     transform(envelope: InputEnvelope): Promise<InputEnvelope>;
 }
 //# sourceMappingURL=document-to-text.d.ts.map

package/dist/transformers/document-to-text.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"document-to-text.d.ts","sourceRoot":"","sources":["../../src/transformers/document-to-text.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAkBrG;;GAEG;AACH,qBAAa,yBAA0B,YAAW,gBAAgB;IAChE,QAAQ,CAAC,QAAQ,cAAc;IAE/B;;;;;;OAMG;IACH,SAAS,CAAC,QAAQ,EAAE,aAAa,EAAE,iBAAiB,EAAE,iBAAiB,GAAG,OAAO;IAMjF;;;;;OAKG;IACG,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;CAkCjE"}
+{"version":3,"file":"document-to-text.d.ts","sourceRoot":"","sources":["../../src/transformers/document-to-text.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAkBrG;;GAEG;AACH,qBAAa,yBAA0B,YAAW,gBAAgB;IAChE,QAAQ,CAAC,QAAQ,cAAc;IAEhC;;;;;;MAME;IACD,SAAS,CAAC,QAAQ,EAAE,aAAa,EAAE,iBAAiB,EAAE,iBAAiB,GAAG,OAAO;IAMlF;;;;;MAKE;IACK,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;CAkCjE"}

package/dist/transformers/document-to-text.js

@@ -16,23 +16,23 @@ const truncateIfNeeded = (text) => {
 export class DocumentToTextTransformer {
     modality = "document";
     /**
-     * 判断是否需要文档降级。
-     *
-     * @param metadata 输入元信息
-     * @param modelCapabilities 模型能力
-     * @returns true 表示需要转换
-     */
+    * 判断是否需要文档降级。
+    *
+    * @param metadata 输入元信息
+    * @param modelCapabilities 模型能力
+    * @returns true 表示需要转换
+    */
     canHandle(metadata, modelCapabilities) {
         const modality = metadata.modality ?? "";
         const isDocument = modality === "document" || modality === "file";
         return isDocument && !modelCapabilities.supportedModalities.includes("file");
     }
     /**
-     * 将文档转换为文本信封。
-     *
-     * @param envelope 输入信封
-     * @returns 文本信封
-     */
+    * 将文档转换为文本信封。
+    *
+    * @param envelope 输入信封
+    * @returns 文本信封
+    */
     async transform(envelope) {
         const content = envelope.content;
         if (!content.path) {

package/dist/transformers/document-to-text.js.map

@@ -1 +1 @@
-{"version":3,"file":"document-to-text.js","sourceRoot":"","sources":["../../src/transformers/document-to-text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,OAAO,MAAM,SAAS,CAAC;AAE9B,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAO9C,MAAM,cAAc,GAAG,OAAO,CAAC;AAE/B,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAU,EAAE;IAChD,IAAI,IAAI,CAAC,MAAM,IAAI,cAAc,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;IAC9C,OAAO,GAAG,OAAO,kBAAkB,IAAI,CAAC,MAAM,GAAG,cAAc,GAAG,CAAC;AACrE,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,OAAO,yBAAyB;IAC3B,QAAQ,GAAG,UAAU,CAAC;IAE/B;;;;;;OAMG;IACH,SAAS,CAAC,QAAuB,EAAE,iBAAoC;QACrE,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC;QACzC,MAAM,UAAU,GAAG,QAAQ,KAAK,UAAU,IAAI,QAAQ,KAAK,MAAM,CAAC;QAClE,OAAO,UAAU,IAAI,CAAC,iBAAiB,CAAC,mBAAmB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC/E,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,SAAS,CAAC,QAAuB;QACrC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAA0B,CAAC;QACpD,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAClB,MAAM,IAAI,eAAe,CAAC,0BAA0B,EAAE,aAAa,CAAC,CAAC;QACvE,CAAC;QACD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC;QAEtE,IAAI,IAAI,GAAG,EAAE,CAAC;QACd,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5E,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC5C,MAAM,MAAM,GAAG,IAAI,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;YAC9C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;YACtC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;YACnB,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;QACzB,CAAC;aAAM,IACL,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;YACzB,QAAQ,CAAC,QAAQ,CAAC,gBAAgB,CAAC;YACnC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,EAC5C,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YACpE,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,IAAI,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC9C,CAAC;QAED,OAAO;YACL,OAAO,EAAE,gBAAgB,CAAC,IAAI,CAAC;YAC/B,QAAQ,EAAE;gBACR,GAAG,QAAQ,CAAC,QAAQ;gBACpB,QAAQ,EAAE,MAAM;gBAChB,QAAQ,EAAE,YAAY;aACvB;SACF,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"document-to-text.js","sourceRoot":"","sources":["../../src/transformers/document-to-text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,OAAO,MAAM,SAAS,CAAC;AAE9B,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAO9C,MAAM,cAAc,GAAG,OAAO,CAAC;AAE/B,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAU,EAAE;IAChD,IAAI,IAAI,CAAC,MAAM,IAAI,cAAc,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;IAC9C,OAAO,GAAG,OAAO,kBAAkB,IAAI,CAAC,MAAM,GAAG,cAAc,GAAG,CAAC;AACrE,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,OAAO,yBAAyB;IAC3B,QAAQ,GAAG,UAAU,CAAC;IAEhC;;;;;;MAME;IACD,SAAS,CAAC,QAAuB,EAAE,iBAAoC;QACrE,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC;QACzC,MAAM,UAAU,GAAG,QAAQ,KAAK,UAAU,IAAI,QAAQ,KAAK,MAAM,CAAC;QAClE,OAAO,UAAU,IAAI,CAAC,iBAAiB,CAAC,mBAAmB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC/E,CAAC;IAEF;;;;;MAKE;IACD,KAAK,CAAC,SAAS,CAAC,QAAuB;QACrC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAA0B,CAAC;QACpD,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAClB,MAAM,IAAI,eAAe,CAAC,0BAA0B,EAAE,aAAa,CAAC,CAAC;QACvE,CAAC;QACD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC;QAEtE,IAAI,IAAI,GAAG,EAAE,CAAC;QACd,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5E,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC5C,MAAM,MAAM,GAAG,IAAI,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;YAC9C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;YACtC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;YACnB,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;QACzB,CAAC;aAAM,IACL,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;YACzB,QAAQ,CAAC,QAAQ,CAAC,gBAAgB,CAAC;YACnC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,EAC5C,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YACpE,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,IAAI,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC9C,CAAC;QAED,OAAO;YACL,OAAO,EAAE,gBAAgB,CAAC,IAAI,CAAC;YAC/B,QAAQ,EAAE;gBACR,GAAG,QAAQ,CAAC,QAAQ;gBACpB,QAAQ,EAAE,MAAM;gBAChB,QAAQ,EAAE,YAAY;aACvB;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/transformers/image-to-text.d.ts

@@ -13,25 +13,25 @@ export declare class ImageToTextTransformer implements InputTransformer {
     private readonly model;
     private readonly promptTemplate;
     /**
-     * 创建图像转换器。
-     *
-     * @param options 配置项
-     */
+    * 创建图像转换器。
+    *
+    * @param options 配置项
+    */
     constructor(options: ImageToTextTransformerOptions);
     /**
-     * 判断是否需要执行降级转换。
-     *
-     * @param metadata 输入元信息
-     * @param modelCapabilities 模型能力
-     * @returns true 表示需要转换
-     */
+    * 判断是否需要执行降级转换。
+    *
+    * @param metadata 输入元信息
+    * @param modelCapabilities 模型能力
+    * @returns true 表示需要转换
+    */
     canHandle(metadata: InputMetadata, modelCapabilities: ModelCapabilities): boolean;
     /**
-     * 将图像输入转换为文本信封。
-     *
-     * @param envelope 输入信封
-     * @returns 转换后的文本信封
-     */
+    * 将图像输入转换为文本信封。
+    *
+    * @param envelope 输入信封
+    * @returns 转换后的文本信封
+    */
     transform(envelope: InputEnvelope): Promise<InputEnvelope>;
 }
 export {};

package/dist/transformers/image-to-text.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"image-to-text.d.ts","sourceRoot":"","sources":["../../src/transformers/image-to-text.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,aAAa,EACb,aAAa,EACb,gBAAgB,EAEhB,iBAAiB,EACjB,eAAe,EAChB,MAAM,aAAa,CAAC;AAGrB,UAAU,6BAA6B;IACrC,QAAQ,EAAE,eAAe,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAUD;;GAEG;AACH,qBAAa,sBAAuB,YAAW,gBAAgB;IAC7D,QAAQ,CAAC,QAAQ,WAAW;IAE5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IAExC;;;;OAIG;gBACS,OAAO,EAAE,6BAA6B;IAMlD;;;;;;OAMG;IACH,SAAS,CAAC,QAAQ,EAAE,aAAa,EAAE,iBAAiB,EAAE,iBAAiB,GAAG,OAAO;IAOjF;;;;;OAKG;IACG,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;CA4CjE"}
+{"version":3,"file":"image-to-text.d.ts","sourceRoot":"","sources":["../../src/transformers/image-to-text.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,aAAa,EACb,aAAa,EACb,gBAAgB,EAEhB,iBAAiB,EACjB,eAAe,EAChB,MAAM,aAAa,CAAC;AAGrB,UAAU,6BAA6B;IACrC,QAAQ,EAAE,eAAe,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAUD;;GAEG;AACH,qBAAa,sBAAuB,YAAW,gBAAgB;IAC7D,QAAQ,CAAC,QAAQ,WAAW;IAE5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IAEzC;;;;MAIE;gBACW,OAAO,EAAE,6BAA6B;IAMnD;;;;;;MAME;IACD,SAAS,CAAC,QAAQ,EAAE,aAAa,EAAE,iBAAiB,EAAE,iBAAiB,GAAG,OAAO;IAOlF;;;;;MAKE;IACK,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;CA4CjE"}

package/dist/transformers/image-to-text.js

@@ -9,32 +9,32 @@ export class ImageToTextTransformer {
     model;
     promptTemplate;
     /**
-     * 创建图像转换器。
-     *
-     * @param options 配置项
-     */
+    * 创建图像转换器。
+    *
+    * @param options 配置项
+    */
     constructor(options) {
         this.provider = options.provider;
         this.model = options.model ?? "gpt-4o";
         this.promptTemplate = options.promptTemplate ?? DEFAULT_PROMPT;
     }
     /**
-     * 判断是否需要执行降级转换。
-     *
-     * @param metadata 输入元信息
-     * @param modelCapabilities 模型能力
-     * @returns true 表示需要转换
-     */
+    * 判断是否需要执行降级转换。
+    *
+    * @param metadata 输入元信息
+    * @param modelCapabilities 模型能力
+    * @returns true 表示需要转换
+    */
     canHandle(metadata, modelCapabilities) {
         return (metadata.modality === "image" &&
             !modelCapabilities.supportedModalities.includes("image"));
     }
     /**
-     * 将图像输入转换为文本信封。
-     *
-     * @param envelope 输入信封
-     * @returns 转换后的文本信封
-     */
+    * 将图像输入转换为文本信封。
+    *
+    * @param envelope 输入信封
+    * @returns 转换后的文本信封
+    */
     async transform(envelope) {
         const content = envelope.content;
         const imageUrl = content.imageUrl ??

package/dist/transformers/image-to-text.js.map

@@ -1 +1 @@
-{"version":3,"file":"image-to-text.js","sourceRoot":"","sources":["../../src/transformers/image-to-text.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,4BAA4B,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAc1E,MAAM,cAAc,GAAG,uBAAuB,CAAC;AAE/C;;GAEG;AACH,MAAM,OAAO,sBAAsB;IACxB,QAAQ,GAAG,OAAO,CAAC;IAEX,QAAQ,CAAkB;IAC1B,KAAK,CAAS;IACd,cAAc,CAAS;IAExC;;;;OAIG;IACH,YAAY,OAAsC;QAChD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,QAAQ,CAAC;QACvC,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,cAAc,CAAC;IACjE,CAAC;IAED;;;;;;OAMG;IACH,SAAS,CAAC,QAAuB,EAAE,iBAAoC;QACrE,OAAO,CACL,QAAQ,CAAC,QAAQ,KAAK,OAAO;YAC7B,CAAC,iBAAiB,CAAC,mBAAmB,CAAC,QAAQ,CAAC,OAAO,CAAC,CACzD,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,SAAS,CAAC,QAAuB;QACrC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAuB,CAAC;QACjD,MAAM,QAAQ,GACZ,OAAO,CAAC,QAAQ;YAChB,CAAC,OAAO,CAAC,WAAW;gBAClB,CAAC,CAAC,QAAQ,OAAO,CAAC,QAAQ,IAAI,WAAW,WAAW,OAAO,CAAC,WAAW,EAAE;gBACzE,CAAC,CAAC,SAAS,CAAC,CAAC;QACjB,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,aAAa,CAAC,wBAAwB,EAAE,2BAA2B,CAAC,CAAC;QACjF,CAAC;QAED,IAAI,CAAC;YACH,MAAM,KAAK,GAAyB;gBAClC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE;gBAC3C,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE;aACpD,CAAC;YACF,MAAM,OAAO,GAAgB;gBAC3B,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,QAAQ,EAAE;oBACR;wBACE,IAAI,EAAE,MAAM;wBACZ,OAAO,EAAE,KAAK;qBACf;iBACF;aACF,CAAC;YACF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,4BAA4B,CAAC,CAAC;YACjF,OAAO;gBACL,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,QAAQ,EAAE;oBACR,GAAG,QAAQ,CAAC,QAAQ;oBACpB,QAAQ,EAAE,MAAM;oBAChB,QAAQ,EAAE,YAAY;iBACvB;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;gBACnC,MAAM,KAAK,CAAC;YACd,CAAC;YACD,MAAM,IAAI,aAAa,CAAC,yBAAyB,EAAE,SAAS,EAAE;gBAC5D,KAAK,EAAE,KAAK;gBACZ,SAAS,EAAE,IAAI;aAChB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"image-to-text.js","sourceRoot":"","sources":["../../src/transformers/image-to-text.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,4BAA4B,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAc1E,MAAM,cAAc,GAAG,uBAAuB,CAAC;AAE/C;;GAEG;AACH,MAAM,OAAO,sBAAsB;IACxB,QAAQ,GAAG,OAAO,CAAC;IAEX,QAAQ,CAAkB;IAC1B,KAAK,CAAS;IACd,cAAc,CAAS;IAEzC;;;;MAIE;IACD,YAAY,OAAsC;QAChD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,QAAQ,CAAC;QACvC,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,cAAc,CAAC;IACjE,CAAC;IAEF;;;;;;MAME;IACD,SAAS,CAAC,QAAuB,EAAE,iBAAoC;QACrE,OAAO,CACL,QAAQ,CAAC,QAAQ,KAAK,OAAO;YAC7B,CAAC,iBAAiB,CAAC,mBAAmB,CAAC,QAAQ,CAAC,OAAO,CAAC,CACzD,CAAC;IACJ,CAAC;IAEF;;;;;MAKE;IACD,KAAK,CAAC,SAAS,CAAC,QAAuB;QACrC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAuB,CAAC;QACjD,MAAM,QAAQ,GACZ,OAAO,CAAC,QAAQ;YAChB,CAAC,OAAO,CAAC,WAAW;gBAClB,CAAC,CAAC,QAAQ,OAAO,CAAC,QAAQ,IAAI,WAAW,WAAW,OAAO,CAAC,WAAW,EAAE;gBACzE,CAAC,CAAC,SAAS,CAAC,CAAC;QACjB,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,aAAa,CAAC,wBAAwB,EAAE,2BAA2B,CAAC,CAAC;QACjF,CAAC;QAED,IAAI,CAAC;YACH,MAAM,KAAK,GAAyB;gBAClC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE;gBAC3C,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE;aACpD,CAAC;YACF,MAAM,OAAO,GAAgB;gBAC3B,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,QAAQ,EAAE;oBACR;wBACE,IAAI,EAAE,MAAM;wBACZ,OAAO,EAAE,KAAK;qBACf;iBACF;aACF,CAAC;YACF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,4BAA4B,CAAC,CAAC;YACjF,OAAO;gBACL,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,QAAQ,EAAE;oBACR,GAAG,QAAQ,CAAC,QAAQ;oBACpB,QAAQ,EAAE,MAAM;oBAChB,QAAQ,EAAE,YAAY;iBACvB;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;gBACnC,MAAM,KAAK,CAAC;YACd,CAAC;YACD,MAAM,IAAI,aAAa,CAAC,yBAAyB,EAAE,SAAS,EAAE;gBAC5D,KAAK,EAAE,KAAK;gBACZ,SAAS,EAAE,IAAI;aAChB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF"}

package/dist/vector/index.d.ts

@@ -1,3 +1,5 @@
-export { LocalFsVectorStore } from "./local-fs";
-export { QdrantVectorStore } from "./qdrant";
+export { LocalFsVectorIndexAdapter } from "./local-fs-index";
+export type { LocalFsVectorIndexAdapterOptions } from "./local-fs-index";
+export { QdrantVectorIndexAdapter, QdrantVectorStore } from "./qdrant";
+export type { QdrantVectorIndexAdapterOptions } from "./qdrant";
 //# sourceMappingURL=index.d.ts.map

package/dist/vector/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vector/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vector/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,YAAY,EAAE,gCAAgC,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACvE,YAAY,EAAE,+BAA+B,EAAE,MAAM,UAAU,CAAC"}

package/dist/vector/index.js

@@ -1,3 +1,3 @@
-export { LocalFsVectorStore } from "./local-fs";
-export { QdrantVectorStore } from "./qdrant";
+export { LocalFsVectorIndexAdapter } from "./local-fs-index";
+export { QdrantVectorIndexAdapter, QdrantVectorStore } from "./qdrant";
 //# sourceMappingURL=index.js.map

package/dist/vector/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/vector/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/vector/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAE7D,OAAO,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC"}

package/dist/vector/local-fs-index.d.ts

@@ -0,0 +1,59 @@
+import { type AdapterCallContext, type VectorHit, type VectorIndexAdapter, type VectorPayloadFilter, type VectorPoint } from "@tachu/core";
+export interface LocalFsVectorIndexAdapterOptions {
+    /** Persisted index file. Defaults to `.tachu/vector-index.json` under cwd. */
+    filePath?: string;
+    /** Debounce window (ms) before flushing buffered writes to disk. Default 500. */
+    persistDebounceMs?: number;
+    /**
+    * Optional soft cap on the number of points retained. When exceeded, the
+    * oldest insertions are evicted (FIFO) to prevent unbounded growth.
+    */
+    indexLimit?: number;
+}
+interface PersistedPoint {
+    id: string;
+    vector: number[];
+    payload: Record<string, unknown>;
+}
+/**
+ * Pure-vector local filesystem index ( / / ).
+ *
+ * - Accepts only precomputed numeric `VectorPoint`s. Text-only `upsert(id, string, …)`
+ * shortcuts from pre- hosts are rejected — production projection paths
+ * must embed via {@link EmbeddingRuntime} before reaching this adapter.
+ * - Persisted as a single JSON snapshot at `.tachu/vector-index.json` with
+ * debounced atomic rewrites; safe for the CLI default deployment without
+ * pulling in an external vector database.
+ * - Implements {@link VectorIndexAdapter}, the only interface the
+ * {@link ProjectionWorker} and {@link DefaultSemanticRetrievalFacade}
+ * consume in production wiring.
+ */
+export declare class LocalFsVectorIndexAdapter implements VectorIndexAdapter {
+    private readonly filePath;
+    private readonly lockPath;
+    private readonly persistDebounceMs;
+    private readonly indexLimit;
+    private readonly entries;
+    private readonly initPromise;
+    private persistTimer;
+    private persisting;
+    constructor(options?: LocalFsVectorIndexAdapterOptions);
+    upsert(points: readonly VectorPoint[], _ctx: AdapterCallContext, signal?: AbortSignal): Promise<void>;
+    searchVector(query: number[], topK: number, filters: VectorPayloadFilter, _ctx: AdapterCallContext, signal?: AbortSignal): Promise<VectorHit[]>;
+    delete(ids: readonly string[], _ctx: AdapterCallContext, signal?: AbortSignal): Promise<void>;
+    /** Test-only inspection helper. Not part of the {@link VectorIndexAdapter} contract. */
+    snapshot(): PersistedPoint[];
+    /**
+    * Flush any pending writes synchronously. Hosts wiring this adapter into a
+    * graceful shutdown should `await flush()` before the process exits to avoid
+    * losing buffered upserts.
+    */
+    flush(): Promise<void>;
+    private loadFromDisk;
+    private schedulePersist;
+    private acquireLock;
+    private persistToDisk;
+    static fileExists(path: string): boolean;
+}
+export {};
+//# sourceMappingURL=local-fs-index.d.ts.map

package/dist/vector/local-fs-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-fs-index.d.ts","sourceRoot":"","sources":["../../src/vector/local-fs-index.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACd,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,WAAW,EACjB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,gCAAgC;IAChD,8EAA8E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC;IACnB,iFAAiF;IAChF,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;MAGE;IACD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,cAAc;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAmCD;;;;;;;;;;;;GAYG;AACH,qBAAa,yBAA0B,YAAW,kBAAkB;IAClE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAC7D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgB;IAC5C,OAAO,CAAC,YAAY,CAA4C;IAChE,OAAO,CAAC,UAAU,CAAoC;gBAE1C,OAAO,GAAE,gCAAqC;IAQpD,MAAM,CACV,MAAM,EAAE,SAAS,WAAW,EAAE,EAC9B,IAAI,EAAE,kBAAkB,EACxB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC;IA2CV,YAAY,CAChB,KAAK,EAAE,MAAM,EAAE,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,mBAAmB,EAC5B,IAAI,EAAE,kBAAkB,EACxB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,SAAS,EAAE,CAAC;IAsBjB,MAAM,CACV,GAAG,EAAE,SAAS,MAAM,EAAE,EACtB,IAAI,EAAE,kBAAkB,EACxB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC;IAWjB,wFAAwF;IACvF,QAAQ,IAAI,cAAc,EAAE;IAQ7B;;;;MAIE;IACK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YASd,YAAY;IAyB1B,OAAO,CAAC,eAAe;YAOT,WAAW;YAgBX,aAAa;IAsB3B,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAGzC"}