@tachu/extensions 1.0.0-alpha.1

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

@@ -0,0 +1,185 @@
+import { buildWebFetchJsonHeaders, getWebFetchEndpointBase, readWebFetchClientTimeoutMs, } from "../_shared/web-client";
+import { assertNotAborted } from "../shared";
+import { getMalformedResponseError, getNetworkError } from "../web-fetch/errors";
+import { asWebSearchClientError, getSearchTimeoutError, mapSearchServerErrorToClient, } from "./errors";
+function toSearchRequest(input) {
+    const { timeoutMs: _timeoutMs, ...rest } = input;
+    return {
+        ...rest,
+        traceId: null,
+    };
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isSearchResultExtract(value) {
+    if (!isRecord(value))
+        return false;
+    if (typeof value.status !== "number")
+        return false;
+    if (value.renderedWith !== "static" && value.renderedWith !== "browser")
+        return false;
+    if (typeof value.body !== "string")
+        return false;
+    if (typeof value.wordCount !== "number")
+        return false;
+    if (typeof value.truncated !== "boolean")
+        return false;
+    if (!Array.isArray(value.warnings))
+        return false;
+    if (value.title !== undefined && typeof value.title !== "string")
+        return false;
+    return true;
+}
+function isSearchResultItem(value) {
+    if (!isRecord(value))
+        return false;
+    if (typeof value.title !== "string")
+        return false;
+    if (typeof value.url !== "string")
+        return false;
+    if (typeof value.snippet !== "string")
+        return false;
+    if (value.publishedAt !== undefined && value.publishedAt !== null && typeof value.publishedAt !== "string") {
+        return false;
+    }
+    if (value.score !== undefined && value.score !== null && typeof value.score !== "number") {
+        return false;
+    }
+    if (value.extract !== undefined && !isSearchResultExtract(value.extract))
+        return false;
+    return true;
+}
+function isSearchResponse(value) {
+    if (!isRecord(value))
+        return false;
+    if (typeof value.query !== "string")
+        return false;
+    if (typeof value.provider !== "string")
+        return false;
+    if (!Array.isArray(value.results))
+        return false;
+    for (const item of value.results) {
+        if (!isSearchResultItem(item))
+            return false;
+    }
+    if (typeof value.totalResults !== "number")
+        return false;
+    if (typeof value.searchedAtMs !== "number")
+        return false;
+    if (!Array.isArray(value.warnings))
+        return false;
+    if (typeof value.traceId !== "string")
+        return false;
+    return true;
+}
+function toToolOutput(res) {
+    return {
+        query: res.query,
+        provider: res.provider,
+        results: res.results.map((r) => {
+            const row = {
+                title: r.title,
+                url: r.url,
+                snippet: r.snippet,
+            };
+            if (r.publishedAt !== undefined)
+                row.publishedAt = r.publishedAt;
+            if (r.score !== undefined)
+                row.score = r.score;
+            if (r.extract !== undefined) {
+                row.extract = {
+                    status: r.extract.status,
+                    renderedWith: r.extract.renderedWith,
+                    body: r.extract.body,
+                    wordCount: r.extract.wordCount,
+                    truncated: r.extract.truncated,
+                    warnings: r.extract.warnings,
+                };
+                if (r.extract.title !== undefined)
+                    row.extract.title = r.extract.title;
+            }
+            return row;
+        }),
+        totalResults: res.totalResults,
+        warnings: res.warnings,
+    };
+}
+function tryParseErrorBody(text) {
+    try {
+        const parsed = JSON.parse(text);
+        if (!isRecord(parsed))
+            return null;
+        const err = parsed.error;
+        if (!isRecord(err))
+            return null;
+        if (typeof err.code !== "string")
+            return null;
+        if (typeof err.message !== "string")
+            return null;
+        if (typeof err.requestId !== "string")
+            return null;
+        const body = {
+            error: {
+                code: err.code,
+                message: err.message,
+                requestId: err.requestId,
+                ...(isRecord(err.detail) ? { detail: err.detail } : {}),
+            },
+        };
+        return body;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 调用 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
+ */
+export async function executeWebSearch(input, ctx) {
+    assertNotAborted(ctx.abortSignal);
+    const endpoint = getWebFetchEndpointBase();
+    const url = `${endpoint}/v1/search`;
+    const timeoutMs = readWebFetchClientTimeoutMs(input.timeoutMs);
+    const signal = AbortSignal.any([AbortSignal.timeout(timeoutMs), ctx.abortSignal]);
+    const headers = buildWebFetchJsonHeaders();
+    let response;
+    try {
+        response = await fetch(url, {
+            method: "POST",
+            headers,
+            body: JSON.stringify(toSearchRequest(input)),
+            signal,
+        });
+    }
+    catch (e) {
+        if (e instanceof Error && e.name === "AbortError") {
+            if (ctx.abortSignal.aborted) {
+                throw ctx.abortSignal.reason ?? e;
+            }
+            throw getSearchTimeoutError(timeoutMs);
+        }
+        throw asWebSearchClientError(getNetworkError(endpoint, e));
+    }
+    if (!response.ok) {
+        const text = await response.text();
+        const parsed = tryParseErrorBody(text);
+        throw mapSearchServerErrorToClient(response.status, parsed, { endpoint });
+    }
+    const text = await response.text();
+    let parsedBody;
+    try {
+        parsedBody = JSON.parse(text);
+    }
+    catch {
+        throw asWebSearchClientError(getMalformedResponseError());
+    }
+    if (!isSearchResponse(parsedBody)) {
+        throw asWebSearchClientError(getMalformedResponseError());
+    }
+    return toToolOutput(parsedBody);
+}
+//# sourceMappingURL=executor.js.map

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

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

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

@@ -0,0 +1,4 @@
+export { asWebSearchClientError, getSearchTimeoutError, mapSearchServerErrorToClient, WebSearchClientError, } from "./errors";
+export { executeWebSearch } from "./executor";
+export type { SearchRequest, SearchResponse, SearchResultItem, WebSearchToolInput, WebSearchToolOutput, } from "./types";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/web-search/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,4BAA4B,EAC5B,oBAAoB,GACrB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,YAAY,EACV,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,SAAS,CAAC"}

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

@@ -0,0 +1,3 @@
+export { asWebSearchClientError, getSearchTimeoutError, mapSearchServerErrorToClient, WebSearchClientError, } from "./errors";
+export { executeWebSearch } from "./executor";
+//# sourceMappingURL=index.js.map

package/dist/tools/web-search/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/web-search/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,4BAA4B,EAC5B,oBAAoB,GACrB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

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

@@ -0,0 +1,86 @@
+/**
+ * Web Search 工具类型（客户端本地复刻，不依赖 `@tachu/web-fetch-server`）。
+ *
+ * @see docs/adr/decisions/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
+ */
+export interface SearchRequest {
+    query: string;
+    maxResults?: number;
+    language?: string | null;
+    region?: string | null;
+    timeRange?: "day" | "week" | "month" | "year" | null;
+    safeSearch?: "off" | "moderate" | "strict";
+    includeDomains?: string[];
+    excludeDomains?: string[];
+    fetchTopN?: number;
+    fetchOptions?: Omit<ExtractRequest, "url" | "traceId">;
+    traceId?: string | null;
+}
+export interface SearchResponse {
+    query: string;
+    provider: string;
+    results: SearchResultItem[];
+    totalResults: number;
+    searchedAtMs: number;
+    warnings: string[];
+    traceId: string;
+}
+export interface SearchResultItem {
+    title: string;
+    url: string;
+    snippet: string;
+    publishedAt?: string | null;
+    score?: number | null;
+    extract?: Pick<ExtractResponse, "status" | "renderedWith" | "title" | "body" | "wordCount" | "truncated" | "warnings">;
+}
+/**
+ * `web-search` 工具入参（`timeoutMs` 仅客户端使用）。
+ * @see docs/adr/decisions/0003b-web-fetch-types.md §6.2
+ */
+export interface WebSearchToolInput {
+    query: string;
+    maxResults?: number;
+    language?: string;
+    region?: string;
+    timeRange?: "day" | "week" | "month" | "year";
+    safeSearch?: "off" | "moderate" | "strict";
+    includeDomains?: string[];
+    excludeDomains?: string[];
+    /** 渲染前 N 条结果为 Markdown；上限 5 */
+    fetchTopN?: number;
+    /** `fetchTopN > 0` 时透传至服务端 extract 管线 */
+    fetchOptions?: Omit<ExtractRequest, "url" | "traceId">;
+    timeoutMs?: number;
+}
+/**
+ * `web-search` 工具成功出参（不含 `searchedAtMs` / `traceId` 等追踪字段）。
+ * @see docs/adr/decisions/0003b-web-fetch-types.md §6.2
+ */
+export interface WebSearchToolOutput {
+    query: string;
+    provider: string;
+    results: Array<{
+        title: string;
+        url: string;
+        snippet: string;
+        publishedAt?: string | null;
+        score?: number | null;
+        extract?: {
+            status: number;
+            renderedWith: "static" | "browser";
+            title?: string;
+            body: string;
+            wordCount: number;
+            truncated: boolean;
+            warnings?: string[];
+        };
+    }>;
+    totalResults: number;
+    warnings: string[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/web-search/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/tools/write-file/descriptor.md

@@ -0,0 +1,30 @@
+---
+kind: tool
+name: write-file
+description: 写入工作区内文件内容
+sideEffect: write
+idempotent: false
+requiresApproval: true
+timeout: 5000
+inputSchema:
+  type: object
+  properties:
+    path:
+      type: string
+    content:
+      type: string
+    encoding:
+      type: string
+      enum: [utf-8, base64]
+    createDirs:
+      type: boolean
+  required: [path, content]
+outputSchema:
+  type: object
+  properties:
+    bytesWritten:
+      type: number
+execute: write-file
+---
+
+向工作区写入文件，支持 UTF-8 与 base64 输入。

package/dist/tools/write-file/executor.d.ts

@@ -0,0 +1,16 @@
+import type { ToolExecutor } from "../shared";
+interface WriteFileInput {
+    path: string;
+    content: string;
+    encoding?: "utf-8" | "base64";
+    createDirs?: boolean;
+}
+interface WriteFileOutput {
+    bytesWritten: number;
+}
+/**
+ * 写入文件 Tool 执行器。
+ */
+export declare const writeFileExecutor: ToolExecutor<WriteFileInput, WriteFileOutput>;
+export {};
+//# sourceMappingURL=executor.d.ts.map

package/dist/tools/write-file/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/tools/write-file/executor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAG9C,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC9B,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,UAAU,eAAe;IACvB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,YAAY,CAAC,cAAc,EAAE,eAAe,CAa3E,CAAC"}

package/dist/tools/write-file/executor.js

@@ -0,0 +1,18 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+import { resolveAllowedPath } from "../../common/path";
+import { assertNotAborted, resolveSandboxPolicy } from "../shared";
+/**
+ * 写入文件 Tool 执行器。
+ */
+export const writeFileExecutor = async (input, context) => {
+    assertNotAborted(context.abortSignal);
+    const target = resolveAllowedPath(input.path, resolveSandboxPolicy(context));
+    if (input.createDirs) {
+        await mkdir(dirname(target), { recursive: true });
+    }
+    const payload = input.encoding === "base64" ? Buffer.from(input.content, "base64") : Buffer.from(input.content);
+    await writeFile(target, payload);
+    return { bytesWritten: payload.byteLength };
+};
+//# sourceMappingURL=executor.js.map

package/dist/tools/write-file/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../src/tools/write-file/executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAanE;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAkD,KAAK,EACnF,KAAK,EACL,OAAO,EACP,EAAE;IACF,gBAAgB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,CAAC,IAAI,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC;IAC7E,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACrB,MAAM,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,MAAM,OAAO,GACX,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAClG,MAAM,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,EAAE,YAAY,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC;AAC9C,CAAC,CAAC"}

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

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

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

@@ -0,0 +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"}

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

@@ -0,0 +1,69 @@
+import { readFile } from "node:fs/promises";
+import { PDFParse } from "pdf-parse";
+import mammoth from "mammoth";
+import { ValidationError } from "@tachu/core";
+const MAX_TEXT_CHARS = 500_000;
+const truncateIfNeeded = (text) => {
+    if (text.length <= MAX_TEXT_CHARS) {
+        return text;
+    }
+    const trimmed = text.slice(0, MAX_TEXT_CHARS);
+    return `${trimmed}\n\n[TRUNCATED:${text.length - MAX_TEXT_CHARS}]`;
+};
+/**
+ * 文档转文本转换器（PDF / DOCX）。
+ */
+export class DocumentToTextTransformer {
+    modality = "document";
+    /**
+     * 判断是否需要文档降级。
+     *
+     * @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 文本信封
+     */
+    async transform(envelope) {
+        const content = envelope.content;
+        if (!content.path) {
+            throw new ValidationError("VALIDATION_DOCUMENT_PATH", "文档输入缺少 path");
+        }
+        const mimeType = content.mimeType ?? envelope.metadata.mimeType ?? "";
+        let text = "";
+        if (mimeType.includes("pdf") || content.path.toLowerCase().endsWith(".pdf")) {
+            const buffer = await readFile(content.path);
+            const parser = new PDFParse({ data: buffer });
+            const parsed = await parser.getText();
+            text = parsed.text;
+            await parser.destroy();
+        }
+        else if (mimeType.includes("word") ||
+            mimeType.includes("officedocument") ||
+            content.path.toLowerCase().endsWith(".docx")) {
+            const result = await mammoth.extractRawText({ path: content.path });
+            text = result.value;
+        }
+        else {
+            text = await readFile(content.path, "utf8");
+        }
+        return {
+            content: truncateIfNeeded(text),
+            metadata: {
+                ...envelope.metadata,
+                modality: "text",
+                mimeType: "text/plain",
+            },
+        };
+    }
+}
+//# sourceMappingURL=document-to-text.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,38 @@
+import type { InputEnvelope, InputMetadata, InputTransformer, ModelCapabilities, ProviderAdapter } from "@tachu/core";
+interface ImageToTextTransformerOptions {
+    provider: ProviderAdapter;
+    model?: string;
+    promptTemplate?: string;
+}
+/**
+ * 图像转文本转换器（基于 Provider Vision 能力）。
+ */
+export declare class ImageToTextTransformer implements InputTransformer {
+    readonly modality = "image";
+    private readonly provider;
+    private readonly model;
+    private readonly promptTemplate;
+    /**
+     * 创建图像转换器。
+     *
+     * @param options 配置项
+     */
+    constructor(options: ImageToTextTransformerOptions);
+    /**
+     * 判断是否需要执行降级转换。
+     *
+     * @param metadata 输入元信息
+     * @param modelCapabilities 模型能力
+     * @returns true 表示需要转换
+     */
+    canHandle(metadata: InputMetadata, modelCapabilities: ModelCapabilities): boolean;
+    /**
+     * 将图像输入转换为文本信封。
+     *
+     * @param envelope 输入信封
+     * @returns 转换后的文本信封
+     */
+    transform(envelope: InputEnvelope): Promise<InputEnvelope>;
+}
+export {};
+//# sourceMappingURL=image-to-text.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,82 @@
+import { ProviderError } from "@tachu/core";
+const DEFAULT_PROMPT = "请描述图片的主要内容、关键信息和可见文本。";
+/**
+ * 图像转文本转换器（基于 Provider Vision 能力）。
+ */
+export class ImageToTextTransformer {
+    modality = "image";
+    provider;
+    model;
+    promptTemplate;
+    /**
+     * 创建图像转换器。
+     *
+     * @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 表示需要转换
+     */
+    canHandle(metadata, modelCapabilities) {
+        return (metadata.modality === "image" &&
+            !modelCapabilities.supportedModalities.includes("image"));
+    }
+    /**
+     * 将图像输入转换为文本信封。
+     *
+     * @param envelope 输入信封
+     * @returns 转换后的文本信封
+     */
+    async transform(envelope) {
+        const content = envelope.content;
+        const imageUrl = content.imageUrl ??
+            (content.imageBase64
+                ? `data:${content.mimeType ?? "image/png"};base64,${content.imageBase64}`
+                : undefined);
+        if (!imageUrl) {
+            throw new ProviderError("PROVIDER_INVALID_INPUT", "缺少 imageUrl 或 imageBase64");
+        }
+        try {
+            const parts = [
+                { type: "text", text: this.promptTemplate },
+                { type: "image_url", image_url: { url: imageUrl } },
+            ];
+            const request = {
+                model: this.model,
+                messages: [
+                    {
+                        role: "user",
+                        content: parts,
+                    },
+                ],
+            };
+            const response = await this.provider.chat(request);
+            return {
+                content: response.content,
+                metadata: {
+                    ...envelope.metadata,
+                    modality: "text",
+                    mimeType: "text/plain",
+                },
+            };
+        }
+        catch (error) {
+            if (error instanceof ProviderError) {
+                throw error;
+            }
+            throw new ProviderError("PROVIDER_UPSTREAM_ERROR", "图像转文本失败", {
+                cause: error,
+                retryable: true,
+            });
+        }
+    }
+}
+//# sourceMappingURL=image-to-text.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"image-to-text.js","sourceRoot":"","sources":["../../src/transformers/image-to-text.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAc5C,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,CAAC,CAAC;YACnD,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/transformers/index.d.ts

@@ -0,0 +1,3 @@
+export { ImageToTextTransformer } from "./image-to-text";
+export { DocumentToTextTransformer } from "./document-to-text";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transformers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/transformers/index.js

@@ -0,0 +1,3 @@
+export { ImageToTextTransformer } from "./image-to-text";
+export { DocumentToTextTransformer } from "./document-to-text";
+//# sourceMappingURL=index.js.map

package/dist/transformers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transformers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/vector/index.d.ts

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