@mxf-dev/core 1.0.0

package/dist/schemas/MxpProtocolSchemas.js

@@ -0,0 +1,282 @@
+/**
+ * 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/
+ */
+/**
+ * MXP (Model Exchange Protocol) Schemas
+ *
+ * Defines the structure for efficient, encrypted agent-to-agent communication
+ * within the MXF framework. MXP reduces bandwidth and token usage while
+ * maintaining security through encryption.
+ */
+import { v4 as uuidv4 } from 'uuid';
+import { z } from 'zod';
+/**
+ * MXP Protocol Version
+ */
+export const MXP_VERSION = '2.0';
+/**
+ * Supported MXP message types
+ */
+export var MxpMessageType;
+(function (MxpMessageType) {
+    MxpMessageType["OPERATION"] = "operation";
+    MxpMessageType["REASONING"] = "reasoning";
+    MxpMessageType["COORDINATION"] = "coordination";
+    MxpMessageType["TASK"] = "task";
+    MxpMessageType["RESPONSE"] = "response"; // Responses to operations
+})(MxpMessageType || (MxpMessageType = {}));
+/**
+ * Encryption algorithms supported by MXP
+ */
+export var MxpEncryptionAlgorithm;
+(function (MxpEncryptionAlgorithm) {
+    MxpEncryptionAlgorithm["AES_256_GCM"] = "aes-256-gcm";
+    MxpEncryptionAlgorithm["NONE"] = "none"; // For development/debugging only
+})(MxpEncryptionAlgorithm || (MxpEncryptionAlgorithm = {}));
+/**
+ * Common MXP operations
+ */
+export var MxpOperation;
+(function (MxpOperation) {
+    // Calculation operations
+    MxpOperation["CALC_SUM"] = "calc.sum";
+    MxpOperation["CALC_AVERAGE"] = "calc.average";
+    MxpOperation["CALC_COMPARE"] = "calc.compare";
+    // Data operations
+    MxpOperation["DATA_FETCH"] = "data.fetch";
+    MxpOperation["DATA_STORE"] = "data.store";
+    MxpOperation["DATA_QUERY"] = "data.query";
+    // Tool operations
+    MxpOperation["TOOL_EXECUTE"] = "tool.execute";
+    MxpOperation["TOOL_CHAIN"] = "tool.chain";
+    // Coordination operations
+    MxpOperation["COORD_SYNC"] = "coord.sync";
+    MxpOperation["COORD_DELEGATE"] = "coord.delegate";
+    MxpOperation["COORD_STATUS"] = "coord.status";
+    // LLM Token Optimization Operations
+    // Collaboration operations
+    MxpOperation["COLLAB_INIT"] = "collab.init";
+    MxpOperation["COLLAB_PROPOSE"] = "collab.propose";
+    MxpOperation["COLLAB_ACCEPT"] = "collab.accept";
+    MxpOperation["COLLAB_COUNTER"] = "collab.counter";
+    MxpOperation["COLLAB_COMPLETE"] = "collab.complete";
+    // Task operations
+    MxpOperation["TASK_DELEGATE"] = "task.delegate";
+    MxpOperation["TASK_PROGRESS"] = "task.progress";
+    MxpOperation["TASK_COMPLETE"] = "task.complete";
+    MxpOperation["TASK_REQUEST"] = "task.request";
+    // State management operations
+    MxpOperation["STATE_UPDATE"] = "state.update";
+    MxpOperation["STATE_REFERENCE"] = "state.reference";
+    MxpOperation["STATE_SYNC"] = "state.sync";
+    MxpOperation["STATE_QUERY"] = "state.query";
+    // Decision operations
+    MxpOperation["DECISION_MADE"] = "decision.made";
+    MxpOperation["DECISION_REQUEST"] = "decision.request";
+    // Custom operation
+    MxpOperation["CUSTOM"] = "custom";
+})(MxpOperation || (MxpOperation = {}));
+/**
+ * MXP Payload Schema - The actual message content
+ */
+export const MxpPayloadSchema = z.object({
+    op: z.string().describe('Operation identifier'),
+    args: z.array(z.any()).optional().describe('Operation arguments'),
+    context: z.any().optional().describe('Additional context data'),
+    reasoning: z.string().optional().describe('Natural language reasoning for complex operations'),
+    metadata: z.object({
+        priority: z.number().min(0).max(10).default(5),
+        ttl: z.number().optional().describe('Time to live in milliseconds'),
+        correlationId: z.string().optional(),
+        requestId: z.string().optional()
+    }).optional()
+});
+/**
+ * Encrypted payload wrapper
+ */
+export const EncryptedPayloadSchema = z.object({
+    algorithm: z.nativeEnum(MxpEncryptionAlgorithm),
+    data: z.string().describe('Base64 encoded encrypted data'),
+    iv: z.string().describe('Initialization vector'),
+    authTag: z.string().describe('Authentication tag'),
+    keyId: z.string().optional().describe('Key identifier for key rotation')
+});
+/**
+ * Main MXP Message Schema
+ */
+export const MxpMessageSchema = z.object({
+    version: z.literal(MXP_VERSION),
+    type: z.nativeEnum(MxpMessageType),
+    encrypted: z.boolean(),
+    payload: z.union([MxpPayloadSchema, EncryptedPayloadSchema]),
+    // Message metadata
+    messageId: z.string(),
+    timestamp: z.number(),
+    senderId: z.string(),
+    receiverId: z.string().optional(),
+    channelId: z.string().optional(),
+    // Protocol negotiation
+    capabilities: z.array(z.string()).optional().describe('Supported MXP capabilities'),
+    fallbackFormat: z.enum(['natural-language', 'json']).optional()
+});
+/**
+ * MXP Capability flags for protocol negotiation
+ */
+export var MxpCapability;
+(function (MxpCapability) {
+    MxpCapability["ENCRYPTION"] = "encryption";
+    MxpCapability["COMPRESSION"] = "compression";
+    MxpCapability["BATCH_OPERATIONS"] = "batch-ops";
+    MxpCapability["CUSTOM_OPERATIONS"] = "custom-ops";
+    MxpCapability["NATURAL_LANGUAGE_FALLBACK"] = "nl-fallback";
+})(MxpCapability || (MxpCapability = {}));
+/**
+ * Helper to create an MXP message
+ */
+export function createMxpMessage(type, senderId, payload, options = {}) {
+    return {
+        version: MXP_VERSION,
+        type,
+        encrypted: options.encrypted ?? false,
+        payload,
+        messageId: options.messageId ?? generateMessageId(),
+        timestamp: Date.now(),
+        senderId,
+        receiverId: options.receiverId,
+        channelId: options.channelId,
+        capabilities: options.capabilities?.map(c => c.toString()),
+        fallbackFormat: 'natural-language'
+    };
+}
+/**
+ * Type guard to check if a message is MXP format
+ */
+export function isMxpMessage(message) {
+    try {
+        if (typeof message === 'string') {
+            // Try to parse if it's a JSON string
+            const parsed = JSON.parse(message);
+            return parsed.version === MXP_VERSION;
+        }
+        return message?.version === MXP_VERSION;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Type guard to check if payload is encrypted
+ */
+export function isEncryptedPayload(payload) {
+    return payload?.algorithm && payload?.data && payload?.iv;
+}
+/**
+ * Convert natural language to MXP operation (basic example)
+ */
+export function detectOperation(naturalLanguage) {
+    const text = naturalLanguage.toLowerCase();
+    // Pattern matching for LLM token optimization - detects collaboration patterns
+    const patterns = [
+        // Calculation operations
+        { pattern: /\b(sum|add|total)\b.*\b(of|up)\b/i, op: MxpOperation.CALC_SUM, confidence: 0.8 },
+        { pattern: /\b(average|mean)\b.*\b(of)\b/i, op: MxpOperation.CALC_AVERAGE, confidence: 0.8 },
+        { pattern: /\b(compare|versus|vs)\b/i, op: MxpOperation.CALC_COMPARE, confidence: 0.7 },
+        // Data operations
+        { pattern: /\b(fetch|get|retrieve)\b.*\b(data|information)\b/i, op: MxpOperation.DATA_FETCH, confidence: 0.7 },
+        { pattern: /\b(store|save|persist)\b/i, op: MxpOperation.DATA_STORE, confidence: 0.7 },
+        // Tool operations - High token savings
+        { pattern: /\b(use|execute|run)\b.*\btool\b/i, op: MxpOperation.TOOL_EXECUTE, confidence: 0.8 },
+        { pattern: /\b(call|invoke)\b.*\b(function|method)\b/i, op: MxpOperation.TOOL_EXECUTE, confidence: 0.7 },
+        // Collaboration operations - Major token reduction potential
+        { pattern: /\b(let's|let us)\b.*\b(work together|collaborate)\b/i, op: MxpOperation.COLLAB_INIT, confidence: 0.8 },
+        { pattern: /\b(propose|suggest|recommend)\b.*\b(we|us)\b/i, op: MxpOperation.COLLAB_PROPOSE, confidence: 0.8 },
+        { pattern: /\b(accept|agree|sounds good)\b/i, op: MxpOperation.COLLAB_ACCEPT, confidence: 0.7 },
+        { pattern: /\b(how about|what if|instead)\b/i, op: MxpOperation.COLLAB_COUNTER, confidence: 0.7 },
+        { pattern: /\b(done|finished|completed)\b.*\b(collaboration|working together)\b/i, op: MxpOperation.COLLAB_COMPLETE, confidence: 0.8 },
+        // Task operations - Significant token savings in delegation
+        { pattern: /\b(delegate|assign|hand off)\b.*\b(task|work)\b/i, op: MxpOperation.TASK_DELEGATE, confidence: 0.8 },
+        { pattern: /\b(progress|update|status)\b.*\b(on|of)\b.*\b(task|work)\b/i, op: MxpOperation.TASK_PROGRESS, confidence: 0.8 },
+        { pattern: /\b(task|work|assignment)\b.*\b(complete|done|finished)\b/i, op: MxpOperation.TASK_COMPLETE, confidence: 0.8 },
+        { pattern: /\b(need|require|request)\b.*\b(help|assistance|support)\b/i, op: MxpOperation.TASK_REQUEST, confidence: 0.7 },
+        // State management - Huge token savings by referencing vs retransmitting
+        { pattern: /\b(based on|referring to|as discussed)\b.*\b(earlier|before|previously)\b/i, op: MxpOperation.STATE_REFERENCE, confidence: 0.8 },
+        { pattern: /\b(update|modify|change)\b.*\b(state|status|information)\b/i, op: MxpOperation.STATE_UPDATE, confidence: 0.7 },
+        { pattern: /\b(sync|synchronize|align)\b.*\b(state|status)\b/i, op: MxpOperation.STATE_SYNC, confidence: 0.8 },
+        // Decision operations
+        { pattern: /\b(decided|determined|concluded)\b/i, op: MxpOperation.DECISION_MADE, confidence: 0.7 },
+        { pattern: /\b(need to decide|should we|what do you think)\b/i, op: MxpOperation.DECISION_REQUEST, confidence: 0.8 },
+        // Coordination operations
+        { pattern: /\b(coordinate|sync|align)\b/i, op: MxpOperation.COORD_SYNC, confidence: 0.6 }
+    ];
+    for (const { pattern, op, confidence } of patterns) {
+        if (pattern.test(text)) {
+            return { op, confidence };
+        }
+    }
+    return null;
+}
+/**
+ * Generate a unique message ID
+ */
+function generateMessageId() {
+    return `mxp_${uuidv4()}`;
+}
+/**
+ * Example MXP message creators for common operations
+ */
+export const MxpMessageCreators = {
+    /**
+     * Create a calculation operation message
+     */
+    calculation(senderId, operation, args, options) {
+        const opMap = {
+            sum: MxpOperation.CALC_SUM,
+            average: MxpOperation.CALC_AVERAGE,
+            compare: MxpOperation.CALC_COMPARE
+        };
+        return createMxpMessage(MxpMessageType.OPERATION, senderId, {
+            op: opMap[operation],
+            args,
+            metadata: { priority: 5 }
+        }, options);
+    },
+    /**
+     * Create a tool execution message
+     */
+    toolExecute(senderId, toolName, toolArgs, options) {
+        return createMxpMessage(MxpMessageType.OPERATION, senderId, {
+            op: MxpOperation.TOOL_EXECUTE,
+            args: [{ tool: toolName, input: toolArgs }],
+            reasoning: options?.reasoning,
+            metadata: { priority: 7 }
+        }, options);
+    },
+    /**
+     * Create a coordination sync message
+     */
+    coordinationSync(senderId, channelId, status, context) {
+        return createMxpMessage(MxpMessageType.COORDINATION, senderId, {
+            op: MxpOperation.COORD_SYNC,
+            args: [status],
+            context,
+            metadata: { priority: 8 }
+        }, { channelId });
+    }
+};
+//# sourceMappingURL=MxpProtocolSchemas.js.map

package/dist/schemas/MxpProtocolSchemas.js.map

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

package/dist/schemas/ShellExecutionEventPayloads.d.ts

@@ -0,0 +1,117 @@
+/**
+ * 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 { AgentId, ChannelId } from '../types/ChannelContext.js';
+import { BaseEventPayload } from './EventPayloadSchema.js';
+/**
+ * Creates a SHELL_EXECUTION_STARTED event payload
+ */
+export declare function createShellExecutionStartedPayload(agentId: AgentId, channelId: ChannelId, data: {
+    requestId: string;
+    command: string;
+    description?: string;
+    commandHash: string;
+    timeout: number;
+    classification: {
+        category: string;
+        isReadOnly: boolean;
+    };
+    warnings: string[];
+}): BaseEventPayload<any>;
+/**
+ * Creates a SHELL_EXECUTION_COMPLETED event payload
+ */
+export declare function createShellExecutionCompletedPayload(agentId: AgentId, channelId: ChannelId, data: {
+    requestId: string;
+    command: string;
+    exitCode: number;
+    exitCodeMeaning?: string;
+    isError: boolean;
+    executionTime: number;
+    outputSize: number;
+    outputTruncated: boolean;
+    persistedOutputId?: string;
+}): BaseEventPayload<any>;
+/**
+ * Creates a SHELL_EXECUTION_FAILED event payload
+ */
+export declare function createShellExecutionFailedPayload(agentId: AgentId, channelId: ChannelId, data: {
+    requestId: string;
+    command: string;
+    error: string;
+    exitCode: number;
+    executionTime: number;
+}): BaseEventPayload<any>;
+/**
+ * Creates a SHELL_EXECUTION_PROGRESS event payload
+ */
+export declare function createShellExecutionProgressPayload(agentId: AgentId, channelId: ChannelId, data: {
+    requestId: string;
+    taskId: string;
+    output: string;
+    fullOutputSize: number;
+    elapsedTimeSeconds: number;
+    totalLines: number;
+    totalBytes: number;
+}): BaseEventPayload<any>;
+/**
+ * Creates a SHELL_DESTRUCTIVE_WARNING event payload
+ */
+export declare function createShellDestructiveWarningPayload(agentId: AgentId, channelId: ChannelId, data: {
+    requestId: string;
+    command: string;
+    warnings: Array<{
+        warning: string;
+        severity: string;
+    }>;
+}): BaseEventPayload<any>;
+/**
+ * Creates a SHELL_BACKGROUND_STARTED event payload
+ */
+export declare function createShellBackgroundStartedPayload(agentId: AgentId, channelId: ChannelId, data: {
+    requestId: string;
+    taskId: string;
+    command: string;
+    description?: string;
+    timeout: number;
+}): BaseEventPayload<any>;
+/**
+ * Creates a SHELL_BACKGROUND_COMPLETED event payload
+ */
+export declare function createShellBackgroundCompletedPayload(agentId: AgentId, channelId: ChannelId, data: {
+    requestId: string;
+    taskId: string;
+    command: string;
+    exitCode: number;
+    isError: boolean;
+    executionTime: number;
+    outputSize: number;
+    persistedOutputId?: string;
+}): BaseEventPayload<any>;
+/**
+ * Creates a SHELL_OUTPUT_PERSISTED event payload
+ */
+export declare function createShellOutputPersistedPayload(agentId: AgentId, channelId: ChannelId, data: {
+    requestId: string;
+    outputId: string;
+    totalBytes: number;
+    totalLines: number;
+    command: string;
+}): BaseEventPayload<any>;
+//# sourceMappingURL=ShellExecutionEventPayloads.d.ts.map

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

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

package/dist/schemas/ShellExecutionEventPayloads.js

@@ -0,0 +1,165 @@
+/**
+ * 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/
+ */
+/**
+ * ShellExecutionEventPayloads.ts
+ *
+ * Helper functions for creating properly structured shell execution event payloads.
+ * All shell execution events must use these helpers to ensure compliance with
+ * the BaseEventPayload structure.
+ */
+import { v4 as uuidv4 } from 'uuid';
+import { ShellExecutionEvents } from '../events/event-definitions/ShellExecutionEvents.js';
+/**
+ * Creates a SHELL_EXECUTION_STARTED event payload
+ */
+export function createShellExecutionStartedPayload(agentId, channelId, data) {
+    return {
+        eventId: uuidv4(),
+        eventType: ShellExecutionEvents.SHELL_EXECUTION_STARTED,
+        timestamp: Date.now(),
+        agentId,
+        channelId,
+        source: 'ShellExecute',
+        data: {
+            ...data,
+            eventType: ShellExecutionEvents.SHELL_EXECUTION_STARTED
+        }
+    };
+}
+/**
+ * Creates a SHELL_EXECUTION_COMPLETED event payload
+ */
+export function createShellExecutionCompletedPayload(agentId, channelId, data) {
+    return {
+        eventId: uuidv4(),
+        eventType: ShellExecutionEvents.SHELL_EXECUTION_COMPLETED,
+        timestamp: Date.now(),
+        agentId,
+        channelId,
+        source: 'ShellExecute',
+        data: {
+            ...data,
+            eventType: ShellExecutionEvents.SHELL_EXECUTION_COMPLETED
+        }
+    };
+}
+/**
+ * Creates a SHELL_EXECUTION_FAILED event payload
+ */
+export function createShellExecutionFailedPayload(agentId, channelId, data) {
+    return {
+        eventId: uuidv4(),
+        eventType: ShellExecutionEvents.SHELL_EXECUTION_FAILED,
+        timestamp: Date.now(),
+        agentId,
+        channelId,
+        source: 'ShellExecute',
+        data: {
+            ...data,
+            eventType: ShellExecutionEvents.SHELL_EXECUTION_FAILED
+        }
+    };
+}
+/**
+ * Creates a SHELL_EXECUTION_PROGRESS event payload
+ */
+export function createShellExecutionProgressPayload(agentId, channelId, data) {
+    return {
+        eventId: uuidv4(),
+        eventType: ShellExecutionEvents.SHELL_EXECUTION_PROGRESS,
+        timestamp: Date.now(),
+        agentId,
+        channelId,
+        source: 'ShellExecute',
+        data: {
+            ...data,
+            eventType: ShellExecutionEvents.SHELL_EXECUTION_PROGRESS
+        }
+    };
+}
+/**
+ * Creates a SHELL_DESTRUCTIVE_WARNING event payload
+ */
+export function createShellDestructiveWarningPayload(agentId, channelId, data) {
+    return {
+        eventId: uuidv4(),
+        eventType: ShellExecutionEvents.SHELL_DESTRUCTIVE_WARNING,
+        timestamp: Date.now(),
+        agentId,
+        channelId,
+        source: 'ShellExecute',
+        data: {
+            ...data,
+            eventType: ShellExecutionEvents.SHELL_DESTRUCTIVE_WARNING
+        }
+    };
+}
+/**
+ * Creates a SHELL_BACKGROUND_STARTED event payload
+ */
+export function createShellBackgroundStartedPayload(agentId, channelId, data) {
+    return {
+        eventId: uuidv4(),
+        eventType: ShellExecutionEvents.SHELL_BACKGROUND_STARTED,
+        timestamp: Date.now(),
+        agentId,
+        channelId,
+        source: 'ShellExecute',
+        data: {
+            ...data,
+            eventType: ShellExecutionEvents.SHELL_BACKGROUND_STARTED
+        }
+    };
+}
+/**
+ * Creates a SHELL_BACKGROUND_COMPLETED event payload
+ */
+export function createShellBackgroundCompletedPayload(agentId, channelId, data) {
+    return {
+        eventId: uuidv4(),
+        eventType: ShellExecutionEvents.SHELL_BACKGROUND_COMPLETED,
+        timestamp: Date.now(),
+        agentId,
+        channelId,
+        source: 'ShellExecute',
+        data: {
+            ...data,
+            eventType: ShellExecutionEvents.SHELL_BACKGROUND_COMPLETED
+        }
+    };
+}
+/**
+ * Creates a SHELL_OUTPUT_PERSISTED event payload
+ */
+export function createShellOutputPersistedPayload(agentId, channelId, data) {
+    return {
+        eventId: uuidv4(),
+        eventType: ShellExecutionEvents.SHELL_OUTPUT_PERSISTED,
+        timestamp: Date.now(),
+        agentId,
+        channelId,
+        source: 'ShellExecute',
+        data: {
+            ...data,
+            eventType: ShellExecutionEvents.SHELL_OUTPUT_PERSISTED
+        }
+    };
+}
+//# sourceMappingURL=ShellExecutionEventPayloads.js.map

package/dist/schemas/ShellExecutionEventPayloads.js.map

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

package/dist/services/AgentPerformanceService.d.ts

@@ -0,0 +1,73 @@
+/**
+ * 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/
+ */
+/**
+ * Agent Performance Service for Enhanced Agent Intelligence
+ * Phase 2: Agent Performance Tracking and Optimization
+ *
+ * Simplified version that integrates with existing MXF services
+ */
+import { Observable } from 'rxjs';
+import { AgentId } from '../types/Agent.js';
+import { ChannelId } from '../types/ChannelContext.js';
+import { AgentPerformanceMetrics, AgentPerformanceAnalysis, PerformanceOptimizationSuggestion } from '../types/AgentPerformanceTypes.js';
+/**
+ * Simplified Agent Performance Service for within-channel performance tracking
+ */
+export declare class AgentPerformanceService {
+    private readonly logger;
+    private readonly memoryService;
+    private readonly performanceCache;
+    private readonly phaseStartTimes;
+    private readonly performanceUpdates$;
+    private constructor();
+    /**
+     * Get singleton instance
+     */
+    static getInstance(): AgentPerformanceService;
+    private static instance;
+    private setupEventListeners;
+    /**
+     * Get performance metrics for an agent in a channel
+     */
+    getPerformanceMetrics(agentId: AgentId, channelId: ChannelId): Promise<Observable<AgentPerformanceMetrics>>;
+    /**
+     * Analyze agent performance and provide insights (simplified)
+     */
+    analyzePerformance(agentId: AgentId, channelId: ChannelId): Promise<Observable<AgentPerformanceAnalysis>>;
+    /**
+     * Get performance optimization suggestions
+     */
+    getOptimizationSuggestions(agentId: AgentId, channelId: ChannelId): Promise<Observable<PerformanceOptimizationSuggestion[]>>;
+    private trackPhaseStart;
+    private trackPhaseTransition;
+    private updateOrparTiming;
+    private trackToolUsage;
+    private trackMessageActivity;
+    private createInitialMetrics;
+    private createSimplifiedAnalysis;
+    private updateRunningAverage;
+    private getPhaseAverage;
+    private storeMetrics;
+    /**
+     * Observable for performance updates
+     */
+    get performanceUpdates(): Observable<AgentPerformanceMetrics[]>;
+}
+//# sourceMappingURL=AgentPerformanceService.d.ts.map

package/dist/services/AgentPerformanceService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentPerformanceService.d.ts","sourceRoot":"","sources":["../../src/services/AgentPerformanceService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAmC,MAAM,MAAM,CAAC;AAInE,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EACH,uBAAuB,EAIvB,wBAAwB,EACxB,iCAAiC,EACpC,MAAM,mCAAmC,CAAC;AAK3C;;GAEG;AACH,qBAAa,uBAAuB;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAG9C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA8C;IAG/E,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA6B;IAG7D,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAsD;IAE1F,OAAO;IAOP;;OAEG;WACW,WAAW,IAAI,uBAAuB;IAOpD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA0B;IAMjD,OAAO,CAAC,mBAAmB;IAsC3B;;OAEG;IACU,qBAAqB,CAC9B,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,SAAS,GACrB,OAAO,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAC;IA0B/C;;OAEG;IACU,kBAAkB,CAC3B,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,SAAS,GACrB,OAAO,CAAC,UAAU,CAAC,wBAAwB,CAAC,CAAC;IA2BhD;;OAEG;IACU,0BAA0B,CACnC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,SAAS,GACrB,OAAO,CAAC,UAAU,CAAC,iCAAiC,EAAE,CAAC,CAAC;YAqB7C,eAAe;YAMf,oBAAoB;YAmBpB,iBAAiB;YAwDjB,cAAc;YAiDd,oBAAoB;IAkClC,OAAO,CAAC,oBAAoB;IAuH5B,OAAO,CAAC,wBAAwB;IA8EhC,OAAO,CAAC,oBAAoB;IAK5B,OAAO,CAAC,eAAe;YAWT,YAAY;IAqB1B;;OAEG;IACH,IAAW,kBAAkB,IAAI,UAAU,CAAC,uBAAuB,EAAE,CAAC,CAErE;CACJ"}