ai/interfaces.ts

* AI layer interfaces — all optional, everything degrades gracefully. / * Hint for providers that produce different embeddings for indexing vs retrieval (Voyage `input_type`, Vertex `task_type`). Providers that don't distinguish ignore this parameter. Default: `'document'` (index

// Source: https://github.com/nikolai-vysotskyi/trace-mcp | License: MIT | Copyright 2026 Nikolai Vysotskyi
// Provided via justclaw.it.com; keep this notice with the code.
/**
 * AI layer interfaces — all optional, everything degrades gracefully.
 */

/**
 * Hint for providers that produce different embeddings for indexing vs retrieval
 * (Voyage `input_type`, Vertex `task_type`). Providers that don't distinguish
 * ignore this parameter. Default: `'document'` (indexing path) — callers
 * embedding a search query MUST pass `'query'` to get optimal retrieval quality.
 */
export type EmbeddingTask = 'document' | 'query';

export interface EmbeddingService {
  embed(text: string, task?: EmbeddingTask, signal?: AbortSignal): Promise<number[]>;
  embedBatch(texts: string[], task?: EmbeddingTas

... (truncated -- full source via MCP)