@mxf-dev/core 1.0.0

package/dist/events/event-definitions/ChannelEvents.d.ts

@@ -0,0 +1,197 @@
+/**
+ * Copyright 2024 Brad Anderson
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @author Brad Anderson <BradA1878@pm.me>
+ * @repository https://github.com/mxf-dev/mxf
+ * @documentation https://mxf-dev.github.io/mxf/
+ */
+import { ChannelCreationEventData, ContextGetEventData, ContextGotEventData, ContextGetFailedEventData, ContextUpdateEventData, ContextUpdatedEventData, ContextUpdateFailedEventData, MetadataSetEventData, MetadataSetSuccessEventData, MetadataSetFailedEventData, MetadataGetEventData, MetadataGotEventData, MetadataGetFailedEventData, TopicsExtractEventData, TopicsExtractedEventData, TopicsExtractFailedEventData, SummaryGenerateEventData, SummaryGeneratedEventData, SummaryGenerateFailedEventData } from '../../schemas/EventPayloadSchema.js';
+/**
+ * Type definition for channel creation events imported from EventPayloadSchema
+ * @deprecated BACKWARD-COMPATIBILITY: Import from src/shared/schemas/EventPayloadSchema.ts instead
+ * This type alias is maintained for backward compatibility and will be removed in a future release
+ */
+export type ChannelCreationEvent = ChannelCreationEventData;
+/**
+ * Channel action types enum
+ */
+export declare const ChannelActionTypes: {
+    readonly CREATE: "create";
+    readonly JOIN: "join";
+    readonly LEAVE: "leave";
+    readonly UPDATE: "update";
+    readonly DELETE: "delete";
+    readonly GET_CONTEXT: "get_context";
+    readonly UPDATE_CONTEXT: "update_context";
+    readonly SET_METADATA: "set_metadata";
+    readonly GET_METADATA: "get_metadata";
+    readonly MESSAGE_POSTED: "message_posted";
+    readonly ERROR: "error";
+};
+/**
+ * Type for channel action types
+ */
+export type ChannelActionType = typeof ChannelActionTypes[keyof typeof ChannelActionTypes];
+/**
+ * Events related to channels
+ */
+export declare const Events: {
+    CREATE: string;
+    CREATED: string;
+    CREATION_FAILED: string;
+    UPDATE: string;
+    UPDATED: string;
+    UPDATE_FAILED: string;
+    DELETE: string;
+    DELETED: string;
+    DELETE_FAILED: string;
+    ARCHIVE: string;
+    ARCHIVED: string;
+    ARCHIVE_FAILED: string;
+    AGENT_JOINED: string;
+    AGENT_LEFT: string;
+    CONTEXT: {
+        GET: string;
+        GOT: string;
+        GET_FAILED: string;
+        UPDATE: string;
+        UPDATED: string;
+        UPDATE_FAILED: string;
+        METADATA_SET: string;
+        METADATA_SET_SUCCESS: string;
+        METADATA_SET_FAILED: string;
+        METADATA_GET: string;
+        METADATA_GOT: string;
+        METADATA_GET_FAILED: string;
+        TOPICS_EXTRACT: string;
+        TOPICS_EXTRACTED: string;
+        TOPICS_EXTRACT_FAILED: string;
+        SUMMARY_GENERATE: string;
+        SUMMARY_GENERATED: string;
+        SUMMARY_GENERATE_FAILED: string;
+    };
+    BULK_MESSAGES_PERSISTED: string;
+};
+/**
+ * Channel context operation payload types
+ * Using type aliases to EventPayloadSchema.ts definitions
+ *
+ * @deprecated BACKWARD-COMPATIBILITY: All these types should be imported directly from src/shared/schemas/EventPayloadSchema.ts
+ * These type aliases are maintained for backward compatibility and will be removed in a future release
+ * Used by: src/server/services/ChannelContextService.ts
+ */
+export type ContextGetPayload = ContextGetEventData;
+export type ContextGotPayload = ContextGotEventData;
+export type ContextGetFailedPayload = ContextGetFailedEventData;
+export type ContextUpdatePayload = ContextUpdateEventData;
+export type ContextUpdatedPayload = ContextUpdatedEventData;
+export type ContextUpdateFailedPayload = ContextUpdateFailedEventData;
+export type MetadataSetPayload = MetadataSetEventData;
+export type MetadataSetSuccessPayload = MetadataSetSuccessEventData;
+export type MetadataSetFailedPayload = MetadataSetFailedEventData;
+export type MetadataGetPayload = MetadataGetEventData;
+export type MetadataGotPayload = MetadataGotEventData;
+export type MetadataGetFailedPayload = MetadataGetFailedEventData;
+export type TopicsExtractPayload = TopicsExtractEventData;
+export type TopicsExtractedPayload = TopicsExtractedEventData;
+export type TopicsExtractFailedPayload = TopicsExtractFailedEventData;
+export type SummaryGeneratePayload = SummaryGenerateEventData;
+export type SummaryGeneratedPayload = SummaryGeneratedEventData;
+export type SummaryGenerateFailedPayload = SummaryGenerateFailedEventData;
+/**
+ * Payload types for Channel events
+ */
+export interface ChannelPayloads {
+    'channel:create': {
+        name: string;
+        metadata?: Record<string, any>;
+    };
+    'channel:created': {
+        channelId: string;
+        name: string;
+    };
+    'channel:creation:failed': {
+        error: string;
+    };
+    'channel:update': {
+        channelId: string;
+        name?: string;
+        metadata?: Record<string, any>;
+    };
+    'channel:updated': {
+        channelId: string;
+    };
+    'channel:update:failed': {
+        channelId: string;
+        error: string;
+    };
+    'channel:delete': {
+        channelId: string;
+        reason?: string;
+    };
+    'channel:deleted': {
+        channelId: string;
+    };
+    'channel:delete:failed': {
+        channelId: string;
+        error: string;
+    };
+    'channel:archive': {
+        channelId: string;
+        reason?: string;
+    };
+    'channel:archived': {
+        channelId: string;
+        metadata?: Record<string, any>;
+    };
+    'channel:archive:failed': {
+        channelId: string;
+        error: string;
+    };
+    'channel:agent:joined': {
+        channelId: string;
+        agentId: string;
+    };
+    'channel:agent:left': {
+        channelId: string;
+        agentId: string;
+        data?: {
+            remainingAgents?: number;
+        };
+    };
+    'channel:context:get': ContextGetPayload;
+    'channel:context:got': ContextGotPayload;
+    'channel:context:get:failed': ContextGetFailedPayload;
+    'channel:context:update': ContextUpdatePayload;
+    'channel:context:updated': ContextUpdatedPayload;
+    'channel:context:update:failed': ContextUpdateFailedPayload;
+    'channel:context:metadata:set': MetadataSetPayload;
+    'channel:context:metadata:set:success': MetadataSetSuccessPayload;
+    'channel:context:metadata:set:failed': MetadataSetFailedPayload;
+    'channel:context:metadata:get': MetadataGetPayload;
+    'channel:context:metadata:got': MetadataGotPayload;
+    'channel:context:metadata:get:failed': MetadataGetFailedPayload;
+    'channel:context:topics:extract': TopicsExtractPayload;
+    'channel:context:topics:extracted': TopicsExtractedPayload;
+    'channel:context:topics:extract:failed': TopicsExtractFailedPayload;
+    'channel:context:summary:generate': SummaryGeneratePayload;
+    'channel:context:summary:generated': SummaryGeneratedPayload;
+    'channel:context:summary:generate:failed': SummaryGenerateFailedPayload;
+    'channel:bulk:messages:persisted': {
+        channelId: string;
+        messageIds: string[];
+    };
+}
+//# sourceMappingURL=ChannelEvents.d.ts.map

package/dist/events/event-definitions/ChannelEvents.d.ts.map

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

package/dist/events/event-definitions/ChannelEvents.js

@@ -0,0 +1,82 @@
+/**
+ * Copyright 2024 Brad Anderson
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @author Brad Anderson <BradA1878@pm.me>
+ * @repository https://github.com/mxf-dev/mxf
+ * @documentation https://mxf-dev.github.io/mxf/
+ */
+/**
+ * Channel action types enum
+ */
+export const ChannelActionTypes = {
+    CREATE: 'create',
+    JOIN: 'join',
+    LEAVE: 'leave',
+    UPDATE: 'update',
+    DELETE: 'delete',
+    GET_CONTEXT: 'get_context',
+    UPDATE_CONTEXT: 'update_context',
+    SET_METADATA: 'set_metadata',
+    GET_METADATA: 'get_metadata',
+    MESSAGE_POSTED: 'message_posted',
+    ERROR: 'error'
+};
+/**
+ * Events related to channels
+ */
+export const Events = {
+    // Channel creation
+    CREATE: 'channel:create', // Create a new channel
+    CREATED: 'channel:created', // Channel has been created
+    CREATION_FAILED: 'channel:creation:failed', // Channel creation failed
+    // Channel updates
+    UPDATE: 'channel:update', // Update a channel
+    UPDATED: 'channel:updated', // Channel has been updated
+    UPDATE_FAILED: 'channel:update:failed', // Channel update failed
+    // Channel deletion and archival
+    DELETE: 'channel:delete', // Delete a channel
+    DELETED: 'channel:deleted', // Channel has been deleted
+    DELETE_FAILED: 'channel:delete:failed', // Channel deletion failed
+    ARCHIVE: 'channel:archive', // Archive a channel
+    ARCHIVED: 'channel:archived', // Channel has been archived
+    ARCHIVE_FAILED: 'channel:archive:failed', // Channel archival failed
+    // Agent events within channels
+    AGENT_JOINED: 'channel:agent:joined', // Agent joined the channel
+    AGENT_LEFT: 'channel:agent:left', // Agent left the channel
+    // Channel context operations
+    CONTEXT: {
+        GET: 'channel:context:get', // Get channel context
+        GOT: 'channel:context:got', // Channel context retrieved
+        GET_FAILED: 'channel:context:get:failed', // Failed to get channel context
+        UPDATE: 'channel:context:update', // Update channel context
+        UPDATED: 'channel:context:updated', // Channel context updated
+        UPDATE_FAILED: 'channel:context:update:failed', // Failed to update channel context
+        METADATA_SET: 'channel:context:metadata:set', // Set channel metadata
+        METADATA_SET_SUCCESS: 'channel:context:metadata:set:success', // Channel metadata set successfully
+        METADATA_SET_FAILED: 'channel:context:metadata:set:failed', // Failed to set channel metadata
+        METADATA_GET: 'channel:context:metadata:get', // Get channel metadata
+        METADATA_GOT: 'channel:context:metadata:got', // Channel metadata retrieved
+        METADATA_GET_FAILED: 'channel:context:metadata:get:failed', // Failed to get channel metadata
+        TOPICS_EXTRACT: 'channel:context:topics:extract', // Extract topics from channel conversation
+        TOPICS_EXTRACTED: 'channel:context:topics:extracted', // Topics extracted from channel conversation
+        TOPICS_EXTRACT_FAILED: 'channel:context:topics:extract:failed', // Failed to extract topics
+        SUMMARY_GENERATE: 'channel:context:summary:generate', // Generate channel conversation summary
+        SUMMARY_GENERATED: 'channel:context:summary:generated', // Channel summary generated
+        SUMMARY_GENERATE_FAILED: 'channel:context:summary:generate:failed' // Failed to generate summary
+    },
+    // Bulk message operations
+    BULK_MESSAGES_PERSISTED: 'channel:bulk:messages:persisted' // Bulk messages have been persisted
+};
+//# sourceMappingURL=ChannelEvents.js.map

package/dist/events/event-definitions/ChannelEvents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChannelEvents.js","sourceRoot":"","sources":["../../../src/events/event-definitions/ChannelEvents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAiDH;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAC9B,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,WAAW,EAAE,aAAa;IAC1B,cAAc,EAAE,gBAAgB;IAChC,YAAY,EAAE,cAAc;IAC5B,YAAY,EAAE,cAAc;IAC5B,cAAc,EAAE,gBAAgB;IAChC,KAAK,EAAE,OAAO;CACR,CAAC;AAOX;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IAClB,mBAAmB;IACnB,MAAM,EAAE,gBAAgB,EAAE,uBAAuB;IACjD,OAAO,EAAE,iBAAiB,EAAE,2BAA2B;IACvD,eAAe,EAAE,yBAAyB,EAAE,0BAA0B;IAEtE,kBAAkB;IAClB,MAAM,EAAE,gBAAgB,EAAE,mBAAmB;IAC7C,OAAO,EAAE,iBAAiB,EAAE,2BAA2B;IACvD,aAAa,EAAE,uBAAuB,EAAE,wBAAwB;IAEhE,gCAAgC;IAChC,MAAM,EAAE,gBAAgB,EAAE,mBAAmB;IAC7C,OAAO,EAAE,iBAAiB,EAAE,2BAA2B;IACvD,aAAa,EAAE,uBAAuB,EAAE,0BAA0B;IAElE,OAAO,EAAE,iBAAiB,EAAE,oBAAoB;IAChD,QAAQ,EAAE,kBAAkB,EAAE,4BAA4B;IAC1D,cAAc,EAAE,wBAAwB,EAAE,0BAA0B;IAEpE,+BAA+B;IAC/B,YAAY,EAAE,sBAAsB,EAAE,2BAA2B;IACjE,UAAU,EAAE,oBAAoB,EAAE,yBAAyB;IAE3D,6BAA6B;IAC7B,OAAO,EAAE;QACL,GAAG,EAAE,qBAAqB,EAAE,sBAAsB;QAClD,GAAG,EAAE,qBAAqB,EAAE,4BAA4B;QACxD,UAAU,EAAE,4BAA4B,EAAE,gCAAgC;QAE1E,MAAM,EAAE,wBAAwB,EAAE,yBAAyB;QAC3D,OAAO,EAAE,yBAAyB,EAAE,0BAA0B;QAC9D,aAAa,EAAE,+BAA+B,EAAE,mCAAmC;QAEnF,YAAY,EAAE,8BAA8B,EAAE,uBAAuB;QACrE,oBAAoB,EAAE,sCAAsC,EAAE,oCAAoC;QAClG,mBAAmB,EAAE,qCAAqC,EAAE,iCAAiC;QAE7F,YAAY,EAAE,8BAA8B,EAAE,uBAAuB;QACrE,YAAY,EAAE,8BAA8B,EAAE,6BAA6B;QAC3E,mBAAmB,EAAE,qCAAqC,EAAE,iCAAiC;QAE7F,cAAc,EAAE,gCAAgC,EAAE,2CAA2C;QAC7F,gBAAgB,EAAE,kCAAkC,EAAE,6CAA6C;QACnG,qBAAqB,EAAE,uCAAuC,EAAE,2BAA2B;QAE3F,gBAAgB,EAAE,kCAAkC,EAAE,wCAAwC;QAC9F,iBAAiB,EAAE,mCAAmC,EAAE,4BAA4B;QACpF,uBAAuB,EAAE,yCAAyC,CAAC,6BAA6B;KACnG;IAED,0BAA0B;IAC1B,uBAAuB,EAAE,iCAAiC,CAAC,oCAAoC;CAClG,CAAC"}

package/dist/events/event-definitions/CodeExecutionEvents.d.ts

@@ -0,0 +1,263 @@
+/**
+ * Copyright 2024 Brad Anderson
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @author Brad Anderson <BradA1878@pm.me>
+ * @repository https://github.com/mxf-dev/mxf
+ * @documentation https://mxf-dev.github.io/mxf/
+ */
+/**
+ * CodeExecutionEvents.ts
+ *
+ * Event definitions for code execution operations in the sandbox.
+ * These events track code execution lifecycle, performance, and security.
+ */
+import { AgentId, ChannelId } from '../../types/ChannelContext.js';
+/**
+ * Code execution event constants
+ */
+export declare const CodeExecutionEvents: {
+    /** Code execution started */
+    readonly CODE_EXECUTION_STARTED: "code:execution:started";
+    /** Code execution completed successfully */
+    readonly CODE_EXECUTION_COMPLETED: "code:execution:completed";
+    /** Code execution failed */
+    readonly CODE_EXECUTION_FAILED: "code:execution:failed";
+    /** Code validation started */
+    readonly CODE_VALIDATION_STARTED: "code:validation:started";
+    /** Code validation completed */
+    readonly CODE_VALIDATION_COMPLETED: "code:validation:completed";
+    /** Security issue detected in code */
+    readonly CODE_SECURITY_ISSUE: "code:security:issue";
+    /** Resource limit exceeded during execution */
+    readonly CODE_RESOURCE_LIMIT_EXCEEDED: "code:resource:limit:exceeded";
+    /** Code execution timeout */
+    readonly CODE_EXECUTION_TIMEOUT: "code:execution:timeout";
+};
+/**
+ * Execution language enum
+ */
+export type ExecutionLanguage = 'javascript' | 'typescript';
+/**
+ * Code execution started event payload
+ */
+export interface CodeExecutionStartedPayload {
+    /** Event type */
+    eventType: typeof CodeExecutionEvents.CODE_EXECUTION_STARTED;
+    /** Agent executing the code */
+    agentId: AgentId;
+    /** Channel context */
+    channelId: ChannelId;
+    /** Unique request identifier */
+    requestId: string;
+    /** Execution language */
+    language: ExecutionLanguage;
+    /** Code hash for tracking */
+    codeHash: string;
+    /** Code length in characters */
+    codeLength: number;
+    /** Execution timeout setting */
+    timeout: number;
+    /** Start timestamp */
+    timestamp: number;
+}
+/**
+ * Code execution completed event payload
+ */
+export interface CodeExecutionCompletedPayload {
+    /** Event type */
+    eventType: typeof CodeExecutionEvents.CODE_EXECUTION_COMPLETED;
+    /** Agent executing the code */
+    agentId: AgentId;
+    /** Channel context */
+    channelId: ChannelId;
+    /** Unique request identifier */
+    requestId: string;
+    /** Execution language */
+    language: ExecutionLanguage;
+    /** Code hash for tracking */
+    codeHash: string;
+    /** Execution time in milliseconds */
+    executionTime: number;
+    /** Output size in characters */
+    outputSize: number;
+    /** Number of console logs captured */
+    logCount: number;
+    /** Resource usage */
+    resourceUsage: {
+        /** Memory used in MB */
+        memory: number;
+        /** Whether timeout occurred */
+        timeout: boolean;
+    };
+    /** Completion timestamp */
+    timestamp: number;
+}
+/**
+ * Code execution failed event payload
+ */
+export interface CodeExecutionFailedPayload {
+    /** Event type */
+    eventType: typeof CodeExecutionEvents.CODE_EXECUTION_FAILED;
+    /** Agent executing the code */
+    agentId: AgentId;
+    /** Channel context */
+    channelId: ChannelId;
+    /** Unique request identifier */
+    requestId: string;
+    /** Execution language */
+    language: ExecutionLanguage;
+    /** Code hash for tracking */
+    codeHash: string;
+    /** Error message */
+    error: string;
+    /** Error type */
+    errorType: 'timeout' | 'validation' | 'runtime' | 'security' | 'resource_limit';
+    /** Execution time before failure */
+    executionTime: number;
+    /** Failure timestamp */
+    timestamp: number;
+}
+/**
+ * Code validation started event payload
+ */
+export interface CodeValidationStartedPayload {
+    /** Event type */
+    eventType: typeof CodeExecutionEvents.CODE_VALIDATION_STARTED;
+    /** Agent executing the code */
+    agentId: AgentId;
+    /** Channel context */
+    channelId: ChannelId;
+    /** Unique request identifier */
+    requestId: string;
+    /** Code hash for tracking */
+    codeHash: string;
+    /** Start timestamp */
+    timestamp: number;
+}
+/**
+ * Code validation completed event payload
+ */
+export interface CodeValidationCompletedPayload {
+    /** Event type */
+    eventType: typeof CodeExecutionEvents.CODE_VALIDATION_COMPLETED;
+    /** Agent executing the code */
+    agentId: AgentId;
+    /** Channel context */
+    channelId: ChannelId;
+    /** Unique request identifier */
+    requestId: string;
+    /** Code hash for tracking */
+    codeHash: string;
+    /** Whether validation passed */
+    safe: boolean;
+    /** Number of errors found */
+    errorCount: number;
+    /** Number of warnings found */
+    warningCount: number;
+    /** Validation time in milliseconds */
+    validationTime: number;
+    /** Completion timestamp */
+    timestamp: number;
+}
+/**
+ * Security issue detected event payload
+ */
+export interface CodeSecurityIssuePayload {
+    /** Event type */
+    eventType: typeof CodeExecutionEvents.CODE_SECURITY_ISSUE;
+    /** Agent executing the code */
+    agentId: AgentId;
+    /** Channel context */
+    channelId: ChannelId;
+    /** Unique request identifier */
+    requestId: string;
+    /** Code hash for tracking */
+    codeHash: string;
+    /** Security issue type */
+    issueType: 'dangerous_pattern' | 'unauthorized_access' | 'malicious_code';
+    /** Issue description */
+    description: string;
+    /** Severity level */
+    severity: 'low' | 'medium' | 'high' | 'critical';
+    /** Detected pattern (if applicable) */
+    pattern?: string;
+    /** Detection timestamp */
+    timestamp: number;
+}
+/**
+ * Resource limit exceeded event payload
+ */
+export interface CodeResourceLimitExceededPayload {
+    /** Event type */
+    eventType: typeof CodeExecutionEvents.CODE_RESOURCE_LIMIT_EXCEEDED;
+    /** Agent executing the code */
+    agentId: AgentId;
+    /** Channel context */
+    channelId: ChannelId;
+    /** Unique request identifier */
+    requestId: string;
+    /** Code hash for tracking */
+    codeHash: string;
+    /** Resource that exceeded limit */
+    resource: 'memory' | 'cpu' | 'time';
+    /** Limit value */
+    limit: number;
+    /** Actual value reached */
+    actual: number;
+    /** Execution time before limit exceeded */
+    executionTime: number;
+    /** Event timestamp */
+    timestamp: number;
+}
+/**
+ * Code execution timeout event payload
+ */
+export interface CodeExecutionTimeoutPayload {
+    /** Event type */
+    eventType: typeof CodeExecutionEvents.CODE_EXECUTION_TIMEOUT;
+    /** Agent executing the code */
+    agentId: AgentId;
+    /** Channel context */
+    channelId: ChannelId;
+    /** Unique request identifier */
+    requestId: string;
+    /** Code hash for tracking */
+    codeHash: string;
+    /** Timeout setting in milliseconds */
+    timeout: number;
+    /** Actual time before timeout */
+    actualTime: number;
+    /** Event timestamp */
+    timestamp: number;
+}
+/**
+ * Union type of all code execution event payloads
+ */
+export type CodeExecutionEventPayload = CodeExecutionStartedPayload | CodeExecutionCompletedPayload | CodeExecutionFailedPayload | CodeValidationStartedPayload | CodeValidationCompletedPayload | CodeSecurityIssuePayload | CodeResourceLimitExceededPayload | CodeExecutionTimeoutPayload;
+/**
+ * Code execution event payload map for type-safe event handling
+ */
+export interface CodeExecutionPayloads {
+    [CodeExecutionEvents.CODE_EXECUTION_STARTED]: CodeExecutionStartedPayload;
+    [CodeExecutionEvents.CODE_EXECUTION_COMPLETED]: CodeExecutionCompletedPayload;
+    [CodeExecutionEvents.CODE_EXECUTION_FAILED]: CodeExecutionFailedPayload;
+    [CodeExecutionEvents.CODE_VALIDATION_STARTED]: CodeValidationStartedPayload;
+    [CodeExecutionEvents.CODE_VALIDATION_COMPLETED]: CodeValidationCompletedPayload;
+    [CodeExecutionEvents.CODE_SECURITY_ISSUE]: CodeSecurityIssuePayload;
+    [CodeExecutionEvents.CODE_RESOURCE_LIMIT_EXCEEDED]: CodeResourceLimitExceededPayload;
+    [CodeExecutionEvents.CODE_EXECUTION_TIMEOUT]: CodeExecutionTimeoutPayload;
+}
+export type CodeExecutionEventType = keyof typeof CodeExecutionEvents;
+//# sourceMappingURL=CodeExecutionEvents.d.ts.map

package/dist/events/event-definitions/CodeExecutionEvents.d.ts.map

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

package/dist/events/event-definitions/CodeExecutionEvents.js

@@ -0,0 +1,41 @@
+/**
+ * Copyright 2024 Brad Anderson
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @author Brad Anderson <BradA1878@pm.me>
+ * @repository https://github.com/mxf-dev/mxf
+ * @documentation https://mxf-dev.github.io/mxf/
+ */
+/**
+ * Code execution event constants
+ */
+export const CodeExecutionEvents = {
+    /** Code execution started */
+    CODE_EXECUTION_STARTED: 'code:execution:started',
+    /** Code execution completed successfully */
+    CODE_EXECUTION_COMPLETED: 'code:execution:completed',
+    /** Code execution failed */
+    CODE_EXECUTION_FAILED: 'code:execution:failed',
+    /** Code validation started */
+    CODE_VALIDATION_STARTED: 'code:validation:started',
+    /** Code validation completed */
+    CODE_VALIDATION_COMPLETED: 'code:validation:completed',
+    /** Security issue detected in code */
+    CODE_SECURITY_ISSUE: 'code:security:issue',
+    /** Resource limit exceeded during execution */
+    CODE_RESOURCE_LIMIT_EXCEEDED: 'code:resource:limit:exceeded',
+    /** Code execution timeout */
+    CODE_EXECUTION_TIMEOUT: 'code:execution:timeout'
+};
+//# sourceMappingURL=CodeExecutionEvents.js.map

package/dist/events/event-definitions/CodeExecutionEvents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodeExecutionEvents.js","sourceRoot":"","sources":["../../../src/events/event-definitions/CodeExecutionEvents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAWH;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IAC/B,6BAA6B;IAC7B,sBAAsB,EAAE,wBAAwB;IAEhD,4CAA4C;IAC5C,wBAAwB,EAAE,0BAA0B;IAEpD,4BAA4B;IAC5B,qBAAqB,EAAE,uBAAuB;IAE9C,8BAA8B;IAC9B,uBAAuB,EAAE,yBAAyB;IAElD,gCAAgC;IAChC,yBAAyB,EAAE,2BAA2B;IAEtD,sCAAsC;IACtC,mBAAmB,EAAE,qBAAqB;IAE1C,+CAA+C;IAC/C,4BAA4B,EAAE,8BAA8B;IAE5D,6BAA6B;IAC7B,sBAAsB,EAAE,wBAAwB;CAC1C,CAAC"}