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

package/README.md

@@ -2,30 +2,12 @@
 
 Schemas and types for [Handlebar] rules.
 
-_Note: This package in early development and the interface is subject to change._
-
-## Roadmap
-
-Handlebar is in early development. We have a lot of functionality planned,
-but need your feedback on what you need to help you build better agents.
-
-- Refer to the [roadmap][root_roadmap] to see what we're cooking.
-- Please feel free to [open an issue](https://github.com/gethandlebar/handlebar-js/issues/new) if you have any feedback or suggestions
-- or [join our Discord][discord_invite] to talk to us directly
-
-See [contributing][root_contributing] for more ways to get in touch and help.
-
 ## Getting started
 
 This package should be used alongside a framework-specific Handlebar SDK,
 such as [ai-sdk-v5](https://github.com/gethandlebar/handlebar-js/blob/main/packages/ai-sdk-v5/).
 Refer to that package's README for more information.
 
-Please refer to [`./examples/`][examples] for a runable demo of [Handlebar]
-applied to an ai sdk agent.
-
-**N.b. Our developer docs are incoming.**
-
 ## Contributing
 
 We welcome contributions from the community: bug reports, feedback, feature requests
@@ -35,10 +17,8 @@ and guidelines.
 
 ## About Handlebar
 
-Find out more at https://gethandlebar.com
+Find out more at [https://gethandlebar.com][handlebar]
 
 [handlebar]: https://gethandlebar.com
-[root_roadmap]: https://github.com/gethandlebar/handlebar-js/blob/main/ROADMAP.md
 [root_contributing]: https://github.com/gethandlebar/handlebar-js/blob/main/CONTRIBUTING.md
-[examples]: https://github.com/gethandlebar/handlebar-js/blob/main/examples/ai-sdk-v5/
 [discord_invite]: https://discord.gg/Q6xwvccg

package/dist/audit/events.base.d.ts

@@ -5,11 +5,7 @@ export declare const AuditEnvelopeSchema: z.ZodObject<{
     runId: z.ZodString;
     stepIndex: z.ZodOptional<z.ZodNumber>;
     decisionId: z.ZodOptional<z.ZodString>;
-    user: z.ZodOptional<z.ZodObject<{
-        userId: z.ZodOptional<z.ZodString>;
-        userCategory: z.ZodOptional<z.ZodString>;
-        sessionId: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
+    enduserExternalId: z.ZodOptional<z.ZodString>;
     otel: z.ZodOptional<z.ZodObject<{
         traceId: z.ZodOptional<z.ZodString>;
         spanId: z.ZodOptional<z.ZodString>;

package/dist/audit/events.d.ts

@@ -5,11 +5,7 @@ export declare const RunStartedEventSchema: z.ZodObject<{
     runId: z.ZodString;
     stepIndex: z.ZodOptional<z.ZodNumber>;
     decisionId: z.ZodOptional<z.ZodString>;
-    user: z.ZodOptional<z.ZodObject<{
-        userId: z.ZodOptional<z.ZodString>;
-        userCategory: z.ZodOptional<z.ZodString>;
-        sessionId: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
+    enduserExternalId: z.ZodOptional<z.ZodString>;
     otel: z.ZodOptional<z.ZodObject<{
         traceId: z.ZodOptional<z.ZodString>;
         spanId: z.ZodOptional<z.ZodString>;
@@ -40,11 +36,11 @@ export declare const RunStartedEventSchema: z.ZodObject<{
         }, z.core.$strip>;
         enduser: z.ZodOptional<z.ZodObject<{
             externalId: z.ZodString;
-            metadata: z.ZodRecord<z.ZodString, z.ZodString>;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
             name: z.ZodOptional<z.ZodString>;
             group: z.ZodOptional<z.ZodObject<{
                 externalId: z.ZodString;
-                metadata: z.ZodRecord<z.ZodString, z.ZodString>;
+                metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
                 name: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>;
         }, z.core.$strip>>;
@@ -67,147 +63,13 @@ export declare const RunStartedEventSchema: z.ZodObject<{
         }, z.core.$strip>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
-export declare const HitlMetaSchema: z.ZodObject<{
-    hitlActionId: z.ZodOptional<z.ZodString>;
-    fingerprint: z.ZodOptional<z.ZodString>;
-    status: z.ZodOptional<z.ZodEnum<{
-        none: "none";
-        pending: "pending";
-        approved: "approved";
-        denied: "denied";
-    }>>;
-}, z.core.$strip>;
-export declare const ToolDecisionEventSchema: z.ZodObject<{
-    schema: z.ZodLiteral<"handlebar.audit.v1">;
-    ts: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDate>;
-    runId: z.ZodString;
-    stepIndex: z.ZodOptional<z.ZodNumber>;
-    decisionId: z.ZodOptional<z.ZodString>;
-    user: z.ZodOptional<z.ZodObject<{
-        userId: z.ZodOptional<z.ZodString>;
-        userCategory: z.ZodOptional<z.ZodString>;
-        sessionId: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
-    otel: z.ZodOptional<z.ZodObject<{
-        traceId: z.ZodOptional<z.ZodString>;
-        spanId: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
-    sample: z.ZodOptional<z.ZodObject<{
-        rate: z.ZodOptional<z.ZodNumber>;
-        reason: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
-    redaction: z.ZodOptional<z.ZodObject<{
-        level: z.ZodOptional<z.ZodEnum<{
-            none: "none";
-            partial: "partial";
-            strict: "strict";
-        }>>;
-    }, z.core.$strip>>;
-    kind: z.ZodLiteral<"tool.decision">;
-    data: z.ZodObject<{
-        effect: z.ZodCustom<import("./governance-actions").GovernanceEffect, import("./governance-actions").GovernanceEffect>;
-        code: z.ZodCustom<import("./governance-actions").GovernanceCode, import("./governance-actions").GovernanceCode>;
-        matchedRuleIds: z.ZodArray<z.ZodString>;
-        appliedActions: z.ZodArray<z.ZodObject<{
-            type: z.ZodCustom<"allow" | "block" | "hitl" | "notify" | "log", "allow" | "block" | "hitl" | "notify" | "log">;
-            ruleId: z.ZodString;
-        }, z.core.$strip>>;
-        reason: z.ZodOptional<z.ZodString>;
-        tool: z.ZodObject<{
-            name: z.ZodString;
-            categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        }, z.core.$strip>;
-        args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        argsMeta: z.ZodOptional<z.ZodObject<{
-            redacted: z.ZodBoolean;
-            redactedFields: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            sizeBytesApprox: z.ZodOptional<z.ZodNumber>;
-        }, z.core.$strip>>;
-        hitl: z.ZodOptional<z.ZodObject<{
-            hitlActionId: z.ZodOptional<z.ZodString>;
-            fingerprint: z.ZodOptional<z.ZodString>;
-            status: z.ZodOptional<z.ZodEnum<{
-                none: "none";
-                pending: "pending";
-                approved: "approved";
-                denied: "denied";
-            }>>;
-        }, z.core.$strip>>;
-        counters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
-        latencyMs: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>;
-}, z.core.$strip>;
-export declare const ToolResultEventSchema: z.ZodObject<{
-    schema: z.ZodLiteral<"handlebar.audit.v1">;
-    ts: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDate>;
-    runId: z.ZodString;
-    stepIndex: z.ZodOptional<z.ZodNumber>;
-    decisionId: z.ZodOptional<z.ZodString>;
-    user: z.ZodOptional<z.ZodObject<{
-        userId: z.ZodOptional<z.ZodString>;
-        userCategory: z.ZodOptional<z.ZodString>;
-        sessionId: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
-    otel: z.ZodOptional<z.ZodObject<{
-        traceId: z.ZodOptional<z.ZodString>;
-        spanId: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
-    sample: z.ZodOptional<z.ZodObject<{
-        rate: z.ZodOptional<z.ZodNumber>;
-        reason: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
-    redaction: z.ZodOptional<z.ZodObject<{
-        level: z.ZodOptional<z.ZodEnum<{
-            none: "none";
-            partial: "partial";
-            strict: "strict";
-        }>>;
-    }, z.core.$strip>>;
-    kind: z.ZodLiteral<"tool.result">;
-    data: z.ZodObject<{
-        tool: z.ZodObject<{
-            name: z.ZodString;
-            categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        }, z.core.$strip>;
-        hitl: z.ZodOptional<z.ZodObject<{
-            hitlActionId: z.ZodOptional<z.ZodString>;
-            fingerprint: z.ZodOptional<z.ZodString>;
-            status: z.ZodOptional<z.ZodEnum<{
-                none: "none";
-                pending: "pending";
-                approved: "approved";
-                denied: "denied";
-            }>>;
-        }, z.core.$strip>>;
-        outcome: z.ZodEnum<{
-            success: "success";
-            error: "error";
-        }>;
-        durationMs: z.ZodOptional<z.ZodNumber>;
-        counters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
-        error: z.ZodOptional<z.ZodObject<{
-            name: z.ZodOptional<z.ZodString>;
-            message: z.ZodOptional<z.ZodString>;
-            stack: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>>;
-        resultMeta: z.ZodOptional<z.ZodObject<{
-            redacted: z.ZodBoolean;
-            redactedFields: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            sizeBytesApprox: z.ZodOptional<z.ZodNumber>;
-        }, z.core.$strip>>;
-    }, z.core.$strip>;
-}, z.core.$strip>;
 export declare const RunEndedEventSchema: z.ZodObject<{
     schema: z.ZodLiteral<"handlebar.audit.v1">;
     ts: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDate>;
     runId: z.ZodString;
     stepIndex: z.ZodOptional<z.ZodNumber>;
     decisionId: z.ZodOptional<z.ZodString>;
-    user: z.ZodOptional<z.ZodObject<{
-        userId: z.ZodOptional<z.ZodString>;
-        userCategory: z.ZodOptional<z.ZodString>;
-        sessionId: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
+    enduserExternalId: z.ZodOptional<z.ZodString>;
     otel: z.ZodOptional<z.ZodObject<{
         traceId: z.ZodOptional<z.ZodString>;
         spanId: z.ZodOptional<z.ZodString>;
@@ -241,11 +103,7 @@ export declare const ErrorEventSchema: z.ZodObject<{
     runId: z.ZodString;
     stepIndex: z.ZodOptional<z.ZodNumber>;
     decisionId: z.ZodOptional<z.ZodString>;
-    user: z.ZodOptional<z.ZodObject<{
-        userId: z.ZodOptional<z.ZodString>;
-        userCategory: z.ZodOptional<z.ZodString>;
-        sessionId: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
+    enduserExternalId: z.ZodOptional<z.ZodString>;
     otel: z.ZodOptional<z.ZodObject<{
         traceId: z.ZodOptional<z.ZodString>;
         spanId: z.ZodOptional<z.ZodString>;
@@ -280,11 +138,7 @@ export declare const AuditEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     runId: z.ZodString;
     stepIndex: z.ZodOptional<z.ZodNumber>;
     decisionId: z.ZodOptional<z.ZodString>;
-    user: z.ZodOptional<z.ZodObject<{
-        userId: z.ZodOptional<z.ZodString>;
-        userCategory: z.ZodOptional<z.ZodString>;
-        sessionId: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
+    enduserExternalId: z.ZodOptional<z.ZodString>;
     otel: z.ZodOptional<z.ZodObject<{
         traceId: z.ZodOptional<z.ZodString>;
         spanId: z.ZodOptional<z.ZodString>;
@@ -315,11 +169,11 @@ export declare const AuditEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         }, z.core.$strip>;
         enduser: z.ZodOptional<z.ZodObject<{
             externalId: z.ZodString;
-            metadata: z.ZodRecord<z.ZodString, z.ZodString>;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
             name: z.ZodOptional<z.ZodString>;
             group: z.ZodOptional<z.ZodObject<{
                 externalId: z.ZodString;
-                metadata: z.ZodRecord<z.ZodString, z.ZodString>;
+                metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
                 name: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>;
         }, z.core.$strip>>;
@@ -347,11 +201,7 @@ export declare const AuditEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     runId: z.ZodString;
     stepIndex: z.ZodOptional<z.ZodNumber>;
     decisionId: z.ZodOptional<z.ZodString>;
-    user: z.ZodOptional<z.ZodObject<{
-        userId: z.ZodOptional<z.ZodString>;
-        userCategory: z.ZodOptional<z.ZodString>;
-        sessionId: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
+    enduserExternalId: z.ZodOptional<z.ZodString>;
     otel: z.ZodOptional<z.ZodObject<{
         traceId: z.ZodOptional<z.ZodString>;
         spanId: z.ZodOptional<z.ZodString>;
@@ -397,6 +247,23 @@ export declare const AuditEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 denied: "denied";
             }>>;
         }, z.core.$strip>>;
+        subjects: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            subjectType: z.ZodString;
+            role: z.ZodOptional<z.ZodString>;
+            value: z.ZodString;
+            idSystem: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        signals: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            result: z.ZodUnion<readonly [z.ZodObject<{
+                ok: z.ZodLiteral<false>;
+                error: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                ok: z.ZodLiteral<true>;
+                value: z.ZodString;
+            }, z.core.$strip>]>;
+        }, z.core.$strip>>>;
         counters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
         latencyMs: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
@@ -406,11 +273,7 @@ export declare const AuditEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     runId: z.ZodString;
     stepIndex: z.ZodOptional<z.ZodNumber>;
     decisionId: z.ZodOptional<z.ZodString>;
-    user: z.ZodOptional<z.ZodObject<{
-        userId: z.ZodOptional<z.ZodString>;
-        userCategory: z.ZodOptional<z.ZodString>;
-        sessionId: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
+    enduserExternalId: z.ZodOptional<z.ZodString>;
     otel: z.ZodOptional<z.ZodObject<{
         traceId: z.ZodOptional<z.ZodString>;
         spanId: z.ZodOptional<z.ZodString>;
@@ -448,6 +311,24 @@ export declare const AuditEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         }>;
         durationMs: z.ZodOptional<z.ZodNumber>;
         counters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+        metrics: z.ZodOptional<z.ZodObject<{
+            inbuilt: z.ZodRecord<z.ZodEnum<{
+                bytes_in: "bytes_in";
+                bytes_out: "bytes_out";
+                duration_ms: "duration_ms";
+                records_in: "records_in";
+                records_out: "records_out";
+                llm_tokens_in: "llm_tokens_in";
+                llm_tokens_out: "llm_tokens_out";
+            }> & z.core.$partial, z.ZodObject<{
+                value: z.ZodNumber;
+                unit: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            custom: z.ZodRecord<z.ZodString, z.ZodObject<{
+                value: z.ZodNumber;
+                unit: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
         error: z.ZodOptional<z.ZodObject<{
             name: z.ZodOptional<z.ZodString>;
             message: z.ZodOptional<z.ZodString>;
@@ -458,6 +339,11 @@ export declare const AuditEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             redactedFields: z.ZodOptional<z.ZodArray<z.ZodString>>;
             sizeBytesApprox: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
+        debug: z.ZodOptional<z.ZodObject<{
+            approxTokens: z.ZodOptional<z.ZodNumber>;
+            chars: z.ZodOptional<z.ZodNumber>;
+            bytes: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
     }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
     schema: z.ZodLiteral<"handlebar.audit.v1">;
@@ -465,11 +351,7 @@ export declare const AuditEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     runId: z.ZodString;
     stepIndex: z.ZodOptional<z.ZodNumber>;
     decisionId: z.ZodOptional<z.ZodString>;
-    user: z.ZodOptional<z.ZodObject<{
-        userId: z.ZodOptional<z.ZodString>;
-        userCategory: z.ZodOptional<z.ZodString>;
-        sessionId: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
+    enduserExternalId: z.ZodOptional<z.ZodString>;
     otel: z.ZodOptional<z.ZodObject<{
         traceId: z.ZodOptional<z.ZodString>;
         spanId: z.ZodOptional<z.ZodString>;
@@ -502,11 +384,7 @@ export declare const AuditEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     runId: z.ZodString;
     stepIndex: z.ZodOptional<z.ZodNumber>;
     decisionId: z.ZodOptional<z.ZodString>;
-    user: z.ZodOptional<z.ZodObject<{
-        userId: z.ZodOptional<z.ZodString>;
-        userCategory: z.ZodOptional<z.ZodString>;
-        sessionId: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
+    enduserExternalId: z.ZodOptional<z.ZodString>;
     otel: z.ZodOptional<z.ZodObject<{
         traceId: z.ZodOptional<z.ZodString>;
         spanId: z.ZodOptional<z.ZodString>;
@@ -540,11 +418,7 @@ export declare const AuditEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     runId: z.ZodString;
     stepIndex: z.ZodOptional<z.ZodNumber>;
     decisionId: z.ZodOptional<z.ZodString>;
-    user: z.ZodOptional<z.ZodObject<{
-        userId: z.ZodOptional<z.ZodString>;
-        userCategory: z.ZodOptional<z.ZodString>;
-        sessionId: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
+    enduserExternalId: z.ZodOptional<z.ZodString>;
     otel: z.ZodOptional<z.ZodObject<{
         traceId: z.ZodOptional<z.ZodString>;
         spanId: z.ZodOptional<z.ZodString>;
@@ -561,18 +435,18 @@ export declare const AuditEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         }>>;
     }, z.core.$strip>>;
     kind: z.ZodLiteral<"message.raw.created">;
-    data: z.ZodObject<{
+    data: z.ZodIntersection<z.ZodObject<{
         messageId: z.ZodUUID;
         role: z.ZodEnum<{
-            user: "user";
             system: "system";
             developer: "developer";
+            user: "user";
             assistant: "assistant";
             tool: "tool";
         }>;
         kind: z.ZodEnum<{
-            output: "output";
             input: "input";
+            output: "output";
             tool_call: "tool_call";
             tool_result: "tool_result";
             observation: "observation";
@@ -585,6 +459,55 @@ export declare const AuditEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         turnIndex: z.ZodOptional<z.ZodNumber>;
         name: z.ZodOptional<z.ZodString>;
         tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>, z.ZodObject<{
+        debug: z.ZodOptional<z.ZodObject<{
+            approxTokens: z.ZodOptional<z.ZodNumber>;
+            chars: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    schema: z.ZodLiteral<"handlebar.audit.v1">;
+    ts: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDate>;
+    runId: z.ZodString;
+    stepIndex: z.ZodOptional<z.ZodNumber>;
+    decisionId: z.ZodOptional<z.ZodString>;
+    enduserExternalId: z.ZodOptional<z.ZodString>;
+    otel: z.ZodOptional<z.ZodObject<{
+        traceId: z.ZodOptional<z.ZodString>;
+        spanId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    sample: z.ZodOptional<z.ZodObject<{
+        rate: z.ZodOptional<z.ZodNumber>;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    redaction: z.ZodOptional<z.ZodObject<{
+        level: z.ZodOptional<z.ZodEnum<{
+            none: "none";
+            partial: "partial";
+            strict: "strict";
+        }>>;
+    }, z.core.$strip>>;
+    kind: z.ZodLiteral<"llm.result">;
+    data: z.ZodObject<{
+        model: z.ZodObject<{
+            model: z.ZodString;
+            provider: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        tokens: z.ZodObject<{
+            in: z.ZodNumber;
+            out: z.ZodNumber;
+        }, z.core.$strip>;
+        debug: z.ZodOptional<z.ZodObject<{
+            inTokenAttribution: z.ZodRecord<z.ZodEnum<{
+                system: "system";
+                developer: "developer";
+                user: "user";
+                assistant: "assistant";
+                tool: "tool";
+            }> & z.core.$partial, z.ZodNumber>;
+        }, z.core.$strip>>;
+        messageCount: z.ZodNumber;
+        durationMs: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
 }, z.core.$strip>], "kind">;
 export type AuditEvent = z.infer<typeof AuditEventSchema>;

package/dist/audit/events.llm.d.ts

@@ -1,8 +1,8 @@
 import { z } from "zod";
 export declare const MessageRoleSchema: z.ZodEnum<{
-    user: "user";
     system: "system";
     developer: "developer";
+    user: "user";
     assistant: "assistant";
     tool: "tool";
 }>;
@@ -18,8 +18,8 @@ export declare const MessageRoleSchema: z.ZodEnum<{
  *
  */
 export declare const MessageKindSchema: z.ZodEnum<{
-    output: "output";
     input: "input";
+    output: "output";
     tool_call: "tool_call";
     tool_result: "tool_result";
     observation: "observation";
@@ -29,15 +29,15 @@ export declare const MessageKindSchema: z.ZodEnum<{
 export declare const MessageSchema: z.ZodObject<{
     messageId: z.ZodUUID;
     role: z.ZodEnum<{
-        user: "user";
         system: "system";
         developer: "developer";
+        user: "user";
         assistant: "assistant";
         tool: "tool";
     }>;
     kind: z.ZodEnum<{
-        output: "output";
         input: "input";
+        output: "output";
         tool_call: "tool_call";
         tool_result: "tool_result";
         observation: "observation";
@@ -57,11 +57,7 @@ export declare const MessageEventSchema: z.ZodObject<{
     runId: z.ZodString;
     stepIndex: z.ZodOptional<z.ZodNumber>;
     decisionId: z.ZodOptional<z.ZodString>;
-    user: z.ZodOptional<z.ZodObject<{
-        userId: z.ZodOptional<z.ZodString>;
-        userCategory: z.ZodOptional<z.ZodString>;
-        sessionId: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
+    enduserExternalId: z.ZodOptional<z.ZodString>;
     otel: z.ZodOptional<z.ZodObject<{
         traceId: z.ZodOptional<z.ZodString>;
         spanId: z.ZodOptional<z.ZodString>;
@@ -78,18 +74,18 @@ export declare const MessageEventSchema: z.ZodObject<{
         }>>;
     }, z.core.$strip>>;
     kind: z.ZodLiteral<"message.raw.created">;
-    data: z.ZodObject<{
+    data: z.ZodIntersection<z.ZodObject<{
         messageId: z.ZodUUID;
         role: z.ZodEnum<{
-            user: "user";
             system: "system";
             developer: "developer";
+            user: "user";
             assistant: "assistant";
             tool: "tool";
         }>;
         kind: z.ZodEnum<{
-            output: "output";
             input: "input";
+            output: "output";
             tool_call: "tool_call";
             tool_result: "tool_result";
             observation: "observation";
@@ -102,5 +98,55 @@ export declare const MessageEventSchema: z.ZodObject<{
         turnIndex: z.ZodOptional<z.ZodNumber>;
         name: z.ZodOptional<z.ZodString>;
         tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>, z.ZodObject<{
+        debug: z.ZodOptional<z.ZodObject<{
+            approxTokens: z.ZodOptional<z.ZodNumber>;
+            chars: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const LLMResultEventSchema: z.ZodObject<{
+    schema: z.ZodLiteral<"handlebar.audit.v1">;
+    ts: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDate>;
+    runId: z.ZodString;
+    stepIndex: z.ZodOptional<z.ZodNumber>;
+    decisionId: z.ZodOptional<z.ZodString>;
+    enduserExternalId: z.ZodOptional<z.ZodString>;
+    otel: z.ZodOptional<z.ZodObject<{
+        traceId: z.ZodOptional<z.ZodString>;
+        spanId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    sample: z.ZodOptional<z.ZodObject<{
+        rate: z.ZodOptional<z.ZodNumber>;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    redaction: z.ZodOptional<z.ZodObject<{
+        level: z.ZodOptional<z.ZodEnum<{
+            none: "none";
+            partial: "partial";
+            strict: "strict";
+        }>>;
+    }, z.core.$strip>>;
+    kind: z.ZodLiteral<"llm.result">;
+    data: z.ZodObject<{
+        model: z.ZodObject<{
+            model: z.ZodString;
+            provider: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        tokens: z.ZodObject<{
+            in: z.ZodNumber;
+            out: z.ZodNumber;
+        }, z.core.$strip>;
+        debug: z.ZodOptional<z.ZodObject<{
+            inTokenAttribution: z.ZodRecord<z.ZodEnum<{
+                system: "system";
+                developer: "developer";
+                user: "user";
+                assistant: "assistant";
+                tool: "tool";
+            }> & z.core.$partial, z.ZodNumber>;
+        }, z.core.$strip>>;
+        messageCount: z.ZodNumber;
+        durationMs: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
 }, z.core.$strip>;