Class ReflectionsClient

ReflectionsClient class - Query and analytics for Insights events

Constructors

constructor

new ReflectionsClient(config?): node.common.apis.reflections.ReflectionsClient
Parameters
- Optionalconfig: node.common.apis.reflections.ReflectionsConfig
Returns node.common.apis.reflections.ReflectionsClient
- Defined in packages/ts_common/dist/apis/reflections.d.ts:16

Methods

analyzeErrors

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

analyzeLLMUsage

analyzeLLMUsage(time_range, filter?): Promise<node.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<node.common.apis.reflections.QueryFilter>
Returns Promise<node.common.apis.reflections.LLMAnalytics>
- Defined in packages/ts_common/dist/apis/reflections.d.ts:57

analyzePerformance

analyzePerformance(time_range, filter?): Promise<node.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<node.common.apis.reflections.QueryFilter>
Returns Promise<node.common.apis.reflections.PerformanceMetrics>
- Defined in packages/ts_common/dist/apis/reflections.d.ts:65

analyzeSession

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

analyzeTrace

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

getAllTags

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

Returns Promise<string[]>
- Defined in packages/ts_common/dist/apis/reflections.d.ts:108

getCacheStats

getCacheStats(): any
Get cache statistics

Returns any
- Defined in packages/ts_common/dist/apis/reflections.d.ts:128

getConfig

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

Returns Required<node.common.apis.reflections.ReflectionsConfig>
- Defined in packages/ts_common/dist/apis/reflections.d.ts:136

getDatabaseStats

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

Returns Promise<node.common.apis.reflections.DatabaseStats>
- Defined in packages/ts_common/dist/apis/reflections.d.ts:116

getEventById

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

getEventTypeStats

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

Returns Promise<node.common.apis.reflections.EventTypeStats[]>
- Defined in packages/ts_common/dist/apis/reflections.d.ts:84

getEventTypes

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

Returns Promise<string[]>
- Defined in packages/ts_common/dist/apis/reflections.d.ts:80

getEventsBySession

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

getEventsByTrace

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

getEventsByType

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

getSessions

getSessions(limit?): Promise<string[]>
Get list of all session IDs
Parameters
- Optionallimit: number
Returns Promise<string[]>
- Defined in packages/ts_common/dist/apis/reflections.d.ts:92

getTimeRange

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

Returns Promise<node.common.apis.reflections.TimeRangeInfo>
- Defined in packages/ts_common/dist/apis/reflections.d.ts:112

getTraces

getTraces(limit?): Promise<string[]>
Get list of all trace IDs
Parameters
- Optionallimit: number
Returns Promise<string[]>
- Defined in packages/ts_common/dist/apis/reflections.d.ts:96

inspectPayloadSchema

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

inspectSession

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

inspectTrace

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

invalidateCache

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

queryEvents

queryEvents(filter?): Promise<node.common.apis.reflections.QueryResult>
Query events with flexible filtering Core method that all other queries build upon
Parameters
- Optionalfilter: node.common.apis.reflections.QueryFilter
Returns Promise<node.common.apis.reflections.QueryResult>
- Defined in packages/ts_common/dist/apis/reflections.d.ts:21

sampleEvents

sampleEvents(event_type, limit?): Promise<node.apis.insights.InsightsEvent[]>
Sample events of a specific type
Parameters
- event_type: string
- Optionallimit: number
Returns Promise<node.apis.insights.InsightsEvent[]>
- Defined in packages/ts_common/dist/apis/reflections.d.ts:120

setEnabled

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