🪢 Open source agent evals & observability: Trace, evaluate, and improve LLM applications with one open platform.
TypeScript analyticsautogenevaluationlangchainlarge-language-modelsllama-indexllmllm-evaluationllm-observabilityllmopsmonitoringobservabilityopen-sourceopenaiplaygroundprompt-engineeringprompt-managementself-hostedycombinator
import type { FilterCondition } from "../../../types";
import type { TracingSearchType } from "../../../interfaces/search";
import type { EventsQueryBuilder } from "./event-query-builder";
import {
buildEventsObservationRowSelection,
buildEventsObservationRowSelectionForBlobExport,
} from "./events-observation-row-selection";
export type EventsStreamQueryInput = {
projectId: string;
cutoffCreatedAt?: Date;
filter: FilterCondition[] | null;
searchQuery?: string;
searchType?: TracingSearchType[];
rowLimit: number;
};
export type EventsStreamQuery = {
queryBuilder: EventsQueryBuilder;
};
export type EventsBlobExportStreamQuery = EventsStreamQuery & {
startTimeFrom: string | null;
};
/**
* Builds the common event selection used by streaming consumers.
*
* The returned builder is intentionally unprojected so each consumer can
* select its own row shape. Callers must add a field set or raw selection
* before building the query.
*
* Score filters are applied by the shared row-selection planner. Comment
* filters must be resolved to event IDs before reaching this builder.
*/
const buildEventsStreamQueryInternal = (
{
projectId,
cutoffCreatedAt,
filter,
searchQuery,
searchType,
rowLimit,
}: EventsStreamQueryInput,
buildRowSelection: typeof buildEventsObservationRowSelection,
): EventsBlobExportStreamQuery => {
const filterConditions: FilterCondition[] = [...(filter ?? [])];
if (cutoffCreatedAt) {
filterConditions.push({
column: "startTime",
operator: "<",
value: cutoffCreatedAt,
type: "datetime",
});
}
const { queryBuilder, startTimeFrom } = buildRowSelection({
projectId,
filter: filterConditions,
searchQuery,
searchType,
});
queryBuilder
.whereRaw("e.is_deleted = 0")
.orderByDefault()
.limitBy("e.span_id", "e.project_id")
.limit(rowLimit);
return {
queryBuilder,
startTimeFrom,
};
};
export const buildEventsStreamQuery = (
input: EventsStreamQueryInput,
): EventsStreamQuery =>
buildEventsStreamQueryInternal(input, buildEventsObservationRowSelection);
/**
* Builds the blob-export selection, including its observation-score projection
* and the matching aggregation source.
*/
export const buildEventsBlobExportStreamQuery = (
input: EventsStreamQueryInput,
): EventsBlobExportStreamQuery => {
const result = buildEventsStreamQueryInternal(
input,
buildEventsObservationRowSelectionForBlobExport,
);
result.queryBuilder
.selectFieldSet("export")
.selectIO(false) // Full I/O, no truncation
.selectMetadataExpanded(); // Full metadata values from events_full
return result;
};