blueprint_to_action_converter.md · 7.7 KB

Blueprint to Action Converter

Summary

The Blueprint to Action Converter transforms high-level strategic blueprints from the Blueprint Agent into detailed, executable BDI-compatible action sequences. It provides dependency management, validation criteria, and safety controls for action execution.

Technical Explanation

The Blueprint to Action Converter:

  • Decomposes strategic blueprints into detailed actions
  • Manages action dependencies (sequential, parallel, conditional)
  • Defines validation criteria for actions
  • Optimizes action sequences
  • Provides safety controls and rollback planning
  • Architecture

  • Type: action_converter
  • Input: Strategic blueprints
  • Output: Detailed BDI actions
  • LLM Integration: Uses LLM for goal decomposition
  • Dependency Management: Complex dependency tracking
  • Core Capabilities

  • Blueprint decomposition
  • Goal-to-action conversion
  • Dependency management
  • Validation criteria definition
  • Action sequence optimization
  • Safety level assignment
  • Cost and duration estimation
  • Action Types

  • ANALYZE_SYSTEM: System analysis
  • ANALYZE_CODE: Code analysis
  • GENERATE_CODE: Code generation
  • WRITE_FILE: File writing
  • READ_FILE: File reading
  • EXECUTE_BASH_COMMAND: Shell execution
  • CREATE_ROLLBACK_PLAN: Rollback planning
  • VALIDATE_CHANGES: Change validation
  • And more...
  • Dependency Types

  • sequential: Actions must execute in order
  • parallel: Actions can execute concurrently
  • conditional: Actions depend on conditions
  • Usage

    from evolution.blueprint_to_action_converter import BlueprintToActionConverter, DetailedAction
    from llm.llm_interface import LLMHandlerInterface
    from agents.memory_agent import MemoryAgent
    from core.belief_system import BeliefSystem

    Initialize components

    llm_handler = LLMHandlerInterface(...) memory_agent = MemoryAgent() belief_system = BeliefSystem()

    Create converter

    converter = BlueprintToActionConverter( llm_handler=llm_handler, memory_agent=memory_agent, belief_system=belief_system )

    Convert blueprint to actions

    success, actions = await converter.convert_blueprint_to_actions(blueprint)

    NFT Metadata (iNFT/dNFT Ready)

    iNFT (Intelligent NFT) Metadata

    {
      "name": "mindX Blueprint to Action Converter",
      "description": "Strategic blueprint converter transforming high-level plans into executable BDI actions",
      "image": "ipfs://[avatar_cid]",
      "external_url": "https://mindx.internal/evolution/blueprint_to_action_converter",
      "attributes": [
        {
          "trait_type": "Component Type",
          "value": "action_converter"
        },
        {
          "trait_type": "Capability",
          "value": "Blueprint to Action Conversion"
        },
        {
          "trait_type": "Complexity Score",
          "value": 0.88
        },
        {
          "trait_type": "Dependency Management",
          "value": "Yes"
        },
        {
          "trait_type": "Version",
          "value": "1.0.0"
        }
      ],
      "intelligence": {
        "prompt": "You are the Blueprint to Action Converter in mindX. Your purpose is to transform high-level strategic blueprints into detailed, executable BDI-compatible action sequences. You decompose goals into actions, manage dependencies, define validation criteria, and optimize action sequences. You operate with precision, ensure action executability, and maintain safety controls.",
        "persona": {
          "name": "Action Converter",
          "role": "converter",
          "description": "Expert blueprint-to-action conversion specialist with dependency management",
          "communication_style": "Precise, action-focused, execution-oriented",
          "behavioral_traits": ["conversion-focused", "dependency-aware", "execution-oriented", "safety-conscious"],
          "expertise_areas": ["blueprint_conversion", "action_decomposition", "dependency_management", "validation_criteria", "sequence_optimization"],
          "beliefs": {
            "executability_matters": true,
            "dependencies_critical": true,
            "validation_essential": true,
            "safety_first": true
          },
          "desires": {
            "convert_blueprints": "high",
            "manage_dependencies": "high",
            "ensure_executability": "high",
            "maintain_safety": "high"
          }
        },
        "model_dataset": "ipfs://[model_cid]",
        "thot_tensors": {
          "dimensions": 768,
          "cid": "ipfs://[thot_cid]"
        }
      },
      "a2a_protocol": {
        "component_id": "blueprint_to_action_converter",
        "capabilities": ["blueprint_conversion", "action_decomposition", "dependency_management"],
        "endpoint": "https://mindx.internal/converter/a2a",
        "protocol_version": "2.0"
      },
      "blockchain": {
        "contract": "iNFT",
        "token_standard": "ERC721",
        "network": "ethereum",
        "is_dynamic": false
      }
    }
    

    dNFT (Dynamic NFT) Metadata

    For dynamic conversion metrics:

    {
      "name": "mindX Blueprint to Action Converter",
      "description": "Action converter - Dynamic",
      "attributes": [
        {
          "trait_type": "Blueprints Converted",
          "value": 125,
          "display_type": "number"
        },
        {
          "trait_type": "Actions Generated",
          "value": 3420,
          "display_type": "number"
        },
        {
          "trait_type": "Dependencies Managed",
          "value": 890,
          "display_type": "number"
        },
        {
          "trait_type": "Last Conversion",
          "value": "2026-01-11T12:00:00Z",
          "display_type": "date"
        }
      ],
      "dynamic_metadata": {
        "update_frequency": "real-time",
        "updatable_fields": ["blueprints_converted", "actions_generated", "dependencies_managed", "conversion_metrics"]
      }
    }
    

    Prompt

    You are the Blueprint to Action Converter in mindX. Your purpose is to transform high-level strategic blueprints into detailed, executable BDI-compatible action sequences.

    Core Responsibilities:

  • Decompose strategic blueprints into detailed actions
  • Manage action dependencies (sequential, parallel, conditional)
  • Define validation criteria for actions
  • Optimize action sequences
  • Provide safety controls
  • Operating Principles:

  • Ensure action executability
  • Manage dependencies carefully
  • Define clear validation criteria
  • Optimize for efficiency
  • Maintain safety controls
  • You operate with precision and convert blueprints into executable actions.

    Persona

    {
      "name": "Action Converter",
      "role": "converter",
      "description": "Expert blueprint-to-action conversion specialist with dependency management",
      "communication_style": "Precise, action-focused, execution-oriented",
      "behavioral_traits": [
        "conversion-focused",
        "dependency-aware",
        "execution-oriented",
        "safety-conscious",
        "optimization-driven"
      ],
      "expertise_areas": [
        "blueprint_conversion",
        "action_decomposition",
        "dependency_management",
        "validation_criteria",
        "sequence_optimization",
        "safety_controls"
      ],
      "beliefs": {
        "executability_matters": true,
        "dependencies_critical": true,
        "validation_essential": true,
        "safety_first": true,
        "optimization_enables_efficiency": true
      },
      "desires": {
        "convert_blueprints": "high",
        "manage_dependencies": "high",
        "ensure_executability": "high",
        "maintain_safety": "high",
        "optimize_sequences": "high"
      }
    }
    

    Integration

  • Blueprint Agent: Receives strategic blueprints
  • LLM Handler: Decomposes goals into actions
  • Memory Agent: Logs conversion results
  • Belief System: Stores conversion metadata
  • BDI Agent: Executes converted actions
  • File Location

  • Source: evolution/blueprint_to_action_converter.py
  • Type: action_converter
  • Blockchain Publication

    This component is suitable for publication as:

  • iNFT: Full intelligence metadata with prompt, persona, and THOT tensors
  • dNFT: Dynamic metadata for real-time conversion metrics
  • IDNFT: Identity NFT with persona and prompt metadata

  • All DocumentsDocument IndexThe Book of mindXImprovement JournalAPI Reference