@aigne/afs-index 1.12.0-beta.5

package/dist/backend/types.d.mts.map

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

package/dist/backend/upstash-vector-backend.cjs

@@ -0,0 +1,98 @@
+
+//#region src/backend/upstash-vector-backend.ts
+const UPSTASH_MAX_TOP_K = 1e3;
+var UpstashVectorBackend = class {
+	constructor(url, token, scope) {
+		this.url = url;
+		this.token = token;
+		this.scope = scope;
+	}
+	async upsert(entryPath, vector, domain) {
+		const id = await hashVectorId(this.scope, entryPath);
+		const metadata = {
+			scope: this.scope,
+			entryPath
+		};
+		if (domain) metadata.domain = domain;
+		await this.request("upsert", [{
+			id,
+			vector,
+			metadata
+		}]);
+	}
+	async query(vector, filter, topK = 20) {
+		const boundedTopK = Math.min(topK, UPSTASH_MAX_TOP_K);
+		const filterStr = buildUpstashFilter(this.scope, filter);
+		const matches = await this.request("query", {
+			vector,
+			topK: boundedTopK,
+			filter: filterStr,
+			includeMetadata: true
+		});
+		if (!Array.isArray(matches)) return [];
+		let results = matches.filter((m) => typeof m.metadata?.entryPath === "string").map((m) => ({
+			entryPath: m.metadata.entryPath,
+			similarity: m.score
+		}));
+		if (filter.pathPrefix) {
+			const prefix = filter.pathPrefix;
+			results = results.filter((r) => r.entryPath.startsWith(prefix));
+		}
+		return results;
+	}
+	async delete(entryPath) {
+		const id = await hashVectorId(this.scope, entryPath);
+		await this.request("delete", [id]);
+	}
+	capability() {
+		return {
+			supported: true,
+			dimension: 0
+		};
+	}
+	async request(endpoint, body) {
+		const res = await fetch(`${this.url}/${endpoint}`, {
+			method: "POST",
+			headers: {
+				Authorization: `Bearer ${this.token}`,
+				"Content-Type": "application/json"
+			},
+			body: JSON.stringify(body)
+		});
+		if (!res.ok) {
+			const text = await res.text().catch(() => "(unreadable)");
+			throw new Error(`Upstash Vector /${endpoint}: ${res.status} ${text}`);
+		}
+		return (await res.json()).result;
+	}
+};
+/**
+* Build an Upstash SQL-like filter string for the query.
+* Scope is always required (enforces per-user isolation).
+* Domain values are escaped to prevent SQL injection via single-quote doubling.
+*/
+function buildUpstashFilter(scope, filter) {
+	const clauses = [`scope = '${escapeSql(scope)}'`];
+	if (filter.domain) clauses.push(`domain = '${escapeSql(filter.domain)}'`);
+	else if (filter.domains && filter.domains.length > 0) {
+		const list = filter.domains.map((d) => `'${escapeSql(d)}'`).join(", ");
+		clauses.push(`domain IN (${list})`);
+	}
+	return clauses.join(" AND ");
+}
+/** Escape a string for embedding in a SQL-like Upstash filter (double single-quotes). */
+function escapeSql(s) {
+	return s.replace(/'/g, "''");
+}
+/**
+* Derive a stable vector ID from scope + entryPath.
+* SHA-256 → 64 hex chars, which is safely within any vector store ID limit.
+*/
+async function hashVectorId(scope, entryPath) {
+	const data = new TextEncoder().encode(`${scope}:${entryPath}`);
+	const buf = await crypto.subtle.digest("SHA-256", data);
+	return Array.from(new Uint8Array(buf)).map((b) => b.toString(16).padStart(2, "0")).join("");
+}
+
+//#endregion
+exports.UpstashVectorBackend = UpstashVectorBackend;

package/dist/backend/upstash-vector-backend.d.cts

@@ -0,0 +1,21 @@
+import { VectorResult } from "../types.cjs";
+import { VectorBackend, VectorFilter } from "./vector-backend.cjs";
+
+//#region src/backend/upstash-vector-backend.d.ts
+declare class UpstashVectorBackend implements VectorBackend {
+  private readonly url;
+  private readonly token;
+  private readonly scope;
+  constructor(url: string, token: string, scope: string);
+  upsert(entryPath: string, vector: number[], domain?: string): Promise<void>;
+  query(vector: number[], filter: VectorFilter, topK?: number): Promise<VectorResult[]>;
+  delete(entryPath: string): Promise<void>;
+  capability(): {
+    supported: boolean;
+    dimension: number;
+  } | null;
+  private request;
+}
+//#endregion
+export { UpstashVectorBackend };
+//# sourceMappingURL=upstash-vector-backend.d.cts.map

package/dist/backend/upstash-vector-backend.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upstash-vector-backend.d.cts","names":[],"sources":["../../src/backend/upstash-vector-backend.ts"],"mappings":";;;;cA6Ba,oBAAA,YAAgC,aAAA;EAAA,iBAExB,GAAA;EAAA,iBACA,KAAA;EAAA,iBACA,KAAA;cAFA,GAAA,UACA,KAAA,UACA,KAAA;EAGb,MAAA,CAAO,SAAA,UAAmB,MAAA,YAAkB,MAAA,YAAkB,OAAA;EAS9D,KAAA,CAAM,MAAA,YAAkB,MAAA,EAAQ,YAAA,EAAc,IAAA,YAAY,OAAA,CAAQ,YAAA;EAoBlE,MAAA,CAAO,SAAA,WAAoB,OAAA;EAKjC,UAAA,CAAA;IAAgB,SAAA;IAAoB,SAAA;EAAA;EAAA,QAItB,OAAA;AAAA"}

package/dist/backend/upstash-vector-backend.d.mts

@@ -0,0 +1,21 @@
+import { VectorResult } from "../types.mjs";
+import { VectorBackend, VectorFilter } from "./vector-backend.mjs";
+
+//#region src/backend/upstash-vector-backend.d.ts
+declare class UpstashVectorBackend implements VectorBackend {
+  private readonly url;
+  private readonly token;
+  private readonly scope;
+  constructor(url: string, token: string, scope: string);
+  upsert(entryPath: string, vector: number[], domain?: string): Promise<void>;
+  query(vector: number[], filter: VectorFilter, topK?: number): Promise<VectorResult[]>;
+  delete(entryPath: string): Promise<void>;
+  capability(): {
+    supported: boolean;
+    dimension: number;
+  } | null;
+  private request;
+}
+//#endregion
+export { UpstashVectorBackend };
+//# sourceMappingURL=upstash-vector-backend.d.mts.map

package/dist/backend/upstash-vector-backend.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upstash-vector-backend.d.mts","names":[],"sources":["../../src/backend/upstash-vector-backend.ts"],"mappings":";;;;cA6Ba,oBAAA,YAAgC,aAAA;EAAA,iBAExB,GAAA;EAAA,iBACA,KAAA;EAAA,iBACA,KAAA;cAFA,GAAA,UACA,KAAA,UACA,KAAA;EAGb,MAAA,CAAO,SAAA,UAAmB,MAAA,YAAkB,MAAA,YAAkB,OAAA;EAS9D,KAAA,CAAM,MAAA,YAAkB,MAAA,EAAQ,YAAA,EAAc,IAAA,YAAY,OAAA,CAAQ,YAAA;EAoBlE,MAAA,CAAO,SAAA,WAAoB,OAAA;EAKjC,UAAA,CAAA;IAAgB,SAAA;IAAoB,SAAA;EAAA;EAAA,QAItB,OAAA;AAAA"}

package/dist/backend/upstash-vector-backend.mjs

@@ -0,0 +1,98 @@
+//#region src/backend/upstash-vector-backend.ts
+const UPSTASH_MAX_TOP_K = 1e3;
+var UpstashVectorBackend = class {
+	constructor(url, token, scope) {
+		this.url = url;
+		this.token = token;
+		this.scope = scope;
+	}
+	async upsert(entryPath, vector, domain) {
+		const id = await hashVectorId(this.scope, entryPath);
+		const metadata = {
+			scope: this.scope,
+			entryPath
+		};
+		if (domain) metadata.domain = domain;
+		await this.request("upsert", [{
+			id,
+			vector,
+			metadata
+		}]);
+	}
+	async query(vector, filter, topK = 20) {
+		const boundedTopK = Math.min(topK, UPSTASH_MAX_TOP_K);
+		const filterStr = buildUpstashFilter(this.scope, filter);
+		const matches = await this.request("query", {
+			vector,
+			topK: boundedTopK,
+			filter: filterStr,
+			includeMetadata: true
+		});
+		if (!Array.isArray(matches)) return [];
+		let results = matches.filter((m) => typeof m.metadata?.entryPath === "string").map((m) => ({
+			entryPath: m.metadata.entryPath,
+			similarity: m.score
+		}));
+		if (filter.pathPrefix) {
+			const prefix = filter.pathPrefix;
+			results = results.filter((r) => r.entryPath.startsWith(prefix));
+		}
+		return results;
+	}
+	async delete(entryPath) {
+		const id = await hashVectorId(this.scope, entryPath);
+		await this.request("delete", [id]);
+	}
+	capability() {
+		return {
+			supported: true,
+			dimension: 0
+		};
+	}
+	async request(endpoint, body) {
+		const res = await fetch(`${this.url}/${endpoint}`, {
+			method: "POST",
+			headers: {
+				Authorization: `Bearer ${this.token}`,
+				"Content-Type": "application/json"
+			},
+			body: JSON.stringify(body)
+		});
+		if (!res.ok) {
+			const text = await res.text().catch(() => "(unreadable)");
+			throw new Error(`Upstash Vector /${endpoint}: ${res.status} ${text}`);
+		}
+		return (await res.json()).result;
+	}
+};
+/**
+* Build an Upstash SQL-like filter string for the query.
+* Scope is always required (enforces per-user isolation).
+* Domain values are escaped to prevent SQL injection via single-quote doubling.
+*/
+function buildUpstashFilter(scope, filter) {
+	const clauses = [`scope = '${escapeSql(scope)}'`];
+	if (filter.domain) clauses.push(`domain = '${escapeSql(filter.domain)}'`);
+	else if (filter.domains && filter.domains.length > 0) {
+		const list = filter.domains.map((d) => `'${escapeSql(d)}'`).join(", ");
+		clauses.push(`domain IN (${list})`);
+	}
+	return clauses.join(" AND ");
+}
+/** Escape a string for embedding in a SQL-like Upstash filter (double single-quotes). */
+function escapeSql(s) {
+	return s.replace(/'/g, "''");
+}
+/**
+* Derive a stable vector ID from scope + entryPath.
+* SHA-256 → 64 hex chars, which is safely within any vector store ID limit.
+*/
+async function hashVectorId(scope, entryPath) {
+	const data = new TextEncoder().encode(`${scope}:${entryPath}`);
+	const buf = await crypto.subtle.digest("SHA-256", data);
+	return Array.from(new Uint8Array(buf)).map((b) => b.toString(16).padStart(2, "0")).join("");
+}
+
+//#endregion
+export { UpstashVectorBackend };
+//# sourceMappingURL=upstash-vector-backend.mjs.map

package/dist/backend/upstash-vector-backend.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"upstash-vector-backend.mjs","names":[],"sources":["../../src/backend/upstash-vector-backend.ts"],"sourcesContent":["/**\n * UpstashVectorBackend — VectorBackend backed by Upstash Vector REST API.\n *\n * Upstash Vector uses HTTP (no TCP), making it compatible with Cloudflare\n * Workers. Each instance is bound to one scope; isolation is enforced via\n * a metadata field filter on every query.\n *\n * Platform limits to be aware of:\n *   - Free plan: 10,000 vectors, 1,536 dimensions\n *   - Metadata filter syntax: SQL-like (`field = 'val' AND ...`)\n *   - topK: up to 1,000 per query\n *   - No vector ID length limit documented; SHA-256 hex (64 chars) is safe\n *\n * Env vars (read by the CF runtime factory, not here):\n *   AFS_UPSTASH_VECTOR_URL   — Upstash REST endpoint (e.g. https://xxx.upstash.io)\n *   AFS_UPSTASH_VECTOR_TOKEN — read-write token (secret)\n */\nimport type { VectorResult } from \"../types.js\";\nimport type { VectorBackend, VectorFilter } from \"./vector-backend.js\";\n\ninterface UpstashQueryMatch {\n  id: string;\n  score: number;\n  metadata?: Record<string, unknown>;\n}\n\n// Max topK Upstash Vector supports per query.\nconst UPSTASH_MAX_TOP_K = 1000;\n\nexport class UpstashVectorBackend implements VectorBackend {\n  constructor(\n    private readonly url: string,\n    private readonly token: string,\n    private readonly scope: string,\n  ) {}\n\n  async upsert(entryPath: string, vector: number[], domain?: string): Promise<void> {\n    const id = await hashVectorId(this.scope, entryPath);\n    // `domain` is filtered on at query time (buildUpstashFilter) — it MUST be\n    // stored here, else a boundDomains query's `domain IN (...)` matches nothing.\n    const metadata: Record<string, unknown> = { scope: this.scope, entryPath };\n    if (domain) metadata.domain = domain;\n    await this.request(\"upsert\", [{ id, vector, metadata }]);\n  }\n\n  async query(vector: number[], filter: VectorFilter, topK = 20): Promise<VectorResult[]> {\n    const boundedTopK = Math.min(topK, UPSTASH_MAX_TOP_K);\n    const filterStr = buildUpstashFilter(this.scope, filter);\n    const matches = await this.request<UpstashQueryMatch[]>(\"query\", {\n      vector,\n      topK: boundedTopK,\n      filter: filterStr,\n      includeMetadata: true,\n    });\n    if (!Array.isArray(matches)) return [];\n    let results: VectorResult[] = matches\n      .filter((m) => typeof m.metadata?.entryPath === \"string\")\n      .map((m) => ({ entryPath: m.metadata!.entryPath as string, similarity: m.score }));\n    if (filter.pathPrefix) {\n      const prefix = filter.pathPrefix;\n      results = results.filter((r) => r.entryPath.startsWith(prefix));\n    }\n    return results;\n  }\n\n  async delete(entryPath: string): Promise<void> {\n    const id = await hashVectorId(this.scope, entryPath);\n    await this.request(\"delete\", [id]);\n  }\n\n  capability(): { supported: boolean; dimension: number } | null {\n    return { supported: true, dimension: 0 };\n  }\n\n  private async request<T = unknown>(endpoint: string, body: unknown): Promise<T> {\n    const res = await fetch(`${this.url}/${endpoint}`, {\n      method: \"POST\",\n      headers: {\n        Authorization: `Bearer ${this.token}`,\n        \"Content-Type\": \"application/json\",\n      },\n      body: JSON.stringify(body),\n    });\n    if (!res.ok) {\n      const text = await res.text().catch(() => \"(unreadable)\");\n      throw new Error(`Upstash Vector /${endpoint}: ${res.status} ${text}`);\n    }\n    const json = (await res.json()) as { result: T };\n    return json.result;\n  }\n}\n\n/**\n * Build an Upstash SQL-like filter string for the query.\n * Scope is always required (enforces per-user isolation).\n * Domain values are escaped to prevent SQL injection via single-quote doubling.\n */\nfunction buildUpstashFilter(scope: string, filter: VectorFilter): string {\n  const clauses: string[] = [`scope = '${escapeSql(scope)}'`];\n  if (filter.domain) {\n    clauses.push(`domain = '${escapeSql(filter.domain)}'`);\n  } else if (filter.domains && filter.domains.length > 0) {\n    const list = filter.domains.map((d) => `'${escapeSql(d)}'`).join(\", \");\n    clauses.push(`domain IN (${list})`);\n  }\n  return clauses.join(\" AND \");\n}\n\n/** Escape a string for embedding in a SQL-like Upstash filter (double single-quotes). */\nfunction escapeSql(s: string): string {\n  return s.replace(/'/g, \"''\");\n}\n\n/**\n * Derive a stable vector ID from scope + entryPath.\n * SHA-256 → 64 hex chars, which is safely within any vector store ID limit.\n */\nasync function hashVectorId(scope: string, entryPath: string): Promise<string> {\n  const data = new TextEncoder().encode(`${scope}:${entryPath}`);\n  const buf = await crypto.subtle.digest(\"SHA-256\", data);\n  return Array.from(new Uint8Array(buf))\n    .map((b) => b.toString(16).padStart(2, \"0\"))\n    .join(\"\");\n}\n"],"mappings":";AA2BA,MAAM,oBAAoB;AAE1B,IAAa,uBAAb,MAA2D;CACzD,YACE,AAAiB,KACjB,AAAiB,OACjB,AAAiB,OACjB;EAHiB;EACA;EACA;;CAGnB,MAAM,OAAO,WAAmB,QAAkB,QAAgC;EAChF,MAAM,KAAK,MAAM,aAAa,KAAK,OAAO,UAAU;EAGpD,MAAM,WAAoC;GAAE,OAAO,KAAK;GAAO;GAAW;AAC1E,MAAI,OAAQ,UAAS,SAAS;AAC9B,QAAM,KAAK,QAAQ,UAAU,CAAC;GAAE;GAAI;GAAQ;GAAU,CAAC,CAAC;;CAG1D,MAAM,MAAM,QAAkB,QAAsB,OAAO,IAA6B;EACtF,MAAM,cAAc,KAAK,IAAI,MAAM,kBAAkB;EACrD,MAAM,YAAY,mBAAmB,KAAK,OAAO,OAAO;EACxD,MAAM,UAAU,MAAM,KAAK,QAA6B,SAAS;GAC/D;GACA,MAAM;GACN,QAAQ;GACR,iBAAiB;GAClB,CAAC;AACF,MAAI,CAAC,MAAM,QAAQ,QAAQ,CAAE,QAAO,EAAE;EACtC,IAAI,UAA0B,QAC3B,QAAQ,MAAM,OAAO,EAAE,UAAU,cAAc,SAAS,CACxD,KAAK,OAAO;GAAE,WAAW,EAAE,SAAU;GAAqB,YAAY,EAAE;GAAO,EAAE;AACpF,MAAI,OAAO,YAAY;GACrB,MAAM,SAAS,OAAO;AACtB,aAAU,QAAQ,QAAQ,MAAM,EAAE,UAAU,WAAW,OAAO,CAAC;;AAEjE,SAAO;;CAGT,MAAM,OAAO,WAAkC;EAC7C,MAAM,KAAK,MAAM,aAAa,KAAK,OAAO,UAAU;AACpD,QAAM,KAAK,QAAQ,UAAU,CAAC,GAAG,CAAC;;CAGpC,aAA+D;AAC7D,SAAO;GAAE,WAAW;GAAM,WAAW;GAAG;;CAG1C,MAAc,QAAqB,UAAkB,MAA2B;EAC9E,MAAM,MAAM,MAAM,MAAM,GAAG,KAAK,IAAI,GAAG,YAAY;GACjD,QAAQ;GACR,SAAS;IACP,eAAe,UAAU,KAAK;IAC9B,gBAAgB;IACjB;GACD,MAAM,KAAK,UAAU,KAAK;GAC3B,CAAC;AACF,MAAI,CAAC,IAAI,IAAI;GACX,MAAM,OAAO,MAAM,IAAI,MAAM,CAAC,YAAY,eAAe;AACzD,SAAM,IAAI,MAAM,mBAAmB,SAAS,IAAI,IAAI,OAAO,GAAG,OAAO;;AAGvE,UADc,MAAM,IAAI,MAAM,EAClB;;;;;;;;AAShB,SAAS,mBAAmB,OAAe,QAA8B;CACvE,MAAM,UAAoB,CAAC,YAAY,UAAU,MAAM,CAAC,GAAG;AAC3D,KAAI,OAAO,OACT,SAAQ,KAAK,aAAa,UAAU,OAAO,OAAO,CAAC,GAAG;UAC7C,OAAO,WAAW,OAAO,QAAQ,SAAS,GAAG;EACtD,MAAM,OAAO,OAAO,QAAQ,KAAK,MAAM,IAAI,UAAU,EAAE,CAAC,GAAG,CAAC,KAAK,KAAK;AACtE,UAAQ,KAAK,cAAc,KAAK,GAAG;;AAErC,QAAO,QAAQ,KAAK,QAAQ;;;AAI9B,SAAS,UAAU,GAAmB;AACpC,QAAO,EAAE,QAAQ,MAAM,KAAK;;;;;;AAO9B,eAAe,aAAa,OAAe,WAAoC;CAC7E,MAAM,OAAO,IAAI,aAAa,CAAC,OAAO,GAAG,MAAM,GAAG,YAAY;CAC9D,MAAM,MAAM,MAAM,OAAO,OAAO,OAAO,WAAW,KAAK;AACvD,QAAO,MAAM,KAAK,IAAI,WAAW,IAAI,CAAC,CACnC,KAAK,MAAM,EAAE,SAAS,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,CAC3C,KAAK,GAAG"}

package/dist/backend/vector-backend.d.cts

@@ -0,0 +1,29 @@
+import { VectorResult } from "../types.cjs";
+
+//#region src/backend/vector-backend.d.ts
+interface VectorFilter {
+  domain?: string;
+  domains?: string[];
+  pathPrefix?: string;
+}
+interface VectorBackend {
+  /**
+   * Store a vector for `entryPath`. `domain` (the entry's composite
+   * `{name}:{scope}`) MUST be persisted alongside so `query`'s `VectorFilter.
+   * domain(s)` can isolate cross-blocklet: backends without a join to
+   * `ds_indexed_entry` (Upstash/Vectorize) rely on it being in their own
+   * metadata — the D1 backend, which joins, ignores it. Omitting it makes the
+   * domain filter match nothing (empty results for any caller that passes
+   * boundDomains — i.e. every /user query).
+   */
+  upsert(entryPath: string, vector: number[], domain?: string): Promise<void>;
+  query(vector: number[], filter: VectorFilter, topK?: number): Promise<VectorResult[]>;
+  delete(entryPath: string): Promise<void>;
+  capability(): {
+    supported: boolean;
+    dimension: number;
+  } | null;
+}
+//#endregion
+export { VectorBackend, VectorFilter };
+//# sourceMappingURL=vector-backend.d.cts.map

package/dist/backend/vector-backend.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-backend.d.cts","names":[],"sources":["../../src/backend/vector-backend.ts"],"mappings":";;;UASiB,YAAA;EACf,MAAA;EACA,OAAA;EACA,UAAA;AAAA;AAAA,UAGe,aAAA;;;;;;;;;;EAUf,MAAA,CAAO,SAAA,UAAmB,MAAA,YAAkB,MAAA,YAAkB,OAAA;EAC9D,KAAA,CAAM,MAAA,YAAkB,MAAA,EAAQ,YAAA,EAAc,IAAA,YAAgB,OAAA,CAAQ,YAAA;EACtE,MAAA,CAAO,SAAA,WAAoB,OAAA;EAC3B,UAAA;IAAgB,SAAA;IAAoB,SAAA;EAAA;AAAA"}

package/dist/backend/vector-backend.d.mts

@@ -0,0 +1,29 @@
+import { VectorResult } from "../types.mjs";
+
+//#region src/backend/vector-backend.d.ts
+interface VectorFilter {
+  domain?: string;
+  domains?: string[];
+  pathPrefix?: string;
+}
+interface VectorBackend {
+  /**
+   * Store a vector for `entryPath`. `domain` (the entry's composite
+   * `{name}:{scope}`) MUST be persisted alongside so `query`'s `VectorFilter.
+   * domain(s)` can isolate cross-blocklet: backends without a join to
+   * `ds_indexed_entry` (Upstash/Vectorize) rely on it being in their own
+   * metadata — the D1 backend, which joins, ignores it. Omitting it makes the
+   * domain filter match nothing (empty results for any caller that passes
+   * boundDomains — i.e. every /user query).
+   */
+  upsert(entryPath: string, vector: number[], domain?: string): Promise<void>;
+  query(vector: number[], filter: VectorFilter, topK?: number): Promise<VectorResult[]>;
+  delete(entryPath: string): Promise<void>;
+  capability(): {
+    supported: boolean;
+    dimension: number;
+  } | null;
+}
+//#endregion
+export { VectorBackend, VectorFilter };
+//# sourceMappingURL=vector-backend.d.mts.map

package/dist/backend/vector-backend.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-backend.d.mts","names":[],"sources":["../../src/backend/vector-backend.ts"],"mappings":";;;UASiB,YAAA;EACf,MAAA;EACA,OAAA;EACA,UAAA;AAAA;AAAA,UAGe,aAAA;;;;;;;;;;EAUf,MAAA,CAAO,SAAA,UAAmB,MAAA,YAAkB,MAAA,YAAkB,OAAA;EAC9D,KAAA,CAAM,MAAA,YAAkB,MAAA,EAAQ,YAAA,EAAc,IAAA,YAAgB,OAAA,CAAQ,YAAA;EACtE,MAAA,CAAO,SAAA,WAAoB,OAAA;EAC3B,UAAA;IAAgB,SAAA;IAAoB,SAAA;EAAA;AAAA"}

package/dist/dirty-queue.d.cts

@@ -0,0 +1,41 @@
+//#region src/dirty-queue.d.ts
+/**
+ * DirtyPathQueue — consumer-side contract the IndexFollower drains
+ * (planning/index-provider/dirty-path-follower, design §7).
+ *
+ * This is the STRUCTURAL mirror of `@aigne/afs-did-space`'s dirty-path-queue
+ * contract. The index package and the did-space package do NOT depend on each
+ * other (they meet only at the runtime wiring layer, CF/Node), so — exactly like
+ * `spaceAfs: AFSRoot` and the `IndexBackend` interface — the follower declares
+ * the shape it needs and the runtime passes a did-space `PrefixedTreeIndex`
+ * (which implements these three methods) as a structurally-compatible value.
+ * Keep this in lockstep with did-space `src/dirty-path-queue.ts`.
+ */
+type DirtyPathOp = "put" | "delete";
+/**
+ * A dirty row handed to the follower. `path` is the fragment-STRIPPED
+ * `originalPath` (e.g. `items/x.json`) when the queue is a prefixed source
+ * (the normal wiring). `op/cid/latestSeq` drive scheduling + the ack race guard
+ * only — the follower re-reads live state before writing the index (design §4.3).
+ */
+interface DirtyPathRow {
+  path: string;
+  latestSeq: number;
+  op: DirtyPathOp;
+  cid?: string | null;
+  mtime: number;
+  attempts: number;
+}
+interface ListDirtyPathOptions {
+  prefix: string;
+  limit: number;
+  now?: number;
+}
+interface DirtyPathQueue {
+  listDirtyPaths(options: ListDirtyPathOptions): Promise<DirtyPathRow[]>;
+  ackDirtyPath(path: string, latestSeq: number): Promise<boolean>;
+  markDirtyPathError(path: string, latestSeq: number, error: string, nextAttemptAt: number): Promise<boolean>;
+}
+//#endregion
+export { DirtyPathOp, DirtyPathQueue, DirtyPathRow, ListDirtyPathOptions };
+//# sourceMappingURL=dirty-queue.d.cts.map

package/dist/dirty-queue.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dirty-queue.d.cts","names":[],"sources":["../src/dirty-queue.ts"],"mappings":";;AAaA;;;;;AAQA;;;;;;KARY,WAAA;;;;;;;UAQK,YAAA;EACf,IAAA;EACA,SAAA;EACA,EAAA,EAAI,WAAA;EACJ,GAAA;EACA,KAAA;EACA,QAAA;AAAA;AAAA,UAGe,oBAAA;EACf,MAAA;EACA,KAAA;EACA,GAAA;AAAA;AAAA,UAGe,cAAA;EACf,cAAA,CAAe,OAAA,EAAS,oBAAA,GAAuB,OAAA,CAAQ,YAAA;EACvD,YAAA,CAAa,IAAA,UAAc,SAAA,WAAoB,OAAA;EAC/C,kBAAA,CACE,IAAA,UACA,SAAA,UACA,KAAA,UACA,aAAA,WACC,OAAA;AAAA"}

package/dist/dirty-queue.d.mts

@@ -0,0 +1,41 @@
+//#region src/dirty-queue.d.ts
+/**
+ * DirtyPathQueue — consumer-side contract the IndexFollower drains
+ * (planning/index-provider/dirty-path-follower, design §7).
+ *
+ * This is the STRUCTURAL mirror of `@aigne/afs-did-space`'s dirty-path-queue
+ * contract. The index package and the did-space package do NOT depend on each
+ * other (they meet only at the runtime wiring layer, CF/Node), so — exactly like
+ * `spaceAfs: AFSRoot` and the `IndexBackend` interface — the follower declares
+ * the shape it needs and the runtime passes a did-space `PrefixedTreeIndex`
+ * (which implements these three methods) as a structurally-compatible value.
+ * Keep this in lockstep with did-space `src/dirty-path-queue.ts`.
+ */
+type DirtyPathOp = "put" | "delete";
+/**
+ * A dirty row handed to the follower. `path` is the fragment-STRIPPED
+ * `originalPath` (e.g. `items/x.json`) when the queue is a prefixed source
+ * (the normal wiring). `op/cid/latestSeq` drive scheduling + the ack race guard
+ * only — the follower re-reads live state before writing the index (design §4.3).
+ */
+interface DirtyPathRow {
+  path: string;
+  latestSeq: number;
+  op: DirtyPathOp;
+  cid?: string | null;
+  mtime: number;
+  attempts: number;
+}
+interface ListDirtyPathOptions {
+  prefix: string;
+  limit: number;
+  now?: number;
+}
+interface DirtyPathQueue {
+  listDirtyPaths(options: ListDirtyPathOptions): Promise<DirtyPathRow[]>;
+  ackDirtyPath(path: string, latestSeq: number): Promise<boolean>;
+  markDirtyPathError(path: string, latestSeq: number, error: string, nextAttemptAt: number): Promise<boolean>;
+}
+//#endregion
+export { DirtyPathOp, DirtyPathQueue, DirtyPathRow, ListDirtyPathOptions };
+//# sourceMappingURL=dirty-queue.d.mts.map

package/dist/dirty-queue.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dirty-queue.d.mts","names":[],"sources":["../src/dirty-queue.ts"],"mappings":";;AAaA;;;;;AAQA;;;;;;KARY,WAAA;;;;;;;UAQK,YAAA;EACf,IAAA;EACA,SAAA;EACA,EAAA,EAAI,WAAA;EACJ,GAAA;EACA,KAAA;EACA,QAAA;AAAA;AAAA,UAGe,oBAAA;EACf,MAAA;EACA,KAAA;EACA,GAAA;AAAA;AAAA,UAGe,cAAA;EACf,cAAA,CAAe,OAAA,EAAS,oBAAA,GAAuB,OAAA,CAAQ,YAAA;EACvD,YAAA,CAAa,IAAA,UAAc,SAAA,WAAoB,OAAA;EAC/C,kBAAA,CACE,IAAA,UACA,SAAA,UACA,KAAA,UACA,aAAA,WACC,OAAA;AAAA"}

package/dist/embed.cjs

@@ -0,0 +1,45 @@
+let ufo = require("ufo");
+
+//#region src/embed.ts
+const DEFAULT_EMBED_TIMEOUT_MS = 2e3;
+function embeddingTimeoutMs() {
+	const raw = (globalThis.process?.env)?.AFS_INDEX_EMBED_TIMEOUT_MS;
+	const parsed = raw ? Number(raw) : DEFAULT_EMBED_TIMEOUT_MS;
+	return Number.isFinite(parsed) && parsed > 0 ? parsed : DEFAULT_EMBED_TIMEOUT_MS;
+}
+async function withTimeout(promise, timeoutMs) {
+	let timer;
+	try {
+		return await Promise.race([promise, new Promise((resolve) => {
+			timer = setTimeout(() => resolve(null), timeoutMs);
+		})]);
+	} finally {
+		if (timer) clearTimeout(timer);
+	}
+}
+/**
+* Build an embedder. Returns null (never throws) when embedding is disabled,
+* unconfigured, or the inference call fails — callers degrade to FTS+anchor.
+*/
+function createEmbedder(opts) {
+	return async (text, type = "passage") => {
+		const { embeddingEnabled, llmProvider, embedRoot } = opts;
+		if (!text || !embeddingEnabled || !llmProvider || !embedRoot?.exec) return null;
+		const safeText = text.length > 6e3 ? text.slice(0, 6e3) : text;
+		try {
+			const result = await withTimeout(embedRoot.exec((0, ufo.joinURL)(llmProvider, ".actions", "embed"), {
+				text: safeText,
+				input: safeText,
+				type
+			}, {}), embeddingTimeoutMs());
+			if (!result || !result.success || !result.data) return null;
+			const data = result.data;
+			return data.embedding ?? data.embeddings?.[0] ?? null;
+		} catch {
+			return null;
+		}
+	};
+}
+
+//#endregion
+exports.createEmbedder = createEmbedder;

package/dist/embed.d.cts

@@ -0,0 +1,20 @@
+import { AFSRoot } from "@aigne/afs";
+
+//#region src/embed.d.ts
+interface EmbedderOptions {
+  /** Master switch — when false the embedder is a no-op (returns null). */
+  embeddingEnabled?: boolean;
+  /** AFS path of the embed model node, e.g. `/dev/ai/hubs/workers-ai/models/bge-m3`. */
+  llmProvider?: string;
+  /** AFS root whose `exec` reaches `<llmProvider>/.actions/embed` (a `/dev/ai` mount). */
+  embedRoot?: AFSRoot;
+}
+type Embedder = (text?: string, type?: "query" | "passage") => Promise<number[] | null>;
+/**
+ * Build an embedder. Returns null (never throws) when embedding is disabled,
+ * unconfigured, or the inference call fails — callers degrade to FTS+anchor.
+ */
+declare function createEmbedder(opts: EmbedderOptions): Embedder;
+//#endregion
+export { Embedder, EmbedderOptions, createEmbedder };
+//# sourceMappingURL=embed.d.cts.map

package/dist/embed.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed.d.cts","names":[],"sources":["../src/embed.ts"],"mappings":";;;UAYiB,eAAA;EAMI;EAJnB,gBAAA;EAOU;EALV,WAAA;;EAEA,SAAA,GAAY,OAAA;AAAA;AAAA,KAGF,QAAA,IAAY,IAAA,WAAe,IAAA,2BAA+B,OAAA;;;;AA8BtE;iBAAgB,cAAA,CAAe,IAAA,EAAM,eAAA,GAAkB,QAAA"}

package/dist/embed.d.mts

@@ -0,0 +1,20 @@
+import { AFSRoot } from "@aigne/afs";
+
+//#region src/embed.d.ts
+interface EmbedderOptions {
+  /** Master switch — when false the embedder is a no-op (returns null). */
+  embeddingEnabled?: boolean;
+  /** AFS path of the embed model node, e.g. `/dev/ai/hubs/workers-ai/models/bge-m3`. */
+  llmProvider?: string;
+  /** AFS root whose `exec` reaches `<llmProvider>/.actions/embed` (a `/dev/ai` mount). */
+  embedRoot?: AFSRoot;
+}
+type Embedder = (text?: string, type?: "query" | "passage") => Promise<number[] | null>;
+/**
+ * Build an embedder. Returns null (never throws) when embedding is disabled,
+ * unconfigured, or the inference call fails — callers degrade to FTS+anchor.
+ */
+declare function createEmbedder(opts: EmbedderOptions): Embedder;
+//#endregion
+export { Embedder, EmbedderOptions, createEmbedder };
+//# sourceMappingURL=embed.d.mts.map

package/dist/embed.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed.d.mts","names":[],"sources":["../src/embed.ts"],"mappings":";;;UAYiB,eAAA;EAMI;EAJnB,gBAAA;EAOU;EALV,WAAA;;EAEA,SAAA,GAAY,OAAA;AAAA;AAAA,KAGF,QAAA,IAAY,IAAA,WAAe,IAAA,2BAA+B,OAAA;;;;AA8BtE;iBAAgB,cAAA,CAAe,IAAA,EAAM,eAAA,GAAkB,QAAA"}

package/dist/embed.mjs

@@ -0,0 +1,46 @@
+import { joinURL } from "ufo";
+
+//#region src/embed.ts
+const DEFAULT_EMBED_TIMEOUT_MS = 2e3;
+function embeddingTimeoutMs() {
+	const raw = (globalThis.process?.env)?.AFS_INDEX_EMBED_TIMEOUT_MS;
+	const parsed = raw ? Number(raw) : DEFAULT_EMBED_TIMEOUT_MS;
+	return Number.isFinite(parsed) && parsed > 0 ? parsed : DEFAULT_EMBED_TIMEOUT_MS;
+}
+async function withTimeout(promise, timeoutMs) {
+	let timer;
+	try {
+		return await Promise.race([promise, new Promise((resolve) => {
+			timer = setTimeout(() => resolve(null), timeoutMs);
+		})]);
+	} finally {
+		if (timer) clearTimeout(timer);
+	}
+}
+/**
+* Build an embedder. Returns null (never throws) when embedding is disabled,
+* unconfigured, or the inference call fails — callers degrade to FTS+anchor.
+*/
+function createEmbedder(opts) {
+	return async (text, type = "passage") => {
+		const { embeddingEnabled, llmProvider, embedRoot } = opts;
+		if (!text || !embeddingEnabled || !llmProvider || !embedRoot?.exec) return null;
+		const safeText = text.length > 6e3 ? text.slice(0, 6e3) : text;
+		try {
+			const result = await withTimeout(embedRoot.exec(joinURL(llmProvider, ".actions", "embed"), {
+				text: safeText,
+				input: safeText,
+				type
+			}, {}), embeddingTimeoutMs());
+			if (!result || !result.success || !result.data) return null;
+			const data = result.data;
+			return data.embedding ?? data.embeddings?.[0] ?? null;
+		} catch {
+			return null;
+		}
+	};
+}
+
+//#endregion
+export { createEmbedder };
+//# sourceMappingURL=embed.mjs.map

package/dist/embed.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed.mjs","names":[],"sources":["../src/embed.ts"],"sourcesContent":["/**\n * Shared passage/query embedder for the semantic index (Epic #932).\n *\n * Both the query path (`AFSIndex.autoEmbed`) and the two index paths — the\n * `index` action AND the changelog follower — need to turn text into a vector\n * via the SAME `<llmProvider>/.actions/embed` call. Extracted here so the follower\n * (and the CF cron's `rebuildFollowerFromCursor`, which has no `AFSIndex` handle)\n * can embed identically without duplicating the request/response shape handling.\n */\nimport type { AFSRoot } from \"@aigne/afs\";\nimport { joinURL } from \"ufo\";\n\nexport interface EmbedderOptions {\n  /** Master switch — when false the embedder is a no-op (returns null). */\n  embeddingEnabled?: boolean;\n  /** AFS path of the embed model node, e.g. `/dev/ai/hubs/workers-ai/models/bge-m3`. */\n  llmProvider?: string;\n  /** AFS root whose `exec` reaches `<llmProvider>/.actions/embed` (a `/dev/ai` mount). */\n  embedRoot?: AFSRoot;\n}\n\nexport type Embedder = (text?: string, type?: \"query\" | \"passage\") => Promise<number[] | null>;\n\nconst DEFAULT_EMBED_TIMEOUT_MS = 2_000;\n\nfunction embeddingTimeoutMs(): number {\n  const env = (globalThis as { process?: { env?: Record<string, string | undefined> } }).process\n    ?.env;\n  const raw = env?.AFS_INDEX_EMBED_TIMEOUT_MS;\n  const parsed = raw ? Number(raw) : DEFAULT_EMBED_TIMEOUT_MS;\n  return Number.isFinite(parsed) && parsed > 0 ? parsed : DEFAULT_EMBED_TIMEOUT_MS;\n}\n\nasync function withTimeout<T>(promise: Promise<T>, timeoutMs: number): Promise<T | null> {\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  try {\n    return await Promise.race([\n      promise,\n      new Promise<null>((resolve) => {\n        timer = setTimeout(() => resolve(null), timeoutMs);\n      }),\n    ]);\n  } finally {\n    if (timer) clearTimeout(timer);\n  }\n}\n\n/**\n * Build an embedder. Returns null (never throws) when embedding is disabled,\n * unconfigured, or the inference call fails — callers degrade to FTS+anchor.\n */\nexport function createEmbedder(opts: EmbedderOptions): Embedder {\n  return async (text, type = \"passage\") => {\n    const { embeddingEnabled, llmProvider, embedRoot } = opts;\n    if (!text || !embeddingEnabled || !llmProvider || !embedRoot?.exec) {\n      return null;\n    }\n    // text-embedding-3-* / bge-m3 have ~8K-token contexts; ~6 chars/token, so\n    // 6000 chars stays well inside the cap so a verbose body doesn't 400.\n    const safeText = text.length > 6000 ? text.slice(0, 6000) : text;\n    try {\n      // Superset args: legacy/E5 `{ text, type }` → `{ embedding }`, and\n      // AigneHub/OpenAI `{ input }` → `{ embeddings: [[...]] }`. Accept either.\n      const result = await withTimeout(\n        embedRoot.exec(\n          joinURL(llmProvider, \".actions\", \"embed\"),\n          {\n            text: safeText,\n            input: safeText,\n            type,\n          },\n          {},\n        ),\n        embeddingTimeoutMs(),\n      );\n      if (!result || !result.success || !result.data) return null;\n      const data = result.data as { embedding?: number[]; embeddings?: number[][] };\n      return data.embedding ?? data.embeddings?.[0] ?? null;\n    } catch {\n      return null;\n    }\n  };\n}\n"],"mappings":";;;AAuBA,MAAM,2BAA2B;AAEjC,SAAS,qBAA6B;CAGpC,MAAM,OAFO,WAA0E,SACnF,MACa;CACjB,MAAM,SAAS,MAAM,OAAO,IAAI,GAAG;AACnC,QAAO,OAAO,SAAS,OAAO,IAAI,SAAS,IAAI,SAAS;;AAG1D,eAAe,YAAe,SAAqB,WAAsC;CACvF,IAAI;AACJ,KAAI;AACF,SAAO,MAAM,QAAQ,KAAK,CACxB,SACA,IAAI,SAAe,YAAY;AAC7B,WAAQ,iBAAiB,QAAQ,KAAK,EAAE,UAAU;IAClD,CACH,CAAC;WACM;AACR,MAAI,MAAO,cAAa,MAAM;;;;;;;AAQlC,SAAgB,eAAe,MAAiC;AAC9D,QAAO,OAAO,MAAM,OAAO,cAAc;EACvC,MAAM,EAAE,kBAAkB,aAAa,cAAc;AACrD,MAAI,CAAC,QAAQ,CAAC,oBAAoB,CAAC,eAAe,CAAC,WAAW,KAC5D,QAAO;EAIT,MAAM,WAAW,KAAK,SAAS,MAAO,KAAK,MAAM,GAAG,IAAK,GAAG;AAC5D,MAAI;GAGF,MAAM,SAAS,MAAM,YACnB,UAAU,KACR,QAAQ,aAAa,YAAY,QAAQ,EACzC;IACE,MAAM;IACN,OAAO;IACP;IACD,EACD,EAAE,CACH,EACD,oBAAoB,CACrB;AACD,OAAI,CAAC,UAAU,CAAC,OAAO,WAAW,CAAC,OAAO,KAAM,QAAO;GACvD,MAAM,OAAO,OAAO;AACpB,UAAO,KAAK,aAAa,KAAK,aAAa,MAAM;UAC3C;AACN,UAAO"}