ai-functions 0.3.0 → 0.4.0

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAMrD,2BAA2B;AAC3B,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,WAAW,GACX,MAAM,GACN,UAAU,CAAA;AAEd,sCAAsC;AACtC,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,aAAa,CAAA;IACxB,2BAA2B;IAC3B,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,yEAAyE;IACzE,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,qEAAqE;IACrE,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAQD;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAEzD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,gBAAgB,CAEnD;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAEnC;AAuCD;;;GAGG;AACH,wBAAgB,UAAU,IAAI,gBAAgB,CAS7C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,OAAO,EAAE,gBAAgB,EACzB,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACvB,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAehB;AAwDD;;GAEG;AACH,wBAAgB,QAAQ,IAAI,MAAM,CAGjC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,aAAa,CAG3C;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAGxC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAGzC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAG1C;AAED,oCAAoC;AACpC,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,CAAA;AAE1D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,CAwBjE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAG5D;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAGzC"}

package/dist/context.js

@@ -0,0 +1,267 @@
+/**
+ * Execution Context for AI Functions
+ *
+ * Provides configuration without polluting function signatures.
+ * Settings flow from environment → global context → local context.
+ *
+ * @example
+ * ```ts
+ * // Set global defaults (from environment or initialization)
+ * configure({
+ *   provider: 'anthropic',
+ *   model: 'claude-sonnet-4-20250514',
+ *   batchMode: 'auto', // 'auto' | 'immediate' | 'deferred'
+ * })
+ *
+ * // Or use execution context for specific operations
+ * await withContext({ provider: 'openai', model: 'gpt-4o' }, async () => {
+ *   const titles = await list`10 blog titles`
+ *   return titles.map(title => write`blog post: ${title}`)
+ * })
+ * ```
+ *
+ * @packageDocumentation
+ */
+// ============================================================================
+// Global Context
+// ============================================================================
+let globalContext = {};
+/**
+ * Configure global defaults for AI functions
+ *
+ * @example
+ * ```ts
+ * configure({
+ *   model: 'claude-sonnet-4-20250514',
+ *   provider: 'anthropic',
+ *   batchMode: 'auto',
+ *   batchThreshold: 5,
+ * })
+ * ```
+ */
+export function configure(context) {
+    globalContext = { ...globalContext, ...context };
+}
+/**
+ * Get the current global context
+ */
+export function getGlobalContext() {
+    return { ...globalContext };
+}
+/**
+ * Reset global context to defaults
+ */
+export function resetContext() {
+    globalContext = {};
+}
+// ============================================================================
+// Async Local Storage for Execution Context
+// ============================================================================
+// Use AsyncLocalStorage if available (Node.js), otherwise fallback to global
+let asyncLocalStorage = null;
+// Lazy initialization of AsyncLocalStorage
+let asyncLocalStorageInitialized = false;
+async function initAsyncLocalStorage() {
+    if (asyncLocalStorageInitialized)
+        return;
+    asyncLocalStorageInitialized = true;
+    try {
+        const { AsyncLocalStorage } = await import('async_hooks');
+        asyncLocalStorage = new AsyncLocalStorage();
+    }
+    catch {
+        // Not in Node.js environment, use global context only
+    }
+}
+// Initialize synchronously if possible (for Node.js environments)
+if (typeof process !== 'undefined' && process.versions?.node) {
+    import('async_hooks')
+        .then(({ AsyncLocalStorage }) => {
+        asyncLocalStorage = new AsyncLocalStorage();
+        asyncLocalStorageInitialized = true;
+    })
+        .catch(() => {
+        asyncLocalStorageInitialized = true;
+    });
+}
+/**
+ * Get the current execution context
+ * Merges: environment defaults → global context → local context
+ */
+export function getContext() {
+    const envContext = getEnvContext();
+    const localContext = asyncLocalStorage?.getStore();
+    return {
+        ...envContext,
+        ...globalContext,
+        ...localContext,
+    };
+}
+/**
+ * Run a function with a specific execution context
+ *
+ * @example
+ * ```ts
+ * const posts = await withContext({ provider: 'openai', batchMode: 'deferred' }, async () => {
+ *   const titles = await list`10 blog titles`
+ *   return titles.map(title => write`blog post: ${title}`)
+ * })
+ * ```
+ */
+export function withContext(context, fn) {
+    const mergedContext = { ...getContext(), ...context };
+    if (asyncLocalStorage) {
+        return asyncLocalStorage.run(mergedContext, fn);
+    }
+    // Fallback: temporarily modify global context
+    const previousContext = globalContext;
+    globalContext = mergedContext;
+    try {
+        return fn();
+    }
+    finally {
+        globalContext = previousContext;
+    }
+}
+// ============================================================================
+// Environment Defaults
+// ============================================================================
+function getEnvContext() {
+    if (typeof process === 'undefined')
+        return {};
+    const context = {};
+    // Model defaults
+    if (process.env.AI_MODEL) {
+        context.model = process.env.AI_MODEL;
+    }
+    // Provider defaults
+    if (process.env.AI_PROVIDER) {
+        context.provider = process.env.AI_PROVIDER;
+    }
+    else if (process.env.ANTHROPIC_API_KEY && !process.env.OPENAI_API_KEY) {
+        context.provider = 'anthropic';
+    }
+    else if (process.env.OPENAI_API_KEY) {
+        context.provider = 'openai';
+    }
+    else if (process.env.CLOUDFLARE_API_TOKEN) {
+        context.provider = 'cloudflare';
+    }
+    else if (process.env.AWS_ACCESS_KEY_ID) {
+        context.provider = 'bedrock';
+    }
+    // Batch mode
+    if (process.env.AI_BATCH_MODE) {
+        context.batchMode = process.env.AI_BATCH_MODE;
+    }
+    // Flex threshold (when to start using flex processing)
+    if (process.env.AI_FLEX_THRESHOLD) {
+        context.flexThreshold = parseInt(process.env.AI_FLEX_THRESHOLD, 10);
+    }
+    // Batch threshold (when to switch from flex to full batch)
+    if (process.env.AI_BATCH_THRESHOLD) {
+        context.batchThreshold = parseInt(process.env.AI_BATCH_THRESHOLD, 10);
+    }
+    // Webhook URL
+    if (process.env.AI_BATCH_WEBHOOK_URL) {
+        context.webhookUrl = process.env.AI_BATCH_WEBHOOK_URL;
+    }
+    return context;
+}
+// ============================================================================
+// Context Helpers
+// ============================================================================
+/**
+ * Get the effective model from context
+ */
+export function getModel() {
+    const ctx = getContext();
+    return ctx.model || 'sonnet';
+}
+/**
+ * Get the effective provider from context
+ */
+export function getProvider() {
+    const ctx = getContext();
+    return ctx.provider || 'openai';
+}
+/**
+ * Get the effective batch mode from context
+ */
+export function getBatchMode() {
+    const ctx = getContext();
+    return ctx.batchMode || 'auto';
+}
+/**
+ * Get the flex threshold from context (minimum items to use flex)
+ * Default: 5 items
+ */
+export function getFlexThreshold() {
+    const ctx = getContext();
+    return ctx.flexThreshold || 5;
+}
+/**
+ * Get the batch threshold from context (minimum items to use full batch)
+ * Default: 500 items
+ */
+export function getBatchThreshold() {
+    const ctx = getContext();
+    return ctx.batchThreshold || 500;
+}
+/**
+ * Determine the execution tier for a given number of items
+ *
+ * Auto mode tiers:
+ * - immediate: < flexThreshold (default 5) - concurrent requests, full price
+ * - flex: flexThreshold to batchThreshold (5-500) - ~50% discount, minutes
+ * - batch: >= batchThreshold (500+) - 50% discount, up to 24hr
+ *
+ * @example
+ * ```ts
+ * getExecutionTier(3)   // 'immediate' (< 5)
+ * getExecutionTier(50)  // 'flex' (5-500)
+ * getExecutionTier(1000) // 'batch' (500+)
+ * ```
+ */
+export function getExecutionTier(itemCount) {
+    const mode = getBatchMode();
+    switch (mode) {
+        case 'immediate':
+            return 'immediate';
+        case 'flex':
+            return 'flex';
+        case 'deferred':
+            return 'batch';
+        case 'auto':
+        default: {
+            const flexThreshold = getFlexThreshold();
+            const batchThreshold = getBatchThreshold();
+            if (itemCount < flexThreshold) {
+                return 'immediate';
+            }
+            else if (itemCount < batchThreshold) {
+                return 'flex';
+            }
+            else {
+                return 'batch';
+            }
+        }
+    }
+}
+/**
+ * Check if we should use the batch API for a given number of items
+ * @deprecated Use getExecutionTier() instead for more granular control
+ */
+export function shouldUseBatchAPI(itemCount) {
+    const tier = getExecutionTier(itemCount);
+    return tier === 'flex' || tier === 'batch';
+}
+/**
+ * Check if flex processing is available for the current provider
+ * Only OpenAI and AWS Bedrock support flex processing currently
+ */
+export function isFlexAvailable() {
+    const provider = getProvider();
+    return provider === 'openai' || provider === 'bedrock' || provider === 'google';
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

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

package/dist/embeddings.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Embedding utilities from AI SDK
+ *
+ * Re-exports embed, embedMany, and cosineSimilarity from the Vercel AI SDK
+ * with additional convenience wrappers.
+ *
+ * Default model: Cloudflare Workers AI @cf/baai/bge-m3
+ *
+ * @packageDocumentation
+ */
+export { embed, embedMany, cosineSimilarity } from 'ai';
+export type { EmbeddingModel, Embedding } from 'ai';
+export { cloudflare, cloudflareEmbedding, DEFAULT_CF_EMBEDDING_MODEL } from 'ai-providers/cloudflare';
+/**
+ * Get the default embedding model (Cloudflare @cf/baai/bge-m3)
+ */
+export declare function getDefaultEmbeddingModel(): import("ai").EmbeddingModel<string>;
+/**
+ * Embed a single value using the default Cloudflare model
+ *
+ * @example
+ * ```ts
+ * import { embedText } from 'ai-functions'
+ *
+ * const { embedding } = await embedText('hello world')
+ * ```
+ */
+export declare function embedText(value: string): Promise<import("ai").EmbedResult<string>>;
+/**
+ * Embed multiple values using the default Cloudflare model
+ *
+ * @example
+ * ```ts
+ * import { embedTexts } from 'ai-functions'
+ *
+ * const { embeddings } = await embedTexts(['doc1', 'doc2', 'doc3'])
+ * ```
+ */
+export declare function embedTexts(values: string[]): Promise<import("ai").EmbedManyResult<string>>;
+/**
+ * Result of an embed operation
+ */
+export interface EmbedResult<T = string> {
+    /** The original input value */
+    value: T;
+    /** The generated embedding vector */
+    embedding: number[];
+    /** Token usage */
+    usage: {
+        tokens: number;
+    };
+}
+/**
+ * Result of an embedMany operation
+ */
+export interface EmbedManyResult<T = string> {
+    /** The original input values */
+    values: T[];
+    /** The generated embedding vectors */
+    embeddings: number[][];
+    /** Token usage */
+    usage: {
+        tokens: number;
+    };
+}
+/**
+ * Find the most similar items to a query embedding
+ *
+ * @example
+ * ```ts
+ * import { embed, embedMany, findSimilar } from 'ai-functions'
+ *
+ * const documents = ['doc1', 'doc2', 'doc3']
+ * const { embeddings } = await embedMany({ model, values: documents })
+ * const { embedding: queryEmbedding } = await embed({ model, value: 'search query' })
+ *
+ * const results = findSimilar(queryEmbedding, embeddings, documents, { topK: 2 })
+ * // [{ item: 'doc1', score: 0.95, index: 0 }, { item: 'doc2', score: 0.82, index: 1 }]
+ * ```
+ */
+export declare function findSimilar<T>(queryEmbedding: number[], embeddings: number[][], items: T[], options?: {
+    /** Number of results to return (default: 10) */
+    topK?: number;
+    /** Minimum similarity score (default: 0) */
+    minScore?: number;
+}): Array<{
+    item: T;
+    score: number;
+    index: number;
+}>;
+/**
+ * Calculate pairwise similarities between all embeddings
+ *
+ * @example
+ * ```ts
+ * const matrix = pairwiseSimilarity(embeddings)
+ * // matrix[i][j] = similarity between embeddings[i] and embeddings[j]
+ * ```
+ */
+export declare function pairwiseSimilarity(embeddings: number[][]): number[][];
+/**
+ * Cluster embeddings by similarity using a simple threshold-based approach
+ *
+ * @example
+ * ```ts
+ * const clusters = clusterBySimilarity(embeddings, items, { threshold: 0.8 })
+ * // [[item1, item2], [item3], [item4, item5, item6]]
+ * ```
+ */
+export declare function clusterBySimilarity<T>(embeddings: number[][], items: T[], options?: {
+    /** Similarity threshold for clustering (default: 0.8) */
+    threshold?: number;
+}): T[][];
+/**
+ * Average multiple embeddings into a single embedding
+ * Useful for creating document embeddings from chunk embeddings
+ */
+export declare function averageEmbeddings(embeddings: number[][]): number[];
+/**
+ * Normalize an embedding to unit length
+ */
+export declare function normalizeEmbedding(embedding: number[]): number[];
+//# sourceMappingURL=embeddings.d.ts.map

package/dist/embeddings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.d.ts","sourceRoot":"","sources":["../src/embeddings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,IAAI,CAAA;AAGvD,YAAY,EACV,cAAc,EACd,SAAS,EACV,MAAM,IAAI,CAAA;AAGX,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAA;AAKrG;;GAEG;AACH,wBAAgB,wBAAwB,wCAEvC;AAED;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,6CAK5C;AAED;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,iDAKhD;AAED;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,MAAM;IACrC,+BAA+B;IAC/B,KAAK,EAAE,CAAC,CAAA;IACR,qCAAqC;IACrC,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,kBAAkB;IAClB,KAAK,EAAE;QACL,MAAM,EAAE,MAAM,CAAA;KACf,CAAA;CACF;AAED;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,MAAM;IACzC,gCAAgC;IAChC,MAAM,EAAE,CAAC,EAAE,CAAA;IACX,sCAAsC;IACtC,UAAU,EAAE,MAAM,EAAE,EAAE,CAAA;IACtB,kBAAkB;IAClB,KAAK,EAAE;QACL,MAAM,EAAE,MAAM,CAAA;KACf,CAAA;CACF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,cAAc,EAAE,MAAM,EAAE,EACxB,UAAU,EAAE,MAAM,EAAE,EAAE,EACtB,KAAK,EAAE,CAAC,EAAE,EACV,OAAO,GAAE;IACP,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAA;CACb,GACL,KAAK,CAAC;IAAE,IAAI,EAAE,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAiBlD;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,EAAE,CAgBrE;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,UAAU,EAAE,MAAM,EAAE,EAAE,EACtB,KAAK,EAAE,CAAC,EAAE,EACV,OAAO,GAAE;IACP,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAA;CACd,GACL,CAAC,EAAE,EAAE,CA4BP;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,CAkBlE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAIhE"}

package/dist/embeddings.js

@@ -0,0 +1,170 @@
+/**
+ * Embedding utilities from AI SDK
+ *
+ * Re-exports embed, embedMany, and cosineSimilarity from the Vercel AI SDK
+ * with additional convenience wrappers.
+ *
+ * Default model: Cloudflare Workers AI @cf/baai/bge-m3
+ *
+ * @packageDocumentation
+ */
+// Re-export core embedding functions from AI SDK
+export { embed, embedMany, cosineSimilarity } from 'ai';
+// Re-export Cloudflare provider from ai-providers
+export { cloudflare, cloudflareEmbedding, DEFAULT_CF_EMBEDDING_MODEL } from 'ai-providers/cloudflare';
+import { embed as aiEmbed, embedMany as aiEmbedMany } from 'ai';
+import { cloudflareEmbedding, DEFAULT_CF_EMBEDDING_MODEL } from 'ai-providers/cloudflare';
+/**
+ * Get the default embedding model (Cloudflare @cf/baai/bge-m3)
+ */
+export function getDefaultEmbeddingModel() {
+    return cloudflareEmbedding(DEFAULT_CF_EMBEDDING_MODEL);
+}
+/**
+ * Embed a single value using the default Cloudflare model
+ *
+ * @example
+ * ```ts
+ * import { embedText } from 'ai-functions'
+ *
+ * const { embedding } = await embedText('hello world')
+ * ```
+ */
+export async function embedText(value) {
+    return aiEmbed({
+        model: getDefaultEmbeddingModel(),
+        value
+    });
+}
+/**
+ * Embed multiple values using the default Cloudflare model
+ *
+ * @example
+ * ```ts
+ * import { embedTexts } from 'ai-functions'
+ *
+ * const { embeddings } = await embedTexts(['doc1', 'doc2', 'doc3'])
+ * ```
+ */
+export async function embedTexts(values) {
+    return aiEmbedMany({
+        model: getDefaultEmbeddingModel(),
+        values
+    });
+}
+/**
+ * Find the most similar items to a query embedding
+ *
+ * @example
+ * ```ts
+ * import { embed, embedMany, findSimilar } from 'ai-functions'
+ *
+ * const documents = ['doc1', 'doc2', 'doc3']
+ * const { embeddings } = await embedMany({ model, values: documents })
+ * const { embedding: queryEmbedding } = await embed({ model, value: 'search query' })
+ *
+ * const results = findSimilar(queryEmbedding, embeddings, documents, { topK: 2 })
+ * // [{ item: 'doc1', score: 0.95, index: 0 }, { item: 'doc2', score: 0.82, index: 1 }]
+ * ```
+ */
+export function findSimilar(queryEmbedding, embeddings, items, options = {}) {
+    const { topK = 10, minScore = 0 } = options;
+    // Import cosineSimilarity dynamically to avoid issues if ai isn't installed
+    const { cosineSimilarity } = require('ai');
+    const scored = embeddings
+        .map((embedding, index) => ({
+        item: items[index],
+        score: cosineSimilarity(queryEmbedding, embedding),
+        index
+    }))
+        .filter(result => result.score >= minScore)
+        .sort((a, b) => b.score - a.score)
+        .slice(0, topK);
+    return scored;
+}
+/**
+ * Calculate pairwise similarities between all embeddings
+ *
+ * @example
+ * ```ts
+ * const matrix = pairwiseSimilarity(embeddings)
+ * // matrix[i][j] = similarity between embeddings[i] and embeddings[j]
+ * ```
+ */
+export function pairwiseSimilarity(embeddings) {
+    const { cosineSimilarity } = require('ai');
+    const n = embeddings.length;
+    const matrix = Array(n).fill(null).map(() => Array(n).fill(0));
+    for (let i = 0; i < n; i++) {
+        matrix[i][i] = 1; // Self-similarity is always 1
+        for (let j = i + 1; j < n; j++) {
+            const sim = cosineSimilarity(embeddings[i], embeddings[j]);
+            matrix[i][j] = sim;
+            matrix[j][i] = sim;
+        }
+    }
+    return matrix;
+}
+/**
+ * Cluster embeddings by similarity using a simple threshold-based approach
+ *
+ * @example
+ * ```ts
+ * const clusters = clusterBySimilarity(embeddings, items, { threshold: 0.8 })
+ * // [[item1, item2], [item3], [item4, item5, item6]]
+ * ```
+ */
+export function clusterBySimilarity(embeddings, items, options = {}) {
+    const { threshold = 0.8 } = options;
+    const { cosineSimilarity } = require('ai');
+    const n = embeddings.length;
+    const assigned = new Set();
+    const clusters = [];
+    for (let i = 0; i < n; i++) {
+        if (assigned.has(i))
+            continue;
+        const cluster = [items[i]];
+        assigned.add(i);
+        for (let j = i + 1; j < n; j++) {
+            if (assigned.has(j))
+                continue;
+            const sim = cosineSimilarity(embeddings[i], embeddings[j]);
+            if (sim >= threshold) {
+                cluster.push(items[j]);
+                assigned.add(j);
+            }
+        }
+        clusters.push(cluster);
+    }
+    return clusters;
+}
+/**
+ * Average multiple embeddings into a single embedding
+ * Useful for creating document embeddings from chunk embeddings
+ */
+export function averageEmbeddings(embeddings) {
+    if (embeddings.length === 0)
+        return [];
+    const dim = embeddings[0].length;
+    const result = new Array(dim).fill(0);
+    for (const embedding of embeddings) {
+        for (let i = 0; i < dim; i++) {
+            result[i] += embedding[i];
+        }
+    }
+    const n = embeddings.length;
+    for (let i = 0; i < dim; i++) {
+        result[i] /= n;
+    }
+    return result;
+}
+/**
+ * Normalize an embedding to unit length
+ */
+export function normalizeEmbedding(embedding) {
+    const magnitude = Math.sqrt(embedding.reduce((sum, val) => sum + val * val, 0));
+    if (magnitude === 0)
+        return embedding;
+    return embedding.map(val => val / magnitude);
+}
+//# sourceMappingURL=embeddings.js.map

package/dist/embeddings.js.map

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

package/dist/eval/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * AI Functions Eval Suite
+ *
+ * @packageDocumentation
+ */
+export * from './models.js';
+export * from './runner.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/eval/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA"}

package/dist/eval/index.js

@@ -0,0 +1,8 @@
+/**
+ * AI Functions Eval Suite
+ *
+ * @packageDocumentation
+ */
+export * from './models.js';
+export * from './runner.js';
+//# sourceMappingURL=index.js.map

package/dist/eval/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/eval/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA"}

package/dist/eval/models.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Model Registry for AI Functions Eval Suite
+ *
+ * Simple model list for running evals across providers.
+ * Uses ai-providers/language-models for resolution and pricing.
+ *
+ * @packageDocumentation
+ */
+import { type ModelInfo } from 'language-models';
+export type ModelTier = 'best' | 'fast' | 'cheap';
+export interface EvalModel {
+    /** Alias or full model ID */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Provider slug */
+    provider: string;
+    /** Capability tier */
+    tier: ModelTier;
+    /** Optional notes */
+    notes?: string;
+}
+/**
+ * Core models to test - one per tier per major provider
+ * These resolve via ai-providers to OpenRouter or direct SDKs
+ *
+ * Updated: December 2025
+ *
+ * Note: Some models use OpenRouter format (provider/model) to avoid
+ * resolution issues with provider_model_id mismatches.
+ */
+export declare const EVAL_MODELS: EvalModel[];
+/**
+ * Get models by tier
+ */
+export declare function getModelsByTier(tier: ModelTier): EvalModel[];
+/**
+ * Get models by provider
+ */
+export declare function getModelsByProvider(provider: string): EvalModel[];
+/**
+ * Get model info from language-models package (includes pricing)
+ */
+export declare function getModelInfo(id: string): ModelInfo | undefined;
+/**
+ * Get pricing for a model (from OpenRouter data)
+ */
+export declare function getModelPricing(id: string): {
+    prompt: number;
+    completion: number;
+} | undefined;
+/**
+ * Create evalite variants for model testing
+ */
+export declare function createModelVariants(opts?: {
+    tiers?: ModelTier[];
+    providers?: string[];
+}): Array<{
+    name: string;
+    input: EvalModel;
+}>;
+/**
+ * Get a representative model from each provider for a given tier
+ */
+export declare function getRepresentativeModels(tier: ModelTier): EvalModel[];
+//# sourceMappingURL=models.d.ts.map