teckel-ai 0.3.5 → 0.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,60 +1,37 @@
1
1
  # teckel-ai
2
2
 
3
- TypeScript/JavaScript SDK for [Teckel AI](https://teckel.ai)- Get insight into your AI systems, track topics of your choosing, and identify and fix knowledge gaps.
3
+ TypeScript SDK for [Teckel AI](https://teckel.ai)- Topic focused, RAG friendly, AI observability platform for detecting knowledge gaps and improving agent output.
4
4
 
5
- ## Installation
5
+ ## Install
6
6
 
7
7
  ```bash
8
8
  npm install teckel-ai
9
9
  ```
10
10
 
11
- **Requirements:** Node.js 18+ (or Bun, Deno, serverless runtimes)
12
-
13
- ## Quick Start
11
+ ## Usage
14
12
 
15
13
  ```typescript
16
14
  import { TeckelTracer } from 'teckel-ai';
17
15
 
18
- // Initialize once at startup
19
- const tracer = new TeckelTracer({
20
- apiKey: process.env.TECKEL_API_KEY
16
+ const tracer = new TeckelTracer({ apiKey: process.env.TECKEL_API_KEY });
17
+
18
+ tracer.trace({
19
+ query: "How do I reset my password?",
20
+ response: "Go to Settings > Security...",
21
+ documents: [{ id: "doc-1", name: "Password Guide", text: "To reset..." }]
21
22
  });
22
23
 
23
- // In your API handler
24
- async function handleChat(userQuestion: string, sessionId: string) {
25
- const conversation = tracer.start({ sessionRef: sessionId });
26
-
27
- // Your existing RAG logic
28
- const chunks = await vectorDB.search(userQuestion);
29
- const answer = await llm.generate(userQuestion, chunks);
30
-
31
- // Send trace (non-blocking)
32
- conversation.trace({
33
- query: userQuestion,
34
- response: answer,
35
- documents: chunks.map((chunk, i) => ({
36
- documentRef: chunk.id,
37
- documentName: chunk.title,
38
- documentText: chunk.content,
39
- }))
40
- });
41
-
42
- // For serverless: flush before returning
43
- await conversation.flush();
44
-
45
- return answer;
46
- }
24
+ // Serverless: flush before returning
25
+ await tracer.flush();
47
26
  ```
48
27
 
49
28
  ## Documentation
50
29
 
51
- - **Full SDK Reference:** [docs.teckel.ai/docs/typescript-sdk-reference](https://docs.teckel.ai/docs/typescript-sdk-reference)
52
- - **Getting Started:** [docs.teckel.ai/docs/getting-started](https://docs.teckel.ai/docs/getting-started)
53
-
54
- ## Support
30
+ Full docs at [docs.teckel.ai](https://docs.teckel.ai)
55
31
 
56
- - **Email:** support@teckel.ai
57
- - **Website** [teckel.ai](https://teckel.ai)
32
+ - [Getting Started](https://docs.teckel.ai/docs/getting_started)
33
+ - [SDK Reference](https://docs.teckel.ai/docs/typescript_sdk_reference)
34
+ - [API Reference](https://docs.teckel.ai/docs/http_api_reference)
58
35
 
59
36
  ## License
60
37
 
package/dist/index.d.mts CHANGED
@@ -1,214 +1,179 @@
1
1
  import { z } from 'zod';
2
2
 
3
3
  /**
4
- * Type definitions for teckel-ai SDK v0.3.5
5
- * Simple, clean types matching existing database schema
6
- */
7
- /**
8
- * SDK Configuration
4
+ * Type definitions for teckel-ai SDK
9
5
  */
10
6
  interface TeckelConfig {
7
+ /** Teckel API key (tk_live_...) */
11
8
  apiKey: string;
9
+ /** API endpoint (default: https://app.teckel.ai/api) */
12
10
  endpoint?: string;
11
+ /** Enable debug logging */
13
12
  debug?: boolean;
13
+ /** Network timeout in ms (default: 5000) */
14
14
  timeoutMs?: number;
15
15
  }
16
16
  /**
17
- * Conversation options
18
- * sessionRef IS the conversation identifier
19
- *
20
- * Naming convention:
21
- * - *Ref = Client-provided identifier (TEXT)
22
- * - *Id = Server-generated internal ID (UUID)
23
- */
24
- interface ConversationOptions {
25
- sessionRef?: string;
26
- userRef?: string;
27
- metadata?: Record<string, unknown>;
28
- }
29
- /**
30
- * Document structure for RAG systems
31
- * Matches existing documents + chunk_events schema
17
+ * Document/chunk from your RAG pipeline.
18
+ * The `id` field is your stable identifier - server generates internal UUIDs via deterministic hashing.
32
19
  */
33
20
  interface Document {
34
- documentRef: string;
35
- documentName: string;
36
- documentText: string;
37
- documentLastUpdated?: string;
38
- sourceUri?: string;
39
- sourceType?: string;
21
+ /** Your document identifier (any format: "overview.md", "doc-123", etc.) */
22
+ id: string;
23
+ /** Human-readable document name */
24
+ name: string;
25
+ /** The actual text/chunk content */
26
+ text: string;
27
+ /** ISO 8601 timestamp - enables version tracking */
28
+ lastUpdated?: string;
29
+ /** Link to source (URL, intranet, file://) */
30
+ url?: string;
31
+ /** Storage platform: confluence, slack, gdrive, etc. */
32
+ source?: string;
33
+ /** File format: pdf, docx, md, etc. */
34
+ fileFormat?: string;
35
+ /** Vector similarity score (0-1) */
40
36
  similarity?: number;
37
+ /** Position in results */
41
38
  rank?: number;
39
+ /** Document owner email */
42
40
  ownerEmail?: string;
43
- documentType?: string;
44
41
  }
45
- /**
46
- * Token usage tracking
47
- */
48
42
  interface TokenUsage {
49
43
  prompt: number;
50
44
  completion: number;
51
45
  total: number;
52
46
  }
53
47
  /**
54
- * Trace data for a single query-response interaction
55
- * Matches existing traces table schema
48
+ * Trace data for a single query-response interaction.
49
+ * Sessions are created implicitly when traces share the same sessionId.
56
50
  */
57
51
  interface TraceData {
52
+ /** User's question/prompt */
58
53
  query: string;
54
+ /** LLM's response */
59
55
  response: string;
56
+ /** Model name (e.g., 'gpt-4') */
60
57
  model?: string;
61
- responseTimeMs?: number;
62
- documents?: Document[];
58
+ /** Response time in milliseconds */
59
+ latencyMs?: number;
60
+ /** Token usage */
63
61
  tokens?: TokenUsage;
62
+ /** Source documents used in RAG */
63
+ documents?: Document[];
64
+ /** Groups traces into a session (any string up to 200 chars, OTEL compatible) */
65
+ sessionId?: string;
66
+ /** User identifier */
67
+ userId?: string;
68
+ /** Client-provided trace ID (UUID, auto-generated if omitted) */
69
+ traceId?: string;
70
+ /** LLM system prompt/instructions */
71
+ systemPrompt?: string;
72
+ /** Custom metadata (max 10KB) */
64
73
  metadata?: Record<string, unknown>;
65
- traceRef?: string;
66
- userRef?: string;
67
74
  }
68
- /**
69
- * Feedback types
70
- */
71
75
  type FeedbackType = 'thumbs_up' | 'thumbs_down' | 'flag' | 'rating';
72
76
  /**
73
- * User feedback signal
77
+ * User feedback signal. Target either a specific trace or an entire session.
74
78
  */
75
79
  interface FeedbackData {
80
+ /** Target trace (UUID) */
81
+ traceId?: string;
82
+ /** Target session (any string up to 200 chars) */
83
+ sessionId?: string;
84
+ /** Feedback type */
76
85
  type: FeedbackType;
86
+ /** For ratings: '1'-'5' */
77
87
  value?: string;
88
+ /** Optional comment */
78
89
  comment?: string;
79
- traceRef?: string;
80
90
  }
81
- /**
82
- * Result returned when a trace is created
83
- */
84
91
  interface TraceResult {
85
- traceRef: string;
86
- turnNumber: number;
92
+ traceId: string;
93
+ sessionId?: string;
94
+ chunkCount: number;
95
+ }
96
+ interface FeedbackResult {
97
+ feedbackId: string;
98
+ type: FeedbackType;
99
+ traceId?: string;
100
+ sessionId?: string;
87
101
  }
88
102
 
89
103
  /**
90
- * Conversation class for teckel-ai SDK v0.3.5
91
- * Manages a single conversation with fire-and-forget semantics
104
+ * TeckelTracer - Fire-and-forget trace collection for AI applications
92
105
  */
93
106
 
94
- /** Internal type - sessionRef is guaranteed by TeckelTracer.start() */
95
- interface ResolvedConversationOptions extends ConversationOptions {
96
- sessionRef: string;
97
- }
98
- declare class Conversation {
107
+ declare class TeckelTracer {
99
108
  private readonly apiKey;
100
109
  private readonly endpoint;
101
- private readonly sessionRef;
102
- private readonly userRef?;
103
- private readonly metadata?;
104
- private readonly startedAt;
105
110
  private readonly debug;
106
111
  private readonly timeoutMs;
107
- private turnCount;
108
- private startPromise;
109
112
  private sendQueue;
110
- constructor(apiKey: string, endpoint: string, options: ResolvedConversationOptions, debug?: boolean, extras?: {
111
- timeoutMs: number;
112
- });
113
- /**
114
- * Record a trace (single query-response interaction)
115
- * Fire-and-forget by default - never blocks
116
- * For serverless, call flush() before function termination
117
- */
118
- trace(data: TraceData): TraceResult | void;
113
+ constructor(config: TeckelConfig);
119
114
  /**
120
- * Add user feedback signal
121
- * Never throws - gracefully handles errors
115
+ * Record a trace. Fire-and-forget - call flush() in serverless before termination.
122
116
  */
123
- feedback(data: FeedbackData): Promise<void>;
117
+ trace(data: TraceData): void;
124
118
  /**
125
- * End the conversation
126
- * Flushes all pending traces before sending end signal
127
- * Never throws - gracefully handles errors
119
+ * Submit feedback for a trace or session.
128
120
  */
129
- end(): Promise<void>;
121
+ feedback(data: FeedbackData): void;
130
122
  /**
131
- * Read-only properties
132
- */
133
- get id(): string;
134
- get turns(): number;
135
- get started(): Date;
136
- private fetchWithRetry;
137
- private _startConversation;
138
- private _sendTrace;
139
- private _sendFeedback;
140
- private _endConversation;
141
- private enqueueSend;
142
- /**
143
- * Flush queued sends with a bounded timeout.
144
- * Returns when the queue is empty or the timeout elapses (whichever comes first).
123
+ * Wait for queued requests to complete. Essential for serverless environments.
145
124
  */
146
125
  flush(timeoutMs?: number): Promise<void>;
126
+ private send;
127
+ private fetchWithRetry;
128
+ private enqueue;
129
+ private logValidationError;
130
+ private logHttpError;
147
131
  }
148
132
 
149
133
  /**
150
- * TeckelTracer - Main SDK class for teckel-ai v0.3.5
151
- * Simple, lightweight SDK for AI conversation tracking
152
- */
153
-
154
- declare class TeckelTracer {
155
- private readonly apiKey;
156
- private readonly endpoint;
157
- private readonly debug;
158
- private readonly timeoutMs;
159
- constructor(config: TeckelConfig);
160
- /**
161
- * Start a new conversation
162
- * sessionRef IS the public conversation identifier
163
- * If not provided, auto-generates one as 'auto:{8-char-uuid}'
164
- */
165
- start(options?: ConversationOptions): Conversation;
166
- }
167
-
168
- /**
169
- * Zod validation schemas for teckel-ai SDK v0.3.5
134
+ * Zod validation schemas for teckel-ai SDK
170
135
  */
171
136
 
172
- /**
173
- * Document schema
174
- */
137
+ /** Payload size limits */
138
+ declare const TRACE_SIZE_LIMITS: {
139
+ readonly METADATA_MAX_BYTES: 10000;
140
+ readonly TRACE_MAX_BYTES: 3000000;
141
+ readonly MAX_DOCUMENTS: 15;
142
+ };
175
143
  declare const DocumentSchema: z.ZodObject<{
176
- documentRef: z.ZodString;
177
- documentName: z.ZodString;
178
- documentText: z.ZodString;
179
- documentLastUpdated: z.ZodOptional<z.ZodString>;
180
- sourceUri: z.ZodOptional<z.ZodString>;
181
- sourceType: z.ZodOptional<z.ZodString>;
144
+ id: z.ZodString;
145
+ name: z.ZodString;
146
+ text: z.ZodString;
147
+ lastUpdated: z.ZodOptional<z.ZodString>;
148
+ url: z.ZodOptional<z.ZodString>;
149
+ source: z.ZodOptional<z.ZodString>;
150
+ fileFormat: z.ZodOptional<z.ZodString>;
182
151
  similarity: z.ZodOptional<z.ZodNumber>;
183
152
  rank: z.ZodOptional<z.ZodNumber>;
184
153
  ownerEmail: z.ZodOptional<z.ZodString>;
185
- documentType: z.ZodOptional<z.ZodString>;
186
154
  }, "strip", z.ZodTypeAny, {
187
- documentRef: string;
188
- documentName: string;
189
- documentText: string;
190
- documentLastUpdated?: string | undefined;
191
- sourceUri?: string | undefined;
192
- sourceType?: string | undefined;
155
+ id: string;
156
+ name: string;
157
+ text: string;
158
+ lastUpdated?: string | undefined;
159
+ url?: string | undefined;
160
+ source?: string | undefined;
161
+ fileFormat?: string | undefined;
193
162
  similarity?: number | undefined;
194
163
  rank?: number | undefined;
195
164
  ownerEmail?: string | undefined;
196
- documentType?: string | undefined;
197
165
  }, {
198
- documentRef: string;
199
- documentName: string;
200
- documentText: string;
201
- documentLastUpdated?: string | undefined;
202
- sourceUri?: string | undefined;
203
- sourceType?: string | undefined;
166
+ id: string;
167
+ name: string;
168
+ text: string;
169
+ lastUpdated?: string | undefined;
170
+ url?: string | undefined;
171
+ source?: string | undefined;
172
+ fileFormat?: string | undefined;
204
173
  similarity?: number | undefined;
205
174
  rank?: number | undefined;
206
175
  ownerEmail?: string | undefined;
207
- documentType?: string | undefined;
208
176
  }>;
209
- /**
210
- * Token usage schema
211
- */
212
177
  declare const TokenUsageSchema: z.ZodObject<{
213
178
  prompt: z.ZodNumber;
214
179
  completion: z.ZodNumber;
@@ -222,48 +187,11 @@ declare const TokenUsageSchema: z.ZodObject<{
222
187
  completion: number;
223
188
  total: number;
224
189
  }>;
225
- /**
226
- * Trace data schema
227
- */
228
- declare const TraceDataSchema: z.ZodObject<{
190
+ declare const TraceDataSchema: z.ZodEffects<z.ZodObject<{
229
191
  query: z.ZodString;
230
192
  response: z.ZodString;
231
193
  model: z.ZodOptional<z.ZodString>;
232
- responseTimeMs: z.ZodOptional<z.ZodNumber>;
233
- documents: z.ZodOptional<z.ZodArray<z.ZodObject<{
234
- documentRef: z.ZodString;
235
- documentName: z.ZodString;
236
- documentText: z.ZodString;
237
- documentLastUpdated: z.ZodOptional<z.ZodString>;
238
- sourceUri: z.ZodOptional<z.ZodString>;
239
- sourceType: z.ZodOptional<z.ZodString>;
240
- similarity: z.ZodOptional<z.ZodNumber>;
241
- rank: z.ZodOptional<z.ZodNumber>;
242
- ownerEmail: z.ZodOptional<z.ZodString>;
243
- documentType: z.ZodOptional<z.ZodString>;
244
- }, "strip", z.ZodTypeAny, {
245
- documentRef: string;
246
- documentName: string;
247
- documentText: string;
248
- documentLastUpdated?: string | undefined;
249
- sourceUri?: string | undefined;
250
- sourceType?: string | undefined;
251
- similarity?: number | undefined;
252
- rank?: number | undefined;
253
- ownerEmail?: string | undefined;
254
- documentType?: string | undefined;
255
- }, {
256
- documentRef: string;
257
- documentName: string;
258
- documentText: string;
259
- documentLastUpdated?: string | undefined;
260
- sourceUri?: string | undefined;
261
- sourceType?: string | undefined;
262
- similarity?: number | undefined;
263
- rank?: number | undefined;
264
- ownerEmail?: string | undefined;
265
- documentType?: string | undefined;
266
- }>, "many">>;
194
+ latencyMs: z.ZodOptional<z.ZodNumber>;
267
195
  tokens: z.ZodOptional<z.ZodObject<{
268
196
  prompt: z.ZodNumber;
269
197
  completion: z.ZodNumber;
@@ -277,98 +205,185 @@ declare const TraceDataSchema: z.ZodObject<{
277
205
  completion: number;
278
206
  total: number;
279
207
  }>>;
280
- metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
281
- traceRef: z.ZodOptional<z.ZodString>;
282
- userRef: z.ZodOptional<z.ZodString>;
208
+ documents: z.ZodOptional<z.ZodArray<z.ZodObject<{
209
+ id: z.ZodString;
210
+ name: z.ZodString;
211
+ text: z.ZodString;
212
+ lastUpdated: z.ZodOptional<z.ZodString>;
213
+ url: z.ZodOptional<z.ZodString>;
214
+ source: z.ZodOptional<z.ZodString>;
215
+ fileFormat: z.ZodOptional<z.ZodString>;
216
+ similarity: z.ZodOptional<z.ZodNumber>;
217
+ rank: z.ZodOptional<z.ZodNumber>;
218
+ ownerEmail: z.ZodOptional<z.ZodString>;
219
+ }, "strip", z.ZodTypeAny, {
220
+ id: string;
221
+ name: string;
222
+ text: string;
223
+ lastUpdated?: string | undefined;
224
+ url?: string | undefined;
225
+ source?: string | undefined;
226
+ fileFormat?: string | undefined;
227
+ similarity?: number | undefined;
228
+ rank?: number | undefined;
229
+ ownerEmail?: string | undefined;
230
+ }, {
231
+ id: string;
232
+ name: string;
233
+ text: string;
234
+ lastUpdated?: string | undefined;
235
+ url?: string | undefined;
236
+ source?: string | undefined;
237
+ fileFormat?: string | undefined;
238
+ similarity?: number | undefined;
239
+ rank?: number | undefined;
240
+ ownerEmail?: string | undefined;
241
+ }>, "many">>;
242
+ sessionId: z.ZodOptional<z.ZodString>;
243
+ userId: z.ZodOptional<z.ZodString>;
244
+ traceId: z.ZodOptional<z.ZodString>;
245
+ systemPrompt: z.ZodOptional<z.ZodString>;
246
+ metadata: z.ZodEffects<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>, Record<string, unknown> | undefined, Record<string, unknown> | undefined>;
283
247
  }, "strip", z.ZodTypeAny, {
284
248
  query: string;
285
249
  response: string;
286
250
  model?: string | undefined;
287
- responseTimeMs?: number | undefined;
251
+ latencyMs?: number | undefined;
252
+ tokens?: {
253
+ prompt: number;
254
+ completion: number;
255
+ total: number;
256
+ } | undefined;
288
257
  documents?: {
289
- documentRef: string;
290
- documentName: string;
291
- documentText: string;
292
- documentLastUpdated?: string | undefined;
293
- sourceUri?: string | undefined;
294
- sourceType?: string | undefined;
258
+ id: string;
259
+ name: string;
260
+ text: string;
261
+ lastUpdated?: string | undefined;
262
+ url?: string | undefined;
263
+ source?: string | undefined;
264
+ fileFormat?: string | undefined;
295
265
  similarity?: number | undefined;
296
266
  rank?: number | undefined;
297
267
  ownerEmail?: string | undefined;
298
- documentType?: string | undefined;
299
268
  }[] | undefined;
269
+ sessionId?: string | undefined;
270
+ userId?: string | undefined;
271
+ traceId?: string | undefined;
272
+ systemPrompt?: string | undefined;
273
+ metadata?: Record<string, unknown> | undefined;
274
+ }, {
275
+ query: string;
276
+ response: string;
277
+ model?: string | undefined;
278
+ latencyMs?: number | undefined;
300
279
  tokens?: {
301
280
  prompt: number;
302
281
  completion: number;
303
282
  total: number;
304
283
  } | undefined;
284
+ documents?: {
285
+ id: string;
286
+ name: string;
287
+ text: string;
288
+ lastUpdated?: string | undefined;
289
+ url?: string | undefined;
290
+ source?: string | undefined;
291
+ fileFormat?: string | undefined;
292
+ similarity?: number | undefined;
293
+ rank?: number | undefined;
294
+ ownerEmail?: string | undefined;
295
+ }[] | undefined;
296
+ sessionId?: string | undefined;
297
+ userId?: string | undefined;
298
+ traceId?: string | undefined;
299
+ systemPrompt?: string | undefined;
305
300
  metadata?: Record<string, unknown> | undefined;
306
- traceRef?: string | undefined;
307
- userRef?: string | undefined;
308
- }, {
301
+ }>, {
309
302
  query: string;
310
303
  response: string;
311
304
  model?: string | undefined;
312
- responseTimeMs?: number | undefined;
305
+ latencyMs?: number | undefined;
306
+ tokens?: {
307
+ prompt: number;
308
+ completion: number;
309
+ total: number;
310
+ } | undefined;
313
311
  documents?: {
314
- documentRef: string;
315
- documentName: string;
316
- documentText: string;
317
- documentLastUpdated?: string | undefined;
318
- sourceUri?: string | undefined;
319
- sourceType?: string | undefined;
312
+ id: string;
313
+ name: string;
314
+ text: string;
315
+ lastUpdated?: string | undefined;
316
+ url?: string | undefined;
317
+ source?: string | undefined;
318
+ fileFormat?: string | undefined;
320
319
  similarity?: number | undefined;
321
320
  rank?: number | undefined;
322
321
  ownerEmail?: string | undefined;
323
- documentType?: string | undefined;
324
322
  }[] | undefined;
323
+ sessionId?: string | undefined;
324
+ userId?: string | undefined;
325
+ traceId?: string | undefined;
326
+ systemPrompt?: string | undefined;
327
+ metadata?: Record<string, unknown> | undefined;
328
+ }, {
329
+ query: string;
330
+ response: string;
331
+ model?: string | undefined;
332
+ latencyMs?: number | undefined;
325
333
  tokens?: {
326
334
  prompt: number;
327
335
  completion: number;
328
336
  total: number;
329
337
  } | undefined;
338
+ documents?: {
339
+ id: string;
340
+ name: string;
341
+ text: string;
342
+ lastUpdated?: string | undefined;
343
+ url?: string | undefined;
344
+ source?: string | undefined;
345
+ fileFormat?: string | undefined;
346
+ similarity?: number | undefined;
347
+ rank?: number | undefined;
348
+ ownerEmail?: string | undefined;
349
+ }[] | undefined;
350
+ sessionId?: string | undefined;
351
+ userId?: string | undefined;
352
+ traceId?: string | undefined;
353
+ systemPrompt?: string | undefined;
330
354
  metadata?: Record<string, unknown> | undefined;
331
- traceRef?: string | undefined;
332
- userRef?: string | undefined;
333
- }>;
334
- /**
335
- * Conversation options schema
336
- */
337
- declare const ConversationOptionsSchema: z.ZodObject<{
338
- sessionRef: z.ZodOptional<z.ZodString>;
339
- userRef: z.ZodOptional<z.ZodString>;
340
- metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
341
- }, "strip", z.ZodTypeAny, {
342
- metadata?: Record<string, unknown> | undefined;
343
- userRef?: string | undefined;
344
- sessionRef?: string | undefined;
345
- }, {
346
- metadata?: Record<string, unknown> | undefined;
347
- userRef?: string | undefined;
348
- sessionRef?: string | undefined;
349
355
  }>;
350
- /**
351
- * Feedback data schema
352
- */
353
- declare const FeedbackDataSchema: z.ZodObject<{
356
+ declare const FeedbackDataSchema: z.ZodEffects<z.ZodObject<{
357
+ traceId: z.ZodOptional<z.ZodString>;
358
+ sessionId: z.ZodOptional<z.ZodString>;
354
359
  type: z.ZodEnum<["thumbs_up", "thumbs_down", "flag", "rating"]>;
355
360
  value: z.ZodOptional<z.ZodString>;
356
361
  comment: z.ZodOptional<z.ZodString>;
357
- traceRef: z.ZodOptional<z.ZodString>;
358
362
  }, "strip", z.ZodTypeAny, {
359
363
  type: "thumbs_up" | "thumbs_down" | "flag" | "rating";
360
364
  value?: string | undefined;
361
- traceRef?: string | undefined;
365
+ sessionId?: string | undefined;
366
+ traceId?: string | undefined;
367
+ comment?: string | undefined;
368
+ }, {
369
+ type: "thumbs_up" | "thumbs_down" | "flag" | "rating";
370
+ value?: string | undefined;
371
+ sessionId?: string | undefined;
372
+ traceId?: string | undefined;
373
+ comment?: string | undefined;
374
+ }>, {
375
+ type: "thumbs_up" | "thumbs_down" | "flag" | "rating";
376
+ value?: string | undefined;
377
+ sessionId?: string | undefined;
378
+ traceId?: string | undefined;
362
379
  comment?: string | undefined;
363
380
  }, {
364
381
  type: "thumbs_up" | "thumbs_down" | "flag" | "rating";
365
382
  value?: string | undefined;
366
- traceRef?: string | undefined;
383
+ sessionId?: string | undefined;
384
+ traceId?: string | undefined;
367
385
  comment?: string | undefined;
368
386
  }>;
369
- /**
370
- * Config schema
371
- */
372
387
  declare const TeckelConfigSchema: z.ZodObject<{
373
388
  apiKey: z.ZodString;
374
389
  endpoint: z.ZodOptional<z.ZodString>;
@@ -386,4 +401,4 @@ declare const TeckelConfigSchema: z.ZodObject<{
386
401
  timeoutMs?: number | undefined;
387
402
  }>;
388
403
 
389
- export { Conversation, type ConversationOptions, ConversationOptionsSchema, type Document, DocumentSchema, type FeedbackData, FeedbackDataSchema, type FeedbackType, type TeckelConfig, TeckelConfigSchema, TeckelTracer, type TokenUsage, TokenUsageSchema, type TraceData, TraceDataSchema, type TraceResult };
404
+ export { type Document, DocumentSchema, type FeedbackData, FeedbackDataSchema, type FeedbackResult, type FeedbackType, TRACE_SIZE_LIMITS, type TeckelConfig, TeckelConfigSchema, TeckelTracer, type TokenUsage, TokenUsageSchema, type TraceData, TraceDataSchema, type TraceResult };