@mxf-dev/core 1.0.0

package/dist/types/PatternMemoryTypes.d.ts

@@ -0,0 +1,245 @@
+/**
+ * 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/
+ */
+/**
+ * Pattern Memory Types for Enhanced Memory Architecture
+ * Phase 2: Pattern Recognition and Workflow Optimization
+ */
+import { AgentId } from './Agent.js';
+import { ChannelId } from './ChannelContext.js';
+/**
+ * Extended memory layers for pattern recognition
+ */
+export declare enum MemoryLayer {
+    CHANNEL = "channel",// Existing: shared context for all agents
+    AGENT = "agent",// Existing: personal context per agent
+    PATTERN = "pattern",// New: successful interaction patterns within channel
+    WORKFLOW = "workflow"
+}
+/**
+ * Types of patterns that can be recognized and stored
+ */
+export type PatternType = 'orpar_sequence' | 'tool_chain' | 'collaboration_flow' | 'error_recovery';
+/**
+ * Pattern memory entry for successful workflows within channels
+ */
+export interface PatternMemoryEntry {
+    /** Unique pattern identifier */
+    patternId: string;
+    /** Channel where pattern was observed - patterns are channel-scoped */
+    channelId: ChannelId;
+    /** Type of pattern observed */
+    type: PatternType;
+    /** The actual pattern data */
+    pattern: {
+        /** Sequence of steps/actions in the pattern */
+        sequence: string[];
+        /** Conditions under which pattern was successful */
+        conditions: Record<string, any>;
+        /** Outcomes achieved by following this pattern */
+        outcomes: Record<string, any>;
+        /** Tools used in this pattern */
+        toolsUsed: string[];
+        /** Duration of pattern execution in milliseconds */
+        executionTime: number;
+        /** Pattern complexity score (1-10) */
+        complexity: number;
+    };
+    /** How effective this pattern has been (0.0-1.0) */
+    effectiveness: number;
+    /** Number of times this pattern has been used */
+    usageCount: number;
+    /** Number of times pattern was successful */
+    successCount: number;
+    /** Last time this pattern was used */
+    lastUsed: number;
+    /** When this pattern was first discovered */
+    firstDiscovered: number;
+    /** Agents who have participated in this pattern */
+    agentParticipants: AgentId[];
+    /** Similar patterns (by ID) for cross-referencing */
+    similarPatterns: string[];
+    /** Tags for pattern categorization */
+    tags: string[];
+    /** Pattern metadata for analysis */
+    metadata: {
+        /** Channel context when pattern was successful */
+        channelContext: string;
+        /** System state during successful executions */
+        systemState: Record<string, any>;
+        /** Performance metrics for this pattern */
+        performanceMetrics: {
+            averageExecutionTime: number;
+            minExecutionTime: number;
+            maxExecutionTime: number;
+            standardDeviation: number;
+        };
+        /** Confidence score for pattern recommendations (0.0-1.0) */
+        confidence: number;
+    };
+}
+/**
+ * Workflow memory entry for reusable ORPAR sequences
+ */
+export interface WorkflowMemoryEntry {
+    /** Unique workflow identifier */
+    workflowId: string;
+    /** Channel where workflow was created */
+    channelId: ChannelId;
+    /** Human-readable workflow name */
+    name: string;
+    /** Workflow description */
+    description: string;
+    /** ORPAR sequence definition */
+    orparSequence: {
+        /** Observation patterns */
+        observation: {
+            expectedInputs: string[];
+            dataCollection: string[];
+            contextRequirements: string[];
+        };
+        /** Reasoning patterns */
+        reasoning: {
+            analysisSteps: string[];
+            decisionCriteria: string[];
+            logicChain: string[];
+        };
+        /** Action patterns */
+        action: {
+            executionSteps: string[];
+            toolsRequired: string[];
+            dependencies: string[];
+        };
+        /** Planning patterns */
+        planning: {
+            planningSteps: string[];
+            resourceRequirements: string[];
+            timeEstimates: Record<string, number>;
+        };
+        /** Reflection patterns */
+        reflection: {
+            successCriteria: string[];
+            evaluationMetrics: string[];
+            improvementAreas: string[];
+        };
+    };
+    /** Workflow success metrics */
+    metrics: {
+        /** Total executions of this workflow */
+        totalExecutions: number;
+        /** Successful executions */
+        successfulExecutions: number;
+        /** Success rate (0.0-1.0) */
+        successRate: number;
+        /** Average execution time per ORPAR phase */
+        averagePhaseTimings: {
+            observation: number;
+            reasoning: number;
+            action: number;
+            planning: number;
+            reflection: number;
+        };
+        /** Workflow efficiency score (0.0-1.0) */
+        efficiency: number;
+    };
+    /** Agents who have used this workflow */
+    usedByAgents: AgentId[];
+    /** Last time workflow was executed */
+    lastExecuted: number;
+    /** When workflow was created */
+    created: number;
+    /** Workflow version for iterative improvements */
+    version: number;
+    /** Tags for workflow categorization */
+    tags: string[];
+}
+/**
+ * Pattern analysis result from SystemLlmService
+ */
+export interface PatternAnalysisResult {
+    /** Whether a pattern was detected */
+    patternDetected: boolean;
+    /** Type of pattern if detected */
+    patternType?: PatternType;
+    /** Pattern description */
+    description: string;
+    /** Analysis confidence (0.0-1.0) */
+    confidence: number;
+    /** Recommended actions based on pattern */
+    recommendations: string[];
+    /** Pattern metadata */
+    metadata: {
+        /** Complexity assessment */
+        complexity: number;
+        /** Potential for reuse */
+        reuseability: number;
+        /** Performance impact */
+        performanceImpact: 'positive' | 'neutral' | 'negative';
+        /** Tools involved in pattern */
+        toolsInvolved: string[];
+        /** Estimated effectiveness */
+        estimatedEffectiveness: number;
+    };
+}
+/**
+ * Pattern search criteria for finding similar patterns
+ */
+export interface PatternSearchCriteria {
+    /** Channel to search within */
+    channelId: ChannelId;
+    /** Pattern type filter */
+    patternType?: PatternType;
+    /** Minimum effectiveness threshold */
+    minEffectiveness?: number;
+    /** Minimum usage count */
+    minUsageCount?: number;
+    /** Tags to match */
+    tags?: string[];
+    /** Tools that must be involved */
+    toolsUsed?: string[];
+    /** Agents that must have participated */
+    agentParticipants?: AgentId[];
+    /** Time range for pattern discovery */
+    timeRange?: {
+        start: number;
+        end: number;
+    };
+    /** Similarity threshold for pattern matching */
+    similarityThreshold?: number;
+}
+/**
+ * Pattern recommendation for agents
+ */
+export interface PatternRecommendation {
+    /** Pattern being recommended */
+    pattern: PatternMemoryEntry;
+    /** Relevance score (0.0-1.0) */
+    relevance: number;
+    /** Reason for recommendation */
+    reason: string;
+    /** Expected benefits */
+    expectedBenefits: string[];
+    /** Adaptation suggestions for current context */
+    adaptationSuggestions: string[];
+    /** Risk assessment */
+    risks: string[];
+    /** Confidence in recommendation (0.0-1.0) */
+    confidence: number;
+}
+//# sourceMappingURL=PatternMemoryTypes.d.ts.map

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

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

package/dist/types/PatternMemoryTypes.js

@@ -0,0 +1,30 @@
+/**
+ * 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/
+ */
+/**
+ * Extended memory layers for pattern recognition
+ */
+export var MemoryLayer;
+(function (MemoryLayer) {
+    MemoryLayer["CHANNEL"] = "channel";
+    MemoryLayer["AGENT"] = "agent";
+    MemoryLayer["PATTERN"] = "pattern";
+    MemoryLayer["WORKFLOW"] = "workflow";
+})(MemoryLayer || (MemoryLayer = {}));
+//# sourceMappingURL=PatternMemoryTypes.js.map

package/dist/types/PatternMemoryTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PatternMemoryTypes.js","sourceRoot":"","sources":["../../src/types/PatternMemoryTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAUH;;GAEG;AACH,MAAM,CAAN,IAAY,WAKX;AALD,WAAY,WAAW;IACnB,kCAAmB,CAAA;IACnB,8BAAe,CAAA;IACf,kCAAmB,CAAA;IACnB,oCAAqB,CAAA;AACzB,CAAC,EALW,WAAW,KAAX,WAAW,QAKtB"}

package/dist/types/ReflectionTypes.d.ts

@@ -0,0 +1,61 @@
+/**
+ * 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/
+ */
+/**
+ * Structured metrics about a plan execution
+ */
+export interface ReflectionMetrics {
+    successRate: number;
+    completionRate: number;
+    executionTime: number;
+    complexity: number;
+    errorRate: number;
+}
+/**
+ * Types of reflection insights
+ */
+export type InsightType = 'success' | 'error' | 'improvement' | 'pattern';
+/**
+ * Structured insight from reflection
+ */
+export interface ReflectionInsight {
+    type: InsightType;
+    description: string;
+    confidence: number;
+    relatedActionIds?: string[];
+    metadata?: Record<string, any>;
+}
+/**
+ * Learning signals for reinforcement learning integration
+ */
+export interface LearningSignals {
+    reward: number;
+    actionRewards: Record<string, number>;
+    confidenceScore: number;
+}
+/**
+ * Extended Reflection interface with structured data
+ * Enhances the base Reflection interface from ControlLoopTypes
+ */
+export interface EnhancedReflection {
+    metrics: ReflectionMetrics;
+    structuredInsights: ReflectionInsight[];
+    learningSignals?: LearningSignals;
+}
+//# sourceMappingURL=ReflectionTypes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ReflectionTypes.d.ts","sourceRoot":"","sources":["../../src/types/ReflectionTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAWH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,OAAO,GAAG,aAAa,GAAG,SAAS,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,eAAe,EAAE,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IAC/B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,kBAAkB,EAAE,iBAAiB,EAAE,CAAC;IACxC,eAAe,CAAC,EAAE,eAAe,CAAC;CACrC"}

package/dist/types/ReflectionTypes.js

@@ -0,0 +1,21 @@
+/**
+ * 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/
+ */
+export {};
+//# sourceMappingURL=ReflectionTypes.js.map

package/dist/types/ReflectionTypes.js.map

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

package/dist/types/TaskCompletionTypes.d.ts

@@ -0,0 +1,122 @@
+/**
+ * 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/
+ */
+/**
+ * Task Completion Types
+ *
+ * Defines types for intelligent task completion monitoring
+ * that leverages existing planning tools and memory infrastructure
+ */
+export type CompletionStrategyType = 'plan-based' | 'systemllm-eval' | 'output-based' | 'time-based' | 'event-based' | 'consensus' | 'custom';
+export interface PlanBasedCompletion {
+    type: 'plan-based';
+    planId: string;
+    completionType: 'all_steps' | 'critical_steps' | 'percentage';
+    percentage?: number;
+}
+export interface SystemLLMEvalCompletion {
+    type: 'systemllm-eval';
+    objectives: string[];
+    evaluationInterval: number;
+    confidenceThreshold: number;
+}
+export interface OutputBasedCompletion {
+    type: 'output-based';
+    requiredOutputs: {
+        type: 'file' | 'message' | 'tool_call' | 'memory_entry';
+        pattern?: string;
+        count?: number;
+    }[];
+}
+export interface TimeBasedCompletion {
+    type: 'time-based';
+    minimumDuration?: number;
+    maximumDuration: number;
+    requireActivity?: boolean;
+}
+export interface EventBasedCompletion {
+    type: 'event-based';
+    eventName: string;
+    eventData?: Record<string, any>;
+}
+export interface ConsensusCompletion {
+    type: 'consensus';
+    requiredAgents?: string[];
+    threshold: number | 'majority' | 'all';
+}
+export interface CustomCompletion {
+    type: 'custom';
+    evaluatorFunction: string;
+    parameters?: Record<string, any>;
+}
+export type TaskCompletionCriteria = PlanBasedCompletion | SystemLLMEvalCompletion | OutputBasedCompletion | TimeBasedCompletion | EventBasedCompletion | ConsensusCompletion | CustomCompletion;
+export interface TaskCompletionConfig {
+    enabled?: boolean;
+    primary: TaskCompletionCriteria;
+    fallbacks?: TaskCompletionCriteria[];
+    absoluteTimeout?: number;
+    timeoutBehavior?: 'complete' | 'fail' | 'alert';
+    allowManualCompletion?: boolean;
+}
+export interface TaskMonitoringState {
+    taskId: string;
+    startTime: number;
+    lastActivityTime: number;
+    activityCount: number;
+    evidence: {
+        messages: Array<{
+            agentId: string;
+            content: string;
+            timestamp: number;
+        }>;
+        toolCalls: Array<{
+            agentId: string;
+            toolName: string;
+            result: any;
+            timestamp: number;
+        }>;
+        planProgress?: {
+            completedSteps: string[];
+            totalSteps: number;
+            criticalStepsCompleted: number;
+        };
+    };
+    evaluations: Array<{
+        timestamp: number;
+        strategy: CompletionStrategyType;
+        result: boolean;
+        confidence?: number;
+        reason?: string;
+    }>;
+    agentActivity: Map<string, {
+        messageCount: number;
+        toolCallCount: number;
+        lastActive: number;
+    }>;
+}
+export interface TaskCompletionEvent {
+    taskId: string;
+    completedBy: 'system' | string;
+    completionStrategy: CompletionStrategyType;
+    evidence: TaskMonitoringState['evidence'];
+    confidence: number;
+    reason: string;
+    duration: number;
+}
+//# sourceMappingURL=TaskCompletionTypes.d.ts.map

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

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

package/dist/types/TaskCompletionTypes.js

@@ -0,0 +1,21 @@
+/**
+ * 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/
+ */
+export {};
+//# sourceMappingURL=TaskCompletionTypes.js.map

package/dist/types/TaskCompletionTypes.js.map

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