@tachu/extensions 1.0.0-beta.1 → 1.0.0-rc.0

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

@@ -0,0 +1,216 @@
+import { existsSync } from "node:fs";
+import { mkdir, open, readFile, rename, rm, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+import { ProviderError, } from "@tachu/core";
+function cosineSimilarity(a, b) {
+    const length = Math.min(a.length, b.length);
+    if (length === 0)
+        return 0;
+    let dot = 0;
+    let aNorm = 0;
+    let bNorm = 0;
+    for (let i = 0; i < length; i += 1) {
+        const ai = a[i] ?? 0;
+        const bi = b[i] ?? 0;
+        dot += ai * bi;
+        aNorm += ai * ai;
+        bNorm += bi * bi;
+    }
+    if (aNorm === 0 || bNorm === 0)
+        return 0;
+    return dot / (Math.sqrt(aNorm) * Math.sqrt(bNorm));
+}
+function payloadMatchesFilters(payload, filters) {
+    const must = filters.must ?? {};
+    for (const [key, value] of Object.entries(must)) {
+        if (payload[key] !== value)
+            return false;
+    }
+    return true;
+}
+/**
+ * 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 class LocalFsVectorIndexAdapter {
+    filePath;
+    lockPath;
+    persistDebounceMs;
+    indexLimit;
+    entries = new Map();
+    initPromise;
+    persistTimer;
+    persisting = Promise.resolve();
+    constructor(options = {}) {
+        this.filePath = options.filePath ?? ".tachu/vector-index.json";
+        this.lockPath = `${this.filePath}.lock`;
+        this.persistDebounceMs = options.persistDebounceMs ?? 500;
+        this.indexLimit = options.indexLimit ?? 100_000;
+        this.initPromise = this.loadFromDisk();
+    }
+    async upsert(points, _ctx, signal) {
+        signal?.throwIfAborted();
+        await this.initPromise;
+        for (const point of points) {
+            if (typeof point.id !== "string" || point.id.length === 0) {
+                throw new ProviderError("PROVIDER_INVALID_REQUEST", "LocalFsVectorIndexAdapter.upsert requires a non-empty point id", { retryable: false });
+            }
+            if (!Array.isArray(point.vector) || point.vector.length === 0) {
+                throw new ProviderError("PROVIDER_INVALID_REQUEST", `LocalFsVectorIndexAdapter.upsert requires a numeric vector for ${point.id}; ` +
+                    "legacy string-embed shortcuts are not supported", { retryable: false });
+            }
+            if (point.vector.some((value) => typeof value !== "number")) {
+                throw new ProviderError("PROVIDER_INVALID_REQUEST", `LocalFsVectorIndexAdapter.upsert vector for ${point.id} contains non-numeric values`, { retryable: false });
+            }
+            const cloned = {
+                id: point.id,
+                vector: [...point.vector],
+                payload: { ...(point.payload ?? {}) },
+            };
+            if (!this.entries.has(point.id) && this.entries.size >= this.indexLimit) {
+                // FIFO eviction: drop the oldest entry to keep the file bounded.
+                const oldest = this.entries.keys().next();
+                if (!oldest.done && oldest.value !== undefined) {
+                    this.entries.delete(oldest.value);
+                }
+            }
+            this.entries.set(point.id, cloned);
+        }
+        this.schedulePersist();
+    }
+    async searchVector(query, topK, filters, _ctx, signal) {
+        signal?.throwIfAborted();
+        await this.initPromise;
+        if (!Array.isArray(query) || query.some((value) => typeof value !== "number")) {
+            throw new ProviderError("PROVIDER_INVALID_REQUEST", "LocalFsVectorIndexAdapter.searchVector requires a numeric query vector", { retryable: false });
+        }
+        const k = Math.max(0, Math.floor(topK));
+        if (k === 0)
+            return [];
+        const ranked = [];
+        for (const entry of this.entries.values()) {
+            if (!payloadMatchesFilters(entry.payload, filters))
+                continue;
+            const score = cosineSimilarity(query, entry.vector);
+            ranked.push({ id: entry.id, score, metadata: { ...entry.payload } });
+        }
+        ranked.sort((a, b) => b.score - a.score);
+        return ranked.slice(0, k);
+    }
+    async delete(ids, _ctx, signal) {
+        signal?.throwIfAborted();
+        await this.initPromise;
+        if (ids.length === 0)
+            return;
+        let changed = false;
+        for (const id of ids) {
+            if (this.entries.delete(id))
+                changed = true;
+        }
+        if (changed)
+            this.schedulePersist();
+    }
+    /** Test-only inspection helper. Not part of the {@link VectorIndexAdapter} contract. */
+    snapshot() {
+        return [...this.entries.values()].map((entry) => ({
+            id: entry.id,
+            vector: [...entry.vector],
+            payload: { ...entry.payload },
+        }));
+    }
+    /**
+    * 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.
+    */
+    async flush() {
+        if (this.persistTimer !== undefined) {
+            clearTimeout(this.persistTimer);
+            this.persistTimer = undefined;
+        }
+        this.persisting = this.persisting.then(() => this.persistToDisk());
+        await this.persisting;
+    }
+    async loadFromDisk() {
+        const raw = await readFile(this.filePath, "utf8").catch(() => "");
+        if (!raw)
+            return;
+        let payload;
+        try {
+            payload = JSON.parse(raw);
+        }
+        catch {
+            return;
+        }
+        for (const entry of payload.entries ?? []) {
+            if (typeof entry?.id !== "string" ||
+                !Array.isArray(entry.vector) ||
+                entry.vector.some((value) => typeof value !== "number")) {
+                continue;
+            }
+            this.entries.set(entry.id, {
+                id: entry.id,
+                vector: [...entry.vector],
+                payload: { ...(entry.payload ?? {}) },
+            });
+        }
+    }
+    schedulePersist() {
+        if (this.persistTimer)
+            clearTimeout(this.persistTimer);
+        this.persistTimer = setTimeout(() => {
+            this.persisting = this.persisting.then(() => this.persistToDisk());
+        }, this.persistDebounceMs);
+    }
+    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 = {
+                version: 1,
+                entries: [...this.entries.values()].map((entry) => ({
+                    id: entry.id,
+                    vector: [...entry.vector],
+                    payload: { ...entry.payload },
+                })),
+            };
+            await writeFile(tempPath, JSON.stringify(payload), "utf8");
+            await rename(tempPath, this.filePath);
+        }
+        finally {
+            await release();
+        }
+    }
+    // Keep `existsSync` reachable so tree-shakers don't drop the dependency
+    // when callers only invoke async paths.
+    static fileExists(path) {
+        return existsSync(path);
+    }
+}
+//# sourceMappingURL=local-fs-index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"local-fs-index.js","sourceRoot":"","sources":["../../src/vector/local-fs-index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAChF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EACL,aAAa,GAMd,MAAM,aAAa,CAAC;AAyBrB,SAAS,gBAAgB,CAAC,CAAW,EAAE,CAAW;IAChD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IAC5C,IAAI,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAC3B,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACrB,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACrB,GAAG,IAAI,EAAE,GAAG,EAAE,CAAC;QACf,KAAK,IAAI,EAAE,GAAG,EAAE,CAAC;QACjB,KAAK,IAAI,EAAE,GAAG,EAAE,CAAC;IACnB,CAAC;IACD,IAAI,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACzC,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;AACrD,CAAC;AAED,SAAS,qBAAqB,CAC5B,OAAgC,EAChC,OAA4B;IAE5B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;IAChC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK;YAAE,OAAO,KAAK,CAAC;IAC3C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,yBAAyB;IACnB,QAAQ,CAAS;IACjB,QAAQ,CAAS;IACjB,iBAAiB,CAAS;IAC1B,UAAU,CAAS;IACnB,OAAO,GAAG,IAAI,GAAG,EAA0B,CAAC;IAC5C,WAAW,CAAgB;IACpC,YAAY,CAA4C;IACxD,UAAU,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IAEtD,YAAY,UAA4C,EAAE;QACxD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,0BAA0B,CAAC;QAC/D,IAAI,CAAC,QAAQ,GAAG,GAAG,IAAI,CAAC,QAAQ,OAAO,CAAC;QACxC,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,IAAI,GAAG,CAAC;QAC1D,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC;QAChD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,MAAM,CACV,MAA8B,EAC9B,IAAwB,EACxB,MAAoB;QAEpB,MAAM,EAAE,cAAc,EAAE,CAAC;QACzB,MAAM,IAAI,CAAC,WAAW,CAAC;QACvB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,IAAI,KAAK,CAAC,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1D,MAAM,IAAI,aAAa,CACrB,0BAA0B,EAC1B,gEAAgE,EAChE,EAAE,SAAS,EAAE,KAAK,EAAE,CACrB,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC9D,MAAM,IAAI,aAAa,CACrB,0BAA0B,EAC1B,kEAAkE,KAAK,CAAC,EAAE,IAAI;oBAC5E,iDAAiD,EACnD,EAAE,SAAS,EAAE,KAAK,EAAE,CACrB,CAAC;YACJ,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,EAAE,CAAC;gBAC5D,MAAM,IAAI,aAAa,CACrB,0BAA0B,EAC1B,+CAA+C,KAAK,CAAC,EAAE,8BAA8B,EACrF,EAAE,SAAS,EAAE,KAAK,EAAE,CACrB,CAAC;YACJ,CAAC;YACD,MAAM,MAAM,GAAmB;gBAC7B,EAAE,EAAE,KAAK,CAAC,EAAE;gBACZ,MAAM,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;gBACzB,OAAO,EAAE,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE;aACtC,CAAC;YACF,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBAC/E,iEAAiE;gBAC1D,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;gBAC1C,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;oBAC/C,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACpC,CAAC;YACH,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QACrC,CAAC;QACD,IAAI,CAAC,eAAe,EAAE,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,KAAe,EACf,IAAY,EACZ,OAA4B,EAC5B,IAAwB,EACxB,MAAoB;QAEpB,MAAM,EAAE,cAAc,EAAE,CAAC;QACzB,MAAM,IAAI,CAAC,WAAW,CAAC;QACvB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,EAAE,CAAC;YAC9E,MAAM,IAAI,aAAa,CACrB,0BAA0B,EAC1B,wEAAwE,EACxE,EAAE,SAAS,EAAE,KAAK,EAAE,CACrB,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACvB,MAAM,MAAM,GAAgB,EAAE,CAAC;QAC/B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAC1C,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC;gBAAE,SAAS;YAC7D,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;YACpD,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACvE,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QACzC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,MAAM,CACV,GAAsB,EACtB,IAAwB,EACxB,MAAoB;QAEpB,MAAM,EAAE,cAAc,EAAE,CAAC;QACzB,MAAM,IAAI,CAAC,WAAW,CAAC;QACvB,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC7B,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;YACrB,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAAE,OAAO,GAAG,IAAI,CAAC;QAC9C,CAAC;QACD,IAAI,OAAO;YAAE,IAAI,CAAC,eAAe,EAAE,CAAC;IACtC,CAAC;IAEF,wFAAwF;IACvF,QAAQ;QACN,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAChD,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,MAAM,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;YACzB,OAAO,EAAE,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE;SAC9B,CAAC,CAAC,CAAC;IACN,CAAC;IAEF;;;;MAIE;IACD,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACpC,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAChC,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;QAChC,CAAC;QACD,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;QACnE,MAAM,IAAI,CAAC,UAAU,CAAC;IACxB,CAAC;IAEO,KAAK,CAAC,YAAY;QACxB,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QAClE,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,IAAI,OAAyB,CAAC;QAC9B,IAAI,CAAC;YACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAqB,CAAC;QAChD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;YAC1C,IACE,OAAO,KAAK,EAAE,EAAE,KAAK,QAAQ;gBAC7B,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC;gBAC5B,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAc,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,EAChE,CAAC;gBACD,SAAS;YACX,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE;gBACzB,EAAE,EAAE,KAAK,CAAC,EAAE;gBACZ,MAAM,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;gBACzB,OAAO,EAAE,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE;aACtC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAEO,eAAe;QACrB,IAAI,IAAI,CAAC,YAAY;YAAE,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACvD,IAAI,CAAC,YAAY,GAAG,UAAU,CAAC,GAAG,EAAE;YAClC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;QACrE,CAAC,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC7B,CAAC;IAEO,KAAK,CAAC,WAAW;QACvB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,EAAE,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;YACjD,IAAI,CAAC;gBACH,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBACzD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;gBAC/C,OAAO,KAAK,IAAI,EAAE;oBAChB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;oBAC5C,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;gBAClE,CAAC,CAAC;YACJ,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAChF,CAAC;QACH,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC/C,CAAC;IAEO,KAAK,CAAC,aAAa;QACzB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzC,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACzD,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,QAAQ,MAAM,CAAC;YACxC,MAAM,OAAO,GAAqB;gBAChC,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;oBAClD,EAAE,EAAE,KAAK,CAAC,EAAE;oBACZ,MAAM,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;oBACzB,OAAO,EAAE,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE;iBAC9B,CAAC,CAAC;aACJ,CAAC;YACF,MAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC;YAC3D,MAAM,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxC,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO,EAAE,CAAC;QAClB,CAAC;IACH,CAAC;IAEF,wEAAwE;IACxE,wCAAwC;IACvC,MAAM,CAAC,UAAU,CAAC,IAAY;QAC5B,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF"}

package/dist/vector/qdrant.d.ts

@@ -1,65 +1,24 @@
-import { type VectorSearchResult, type VectorStore } from "@tachu/core";
-interface QdrantVectorStoreOptions {
+import { type AdapterCallContext, type VectorHit, type VectorIndexAdapter, type VectorPayloadFilter, type VectorPoint } from "@tachu/core";
+export interface QdrantVectorIndexAdapterOptions {
     url: string;
     apiKey?: string;
     collectionName: string;
-    vectorSize?: number;
+    vectorSize: number;
 }
 /**
- * Qdrant 远程向量存储适配器。
+ * Qdrant pure vector index adapter (). No text embedding — vectors must be precomputed.
  */
-export declare class QdrantVectorStore implements VectorStore {
+export declare class QdrantVectorIndexAdapter implements VectorIndexAdapter {
     private readonly client;
     private readonly collectionName;
     private readonly vectorSize;
     private ensured;
-    private entryCount;
-    /**
-     * 创建 Qdrant 向量存储。
-     *
-     * @param options Qdrant 连接配置
-     */
-    constructor(options: QdrantVectorStoreOptions);
-    /**
-     * 文本向量化（本地哈希嵌入）。
-     *
-     * @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;
+    constructor(options: QdrantVectorIndexAdapterOptions);
+    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>;
     private ensureCollection;
 }
-export {};
+/** @deprecated Use {@link QdrantVectorIndexAdapter} (). */
+export { QdrantVectorIndexAdapter as QdrantVectorStore };
 //# sourceMappingURL=qdrant.d.ts.map

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

@@ -1 +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;;;;;OAKG;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;;;;OAIG;IACH,IAAI,IAAI,MAAM;YAIA,gBAAgB;CAe/B"}
+{"version":3,"file":"qdrant.d.ts","sourceRoot":"","sources":["../../src/vector/qdrant.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACd,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,WAAW,EACjB,MAAM,aAAa,CAAC;AAGrB,MAAM,WAAW,+BAA+B;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,wBAAyB,YAAW,kBAAkB;IACjE,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;gBAEZ,OAAO,EAAE,+BAA+B;IAS9C,MAAM,CACV,MAAM,EAAE,SAAS,WAAW,EAAE,EAC9B,IAAI,EAAE,kBAAkB,EACxB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC;IA6BV,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;IAuCjB,MAAM,CACV,GAAG,EAAE,SAAS,MAAM,EAAE,EACtB,IAAI,EAAE,kBAAkB,EACxB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC;YAcF,gBAAgB;CAa/B;AAED,2DAA2D;AAC3D,OAAO,EAAE,wBAAwB,IAAI,iBAAiB,EAAE,CAAC"}

package/dist/vector/qdrant.js

@@ -1,79 +1,38 @@
-import { ProviderError } from "@tachu/core";
+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 远程向量存储适配器。
+ * Qdrant pure vector index adapter (). No text embedding — vectors must be precomputed.
  */
-export class QdrantVectorStore {
+export class QdrantVectorIndexAdapter {
     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;
-    }
-    /**
-     * 文本向量化（本地哈希嵌入）。
-     *
-     * @param texts 文本数组
-     * @returns 向量数组
-     */
-    async embed(texts) {
-        return texts.map((text) => embedText(text, this.vectorSize));
+        this.vectorSize = options.vectorSize;
     }
-    /**
-     * 写入或更新向量。
-     *
-     * @param id 条目 ID
-     * @param vectorOrText 向量或文本
-     * @param metadata 元数据
-     */
-    async upsert(id, vectorOrText, metadata) {
+    async upsert(points, _ctx, signal) {
+        signal?.throwIfAborted();
+        for (const point of points) {
+            if (!Array.isArray(point.vector) || point.vector.length !== this.vectorSize) {
+                throw new ProviderError("PROVIDER_INVALID_REQUEST", `QdrantVectorIndexAdapter expects vectors of size ${this.vectorSize}`, { retryable: false });
+            }
+        }
         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 }],
+                points: points.map((point) => ({
+                    id: point.id,
+                    vector: point.vector,
+                    payload: point.payload,
+                })),
             });
-            this.entryCount += 1;
         }
         catch (error) {
             throw new ProviderError("PROVIDER_UPSTREAM_ERROR", "Qdrant upsert 失败", {
@@ -82,21 +41,26 @@ export class QdrantVectorStore {
             });
         }
     }
-    /**
-     * 相似度搜索。
-     *
-     * @param query 查询向量或文本
-     * @param topK 结果数量
-     * @returns 搜索结果
-     */
-    async search(query, topK) {
+    async searchVector(query, topK, filters, _ctx, signal) {
+        signal?.throwIfAborted();
+        if (!Array.isArray(query) || query.some((value) => typeof value !== "number")) {
+            throw new ProviderError("PROVIDER_INVALID_REQUEST", "QdrantVectorIndexAdapter.searchVector requires a numeric query vector", { retryable: false });
+        }
         try {
             await this.ensureCollection();
-            const vector = typeof query === "string" ? embedText(query, this.vectorSize) : query;
+            const filter = filters.must && Object.keys(filters.must).length > 0
+                ? {
+                    must: Object.entries(filters.must).map(([key, val]) => ({
+                        key,
+                        match: { value: val },
+                    })),
+                }
+                : undefined;
             const result = await this.client.search(this.collectionName, {
-                vector,
+                vector: query,
                 limit: topK,
                 with_payload: true,
+                ...(filter !== undefined ? { filter } : {}),
             });
             return result.map((item) => ({
                 id: String(item.id),
@@ -111,16 +75,13 @@ export class QdrantVectorStore {
             });
         }
     }
-    /**
-     * 删除条目。
-     *
-     * @param id 条目 ID
-     */
-    async delete(id) {
+    async delete(ids, _ctx, signal) {
+        signal?.throwIfAborted();
+        if (ids.length === 0)
+            return;
         try {
             await this.ensureCollection();
-            await this.client.delete(this.collectionName, { wait: true, points: [id] });
-            this.entryCount = Math.max(0, this.entryCount - 1);
+            await this.client.delete(this.collectionName, { wait: true, points: [...ids] });
         }
         catch (error) {
             throw new ProviderError("PROVIDER_UPSTREAM_ERROR", "Qdrant delete 失败", {
@@ -129,38 +90,9 @@ export class QdrantVectorStore {
             });
         }
     }
-    /**
-     * 清空集合。
-     */
-    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,
-            });
-        }
-    }
-    /**
-     * 返回估算条目数量。
-     *
-     * @returns 条目数
-     */
-    size() {
-        return this.entryCount;
-    }
     async ensureCollection() {
-        if (this.ensured) {
+        if (this.ensured)
             return;
-        }
         const exists = await this.client.collectionExists(this.collectionName);
         if (!exists.exists) {
             await this.client.createCollection(this.collectionName, {
@@ -173,4 +105,6 @@ export class QdrantVectorStore {
         this.ensured = true;
     }
 }
+/** @deprecated Use {@link QdrantVectorIndexAdapter} (). */
+export { QdrantVectorIndexAdapter as QdrantVectorStore };
 //# sourceMappingURL=qdrant.js.map

package/dist/vector/qdrant.js.map

@@ -1 +1 @@
-{"version":3,"file":"qdrant.js","sourceRoot":"","sources":["../../src/vector/qdrant.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"qdrant.js","sourceRoot":"","sources":["../../src/vector/qdrant.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,GAMd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAStD;;GAEG;AACH,MAAM,OAAO,wBAAwB;IAClB,MAAM,CAAe;IACrB,cAAc,CAAS;IACvB,UAAU,CAAS;IAC5B,OAAO,GAAG,KAAK,CAAC;IAExB,YAAY,OAAwC;QAClD,IAAI,CAAC,MAAM,GAAG,IAAI,YAAY,CAAC;YAC7B,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtD,CAAC,CAAC;QACH,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;QAC7C,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,MAAM,CACV,MAA8B,EAC9B,IAAwB,EACxB,MAAoB;QAEpB,MAAM,EAAE,cAAc,EAAE,CAAC;QACzB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,KAAK,IAAI,CAAC,UAAU,EAAE,CAAC;gBAC5E,MAAM,IAAI,aAAa,CACrB,0BAA0B,EAC1B,oDAAoD,IAAI,CAAC,UAAU,EAAE,EACrE,EAAE,SAAS,EAAE,KAAK,EAAE,CACrB,CAAC;YACJ,CAAC;QACH,CAAC;QACD,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC9B,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE;gBAC5C,IAAI,EAAE,IAAI;gBACV,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;oBAC7B,EAAE,EAAE,KAAK,CAAC,EAAE;oBACZ,MAAM,EAAE,KAAK,CAAC,MAAM;oBACpB,OAAO,EAAE,KAAK,CAAC,OAAO;iBACvB,CAAC,CAAC;aACJ,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,aAAa,CAAC,yBAAyB,EAAE,kBAAkB,EAAE;gBACrE,KAAK,EAAE,KAAK;gBACZ,SAAS,EAAE,IAAI;aAChB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,KAAe,EACf,IAAY,EACZ,OAA4B,EAC5B,IAAwB,EACxB,MAAoB;QAEpB,MAAM,EAAE,cAAc,EAAE,CAAC;QACzB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,EAAE,CAAC;YAC9E,MAAM,IAAI,aAAa,CACrB,0BAA0B,EAC1B,uEAAuE,EACvE,EAAE,SAAS,EAAE,KAAK,EAAE,CACrB,CAAC;QACJ,CAAC;QACD,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC9B,MAAM,MAAM,GACV,OAAO,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;gBAClD,CAAC,CAAC;oBACE,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;wBACtD,GAAG;wBACH,KAAK,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE;qBACtB,CAAC,CAAC;iBACJ;gBACH,CAAC,CAAC,SAAS,CAAC;YAChB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE;gBAC3D,MAAM,EAAE,KAAK;gBACb,KAAK,EAAE,IAAI;gBACX,YAAY,EAAE,IAAI;gBAClB,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC5C,CAAC,CAAC;YACH,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC3B,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,QAAQ,EAAE,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAA4B;aAC1D,CAAC,CAAC,CAAC;QACN,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,aAAa,CAAC,yBAAyB,EAAE,kBAAkB,EAAE;gBACrE,KAAK,EAAE,KAAK;gBACZ,SAAS,EAAE,IAAI;aAChB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CACV,GAAsB,EACtB,IAAwB,EACxB,MAAoB;QAEpB,MAAM,EAAE,cAAc,EAAE,CAAC;QACzB,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC7B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC9B,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC;QAClF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,aAAa,CAAC,yBAAyB,EAAE,kBAAkB,EAAE;gBACrE,KAAK,EAAE,KAAK;gBACZ,SAAS,EAAE,IAAI;aAChB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,gBAAgB;QAC5B,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACvE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,cAAc,EAAE;gBACtD,OAAO,EAAE;oBACP,IAAI,EAAE,IAAI,CAAC,UAAU;oBACrB,QAAQ,EAAE,QAAQ;iBACnB;aACF,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACtB,CAAC;CACF;AAED,2DAA2D;AAC3D,OAAO,EAAE,wBAAwB,IAAI,iBAAiB,EAAE,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tachu/extensions",
-  "version": "1.0.0-beta.1",
-  "description": "Tachu extensions — 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.",
+  "version": "1.0.0-rc.0",
+  "description": "Tachu extensions (release candidate) — OpenAI/Anthropic/Mock providers, 22 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",
@@ -10,6 +10,26 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "default": "./dist/index.js"
+    },
+    "./providers": {
+      "types": "./dist/providers/index.d.ts",
+      "import": "./dist/providers/index.js",
+      "default": "./dist/providers/index.js"
+    },
+    "./providers/gemini": {
+      "types": "./dist/providers/gemini.d.ts",
+      "import": "./dist/providers/gemini.js",
+      "default": "./dist/providers/gemini.js"
+    },
+    "./memory": {
+      "types": "./dist/memory/index.d.ts",
+      "import": "./dist/memory/index.js",
+      "default": "./dist/memory/index.js"
+    },
+    "./vector": {
+      "types": "./dist/vector/index.d.ts",
+      "import": "./dist/vector/index.js",
+      "default": "./dist/vector/index.js"
     }
   },
   "files": [
@@ -46,7 +66,7 @@
     "url": "https://github.com/dangaogit/tachu/issues"
   },
   "engines": {
-    "bun": ">=1.3.12"
+    "bun": ">=1.3.14"
   },
   "publishConfig": {
     "access": "public",
@@ -54,12 +74,13 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.90.0",
+    "@google/genai": "^2.3.0",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@opentelemetry/api": "^1.9.1",
-    "@opentelemetry/sdk-trace-base": "^2.6.1",
-    "@opentelemetry/sdk-trace-node": "^2.6.1",
+    "@opentelemetry/sdk-trace-base": "^2.7.0",
+    "@opentelemetry/sdk-trace-node": "^2.7.0",
     "@qdrant/js-client-rest": "^1.17.0",
-    "@tachu/core": "0.0.0",
+    "@tachu/core": "1.0.0-rc.0",
     "mammoth": "^1.12.0",
     "openai": "^6.34.0",
     "pdf-parse": "^2.4.5"