@mxf-dev/core 1.0.0

package/dist/types/ValidationPerformanceTypes.d.ts

@@ -0,0 +1,168 @@
+/**
+ * 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/
+ */
+/**
+ * Validation Performance Types
+ * Phase 1: Validation metrics for agent performance tracking
+ */
+/**
+ * Validation-specific metrics for tool usage
+ */
+export interface ValidationMetrics {
+    /** Total validation errors encountered */
+    totalValidationErrors: number;
+    /** Validation errors by tool (toolName -> error count) */
+    validationErrorsByTool: Record<string, number>;
+    /** Validation error types encountered */
+    errorTypes: {
+        missingRequired: number;
+        unknownProperties: number;
+        typeMismatch: number;
+        constraintViolation: number;
+        other: number;
+    };
+    /** Help tool usage metrics */
+    helpToolUsage: {
+        tool_help: number;
+        tool_validate: number;
+        tool_quick_reference: number;
+        tool_validation_tips: number;
+    };
+    /** Self-correction metrics */
+    selfCorrection: {
+        /** Number of times agent corrected after validation error */
+        successfulCorrections: number;
+        /** Number of times agent failed to correct */
+        failedCorrections: number;
+        /** Average attempts before successful correction */
+        averageAttemptsToCorrect: number;
+        /** Tools that were successfully corrected */
+        correctedTools: string[];
+    };
+    /** Recovery time metrics */
+    recoveryTime: {
+        /** Average time from error to successful retry (ms) */
+        averageRecoveryTime: number;
+        /** Fastest recovery time (ms) */
+        fastestRecovery: number;
+        /** Slowest recovery time (ms) */
+        slowestRecovery: number;
+        /** Recovery times by tool */
+        byTool: Record<string, number>;
+    };
+    /** Parameter pattern learning */
+    parameterPatterns: {
+        /** Successful parameter patterns by tool */
+        successfulPatterns: Record<string, Array<{
+            parameters: Record<string, any>;
+            frequency: number;
+            lastUsed: number;
+        }>>;
+        /** Failed parameter patterns by tool */
+        failedPatterns: Record<string, Array<{
+            parameters: Record<string, any>;
+            errorType: string;
+            frequency: number;
+            lastSeen: number;
+        }>>;
+    };
+    /** Validation efficiency metrics */
+    efficiency: {
+        /** Percentage of tool calls that pass validation first try */
+        firstTrySuccessRate: number;
+        /** Percentage of validation errors that lead to help tool usage */
+        helpToolUsageRate: number;
+        /** Percentage of errors that are self-corrected */
+        selfCorrectionRate: number;
+        /** Trend over time (improving/stable/declining) */
+        trend: 'improving' | 'stable' | 'declining';
+    };
+    /** Last updated timestamp */
+    lastUpdated: number;
+}
+/**
+ * Enhanced tool usage metrics with validation tracking
+ */
+export interface EnhancedToolUsageMetrics {
+    /** Tool validation success rate (toolName -> success rate 0.0-1.0) */
+    toolValidationSuccessRates: Record<string, number>;
+    /** Common validation errors by tool */
+    commonValidationErrors: Record<string, string[]>;
+    /** Tools that trigger help tool usage most often */
+    helpTriggeringTools: string[];
+    /** Parameter correction suggestions used */
+    parameterCorrections: Array<{
+        tool: string;
+        originalParams: Record<string, any>;
+        correctedParams: Record<string, any>;
+        timestamp: number;
+        successful: boolean;
+    }>;
+}
+/**
+ * Validation performance analysis results
+ */
+export interface ValidationPerformanceAnalysis {
+    /** Overall validation health score (0.0-1.0) */
+    validationHealthScore: number;
+    /** Problem areas identified */
+    problemAreas: Array<{
+        tool: string;
+        errorRate: number;
+        commonErrors: string[];
+        suggestedActions: string[];
+    }>;
+    /** Learning effectiveness */
+    learningEffectiveness: {
+        /** Rate at which agent learns from errors */
+        learningRate: number;
+        /** Tools mastered (low error rate) */
+        masteredTools: string[];
+        /** Tools still learning */
+        learningTools: string[];
+        /** Tools struggling with */
+        strugglingTools: string[];
+    };
+    /** Recommendations for improvement */
+    recommendations: Array<{
+        priority: 'high' | 'medium' | 'low';
+        action: string;
+        expectedImprovement: string;
+        tools: string[];
+    }>;
+}
+/**
+ * Validation event for tracking
+ */
+export interface ValidationEvent {
+    timestamp: number;
+    agentId: string;
+    channelId: string;
+    toolName: string;
+    eventType: 'validation_error' | 'validation_success' | 'help_tool_used' | 'self_correction' | 'parameter_learned';
+    details: {
+        parameters?: Record<string, any>;
+        error?: string;
+        errorType?: string;
+        helpToolUsed?: string;
+        correctionAttempt?: number;
+        recoveryTime?: number;
+    };
+}
+//# sourceMappingURL=ValidationPerformanceTypes.d.ts.map

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

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

package/dist/types/ValidationPerformanceTypes.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=ValidationPerformanceTypes.js.map

package/dist/types/ValidationPerformanceTypes.js.map

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

package/dist/types/WorkflowTypes.d.ts

@@ -0,0 +1,291 @@
+/**
+ * Workflow Types for MXF Agent Dev Kit
+ *
+ * Core types for workflow-based task orchestration system.
+ * Feature flag: WORKFLOW_SYSTEM_ENABLED
+ */
+/**
+ * Workflow step definition
+ */
+export interface WorkflowStep {
+    /** Unique step identifier */
+    id: string;
+    /** Step name for display */
+    name: string;
+    /** Step description */
+    description?: string;
+    /** Type of step execution */
+    type: WorkflowStepType;
+    /** Step configuration */
+    config: WorkflowStepConfig;
+    /** Dependencies (step IDs that must complete first) */
+    dependencies: string[];
+    /** Condition for step execution */
+    condition?: WorkflowCondition;
+    /** Retry policy */
+    retryPolicy?: WorkflowRetryPolicy;
+    /** Timeout in milliseconds */
+    timeout?: number;
+    /** Metadata for extensions */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Type of workflow step
+ */
+export type WorkflowStepType = 'tool_execution' | 'llm_call' | 'decision' | 'loop' | 'parallel' | 'subprocess' | 'wait' | 'validation' | 'custom';
+/**
+ * Configuration for workflow step
+ */
+export interface WorkflowStepConfig {
+    /** Tool name (for tool_execution) */
+    tool?: string;
+    /** Tool parameters */
+    parameters?: Record<string, unknown>;
+    /** LLM prompt (for llm_call) */
+    prompt?: string;
+    /** Decision condition (for decision) */
+    branches?: WorkflowBranch[];
+    /** Loop configuration (for loop) */
+    loop?: WorkflowLoopConfig;
+    /** Wait configuration (for wait) */
+    wait?: WorkflowWaitConfig;
+    /** Custom handler name (for custom) */
+    handler?: string;
+}
+/**
+ * Conditional branch in workflow
+ */
+export interface WorkflowBranch {
+    /** Branch condition */
+    condition: WorkflowCondition;
+    /** Steps to execute if condition is true */
+    steps: string[];
+}
+/**
+ * Workflow condition
+ */
+export interface WorkflowCondition {
+    /** Condition type */
+    type: 'expression' | 'tool_result' | 'state_check' | 'custom';
+    /** Condition expression */
+    expression: string;
+    /** Variables for condition evaluation */
+    variables?: Record<string, unknown>;
+}
+/**
+ * Loop configuration
+ */
+export interface WorkflowLoopConfig {
+    /** Loop type */
+    type: 'for' | 'while' | 'foreach';
+    /** Iteration variable name */
+    variable: string;
+    /** Iteration source (array, range, condition) */
+    source: unknown;
+    /** Maximum iterations */
+    maxIterations?: number;
+}
+/**
+ * Wait configuration
+ */
+export interface WorkflowWaitConfig {
+    /** Wait type */
+    type: 'duration' | 'event' | 'condition';
+    /** Duration in milliseconds (for duration) */
+    duration?: number;
+    /** Event name (for event) */
+    event?: string;
+    /** Condition (for condition) */
+    condition?: WorkflowCondition;
+    /** Timeout in milliseconds */
+    timeout?: number;
+}
+/**
+ * Retry policy
+ */
+export interface WorkflowRetryPolicy {
+    /** Maximum retry attempts */
+    maxAttempts: number;
+    /** Initial delay in milliseconds */
+    initialDelay: number;
+    /** Backoff multiplier */
+    backoffMultiplier: number;
+    /** Maximum delay in milliseconds */
+    maxDelay: number;
+    /** Retry on these error types only */
+    retryOnErrors?: string[];
+}
+/**
+ * Workflow definition
+ */
+export interface WorkflowDefinition {
+    /** Unique workflow identifier */
+    id: string;
+    /** Workflow name */
+    name: string;
+    /** Workflow description */
+    description?: string;
+    /** Workflow version */
+    version: string;
+    /** Workflow steps */
+    steps: WorkflowStep[];
+    /** Initial state */
+    initialState?: WorkflowState;
+    /** Workflow metadata */
+    metadata?: Record<string, unknown>;
+    /** Created timestamp */
+    createdAt: Date;
+    /** Updated timestamp */
+    updatedAt: Date;
+    /** Created by agent ID */
+    createdBy: string;
+}
+/**
+ * Workflow execution state
+ */
+export interface WorkflowState {
+    /** Current step ID being executed */
+    currentStep?: string;
+    /** Completed step IDs */
+    completedSteps: string[];
+    /** Failed step IDs */
+    failedSteps: string[];
+    /** Step outputs (step ID -> output) */
+    stepOutputs: Map<string, unknown>;
+    /** Workflow variables */
+    variables: Record<string, unknown>;
+    /** Execution status */
+    status: WorkflowStatus;
+    /** Error information */
+    error?: WorkflowError;
+    /** Start timestamp */
+    startedAt?: Date;
+    /** End timestamp */
+    completedAt?: Date;
+}
+/**
+ * Workflow execution status
+ */
+export type WorkflowStatus = 'pending' | 'running' | 'paused' | 'completed' | 'failed' | 'cancelled';
+/**
+ * Workflow error
+ */
+export interface WorkflowError {
+    /** Error message */
+    message: string;
+    /** Error code */
+    code?: string;
+    /** Step ID where error occurred */
+    stepId?: string;
+    /** Error stack trace */
+    stack?: string;
+    /** Original error data */
+    data?: unknown;
+}
+/**
+ * Workflow execution context
+ */
+export interface WorkflowExecutionContext {
+    /** Workflow ID */
+    workflowId: string;
+    /** Execution ID */
+    executionId: string;
+    /** Agent ID executing workflow */
+    agentId: string;
+    /** Channel ID (if any) */
+    channelId?: string;
+    /** Current state */
+    state: WorkflowState;
+    /** Execution configuration */
+    config: WorkflowExecutionConfig;
+}
+/**
+ * Workflow execution configuration
+ */
+export interface WorkflowExecutionConfig {
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Override default timeouts */
+    defaultTimeout?: number;
+    /** Override default retry policy */
+    defaultRetryPolicy?: WorkflowRetryPolicy;
+    /** Execution mode */
+    mode?: 'normal' | 'dry_run' | 'debug';
+    /** Callback on step completion */
+    onStepComplete?: (stepId: string, output: unknown) => void;
+    /** Callback on workflow completion */
+    onComplete?: (state: WorkflowState) => void;
+    /** Callback on error */
+    onError?: (error: WorkflowError) => void;
+}
+/**
+ * Workflow template
+ */
+export interface WorkflowTemplate {
+    /** Template ID */
+    id: string;
+    /** Template name */
+    name: string;
+    /** Template description */
+    description?: string;
+    /** Template category */
+    category: string;
+    /** Template tags */
+    tags: string[];
+    /** Workflow definition */
+    workflow: Omit<WorkflowDefinition, 'id' | 'createdAt' | 'updatedAt' | 'createdBy'>;
+    /** Template parameters */
+    parameters?: WorkflowTemplateParameter[];
+    /** Usage examples */
+    examples?: WorkflowTemplateExample[];
+    /** Is built-in template */
+    builtIn: boolean;
+}
+/**
+ * Workflow template parameter
+ */
+export interface WorkflowTemplateParameter {
+    /** Parameter name */
+    name: string;
+    /** Parameter description */
+    description?: string;
+    /** Parameter type */
+    type: 'string' | 'number' | 'boolean' | 'object' | 'array';
+    /** Is required */
+    required: boolean;
+    /** Default value */
+    default?: unknown;
+    /** Validation schema */
+    schema?: Record<string, unknown>;
+}
+/**
+ * Workflow template example
+ */
+export interface WorkflowTemplateExample {
+    /** Example title */
+    title: string;
+    /** Example description */
+    description?: string;
+    /** Example parameters */
+    parameters: Record<string, unknown>;
+}
+/**
+ * Workflow execution result
+ */
+export interface WorkflowExecutionResult {
+    /** Execution ID */
+    executionId: string;
+    /** Workflow ID */
+    workflowId: string;
+    /** Final state */
+    state: WorkflowState;
+    /** Total duration in milliseconds */
+    duration: number;
+    /** Success flag */
+    success: boolean;
+    /** Output data */
+    output?: unknown;
+    /** Error (if failed) */
+    error?: WorkflowError;
+}
+//# sourceMappingURL=WorkflowTypes.d.ts.map

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

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

package/dist/types/WorkflowTypes.js

@@ -0,0 +1,8 @@
+/**
+ * Workflow Types for MXF Agent Dev Kit
+ *
+ * Core types for workflow-based task orchestration system.
+ * Feature flag: WORKFLOW_SYSTEM_ENABLED
+ */
+export {};
+//# sourceMappingURL=WorkflowTypes.js.map

package/dist/types/WorkflowTypes.js.map

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

package/dist/types/toolTypes.d.ts

@@ -0,0 +1,93 @@
+/**
+ * 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/
+ */
+/**
+ * Tool Types (Stub)
+ *
+ * Provides type definitions for tool-related functionality.
+ * This is a minimal implementation to allow the build process to succeed.
+ * Created following DRY principles and fail-fast validation patterns.
+ */
+export declare enum ToolAccessLevel {
+    PUBLIC = "public",
+    PRIVATE = "private",
+    PROTECTED = "protected",
+    RESTRICTED = "restricted"
+}
+export declare enum ToolParameterType {
+    STRING = "string",
+    NUMBER = "number",
+    BOOLEAN = "boolean",
+    OBJECT = "object",
+    ARRAY = "array",
+    ANY = "any"
+}
+export declare enum ToolServerAuthType {
+    NONE = "none",
+    API_KEY = "api_key",
+    OAUTH = "oauth",
+    BASIC = "basic"
+}
+export declare enum ToolServerConnectionType {
+    REST = "rest",
+    GRAPHQL = "graphql",
+    SOAP = "soap",
+    GRPC = "grpc",
+    CUSTOM = "custom"
+}
+export declare enum ToolServerStatus {
+    ONLINE = "online",
+    OFFLINE = "offline",
+    DEGRADED = "degraded",
+    MAINTENANCE = "maintenance",
+    DISCONNECTED = "disconnected"
+}
+export declare enum ToolCallStatus {
+    PENDING = "pending",
+    IN_PROGRESS = "in_progress",
+    COMPLETED = "completed",
+    FAILED = "failed",
+    TIMEOUT = "timeout"
+}
+export interface Tool {
+    name: string;
+    description: string;
+    parameters: ToolParameter[];
+}
+export interface ToolParameter {
+    name: string;
+    type: ToolParameterType;
+    description: string;
+    required: boolean;
+}
+export interface ToolResult {
+    status: ToolCallStatus;
+    data?: any;
+    error?: string;
+}
+export interface ToolContext {
+    agentId: string;
+    channelId?: string;
+}
+export interface ToolRequest {
+    toolName: string;
+    parameters: Record<string, any>;
+    context: ToolContext;
+}
+//# sourceMappingURL=toolTypes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toolTypes.d.ts","sourceRoot":"","sources":["../../src/types/toolTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;;GAMG;AAGH,oBAAY,eAAe;IACvB,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,SAAS,cAAc;IACvB,UAAU,eAAe;CAC5B;AAGD,oBAAY,iBAAiB;IACzB,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,KAAK,UAAU;IACf,GAAG,QAAQ;CACd;AAGD,oBAAY,kBAAkB;IAC1B,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,KAAK,UAAU;CAClB;AAGD,oBAAY,wBAAwB;IAChC,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,IAAI,SAAS;IACb,MAAM,WAAW;CACpB;AAGD,oBAAY,gBAAgB;IACxB,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,QAAQ,aAAa;IACrB,WAAW,gBAAgB;IAC3B,YAAY,iBAAiB;CAChC;AAGD,oBAAY,cAAc;IACtB,OAAO,YAAY;IACnB,WAAW,gBAAgB;IAC3B,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,OAAO,YAAY;CACtB;AAGD,MAAM,WAAW,IAAI;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,aAAa,EAAE,CAAC;CAC/B;AAGD,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,iBAAiB,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACrB;AAGD,MAAM,WAAW,UAAU;IACvB,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAGD,MAAM,WAAW,WAAW;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAGD,MAAM,WAAW,WAAW;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChC,OAAO,EAAE,WAAW,CAAC;CACxB"}