poml 0.0.5 → 0.0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b5ba78c3aed937b9021b7d60fa5615fce4e75067ba607226fcb1c98674e720cf
-  data.tar.gz: 366238332f24e1f4309c64ff8da6fe52822747727e411d3925e92902b4b0ab2c
+  metadata.gz: '08ad238aa1b84997e3120a4379473c190293c3e6cb4a9fc08fe373457e3d10b7'
+  data.tar.gz: '028e54bb00290ffd9317902101435a2024a15972d6987e4acf9773b00ccba679'
 SHA512:
-  metadata.gz: f54b42cd18875cb6200eda77ea3f5be6ef21bbb5a8adcc35e3d349c4b7b6c8e8194f9fccc7c618bfe04c44163bcd8363816f04658f8b5ad279958aa6b9a21e64
-  data.tar.gz: caab1eb1555492e0bcc7342baa2b7c5a48c1a5606a172dee3d4983b617572940ce04d5cfda2b1d966da073cec0bc35b71c060435a5354126d265b3e43148fc5f
+  metadata.gz: db5eb9e927864afd49fc424be4d97f0e99f206e967605a878da19e8ae150a1ea13b25dab5a4a93773653765933c1e191e4da2c19496d43b6708a37a4aec7e758
+  data.tar.gz: be6a7c9fc5570bc8bc88483f2d7afcf757cf8d8153128b3f3fb6aa90bf54faaaff5b8a2236d68be7ee03692b40b6b5c97d36494f4c1ccb622fea5d96e408514e

data/examples/303_new_component_syntax.poml

@@ -0,0 +1,45 @@
+<poml>
+  <!-- New syntax using standalone components -->
+  <output-schema parser="json">
+    {
+      "type": "object",
+      "properties": {
+        "analysis": {
+          "type": "object",
+          "properties": {
+            "sentiment": { "type": "string", "enum": ["positive", "negative", "neutral"] },
+            "confidence": { "type": "number", "minimum": 0, "maximum": 1 },
+            "key_themes": { "type": "array", "items": { "type": "string" } }
+          },
+          "required": ["sentiment", "confidence", "key_themes"]
+        },
+        "summary": { "type": "string" }
+      },
+      "required": ["analysis", "summary"]
+    }
+  </output-schema>
+
+  <tool-definition name="search_web" description="Search the web for information" parser="json">
+    {
+      "type": "object",
+      "properties": {
+        "query": { "type": "string", "description": "Search query" },
+        "max_results": { "type": "integer", "minimum": 1, "maximum": 10, "default": 5 }
+      },
+      "required": ["query"]
+    }
+  </tool-definition>
+
+  <role>Expert Text Analyst</role>
+  
+  <task>
+    Analyze the provided text and return structured insights including sentiment analysis, 
+    key themes, and a summary. Use the search_web tool if you need additional context.
+  </task>
+
+  <p>Text to analyze: "The new product launch exceeded all expectations with overwhelmingly positive customer feedback and record-breaking sales numbers."</p>
+
+  <output-format>
+    Return your analysis in the structured format defined by the output schema.
+  </output-format>
+</poml>

data/lib/poml/components/base.rb

@@ -162,7 +162,12 @@ module Poml
     COMPONENT_MAPPING = {}
 
     def self.render_element(element, context)
-      component_class = COMPONENT_MAPPING[element.tag_name] || TextComponent
+      # Try to find component using multiple key formats for compatibility
+      tag_name = element.tag_name
+      component_class = COMPONENT_MAPPING[tag_name] || 
+                       COMPONENT_MAPPING[tag_name.to_s] || 
+                       COMPONENT_MAPPING[tag_name.to_sym] ||
+                       TextComponent
       component = component_class.new(element, context)
       component.render
     end

data/lib/poml/components/meta.rb

@@ -49,6 +49,12 @@ module Poml
         handle_variables(variables_attr)
       end
       
+      # Handle tool registration via tool attribute
+      tool_attr = get_attribute('tool')
+      if tool_attr
+        handle_tool_registration_with_name(tool_attr)
+      end
+      
       # Handle general metadata attributes
       %w[title description author keywords].each do |attr|
         value = get_attribute(attr)
@@ -86,7 +92,7 @@ module Poml
       
       # Auto-detect format if parser_attr is auto
       if parser_attr == 'auto'
-        parser_attr = content.start_with?('{') ? 'json' : 'expr'
+        parser_attr = content.start_with?('{') ? 'json' : 'eval'
       end
       
       # Handle new 'eval' parser type as alias for 'expr'
@@ -102,6 +108,11 @@ module Poml
       end
       
       if schema
+        # Check if there's already a response schema defined
+        if @context.response_schema
+          raise Poml::Error, "Multiple response schemas are not allowed. Only one response schema per document is supported."
+        end
+        
         # Store the schema directly for simplicity
         @context.response_schema = schema
       end
@@ -113,13 +124,58 @@ module Poml
       # Support both old 'lang' and new 'parser' attributes for compatibility
       parser_attr = get_attribute('parser') || get_attribute('lang', 'auto')
       
-      return unless name
+      content = @element.content.strip
+      
+      # Auto-detect format if parser_attr is auto
+      if parser_attr == 'auto'
+        parser_attr = content.start_with?('{') ? 'json' : 'eval'
+      end
+      
+      # Handle new 'eval' parser type as alias for 'expr'
+      parser_attr = 'expr' if parser_attr == 'eval'
+      
+      schema = case parser_attr.downcase
+      when 'json'
+        parse_json_schema(content)
+      when 'expr'
+        evaluate_expression_schema(content)
+      else
+        nil
+      end
+      
+      if schema
+        @context.tools ||= []
+        
+        # If name and description are provided as attributes, use them
+        if name
+          tool_def = {
+            'name' => name,
+            'description' => description
+          }
+          # Merge in the parsed schema (should include parameters, etc.)
+          tool_def.merge!(schema) if schema.is_a?(Hash)
+        elsif schema.is_a?(Hash) && schema['name']
+          # If the schema contains the full tool definition, use it directly
+          tool_def = schema
+        else
+          # No valid tool definition found
+          return
+        end
+        
+        @context.tools << tool_def
+      end
+    end
+    
+    def handle_tool_registration_with_name(tool_name)
+      description = get_attribute('description')
+      # Support both old 'lang' and new 'parser' attributes for compatibility
+      parser_attr = get_attribute('parser') || get_attribute('lang', 'auto')
       
       content = @element.content.strip
       
       # Auto-detect format if parser_attr is auto
       if parser_attr == 'auto'
-        parser_attr = content.start_with?('{') ? 'json' : 'expr'
+        parser_attr = content.start_with?('{') ? 'json' : 'eval'
       end
       
       # Handle new 'eval' parser type as alias for 'expr'
@@ -138,7 +194,7 @@ module Poml
         @context.tools ||= []
         # Store tool with string keys for JSON compatibility
         tool_def = {
-          'name' => name,
+          'name' => tool_name,
           'description' => description
         }
         # Merge in the parsed schema (should include parameters, etc.)

data/lib/poml/components/output_schema.rb

@@ -0,0 +1,85 @@
+module Poml
+  # OutputSchema component for defining AI response schemas
+  class OutputSchemaComponent < Component
+    def render
+      apply_stylesheet
+      
+      # Support both old 'lang' and new 'parser' attributes for compatibility
+      parser_attr = get_attribute('parser') || get_attribute('lang', 'auto')
+      _name = get_attribute('name')  # May be used for schema naming in future
+      _description = get_attribute('description')  # May be used for schema documentation in future
+      
+      content = @element.content.strip
+      
+      # Auto-detect format if parser_attr is auto
+      if parser_attr == 'auto'
+        parser_attr = content.start_with?('{') ? 'json' : 'eval'
+      end
+      
+      # Handle new 'eval' parser type as alias for 'expr'
+      parser_attr = 'expr' if parser_attr == 'eval'
+      
+      schema = case parser_attr.downcase
+      when 'json'
+        parse_json_schema(content)
+      when 'expr'
+        evaluate_expression_schema(content)
+      else
+        nil
+      end
+      
+      if schema
+        # Check if there's already a response schema defined
+        if @context.response_schema
+          raise Poml::Error, "Multiple output-schema elements are not allowed. Only one response schema per document is supported."
+        end
+        
+        # Store the schema directly for simplicity
+        @context.response_schema = schema
+      end
+      
+      # Meta-like components don't produce output
+      ''
+    end
+    
+    private
+    
+    def parse_json_schema(content)
+      # Apply template substitution first
+      substituted_content = @context.template_engine.substitute(content)
+      
+      begin
+        JSON.parse(substituted_content)
+      rescue JSON::ParserError => e
+        raise Poml::Error, "Invalid JSON schema: #{e.message}"
+      end
+    end
+    
+    def evaluate_expression_schema(content)
+      # Apply template substitution first
+      substituted_content = @context.template_engine.substitute(content)
+      
+      begin
+        # In a real implementation, this would evaluate JavaScript expressions
+        # For now, we'll try to parse as JSON if it looks like JSON, 
+        # otherwise treat it as a placeholder
+        if substituted_content.strip.start_with?('{', '[')
+          JSON.parse(substituted_content)
+        else
+          # This would need a JavaScript engine in a real implementation
+          # For now, return a placeholder that indicates expression evaluation
+          {
+            "_expression" => substituted_content,
+            "_note" => "Expression evaluation not implemented in Ruby gem"
+          }
+        end
+      rescue JSON::ParserError
+        # Return expression as-is if it can't be parsed as JSON
+        {
+          "_expression" => substituted_content,
+          "_note" => "Expression evaluation not implemented in Ruby gem"
+        }
+      end
+    end
+  end
+end

data/lib/poml/components/tool_definition.rb

@@ -0,0 +1,98 @@
+module Poml
+  # ToolDefinition component for registering AI tools
+  class ToolDefinitionComponent < Component
+    def render
+      apply_stylesheet
+      
+      name = get_attribute('name')
+      description = get_attribute('description')
+      # Support both old 'lang' and new 'parser' attributes for compatibility
+      parser_attr = get_attribute('parser') || get_attribute('lang', 'auto')
+      
+      return '' unless name  # Name is required for tools
+      
+      content = @element.content.strip
+      
+      # Auto-detect format if parser_attr is auto
+      if parser_attr == 'auto'
+        parser_attr = content.start_with?('{') ? 'json' : 'eval'
+      end
+      
+      # Handle new 'eval' parser type as alias for 'expr'
+      parser_attr = 'expr' if parser_attr == 'eval'
+      
+      schema = case parser_attr.downcase
+      when 'json'
+        parse_json_schema(content)
+      when 'expr'
+        evaluate_expression_schema(content)
+      else
+        nil
+      end
+      
+      if schema
+        @context.tools ||= []
+        # Store tool with string keys for JSON compatibility
+        tool_def = {
+          'name' => name,
+          'description' => description,
+          'schema' => schema.is_a?(String) ? schema : JSON.generate(schema)
+        }
+        
+        # For compatibility with expected structure, also store as parameters
+        if schema.is_a?(Hash)
+          tool_def['parameters'] = schema
+        end
+        
+        @context.tools << tool_def
+      end
+      
+      # Meta-like components don't produce output
+      ''
+    end
+    
+    private
+    
+    def parse_json_schema(content)
+      # Apply template substitution first
+      substituted_content = @context.template_engine.substitute(content)
+      
+      begin
+        parsed = JSON.parse(substituted_content)
+        # Return the parsed schema directly - don't wrap it
+        parsed
+      rescue JSON::ParserError => e
+        raise Poml::Error, "Invalid JSON schema for tool '#{get_attribute('name')}': #{e.message}"
+      end
+    end
+    
+    def evaluate_expression_schema(content)
+      # Apply template substitution first
+      substituted_content = @context.template_engine.substitute(content)
+      
+      begin
+        # In a real implementation, this would evaluate JavaScript expressions
+        # For now, we'll try to parse as JSON if it looks like JSON, 
+        # otherwise treat it as a placeholder
+        if substituted_content.strip.start_with?('{', '[')
+          parsed = JSON.parse(substituted_content)
+          # Return the parsed schema directly - don't wrap it
+          parsed
+        else
+          # This would need a JavaScript engine in a real implementation
+          # For now, return a placeholder that indicates expression evaluation
+          {
+            "_expression" => substituted_content,
+            "_note" => "Expression evaluation not implemented in Ruby gem"
+          }
+        end
+      rescue JSON::ParserError
+        # Return expression as-is if it can't be parsed as JSON
+        {
+          "_expression" => substituted_content,
+          "_note" => "Expression evaluation not implemented in Ruby gem"
+        }
+      end
+    end
+  end
+end

data/lib/poml/components.rb

@@ -14,6 +14,8 @@ require_relative 'components/media'
 require_relative 'components/utilities'
 require_relative 'components/meta'
 require_relative 'components/template'
+require_relative 'components/output_schema'
+require_relative 'components/tool_definition'
 
 module Poml
   # Update the component mapping after all components are loaded
@@ -126,6 +128,14 @@ module Poml
     # Meta components
     meta: MetaComponent,
     Meta: MetaComponent,
+    'output-schema': OutputSchemaComponent,
+    'outputschema': OutputSchemaComponent,
+    OutputSchema: OutputSchemaComponent,
+    'tool-definition': ToolDefinitionComponent,
+    'tooldefinition': ToolDefinitionComponent,
+    ToolDefinition: ToolDefinitionComponent,
+    tool: ToolDefinitionComponent,  # 'tool' is an alias for 'tool-definition'
+    Tool: ToolDefinitionComponent,
     
     # Template components
     include: IncludeComponent,

data/lib/poml/parser.rb

@@ -236,7 +236,8 @@ module Poml
     def preprocess_void_elements(content)
       # List of HTML void elements that should be self-closing in XML
       # Note: 'meta' is removed from this list because POML meta components can have content
-      void_elements = %w[br hr img input area base col embed link param source track wbr]
+      # Note: 'input' is removed because POML input components (for examples) can have content
+      void_elements = %w[br hr img area base col embed link param source track wbr]
       
       # Convert <element> to <element/> for void elements, but only if not already self-closing
       void_elements.each do |element|

data/lib/poml/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Poml
-  VERSION = "0.0.5"
+  VERSION = "0.0.6"
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: poml
 version: !ruby/object:Gem::Version
-  version: 0.0.5
+  version: 0.0.6
 platform: ruby
 authors:
 - Ghennadii Mirosnicenco
 bindir: bin
 cert_chain: []
-date: 2025-08-21 00:00:00.000000000 Z
+date: 2025-08-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rexml
@@ -64,6 +64,7 @@ files:
 - examples/301_generate_poml.poml
 - examples/301_new_schema_syntax.poml
 - examples/302_schema_compatibility.poml
+- examples/303_new_component_syntax.poml
 - examples/README.md
 - examples/assets/101_jerry_mouse.jpg
 - examples/assets/101_tom_and_jerry.docx
@@ -110,9 +111,11 @@ files:
 - lib/poml/components/lists.rb
 - lib/poml/components/media.rb
 - lib/poml/components/meta.rb
+- lib/poml/components/output_schema.rb
 - lib/poml/components/styling.rb
 - lib/poml/components/template.rb
 - lib/poml/components/text.rb
+- lib/poml/components/tool_definition.rb
 - lib/poml/components/utilities.rb
 - lib/poml/components/workflow.rb
 - lib/poml/components_new.rb