Module intelligent_behavior 

Intelligent Mock Behavior System

This module provides LLM-powered stateful mock behavior that maintains consistency across multiple API requests, simulating a real, thinking backend.

Features

• Stateful Context Management: Tracks state across requests using sessions
• LLM-Powered Decision Making: Uses AI to generate intelligent, context-aware responses
• Vector Memory: Semantic search over past interactions for long-term memory
• Consistency Rules: Enforces logical behavior patterns (e.g., auth requirements)
• State Machines: Resources follow realistic lifecycle transitions

Architecture

Request → Context Manager → Behavior Model → LLM + Vector Store → Response
             ↓                    ↓                    ↓
        Session State      Consistency Rules    Past Interactions

Example Usage

use mockforge_core::intelligent_behavior::{
    StatefulAiContext, BehaviorModel, IntelligentBehaviorConfig,
};

// Create a stateful context
let config = IntelligentBehaviorConfig::default();
let mut context = StatefulAiContext::new("session_123", config);

// Record an interaction
context.record_interaction(
    "POST",
    "/api/users",
    Some(serde_json::json!({"name": "Alice"})),
    Some(serde_json::json!({"id": "user_1", "name": "Alice"})),
).await?;

// Get current state
let state = context.get_state();

Re-exports

pub use llm_client::LlmUsage;

pub use behavior::BehaviorModel;

pub use context::StatefulAiContext;

pub use memory::VectorMemoryStore;

pub use mockai::MockAI;

pub use mutation_analyzer::ChangeType;

pub use mutation_analyzer::FieldChange;

pub use mutation_analyzer::MutationAnalysis;

pub use mutation_analyzer::MutationAnalyzer;

pub use mutation_analyzer::MutationType;

pub use mutation_analyzer::ResponseType;

pub use mutation_analyzer::ValidationIssue;

pub use mutation_analyzer::ValidationIssueType;

pub use mutation_analyzer::ValidationSeverity;

pub use openapi_generator::ConfidenceScore;

pub use openapi_generator::OpenApiGenerationConfig;

pub use openapi_generator::OpenApiGenerationMetadata;

pub use openapi_generator::OpenApiGenerationResult;

pub use openapi_generator::OpenApiSpecGenerator;

pub use pagination_intelligence::PaginationFormat;

pub use pagination_intelligence::PaginationIntelligence;

pub use pagination_intelligence::PaginationMetadata;

pub use pagination_intelligence::PaginationRequest;

pub use pagination_intelligence::PaginationRule;

pub use relationship_inference::Relationship;

pub use relationship_inference::RelationshipInference;

pub use rule_generator::RuleGenerator;

pub use spec_suggestion::EndpointSuggestion;

pub use spec_suggestion::OutputFormat;

pub use spec_suggestion::ParameterInfo;

pub use spec_suggestion::SpecSuggestionEngine;

pub use spec_suggestion::SuggestionConfig;

pub use spec_suggestion::SuggestionInput;

pub use spec_suggestion::SuggestionMetadata;

pub use spec_suggestion::SuggestionResult;

pub use validation_generator::ErrorFormat;

pub use validation_generator::FieldError;

pub use validation_generator::RequestContext;

pub use validation_generator::ValidationErrorExample;

pub use validation_generator::ValidationErrorResponse;

pub use validation_generator::ValidationGenerator;

Modules

behavior

Behavior model for LLM-powered decision making

cache

Response caching for intelligent behavior

condition_evaluator

Re-exported from mockforge_foundation::state_machine (Phase 6 / A4).

config

Configuration for the Intelligent Mock Behavior system

context

Stateful AI context management

embedding_client

Embedding client for vector memory

history

Re-exported from mockforge_foundation::state_machine (Phase 6 / A4).

llm_client

LLM client wrapper for intelligent behavior

memory

Vector memory store for long-term semantic memory

mockai

Unified MockAI interface

mutation_analyzer

Request mutation detection and context analysis

openapi_generator

OpenAPI specification generator from recorded traffic

pagination_intelligence

Context-aware pagination intelligence

relationship_inference

Relationship Inference for Smart Personas

rule_generator

Rule auto-generation engine for MockAI

rules

Re-exported from mockforge_foundation::state_machine (Phase 6 / A3).

session

Re-exported from mockforge_foundation::intelligent_behavior::session (Phase 6 / A7).

spec_suggestion

AI-powered specification suggestion and generation

sub_scenario

Re-exported from mockforge_foundation::state_machine (Phase 6 / A3).

types

Core types for the Intelligent Mock Behavior system

validation_generator

AI-driven validation error generation

visual_layout

Re-exported from mockforge_foundation::state_machine (Phase 6 / A3).

Structs

BehaviorRules

Behavior rules that define how the mock API should behave

ConditionEvaluator

Condition evaluator for state machine transitions

ConsistencyRule

Consistency rule that enforces logical behavior patterns

CrudExample

CRUD example for state machine generation

ErrorExample

Error example for learning validation rules

ExamplePair

Example request/response pair for learning

HistoryManager

History manager for state machine edits

HttpExchange

Captured HTTP request/response exchange used for behavioral analysis.

IntelligentBehaviorConfig

Configuration for the Intelligent Mock Behavior system

InteractionRecord

A single interaction record (request + response pair)

PaginatedResponse

Paginated response example

PatternMatch

Pattern match information

Persona

A persona defines consistent data patterns across endpoints

PersonasConfig

Personas configuration for consistent data generation

Request

HTTP request for MockAI processing.

Response

HTTP response from MockAI.

RuleExplanation

Rule explanation metadata

SessionManager

Session manager for tracking and managing sessions

SessionTracking

Session tracking configuration

StateMachine

State machine for resource lifecycle management

StateTransition

State transition definition

SubScenario

Sub-scenario definition for nested state machine execution

ValidationRule

Validation rule inferred from examples

Viewport

Viewport information for the visual editor

VisualEdge

Visual representation of a transition edge

VisualLayout

Visual layout for a state machine graph

VisualNode

Visual representation of a state node

Enums

ConditionError

Error types for condition evaluation

RuleAction

Action to take when a consistency rule matches

RuleType

Rule type classification

Type Aliases

ConditionResult

Result type for condition evaluation