@unbrained/pm-cli 2026.9.7 → 2026.9.9

package/dist/core/search/eval.js

@@ -1,226 +1,2 @@
-/**
- * @module core/search/eval
- *
- * Search relevance evaluation primitives (pm-u8n5). Implements the standard
- * offline ranking metrics — nDCG@k, MRR@k, precision@k, recall@k — over a
- * human-curated golden-query set, plus the loader/validator for that set. The
- * `pm eval` command (src/cli/commands/eval.ts) runs each golden query through
- * the live retrieval path and feeds the ranked ids here, so relevance
- * regressions from corpus changes, hybrid-weight changes, or provider swaps are
- * measurable and gateable in CI.
- *
- * Relevance is binary: an id is either in a query's `relevant_ids` set or it is
- * not. This keeps the golden set cheap to curate while still supporting the
- * graded-discount behavior of DCG (earlier hits are worth more).
- */
-/** Default cutoff (`@k`) used for every metric when the caller does not override it. */
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="70e06a73-6602-5384-a25b-fd3df5f6438e")}catch(e){}}();
-export const DEFAULT_EVAL_K = 10;
-/** Stable public schema identifier for versioned golden-query files. */
-export const EVAL_QUERY_SET_SCHEMA_ID = "https://schema.unbrained.dev/pm/eval-query-set/v1";
-/** Machine-readable input contract exposed by the SDK and CLI guidance. */
-export const EVAL_QUERY_SET_CONTRACT = {
-    schema: EVAL_QUERY_SET_SCHEMA_ID,
-    accepted_top_level: ["array", "object"],
-    required_query_fields: ["query", "relevant_ids"],
-    optional_fields: ["mode", "description"],
-    modes: ["keyword", "semantic", "hybrid"],
-};
-/** Copy-ready minimal query set shared by help, diagnostics, and integrations. */
-export const EVAL_QUERY_SET_EXAMPLE = {
-    schema: EVAL_QUERY_SET_SCHEMA_ID,
-    queries: [
-        {
-            query: "offline search",
-            relevant_ids: ["pm-75k9"],
-            mode: "keyword",
-        },
-    ],
-};
-/**
- * Thrown by {@link parseEvalQuerySet} when the raw golden-query payload is
- * structurally invalid. Carries a precise, human-actionable message naming the
- * offending query index/field so an author can fix the JSON directly.
- */
-export class EvalQuerySetError extends Error {
-    /** Construct an error describing why a golden-query set failed validation. */
-    constructor(message) {
-        super(message);
-        this.name = "EvalQuerySetError";
-    }
-}
-const VALID_EVAL_MODES = new Set([
-    "keyword",
-    "semantic",
-    "hybrid",
-]);
-/** Compute Discounted Cumulative Gain at cutoff `k` for an ordered list of binary relevance gains (`1` relevant, `0` not). Position `i` (1-based) contributes `gain / log2(i + 1)`, so a relevant hit ranked first is worth `1` and later hits are progressively discounted. Gains beyond `k` are ignored. */
-export function dcgAtK(relevanceGains, k) {
-    let dcg = 0;
-    const limit = Math.min(k, relevanceGains.length);
-    for (let index = 0; index < limit; index += 1) {
-        dcg += relevanceGains[index] / Math.log2(index + 2);
-    }
-    return dcg;
-}
-/** Normalized DCG at cutoff `k`: the ranking's DCG divided by the DCG of the ideal ranking (all relevant ids first). Returns `0` when the query has no relevant ids (the ideal DCG is `0` and the score is undefined), giving a stable lower bound for aggregation. Result is in `[0, 1]`. */
-export function ndcgAtK(rankedIds, relevantIds, k) {
-    if (relevantIds.size === 0) {
-        return 0;
-    }
-    const gains = rankedIds.map((id) => (relevantIds.has(id) ? 1 : 0));
-    const dcg = dcgAtK(gains, k);
-    const idealGains = Array.from({ length: relevantIds.size }, () => 1);
-    const idealDcg = dcgAtK(idealGains, k);
-    return idealDcg === 0 ? 0 : dcg / idealDcg;
-}
-/**
- * Reciprocal rank of the first relevant id within the top `k` results: `1/rank`
- * (rank is 1-based), or `0` when no relevant id appears in the cutoff. Averaged
- * across queries this is Mean Reciprocal Rank (MRR@k).
- */
-export function reciprocalRankAtK(rankedIds, relevantIds, k) {
-    const limit = Math.min(k, rankedIds.length);
-    for (let index = 0; index < limit; index += 1) {
-        if (relevantIds.has(rankedIds[index])) {
-            return 1 / (index + 1);
-        }
-    }
-    return 0;
-}
-/** Count relevant ids within the top `k` results (shared by precision and recall). */
-function countRelevantInTopK(rankedIds, relevantIds, k) {
-    const limit = Math.min(k, rankedIds.length);
-    let hits = 0;
-    for (let index = 0; index < limit; index += 1) {
-        if (relevantIds.has(rankedIds[index])) {
-            hits += 1;
-        }
-    }
-    return hits;
-}
-/** Precision at cutoff `k`: relevant ids retrieved in the top `k` divided by `k`. Returns `0` for a non-positive `k`. */
-export function precisionAtK(rankedIds, relevantIds, k) {
-    if (k <= 0) {
-        return 0;
-    }
-    return countRelevantInTopK(rankedIds, relevantIds, k) / k;
-}
-/** Recall at cutoff `k`: relevant ids retrieved in the top `k` divided by the total number of relevant ids. Returns `0` when the query has no relevant ids. */
-export function recallAtK(rankedIds, relevantIds, k) {
-    if (relevantIds.size === 0) {
-        return 0;
-    }
-    return countRelevantInTopK(rankedIds, relevantIds, k) / relevantIds.size;
-}
-/** Evaluate one ranking against its relevant-id set at cutoff `k`, returning all four metrics together so callers compute the document ranking once and read every score off the result. */
-export function evaluateRanking(rankedIds, relevantIds, k) {
-    return {
-        ndcg: ndcgAtK(rankedIds, relevantIds, k),
-        mrr: reciprocalRankAtK(rankedIds, relevantIds, k),
-        precision: precisionAtK(rankedIds, relevantIds, k),
-        recall: recallAtK(rankedIds, relevantIds, k),
-        relevant_total: relevantIds.size,
-        retrieved_relevant: countRelevantInTopK(rankedIds, relevantIds, k),
-    };
-}
-/** Macro-average per-query metrics (each query weighted equally). Returns all zeros with `query_count: 0` for an empty input so the gate path has a stable shape to compare against. */
-export function aggregateEvalMetrics(perQuery) {
-    const queryCount = perQuery.length;
-    if (queryCount === 0) {
-        return { ndcg: 0, mrr: 0, precision: 0, recall: 0, query_count: 0 };
-    }
-    const sum = perQuery.reduce((accumulator, metrics) => ({
-        ndcg: accumulator.ndcg + metrics.ndcg,
-        mrr: accumulator.mrr + metrics.mrr,
-        precision: accumulator.precision + metrics.precision,
-        recall: accumulator.recall + metrics.recall,
-    }), { ndcg: 0, mrr: 0, precision: 0, recall: 0 });
-    return {
-        ndcg: sum.ndcg / queryCount,
-        mrr: sum.mrr / queryCount,
-        precision: sum.precision / queryCount,
-        recall: sum.recall / queryCount,
-        query_count: queryCount,
-    };
-}
-/**
- * Validate one raw golden-query entry, returning a typed {@link EvalQuery}.
- * Throws {@link EvalQuerySetError} (with the entry index) for a missing/empty
- * `query`, a `relevant_ids` that is not a non-empty string array, or an invalid
- * `mode`. `relevant_ids` are trimmed and de-duplicated; `description` is kept
- * only when it is a non-empty string.
- */
-function parseEvalQueryEntry(raw, index) {
-    if (typeof raw !== "object" || raw === null) {
-        throw new EvalQuerySetError(`Eval query at index ${index} must be an object`);
-    }
-    const entry = raw;
-    const query = typeof entry.query === "string" ? entry.query.trim() : "";
-    if (query.length === 0) {
-        throw new EvalQuerySetError(`Eval query at index ${index} must have a non-empty "query" string`);
-    }
-    if (!Array.isArray(entry.relevant_ids)) {
-        throw new EvalQuerySetError(`Eval query at index ${index} must have a "relevant_ids" array`);
-    }
-    if (entry.relevant_ids.some((value) => typeof value !== "string")) {
-        // Reject (rather than silently drop) non-string members: malformed golden
-        // data must fail loudly so it can never quietly change relevance judgments.
-        throw new EvalQuerySetError(`Eval query at index ${index} must have a "relevant_ids" array of strings`);
-    }
-    const relevantIds = [
-        ...new Set(entry.relevant_ids
-            .map((value) => value.trim())
-            .filter((value) => value.length > 0)),
-    ];
-    if (relevantIds.length === 0) {
-        throw new EvalQuerySetError(`Eval query at index ${index} must list at least one relevant id`);
-    }
-    if (entry.mode !== undefined &&
-        (typeof entry.mode !== "string" || !VALID_EVAL_MODES.has(entry.mode))) {
-        throw new EvalQuerySetError(`Eval query at index ${index} has an invalid mode (expected keyword|semantic|hybrid)`);
-    }
-    return {
-        query,
-        relevant_ids: relevantIds,
-        ...(entry.mode !== undefined ? { mode: entry.mode } : {}),
-        ...(typeof entry.description === "string" &&
-            entry.description.trim().length > 0
-            ? { description: entry.description.trim() }
-            : {}),
-    };
-}
-/**
- * Parse and validate a raw golden-query payload (typically `JSON.parse` of
- * `.agents/pm/search/eval-queries.json`). Accepts either a bare array of query
- * entries or an object with a `queries` array. Throws {@link EvalQuerySetError}
- * with a precise message when the payload is not an array/object, when
- * `queries` is missing/not an array, when the set is empty, or when any entry
- * fails {@link parseEvalQueryEntry}.
- */
-export function parseEvalQuerySet(raw) {
-    const rawSchema = typeof raw === "object" && raw !== null && !Array.isArray(raw)
-        ? raw.schema
-        : undefined;
-    if (rawSchema !== undefined && rawSchema !== EVAL_QUERY_SET_SCHEMA_ID) {
-        throw new EvalQuerySetError(`Unsupported eval query set schema; expected "${EVAL_QUERY_SET_SCHEMA_ID}"`);
-    }
-    const rawQueries = Array.isArray(raw)
-        ? raw
-        : typeof raw === "object" && raw !== null
-            ? raw.queries
-            : undefined;
-    if (!Array.isArray(rawQueries)) {
-        throw new EvalQuerySetError('Eval query set must be an array of queries or an object with a "queries" array');
-    }
-    if (rawQueries.length === 0) {
-        throw new EvalQuerySetError("Eval query set must contain at least one query");
-    }
-    return {
-        schema: EVAL_QUERY_SET_SCHEMA_ID,
-        queries: rawQueries.map((entry, index) => parseEvalQueryEntry(entry, index)),
-    };
-}
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="7b09736a-499b-57f6-b688-0458b487786b")}catch(e2){}})();const DEFAULT_EVAL_K=10;const EVAL_QUERY_SET_SCHEMA_ID="https://schema.unbrained.dev/pm/eval-query-set/v1";const EVAL_QUERY_SET_CONTRACT={schema:EVAL_QUERY_SET_SCHEMA_ID,accepted_top_level:["array","object"],required_query_fields:["query","relevant_ids"],optional_fields:["mode","description"],modes:["keyword","semantic","hybrid"]};const EVAL_QUERY_SET_EXAMPLE={schema:EVAL_QUERY_SET_SCHEMA_ID,queries:[{query:"offline search",relevant_ids:["pm-75k9"],mode:"keyword"}]};class EvalQuerySetError extends Error{constructor(message){super(message);this.name="EvalQuerySetError"}}const VALID_EVAL_MODES=new Set(["keyword","semantic","hybrid"]);function dcgAtK(relevanceGains,k){let dcg=0;const limit=Math.min(k,relevanceGains.length);for(let index=0;index<limit;index+=1){dcg+=relevanceGains[index]/Math.log2(index+2)}return dcg}function ndcgAtK(rankedIds,relevantIds,k){if(relevantIds.size===0){return 0}const gains=rankedIds.map(id=>relevantIds.has(id)?1:0);const dcg=dcgAtK(gains,k);const idealGains=Array.from({length:relevantIds.size},()=>1);const idealDcg=dcgAtK(idealGains,k);return idealDcg===0?0:dcg/idealDcg}function reciprocalRankAtK(rankedIds,relevantIds,k){const limit=Math.min(k,rankedIds.length);for(let index=0;index<limit;index+=1){if(relevantIds.has(rankedIds[index])){return 1/(index+1)}}return 0}function countRelevantInTopK(rankedIds,relevantIds,k){const limit=Math.min(k,rankedIds.length);let hits=0;for(let index=0;index<limit;index+=1){if(relevantIds.has(rankedIds[index])){hits+=1}}return hits}function precisionAtK(rankedIds,relevantIds,k){if(k<=0){return 0}return countRelevantInTopK(rankedIds,relevantIds,k)/k}function recallAtK(rankedIds,relevantIds,k){if(relevantIds.size===0){return 0}return countRelevantInTopK(rankedIds,relevantIds,k)/relevantIds.size}function evaluateRanking(rankedIds,relevantIds,k){return{ndcg:ndcgAtK(rankedIds,relevantIds,k),mrr:reciprocalRankAtK(rankedIds,relevantIds,k),precision:precisionAtK(rankedIds,relevantIds,k),recall:recallAtK(rankedIds,relevantIds,k),relevant_total:relevantIds.size,retrieved_relevant:countRelevantInTopK(rankedIds,relevantIds,k)}}function aggregateEvalMetrics(perQuery){const queryCount=perQuery.length;if(queryCount===0){return{ndcg:0,mrr:0,precision:0,recall:0,query_count:0}}const sum=perQuery.reduce((accumulator,metrics)=>({ndcg:accumulator.ndcg+metrics.ndcg,mrr:accumulator.mrr+metrics.mrr,precision:accumulator.precision+metrics.precision,recall:accumulator.recall+metrics.recall}),{ndcg:0,mrr:0,precision:0,recall:0});return{ndcg:sum.ndcg/queryCount,mrr:sum.mrr/queryCount,precision:sum.precision/queryCount,recall:sum.recall/queryCount,query_count:queryCount}}function parseEvalQueryEntry(raw,index){if(typeof raw!=="object"||raw===null){throw new EvalQuerySetError(`Eval query at index ${index} must be an object`)}const entry=raw;const query=typeof entry.query==="string"?entry.query.trim():"";if(query.length===0){throw new EvalQuerySetError(`Eval query at index ${index} must have a non-empty "query" string`)}if(!Array.isArray(entry.relevant_ids)){throw new EvalQuerySetError(`Eval query at index ${index} must have a "relevant_ids" array`)}if(entry.relevant_ids.some(value=>typeof value!=="string")){throw new EvalQuerySetError(`Eval query at index ${index} must have a "relevant_ids" array of strings`)}const relevantIds=[...new Set(entry.relevant_ids.map(value=>value.trim()).filter(value=>value.length>0))];if(relevantIds.length===0){throw new EvalQuerySetError(`Eval query at index ${index} must list at least one relevant id`)}if(entry.mode!==void 0&&(typeof entry.mode!=="string"||!VALID_EVAL_MODES.has(entry.mode))){throw new EvalQuerySetError(`Eval query at index ${index} has an invalid mode (expected keyword|semantic|hybrid)`)}return{query,relevant_ids:relevantIds,...entry.mode!==void 0?{mode:entry.mode}:{},...typeof entry.description==="string"&&entry.description.trim().length>0?{description:entry.description.trim()}:{}}}function parseEvalQuerySet(raw){const rawSchema=typeof raw==="object"&&raw!==null&&!Array.isArray(raw)?raw.schema:void 0;if(rawSchema!==void 0&&rawSchema!==EVAL_QUERY_SET_SCHEMA_ID){throw new EvalQuerySetError(`Unsupported eval query set schema; expected "${EVAL_QUERY_SET_SCHEMA_ID}"`)}const rawQueries=Array.isArray(raw)?raw:typeof raw==="object"&&raw!==null?raw.queries:void 0;if(!Array.isArray(rawQueries)){throw new EvalQuerySetError('Eval query set must be an array of queries or an object with a "queries" array')}if(rawQueries.length===0){throw new EvalQuerySetError("Eval query set must contain at least one query")}return{schema:EVAL_QUERY_SET_SCHEMA_ID,queries:rawQueries.map((entry,index)=>parseEvalQueryEntry(entry,index))}}export{DEFAULT_EVAL_K,EVAL_QUERY_SET_CONTRACT,EVAL_QUERY_SET_EXAMPLE,EVAL_QUERY_SET_SCHEMA_ID,EvalQuerySetError,aggregateEvalMetrics,dcgAtK,evaluateRanking,ndcgAtK,parseEvalQuerySet,precisionAtK,recallAtK,reciprocalRankAtK};
 //# sourceMappingURL=eval.js.map
-//# debugId=70e06a73-6602-5384-a25b-fd3df5f6438e

package/dist/core/search/http-client.js

@@ -1,76 +1,2 @@
-/**
- * @module core/search/http-client
- *
- * Powers search, embeddings, and semantic retrieval behavior for Http Client.
- */
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="b5ce7132-0024-5d42-9cb8-585933beb7c7")}catch(e){}}();
-import { toErrorMessage } from "../shared/primitives.js";
-const DEFAULT_SEARCH_HTTP_TIMEOUT_MS = 30_000;
-/** Implements normalize search http timeout ms for the public runtime surface of this module. */
-export function normalizeSearchHttpTimeoutMs(timeoutMs, requestLabel, defaultTimeoutMs = DEFAULT_SEARCH_HTTP_TIMEOUT_MS) {
-    const resolved = timeoutMs ?? defaultTimeoutMs;
-    if (!Number.isFinite(resolved) || resolved <= 0) {
-        throw new Error(`${requestLabel} timeout must be a positive finite number`);
-    }
-    return Math.floor(resolved);
-}
-/** Implements resolve search http fetcher for the public runtime surface of this module. */
-export function resolveSearchHttpFetcher(fetcher, requestLabel) {
-    if (fetcher) {
-        return fetcher;
-    }
-    if (typeof globalThis.fetch === "function") {
-        return globalThis.fetch.bind(globalThis);
-    }
-    throw new Error(`${requestLabel} execution requires a fetch implementation`);
-}
-/** Implements read failed search http response body for the public runtime surface of this module. */
-export async function readFailedSearchHttpResponseBody(response) {
-    try {
-        return (await response.text()).replaceAll(/\s+/g, " ").trim();
-    }
-    catch (error) {
-        return `(failed to read response body: ${toErrorMessage(error)})`;
-    }
-}
-/** Implements execute search json request for the public runtime surface of this module. */
-export async function executeSearchJsonRequest(options) {
-    const controller = new AbortController();
-    const timeoutHandle = setTimeout(() => {
-        controller.abort();
-    }, options.timeoutMs);
-    try {
-        let response;
-        try {
-            response = await options.fetcher(options.endpoint, {
-                method: options.method,
-                headers: options.headers,
-                body: JSON.stringify(options.body),
-                signal: controller.signal,
-            });
-        }
-        catch (error) {
-            if (error instanceof Error && error.name === "AbortError") {
-                throw new Error(`${options.requestLabel} timed out after ${options.timeoutMs}ms`);
-            }
-            throw new Error(`${options.requestLabel} execution failed: ${toErrorMessage(error)}`);
-        }
-        if (!response.ok) {
-            const responseBody = await readFailedSearchHttpResponseBody(response);
-            const detail = responseBody.length > 0 ? `: ${responseBody}` : "";
-            throw new Error(`${options.requestLabel} failed with status ${response.status} ${response.statusText}${detail}`);
-        }
-        try {
-            return await response.json();
-        }
-        catch (error) {
-            throw new Error(`${options.responseLabel} JSON parse failed: ${toErrorMessage(error)}`);
-        }
-    }
-    finally {
-        clearTimeout(timeoutHandle);
-    }
-}
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="74cee8e6-1785-50f4-94d8-fc0b29055dc2")}catch(e2){}})();import{toErrorMessage}from"../shared/primitives.js";const DEFAULT_SEARCH_HTTP_TIMEOUT_MS=3e4;function normalizeSearchHttpTimeoutMs(timeoutMs,requestLabel,defaultTimeoutMs=DEFAULT_SEARCH_HTTP_TIMEOUT_MS){const resolved=timeoutMs??defaultTimeoutMs;if(!Number.isFinite(resolved)||resolved<=0){throw new Error(`${requestLabel} timeout must be a positive finite number`)}return Math.floor(resolved)}function resolveSearchHttpFetcher(fetcher,requestLabel){if(fetcher){return fetcher}if(typeof globalThis.fetch==="function"){return globalThis.fetch.bind(globalThis)}throw new Error(`${requestLabel} execution requires a fetch implementation`)}async function readFailedSearchHttpResponseBody(response){try{return(await response.text()).replaceAll(/\s+/g," ").trim()}catch(error){return`(failed to read response body: ${toErrorMessage(error)})`}}async function executeSearchJsonRequest(options){const controller=new AbortController;const timeoutHandle=setTimeout(()=>{controller.abort()},options.timeoutMs);try{let response;try{response=await options.fetcher(options.endpoint,{method:options.method,headers:options.headers,body:JSON.stringify(options.body),signal:controller.signal})}catch(error){if(error instanceof Error&&error.name==="AbortError"){throw new Error(`${options.requestLabel} timed out after ${options.timeoutMs}ms`)}throw new Error(`${options.requestLabel} execution failed: ${toErrorMessage(error)}`)}if(!response.ok){const responseBody=await readFailedSearchHttpResponseBody(response);const detail=responseBody.length>0?`: ${responseBody}`:"";throw new Error(`${options.requestLabel} failed with status ${response.status} ${response.statusText}${detail}`)}try{return await response.json()}catch(error){throw new Error(`${options.responseLabel} JSON parse failed: ${toErrorMessage(error)}`)}}finally{clearTimeout(timeoutHandle)}}export{executeSearchJsonRequest,normalizeSearchHttpTimeoutMs,readFailedSearchHttpResponseBody,resolveSearchHttpFetcher};
 //# sourceMappingURL=http-client.js.map
-//# debugId=b5ce7132-0024-5d42-9cb8-585933beb7c7

package/dist/core/search/providers.js

@@ -1,243 +1,2 @@
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="af754be6-8026-530a-8a20-b03d4ed742e1")}catch(e){}}();
-import { executeSearchJsonRequest, normalizeSearchHttpTimeoutMs, resolveSearchHttpFetcher, } from "./http-client.js";
-import { isFiniteNumberArray, toNonEmptyString, trimTrailingSlashes, } from "../shared/primitives.js";
-/** Classifies the resolution source for an active provider/adapter given the persisted (possibly empty) configured value. Pure and adapter-agnostic so it serves both the embedding provider and the vector-store adapter. "configured" requires the persisted value to actually MATCH the active resolution (case-insensitively): a configured-but-unhonored value (typo or unsupported name that the runtime fell back from) is reported as "auto-detected", not falsely "configured". */
-export function resolveProviderConfigSource(activeName, configured) {
-    const active = toNonEmptyString(activeName);
-    if (!active) {
-        return "unconfigured";
-    }
-    const configuredValue = toNonEmptyString(configured);
-    return configuredValue &&
-        configuredValue.toLowerCase() === active.toLowerCase()
-        ? "configured"
-        : "auto-detected";
-}
-function normalizeOpenAiEmbeddingsEndpoint(baseUrl) {
-    const normalizedBaseUrl = trimTrailingSlashes(baseUrl);
-    const normalizedLower = normalizedBaseUrl.toLowerCase();
-    if (normalizedLower.endsWith("/embeddings")) {
-        return normalizedBaseUrl;
-    }
-    if (normalizedLower.endsWith("/v1")) {
-        return `${normalizedBaseUrl}/embeddings`;
-    }
-    return `${normalizedBaseUrl}/v1/embeddings`;
-}
-function resolveSearchEmbeddingModelOverride(settings) {
-    // `settings.search.embedding_model` is documented as overriding the
-    // provider-specific model when set (see CONFIG_KEY_ALIASES for
-    // `search_embedding_model` in src/core/config/nested-settings.ts). Each
-    // provider resolver picks this up after its own model is read so the
-    // override applies to whichever built-in is selected.
-    const candidate = settings
-        .search?.embedding_model;
-    return toNonEmptyString(candidate) || null;
-}
-function resolveOpenAiProvider(settings) {
-    const baseUrl = toNonEmptyString(settings.providers?.openai?.base_url);
-    const model = toNonEmptyString(settings.providers?.openai?.model);
-    if (!baseUrl || !model) {
-        return null;
-    }
-    const override = resolveSearchEmbeddingModelOverride(settings);
-    const apiKey = toNonEmptyString(settings.providers?.openai?.api_key);
-    return {
-        name: "openai",
-        base_url: baseUrl,
-        model: override ?? model,
-        ...(apiKey ? { api_key: apiKey } : {}),
-    };
-}
-function resolveOllamaProvider(settings) {
-    const baseUrl = toNonEmptyString(settings.providers?.ollama?.base_url);
-    const model = toNonEmptyString(settings.providers?.ollama?.model);
-    if (!baseUrl || !model) {
-        return null;
-    }
-    const override = resolveSearchEmbeddingModelOverride(settings);
-    return {
-        name: "ollama",
-        base_url: baseUrl,
-        model: override ?? model,
-    };
-}
-function normalizeEmbeddingInputs(input) {
-    const inputs = (Array.isArray(input) ? input : [input])
-        .map((entry) => entry.trim())
-        .filter((entry) => entry.length > 0);
-    if (inputs.length === 0) {
-        throw new Error("Embedding input must include at least one non-empty string");
-    }
-    return inputs;
-}
-function dedupeEmbeddingInputs(inputs) {
-    const uniqueInputs = [];
-    const originalToUniqueIndex = [];
-    const uniqueIndexByInput = new Map();
-    for (const entry of inputs) {
-        const existingUniqueIndex = uniqueIndexByInput.get(entry);
-        if (existingUniqueIndex === undefined) {
-            const nextUniqueIndex = uniqueInputs.length;
-            uniqueInputs.push(entry);
-            uniqueIndexByInput.set(entry, nextUniqueIndex);
-            originalToUniqueIndex.push(nextUniqueIndex);
-            continue;
-        }
-        originalToUniqueIndex.push(existingUniqueIndex);
-    }
-    return {
-        uniqueInputs,
-        originalToUniqueIndex,
-    };
-}
-function buildOrderedOpenAiEntries(data) {
-    const openAiEntries = data.map((entry, position) => ({
-        embedding: entry.embedding,
-        index: entry.index,
-        position,
-    }));
-    const hasExplicitIndex = openAiEntries.some((entry) => entry.index !== undefined);
-    if (hasExplicitIndex) {
-        for (const entry of openAiEntries) {
-            if (!Number.isInteger(entry.index)) {
-                throw new TypeError(`OpenAI embedding response entry at position ${entry.position} is missing a valid integer index`);
-            }
-        }
-        return [...openAiEntries].sort((a, b) => {
-            const byIndex = a.index - b.index;
-            if (byIndex !== 0) {
-                return byIndex;
-            }
-            return a.position - b.position;
-        });
-    }
-    return openAiEntries;
-}
-/** Implements resolve embedding providers for the public runtime surface of this module. */
-export function resolveEmbeddingProviders(settings) {
-    const openAi = resolveOpenAiProvider(settings);
-    const ollama = resolveOllamaProvider(settings);
-    const available = [openAi, ollama].filter((entry) => entry !== null);
-    // Honor `settings.search.provider` when set: if both built-in providers are
-    // configured, the preferred name wins; otherwise fall back to the first
-    // available entry (preserves the previous tie-break: openai > ollama).
-    // Match case-insensitively so "OpenAI" / "Ollama" / "OLLAMA" all work.
-    const preferredName = toNonEmptyString(settings.search?.provider);
-    const preferredKey = preferredName ? preferredName.toLowerCase() : null;
-    const preferred = preferredKey
-        ? available.find((entry) => entry.name === preferredKey)
-        : undefined;
-    return {
-        active: preferred ?? available[0] ?? null,
-        available,
-    };
-}
-/** Implements resolve embedding request target for the public runtime surface of this module. */
-export function resolveEmbeddingRequestTarget(provider) {
-    const baseUrl = trimTrailingSlashes(provider.base_url);
-    if (provider.name === "openai") {
-        return {
-            provider: "openai",
-            endpoint: normalizeOpenAiEmbeddingsEndpoint(baseUrl),
-            model: provider.model,
-        };
-    }
-    return {
-        provider: "ollama",
-        endpoint: `${baseUrl}/api/embed`,
-        model: provider.model,
-    };
-}
-/** Implements build embedding request plan for the public runtime surface of this module. */
-export function buildEmbeddingRequestPlan(provider, input) {
-    const normalizedInputs = normalizeEmbeddingInputs(input);
-    if (provider.name === "openai") {
-        return {
-            target: resolveEmbeddingRequestTarget(provider),
-            method: "POST",
-            headers: {
-                "content-type": "application/json",
-                ...(provider.api_key
-                    ? { authorization: `Bearer ${provider.api_key}` }
-                    : {}),
-            },
-            body: {
-                model: provider.model,
-                input: normalizedInputs.length === 1
-                    ? normalizedInputs[0]
-                    : normalizedInputs,
-            },
-        };
-    }
-    return {
-        target: resolveEmbeddingRequestTarget(provider),
-        method: "POST",
-        headers: {
-            "content-type": "application/json",
-        },
-        body: {
-            model: provider.model,
-            input: normalizedInputs,
-        },
-    };
-}
-/** Implements normalize embedding response for the public runtime surface of this module. */
-export function normalizeEmbeddingResponse(provider, response) {
-    if (provider.name === "openai") {
-        const data = response.data;
-        if (!Array.isArray(data) || data.length === 0) {
-            throw new Error("OpenAI embedding response must include a non-empty data array");
-        }
-        const orderedEntries = buildOrderedOpenAiEntries(data);
-        return orderedEntries.map((entry, index) => {
-            const embedding = entry.embedding;
-            if (!isFiniteNumberArray(embedding)) {
-                throw new Error(`OpenAI embedding response entry at index ${index} is missing a numeric embedding vector`);
-            }
-            return [...embedding];
-        });
-    }
-    const singleEmbedding = response.embedding;
-    if (isFiniteNumberArray(singleEmbedding)) {
-        return [[...singleEmbedding]];
-    }
-    const multipleEmbeddings = response.embeddings;
-    if (Array.isArray(multipleEmbeddings) && multipleEmbeddings.length > 0) {
-        return multipleEmbeddings.map((entry, index) => {
-            if (!isFiniteNumberArray(entry)) {
-                throw new Error(`Ollama embedding response entry at index ${index} is missing a numeric embedding vector`);
-            }
-            return [...entry];
-        });
-    }
-    throw new Error("Ollama embedding response must include embedding or embeddings vectors");
-}
-/** Implements execute embedding request for the public runtime surface of this module. */
-export async function executeEmbeddingRequest(provider, input, options = {}) {
-    const timeoutMs = normalizeSearchHttpTimeoutMs(options.timeout_ms, "Embedding request");
-    const fetcher = resolveSearchHttpFetcher(options.fetcher, "Embedding request");
-    const normalizedInputs = normalizeEmbeddingInputs(input);
-    const dedupedInputs = dedupeEmbeddingInputs(normalizedInputs);
-    const requestPlan = buildEmbeddingRequestPlan(provider, dedupedInputs.uniqueInputs);
-    const payload = await executeSearchJsonRequest({
-        endpoint: requestPlan.target.endpoint,
-        method: requestPlan.method,
-        headers: requestPlan.headers,
-        body: requestPlan.body,
-        timeoutMs,
-        fetcher,
-        requestLabel: "Embedding request",
-        responseLabel: "Embedding response",
-    });
-    const vectors = normalizeEmbeddingResponse(provider, payload);
-    if (vectors.length !== dedupedInputs.uniqueInputs.length) {
-        throw new Error(`Embedding response cardinality mismatch: expected ${dedupedInputs.uniqueInputs.length} vector(s), received ${vectors.length}`);
-    }
-    return dedupedInputs.originalToUniqueIndex.map((uniqueIndex) => [
-        ...vectors[uniqueIndex],
-    ]);
-}
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="2c36f008-53c4-5ee7-bc87-6bfb7aeb8f42")}catch(e2){}})();import{executeSearchJsonRequest,normalizeSearchHttpTimeoutMs,resolveSearchHttpFetcher}from"./http-client.js";import{isFiniteNumberArray,toNonEmptyString,trimTrailingSlashes}from"../shared/primitives.js";function resolveProviderConfigSource(activeName,configured){const active=toNonEmptyString(activeName);if(!active){return"unconfigured"}const configuredValue=toNonEmptyString(configured);return configuredValue&&configuredValue.toLowerCase()===active.toLowerCase()?"configured":"auto-detected"}function normalizeOpenAiEmbeddingsEndpoint(baseUrl){const normalizedBaseUrl=trimTrailingSlashes(baseUrl);const normalizedLower=normalizedBaseUrl.toLowerCase();if(normalizedLower.endsWith("/embeddings")){return normalizedBaseUrl}if(normalizedLower.endsWith("/v1")){return`${normalizedBaseUrl}/embeddings`}return`${normalizedBaseUrl}/v1/embeddings`}function resolveSearchEmbeddingModelOverride(settings){const candidate=settings.search?.embedding_model;return toNonEmptyString(candidate)||null}function resolveOpenAiProvider(settings){const baseUrl=toNonEmptyString(settings.providers?.openai?.base_url);const model=toNonEmptyString(settings.providers?.openai?.model);if(!baseUrl||!model){return null}const override=resolveSearchEmbeddingModelOverride(settings);const apiKey=toNonEmptyString(settings.providers?.openai?.api_key);return{name:"openai",base_url:baseUrl,model:override??model,...apiKey?{api_key:apiKey}:{}}}function resolveOllamaProvider(settings){const baseUrl=toNonEmptyString(settings.providers?.ollama?.base_url);const model=toNonEmptyString(settings.providers?.ollama?.model);if(!baseUrl||!model){return null}const override=resolveSearchEmbeddingModelOverride(settings);return{name:"ollama",base_url:baseUrl,model:override??model}}function normalizeEmbeddingInputs(input){const inputs=(Array.isArray(input)?input:[input]).map(entry=>entry.trim()).filter(entry=>entry.length>0);if(inputs.length===0){throw new Error("Embedding input must include at least one non-empty string")}return inputs}function dedupeEmbeddingInputs(inputs){const uniqueInputs=[];const originalToUniqueIndex=[];const uniqueIndexByInput=new Map;for(const entry of inputs){const existingUniqueIndex=uniqueIndexByInput.get(entry);if(existingUniqueIndex===void 0){const nextUniqueIndex=uniqueInputs.length;uniqueInputs.push(entry);uniqueIndexByInput.set(entry,nextUniqueIndex);originalToUniqueIndex.push(nextUniqueIndex);continue}originalToUniqueIndex.push(existingUniqueIndex)}return{uniqueInputs,originalToUniqueIndex}}function buildOrderedOpenAiEntries(data){const openAiEntries=data.map((entry,position)=>({embedding:entry.embedding,index:entry.index,position}));const hasExplicitIndex=openAiEntries.some(entry=>entry.index!==void 0);if(hasExplicitIndex){for(const entry of openAiEntries){if(!Number.isInteger(entry.index)){throw new TypeError(`OpenAI embedding response entry at position ${entry.position} is missing a valid integer index`)}}return[...openAiEntries].sort((a,b)=>{const byIndex=a.index-b.index;if(byIndex!==0){return byIndex}return a.position-b.position})}return openAiEntries}function resolveEmbeddingProviders(settings){const openAi=resolveOpenAiProvider(settings);const ollama=resolveOllamaProvider(settings);const available=[openAi,ollama].filter(entry=>entry!==null);const preferredName=toNonEmptyString(settings.search?.provider);const preferredKey=preferredName?preferredName.toLowerCase():null;const preferred=preferredKey?available.find(entry=>entry.name===preferredKey):void 0;return{active:preferred??available[0]??null,available}}function resolveEmbeddingRequestTarget(provider){const baseUrl=trimTrailingSlashes(provider.base_url);if(provider.name==="openai"){return{provider:"openai",endpoint:normalizeOpenAiEmbeddingsEndpoint(baseUrl),model:provider.model}}return{provider:"ollama",endpoint:`${baseUrl}/api/embed`,model:provider.model}}function buildEmbeddingRequestPlan(provider,input){const normalizedInputs=normalizeEmbeddingInputs(input);if(provider.name==="openai"){return{target:resolveEmbeddingRequestTarget(provider),method:"POST",headers:{"content-type":"application/json",...provider.api_key?{authorization:`Bearer ${provider.api_key}`}:{}},body:{model:provider.model,input:normalizedInputs.length===1?normalizedInputs[0]:normalizedInputs}}}return{target:resolveEmbeddingRequestTarget(provider),method:"POST",headers:{"content-type":"application/json"},body:{model:provider.model,input:normalizedInputs}}}function normalizeEmbeddingResponse(provider,response){if(provider.name==="openai"){const data=response.data;if(!Array.isArray(data)||data.length===0){throw new Error("OpenAI embedding response must include a non-empty data array")}const orderedEntries=buildOrderedOpenAiEntries(data);return orderedEntries.map((entry,index)=>{const embedding=entry.embedding;if(!isFiniteNumberArray(embedding)){throw new Error(`OpenAI embedding response entry at index ${index} is missing a numeric embedding vector`)}return[...embedding]})}const singleEmbedding=response.embedding;if(isFiniteNumberArray(singleEmbedding)){return[[...singleEmbedding]]}const multipleEmbeddings=response.embeddings;if(Array.isArray(multipleEmbeddings)&&multipleEmbeddings.length>0){return multipleEmbeddings.map((entry,index)=>{if(!isFiniteNumberArray(entry)){throw new Error(`Ollama embedding response entry at index ${index} is missing a numeric embedding vector`)}return[...entry]})}throw new Error("Ollama embedding response must include embedding or embeddings vectors")}async function executeEmbeddingRequest(provider,input,options={}){const timeoutMs=normalizeSearchHttpTimeoutMs(options.timeout_ms,"Embedding request");const fetcher=resolveSearchHttpFetcher(options.fetcher,"Embedding request");const normalizedInputs=normalizeEmbeddingInputs(input);const dedupedInputs=dedupeEmbeddingInputs(normalizedInputs);const requestPlan=buildEmbeddingRequestPlan(provider,dedupedInputs.uniqueInputs);const payload=await executeSearchJsonRequest({endpoint:requestPlan.target.endpoint,method:requestPlan.method,headers:requestPlan.headers,body:requestPlan.body,timeoutMs,fetcher,requestLabel:"Embedding request",responseLabel:"Embedding response"});const vectors=normalizeEmbeddingResponse(provider,payload);if(vectors.length!==dedupedInputs.uniqueInputs.length){throw new Error(`Embedding response cardinality mismatch: expected ${dedupedInputs.uniqueInputs.length} vector(s), received ${vectors.length}`)}return dedupedInputs.originalToUniqueIndex.map(uniqueIndex=>[...vectors[uniqueIndex]])}export{buildEmbeddingRequestPlan,executeEmbeddingRequest,normalizeEmbeddingResponse,resolveEmbeddingProviders,resolveEmbeddingRequestTarget,resolveProviderConfigSource};
 //# sourceMappingURL=providers.js.map
-//# debugId=af754be6-8026-530a-8a20-b03d4ed742e1