crca 1.4.0__py3-none-any.whl → 1.5.0__py3-none-any.whl

examples/hybrid_agent_dictionary_demo.py

@@ -0,0 +1,104 @@
+"""
+Hybrid Agent Dictionary Integration Demo
+
+Demonstrates the online dictionary integration (Free Dictionary API - no API key required).
+"""
+
+from architecture.hybrid.hybrid_agent import HybridAgent
+from architecture.hybrid.language_compiler import LexicalCompiler
+
+# ============================================================================
+# EXAMPLE 1: Dictionary Lookup
+# ============================================================================
+
+print("=== Example 1: Dictionary Lookup ===\n")
+
+compiler = LexicalCompiler(enable_dictionary=True)
+
+# Look up word information
+word_info = compiler.get_word_info("price")
+if word_info and word_info.get('found'):
+    print(f"Word: {word_info['word']}")
+    print(f"Part of Speech: {word_info['part_of_speech']}")
+    print(f"Synonyms: {list(word_info['synonyms'])[:5]}")
+    print()
+
+# ============================================================================
+# EXAMPLE 2: Validate Words
+# ============================================================================
+
+print("=== Example 2: Word Validation ===\n")
+
+words_to_check = ["price", "demand", "xyzabc123", "identify", "policy"]
+
+for word in words_to_check:
+    is_valid = compiler.is_valid_word(word)
+    pos = compiler.get_part_of_speech(word)
+    is_verb = compiler.is_action_verb(word)
+    is_noun = compiler.is_noun(word)
+    
+    print(f"'{word}':")
+    print(f"  Valid: {is_valid}")
+    print(f"  Part of Speech: {pos}")
+    print(f"  Is Verb: {is_verb}")
+    print(f"  Is Noun: {is_noun}")
+    print()
+
+# ============================================================================
+# EXAMPLE 3: Get Synonyms
+# ============================================================================
+
+print("=== Example 3: Synonym Expansion ===\n")
+
+word = "price"
+synonyms = compiler.get_synonyms(word)
+print(f"Synonyms for '{word}': {list(synonyms)[:10]}")
+print()
+
+# ============================================================================
+# EXAMPLE 4: Dictionary-Enhanced Variable Filtering
+# ============================================================================
+
+print("=== Example 4: Dictionary-Enhanced Agent ===\n")
+
+agent = HybridAgent(
+    enable_language_compilation=True,  # Enables dictionary
+    enable_error_correction=True
+)
+
+# Test with a task that has some invalid words
+task = "If product prce is 20000 and demnad is 61%, what is the expected price?"
+
+response = agent.run(task, response_style='conversational')
+print(f"Task: {task}")
+print(f"\nResponse:\n{response[:500]}...")
+print()
+
+# ============================================================================
+# EXAMPLE 5: Dictionary Cache
+# ============================================================================
+
+print("=== Example 5: Dictionary Caching ===\n")
+
+# First lookup (will make API call)
+import time
+start = time.time()
+info1 = compiler.get_word_info("demand")
+time1 = time.time() - start
+
+# Second lookup (will use cache)
+start = time.time()
+info2 = compiler.get_word_info("demand")
+time2 = time.time() - start
+
+print(f"First lookup: {time1:.3f}s")
+print(f"Cached lookup: {time2:.3f}s")
+print(f"Cache speedup: {time1/time2:.1f}x faster")
+print()
+
+print("Dictionary integration complete!")
+print("The hybrid agent now uses online dictionary (no API key required) for:")
+print("- Word validation")
+print("- Part of speech detection")
+print("- Synonym expansion")
+print("- Better spelling correction")

examples/hybrid_agent_enhanced.py

@@ -0,0 +1,179 @@
+"""
+Enhanced Hybrid Agent Usage Examples
+
+Demonstrates the enhanced hybrid agent that can replace LLMs entirely
+for causal reasoning tasks with natural language interaction.
+"""
+
+from architecture.hybrid.hybrid_agent import HybridAgent
+
+# ============================================================================
+# EXAMPLE 1: Basic Usage (Conversational Response)
+# ============================================================================
+
+agent = HybridAgent()
+response = agent.run("If product price is 20000 and demand is 61%, what is the expected price in 7 days?")
+print("=== Example 1: Basic Usage ===")
+print(response)
+print("\n")
+
+# ============================================================================
+# EXAMPLE 2: Different Response Styles
+# ============================================================================
+
+task = "Product quality affects customer satisfaction, which influences sales revenue"
+
+# Conversational (default - natural, LLM-like)
+response_conv = agent.run(task, response_style='conversational')
+print("=== Example 2a: Conversational Style ===")
+print(response_conv)
+print("\n")
+
+# Brief summary
+response_brief = agent.run(task, response_style='brief')
+print("=== Example 2b: Brief Style ===")
+print(response_brief)
+print("\n")
+
+# Full analysis
+response_full = agent.run(task, response_style='full')
+print("=== Example 2c: Full Style ===")
+print(response_full[:500] + "...")  # Truncate for display
+print("\n")
+
+# ============================================================================
+# EXAMPLE 3: Graph-First Query
+# ============================================================================
+
+# Build graph first
+agent.run("Price depends on demand. Demand affects supply. Supply influences cost.")
+
+# Query graph directly
+graph_result = agent.query_graph("What is the relationship between price and cost?")
+print("=== Example 3: Graph-First Query ===")
+print(graph_result)
+print("\n")
+
+# ============================================================================
+# EXAMPLE 4: Error Handling (Stability)
+# ============================================================================
+
+# Empty input
+response = agent.run("")
+print("=== Example 4a: Empty Input ===")
+print(response)
+print("\n")
+
+# Invalid input
+response = agent.run(None)  # Will be caught and handled gracefully
+print("=== Example 4b: Invalid Input ===")
+print(response)
+print("\n")
+
+# ============================================================================
+# EXAMPLE 5: Complex Causal Chain
+# ============================================================================
+
+complex_task = """
+If marketing spend increases by 20%, brand awareness improves, 
+which leads to higher customer acquisition. Customer acquisition 
+affects revenue, and revenue influences profit margins.
+"""
+
+response = agent.run(complex_task, response_style='conversational')
+print("=== Example 5: Complex Causal Chain ===")
+print(response)
+print("\n")
+
+# ============================================================================
+# EXAMPLE 6: Question Answering
+# ============================================================================
+
+agent.run("Temperature affects pressure. Pressure influences flow rate.")
+
+question = "How does temperature affect flow rate?"
+response = agent.run(question, response_style='conversational')
+print("=== Example 6: Question Answering ===")
+print(response)
+print("\n")
+
+# ============================================================================
+# EXAMPLE 7: Counterfactual Analysis
+# ============================================================================
+
+counterfactual_task = """
+If we increase employee training by 30%, productivity improves by 15%.
+Productivity affects output quality, which influences customer satisfaction.
+What if we increase training by 50% instead?
+"""
+
+response = agent.run(counterfactual_task, response_style='conversational')
+print("=== Example 7: Counterfactual Analysis ===")
+print(response[:800] + "...")  # Truncate for display
+print("\n")
+
+# ============================================================================
+# EXAMPLE 8: Text Correction (Handles Typos)
+# ============================================================================
+
+typo_task = "Prce depnds on demnad and suply affects cost"  # Intentional typos
+response = agent.run(typo_task, response_style='conversational')
+print("=== Example 8: Text Correction (Typos) ===")
+print(response)
+print("\n")
+
+# ============================================================================
+# EXAMPLE 9: Multi-Turn Conversation
+# ============================================================================
+
+print("=== Example 9: Multi-Turn Conversation ===")
+
+# Turn 1: Establish context
+agent.run("Customer satisfaction depends on product quality and service quality.")
+
+# Turn 2: Ask question
+response1 = agent.run("What affects customer satisfaction?", response_style='conversational')
+print("Q: What affects customer satisfaction?")
+print(f"A: {response1[:200]}...\n")
+
+# Turn 3: Follow-up
+response2 = agent.run("How does product quality affect it?", response_style='conversational')
+print("Q: How does product quality affect it?")
+print(f"A: {response2[:200]}...\n")
+
+# ============================================================================
+# EXAMPLE 10: Production-Ready Usage
+# ============================================================================
+
+def analyze_causal_relationship(description: str) -> str:
+    """
+    Production-ready function for causal analysis.
+    
+    Args:
+        description: Natural language description of causal relationships
+        
+    Returns:
+        Analysis result as natural language
+    """
+    agent = HybridAgent(
+        enable_graph_first=True,
+        enable_compression=True,
+        enable_language_compilation=True,
+        enable_error_correction=True
+    )
+    
+    try:
+        return agent.run(description, response_style='conversational')
+    except Exception as e:
+        return f"Analysis failed: {str(e)}"
+
+# Usage
+result = analyze_causal_relationship(
+    "Employee motivation drives productivity. Productivity affects company revenue."
+)
+print("=== Example 10: Production-Ready Function ===")
+print(result)
+print("\n")
+
+print("All examples completed successfully!")
+print("\nThe hybrid agent can now replace LLMs for causal reasoning tasks!")

examples/hybrid_agent_general_knowledge.py

@@ -0,0 +1,107 @@
+"""
+Enhanced Hybrid Agent - General Knowledge Examples
+
+Demonstrates the hybrid agent's ability to handle general knowledge tasks,
+not just causal reasoning. Shows taxonomic, spatial, temporal, and definitional relationships.
+"""
+
+from architecture.hybrid.hybrid_agent import HybridAgent
+
+# ============================================================================
+# EXAMPLE 1: Taxonomic Relationships (Is-A)
+# ============================================================================
+
+agent = HybridAgent(graph_type="knowledge")  # Use knowledge graph type
+response = agent.run("A dog is a mammal. A mammal is an animal.")
+print("=== Example 1: Taxonomic Relationships ===")
+print(response)
+print("\n")
+
+# ============================================================================
+# EXAMPLE 2: Spatial Relationships
+# ============================================================================
+
+response = agent.run("Paris is in France. France is in Europe.")
+print("=== Example 2: Spatial Relationships ===")
+print(response)
+print("\n")
+
+# ============================================================================
+# EXAMPLE 3: Definitions
+# ============================================================================
+
+response = agent.run("What is a mammal?")
+print("=== Example 3: Definition Query ===")
+print(response)
+print("\n")
+
+# ============================================================================
+# EXAMPLE 4: Mixed Causal and General Knowledge
+# ============================================================================
+
+agent_mixed = HybridAgent(graph_type="mixed")  # Mixed graph type
+response = agent_mixed.run("Price depends on demand. A product is a good. Demand affects sales.")
+print("=== Example 4: Mixed Relationships ===")
+print(response)
+print("\n")
+
+# ============================================================================
+# EXAMPLE 5: Part-Whole Relationships
+# ============================================================================
+
+response = agent.run("A wheel is part of a car. A car has an engine.")
+print("=== Example 5: Part-Whole Relationships ===")
+print(response)
+print("\n")
+
+# ============================================================================
+# EXAMPLE 6: Temporal Relationships
+# ============================================================================
+
+response = agent.run("Spring occurs before summer. Summer happens after spring.")
+print("=== Example 6: Temporal Relationships ===")
+print(response)
+print("\n")
+
+# ============================================================================
+# EXAMPLE 7: Functional Relationships
+# ============================================================================
+
+response = agent.run("A hammer is used for hitting nails. A pen functions as a writing tool.")
+print("=== Example 7: Functional Relationships ===")
+print(response)
+print("\n")
+
+# ============================================================================
+# EXAMPLE 8: Complex General Knowledge Query
+# ============================================================================
+
+response = agent.run("What is Paris? Where is it located?")
+print("=== Example 8: Complex General Knowledge Query ===")
+print(response)
+print("\n")
+
+# ============================================================================
+# EXAMPLE 9: Conversational General Knowledge
+# ============================================================================
+
+# First message
+response1 = agent.run("A cat is a mammal.")
+print("=== Example 9a: First Message ===")
+print(response1)
+print("\n")
+
+# Follow-up with reference
+response2 = agent.run("What else is a mammal?")
+print("=== Example 9b: Follow-up with Reference ===")
+print(response2)
+print("\n")
+
+# ============================================================================
+# EXAMPLE 10: Show Reasoning for General Knowledge
+# ============================================================================
+
+response = agent.run("A bird is an animal. An animal is a living thing.", show_reasoning=True)
+print("=== Example 10: General Knowledge with Reasoning ===")
+print(response)
+print("\n")