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

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

@@ -0,0 +1,28 @@
+import { z } from "zod";
+export declare const AuditEnvelopeSchema: 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>>;
+}, z.core.$strip>;

package/dist/audit/events.d.ts

@@ -1,31 +1,4 @@
 import { z } from "zod";
-export declare const AuditEnvelopeSchema: 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>>;
-}, z.core.$strip>;
 export declare const RunStartedEventSchema: z.ZodObject<{
     schema: z.ZodLiteral<"handlebar.audit.v1">;
     ts: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDate>;
@@ -65,6 +38,16 @@ export declare const RunStartedEventSchema: z.ZodObject<{
             id: z.ZodOptional<z.ZodString>;
             name: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>;
+        enduser: z.ZodOptional<z.ZodObject<{
+            externalId: z.ZodString;
+            metadata: 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>;
+                name: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
         model: z.ZodOptional<z.ZodObject<{
             provider: z.ZodOptional<z.ZodString>;
             name: z.ZodOptional<z.ZodString>;
@@ -330,6 +313,16 @@ export declare const AuditEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             id: z.ZodOptional<z.ZodString>;
             name: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>;
+        enduser: z.ZodOptional<z.ZodObject<{
+            externalId: z.ZodString;
+            metadata: 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>;
+                name: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
         model: z.ZodOptional<z.ZodObject<{
             provider: z.ZodOptional<z.ZodString>;
             name: z.ZodOptional<z.ZodString>;
@@ -541,6 +534,58 @@ export declare const AuditEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         fatal: z.ZodOptional<z.ZodBoolean>;
     }, 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>;
+    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<"message.raw.created">;
+    data: z.ZodObject<{
+        messageId: z.ZodUUID;
+        role: z.ZodEnum<{
+            user: "user";
+            system: "system";
+            developer: "developer";
+            assistant: "assistant";
+            tool: "tool";
+        }>;
+        kind: z.ZodEnum<{
+            output: "output";
+            input: "input";
+            tool_call: "tool_call";
+            tool_result: "tool_result";
+            observation: "observation";
+            internal_summary: "internal_summary";
+            thinking: "thinking";
+        }>;
+        content: z.ZodString;
+        contentTruncated: z.ZodBoolean;
+        parentMessageId: z.ZodOptional<z.ZodUUID>;
+        turnIndex: z.ZodOptional<z.ZodNumber>;
+        name: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
 }, z.core.$strip>], "kind">;
 export type AuditEvent = z.infer<typeof AuditEventSchema>;
 export type AuditEventByKind = {

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

@@ -0,0 +1,106 @@
+import { z } from "zod";
+export declare const MessageRoleSchema: z.ZodEnum<{
+    user: "user";
+    system: "system";
+    developer: "developer";
+    assistant: "assistant";
+    tool: "tool";
+}>;
+/**
+ * Message "kind" is about how it appears in an agent flow.
+ * - input: user message
+ * - output: assistant natural language output
+ * - tool_call: assistant initiated tool call (as text/JSON tool call)
+ * - tool_result: tool return value summarised or raw ref
+ * - observation: agent framework observation (non-tool, e.g. environment signal)
+ * - internal_summary: optional short summary generated for UI
+ * - thinking: model CoT
+ *
+ */
+export declare const MessageKindSchema: z.ZodEnum<{
+    output: "output";
+    input: "input";
+    tool_call: "tool_call";
+    tool_result: "tool_result";
+    observation: "observation";
+    internal_summary: "internal_summary";
+    thinking: "thinking";
+}>;
+export declare const MessageSchema: z.ZodObject<{
+    messageId: z.ZodUUID;
+    role: z.ZodEnum<{
+        user: "user";
+        system: "system";
+        developer: "developer";
+        assistant: "assistant";
+        tool: "tool";
+    }>;
+    kind: z.ZodEnum<{
+        output: "output";
+        input: "input";
+        tool_call: "tool_call";
+        tool_result: "tool_result";
+        observation: "observation";
+        internal_summary: "internal_summary";
+        thinking: "thinking";
+    }>;
+    content: z.ZodString;
+    contentTruncated: z.ZodBoolean;
+    parentMessageId: z.ZodOptional<z.ZodUUID>;
+    turnIndex: z.ZodOptional<z.ZodNumber>;
+    name: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const MessageEventSchema: 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<"message.raw.created">;
+    data: z.ZodObject<{
+        messageId: z.ZodUUID;
+        role: z.ZodEnum<{
+            user: "user";
+            system: "system";
+            developer: "developer";
+            assistant: "assistant";
+            tool: "tool";
+        }>;
+        kind: z.ZodEnum<{
+            output: "output";
+            input: "input";
+            tool_call: "tool_call";
+            tool_result: "tool_result";
+            observation: "observation";
+            internal_summary: "internal_summary";
+            thinking: "thinking";
+        }>;
+        content: z.ZodString;
+        contentTruncated: z.ZodBoolean;
+        parentMessageId: z.ZodOptional<z.ZodUUID>;
+        turnIndex: z.ZodOptional<z.ZodNumber>;
+        name: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;

package/dist/audit/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./events";
+export * from "./events.base";
+export * from "./events.llm";
+export * from "./governance-actions";

package/dist/enduser.types.d.ts

@@ -0,0 +1,13 @@
+import { z } from "zod";
+export declare const EndUserConfigSchema: z.ZodObject<{
+    externalId: z.ZodString;
+    metadata: z.ZodRecord<z.ZodString, z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const EndUserGroupConfigSchema: z.ZodObject<{
+    externalId: z.ZodString;
+    metadata: z.ZodRecord<z.ZodString, z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type EndUserConfig = z.infer<typeof EndUserConfigSchema>;
+export type EndUserGroupConfig = z.infer<typeof EndUserGroupConfigSchema>;

package/dist/index.d.ts

@@ -1,5 +1,8 @@
 export * from "./audit/events";
+export * from "./audit/events.base";
+export * from "./audit/events.llm";
 export * from "./audit/governance-actions";
+export type { EndUserConfig, EndUserGroupConfig } from "./enduser.types";
 export * from "./rules/action.types";
 export * from "./rules/condition.types";
 export * from "./rules/rule.types";

package/dist/index.js

@@ -12574,29 +12574,15 @@ function date4(params) {
 
 // node_modules/zod/v4/classic/external.js
 config(en_default());
-// node_modules/zod/index.js
-var zod_default = exports_external;
-
-// src/audit/governance-actions.ts
-var AppliedActionSchema = exports_external.object({
-  type: exports_external.custom(),
-  ruleId: exports_external.string()
-});
-var GovernanceDecisionSchema = exports_external.object({
-  effect: exports_external.custom(),
-  code: exports_external.custom(),
-  matchedRuleIds: exports_external.array(exports_external.string()),
-  appliedActions: exports_external.array(AppliedActionSchema),
-  reason: exports_external.optional(exports_external.string())
+// src/enduser.types.ts
+var EndUserConfigSchema = exports_external.object({
+  externalId: exports_external.string(),
+  metadata: exports_external.record(exports_external.string(), exports_external.string()),
+  name: exports_external.string().optional()
 });
+var EndUserGroupConfigSchema = EndUserConfigSchema;
 
-// src/audit/events.ts
-var CountersSchema = exports_external.record(exports_external.string(), exports_external.union([exports_external.string(), exports_external.number()]));
-var ToolMetaSchema = exports_external.object({
-  redacted: exports_external.boolean(),
-  redactedFields: exports_external.array(exports_external.string()).optional(),
-  sizeBytesApprox: exports_external.number().min(0).optional()
-});
+// src/audit/events.base.ts
 var AuditEnvelopeSchema = exports_external.object({
   schema: exports_external.literal("handlebar.audit.v1"),
   ts: exports_external.preprocess((v) => {
@@ -12628,6 +12614,60 @@ var AuditEnvelopeSchema = exports_external.object({
     level: exports_external.enum(["none", "partial", "strict"]).optional()
   }).optional()
 });
+
+// src/audit/events.llm.ts
+var MessageRoleSchema = exports_external.enum([
+  "system",
+  "developer",
+  "user",
+  "assistant",
+  "tool"
+]);
+var MessageKindSchema = exports_external.enum([
+  "input",
+  "output",
+  "tool_call",
+  "tool_result",
+  "observation",
+  "internal_summary",
+  "thinking"
+]);
+var MessageSchema = exports_external.object({
+  messageId: exports_external.uuidv7(),
+  role: MessageRoleSchema,
+  kind: MessageKindSchema,
+  content: exports_external.string(),
+  contentTruncated: exports_external.boolean(),
+  parentMessageId: exports_external.uuidv7().optional(),
+  turnIndex: exports_external.number().int().min(0).optional(),
+  name: exports_external.string().optional(),
+  tags: exports_external.array(exports_external.string()).optional()
+});
+var MessageEventSchema = AuditEnvelopeSchema.extend({
+  kind: exports_external.literal("message.raw.created"),
+  data: MessageSchema
+});
+
+// src/audit/governance-actions.ts
+var AppliedActionSchema = exports_external.object({
+  type: exports_external.custom(),
+  ruleId: exports_external.string()
+});
+var GovernanceDecisionSchema = exports_external.object({
+  effect: exports_external.custom(),
+  code: exports_external.custom(),
+  matchedRuleIds: exports_external.array(exports_external.string()),
+  appliedActions: exports_external.array(AppliedActionSchema),
+  reason: exports_external.optional(exports_external.string())
+});
+
+// src/audit/events.ts
+var CountersSchema = exports_external.record(exports_external.string(), exports_external.union([exports_external.string(), exports_external.number()]));
+var ToolMetaSchema = exports_external.object({
+  redacted: exports_external.boolean(),
+  redactedFields: exports_external.array(exports_external.string()).optional(),
+  sizeBytesApprox: exports_external.number().min(0).optional()
+});
 var RunStartedEventSchema = AuditEnvelopeSchema.extend({
   kind: exports_external.literal("run.started"),
   data: exports_external.object({
@@ -12638,6 +12678,9 @@ var RunStartedEventSchema = AuditEnvelopeSchema.extend({
       id: exports_external.string().optional(),
       name: exports_external.string().optional()
     }),
+    enduser: EndUserConfigSchema.extend({
+      group: EndUserGroupConfigSchema.optional()
+    }).optional(),
     model: exports_external.object({
       provider: exports_external.string().optional(),
       name: exports_external.string().optional()
@@ -12717,18 +12760,19 @@ var AuditEventSchema = exports_external.discriminatedUnion("kind", [
   ToolDecisionEventSchema,
   ToolResultEventSchema,
   RunEndedEventSchema,
-  ErrorEventSchema
+  ErrorEventSchema,
+  MessageEventSchema
 ]);
 // src/rules/rule.types.ts
-var RuleConfigSchema = zod_default.object({
-  priority: zod_default.number().min(0),
-  when: zod_default.custom(),
-  condition: zod_default.custom(),
-  actions: zod_default.array(zod_default.custom())
-});
-var RuleSchema = zod_default.object({
-  id: zod_default.uuid({ version: "v7" }),
-  policy_id: zod_default.uuid({ version: "v7" })
+var RuleConfigSchema = exports_external.object({
+  priority: exports_external.number().min(0),
+  when: exports_external.custom(),
+  condition: exports_external.custom(),
+  actions: exports_external.array(exports_external.custom())
+});
+var RuleSchema = exports_external.object({
+  id: exports_external.uuid({ version: "v7" }),
+  policy_id: exports_external.uuid({ version: "v7" })
 }).and(RuleConfigSchema);
 export {
   ToolResultEventSchema,
@@ -12737,6 +12781,10 @@ export {
   RunEndedEventSchema,
   RuleSchema,
   RuleConfigSchema,
+  MessageSchema,
+  MessageRoleSchema,
+  MessageKindSchema,
+  MessageEventSchema,
   HitlMetaSchema,
   GovernanceDecisionSchema,
   ErrorEventSchema,

package/dist/rules/rule.types.d.ts

@@ -1,4 +1,4 @@
-import z from "zod";
+import { z } from "zod";
 import type { RuleAction } from "./action.types";
 import type { RuleCondition } from "./condition.types";
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@handlebar/governance-schema",
-	"version": "0.0.5",
+	"version": "0.0.6-dev.1",
 	"private": false,
 	"type": "module",
 	"main": "./dist/index.cjs",