@kadi.build/core 0.0.1-alpha.1 → 0.0.1-alpha.10

package/dist/types/errors.d.ts

@@ -0,0 +1,178 @@
+/**
+ * Error Types
+ *
+ * Type definitions for KADI error handling.
+ * Errors preserve context without wrapping, enabling proper debugging.
+ */
+/**
+ * KADI Error class
+ *
+ * Custom error class with structured error codes and context.
+ * Preserves stack traces and adds contextual information.
+ *
+ * @example
+ * ```typescript
+ * throw new KadiError(
+ *   'Tool not found',
+ *   ErrorCode.TOOL_NOT_FOUND,
+ *   404,
+ *   { toolName: 'calculate', agent: 'calculator' }
+ * );
+ * ```
+ */
+export declare class KadiError extends Error {
+    /**
+     * Structured error code
+     */
+    readonly code: ErrorCode;
+    /**
+     * HTTP-style status code
+     */
+    readonly statusCode: number;
+    /**
+     * Additional contextual information
+     */
+    readonly context?: ErrorContext;
+    /**
+     * Timestamp when error was created
+     */
+    readonly timestamp: number;
+    /**
+     * Unique error ID for tracking
+     */
+    readonly errorId: string;
+    constructor(message: string, code: ErrorCode, statusCode?: number, context?: ErrorContext);
+    /**
+     * Convert error to JSON for serialization
+     */
+    toJSON(): ErrorJSON;
+    /**
+     * Create KadiError from unknown error
+     */
+    static from(error: unknown, code?: ErrorCode): KadiError;
+}
+/**
+ * Structured error codes
+ */
+export declare enum ErrorCode {
+    UNKNOWN_ERROR = "UNKNOWN_ERROR",
+    INTERNAL_ERROR = "INTERNAL_ERROR",
+    INVALID_INPUT = "INVALID_INPUT",
+    INVALID_CONFIG = "INVALID_CONFIG",
+    NOT_IMPLEMENTED = "NOT_IMPLEMENTED",
+    CONNECTION_FAILED = "CONNECTION_FAILED",
+    CONNECTION_TIMEOUT = "CONNECTION_TIMEOUT",
+    CONNECTION_CLOSED = "CONNECTION_CLOSED",
+    AUTHENTICATION_FAILED = "AUTHENTICATION_FAILED",
+    BROKER_NOT_CONNECTED = "BROKER_NOT_CONNECTED",
+    BROKER_CONNECTION_FAILED = "BROKER_CONNECTION_FAILED",
+    BROKER_RESPONSE_ERROR = "BROKER_RESPONSE_ERROR",
+    BROKER_TIMEOUT = "BROKER_TIMEOUT",
+    TOOL_NOT_FOUND = "TOOL_NOT_FOUND",
+    TOOL_ALREADY_REGISTERED = "TOOL_ALREADY_REGISTERED",
+    TOOL_INVOCATION_FAILED = "TOOL_INVOCATION_FAILED",
+    TOOL_VALIDATION_FAILED = "TOOL_VALIDATION_FAILED",
+    TOOL_TIMEOUT = "TOOL_TIMEOUT",
+    ABILITY_NOT_FOUND = "ABILITY_NOT_FOUND",
+    ABILITY_LOAD_FAILED = "ABILITY_LOAD_FAILED",
+    ABILITY_NOT_LOADED = "ABILITY_NOT_LOADED",
+    ABILITY_ALREADY_LOADED = "ABILITY_ALREADY_LOADED",
+    ABILITY_METHOD_NOT_FOUND = "ABILITY_METHOD_NOT_FOUND",
+    ABILITY_INVALID = "ABILITY_INVALID",
+    ABILITY_NOT_CONNECTED = "ABILITY_NOT_CONNECTED",
+    EVENT_SUBSCRIPTION_FAILED = "EVENT_SUBSCRIPTION_FAILED",
+    EVENT_PUBLISH_FAILED = "EVENT_PUBLISH_FAILED",
+    EVENT_PATTERN_INVALID = "EVENT_PATTERN_INVALID",
+    TRANSPORT_NOT_CONNECTED = "TRANSPORT_NOT_CONNECTED",
+    TRANSPORT_CONNECTION_FAILED = "TRANSPORT_CONNECTION_FAILED",
+    TRANSPORT_SEND_FAILED = "TRANSPORT_SEND_FAILED",
+    STDIO_PROCESS_FAILED = "STDIO_PROCESS_FAILED",
+    STDIO_PROCESS_EXITED = "STDIO_PROCESS_EXITED",
+    STDIO_FRAMING_ERROR = "STDIO_FRAMING_ERROR",
+    SCHEMA_VALIDATION_FAILED = "SCHEMA_VALIDATION_FAILED",
+    BROKER_SCHEMA_COMPILATION_ERROR = "BROKER_SCHEMA_COMPILATION_ERROR",
+    INVALID_MESSAGE_FORMAT = "INVALID_MESSAGE_FORMAT",
+    INVALID_PROTOCOL_VERSION = "INVALID_PROTOCOL_VERSION"
+}
+/**
+ * Error context information
+ */
+export interface ErrorContext {
+    /**
+     * Component/module where error occurred
+     */
+    component?: string;
+    /**
+     * Operation being performed
+     */
+    operation?: string;
+    /**
+     * Agent name
+     */
+    agent?: string;
+    /**
+     * Tool/method name
+     */
+    tool?: string;
+    /**
+     * Ability name
+     */
+    ability?: string;
+    /**
+     * Broker URL
+     */
+    broker?: string;
+    /**
+     * Network
+     */
+    network?: string;
+    /**
+     * Additional details
+     */
+    details?: Record<string, unknown>;
+    /**
+     * Original error name (for wrapped errors)
+     */
+    originalError?: string;
+    [key: string]: unknown;
+}
+/**
+ * JSON representation of error
+ */
+export interface ErrorJSON {
+    name: string;
+    message: string;
+    code: ErrorCode;
+    statusCode: number;
+    context?: ErrorContext;
+    errorId: string;
+    timestamp: number;
+    stack?: string;
+}
+/**
+ * Type guard for KadiError
+ */
+export declare function isKadiError(error: unknown): error is KadiError;
+/**
+ * Type guard for Error
+ */
+export declare function isError(error: unknown): error is Error;
+/**
+ * Error result wrapper for operations that may fail
+ */
+export type Result<T, E = KadiError> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: E;
+};
+/**
+ * Create success result
+ */
+export declare function success<T>(data: T): Result<T, never>;
+/**
+ * Create error result
+ */
+export declare function failure<E = KadiError>(error: E): Result<never, E>;
+//# sourceMappingURL=errors.d.ts.map

package/dist/types/errors.d.ts.map

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

package/dist/types/errors.js

@@ -0,0 +1,165 @@
+/**
+ * Error Types
+ *
+ * Type definitions for KADI error handling.
+ * Errors preserve context without wrapping, enabling proper debugging.
+ */
+/**
+ * KADI Error class
+ *
+ * Custom error class with structured error codes and context.
+ * Preserves stack traces and adds contextual information.
+ *
+ * @example
+ * ```typescript
+ * throw new KadiError(
+ *   'Tool not found',
+ *   ErrorCode.TOOL_NOT_FOUND,
+ *   404,
+ *   { toolName: 'calculate', agent: 'calculator' }
+ * );
+ * ```
+ */
+export class KadiError extends Error {
+    /**
+     * Structured error code
+     */
+    code;
+    /**
+     * HTTP-style status code
+     */
+    statusCode;
+    /**
+     * Additional contextual information
+     */
+    context;
+    /**
+     * Timestamp when error was created
+     */
+    timestamp;
+    /**
+     * Unique error ID for tracking
+     */
+    errorId;
+    constructor(message, code, statusCode = 500, context) {
+        super(message);
+        this.name = 'KadiError';
+        this.code = code;
+        this.statusCode = statusCode;
+        this.context = context;
+        this.timestamp = Date.now();
+        this.errorId = `${code}_${this.timestamp}_${Math.random().toString(36).substring(2, 9)}`;
+        // Capture stack trace
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, KadiError);
+        }
+    }
+    /**
+     * Convert error to JSON for serialization
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            code: this.code,
+            statusCode: this.statusCode,
+            context: this.context,
+            errorId: this.errorId,
+            timestamp: this.timestamp,
+            stack: this.stack
+        };
+    }
+    /**
+     * Create KadiError from unknown error
+     */
+    static from(error, code = ErrorCode.UNKNOWN_ERROR) {
+        if (error instanceof KadiError) {
+            return error;
+        }
+        if (error instanceof Error) {
+            const kadiError = new KadiError(error.message, code, 500, { originalError: error.name });
+            // Preserve original stack
+            kadiError.stack = error.stack;
+            return kadiError;
+        }
+        return new KadiError(String(error), code, 500);
+    }
+}
+/**
+ * Structured error codes
+ */
+export var ErrorCode;
+(function (ErrorCode) {
+    // Generic errors
+    ErrorCode["UNKNOWN_ERROR"] = "UNKNOWN_ERROR";
+    ErrorCode["INTERNAL_ERROR"] = "INTERNAL_ERROR";
+    ErrorCode["INVALID_INPUT"] = "INVALID_INPUT";
+    ErrorCode["INVALID_CONFIG"] = "INVALID_CONFIG";
+    ErrorCode["NOT_IMPLEMENTED"] = "NOT_IMPLEMENTED";
+    // Connection errors
+    ErrorCode["CONNECTION_FAILED"] = "CONNECTION_FAILED";
+    ErrorCode["CONNECTION_TIMEOUT"] = "CONNECTION_TIMEOUT";
+    ErrorCode["CONNECTION_CLOSED"] = "CONNECTION_CLOSED";
+    ErrorCode["AUTHENTICATION_FAILED"] = "AUTHENTICATION_FAILED";
+    // Broker errors
+    ErrorCode["BROKER_NOT_CONNECTED"] = "BROKER_NOT_CONNECTED";
+    ErrorCode["BROKER_CONNECTION_FAILED"] = "BROKER_CONNECTION_FAILED";
+    ErrorCode["BROKER_RESPONSE_ERROR"] = "BROKER_RESPONSE_ERROR";
+    ErrorCode["BROKER_TIMEOUT"] = "BROKER_TIMEOUT";
+    // Tool errors
+    ErrorCode["TOOL_NOT_FOUND"] = "TOOL_NOT_FOUND";
+    ErrorCode["TOOL_ALREADY_REGISTERED"] = "TOOL_ALREADY_REGISTERED";
+    ErrorCode["TOOL_INVOCATION_FAILED"] = "TOOL_INVOCATION_FAILED";
+    ErrorCode["TOOL_VALIDATION_FAILED"] = "TOOL_VALIDATION_FAILED";
+    ErrorCode["TOOL_TIMEOUT"] = "TOOL_TIMEOUT";
+    // Ability errors
+    ErrorCode["ABILITY_NOT_FOUND"] = "ABILITY_NOT_FOUND";
+    ErrorCode["ABILITY_LOAD_FAILED"] = "ABILITY_LOAD_FAILED";
+    ErrorCode["ABILITY_NOT_LOADED"] = "ABILITY_NOT_LOADED";
+    ErrorCode["ABILITY_ALREADY_LOADED"] = "ABILITY_ALREADY_LOADED";
+    ErrorCode["ABILITY_METHOD_NOT_FOUND"] = "ABILITY_METHOD_NOT_FOUND";
+    ErrorCode["ABILITY_INVALID"] = "ABILITY_INVALID";
+    ErrorCode["ABILITY_NOT_CONNECTED"] = "ABILITY_NOT_CONNECTED";
+    // Event errors
+    ErrorCode["EVENT_SUBSCRIPTION_FAILED"] = "EVENT_SUBSCRIPTION_FAILED";
+    ErrorCode["EVENT_PUBLISH_FAILED"] = "EVENT_PUBLISH_FAILED";
+    ErrorCode["EVENT_PATTERN_INVALID"] = "EVENT_PATTERN_INVALID";
+    // Transport errors
+    ErrorCode["TRANSPORT_NOT_CONNECTED"] = "TRANSPORT_NOT_CONNECTED";
+    ErrorCode["TRANSPORT_CONNECTION_FAILED"] = "TRANSPORT_CONNECTION_FAILED";
+    ErrorCode["TRANSPORT_SEND_FAILED"] = "TRANSPORT_SEND_FAILED";
+    // Stdio errors
+    ErrorCode["STDIO_PROCESS_FAILED"] = "STDIO_PROCESS_FAILED";
+    ErrorCode["STDIO_PROCESS_EXITED"] = "STDIO_PROCESS_EXITED";
+    ErrorCode["STDIO_FRAMING_ERROR"] = "STDIO_FRAMING_ERROR";
+    // Validation errors
+    ErrorCode["SCHEMA_VALIDATION_FAILED"] = "SCHEMA_VALIDATION_FAILED";
+    ErrorCode["BROKER_SCHEMA_COMPILATION_ERROR"] = "BROKER_SCHEMA_COMPILATION_ERROR";
+    ErrorCode["INVALID_MESSAGE_FORMAT"] = "INVALID_MESSAGE_FORMAT";
+    ErrorCode["INVALID_PROTOCOL_VERSION"] = "INVALID_PROTOCOL_VERSION";
+})(ErrorCode || (ErrorCode = {}));
+/**
+ * Type guard for KadiError
+ */
+export function isKadiError(error) {
+    return error instanceof KadiError;
+}
+/**
+ * Type guard for Error
+ */
+export function isError(error) {
+    return error instanceof Error;
+}
+/**
+ * Create success result
+ */
+export function success(data) {
+    return { success: true, data };
+}
+/**
+ * Create error result
+ */
+export function failure(error) {
+    return { success: false, error };
+}
+//# sourceMappingURL=errors.js.map

package/dist/types/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,SAAU,SAAQ,KAAK;IAClC;;OAEG;IACa,IAAI,CAAY;IAEhC;;OAEG;IACa,UAAU,CAAS;IAEnC;;OAEG;IACa,OAAO,CAAgB;IAEvC;;OAEG;IACa,SAAS,CAAS;IAElC;;OAEG;IACa,OAAO,CAAS;IAEhC,YACE,OAAe,EACf,IAAe,EACf,aAAqB,GAAG,EACxB,OAAsB;QAEtB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO,GAAG,GAAG,IAAI,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QAEzF,sBAAsB;QACtB,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,KAAc,EAAE,OAAkB,SAAS,CAAC,aAAa;QACnE,IAAI,KAAK,YAAY,SAAS,EAAE,CAAC;YAC/B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,MAAM,SAAS,GAAG,IAAI,SAAS,CAC7B,KAAK,CAAC,OAAO,EACb,IAAI,EACJ,GAAG,EACH,EAAE,aAAa,EAAE,KAAK,CAAC,IAAI,EAAE,CAC9B,CAAC;YACF,0BAA0B;YAC1B,SAAS,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;YAC9B,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,IAAI,SAAS,CAClB,MAAM,CAAC,KAAK,CAAC,EACb,IAAI,EACJ,GAAG,CACJ,CAAC;IACJ,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,SAwDX;AAxDD,WAAY,SAAS;IACnB,iBAAiB;IACjB,4CAA+B,CAAA;IAC/B,8CAAiC,CAAA;IACjC,4CAA+B,CAAA;IAC/B,8CAAiC,CAAA;IACjC,gDAAmC,CAAA;IAEnC,oBAAoB;IACpB,oDAAuC,CAAA;IACvC,sDAAyC,CAAA;IACzC,oDAAuC,CAAA;IACvC,4DAA+C,CAAA;IAE/C,gBAAgB;IAChB,0DAA6C,CAAA;IAC7C,kEAAqD,CAAA;IACrD,4DAA+C,CAAA;IAC/C,8CAAiC,CAAA;IAEjC,cAAc;IACd,8CAAiC,CAAA;IACjC,gEAAmD,CAAA;IACnD,8DAAiD,CAAA;IACjD,8DAAiD,CAAA;IACjD,0CAA6B,CAAA;IAE7B,iBAAiB;IACjB,oDAAuC,CAAA;IACvC,wDAA2C,CAAA;IAC3C,sDAAyC,CAAA;IACzC,8DAAiD,CAAA;IACjD,kEAAqD,CAAA;IACrD,gDAAmC,CAAA;IACnC,4DAA+C,CAAA;IAE/C,eAAe;IACf,oEAAuD,CAAA;IACvD,0DAA6C,CAAA;IAC7C,4DAA+C,CAAA;IAE/C,mBAAmB;IACnB,gEAAmD,CAAA;IACnD,wEAA2D,CAAA;IAC3D,4DAA+C,CAAA;IAE/C,eAAe;IACf,0DAA6C,CAAA;IAC7C,0DAA6C,CAAA;IAC7C,wDAA2C,CAAA;IAE3C,oBAAoB;IACpB,kEAAqD,CAAA;IACrD,gFAAmE,CAAA;IACnE,8DAAiD,CAAA;IACjD,kEAAqD,CAAA;AACvD,CAAC,EAxDW,SAAS,KAAT,SAAS,QAwDpB;AAoED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,KAAK,YAAY,SAAS,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,OAAO,KAAK,YAAY,KAAK,CAAC;AAChC,CAAC;AASD;;GAEG;AACH,MAAM,UAAU,OAAO,CAAI,IAAO;IAChC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAgB,KAAQ;IAC7C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AACnC,CAAC"}

package/dist/types/events.d.ts

@@ -0,0 +1,210 @@
+/**
+ * Event Types
+ *
+ * Type definitions for the KADI event system.
+ * Events enable pub/sub communication between agents and abilities.
+ */
+/**
+ * Event pattern string for subscription matching.
+ *
+ * Supports wildcards:
+ * - `user.login` - exact match
+ * - `user.*` - all events starting with "user."
+ * - `*.error` - all error events
+ * - `*` - all events
+ *
+ * @example
+ * ```typescript
+ * const pattern: EventPattern = 'user.*';
+ * ```
+ */
+export type EventPattern = string;
+/**
+ * Event name/channel identifier
+ *
+ * @example
+ * ```typescript
+ * const eventName: EventName = 'user.login';
+ * ```
+ */
+export type EventName = string;
+/**
+ * Event callback function type.
+ *
+ * @template TData - The type of data the event carries
+ *
+ * @param data - The event data payload
+ * @returns void or Promise<void>
+ *
+ * @example
+ * ```typescript
+ * const handler: EventCallback<{ userId: string }> =
+ *   async (data) => {
+ *     console.log('User logged in:', data.userId);
+ *   };
+ * ```
+ */
+export type EventCallback<TData = unknown> = (data: TData) => void | Promise<void>;
+/**
+ * Event payload structure.
+ *
+ * This is the complete event object that flows through the system.
+ */
+export interface EventPayload<TData = unknown> {
+    /**
+     * Event name/channel
+     */
+    eventName: EventName;
+    /**
+     * Event data
+     */
+    data: TData;
+    /**
+     * When the event was emitted (Unix timestamp in ms)
+     */
+    timestamp: number;
+    /**
+     * Source agent/ability that emitted the event
+     */
+    source: string;
+    /**
+     * Optional metadata
+     */
+    metadata?: EventMetadata;
+}
+/**
+ * Additional event metadata
+ */
+export interface EventMetadata {
+    /**
+     * Event correlation ID for tracking related events
+     */
+    correlationId?: string;
+    /**
+     * Event sequence number (for ordered processing)
+     */
+    sequenceNumber?: number;
+    /**
+     * Time-to-live in milliseconds (for ephemeral events)
+     */
+    ttl?: number;
+    /**
+     * Priority level (higher = more important)
+     */
+    priority?: number;
+    /**
+     * Custom metadata
+     */
+    [key: string]: unknown;
+}
+/**
+ * Event subscription record.
+ *
+ * Internal representation of an active subscription.
+ */
+export interface EventSubscription<TData = unknown> {
+    /**
+     * Unique subscription ID
+     */
+    id: string;
+    /**
+     * Pattern this subscription matches
+     */
+    pattern: EventPattern;
+    /**
+     * Callback function
+     */
+    callback: EventCallback<TData>;
+    /**
+     * When the subscription was created
+     */
+    createdAt: number;
+    /**
+     * Subscription options
+     */
+    options?: SubscriptionOptions;
+    /**
+     * Internal counter for maxEvents tracking
+     * Incremented each time the callback is invoked
+     */
+    _eventCount?: number;
+}
+/**
+ * Options for event subscriptions
+ */
+export interface SubscriptionOptions {
+    /**
+     * Only receive the latest event if multiple match (coalescence)
+     */
+    latestOnly?: boolean;
+    /**
+     * Filter function to selectively receive events
+     */
+    filter?: (payload: EventPayload) => boolean;
+    /**
+     * Maximum number of events to receive before auto-unsubscribing
+     */
+    maxEvents?: number;
+    /**
+     * Auto-unsubscribe after this many milliseconds
+     */
+    timeout?: number;
+}
+/**
+ * Unsubscribe function returned from subscriptions
+ *
+ * @example
+ * ```typescript
+ * const unsubscribe = eventHub.subscribe('user.*', handler);
+ * // Later...
+ * unsubscribe();
+ * ```
+ */
+export type UnsubscribeFunction = () => void;
+/**
+ * Event publishing options/hints
+ */
+export interface PublishOptions {
+    /**
+     * Only keep the latest event in queue (for high-frequency events)
+     */
+    latestOnly?: boolean;
+    /**
+     * Coalescing key - events with same key replace each other
+     */
+    coalescingKey?: string;
+    /**
+     * Time-to-live in milliseconds
+     */
+    ttl?: number;
+    /**
+     * Priority (higher = delivered first)
+     */
+    priority?: number;
+    /**
+     * Correlation ID for tracking related events
+     */
+    correlationId?: string;
+}
+/**
+ * Event delivery status
+ */
+export interface EventDeliveryStatus {
+    /**
+     * Event that was delivered
+     */
+    event: EventPayload;
+    /**
+     * Number of subscribers that received it
+     */
+    delivered: number;
+    /**
+     * Number of delivery failures
+     */
+    failed: number;
+    /**
+     * Delivery timestamp
+     */
+    timestamp: number;
+}
+//# sourceMappingURL=events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/types/events.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAElC;;;;;;;GAOG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAE/B;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,aAAa,CAAC,KAAK,GAAG,OAAO,IAAI,CAC3C,IAAI,EAAE,KAAK,KACR,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B;;;;GAIG;AACH,MAAM,WAAW,YAAY,CAAC,KAAK,GAAG,OAAO;IAC3C;;OAEG;IACH,SAAS,EAAE,SAAS,CAAC;IAErB;;OAEG;IACH,IAAI,EAAE,KAAK,CAAC;IAEZ;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB,CAAC,KAAK,GAAG,OAAO;IAChD;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,OAAO,EAAE,YAAY,CAAC;IAEtB;;OAEG;IACH,QAAQ,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;IAE/B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAE9B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC;IAE5C;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,IAAI,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,KAAK,EAAE,YAAY,CAAC;IAEpB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/types/events.js

@@ -0,0 +1,8 @@
+/**
+ * Event Types
+ *
+ * Type definitions for the KADI event system.
+ * Events enable pub/sub communication between agents and abilities.
+ */
+export {};
+//# sourceMappingURL=events.js.map

package/dist/types/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/types/events.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/types/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * KADI Core Types
+ *
+ * Central export point for all type definitions.
+ * This file provides a single import location for all KADI types.
+ *
+ * @example
+ * ```typescript
+ * import type {
+ *   KadiClientConfig,
+ *   ToolHandler,
+ *   EventCallback
+ * } from '@kadi.build/core/types';
+ * ```
+ */
+/**
+ * JSON Schema type (generic object representation)
+ *
+ * Represents a JSON Schema object. Use this for generic schema handling.
+ */
+export type JSONSchema = Record<string, unknown>;
+export type { KadiTool, KadiToolResult, ToolDefinition, ToolHandler, RegisteredTool, ToolTag, NetworkId, ToolDiscoveryQuery, ToolDiscoveryResult, ToolInvocationResult, McpTool, McpCallToolResult, ToolAnnotations, ListToolsRequest, ListToolsResult, CallToolRequest, ToolListChangedNotification } from './tools.js';
+export type { EventPattern, EventName, EventCallback, EventPayload, EventMetadata, EventSubscription, UnsubscribeFunction, PublishOptions, EventDeliveryStatus, SubscriptionOptions } from './events.js';
+export type { BrokerConnection, BrokerConfig, JsonRpcRequest, JsonRpcResponse, JsonRpcError, JsonRpcNotification, HandshakeParams, HandshakeResult, RegisterCapabilitiesParams, ToolInvokeParams, EventSubscribeParams, EventPublishParams, PendingRequest } from './broker.js';
+export { ConnectionState, KadiProtocolMethod } from './broker.js';
+export type { TransportKind, AgentRole, KadiClientConfig, AdvancedConfig, KadiConfig, ServiceConfig, LoadAbilityOptions, AgentJsonConfig, EnvConfig, ResolvedConfig } from './config.js';
+export { ConfigSource } from './config.js';
+export type { AbilityTransport, MethodSchema, TransportOptions, NativeTransportOptions, StdioTransportOptions, BrokerTransportOptions, MessageTransport, TransportDiscoveryResult, StdioFrame } from './transport.js';
+export { StdioMessageType } from './transport.js';
+export { KadiError, ErrorCode, isKadiError, isError, success, failure } from './errors.js';
+export type { ErrorContext, ErrorJSON, Result } from './errors.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAGjD,YAAY,EAEV,QAAQ,EACR,cAAc,EACd,cAAc,EACd,WAAW,EACX,cAAc,EACd,OAAO,EACP,SAAS,EACT,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EAGpB,OAAO,EACP,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,2BAA2B,EAC5B,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,YAAY,EACZ,SAAS,EACT,aAAa,EACb,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,0BAA0B,EAC1B,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACf,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGlE,YAAY,EACV,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,SAAS,EACT,cAAc,EACf,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,EAChB,wBAAwB,EACxB,UAAU,EACX,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGlD,OAAO,EACL,SAAS,EACT,SAAS,EACT,WAAW,EACX,OAAO,EACP,OAAO,EACP,OAAO,EACR,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,YAAY,EACZ,SAAS,EACT,MAAM,EACP,MAAM,aAAa,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,21 @@
+/**
+ * KADI Core Types
+ *
+ * Central export point for all type definitions.
+ * This file provides a single import location for all KADI types.
+ *
+ * @example
+ * ```typescript
+ * import type {
+ *   KadiClientConfig,
+ *   ToolHandler,
+ *   EventCallback
+ * } from '@kadi.build/core/types';
+ * ```
+ */
+export { ConnectionState, KadiProtocolMethod } from './broker.js';
+export { ConfigSource } from './config.js';
+export { StdioMessageType } from './transport.js';
+// Error types
+export { KadiError, ErrorCode, isKadiError, isError, success, failure } from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAgEH,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAgBlE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAe3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,cAAc;AACd,OAAO,EACL,SAAS,EACT,SAAS,EACT,WAAW,EACX,OAAO,EACP,OAAO,EACP,OAAO,EACR,MAAM,aAAa,CAAC"}