@tachu/extensions 1.0.0-alpha.1

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

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

package/dist/vector/index.js

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

package/dist/vector/index.js.map

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

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

@@ -0,0 +1,76 @@
+import { type VectorSearchResult, type VectorStore } from "@tachu/core";
+interface LocalFsVectorStoreOptions {
+    filePath?: string;
+    persistDebounceMs?: number;
+    indexLimit?: number;
+}
+/**
+ * 本地文件持久化 VectorStore（基于 InMemoryVectorStore）。
+ */
+export declare class LocalFsVectorStore implements VectorStore {
+    private readonly filePath;
+    private readonly lockPath;
+    private readonly persistDebounceMs;
+    private readonly store;
+    private readonly entries;
+    private readonly initPromise;
+    private persistTimer;
+    private persisting;
+    /**
+     * 创建本地向量存储。
+     *
+     * @param options 配置项
+     */
+    constructor(options?: LocalFsVectorStoreOptions);
+    /**
+     * 文本向量化。
+     *
+     * @param texts 文本列表
+     * @returns 向量列表
+     */
+    embed(texts: string[]): Promise<number[][]>;
+    /**
+     * 写入或更新向量条目。
+     *
+     * @param id 条目 ID
+     * @param vectorOrText 向量或文本
+     * @param metadata 元数据
+     */
+    upsert(id: string, vectorOrText: number[] | string, metadata: Record<string, unknown>): Promise<void>;
+    /**
+     * 相似度检索。
+     *
+     * @param query 查询向量或文本
+     * @param topK 返回数量
+     * @returns 检索结果
+     */
+    search(query: number[] | string, topK: number): Promise<VectorSearchResult[]>;
+    /**
+     * 删除条目。
+     *
+     * @param id 条目 ID
+     */
+    delete(id: string): Promise<void>;
+    /**
+     * 清空向量库。
+     */
+    clear(): Promise<void>;
+    /**
+     * 返回当前条目数。
+     *
+     * @returns 条目数量
+     */
+    size(): number;
+    /**
+     * 手动导出快照文件。
+     *
+     * @param path 快照路径
+     */
+    snapshot(path: string): Promise<void>;
+    private schedulePersist;
+    private loadFromDisk;
+    private acquireLock;
+    private persistToDisk;
+}
+export {};
+//# sourceMappingURL=local-fs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"local-fs.d.ts","sourceRoot":"","sources":["../../src/vector/local-fs.ts"],"names":[],"mappings":"AAEA,OAAO,EAAuB,KAAK,kBAAkB,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAE7F,UAAU,yBAAyB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAYD;;GAEG;AACH,qBAAa,kBAAmB,YAAW,WAAW;IACpD,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,KAAK,CAAsB;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAC7D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgB;IAC5C,OAAO,CAAC,YAAY,CAA4C;IAChE,OAAO,CAAC,UAAU,CAAqB;IAEvC;;;;OAIG;gBACS,OAAO,GAAE,yBAA8B;IAUnD;;;;;OAKG;IACG,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IAKjD;;;;;;OAMG;IACG,MAAM,CACV,EAAE,EAAE,MAAM,EACV,YAAY,EAAE,MAAM,EAAE,GAAG,MAAM,EAC/B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,IAAI,CAAC;IAShB;;;;;;OAMG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAKnF;;;;OAIG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOvC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B;;;;OAIG;IACH,IAAI,IAAI,MAAM;IAId;;;;OAIG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO3C,OAAO,CAAC,eAAe;YAST,YAAY;YAYZ,WAAW;YAgBX,aAAa;CAY5B"}

package/dist/vector/local-fs.js

@@ -0,0 +1,153 @@
+import { mkdir, open, readFile, rename, rm, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+import { InMemoryVectorStore } from "@tachu/core";
+/**
+ * 本地文件持久化 VectorStore（基于 InMemoryVectorStore）。
+ */
+export class LocalFsVectorStore {
+    filePath;
+    lockPath;
+    persistDebounceMs;
+    store;
+    entries = new Map();
+    initPromise;
+    persistTimer;
+    persisting = Promise.resolve();
+    /**
+     * 创建本地向量存储。
+     *
+     * @param options 配置项
+     */
+    constructor(options = {}) {
+        this.filePath = options.filePath ?? ".tachu/vectors.json";
+        this.lockPath = `${this.filePath}.lock`;
+        this.persistDebounceMs = options.persistDebounceMs ?? 500;
+        this.store = new InMemoryVectorStore({
+            ...(options.indexLimit !== undefined ? { indexLimit: options.indexLimit } : {}),
+        });
+        this.initPromise = this.loadFromDisk();
+    }
+    /**
+     * 文本向量化。
+     *
+     * @param texts 文本列表
+     * @returns 向量列表
+     */
+    async embed(texts) {
+        await this.initPromise;
+        return this.store.embed(texts);
+    }
+    /**
+     * 写入或更新向量条目。
+     *
+     * @param id 条目 ID
+     * @param vectorOrText 向量或文本
+     * @param metadata 元数据
+     */
+    async upsert(id, vectorOrText, metadata) {
+        await this.initPromise;
+        const vector = typeof vectorOrText === "string" ? (await this.store.embed([vectorOrText]))[0] ?? [] : vectorOrText;
+        await this.store.upsert(id, vector, metadata);
+        this.entries.set(id, { id, vector, metadata });
+        this.schedulePersist();
+    }
+    /**
+     * 相似度检索。
+     *
+     * @param query 查询向量或文本
+     * @param topK 返回数量
+     * @returns 检索结果
+     */
+    async search(query, topK) {
+        await this.initPromise;
+        return this.store.search(query, topK);
+    }
+    /**
+     * 删除条目。
+     *
+     * @param id 条目 ID
+     */
+    async delete(id) {
+        await this.initPromise;
+        await this.store.delete(id);
+        this.entries.delete(id);
+        this.schedulePersist();
+    }
+    /**
+     * 清空向量库。
+     */
+    async clear() {
+        await this.initPromise;
+        await this.store.clear();
+        this.entries.clear();
+        this.schedulePersist();
+    }
+    /**
+     * 返回当前条目数。
+     *
+     * @returns 条目数量
+     */
+    size() {
+        return this.entries.size;
+    }
+    /**
+     * 手动导出快照文件。
+     *
+     * @param path 快照路径
+     */
+    async snapshot(path) {
+        await this.initPromise;
+        const payload = { entries: [...this.entries.values()] };
+        await mkdir(dirname(path), { recursive: true });
+        await writeFile(path, JSON.stringify(payload, null, 2), "utf8");
+    }
+    schedulePersist() {
+        if (this.persistTimer) {
+            clearTimeout(this.persistTimer);
+        }
+        this.persistTimer = setTimeout(() => {
+            this.persisting = this.persisting.then(() => this.persistToDisk());
+        }, this.persistDebounceMs);
+    }
+    async loadFromDisk() {
+        const raw = await readFile(this.filePath, "utf8").catch(() => "");
+        if (!raw) {
+            return;
+        }
+        const payload = JSON.parse(raw);
+        for (const entry of payload.entries ?? []) {
+            await this.store.upsert(entry.id, entry.vector, entry.metadata);
+            this.entries.set(entry.id, entry);
+        }
+    }
+    async acquireLock() {
+        for (let attempt = 0; attempt < 30; attempt += 1) {
+            try {
+                await mkdir(dirname(this.lockPath), { recursive: true });
+                const handle = await open(this.lockPath, "wx");
+                return async () => {
+                    await handle.close().catch(() => undefined);
+                    await rm(this.lockPath, { force: true }).catch(() => undefined);
+                };
+            }
+            catch {
+                await new Promise((resolve) => setTimeout(resolve, 50 * (attempt + 1)));
+            }
+        }
+        throw new Error(`无法获取文件锁: ${this.lockPath}`);
+    }
+    async persistToDisk() {
+        const release = await this.acquireLock();
+        try {
+            await mkdir(dirname(this.filePath), { recursive: true });
+            const tempPath = `${this.filePath}.tmp`;
+            const payload = { entries: [...this.entries.values()] };
+            await writeFile(tempPath, JSON.stringify(payload), "utf8");
+            await rename(tempPath, this.filePath);
+        }
+        finally {
+            await release();
+        }
+    }
+}
+//# sourceMappingURL=local-fs.js.map

package/dist/vector/local-fs.js.map

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

package/dist/vector/qdrant.d.ts

@@ -0,0 +1,85 @@
+import { type VectorSearchResult, type VectorStore } from "@tachu/core";
+interface QdrantVectorStoreOptions {
+    url: string;
+    apiKey?: string;
+    collectionName: string;
+    vectorSize?: number;
+}
+/**
+ * Qdrant 远程向量存储适配器。
+ */
+export declare class QdrantVectorStore implements VectorStore {
+    private readonly client;
+    private readonly collectionName;
+    private readonly vectorSize;
+    private ensured;
+    private entryCount;
+    /**
+     * 创建 Qdrant 向量存储。
+     *
+     * @param options Qdrant 连接配置
+     */
+    constructor(options: QdrantVectorStoreOptions);
+    /**
+     * 文本向量化（**开发/占位实现**，基于哈希词袋）。
+     *
+     * ⚠️ **生产部署请务必注入真实 embedder**：
+     *
+     *   - 本方法采用简易哈希词袋（Hashing Trick）把文本投影到 `vectorSize` 维空间，
+     *     仅用于早期集成与开发环境跑通流程，**无法**刻画词序、语义相似度、跨语言对齐；
+     *   - 在真实的召回与排序场景（跨 session 记忆、多文档检索、向量知识库）下会产生
+     *     大量误召和漏召。
+     *
+     * **推荐做法**（v1.0 起）：
+     *
+     *   1. 由 Provider 层（OpenAI `text-embedding-3-*` / Anthropic 尚未官方支持，可
+     *      桥接第三方）生成向量；
+     *   2. 宿主侧在 `MemorySystem` 调用前统一用真实 embedder 计算向量，再调
+     *      `upsert(id, vector, metadata)` 这条显式向量分支；
+     *   3. 或者继承 `QdrantVectorStore` 并覆盖 `embed`，直接接入业务自选 embedding 服务。
+     *
+     * 参见 `D1-LOW-06`：该占位实现的 QPS 基准与精度限制已记录在 benchmarks 目录。
+     *
+     * @param texts 文本数组
+     * @returns 向量数组（单位向量，维度为 `vectorSize`）
+     */
+    embed(texts: string[]): Promise<number[][]>;
+    /**
+     * 写入或更新向量。
+     *
+     * @param id 条目 ID
+     * @param vectorOrText 向量或文本
+     * @param metadata 元数据
+     */
+    upsert(id: string, vectorOrText: number[] | string, metadata: Record<string, unknown>): Promise<void>;
+    /**
+     * 相似度搜索。
+     *
+     * @param query 查询向量或文本
+     * @param topK 结果数量
+     * @returns 搜索结果
+     */
+    search(query: number[] | string, topK: number): Promise<VectorSearchResult[]>;
+    /**
+     * 删除条目。
+     *
+     * @param id 条目 ID
+     */
+    delete(id: string): Promise<void>;
+    /**
+     * 清空集合。
+     */
+    clear(): Promise<void>;
+    /**
+     * 返回集合内条目数量。
+     *
+     * 远程实现对 `client.count(...)` 发起一次真值查询（`exact: true`），避免本地缓存
+     * 漂移导致读到旧值（D1-LOW-07）。collection 不存在等异常会被包装成 `ProviderError`。
+     *
+     * @returns 条目数（远程真值）
+     */
+    size(): Promise<number>;
+    private ensureCollection;
+}
+export {};
+//# sourceMappingURL=qdrant.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"qdrant.d.ts","sourceRoot":"","sources":["../../src/vector/qdrant.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,kBAAkB,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAGvF,UAAU,wBAAwB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAgCD;;GAEG;AACH,qBAAa,iBAAkB,YAAW,WAAW;IACnD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAK;IAEvB;;;;OAIG;gBACS,OAAO,EAAE,wBAAwB;IAS7C;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IAIjD;;;;;;OAMG;IACG,MAAM,CACV,EAAE,EAAE,MAAM,EACV,YAAY,EAAE,MAAM,EAAE,GAAG,MAAM,EAC/B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,IAAI,CAAC;IAkBhB;;;;;;OAMG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAsBnF;;;;OAIG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAavC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB5B;;;;;;;OAOG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;YAgBf,gBAAgB;CAe/B"}

package/dist/vector/qdrant.js

@@ -0,0 +1,208 @@
+import { ProviderError } from "@tachu/core";
+import { QdrantClient } from "@qdrant/js-client-rest";
+const DEFAULT_VECTOR_SIZE = 256;
+const hashToken = (token, size) => {
+    let hash = 0;
+    for (let index = 0; index < token.length; index += 1) {
+        hash = (hash * 31 + token.charCodeAt(index)) >>> 0;
+    }
+    return hash % size;
+};
+const embedText = (text, size) => {
+    const vector = new Array(size).fill(0);
+    const tokens = text
+        .toLowerCase()
+        .split(/[^a-z0-9\u4e00-\u9fa5]+/u)
+        .filter((token) => token.length > 0);
+    if (tokens.length === 0) {
+        return vector;
+    }
+    for (const token of tokens) {
+        const idx = hashToken(token, size);
+        vector[idx] += 1;
+    }
+    const norm = Math.sqrt(vector.reduce((sum, value) => sum + value * value, 0));
+    if (norm === 0) {
+        return vector;
+    }
+    return vector.map((value) => value / norm);
+};
+/**
+ * Qdrant 远程向量存储适配器。
+ */
+export class QdrantVectorStore {
+    client;
+    collectionName;
+    vectorSize;
+    ensured = false;
+    entryCount = 0;
+    /**
+     * 创建 Qdrant 向量存储。
+     *
+     * @param options Qdrant 连接配置
+     */
+    constructor(options) {
+        this.client = new QdrantClient({
+            url: options.url,
+            ...(options.apiKey ? { apiKey: options.apiKey } : {}),
+        });
+        this.collectionName = options.collectionName;
+        this.vectorSize = options.vectorSize ?? DEFAULT_VECTOR_SIZE;
+    }
+    /**
+     * 文本向量化（**开发/占位实现**，基于哈希词袋）。
+     *
+     * ⚠️ **生产部署请务必注入真实 embedder**：
+     *
+     *   - 本方法采用简易哈希词袋（Hashing Trick）把文本投影到 `vectorSize` 维空间，
+     *     仅用于早期集成与开发环境跑通流程，**无法**刻画词序、语义相似度、跨语言对齐；
+     *   - 在真实的召回与排序场景（跨 session 记忆、多文档检索、向量知识库）下会产生
+     *     大量误召和漏召。
+     *
+     * **推荐做法**（v1.0 起）：
+     *
+     *   1. 由 Provider 层（OpenAI `text-embedding-3-*` / Anthropic 尚未官方支持，可
+     *      桥接第三方）生成向量；
+     *   2. 宿主侧在 `MemorySystem` 调用前统一用真实 embedder 计算向量，再调
+     *      `upsert(id, vector, metadata)` 这条显式向量分支；
+     *   3. 或者继承 `QdrantVectorStore` 并覆盖 `embed`，直接接入业务自选 embedding 服务。
+     *
+     * 参见 `D1-LOW-06`：该占位实现的 QPS 基准与精度限制已记录在 benchmarks 目录。
+     *
+     * @param texts 文本数组
+     * @returns 向量数组（单位向量，维度为 `vectorSize`）
+     */
+    async embed(texts) {
+        return texts.map((text) => embedText(text, this.vectorSize));
+    }
+    /**
+     * 写入或更新向量。
+     *
+     * @param id 条目 ID
+     * @param vectorOrText 向量或文本
+     * @param metadata 元数据
+     */
+    async upsert(id, vectorOrText, metadata) {
+        try {
+            await this.ensureCollection();
+            const vector = typeof vectorOrText === "string" ? embedText(vectorOrText, this.vectorSize) : vectorOrText;
+            await this.client.upsert(this.collectionName, {
+                wait: true,
+                points: [{ id, vector, payload: metadata }],
+            });
+            this.entryCount += 1;
+        }
+        catch (error) {
+            throw new ProviderError("PROVIDER_UPSTREAM_ERROR", "Qdrant upsert 失败", {
+                cause: error,
+                retryable: true,
+            });
+        }
+    }
+    /**
+     * 相似度搜索。
+     *
+     * @param query 查询向量或文本
+     * @param topK 结果数量
+     * @returns 搜索结果
+     */
+    async search(query, topK) {
+        try {
+            await this.ensureCollection();
+            const vector = typeof query === "string" ? embedText(query, this.vectorSize) : query;
+            const result = await this.client.search(this.collectionName, {
+                vector,
+                limit: topK,
+                with_payload: true,
+            });
+            return result.map((item) => ({
+                id: String(item.id),
+                score: item.score,
+                metadata: (item.payload ?? {}),
+            }));
+        }
+        catch (error) {
+            throw new ProviderError("PROVIDER_UPSTREAM_ERROR", "Qdrant search 失败", {
+                cause: error,
+                retryable: true,
+            });
+        }
+    }
+    /**
+     * 删除条目。
+     *
+     * @param id 条目 ID
+     */
+    async delete(id) {
+        try {
+            await this.ensureCollection();
+            await this.client.delete(this.collectionName, { wait: true, points: [id] });
+            this.entryCount = Math.max(0, this.entryCount - 1);
+        }
+        catch (error) {
+            throw new ProviderError("PROVIDER_UPSTREAM_ERROR", "Qdrant delete 失败", {
+                cause: error,
+                retryable: true,
+            });
+        }
+    }
+    /**
+     * 清空集合。
+     */
+    async clear() {
+        try {
+            const exists = await this.client.collectionExists(this.collectionName);
+            if (exists.exists) {
+                await this.client.deleteCollection(this.collectionName);
+            }
+            this.ensured = false;
+            this.entryCount = 0;
+            await this.ensureCollection();
+        }
+        catch (error) {
+            throw new ProviderError("PROVIDER_UPSTREAM_ERROR", "Qdrant clear 失败", {
+                cause: error,
+                retryable: true,
+            });
+        }
+    }
+    /**
+     * 返回集合内条目数量。
+     *
+     * 远程实现对 `client.count(...)` 发起一次真值查询（`exact: true`），避免本地缓存
+     * 漂移导致读到旧值（D1-LOW-07）。collection 不存在等异常会被包装成 `ProviderError`。
+     *
+     * @returns 条目数（远程真值）
+     */
+    async size() {
+        try {
+            await this.ensureCollection();
+            const response = await this.client.count(this.collectionName, { exact: true });
+            const remoteCount = typeof response?.count === "number" ? response.count : this.entryCount;
+            this.entryCount = remoteCount;
+            return remoteCount;
+        }
+        catch (error) {
+            throw new ProviderError("PROVIDER_UPSTREAM_ERROR", "Qdrant count 失败", {
+                cause: error,
+                retryable: true,
+            });
+        }
+    }
+    async ensureCollection() {
+        if (this.ensured) {
+            return;
+        }
+        const exists = await this.client.collectionExists(this.collectionName);
+        if (!exists.exists) {
+            await this.client.createCollection(this.collectionName, {
+                vectors: {
+                    size: this.vectorSize,
+                    distance: "Cosine",
+                },
+            });
+        }
+        this.ensured = true;
+    }
+}
+//# sourceMappingURL=qdrant.js.map

package/dist/vector/qdrant.js.map

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

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@tachu/extensions",
+  "version": "1.0.0-alpha.1",
+  "description": "Tachu extensions (alpha) — OpenAI/Anthropic/Mock providers, 7 built-in tools, execution backends, MCP adapters (stdio+SSE), vector stores (local/Qdrant), observability emitters, input transformers and common rules.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "README_ZH.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "tachu",
+    "agent",
+    "llm",
+    "openai",
+    "anthropic",
+    "mcp",
+    "qdrant",
+    "opentelemetry",
+    "vector-store",
+    "provider",
+    "tools",
+    "bun",
+    "typescript"
+  ],
+  "author": "Tachu Contributors",
+  "license": "Apache-2.0",
+  "homepage": "https://github.com/dangaogit/tachu#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dangaogit/tachu.git",
+    "directory": "packages/extensions"
+  },
+  "bugs": {
+    "url": "https://github.com/dangaogit/tachu/issues"
+  },
+  "engines": {
+    "bun": ">=1.3.12"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.90.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@opentelemetry/api": "^1.9.1",
+    "@opentelemetry/sdk-trace-base": "^2.7.0",
+    "@opentelemetry/sdk-trace-node": "^2.7.0",
+    "@qdrant/js-client-rest": "^1.17.0",
+    "@tachu/core": "1.0.0-alpha.1",
+    "mammoth": "^1.12.0",
+    "openai": "^6.34.0",
+    "pdf-parse": "^2.4.5"
+  },
+  "scripts": {
+    "build": "bun run clean && bunx tsc -p tsconfig.build.json && bun ../../scripts/copy-md-assets.ts",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "test": "bun test",
+    "test:coverage": "bun test --coverage"
+  }
+}