@handlebar/governance-schema 0.0.6-dev.0 → 0.0.6-dev.10

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
@@ -2,30 +2,12 @@
2
2
 
3
3
  Schemas and types for [Handlebar] rules.
4
4
 
5
- _Note: This package in early development and the interface is subject to change._
6
-
7
- ## Roadmap
8
-
9
- Handlebar is in early development. We have a lot of functionality planned,
10
- but need your feedback on what you need to help you build better agents.
11
-
12
- - Refer to the [roadmap][root_roadmap] to see what we're cooking.
13
- - Please feel free to [open an issue](https://github.com/gethandlebar/handlebar-js/issues/new) if you have any feedback or suggestions
14
- - or [join our Discord][discord_invite] to talk to us directly
15
-
16
- See [contributing][root_contributing] for more ways to get in touch and help.
17
-
18
5
  ## Getting started
19
6
 
20
7
  This package should be used alongside a framework-specific Handlebar SDK,
21
8
  such as [ai-sdk-v5](https://github.com/gethandlebar/handlebar-js/blob/main/packages/ai-sdk-v5/).
22
9
  Refer to that package's README for more information.
23
10
 
24
- Please refer to [`./examples/`][examples] for a runable demo of [Handlebar]
25
- applied to an ai sdk agent.
26
-
27
- **N.b. Our developer docs are incoming.**
28
-
29
11
  ## Contributing
30
12
 
31
13
  We welcome contributions from the community: bug reports, feedback, feature requests
@@ -35,10 +17,8 @@ and guidelines.
35
17
 
36
18
  ## About Handlebar
37
19
 
38
- Find out more at https://gethandlebar.com
20
+ Find out more at [https://gethandlebar.com][handlebar]
39
21
 
40
22
  [handlebar]: https://gethandlebar.com
41
- [root_roadmap]: https://github.com/gethandlebar/handlebar-js/blob/main/ROADMAP.md
42
23
  [root_contributing]: https://github.com/gethandlebar/handlebar-js/blob/main/CONTRIBUTING.md
43
- [examples]: https://github.com/gethandlebar/handlebar-js/blob/main/examples/ai-sdk-v5/
44
24
  [discord_invite]: https://discord.gg/Q6xwvccg
@@ -5,11 +5,7 @@ export declare const AuditEnvelopeSchema: z.ZodObject<{
5
5
  runId: z.ZodString;
6
6
  stepIndex: z.ZodOptional<z.ZodNumber>;
7
7
  decisionId: z.ZodOptional<z.ZodString>;
8
- user: z.ZodOptional<z.ZodObject<{
9
- userId: z.ZodOptional<z.ZodString>;
10
- userCategory: z.ZodOptional<z.ZodString>;
11
- sessionId: z.ZodOptional<z.ZodString>;
12
- }, z.core.$strip>>;
8
+ enduserExternalId: z.ZodOptional<z.ZodString>;
13
9
  otel: z.ZodOptional<z.ZodObject<{
14
10
  traceId: z.ZodOptional<z.ZodString>;
15
11
  spanId: z.ZodOptional<z.ZodString>;
@@ -5,11 +5,7 @@ export declare const RunStartedEventSchema: z.ZodObject<{
5
5
  runId: z.ZodString;
6
6
  stepIndex: z.ZodOptional<z.ZodNumber>;
7
7
  decisionId: z.ZodOptional<z.ZodString>;
8
- user: z.ZodOptional<z.ZodObject<{
9
- userId: z.ZodOptional<z.ZodString>;
10
- userCategory: z.ZodOptional<z.ZodString>;
11
- sessionId: z.ZodOptional<z.ZodString>;
12
- }, z.core.$strip>>;
8
+ enduserExternalId: z.ZodOptional<z.ZodString>;
13
9
  otel: z.ZodOptional<z.ZodObject<{
14
10
  traceId: z.ZodOptional<z.ZodString>;
15
11
  spanId: z.ZodOptional<z.ZodString>;
@@ -38,6 +34,16 @@ export declare const RunStartedEventSchema: z.ZodObject<{
38
34
  id: z.ZodOptional<z.ZodString>;
39
35
  name: z.ZodOptional<z.ZodString>;
40
36
  }, z.core.$strip>;
37
+ enduser: z.ZodOptional<z.ZodObject<{
38
+ externalId: z.ZodString;
39
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
40
+ name: z.ZodOptional<z.ZodString>;
41
+ group: z.ZodOptional<z.ZodObject<{
42
+ externalId: z.ZodString;
43
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
44
+ name: z.ZodOptional<z.ZodString>;
45
+ }, z.core.$strip>>;
46
+ }, z.core.$strip>>;
41
47
  model: z.ZodOptional<z.ZodObject<{
42
48
  provider: z.ZodOptional<z.ZodString>;
43
49
  name: z.ZodOptional<z.ZodString>;
@@ -57,147 +63,13 @@ export declare const RunStartedEventSchema: z.ZodObject<{
57
63
  }, z.core.$strip>>;
58
64
  }, z.core.$strip>;
59
65
  }, z.core.$strip>;
60
- export declare const HitlMetaSchema: z.ZodObject<{
61
- hitlActionId: z.ZodOptional<z.ZodString>;
62
- fingerprint: z.ZodOptional<z.ZodString>;
63
- status: z.ZodOptional<z.ZodEnum<{
64
- none: "none";
65
- pending: "pending";
66
- approved: "approved";
67
- denied: "denied";
68
- }>>;
69
- }, z.core.$strip>;
70
- export declare const ToolDecisionEventSchema: z.ZodObject<{
71
- schema: z.ZodLiteral<"handlebar.audit.v1">;
72
- ts: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDate>;
73
- runId: z.ZodString;
74
- stepIndex: z.ZodOptional<z.ZodNumber>;
75
- decisionId: z.ZodOptional<z.ZodString>;
76
- user: z.ZodOptional<z.ZodObject<{
77
- userId: z.ZodOptional<z.ZodString>;
78
- userCategory: z.ZodOptional<z.ZodString>;
79
- sessionId: z.ZodOptional<z.ZodString>;
80
- }, z.core.$strip>>;
81
- otel: z.ZodOptional<z.ZodObject<{
82
- traceId: z.ZodOptional<z.ZodString>;
83
- spanId: z.ZodOptional<z.ZodString>;
84
- }, z.core.$strip>>;
85
- sample: z.ZodOptional<z.ZodObject<{
86
- rate: z.ZodOptional<z.ZodNumber>;
87
- reason: z.ZodOptional<z.ZodString>;
88
- }, z.core.$strip>>;
89
- redaction: z.ZodOptional<z.ZodObject<{
90
- level: z.ZodOptional<z.ZodEnum<{
91
- none: "none";
92
- partial: "partial";
93
- strict: "strict";
94
- }>>;
95
- }, z.core.$strip>>;
96
- kind: z.ZodLiteral<"tool.decision">;
97
- data: z.ZodObject<{
98
- effect: z.ZodCustom<import("./governance-actions").GovernanceEffect, import("./governance-actions").GovernanceEffect>;
99
- code: z.ZodCustom<import("./governance-actions").GovernanceCode, import("./governance-actions").GovernanceCode>;
100
- matchedRuleIds: z.ZodArray<z.ZodString>;
101
- appliedActions: z.ZodArray<z.ZodObject<{
102
- type: z.ZodCustom<"allow" | "block" | "hitl" | "notify" | "log", "allow" | "block" | "hitl" | "notify" | "log">;
103
- ruleId: z.ZodString;
104
- }, z.core.$strip>>;
105
- reason: z.ZodOptional<z.ZodString>;
106
- tool: z.ZodObject<{
107
- name: z.ZodString;
108
- categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
109
- }, z.core.$strip>;
110
- args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
111
- argsMeta: z.ZodOptional<z.ZodObject<{
112
- redacted: z.ZodBoolean;
113
- redactedFields: z.ZodOptional<z.ZodArray<z.ZodString>>;
114
- sizeBytesApprox: z.ZodOptional<z.ZodNumber>;
115
- }, z.core.$strip>>;
116
- hitl: z.ZodOptional<z.ZodObject<{
117
- hitlActionId: z.ZodOptional<z.ZodString>;
118
- fingerprint: z.ZodOptional<z.ZodString>;
119
- status: z.ZodOptional<z.ZodEnum<{
120
- none: "none";
121
- pending: "pending";
122
- approved: "approved";
123
- denied: "denied";
124
- }>>;
125
- }, z.core.$strip>>;
126
- counters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
127
- latencyMs: z.ZodOptional<z.ZodNumber>;
128
- }, z.core.$strip>;
129
- }, z.core.$strip>;
130
- export declare const ToolResultEventSchema: z.ZodObject<{
131
- schema: z.ZodLiteral<"handlebar.audit.v1">;
132
- ts: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDate>;
133
- runId: z.ZodString;
134
- stepIndex: z.ZodOptional<z.ZodNumber>;
135
- decisionId: z.ZodOptional<z.ZodString>;
136
- user: z.ZodOptional<z.ZodObject<{
137
- userId: z.ZodOptional<z.ZodString>;
138
- userCategory: z.ZodOptional<z.ZodString>;
139
- sessionId: z.ZodOptional<z.ZodString>;
140
- }, z.core.$strip>>;
141
- otel: z.ZodOptional<z.ZodObject<{
142
- traceId: z.ZodOptional<z.ZodString>;
143
- spanId: z.ZodOptional<z.ZodString>;
144
- }, z.core.$strip>>;
145
- sample: z.ZodOptional<z.ZodObject<{
146
- rate: z.ZodOptional<z.ZodNumber>;
147
- reason: z.ZodOptional<z.ZodString>;
148
- }, z.core.$strip>>;
149
- redaction: z.ZodOptional<z.ZodObject<{
150
- level: z.ZodOptional<z.ZodEnum<{
151
- none: "none";
152
- partial: "partial";
153
- strict: "strict";
154
- }>>;
155
- }, z.core.$strip>>;
156
- kind: z.ZodLiteral<"tool.result">;
157
- data: z.ZodObject<{
158
- tool: z.ZodObject<{
159
- name: z.ZodString;
160
- categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
161
- }, z.core.$strip>;
162
- hitl: z.ZodOptional<z.ZodObject<{
163
- hitlActionId: z.ZodOptional<z.ZodString>;
164
- fingerprint: z.ZodOptional<z.ZodString>;
165
- status: z.ZodOptional<z.ZodEnum<{
166
- none: "none";
167
- pending: "pending";
168
- approved: "approved";
169
- denied: "denied";
170
- }>>;
171
- }, z.core.$strip>>;
172
- outcome: z.ZodEnum<{
173
- success: "success";
174
- error: "error";
175
- }>;
176
- durationMs: z.ZodOptional<z.ZodNumber>;
177
- counters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
178
- error: z.ZodOptional<z.ZodObject<{
179
- name: z.ZodOptional<z.ZodString>;
180
- message: z.ZodOptional<z.ZodString>;
181
- stack: z.ZodOptional<z.ZodString>;
182
- }, z.core.$strip>>;
183
- resultMeta: z.ZodOptional<z.ZodObject<{
184
- redacted: z.ZodBoolean;
185
- redactedFields: z.ZodOptional<z.ZodArray<z.ZodString>>;
186
- sizeBytesApprox: z.ZodOptional<z.ZodNumber>;
187
- }, z.core.$strip>>;
188
- }, z.core.$strip>;
189
- }, z.core.$strip>;
190
66
  export declare const RunEndedEventSchema: z.ZodObject<{
191
67
  schema: z.ZodLiteral<"handlebar.audit.v1">;
192
68
  ts: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDate>;
193
69
  runId: z.ZodString;
194
70
  stepIndex: z.ZodOptional<z.ZodNumber>;
195
71
  decisionId: z.ZodOptional<z.ZodString>;
196
- user: z.ZodOptional<z.ZodObject<{
197
- userId: z.ZodOptional<z.ZodString>;
198
- userCategory: z.ZodOptional<z.ZodString>;
199
- sessionId: z.ZodOptional<z.ZodString>;
200
- }, z.core.$strip>>;
72
+ enduserExternalId: z.ZodOptional<z.ZodString>;
201
73
  otel: z.ZodOptional<z.ZodObject<{
202
74
  traceId: z.ZodOptional<z.ZodString>;
203
75
  spanId: z.ZodOptional<z.ZodString>;
@@ -231,11 +103,7 @@ export declare const ErrorEventSchema: z.ZodObject<{
231
103
  runId: z.ZodString;
232
104
  stepIndex: z.ZodOptional<z.ZodNumber>;
233
105
  decisionId: z.ZodOptional<z.ZodString>;
234
- user: z.ZodOptional<z.ZodObject<{
235
- userId: z.ZodOptional<z.ZodString>;
236
- userCategory: z.ZodOptional<z.ZodString>;
237
- sessionId: z.ZodOptional<z.ZodString>;
238
- }, z.core.$strip>>;
106
+ enduserExternalId: z.ZodOptional<z.ZodString>;
239
107
  otel: z.ZodOptional<z.ZodObject<{
240
108
  traceId: z.ZodOptional<z.ZodString>;
241
109
  spanId: z.ZodOptional<z.ZodString>;
@@ -270,11 +138,7 @@ export declare const AuditEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
270
138
  runId: z.ZodString;
271
139
  stepIndex: z.ZodOptional<z.ZodNumber>;
272
140
  decisionId: z.ZodOptional<z.ZodString>;
273
- user: z.ZodOptional<z.ZodObject<{
274
- userId: z.ZodOptional<z.ZodString>;
275
- userCategory: z.ZodOptional<z.ZodString>;
276
- sessionId: z.ZodOptional<z.ZodString>;
277
- }, z.core.$strip>>;
141
+ enduserExternalId: z.ZodOptional<z.ZodString>;
278
142
  otel: z.ZodOptional<z.ZodObject<{
279
143
  traceId: z.ZodOptional<z.ZodString>;
280
144
  spanId: z.ZodOptional<z.ZodString>;
@@ -303,6 +167,16 @@ export declare const AuditEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
303
167
  id: z.ZodOptional<z.ZodString>;
304
168
  name: z.ZodOptional<z.ZodString>;
305
169
  }, z.core.$strip>;
170
+ enduser: z.ZodOptional<z.ZodObject<{
171
+ externalId: z.ZodString;
172
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
173
+ name: z.ZodOptional<z.ZodString>;
174
+ group: z.ZodOptional<z.ZodObject<{
175
+ externalId: z.ZodString;
176
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
177
+ name: z.ZodOptional<z.ZodString>;
178
+ }, z.core.$strip>>;
179
+ }, z.core.$strip>>;
306
180
  model: z.ZodOptional<z.ZodObject<{
307
181
  provider: z.ZodOptional<z.ZodString>;
308
182
  name: z.ZodOptional<z.ZodString>;
@@ -327,11 +201,7 @@ export declare const AuditEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
327
201
  runId: z.ZodString;
328
202
  stepIndex: z.ZodOptional<z.ZodNumber>;
329
203
  decisionId: z.ZodOptional<z.ZodString>;
330
- user: z.ZodOptional<z.ZodObject<{
331
- userId: z.ZodOptional<z.ZodString>;
332
- userCategory: z.ZodOptional<z.ZodString>;
333
- sessionId: z.ZodOptional<z.ZodString>;
334
- }, z.core.$strip>>;
204
+ enduserExternalId: z.ZodOptional<z.ZodString>;
335
205
  otel: z.ZodOptional<z.ZodObject<{
336
206
  traceId: z.ZodOptional<z.ZodString>;
337
207
  spanId: z.ZodOptional<z.ZodString>;
@@ -377,6 +247,23 @@ export declare const AuditEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
377
247
  denied: "denied";
378
248
  }>>;
379
249
  }, z.core.$strip>>;
250
+ subjects: z.ZodOptional<z.ZodArray<z.ZodObject<{
251
+ subjectType: z.ZodString;
252
+ role: z.ZodOptional<z.ZodString>;
253
+ value: z.ZodString;
254
+ idSystem: z.ZodOptional<z.ZodString>;
255
+ }, z.core.$strip>>>;
256
+ signals: z.ZodOptional<z.ZodArray<z.ZodObject<{
257
+ key: z.ZodString;
258
+ args: z.ZodOptional<z.ZodArray<z.ZodString>>;
259
+ result: z.ZodUnion<readonly [z.ZodObject<{
260
+ ok: z.ZodLiteral<false>;
261
+ error: z.ZodOptional<z.ZodString>;
262
+ }, z.core.$strip>, z.ZodObject<{
263
+ ok: z.ZodLiteral<true>;
264
+ value: z.ZodString;
265
+ }, z.core.$strip>]>;
266
+ }, z.core.$strip>>>;
380
267
  counters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
381
268
  latencyMs: z.ZodOptional<z.ZodNumber>;
382
269
  }, z.core.$strip>;
@@ -386,11 +273,7 @@ export declare const AuditEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
386
273
  runId: z.ZodString;
387
274
  stepIndex: z.ZodOptional<z.ZodNumber>;
388
275
  decisionId: z.ZodOptional<z.ZodString>;
389
- user: z.ZodOptional<z.ZodObject<{
390
- userId: z.ZodOptional<z.ZodString>;
391
- userCategory: z.ZodOptional<z.ZodString>;
392
- sessionId: z.ZodOptional<z.ZodString>;
393
- }, z.core.$strip>>;
276
+ enduserExternalId: z.ZodOptional<z.ZodString>;
394
277
  otel: z.ZodOptional<z.ZodObject<{
395
278
  traceId: z.ZodOptional<z.ZodString>;
396
279
  spanId: z.ZodOptional<z.ZodString>;
@@ -428,6 +311,24 @@ export declare const AuditEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
428
311
  }>;
429
312
  durationMs: z.ZodOptional<z.ZodNumber>;
430
313
  counters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
314
+ metrics: z.ZodOptional<z.ZodObject<{
315
+ inbuilt: z.ZodRecord<z.ZodEnum<{
316
+ bytes_in: "bytes_in";
317
+ bytes_out: "bytes_out";
318
+ duration_ms: "duration_ms";
319
+ records_in: "records_in";
320
+ records_out: "records_out";
321
+ llm_tokens_in: "llm_tokens_in";
322
+ llm_tokens_out: "llm_tokens_out";
323
+ }> & z.core.$partial, z.ZodObject<{
324
+ value: z.ZodNumber;
325
+ unit: z.ZodOptional<z.ZodString>;
326
+ }, z.core.$strip>>;
327
+ custom: z.ZodRecord<z.ZodString, z.ZodObject<{
328
+ value: z.ZodNumber;
329
+ unit: z.ZodOptional<z.ZodString>;
330
+ }, z.core.$strip>>;
331
+ }, z.core.$strip>>;
431
332
  error: z.ZodOptional<z.ZodObject<{
432
333
  name: z.ZodOptional<z.ZodString>;
433
334
  message: z.ZodOptional<z.ZodString>;
@@ -438,6 +339,11 @@ export declare const AuditEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
438
339
  redactedFields: z.ZodOptional<z.ZodArray<z.ZodString>>;
439
340
  sizeBytesApprox: z.ZodOptional<z.ZodNumber>;
440
341
  }, z.core.$strip>>;
342
+ debug: z.ZodOptional<z.ZodObject<{
343
+ approxTokens: z.ZodOptional<z.ZodNumber>;
344
+ chars: z.ZodOptional<z.ZodNumber>;
345
+ bytes: z.ZodOptional<z.ZodNumber>;
346
+ }, z.core.$strip>>;
441
347
  }, z.core.$strip>;
442
348
  }, z.core.$strip>, z.ZodObject<{
443
349
  schema: z.ZodLiteral<"handlebar.audit.v1">;
@@ -445,11 +351,7 @@ export declare const AuditEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
445
351
  runId: z.ZodString;
446
352
  stepIndex: z.ZodOptional<z.ZodNumber>;
447
353
  decisionId: z.ZodOptional<z.ZodString>;
448
- user: z.ZodOptional<z.ZodObject<{
449
- userId: z.ZodOptional<z.ZodString>;
450
- userCategory: z.ZodOptional<z.ZodString>;
451
- sessionId: z.ZodOptional<z.ZodString>;
452
- }, z.core.$strip>>;
354
+ enduserExternalId: z.ZodOptional<z.ZodString>;
453
355
  otel: z.ZodOptional<z.ZodObject<{
454
356
  traceId: z.ZodOptional<z.ZodString>;
455
357
  spanId: z.ZodOptional<z.ZodString>;
@@ -482,11 +384,7 @@ export declare const AuditEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
482
384
  runId: z.ZodString;
483
385
  stepIndex: z.ZodOptional<z.ZodNumber>;
484
386
  decisionId: z.ZodOptional<z.ZodString>;
485
- user: z.ZodOptional<z.ZodObject<{
486
- userId: z.ZodOptional<z.ZodString>;
487
- userCategory: z.ZodOptional<z.ZodString>;
488
- sessionId: z.ZodOptional<z.ZodString>;
489
- }, z.core.$strip>>;
387
+ enduserExternalId: z.ZodOptional<z.ZodString>;
490
388
  otel: z.ZodOptional<z.ZodObject<{
491
389
  traceId: z.ZodOptional<z.ZodString>;
492
390
  spanId: z.ZodOptional<z.ZodString>;
@@ -520,11 +418,7 @@ export declare const AuditEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
520
418
  runId: z.ZodString;
521
419
  stepIndex: z.ZodOptional<z.ZodNumber>;
522
420
  decisionId: z.ZodOptional<z.ZodString>;
523
- user: z.ZodOptional<z.ZodObject<{
524
- userId: z.ZodOptional<z.ZodString>;
525
- userCategory: z.ZodOptional<z.ZodString>;
526
- sessionId: z.ZodOptional<z.ZodString>;
527
- }, z.core.$strip>>;
421
+ enduserExternalId: z.ZodOptional<z.ZodString>;
528
422
  otel: z.ZodOptional<z.ZodObject<{
529
423
  traceId: z.ZodOptional<z.ZodString>;
530
424
  spanId: z.ZodOptional<z.ZodString>;
@@ -541,12 +435,12 @@ export declare const AuditEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
541
435
  }>>;
542
436
  }, z.core.$strip>>;
543
437
  kind: z.ZodLiteral<"message.raw.created">;
544
- data: z.ZodObject<{
438
+ data: z.ZodIntersection<z.ZodObject<{
545
439
  messageId: z.ZodUUID;
546
440
  role: z.ZodEnum<{
547
- user: "user";
548
441
  system: "system";
549
442
  developer: "developer";
443
+ user: "user";
550
444
  assistant: "assistant";
551
445
  tool: "tool";
552
446
  }>;
@@ -565,6 +459,55 @@ export declare const AuditEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
565
459
  turnIndex: z.ZodOptional<z.ZodNumber>;
566
460
  name: z.ZodOptional<z.ZodString>;
567
461
  tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
462
+ }, z.core.$strip>, z.ZodObject<{
463
+ debug: z.ZodOptional<z.ZodObject<{
464
+ approxTokens: z.ZodOptional<z.ZodNumber>;
465
+ chars: z.ZodOptional<z.ZodNumber>;
466
+ }, z.core.$strip>>;
467
+ }, z.core.$strip>>;
468
+ }, z.core.$strip>, z.ZodObject<{
469
+ schema: z.ZodLiteral<"handlebar.audit.v1">;
470
+ ts: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDate>;
471
+ runId: z.ZodString;
472
+ stepIndex: z.ZodOptional<z.ZodNumber>;
473
+ decisionId: z.ZodOptional<z.ZodString>;
474
+ enduserExternalId: z.ZodOptional<z.ZodString>;
475
+ otel: z.ZodOptional<z.ZodObject<{
476
+ traceId: z.ZodOptional<z.ZodString>;
477
+ spanId: z.ZodOptional<z.ZodString>;
478
+ }, z.core.$strip>>;
479
+ sample: z.ZodOptional<z.ZodObject<{
480
+ rate: z.ZodOptional<z.ZodNumber>;
481
+ reason: z.ZodOptional<z.ZodString>;
482
+ }, z.core.$strip>>;
483
+ redaction: z.ZodOptional<z.ZodObject<{
484
+ level: z.ZodOptional<z.ZodEnum<{
485
+ none: "none";
486
+ partial: "partial";
487
+ strict: "strict";
488
+ }>>;
489
+ }, z.core.$strip>>;
490
+ kind: z.ZodLiteral<"llm.result">;
491
+ data: z.ZodObject<{
492
+ model: z.ZodObject<{
493
+ model: z.ZodString;
494
+ provider: z.ZodOptional<z.ZodString>;
495
+ }, z.core.$strip>;
496
+ tokens: z.ZodObject<{
497
+ in: z.ZodNumber;
498
+ out: z.ZodNumber;
499
+ }, z.core.$strip>;
500
+ debug: z.ZodOptional<z.ZodObject<{
501
+ inTokenAttribution: z.ZodRecord<z.ZodEnum<{
502
+ system: "system";
503
+ developer: "developer";
504
+ user: "user";
505
+ assistant: "assistant";
506
+ tool: "tool";
507
+ }> & z.core.$partial, z.ZodNumber>;
508
+ }, z.core.$strip>>;
509
+ messageCount: z.ZodNumber;
510
+ durationMs: z.ZodOptional<z.ZodNumber>;
568
511
  }, z.core.$strip>;
569
512
  }, z.core.$strip>], "kind">;
570
513
  export type AuditEvent = z.infer<typeof AuditEventSchema>;
@@ -1,8 +1,8 @@
1
1
  import { z } from "zod";
2
2
  export declare const MessageRoleSchema: z.ZodEnum<{
3
- user: "user";
4
3
  system: "system";
5
4
  developer: "developer";
5
+ user: "user";
6
6
  assistant: "assistant";
7
7
  tool: "tool";
8
8
  }>;
@@ -29,9 +29,9 @@ export declare const MessageKindSchema: z.ZodEnum<{
29
29
  export declare const MessageSchema: z.ZodObject<{
30
30
  messageId: z.ZodUUID;
31
31
  role: z.ZodEnum<{
32
- user: "user";
33
32
  system: "system";
34
33
  developer: "developer";
34
+ user: "user";
35
35
  assistant: "assistant";
36
36
  tool: "tool";
37
37
  }>;
@@ -57,11 +57,7 @@ export declare const MessageEventSchema: z.ZodObject<{
57
57
  runId: z.ZodString;
58
58
  stepIndex: z.ZodOptional<z.ZodNumber>;
59
59
  decisionId: z.ZodOptional<z.ZodString>;
60
- user: z.ZodOptional<z.ZodObject<{
61
- userId: z.ZodOptional<z.ZodString>;
62
- userCategory: z.ZodOptional<z.ZodString>;
63
- sessionId: z.ZodOptional<z.ZodString>;
64
- }, z.core.$strip>>;
60
+ enduserExternalId: z.ZodOptional<z.ZodString>;
65
61
  otel: z.ZodOptional<z.ZodObject<{
66
62
  traceId: z.ZodOptional<z.ZodString>;
67
63
  spanId: z.ZodOptional<z.ZodString>;
@@ -78,12 +74,12 @@ export declare const MessageEventSchema: z.ZodObject<{
78
74
  }>>;
79
75
  }, z.core.$strip>>;
80
76
  kind: z.ZodLiteral<"message.raw.created">;
81
- data: z.ZodObject<{
77
+ data: z.ZodIntersection<z.ZodObject<{
82
78
  messageId: z.ZodUUID;
83
79
  role: z.ZodEnum<{
84
- user: "user";
85
80
  system: "system";
86
81
  developer: "developer";
82
+ user: "user";
87
83
  assistant: "assistant";
88
84
  tool: "tool";
89
85
  }>;
@@ -102,5 +98,55 @@ export declare const MessageEventSchema: z.ZodObject<{
102
98
  turnIndex: z.ZodOptional<z.ZodNumber>;
103
99
  name: z.ZodOptional<z.ZodString>;
104
100
  tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
101
+ }, z.core.$strip>, z.ZodObject<{
102
+ debug: z.ZodOptional<z.ZodObject<{
103
+ approxTokens: z.ZodOptional<z.ZodNumber>;
104
+ chars: z.ZodOptional<z.ZodNumber>;
105
+ }, z.core.$strip>>;
106
+ }, z.core.$strip>>;
107
+ }, z.core.$strip>;
108
+ export declare const LLMResultEventSchema: z.ZodObject<{
109
+ schema: z.ZodLiteral<"handlebar.audit.v1">;
110
+ ts: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDate>;
111
+ runId: z.ZodString;
112
+ stepIndex: z.ZodOptional<z.ZodNumber>;
113
+ decisionId: z.ZodOptional<z.ZodString>;
114
+ enduserExternalId: z.ZodOptional<z.ZodString>;
115
+ otel: z.ZodOptional<z.ZodObject<{
116
+ traceId: z.ZodOptional<z.ZodString>;
117
+ spanId: z.ZodOptional<z.ZodString>;
118
+ }, z.core.$strip>>;
119
+ sample: z.ZodOptional<z.ZodObject<{
120
+ rate: z.ZodOptional<z.ZodNumber>;
121
+ reason: z.ZodOptional<z.ZodString>;
122
+ }, z.core.$strip>>;
123
+ redaction: z.ZodOptional<z.ZodObject<{
124
+ level: z.ZodOptional<z.ZodEnum<{
125
+ none: "none";
126
+ partial: "partial";
127
+ strict: "strict";
128
+ }>>;
129
+ }, z.core.$strip>>;
130
+ kind: z.ZodLiteral<"llm.result">;
131
+ data: z.ZodObject<{
132
+ model: z.ZodObject<{
133
+ model: z.ZodString;
134
+ provider: z.ZodOptional<z.ZodString>;
135
+ }, z.core.$strip>;
136
+ tokens: z.ZodObject<{
137
+ in: z.ZodNumber;
138
+ out: z.ZodNumber;
139
+ }, z.core.$strip>;
140
+ debug: z.ZodOptional<z.ZodObject<{
141
+ inTokenAttribution: z.ZodRecord<z.ZodEnum<{
142
+ system: "system";
143
+ developer: "developer";
144
+ user: "user";
145
+ assistant: "assistant";
146
+ tool: "tool";
147
+ }> & z.core.$partial, z.ZodNumber>;
148
+ }, z.core.$strip>>;
149
+ messageCount: z.ZodNumber;
150
+ durationMs: z.ZodOptional<z.ZodNumber>;
105
151
  }, z.core.$strip>;
106
152
  }, z.core.$strip>;