@alexkroman1/aai 0.10.2 → 0.10.4

package/dist/sqlite-kv.d.ts

@@ -1,34 +0,0 @@
-/**
- * SQLite-backed key-value storage for local development.
- *
- * Persists data across restarts using a local SQLite database file.
- * Uses `node:sqlite` (built into Node 22+) — no native dependencies.
- * Drop-in replacement for the in-memory KV store.
- */
-import type { Kv } from "./kv.ts";
-/**
- * Options for creating a SQLite-backed KV store.
- */
-export type SqliteKvOptions = {
-    /** Path to the SQLite database file. Defaults to `.aai/local.db`. */
-    path?: string;
-};
-/**
- * Create a SQLite-backed KV store for local development.
- *
- * Data persists to a local SQLite file (default: `.aai/local.db`).
- * TTL expiration is enforced on reads and periodically cleaned up.
- *
- * @param options - Optional configuration. See {@link SqliteKvOptions}.
- * @returns A {@link Kv} instance backed by SQLite.
- *
- * @example
- * ```ts
- * import { createSqliteKv } from "@alexkroman1/aai/sqlite-kv";
- *
- * const kv = createSqliteKv();
- * await kv.set("greeting", "hello");
- * const value = await kv.get<string>("greeting"); // "hello"
- * ```
- */
-export declare function createSqliteKv(options?: SqliteKvOptions): Kv;

package/dist/sqlite-kv.js

@@ -1,133 +0,0 @@
-import { MAX_VALUE_SIZE, matchGlob, sortAndPaginate } from "./kv.js";
-import { DatabaseSync } from "node:sqlite";
-//#region sqlite-kv.ts
-/**
-* SQLite-backed key-value storage for local development.
-*
-* Persists data across restarts using a local SQLite database file.
-* Uses `node:sqlite` (built into Node 22+) — no native dependencies.
-* Drop-in replacement for the in-memory KV store.
-*/
-/**
-* Create a SQLite-backed KV store for local development.
-*
-* Data persists to a local SQLite file (default: `.aai/local.db`).
-* TTL expiration is enforced on reads and periodically cleaned up.
-*
-* @param options - Optional configuration. See {@link SqliteKvOptions}.
-* @returns A {@link Kv} instance backed by SQLite.
-*
-* @example
-* ```ts
-* import { createSqliteKv } from "@alexkroman1/aai/sqlite-kv";
-*
-* const kv = createSqliteKv();
-* await kv.set("greeting", "hello");
-* const value = await kv.get<string>("greeting"); // "hello"
-* ```
-*/
-function createSqliteKv(options) {
-	const db = new DatabaseSync(options?.path ?? ".aai/local.db");
-	db.exec("PRAGMA journal_mode = WAL");
-	db.exec(`
-    CREATE TABLE IF NOT EXISTS kv (
-      key   TEXT PRIMARY KEY,
-      value TEXT NOT NULL,
-      expires_at INTEGER
-    )
-  `);
-	db.exec(`
-    CREATE INDEX IF NOT EXISTS idx_kv_expires_at ON kv(expires_at)
-      WHERE expires_at IS NOT NULL
-  `);
-	const stmtGet = db.prepare("SELECT value, expires_at FROM kv WHERE key = ?");
-	const stmtUpsert = db.prepare("INSERT INTO kv (key, value, expires_at) VALUES (?, ?, ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value, expires_at = excluded.expires_at");
-	const stmtDelete = db.prepare("DELETE FROM kv WHERE key = ?");
-	const stmtDeleteExpired = db.prepare("DELETE FROM kv WHERE expires_at IS NOT NULL AND expires_at <= ?");
-	const stmtListPrefix = db.prepare("SELECT key, value FROM kv WHERE key >= ? AND key < ? AND (expires_at IS NULL OR expires_at > ?)");
-	const stmtListAll = db.prepare("SELECT key, value FROM kv WHERE expires_at IS NULL OR expires_at > ?");
-	const stmtKeysAll = db.prepare("SELECT key FROM kv WHERE expires_at IS NULL OR expires_at > ?");
-	const stmtKeysPrefix = db.prepare("SELECT key FROM kv WHERE key >= ? AND key < ? AND (expires_at IS NULL OR expires_at > ?)");
-	/** Compute the exclusive upper bound for a prefix scan. */
-	function prefixUpperBound(prefix) {
-		if (prefix === "") return "￿";
-		const last = prefix.charCodeAt(prefix.length - 1);
-		return prefix.slice(0, -1) + String.fromCharCode(last + 1);
-	}
-	const cleanupInterval = setInterval(() => {
-		stmtDeleteExpired.run(Date.now());
-	}, 6e4);
-	if (cleanupInterval.unref) cleanupInterval.unref();
-	return {
-		close() {
-			clearInterval(cleanupInterval);
-			db.close();
-		},
-		get(key) {
-			const now = Date.now();
-			const row = stmtGet.get(key);
-			if (!row) return Promise.resolve(null);
-			if (row.expires_at !== null && row.expires_at <= now) {
-				stmtDelete.run(key);
-				return Promise.resolve(null);
-			}
-			return Promise.resolve(JSON.parse(row.value));
-		},
-		set(key, value, setOptions) {
-			try {
-				const raw = JSON.stringify(value);
-				if (raw.length > 65536) return Promise.reject(/* @__PURE__ */ new Error(`Value exceeds max size of ${MAX_VALUE_SIZE} bytes`));
-				const expireIn = setOptions?.expireIn;
-				const expiresAt = expireIn && expireIn > 0 ? Date.now() + expireIn : null;
-				stmtUpsert.run(key, raw, expiresAt);
-				return Promise.resolve();
-			} catch (err) {
-				return Promise.reject(err);
-			}
-		},
-		delete(keys) {
-			const keyArray = Array.isArray(keys) ? keys : [keys];
-			for (const k of keyArray) stmtDelete.run(k);
-			return Promise.resolve();
-		},
-		list(prefix, listOptions) {
-			const now = Date.now();
-			let rows;
-			if (prefix === "") rows = stmtListAll.all(now);
-			else {
-				const upper = prefixUpperBound(prefix);
-				rows = stmtListPrefix.all(prefix, upper, now);
-			}
-			const entries = rows.map((row) => ({
-				key: row.key,
-				value: JSON.parse(row.value)
-			}));
-			return Promise.resolve(sortAndPaginate(entries, listOptions));
-		},
-		keys(pattern) {
-			const now = Date.now();
-			const isGlob = pattern?.includes("*");
-			if (!pattern) {
-				const keys = stmtKeysAll.all(now).map((r) => r.key);
-				return Promise.resolve(keys.sort((a, b) => a.localeCompare(b)));
-			}
-			if (isGlob) {
-				const starIdx = pattern.indexOf("*");
-				const prefix = pattern.slice(0, starIdx);
-				let rows;
-				if (prefix === "") rows = stmtKeysAll.all(now);
-				else {
-					const upper = prefixUpperBound(prefix);
-					rows = stmtKeysPrefix.all(prefix, upper, now);
-				}
-				const keys = rows.filter((r) => matchGlob(r.key, pattern)).map((r) => r.key);
-				return Promise.resolve(keys.sort((a, b) => a.localeCompare(b)));
-			}
-			const upper = prefixUpperBound(pattern);
-			const keys = stmtKeysPrefix.all(pattern, upper, now).map((r) => r.key);
-			return Promise.resolve(keys.sort((a, b) => a.localeCompare(b)));
-		}
-	};
-}
-//#endregion
-export { createSqliteKv };

package/dist/sqlite-vector.d.ts

@@ -1,58 +0,0 @@
-/**
- * SQLite-backed vector store with local embeddings.
- *
- * Persists data across restarts using a local SQLite database file.
- * Uses brute-force cosine similarity over `node:sqlite` — no native
- * extensions required. Fast enough for local dev (sub-ms for <10k vectors).
- * Embeddings are computed locally via `all-MiniLM-L6-v2` (384 dims) —
- * no external API key required. The model is downloaded on first use
- * (~86 MB) and cached in `.aai/models/`.
- */
-import type { VectorStore } from "./vector.ts";
-/** Function that converts text into an embedding vector. */
-export type EmbedFn = (text: string) => Promise<number[]>;
-/**
- * Options for creating a SQLite-vec backed vector store.
- */
-export type SqliteVecVectorStoreOptions = {
-    /** Path to the SQLite database file. Defaults to `.aai/vectors.db`. */
-    path?: string;
-    /** Custom embedding function. Defaults to local `all-MiniLM-L6-v2` model. */
-    embedFn?: EmbedFn;
-    /** Embedding dimensions. Must match the embedFn output. Defaults to 384. */
-    dimensions?: number;
-    /** Directory for caching downloaded models. Defaults to `.aai/models`. */
-    modelCacheDir?: string;
-};
-/**
- * Create a deterministic hash-based embedding function for testing.
- *
- * Produces repeatable vectors where similar text yields similar embeddings.
- * Not suitable for production — use the default local model instead.
- *
- * @param dimensions - Vector dimensions (default: 384).
- */
-export declare function createTestEmbedFn(dimensions?: number): EmbedFn;
-/**
- * Create a SQLite-backed vector store with local embeddings.
- *
- * Data persists to a local SQLite file (default: `.aai/vectors.db`).
- * Embeddings are computed locally using `all-MiniLM-L6-v2` by default —
- * no API key required. The model auto-downloads on first use (~86 MB).
- *
- * Vector search uses brute-force cosine similarity over all stored
- * embeddings. This is fast for local dev workloads (<10k vectors).
- *
- * @param options - See {@link SqliteVecVectorStoreOptions}.
- * @returns A {@link VectorStore} instance.
- *
- * @example
- * ```ts
- * import { createSqliteVectorStore } from "@alexkroman1/aai/sqlite-vector";
- *
- * const vector = createSqliteVectorStore();
- * await vector.upsert("doc-1", "The capital of France is Paris.");
- * const results = await vector.query("France capital");
- * ```
- */
-export declare function createSqliteVectorStore(options?: SqliteVecVectorStoreOptions): VectorStore;

package/dist/sqlite-vector.js

@@ -1,149 +0,0 @@
-import { DatabaseSync } from "node:sqlite";
-//#region sqlite-vector.ts
-/**
-* SQLite-backed vector store with local embeddings.
-*
-* Persists data across restarts using a local SQLite database file.
-* Uses brute-force cosine similarity over `node:sqlite` — no native
-* extensions required. Fast enough for local dev (sub-ms for <10k vectors).
-* Embeddings are computed locally via `all-MiniLM-L6-v2` (384 dims) —
-* no external API key required. The model is downloaded on first use
-* (~86 MB) and cached in `.aai/models/`.
-*/
-const DEFAULT_DIMENSIONS = 384;
-const DEFAULT_MODEL = "Xenova/all-MiniLM-L6-v2";
-/**
-* Create a local embedding function using `all-MiniLM-L6-v2`.
-*
-* The model is downloaded on first use (~86 MB) and cached locally.
-* Subsequent calls load from cache in ~90ms. Each embedding takes <2ms.
-*/
-function createLocalEmbedFn(cacheDir) {
-	let pipelinePromise = null;
-	async function getPipeline() {
-		if (!pipelinePromise) pipelinePromise = (async () => {
-			const { pipeline, env } = await import("@huggingface/transformers");
-			env.cacheDir = cacheDir;
-			return pipeline("feature-extraction", DEFAULT_MODEL);
-		})();
-		return pipelinePromise;
-	}
-	return async (text) => {
-		const output = await (await getPipeline())(text, {
-			pooling: "mean",
-			normalize: true
-		});
-		return Array.from(output.data);
-	};
-}
-/**
-* Create a deterministic hash-based embedding function for testing.
-*
-* Produces repeatable vectors where similar text yields similar embeddings.
-* Not suitable for production — use the default local model instead.
-*
-* @param dimensions - Vector dimensions (default: 384).
-*/
-function createTestEmbedFn(dimensions = DEFAULT_DIMENSIONS) {
-	return async (text) => {
-		const vec = new Float32Array(dimensions);
-		const words = text.toLowerCase().split(/\s+/).filter(Boolean);
-		for (const word of words) {
-			let hash = 0;
-			for (let i = 0; i < word.length; i++) hash = (hash << 5) - hash + word.charCodeAt(i) | 0;
-			for (let i = 0; i < 8; i++) {
-				const idx = Math.abs((hash + i * 31337) % dimensions);
-				vec[idx] = (vec[idx] ?? 0) + 1;
-			}
-		}
-		let norm = 0;
-		for (let i = 0; i < dimensions; i++) norm += (vec[i] ?? 0) * (vec[i] ?? 0);
-		norm = Math.sqrt(norm) || 1;
-		return Array.from(vec, (v) => v / norm);
-	};
-}
-/** Cosine similarity between two vectors stored as Buffers of float32. */
-function cosineSimilarity(a, b) {
-	const fa = new Float32Array(a.buffer, a.byteOffset, a.byteLength / 4);
-	const fb = new Float32Array(b.buffer, b.byteOffset, b.byteLength / 4);
-	let dot = 0;
-	let normA = 0;
-	let normB = 0;
-	for (let i = 0; i < fa.length; i++) {
-		const ai = fa[i] ?? 0;
-		const bi = fb[i] ?? 0;
-		dot += ai * bi;
-		normA += ai * ai;
-		normB += bi * bi;
-	}
-	const denom = Math.sqrt(normA) * Math.sqrt(normB);
-	return denom === 0 ? 0 : dot / denom;
-}
-/**
-* Create a SQLite-backed vector store with local embeddings.
-*
-* Data persists to a local SQLite file (default: `.aai/vectors.db`).
-* Embeddings are computed locally using `all-MiniLM-L6-v2` by default —
-* no API key required. The model auto-downloads on first use (~86 MB).
-*
-* Vector search uses brute-force cosine similarity over all stored
-* embeddings. This is fast for local dev workloads (<10k vectors).
-*
-* @param options - See {@link SqliteVecVectorStoreOptions}.
-* @returns A {@link VectorStore} instance.
-*
-* @example
-* ```ts
-* import { createSqliteVectorStore } from "@alexkroman1/aai/sqlite-vector";
-*
-* const vector = createSqliteVectorStore();
-* await vector.upsert("doc-1", "The capital of France is Paris.");
-* const results = await vector.query("France capital");
-* ```
-*/
-function createSqliteVectorStore(options) {
-	const dbPath = options?.path ?? ".aai/vectors.db";
-	const cacheDir = options?.modelCacheDir ?? ".aai/models";
-	const embedFn = options?.embedFn ?? createLocalEmbedFn(cacheDir);
-	const db = new DatabaseSync(dbPath);
-	db.exec("PRAGMA journal_mode = WAL");
-	db.exec(`
-    CREATE TABLE IF NOT EXISTS vectors (
-      id TEXT PRIMARY KEY,
-      data TEXT NOT NULL,
-      metadata TEXT NOT NULL DEFAULT '',
-      embedding BLOB NOT NULL
-    )
-  `);
-	const stmtUpsert = db.prepare("INSERT OR REPLACE INTO vectors (id, data, metadata, embedding) VALUES (?, ?, ?, ?)");
-	const stmtDelete = db.prepare("DELETE FROM vectors WHERE id = ?");
-	const stmtAll = db.prepare("SELECT id, data, metadata, embedding FROM vectors");
-	return {
-		async upsert(id, data, metadata) {
-			const vector = await embedFn(data);
-			const embedding = Buffer.from(new Float32Array(vector).buffer);
-			const metaJson = metadata ? JSON.stringify(metadata) : "";
-			stmtUpsert.run(id, data, metaJson, embedding);
-		},
-		async query(text, queryOptions) {
-			const topK = queryOptions?.topK ?? 10;
-			if (!text.trim()) return [];
-			const queryVec = await embedFn(text);
-			const queryBuf = Buffer.from(new Float32Array(queryVec).buffer);
-			const scored = stmtAll.all().map((row) => ({
-				id: row.id,
-				score: cosineSimilarity(queryBuf, row.embedding),
-				data: row.data,
-				metadata: row.metadata && row.metadata !== "" ? JSON.parse(row.metadata) : void 0
-			}));
-			scored.sort((a, b) => b.score - a.score);
-			return scored.slice(0, topK);
-		},
-		async delete(ids) {
-			const idArray = Array.isArray(ids) ? ids : [ids];
-			for (const id of idArray) stmtDelete.run(id);
-		}
-	};
-}
-//#endregion
-export { createSqliteVectorStore, createTestEmbedFn };

package/dist/telemetry.d.ts

@@ -1,49 +0,0 @@
-/**
- * OpenTelemetry instrumentation helpers for the AAI SDK.
- *
- * Uses `@opentelemetry/api` only — consumers bring their own SDK and
- * exporters.  When no SDK is configured the API returns no-op instances,
- * so the overhead in uninstrumented environments is negligible.
- *
- * Provides:
- * - `tracer`  — a pre-scoped `Tracer` for creating spans
- * - `meter`   — a pre-scoped `Meter` for recording metrics
- * - Pre-built counters, histograms, and up/down counters covering the
- *   STT → LLM → TTS pipeline
- */
-import { type Meter, type Span, type Tracer } from "@opentelemetry/api";
-/** Tracer scoped to the AAI SDK. */
-export declare const tracer: Tracer;
-/** Meter scoped to the AAI SDK. */
-export declare const meter: Meter;
-/** Total sessions opened. */
-export declare const sessionCounter: import("@opentelemetry/api").Counter<import("@opentelemetry/api").Attributes>;
-/** Currently active sessions. */
-export declare const activeSessionsUpDown: import("@opentelemetry/api").UpDownCounter<import("@opentelemetry/api").Attributes>;
-/** Total user turns (speech → transcript). */
-export declare const turnCounter: import("@opentelemetry/api").Counter<import("@opentelemetry/api").Attributes>;
-/** Total tool calls executed. */
-export declare const toolCallCounter: import("@opentelemetry/api").Counter<import("@opentelemetry/api").Attributes>;
-/** Tool call execution duration in seconds. */
-export declare const toolCallDuration: import("@opentelemetry/api").Histogram<import("@opentelemetry/api").Attributes>;
-/** Total tool call errors. */
-export declare const toolCallErrorCounter: import("@opentelemetry/api").Counter<import("@opentelemetry/api").Attributes>;
-/** S2S WebSocket connection duration in seconds. */
-export declare const s2sConnectionDuration: import("@opentelemetry/api").Histogram<import("@opentelemetry/api").Attributes>;
-/** Total S2S errors. */
-export declare const s2sErrorCounter: import("@opentelemetry/api").Counter<import("@opentelemetry/api").Attributes>;
-/** Number of agentic loop steps (tool calls) per completed turn. */
-export declare const turnStepsHistogram: import("@opentelemetry/api").Histogram<import("@opentelemetry/api").Attributes>;
-/** Total barge-in (reply interrupted) events. */
-export declare const bargeInCounter: import("@opentelemetry/api").Counter<import("@opentelemetry/api").Attributes>;
-/** Messages silently dropped because the WebSocket was closed. */
-export declare const wsSendDroppedCounter: import("@opentelemetry/api").Counter<import("@opentelemetry/api").Attributes>;
-/** Sessions closed due to S2S idle timeout. */
-export declare const idleTimeoutCounter: import("@opentelemetry/api").Counter<import("@opentelemetry/api").Attributes>;
-/**
- * Run `fn` inside a new span. The span is automatically ended and its
- * status set based on whether `fn` throws.
- */
-export declare function withSpan<T>(name: string, fn: (span: Span) => T): T;
-export type { Meter, Span, Tracer } from "@opentelemetry/api";
-export { context, metrics, SpanStatusCode, trace } from "@opentelemetry/api";

package/dist/telemetry.js

@@ -1,95 +0,0 @@
-import { createRequire } from "node:module";
-import { SpanStatusCode, SpanStatusCode as SpanStatusCode$1, context, metrics, metrics as metrics$1, trace, trace as trace$1 } from "@opentelemetry/api";
-//#region telemetry.ts
-/**
-* OpenTelemetry instrumentation helpers for the AAI SDK.
-*
-* Uses `@opentelemetry/api` only — consumers bring their own SDK and
-* exporters.  When no SDK is configured the API returns no-op instances,
-* so the overhead in uninstrumented environments is negligible.
-*
-* Provides:
-* - `tracer`  — a pre-scoped `Tracer` for creating spans
-* - `meter`   — a pre-scoped `Meter` for recording metrics
-* - Pre-built counters, histograms, and up/down counters covering the
-*   STT → LLM → TTS pipeline
-*/
-const SCOPE = "aai";
-const _require = createRequire(import.meta.url);
-let VERSION = "0.0.0";
-try {
-	VERSION = _require("./package.json").version;
-} catch {
-	VERSION = _require("../package.json").version;
-}
-/** Tracer scoped to the AAI SDK. */
-const tracer = trace$1.getTracer(SCOPE, VERSION);
-/** Meter scoped to the AAI SDK. */
-const meter = metrics$1.getMeter(SCOPE, VERSION);
-/** Total sessions opened. */
-const sessionCounter = meter.createCounter("aai.session.count", { description: "Total voice sessions opened" });
-/** Currently active sessions. */
-const activeSessionsUpDown = meter.createUpDownCounter("aai.session.active", { description: "Currently active voice sessions" });
-/** Total user turns (speech → transcript). */
-const turnCounter = meter.createCounter("aai.turn.count", { description: "Total user turns" });
-/** Total tool calls executed. */
-const toolCallCounter = meter.createCounter("aai.tool.call.count", { description: "Total tool calls executed" });
-/** Tool call execution duration in seconds. */
-const toolCallDuration = meter.createHistogram("aai.tool.call.duration", {
-	description: "Tool call execution duration in seconds",
-	unit: "s"
-});
-/** Total tool call errors. */
-const toolCallErrorCounter = meter.createCounter("aai.tool.call.error.count", { description: "Total tool call errors" });
-/** S2S WebSocket connection duration in seconds. */
-const s2sConnectionDuration = meter.createHistogram("aai.s2s.connection.duration", {
-	description: "S2S WebSocket connection duration in seconds",
-	unit: "s"
-});
-/** Total S2S errors. */
-const s2sErrorCounter = meter.createCounter("aai.s2s.error.count", { description: "Total S2S errors" });
-/** Number of agentic loop steps (tool calls) per completed turn. */
-const turnStepsHistogram = meter.createHistogram("aai.turn.steps", { description: "Number of agentic loop steps per completed turn" });
-/** Total barge-in (reply interrupted) events. */
-const bargeInCounter = meter.createCounter("aai.turn.bargein.count", { description: "Total barge-in (reply interrupted) events" });
-/** Messages silently dropped because the WebSocket was closed. */
-const wsSendDroppedCounter = meter.createCounter("aai.ws.send_dropped", { description: "Messages silently dropped because the WebSocket was closed" });
-/** Sessions closed due to S2S idle timeout. */
-const idleTimeoutCounter = meter.createCounter("aai.session.idle.timeout.count", { description: "Sessions closed due to S2S idle timeout" });
-/**
-* Run `fn` inside a new span. The span is automatically ended and its
-* status set based on whether `fn` throws.
-*/
-function withSpan(name, fn) {
-	return tracer.startActiveSpan(name, (span) => {
-		try {
-			const result = fn(span);
-			if (result instanceof Promise) return result.then((v) => {
-				span.setStatus({ code: SpanStatusCode$1.OK });
-				span.end();
-				return v;
-			}).catch((err) => {
-				span.setStatus({
-					code: SpanStatusCode$1.ERROR,
-					message: err instanceof Error ? err.message : String(err)
-				});
-				span.recordException(err instanceof Error ? err : new Error(String(err)));
-				span.end();
-				throw err;
-			});
-			span.setStatus({ code: SpanStatusCode$1.OK });
-			span.end();
-			return result;
-		} catch (err) {
-			span.setStatus({
-				code: SpanStatusCode$1.ERROR,
-				message: err instanceof Error ? err.message : String(err)
-			});
-			span.recordException(err instanceof Error ? err : new Error(String(err)));
-			span.end();
-			throw err;
-		}
-	});
-}
-//#endregion
-export { SpanStatusCode, activeSessionsUpDown, bargeInCounter, context, idleTimeoutCounter, meter, metrics, s2sConnectionDuration, s2sErrorCounter, sessionCounter, toolCallCounter, toolCallDuration, toolCallErrorCounter, trace, tracer, turnCounter, turnStepsHistogram, withSpan, wsSendDroppedCounter };

package/dist/vector.d.ts

@@ -1,85 +0,0 @@
-/**
- * Vector store interface.
- */
-/**
- * Validate a vector filter expression to prevent injection attacks.
- *
- * Rejects filters containing SQL keywords (SELECT, DROP, etc.),
- * statement terminators, comments, and null bytes. Enforces a
- * maximum length of 1000 characters.
- *
- * @param filter - The raw filter string from user input.
- * @returns The validated filter string (trimmed).
- * @throws Error if the filter contains dangerous patterns.
- *
- * @public
- */
-export declare function validateVectorFilter(filter: string): string;
-/**
- * A single vector search result entry.
- *
- * @public
- */
-export type VectorEntry = {
-    /** The unique identifier for this entry. */
-    id: string;
-    /** Similarity score (higher = more similar). */
-    score: number;
-    /** The original text data stored with this entry. */
-    data?: string | undefined;
-    /** Arbitrary metadata stored with this entry. */
-    metadata?: Record<string, unknown> | undefined;
-};
-/**
- * Async vector store interface used by agents.
- *
- * Agents access the vector store via `ToolContext.vector` or
- * `HookContext.vector`. Backed by Upstash Vector with built-in
- * embeddings — raw text is sent and vectorized server-side.
- *
- * @example
- * ```ts
- * // Inside a tool execute function:
- * const myTool = {
- *   description: "Search knowledge base",
- *   execute: async (_args: unknown, ctx: { vector: VectorStore }) => {
- *     await ctx.vector.upsert("doc-1", "The capital of France is Paris.");
- *     const results = await ctx.vector.query("What is the capital of France?");
- *     return results;
- *   },
- * };
- * ```
- *
- * @public
- */
-export type VectorStore = {
-    /**
-     * Upsert a text entry into the vector store.
-     *
-     * The text is automatically embedded by the server's vector database.
-     *
-     * @param id - Unique identifier for this entry.
-     * @param data - The text content to store and embed.
-     * @param metadata - Optional metadata to store alongside the vector.
-     */
-    upsert(id: string, data: string, metadata?: Record<string, unknown>): Promise<void>;
-    /**
-     * Query the vector store with a text string.
-     *
-     * Returns the most similar entries ranked by score.
-     *
-     * @param text - The query text to search for.
-     * @param options - Optional query parameters. `topK` sets the maximum number of results (default: 10). `filter` is a metadata filter expression.
-     * @returns An array of matching {@link VectorEntry} objects.
-     */
-    query(text: string, options?: {
-        topK?: number;
-        filter?: string;
-    }): Promise<VectorEntry[]>;
-    /**
-     * Delete entries by ID.
-     *
-     * @param ids - A single ID or array of IDs to delete.
-     */
-    delete(ids: string | string[]): Promise<void>;
-};

package/dist/vector.js

@@ -1,49 +0,0 @@
-//#region vector.ts
-/**
-* Vector store interface.
-*/
-/**
-* Maximum allowed length for a vector filter expression.
-* @internal
-*/
-const MAX_FILTER_LENGTH = 1e3;
-/**
-* SQL/query keywords that must not appear in filter expressions.
-* Checked case-insensitively as whole words (word-boundary match).
-* @internal
-*/
-const DANGEROUS_KEYWORDS = /\b(SELECT|INSERT|UPDATE|DELETE|DROP|ALTER|CREATE|EXEC|EXECUTE|UNION|INTO|TRUNCATE|GRANT|REVOKE|CALL)\b/i;
-/**
-* Patterns that indicate injection attempts in filter strings.
-* @internal
-*/
-const DANGEROUS_PATTERNS = [
-	/;/,
-	/--/,
-	/\/\*/,
-	/\*\//,
-	/\0/
-];
-/**
-* Validate a vector filter expression to prevent injection attacks.
-*
-* Rejects filters containing SQL keywords (SELECT, DROP, etc.),
-* statement terminators, comments, and null bytes. Enforces a
-* maximum length of 1000 characters.
-*
-* @param filter - The raw filter string from user input.
-* @returns The validated filter string (trimmed).
-* @throws Error if the filter contains dangerous patterns.
-*
-* @public
-*/
-function validateVectorFilter(filter) {
-	const trimmed = filter.trim();
-	if (trimmed.length === 0) throw new Error("Vector filter must not be empty");
-	if (trimmed.length > MAX_FILTER_LENGTH) throw new Error(`Vector filter exceeds maximum length of ${MAX_FILTER_LENGTH} characters`);
-	if (DANGEROUS_KEYWORDS.test(trimmed)) throw new Error("Vector filter contains disallowed SQL keyword");
-	for (const pattern of DANGEROUS_PATTERNS) if (pattern.test(trimmed)) throw new Error("Vector filter contains disallowed characters");
-	return trimmed;
-}
-//#endregion
-export { validateVectorFilter };