Class ReflectionsClient

ReflectionsClient class - Query and analytics for Insights events

Constructors

constructor

new ReflectionsClient(config?): common.apis.reflections.ReflectionsClient
Parameters
- config: common.apis.reflections.ReflectionsConfig = {}
Returns common.apis.reflections.ReflectionsClient
- Defined in packages/ts_common/src/apis/reflections.ts:40

Methods

analyzeErrors

analyzeErrors(time_range, filter?): Promise<common.apis.reflections.ErrorAnalysis>
Analyze errors Full implementation in Phase 4
Parameters
- time_range: {
  end: number;
  start: number;
  }
  - end: number
  - start: number
- Optionalfilter: Partial<common.apis.reflections.QueryFilter>
Returns Promise<common.apis.reflections.ErrorAnalysis>
- Defined in packages/ts_common/src/apis/reflections.ts:252

analyzeLLMUsage

analyzeLLMUsage(time_range, filter?): Promise<common.apis.reflections.LLMAnalytics>
Analyze LLM usage across time range Full implementation in Phase 4
Parameters
- time_range: {
  end: number;
  start: number;
  }
  - end: number
  - start: number
- Optionalfilter: Partial<common.apis.reflections.QueryFilter>
Returns Promise<common.apis.reflections.LLMAnalytics>
- Defined in packages/ts_common/src/apis/reflections.ts:230

analyzePerformance

analyzePerformance(time_range, filter?): Promise<common.apis.reflections.PerformanceMetrics>
Analyze performance metrics Full implementation in Phase 4
Parameters
- time_range: {
  end: number;
  start: number;
  }
  - end: number
  - start: number
- Optionalfilter: Partial<common.apis.reflections.QueryFilter>
Returns Promise<common.apis.reflections.PerformanceMetrics>
- Defined in packages/ts_common/src/apis/reflections.ts:241

analyzeSession

analyzeSession(session_id): Promise<common.apis.reflections.SessionAnalysis>
Analyze a complete session Full implementation in Phase 3
Parameters
- session_id: string
Returns Promise<common.apis.reflections.SessionAnalysis>
- Defined in packages/ts_common/src/apis/reflections.ts:210

analyzeTrace

analyzeTrace(trace_id): Promise<common.apis.reflections.TraceAnalysis>
Analyze a trace (event chain) Full implementation in Phase 3
Parameters
- trace_id: string
Returns Promise<common.apis.reflections.TraceAnalysis>
- Defined in packages/ts_common/src/apis/reflections.ts:218

getAllTags

getAllTags(): Promise<string[]>
Get all unique tags used in events

Returns Promise<string[]>
- Defined in packages/ts_common/src/apis/reflections.ts:498

getCacheStats

getCacheStats(): any
Get cache statistics

Returns any
- Defined in packages/ts_common/src/apis/reflections.ts:610

getConfig

getConfig(): Required<common.apis.reflections.ReflectionsConfig>
Get current configuration

Returns Required<common.apis.reflections.ReflectionsConfig>
- Defined in packages/ts_common/src/apis/reflections.ts:632

getDatabaseStats

getDatabaseStats(): Promise<common.apis.reflections.DatabaseStats>
Get overall database statistics

Returns Promise<common.apis.reflections.DatabaseStats>
- Defined in packages/ts_common/src/apis/reflections.ts:545

getEventById

getEventById(event_id): Promise<null | common.insights.InsightsEvent>
Get single event by ID
Parameters
- event_id: string
Returns Promise<null | common.insights.InsightsEvent>
- Defined in packages/ts_common/src/apis/reflections.ts:194

getEventTypeStats

getEventTypeStats(): Promise<common.apis.reflections.EventTypeStats[]>
Get statistics for each event type

Returns Promise<common.apis.reflections.EventTypeStats[]>
- Defined in packages/ts_common/src/apis/reflections.ts:275

getEventTypes

getEventTypes(): Promise<string[]>
Get all unique event types in the database

Returns Promise<string[]>
- Defined in packages/ts_common/src/apis/reflections.ts:266

getEventsBySession

getEventsBySession(session_id, options?): Promise<common.apis.reflections.QueryResult>
Get all events for a session
Parameters
- session_id: string
- options: {
  limit?: number;
  } = {}
  - Optionallimit?: number
Returns Promise<common.apis.reflections.QueryResult>
- Defined in packages/ts_common/src/apis/reflections.ts:154

getEventsByTrace

getEventsByTrace(trace_id): Promise<common.apis.reflections.QueryResult>
Get all events for a trace
Parameters
- trace_id: string
Returns Promise<common.apis.reflections.QueryResult>
- Defined in packages/ts_common/src/apis/reflections.ts:169

getEventsByType

getEventsByType(event_type, options?): Promise<common.apis.reflections.QueryResult>
Get events by type
Parameters
- event_type: string
- options: {
  limit?: number;
  session_id?: string;
  } = {}
  - Optionallimit?: number
  - Optionalsession_id?: string
Returns Promise<common.apis.reflections.QueryResult>
- Defined in packages/ts_common/src/apis/reflections.ts:180

getSessions

getSessions(limit?): Promise<string[]>
Get list of all session IDs
Parameters
- limit: number = 100
Returns Promise<string[]>
- Defined in packages/ts_common/src/apis/reflections.ts:365

getTimeRange

getTimeRange(): Promise<common.apis.reflections.TimeRangeInfo>
Get time range of all events in database

Returns Promise<common.apis.reflections.TimeRangeInfo>
- Defined in packages/ts_common/src/apis/reflections.ts:514

getTraces

getTraces(limit?): Promise<string[]>
Get list of all trace IDs
Parameters
- limit: number = 100
Returns Promise<string[]>
- Defined in packages/ts_common/src/apis/reflections.ts:374

inspectPayloadSchema

inspectPayloadSchema(event_type): Promise<common.apis.reflections.PayloadSchemaInspection>
Inspect payload schema for a specific event type
Parameters
- event_type: string
Returns Promise<common.apis.reflections.PayloadSchemaInspection>
- Defined in packages/ts_common/src/apis/reflections.ts:311

inspectSession

inspectSession(session_id): Promise<common.apis.reflections.SessionInspection>
Inspect a specific session
Parameters
- session_id: string
Returns Promise<common.apis.reflections.SessionInspection>
- Defined in packages/ts_common/src/apis/reflections.ts:385

inspectTrace

inspectTrace(trace_id): Promise<common.apis.reflections.TraceInspection>
Inspect a specific trace (event chain)
Parameters
- trace_id: string
Returns Promise<common.apis.reflections.TraceInspection>
- Defined in packages/ts_common/src/apis/reflections.ts:426

invalidateCache

invalidateCache(pattern?): Promise<void>
Invalidate cache for specific key pattern
Parameters
- Optionalpattern: string
Returns Promise<void>
- Defined in packages/ts_common/src/apis/reflections.ts:588

queryEvents

queryEvents(filter?): Promise<common.apis.reflections.QueryResult>
Query events with flexible filtering Core method that all other queries build upon
Parameters
- filter: common.apis.reflections.QueryFilter = {}
Returns Promise<common.apis.reflections.QueryResult>
- Defined in packages/ts_common/src/apis/reflections.ts:76

sampleEvents

sampleEvents(event_type, limit?): Promise<common.insights.InsightsEvent[]>
Sample events of a specific type
Parameters
- event_type: string
- limit: number = 10
Returns Promise<common.insights.InsightsEvent[]>
- Defined in packages/ts_common/src/apis/reflections.ts:573

setEnabled

setEnabled(enabled): void
Enable/disable client
Parameters
- enabled: boolean
Returns void
- Defined in packages/ts_common/src/apis/reflections.ts:624