@kadi.build/core 0.0.1-alpha.2 → 0.0.1-alpha.4

package/dist/messages/MessageBuilder.d.ts

@@ -0,0 +1,83 @@
+/**
+ * TypeScript implementation of JSON-RPC message builders
+ * Replaces the JavaScript message builder functionality
+ */
+/**
+ * Simple ID factory for generating unique message IDs
+ */
+export declare class IdFactory {
+    private counter;
+    next(): string;
+    uuid(): string;
+}
+/**
+ * JSON-RPC message builder
+ */
+export declare class JsonRpcBuilder {
+    private message;
+    constructor(method: string, params?: any, isNotification?: boolean);
+    /**
+     * Set the request ID
+     */
+    id(id: string | number): this;
+    /**
+     * Add additional parameters
+     */
+    params(additionalParams: any): this;
+    /**
+     * Build the final message
+     */
+    build(): any;
+    /**
+     * Build and stringify
+     */
+    toString(): string;
+}
+/**
+ * JSON-RPC response builder
+ */
+export declare class JsonRpcResponse {
+    private response;
+    constructor(id: string | number | null);
+    /**
+     * Set successful result
+     */
+    result(data: any): this;
+    /**
+     * Set error
+     */
+    error(code: number, message: string, data?: any): this;
+    /**
+     * Build the final response
+     */
+    build(): any;
+    /**
+     * Build and stringify
+     */
+    toString(): string;
+}
+/**
+ * Common JSON-RPC error codes
+ */
+export declare const RpcErrorCodes: {
+    readonly PARSE_ERROR: -32700;
+    readonly INVALID_REQUEST: -32600;
+    readonly METHOD_NOT_FOUND: -32601;
+    readonly INVALID_PARAMS: -32602;
+    readonly INTERNAL_ERROR: -32603;
+    readonly SERVER_ERROR_START: -32099;
+    readonly SERVER_ERROR_END: -32000;
+};
+/**
+ * Helper function to create success response
+ */
+export declare function createSuccessResponse(id: string | number | null, result: any): any;
+/**
+ * Helper function to create error response
+ */
+export declare function createErrorResponse(id: string | number | null, code: number, message: string, data?: any): any;
+/**
+ * Helper function to create notification
+ */
+export declare function createNotification(method: string, params?: any): any;
+//# sourceMappingURL=MessageBuilder.d.ts.map

package/dist/messages/MessageBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageBuilder.d.ts","sourceRoot":"","sources":["../../src/messages/MessageBuilder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAK;IAEpB,IAAI,IAAI,MAAM;IAId,IAAI,IAAI,MAAM;CAGf;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAM;gBAET,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,cAAc,UAAQ;IAgBhE;;OAEG;IACH,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAK7B;;OAEG;IACH,MAAM,CAAC,gBAAgB,EAAE,GAAG,GAAG,IAAI;IASnC;;OAEG;IACH,KAAK,IAAI,GAAG;IAIZ;;OAEG;IACH,QAAQ,IAAI,MAAM;CAGnB;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAM;gBAEV,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAOtC;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI;IAMvB;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IActD;;OAEG;IACH,KAAK,IAAI,GAAG;IAIZ;;OAEG;IACH,QAAQ,IAAI,MAAM;CAGnB;AAED;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;CAQhB,CAAC;AAEX;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EAC1B,MAAM,EAAE,GAAG,GACV,GAAG,CAEL;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,GAAG,GACT,GAAG,CAEL;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,GAAG,GAAG,CAEpE"}

package/dist/messages/MessageBuilder.js

@@ -0,0 +1,144 @@
+/**
+ * TypeScript implementation of JSON-RPC message builders
+ * Replaces the JavaScript message builder functionality
+ */
+import { randomUUID } from 'node:crypto';
+/**
+ * Simple ID factory for generating unique message IDs
+ */
+export class IdFactory {
+    counter = 0;
+    next() {
+        return `${Date.now()}-${++this.counter}`;
+    }
+    uuid() {
+        return randomUUID();
+    }
+}
+/**
+ * JSON-RPC message builder
+ */
+export class JsonRpcBuilder {
+    message;
+    constructor(method, params, isNotification = false) {
+        this.message = {
+            jsonrpc: '2.0',
+            method
+        };
+        if (params !== undefined) {
+            this.message.params = params;
+        }
+        if (!isNotification) {
+            // Will be set later with id() method
+            this.message.id = null;
+        }
+    }
+    /**
+     * Set the request ID
+     */
+    id(id) {
+        this.message.id = id;
+        return this;
+    }
+    /**
+     * Add additional parameters
+     */
+    params(additionalParams) {
+        if (this.message.params) {
+            this.message.params = { ...this.message.params, ...additionalParams };
+        }
+        else {
+            this.message.params = additionalParams;
+        }
+        return this;
+    }
+    /**
+     * Build the final message
+     */
+    build() {
+        return { ...this.message };
+    }
+    /**
+     * Build and stringify
+     */
+    toString() {
+        return JSON.stringify(this.build());
+    }
+}
+/**
+ * JSON-RPC response builder
+ */
+export class JsonRpcResponse {
+    response;
+    constructor(id) {
+        this.response = {
+            jsonrpc: '2.0',
+            id
+        };
+    }
+    /**
+     * Set successful result
+     */
+    result(data) {
+        this.response.result = data;
+        delete this.response.error;
+        return this;
+    }
+    /**
+     * Set error
+     */
+    error(code, message, data) {
+        this.response.error = {
+            code,
+            message
+        };
+        if (data !== undefined) {
+            this.response.error.data = data;
+        }
+        delete this.response.result;
+        return this;
+    }
+    /**
+     * Build the final response
+     */
+    build() {
+        return { ...this.response };
+    }
+    /**
+     * Build and stringify
+     */
+    toString() {
+        return JSON.stringify(this.build());
+    }
+}
+/**
+ * Common JSON-RPC error codes
+ */
+export const RpcErrorCodes = {
+    PARSE_ERROR: -32700,
+    INVALID_REQUEST: -32600,
+    METHOD_NOT_FOUND: -32601,
+    INVALID_PARAMS: -32602,
+    INTERNAL_ERROR: -32603,
+    SERVER_ERROR_START: -32099,
+    SERVER_ERROR_END: -32000
+};
+/**
+ * Helper function to create success response
+ */
+export function createSuccessResponse(id, result) {
+    return new JsonRpcResponse(id).result(result).build();
+}
+/**
+ * Helper function to create error response
+ */
+export function createErrorResponse(id, code, message, data) {
+    return new JsonRpcResponse(id).error(code, message, data).build();
+}
+/**
+ * Helper function to create notification
+ */
+export function createNotification(method, params) {
+    return new JsonRpcBuilder(method, params, true).build();
+}
+//# sourceMappingURL=MessageBuilder.js.map

package/dist/messages/MessageBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageBuilder.js","sourceRoot":"","sources":["../../src/messages/MessageBuilder.ts"],"names":[],"mappings":"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"}

package/dist/schemas/events.schemas.d.ts

@@ -0,0 +1,177 @@
+/**
+ * Event System Schema Validation
+ * ------------------------------
+ * Zod schemas for validating event system parameters and messages.
+ * This ensures type safety and proper input validation for all event operations.
+ *
+ * The schemas follow the established patterns in the KADI broker for consistency
+ * and integrate with the existing validation middleware.
+ */
+import { z } from 'zod';
+/**
+ * Event channel pattern validation schema.
+ *
+ * Enforces the hierarchical naming convention:
+ * - Format: namespace.event-name or namespace.category.event-name
+ * - Examples: 'system.startup', 'tool.completed', 'agent.status.changed'
+ * - Wildcards: '*' matches one segment, '#' matches multiple segments
+ *
+ * Rules:
+ * - Must start with lowercase letter
+ * - Segments separated by dots
+ * - Only lowercase letters, numbers, underscores, hyphens allowed
+ * - Wildcards * and # only allowed at end of segments
+ */
+export declare const EventChannelSchema: z.ZodString;
+/**
+ * Schema for event subscription requests (kadi.event.subscribe)
+ */
+export declare const EventSubscribeSchema: z.ZodObject<{
+    channels: z.ZodArray<z.ZodString>;
+    networkId: z.ZodOptional<z.ZodString>;
+    filter: z.ZodOptional<z.ZodObject<{
+        publisherId: z.ZodOptional<z.ZodString>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+}, z.core.$strict>;
+export type EventSubscribeParams = z.infer<typeof EventSubscribeSchema>;
+/**
+ * Schema for event subscription response
+ */
+export declare const EventSubscribeResultSchema: z.ZodObject<{
+    subscribed: z.ZodArray<z.ZodString>;
+    queueName: z.ZodString;
+}, z.core.$strict>;
+export type EventSubscribeResult = z.infer<typeof EventSubscribeResultSchema>;
+/**
+ * Schema for event unsubscription requests (kadi.event.unsubscribe)
+ */
+export declare const EventUnsubscribeSchema: z.ZodObject<{
+    channels: z.ZodArray<z.ZodString>;
+    networkId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type EventUnsubscribeParams = z.infer<typeof EventUnsubscribeSchema>;
+/**
+ * Schema for event unsubscription response
+ */
+export declare const EventUnsubscribeResultSchema: z.ZodObject<{
+    unsubscribed: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export type EventUnsubscribeResult = z.infer<typeof EventUnsubscribeResultSchema>;
+/**
+ * Schema for event publishing requests (kadi.event.publish)
+ */
+export declare const EventPublishSchema: z.ZodObject<{
+    channel: z.ZodString;
+    data: z.ZodUnknown;
+    networks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>;
+export type EventPublishParams = z.infer<typeof EventPublishSchema>;
+/**
+ * Schema for event publishing response
+ */
+export declare const EventPublishResultSchema: z.ZodObject<{
+    published: z.ZodBoolean;
+    eventId: z.ZodString;
+}, z.core.$strict>;
+export type EventPublishResult = z.infer<typeof EventPublishResultSchema>;
+/**
+ * Schema for event subscription listing requests (kadi.event.list)
+ */
+export declare const EventListSchema: z.ZodObject<{
+    agentId: z.ZodOptional<z.ZodString>;
+    networkId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type EventListParams = z.infer<typeof EventListSchema>;
+/**
+ * Schema for event subscription listing response
+ */
+export declare const EventListResultSchema: z.ZodObject<{
+    subscriptions: z.ZodArray<z.ZodObject<{
+        agentId: z.ZodString;
+        channels: z.ZodArray<z.ZodString>;
+        networks: z.ZodArray<z.ZodString>;
+        queueName: z.ZodString;
+        subscribedAt: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strict>;
+export type EventListResult = z.infer<typeof EventListResultSchema>;
+/**
+ * Schema for validating event messages before delivery.
+ * This ensures all events have consistent structure when delivered to subscribers.
+ */
+export declare const EventMessageSchema: z.ZodObject<{
+    channel: z.ZodString;
+    data: z.ZodUnknown;
+    timestamp: z.ZodString;
+    publisherId: z.ZodString;
+    networkId: z.ZodString;
+    metadata: z.ZodOptional<z.ZodObject<{
+        correlationId: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+        eventId: z.ZodOptional<z.ZodString>;
+        publisherRole: z.ZodOptional<z.ZodString>;
+    }, z.core.$catchall<z.ZodUnknown>>>;
+}, z.core.$strict>;
+export type EventMessage = z.infer<typeof EventMessageSchema>;
+/**
+ * Validation middleware for event system methods.
+ * Extends the existing ValidationMiddleware pattern to support event operations.
+ */
+export declare class EventValidationMiddleware {
+    /**
+     * Validates parameters for event system methods using appropriate schemas
+     */
+    static validateEventParams<T>(method: string, params: unknown): T;
+    /**
+     * Validates event message structure before delivery
+     */
+    static validateEventMessage(message: unknown): EventMessage;
+    /**
+     * Provides user-friendly error messages for common validation failures
+     */
+    static getValidationHint(method: string, error: z.ZodError): string;
+}
+/**
+ * Export all schemas for use in tests and external validation
+ */
+export declare const EventSchemas: {
+    readonly EventChannel: z.ZodString;
+    readonly EventSubscribe: z.ZodObject<{
+        channels: z.ZodArray<z.ZodString>;
+        networkId: z.ZodOptional<z.ZodString>;
+        filter: z.ZodOptional<z.ZodObject<{
+            publisherId: z.ZodOptional<z.ZodString>;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>;
+    }, z.core.$strict>;
+    readonly EventUnsubscribe: z.ZodObject<{
+        channels: z.ZodArray<z.ZodString>;
+        networkId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly EventPublish: z.ZodObject<{
+        channel: z.ZodString;
+        data: z.ZodUnknown;
+        networks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>;
+    readonly EventList: z.ZodObject<{
+        agentId: z.ZodOptional<z.ZodString>;
+        networkId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly EventMessage: z.ZodObject<{
+        channel: z.ZodString;
+        data: z.ZodUnknown;
+        timestamp: z.ZodString;
+        publisherId: z.ZodString;
+        networkId: z.ZodString;
+        metadata: z.ZodOptional<z.ZodObject<{
+            correlationId: z.ZodOptional<z.ZodString>;
+            version: z.ZodOptional<z.ZodString>;
+            eventId: z.ZodOptional<z.ZodString>;
+            publisherRole: z.ZodOptional<z.ZodString>;
+        }, z.core.$catchall<z.ZodUnknown>>>;
+    }, z.core.$strict>;
+};
+//# sourceMappingURL=events.schemas.d.ts.map

package/dist/schemas/events.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.schemas.d.ts","sourceRoot":"","sources":["../../src/schemas/events.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,kBAAkB,aAQuB,CAAC;AAMvD;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;kBAqBtB,CAAC;AAEZ,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;kBAO5B,CAAC;AAEZ,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAM9E;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;kBAUxB,CAAC;AAEZ,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE5E;;GAEG;AACH,eAAO,MAAM,4BAA4B;;kBAK9B,CAAC;AAEZ,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAC1C,OAAO,4BAA4B,CACpC,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;kBAoBpB,CAAC;AAEZ,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;kBAO1B,CAAC;AAEZ,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAM1E;;GAEG;AACH,eAAO,MAAM,eAAe;;;kBAOjB,CAAC;AAEZ,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;kBAavB,CAAC;AAEZ,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAMpE;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;kBAiCpB,CAAC;AAEZ,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAM9D;;;GAGG;AACH,qBAAa,yBAAyB;IACpC;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,CAAC;IAoBjE;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY;IAI3D;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,QAAQ,GAAG,MAAM;CAyBpE;AAMD;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAOf,CAAC"}

package/dist/schemas/events.schemas.js

@@ -0,0 +1,265 @@
+/**
+ * Event System Schema Validation
+ * ------------------------------
+ * Zod schemas for validating event system parameters and messages.
+ * This ensures type safety and proper input validation for all event operations.
+ *
+ * The schemas follow the established patterns in the KADI broker for consistency
+ * and integrate with the existing validation middleware.
+ */
+import { z } from 'zod';
+import { NetworkIdSchema } from './kadi.schemas.js';
+// ============================================================================
+// EVENT CHANNEL VALIDATION
+// ============================================================================
+/**
+ * Event channel pattern validation schema.
+ *
+ * Enforces the hierarchical naming convention:
+ * - Format: namespace.event-name or namespace.category.event-name
+ * - Examples: 'system.startup', 'tool.completed', 'agent.status.changed'
+ * - Wildcards: '*' matches one segment, '#' matches multiple segments
+ *
+ * Rules:
+ * - Must start with lowercase letter
+ * - Segments separated by dots
+ * - Only lowercase letters, numbers, underscores, hyphens allowed
+ * - Wildcards * and # only allowed at end of segments
+ */
+export const EventChannelSchema = z
+    .string()
+    .min(1, 'Event channel cannot be empty')
+    .max(128, 'Event channel too long')
+    .regex(/^[a-z][a-z0-9_-]*(?:\.[a-z0-9_*#-]+)*$/, 'Event channel must use lowercase with dots (e.g., "system.startup", "tool.*", "agent.#")')
+    .describe('Event channel pattern for subscriptions');
+// ============================================================================
+// EVENT SUBSCRIPTION SCHEMAS
+// ============================================================================
+/**
+ * Schema for event subscription requests (kadi.event.subscribe)
+ */
+export const EventSubscribeSchema = z
+    .object({
+    /** Array of event channel patterns to subscribe to */
+    channels: z
+        .array(EventChannelSchema)
+        .min(1, 'Must specify at least one channel')
+        .max(50, 'Too many channels in single subscription'),
+    /** Optional network to subscribe within - defaults to agent's networks */
+    networkId: NetworkIdSchema.optional(),
+    /** Optional filters to reduce event volume */
+    filter: z
+        .object({
+        /** Only receive events from specific publisher */
+        publisherId: z.string().optional(),
+        /** Only receive events with matching metadata */
+        metadata: z.record(z.string(), z.unknown()).optional()
+    })
+        .optional()
+})
+    .strict(); // Prevent additional properties
+/**
+ * Schema for event subscription response
+ */
+export const EventSubscribeResultSchema = z
+    .object({
+    /** Channels that were successfully subscribed to */
+    subscribed: z.array(EventChannelSchema),
+    /** Internal queue name for debugging/monitoring */
+    queueName: z.string()
+})
+    .strict();
+// ============================================================================
+// EVENT UNSUBSCRIPTION SCHEMAS
+// ============================================================================
+/**
+ * Schema for event unsubscription requests (kadi.event.unsubscribe)
+ */
+export const EventUnsubscribeSchema = z
+    .object({
+    /** Channel patterns to unsubscribe from */
+    channels: z
+        .array(EventChannelSchema)
+        .min(1, 'Must specify at least one channel'),
+    /** Network to unsubscribe from - defaults to 'global' */
+    networkId: NetworkIdSchema.optional()
+})
+    .strict();
+/**
+ * Schema for event unsubscription response
+ */
+export const EventUnsubscribeResultSchema = z
+    .object({
+    /** Channels that were successfully unsubscribed */
+    unsubscribed: z.array(EventChannelSchema)
+})
+    .strict();
+// ============================================================================
+// EVENT PUBLISHING SCHEMAS
+// ============================================================================
+/**
+ * Schema for event publishing requests (kadi.event.publish)
+ */
+export const EventPublishSchema = z
+    .object({
+    /** Event channel to publish to - must not contain wildcards */
+    channel: EventChannelSchema.refine((channel) => !channel.includes('*') && !channel.includes('#'), 'Cannot publish to wildcard channels - use specific channel names'),
+    /** Event payload data - any serializable value */
+    data: z.unknown(),
+    /** Networks to publish to - defaults to publisher's networks */
+    networks: z
+        .array(NetworkIdSchema)
+        .max(10, 'Cannot publish to more than 10 networks at once')
+        .optional(),
+    /** Optional metadata to include with the event */
+    metadata: z.record(z.string(), z.unknown()).optional()
+})
+    .strict();
+/**
+ * Schema for event publishing response
+ */
+export const EventPublishResultSchema = z
+    .object({
+    /** Whether the event was successfully published */
+    published: z.boolean(),
+    /** Unique identifier for this event (for tracking/debugging) */
+    eventId: z.string().uuid()
+})
+    .strict();
+// ============================================================================
+// EVENT LISTING SCHEMAS
+// ============================================================================
+/**
+ * Schema for event subscription listing requests (kadi.event.list)
+ */
+export const EventListSchema = z
+    .object({
+    /** Filter subscriptions by agent ID */
+    agentId: z.string().optional(),
+    /** Filter subscriptions by network */
+    networkId: NetworkIdSchema.optional()
+})
+    .strict();
+/**
+ * Schema for event subscription listing response
+ */
+export const EventListResultSchema = z
+    .object({
+    /** Array of active subscriptions */
+    subscriptions: z.array(z.object({
+        agentId: z.string(),
+        channels: z.array(EventChannelSchema),
+        networks: z.array(NetworkIdSchema),
+        queueName: z.string(),
+        subscribedAt: z.string().datetime() // ISO 8601 timestamp
+    }))
+})
+    .strict();
+// ============================================================================
+// EVENT MESSAGE SCHEMAS
+// ============================================================================
+/**
+ * Schema for validating event messages before delivery.
+ * This ensures all events have consistent structure when delivered to subscribers.
+ */
+export const EventMessageSchema = z
+    .object({
+    /** The channel this event was published to */
+    channel: EventChannelSchema,
+    /** Event-specific payload data */
+    data: z.unknown(),
+    /** ISO 8601 timestamp when event was published */
+    timestamp: z.string().datetime(),
+    /** ID of the agent/tool that published this event */
+    publisherId: z.string(),
+    /** Network where this event was published */
+    networkId: NetworkIdSchema,
+    /** Optional metadata for correlation and tracking */
+    metadata: z
+        .object({
+        /** For tracking related events across the system */
+        correlationId: z.string().optional(),
+        /** Event schema version for evolution */
+        version: z.string().optional(),
+        /** Event ID for deduplication and tracing */
+        eventId: z.string().uuid().optional(),
+        /** Role of the publisher (agent, tool, system) */
+        publisherRole: z.string().optional()
+        /** Additional custom metadata */
+    })
+        .catchall(z.unknown())
+        .optional() // Allow additional metadata fields
+})
+    .strict();
+// ============================================================================
+// VALIDATION MIDDLEWARE INTEGRATION
+// ============================================================================
+/**
+ * Validation middleware for event system methods.
+ * Extends the existing ValidationMiddleware pattern to support event operations.
+ */
+export class EventValidationMiddleware {
+    /**
+     * Validates parameters for event system methods using appropriate schemas
+     */
+    static validateEventParams(method, params) {
+        switch (method) {
+            case 'kadi.event.subscribe':
+                return EventSubscribeSchema.parse(params);
+            case 'kadi.event.unsubscribe':
+                return EventUnsubscribeSchema.parse(params);
+            case 'kadi.event.publish':
+                return EventPublishSchema.parse(params);
+            case 'kadi.event.list':
+                return EventListSchema.parse(params);
+            default:
+                // For non-event methods, return params as-is
+                return params;
+        }
+    }
+    /**
+     * Validates event message structure before delivery
+     */
+    static validateEventMessage(message) {
+        return EventMessageSchema.parse(message);
+    }
+    /**
+     * Provides user-friendly error messages for common validation failures
+     */
+    static getValidationHint(method, error) {
+        const firstError = error.issues[0];
+        switch (method) {
+            case 'kadi.event.subscribe':
+                if (firstError?.path.includes('channels')) {
+                    return 'Check channel format: use lowercase with dots (e.g., "system.startup", "tool.*")';
+                }
+                break;
+            case 'kadi.event.publish':
+                if (firstError?.path.includes('channel')) {
+                    return 'Channel must be specific (no wildcards) and use lowercase.separated format';
+                }
+                if (firstError?.path.includes('networks')) {
+                    return 'Networks must be an array of valid network IDs';
+                }
+                break;
+            default:
+                return 'Check your event parameters for correct format and types';
+        }
+        return 'Check the event system documentation for parameter requirements';
+    }
+}
+// ============================================================================
+// SCHEMA EXPORTS FOR EXTERNAL USE
+// ============================================================================
+/**
+ * Export all schemas for use in tests and external validation
+ */
+export const EventSchemas = {
+    EventChannel: EventChannelSchema,
+    EventSubscribe: EventSubscribeSchema,
+    EventUnsubscribe: EventUnsubscribeSchema,
+    EventPublish: EventPublishSchema,
+    EventList: EventListSchema,
+    EventMessage: EventMessageSchema
+};
+//# sourceMappingURL=events.schemas.js.map