cpee-llm 1.0.6 → 1.2.2

data/README.md

@@ -152,6 +152,7 @@ Performs arbitrary LLM tasks using a system prompt and user input.
 | system_prompt | text/plain |
 | format | text/plain (`true`/`false`) |
 | temperature | text/plain (optional) |
+| documents | `*/*` (optional, repeatable) |
 
 ## Response
 
@@ -168,6 +169,7 @@ Performs arbitrary LLM tasks using a system prompt and user input.
 ### Notes
 
 - `format=true` requests JSON output (guarantees valid JSON but not any specific structure).
+- `documents` can be repeated to attach one or more files (e.g. images, PDFs, office documents, plain text) to the request, sent as multipart file parts. Attachments are passed through to the LLM alongside `user_input`; support depends on the selected model/provider.
 
 List of supporteb providers: https://rubyllm.com/chat/#getting-structured-output
 
@@ -182,4 +184,17 @@ curl -X POST https://cpee.org/llm/generic/ \
   -F "format=false;type=text/plain"
 ```
 
+With attached documents:
+
+```bash
+curl -X POST https://cpee.org/llm/generic/ \
+  -H 'Content-Type:multipart/form-data' \
+  -F "llm=gemini-2.5-flash-lite;type=text/plain" \
+  -F "user_input=Summarize the attached document.;type=text/plain" \
+  -F "system_prompt=Return the summary as bullet points.;type=text/plain" \
+  -F "format=false;type=text/plain" \
+  -F "documents=@report.pdf;type=application/pdf" \
+  -F "documents=@chart.png;type=image/png"
+```
+
 ---

data/cpee-llm.gemspec

@@ -1,13 +1,13 @@
 Gem::Specification.new do |s|
   s.name             = "cpee-llm"
-  s.version          = "1.0.6"
+  s.version          = "1.2.2"
   s.platform         = Gem::Platform::RUBY
-  s.license          = "LGPL-3.0-or-later"
+  s.license          = "GPL-3.0-or-later"
   s.summary          = "CPEE Conversational Agents"
 
   s.description      = "see http://cpee.org"
 
-  s.files            = Dir['{server/*,tools/**/*,lib/**/*}'] + %w(LICENSE Rakefile cpee-llm.gemspec README.md AUTHORS)
+  s.files            = Dir['{server/*,tools/**/*,lib/**/*}'] - Dir['lib/cpee/llm/prompts/legacy{,/**/*}'] + %w(LICENSE Rakefile cpee-llm.gemspec README.md AUTHORS)
   s.require_path     = 'lib'
   s.extra_rdoc_files = ['README.md']
   s.bindir           = 'tools'

data/lib/cpee/llm/dataflow.rb

@@ -1,16 +1,16 @@
 # This file is part of CPEE-LLM.
 #
 # CPEE-LLM is free software: you can redistribute it and/or modify it under the
-# terms of the GNU Lesser General Public License as published by the Free
+# terms of the GNU General Public License as published by the Free
 # Software Foundation, either version 3 of the License, or (at your option) any
 # later version.
 #
 # CPEE-LLM is distributed in the hope that it will be useful, but WITHOUT ANY
 # WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
-# A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
+# A PARTICULAR PURPOSE. See the GNU General Public License for more
 # details.
 #
-# You should have received a copy of the GNU Lesser General Public License
+# You should have received a copy of the GNU General Public License
 # along with CPEE-LLM (file LICENSE in the main directory). If not, see
 # <http://www.gnu.org/licenses/>.
 

data/lib/cpee/llm/functions.rb

@@ -1,16 +1,16 @@
 # This file is part of CPEE-LLM.
 #
 # CPEE-LLM is free software: you can redistribute it and/or modify it under the
-# terms of the GNU Lesser General Public License as published by the Free
+# terms of the GNU General Public License as published by the Free
 # Software Foundation, either version 3 of the License, or (at your option) any
 # later version.
 #
 # CPEE-LLM is distributed in the hope that it will be useful, but WITHOUT ANY
 # WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
-# A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
+# A PARTICULAR PURPOSE. See the GNU General Public License for more
 # details.
 #
-# You should have received a copy of the GNU Lesser General Public License
+# You should have received a copy of the GNU General Public License
 # along with CPEE-LLM (file LICENSE in the main directory). If not, see
 # <http://www.gnu.org/licenses/>.
 
@@ -45,15 +45,9 @@ module CPEE
         trans.generate_model(CPEE::Transformation::Target::CPEE)
       end #}}}
 
-      def generate_model(myllm,user_input,temperature,llms) #{{{
+      def error_handler #{{{
         begin
-          llm_response = generate_mermaid_model(myllm,user_input,temperature,llms)
-          # raise exceptions if response is empty for some reason
-          if llm_response.nil? || llm_response.empty?
-            raise LLMError.new("Something went wrong and your content was not generated!", 500)
-          else
-            return llm_response
-          end
+          yield
         rescue LLMError => e_llm
           e_llm.message
           raise e_llm
@@ -63,28 +57,42 @@ module CPEE
         end
       end #}}}
 
+      def generate_model(myllm,user_input,temperature,llms) #{{{
+        error_handler do
+          system_prompt = build_system_prompt("generate_mermaid.txt")
+          user_prompt = build_user_prompt("generate_mermaid.txt", user_input:)
+          llm_response = generate_content(myllm,system_prompt,user_prompt,4000,temperature,llms)
+          # raise exceptions if response is empty for some reason
+          if llm_response.nil? || llm_response.empty?
+            raise LLMError.new("Something went wrong and your content was not generated!", 500)
+          else
+            return llm_response
+          end
+        end
+      end #}}}
+
       def adapt_model(myllm,doc,user_input,llms) #{{{
         input_cpee = doc.to_s()
         input_mermaid = cpee_to_mermaid(doc.to_s())
-        begin
-          llm_response = adapt_mermaid_model(myllm,user_input,input_mermaid,llms)
+        error_handler do
+          system_prompt = build_system_prompt("adapt_mermaid.txt")
+          user_prompt = build_user_prompt("adapt.txt", user_input:, process_model: input_mermaid)
+          llm_response = generate_content(myllm,system_prompt,user_prompt,4000,0,llms)
           # raise exceptions if response is empty for some reason
           if llm_response.nil? || llm_response.empty?
             raise LLMError.new("Something went wrong and your content was not generated!", 500)
           else
             return llm_response
           end
-        rescue LLMError => e_llm
-          raise e_llm
-        rescue Exception => e
-          raise e
         end
       end #}}}
 
       def adapt_doccpee_description(myllm,doc,user_input,llms) #{{{
         input_cpee = doc.to_s()
-        begin
-          llm_response = adapt_docxml_description(myllm,user_input,input_cpee,llms)
+        error_handler do
+          system_prompt = build_system_prompt("adapt_xml_documentation.txt")
+          user_prompt = build_user_prompt("adapt.txt", user_input:, process_model: input_cpee)
+          llm_response = generate_content(myllm,system_prompt,user_prompt,16000,0,llms)
           # raise exceptions if response is empty for some reason
           if llm_response.nil? || llm_response.empty?
             raise LLMError.new("Something went wrong and your content was not generated!", 500)
@@ -100,27 +108,20 @@ module CPEE
             end
             return llm_response
           end
-        rescue LLMError => e_llm
-          raise e_llm
-        rescue Exception => e
-          raise e
         end
       end #}}}
 
       def adapt_cpee_model(myllm,doc,user_input,existing_endpoints,endpoints,llms) #{{{
-        testset = XML::Smart.string(<<~XML)
-          <testset xmlns="http://cpee.org/ns/properties/2.0">
-          </testset>
-        XML
+        testset = XML::Smart.string('<testset xmlns="http://cpee.org/ns/properties/2.0"></testset>')
         root = testset.root
         root.add(existing_endpoints.root)
         dslx = root.add("dslx")
         dslx.add(doc.root)
 
-        #puts testset.to_s
-
-        begin
-          llm_response = adapt_xml_model(myllm,user_input,testset,endpoints,llms)
+        error_handler do
+          system_prompt = build_system_prompt("adapt_xml_endpoints.txt")
+          user_prompt = build_user_prompt("adapt_xml_endpoints.txt", user_input:, process_model: testset, api_specification: endpoints)
+          llm_response = generate_content(myllm,system_prompt,user_prompt,15000,0,llms)
           # raise exceptions if response is empty for some reason
           if llm_response.nil? || llm_response.empty?
             raise LLMError.new("Something went wrong and your content was not generated!", 500)
@@ -136,54 +137,42 @@ module CPEE
             end
             return llm_response
           end
-        rescue LLMError => e_llm
-          raise e_llm
-        rescue Exception => e
-          raise e
         end
       end #}}}
 
       def generate_text(myllm,doc,llms) #{{{
         input_cpee = doc.to_s()
         input_mermaid = cpee_to_mermaid(doc.to_s())
-        begin
-          llm_response = generate_plain_text(myllm,input_mermaid,llms)
+        error_handler do
+          system_prompt = build_system_prompt("describe_text.txt")
+          user_prompt = build_user_prompt("describe_text.txt", user_input: input_mermaid)
+          llm_response = generate_content(myllm,system_prompt,user_prompt,4000,0,llms)
           # raise exceptions if response is empty for some reason
           if llm_response.nil? || llm_response.empty?
             raise LLMError.new("Something went wrong and your content was not generated!", 500)
           else
             return llm_response
           end
-        rescue LLMError => e_llm
-          e_llm.message
-          raise e_llm
-        rescue Exception => e
-          e.message
-          raise e
         end
       end #}}}
 
-      def generate_generic(myllm,user_input,system_prompt,format,temperature,llms) #{{{
-        begin
-          llm_response = generate_generic_content(myllm, user_input, system_prompt, format, temperature, llms)
+      def generate_generic(myllm,user_input,system_prompt,format,temperature,documents,llms) #{{{
+        error_handler do
+          llm_response = generate_content(myllm, system_prompt, user_input, 16000, temperature, llms, format == 'true' ? { json: true } : {}, documents)
           # raise exceptions if response is empty for some reason
           if llm_response.nil? || llm_response.empty?
             raise LLMError.new("Something went wrong and your content was not generated!", 500)
           else
             return llm_response
           end
-        rescue LLMError => e_llm
-          e_llm.message
-          raise e_llm
-        rescue Exception => e
-          e.message
-          raise e
         end
       end #}}}
 
       def generate_dataflow(myllm,mermaid_model,api_specification,llms) #{{{
-        begin
-          llm_response = generate_dataflow_content(myllm, mermaid_model, api_specification, llms)
+        error_handler do
+          system_prompt = build_system_prompt("dataflow.txt")
+          user_prompt = build_user_prompt("dataflow.txt", mermaid_model:, api_specification:)
+          llm_response = generate_content(myllm, system_prompt, user_prompt, 4000, 0.1, llms)
           # raise exceptions if response is empty for some reason
           if llm_response.nil? || llm_response.empty?
             raise LLMError.new("Something went wrong and your content was not generated!", 500)
@@ -201,36 +190,28 @@ module CPEE
             end
             return llm_response
           end
-        rescue LLMError => e_llm
-          e_llm.message
-          raise e_llm
-        rescue Exception => e
-          e.message
-          raise e
         end
       end #}}}
 
       def generate_endpoint_model(myllm,user_input,endpoints,llms) #{{{
-        begin
-          llm_response = generate_endpoint_mermaid_model(myllm,user_input,endpoints,llms)
+        error_handler do
+          system_prompt = build_system_prompt("generate_mermaid_endpoints.txt")
+          user_prompt = build_user_prompt("generate_mermaid_endpoints.txt", user_input:, endpoints:)
+          llm_response = generate_content(myllm,system_prompt,user_prompt,4000,0.1,llms)
           # raise exceptions if response is empty for some reason
           if llm_response.nil? || llm_response.empty?
             raise LLMError.new("Something went wrong and your content was not generated!", 500)
           else
             return llm_response
           end
-        rescue LLMError => e_llm
-          e_llm.message
-          raise e_llm
-        rescue Exception => e
-          e.message
-          raise e
         end
       end #}}}
 
       def validate_cpee_model(myllm,cpee_model,llms) #{{{
-        begin
-          llm_response = validate_xml_model(myllm,cpee_model,llms)
+        error_handler do
+          system_prompt = build_system_prompt("validate_xml.txt")
+          user_prompt = build_user_prompt("validate_xml.txt", cpee_model:)
+          llm_response = generate_content(myllm,system_prompt,user_prompt,0,0.1,llms)
           if llm_response.nil? || llm_response.empty?
             raise LLMError.new("Something went wrong and your content was not generated!", 500)
           elsif llm_response.strip.downcase == "perfect"
@@ -243,16 +224,38 @@ module CPEE
             begin
               XML::Smart.string(llm_response)
             rescue Nokogiri::XML::SyntaxError => e
-              raise LLMError.new("Something went wrong and llm was not able to generate valid xml model", llm_response)
+              raise LLMError.new("Something went wrong and llm was not able to generate valid xml model", 500)
             end
             return llm_response
           end
-        rescue LLMError => e_llm
-          e_llm.message
-          raise e_llm
-        rescue Exception => e
-          e.message
-          raise e
+        end
+      end #}}}
+
+      def guess_intent(myllm,user_input,plugins,llms) #{{{
+        plugs = File.read(plugins)
+        error_handler do
+          system_prompt = build_system_prompt("intent.txt")
+          user_prompt = build_user_prompt("intent.txt", user_input:, plugins: plugs)
+          response = generate_content(myllm,system_prompt,user_prompt,4000,0.1,llms,{ json: true })
+          if response.nil? || response.empty?
+            raise LLMError.new("Something went wrong and your content was not generated!", 500)
+          else
+            result = JSON::parse(response)
+            if result.is_a?(Hash) && result["id"]
+              plugin_list = JSON::parse(plugs)
+              plugin = plugin_list.find { |p| p["id"] == result["id"] }
+              if plugin
+                plugin.each do |k,v|
+                  result[k] = v unless k == "description"
+                end
+                result
+              else
+                nil
+              end
+            else
+              result
+            end
+          end
         end
       end #}}}
 

data/lib/cpee/llm/implementation.rb

@@ -1,16 +1,16 @@
 # This file is part of CPEE-LLM.
 #
 # CPEE-LLM is free software: you can redistribute it and/or modify it under the
-# terms of the GNU Lesser General Public License as published by the Free
+# terms of the GNU General Public License as published by the Free
 # Software Foundation, either version 3 of the License, or (at your option) any
 # later version.
 #
 # CPEE-LLM is distributed in the hope that it will be useful, but WITHOUT ANY
 # WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
-# A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
+# A PARTICULAR PURPOSE. See the GNU General Public License for more
 # details.
 #
-# You should have received a copy of the GNU Lesser General Public License
+# You should have received a copy of the GNU General Public License
 # along with CPEE-LLM (file LICENSE in the main directory). If not, see
 # <http://www.gnu.org/licenses/>.
 
@@ -41,7 +41,6 @@ module CPEE
         temperature = @p.shift.value.read if @p[0]&.name == 'temperature'
 
         doc = XML::Smart.string(input_cpee)
-        pp prompt_type
         begin
           output_cpee = if prompt_type == 'generate_noendpoints' || prompt_type == 'generate_noendpoints_docdescription'
             llm_response = generate_model(myllm,user_input,temperature,llms)
@@ -64,7 +63,7 @@ module CPEE
           return Riddl::Parameter::Complex.new('llm_out', 'application/json', { error: e }.to_json)
         end
 
-        return(Riddl::Parameter::Complex.new("llm_out","application/json",{:user_input => user_input, :used_llm => myllm, :input_cpee => input_cpee, :input_intermediate => doc.root().empty?() ? "" : cpee_to_mermaid(doc.to_s()), :output_intermediate => llm_response, :output_cpee => output_cpee, :status => "Success"}.to_json()))
+        return Riddl::Parameter::Complex.new("llm_out","application/json",{:user_input => user_input, :used_llm => myllm, :input_cpee => input_cpee, :input_intermediate => doc.root().empty?() ? "" : cpee_to_mermaid(doc.to_s()), :output_intermediate => llm_response, :output_cpee => output_cpee, :status => "Success"}.to_json())
       rescue LLMError => e
         @status = e&.http_response || 400
         return Riddl::Parameter::Complex.new("llm_out","application/json",{ :error => "#{prompt_type} #{e.message}"}.to_json())
@@ -115,18 +114,20 @@ module CPEE
         llms = @a[0]
         #get parameters
         begin
-          myllm = @p[0].value.read
-          user_input = @p[1].value.read
-          system_prompt = @p[2].value.read
-          format = @p[3].value.read
-          temperature = @p[4]&.value&.read
+          myllm         = @p.shift.value.read
+          user_input    = @p.shift.value.read
+          system_prompt = @p.shift.value.read
+          format        = @p.shift.value.read
+          temperature   = @p.shift.value.read if @p[0]&.name == 'temperature'
+          documents     = []
+          documents << @p.shift while @p[0]&.name == 'document'
         rescue Exception => e
           @status = 400
           return Riddl::Parameter::Complex.new("generic_out","application/json",{:error => e}.to_json())
         end
 
         begin
-          llm_response = generate_generic(myllm,user_input,system_prompt,format,temperature,llms)
+          llm_response = generate_generic(myllm,user_input,system_prompt,format,temperature,documents,llms)
         rescue LLMError => e
           @status = e.http_response
           return Riddl::Parameter::Complex.new("generic_out","application/json",{:error => e.message}.to_json())
@@ -198,36 +199,61 @@ module CPEE
           llm_response = validate_cpee_model(myllm,input_cpee,llms)
         rescue LLMError => e
           @status = e.http_response
-          return Riddl::Parameter::Complex.new("generic_out","application/json",{:error => e.message}.to_json())
+          return Riddl::Parameter::Complex.new("llm_out","application/json",{:error => e.message}.to_json())
         end
 
         return(Riddl::Parameter::Complex.new("llm_out","application/json",{:used_llm => myllm, :output_cpee => llm_response, :status => "Success"}.to_json()))
       end
     end #}}}
 
+    class GuessIntent < Riddl::Implementation #{{{
+      include Functions
+
+      def response
+        llms = @a[0]
+        plugins = @a[1]
+
+        input_cpee = @p[0].value.read
+        myllm = @p[1].value.read
+
+        begin
+          response = guess_intent(myllm,input_cpee,plugins,llms)
+        rescue LLMError => e
+          @status = e.http_response
+          return Riddl::Parameter::Complex.new("user_intent","application/json",{:error => e.message}.to_json())
+        end
+
+        Riddl::Parameter::Complex.new("user_intent","application/json",response.to_json())
+      end
+    end #}}}
+
     def self::implementation(opts)
       Proc.new do
         on resource do
-          run(CreateMermaid, opts[:llms]) if post 'llm_in'
+          run CreateMermaid, opts[:llms] if post 'llm_in'
 
           on resource 'dataflow' do
-            run(CreateDataFlow, opts[:llms]) if post 'dataflow_in'
+            run CreateDataFlow, opts[:llms] if post 'dataflow_in'
           end
 
           on resource 'validate' do
             on resource 'xml' do
-              run(ValidateDataFlow, opts[:llms]) if post 'dataflow_in'
+              run ValidateDataFlow, opts[:llms] if post 'dataflow_in'
             end
           end
 
           on resource 'text' do
             on resource 'llm' do
-              run(CreateText, opts[:llms]) if post 'text_in'
+              run CreateText, opts[:llms] if post 'text_in'
             end
           end
 
+          on resource 'intent' do
+            run GuessIntent, opts[:llms], opts[:plugins] if post 'intent_in'
+          end
+
           on resource 'generic' do
-            run(CreateGeneric, opts[:llms]) if post 'generic_in'
+            run CreateGeneric, opts[:llms] if post 'generic_in'
           end
         end
       end

data/lib/cpee/llm/implementation.xml

@@ -2,16 +2,17 @@
   This file is part of CPEE-LLM.
 
   CPEE-LLM is free software: you can redistribute it and/or modify it under the
-  terms of the GNU General Public License as published by the Free Software
-  Foundation, either version 3 of the License, or (at your option) any later
-  version.
+  terms of the GNU General Public License as published by the Free
+  Software Foundation, either version 3 of the License, or (at your option) any
+  later version.
 
   CPEE-LLM is distributed in the hope that it will be useful, but WITHOUT ANY
   WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
-  A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
+  A PARTICULAR PURPOSE. See the GNU General Public License for more
+  details.
 
-  You should have received a copy of the GNU General Public License along with
-  CPEE-LLM (file LICENSE in the main directory). If not, see
+  You should have received a copy of the GNU General Public License
+  along with CPEE-LLM (file LICENSE in the main directory). If not, see
   <http://www.gnu.org/licenses/>.
 -->
 
@@ -35,9 +36,35 @@
     <parameter name="rpst_xml" mimetype="application/json"/>
   </message>
 
+  <message name="intent_in">
+    <parameter name="user_input" mimetype="text/plain"/>
+    <parameter name="llm" mimetype="text/plain"/>
+  </message>
+
+  <message name="intent_out">
+    <parameter name="user_intent" mimetype="application/json"/>
+    <!--
+      prompt/user/intent.txt
+      prompt/system/intent.txt
+
+      output: json
+      {
+        url: // url to call
+        required_input: {
+          text: // typically extracted from user_input
+          documents: { name: value, }, // documents to pass
+          model: true|false,
+          message_id: '' // input is then the message
+        }
+        output_template: ... // the output text when calling url is written into this template where the %%% is. If the output of calling url is a json, insert multiple %%%name.
+        output: 'chat|process|reintent' // write to chat, give to the normal pipeline, or pass the output to the intention service again
+      }
+    -->
+  </message>
+
   <message name="text_in">
     <parameter name="rpst_xml" mimetype="*/xml"/>
-    <parameter name="llm" type="string"/>
+    <parameter name="llm" mimetype="text/plain"/>
   </message>
   <message name="text_out">
     <parameter name="output_text" mimetype="application/json"/>
@@ -51,6 +78,9 @@
     <optional>
       <parameter name="temperature" mimetype="text/plain"/>
     </optional>
+    <zeroOrMore>
+      <parameter name="document" mimetype="*"/>
+    </zeroOrMore>
   </message>
   <message name="generic_out">
     <parameter name="output_text" mimetype="application/json"/>
@@ -68,6 +98,10 @@
       <post in="dataflow_in" out="llm_out"/>
     </resource>
 
+    <resource relative="intent">
+      <post in="intent_in" out="intent_out"/>
+    </resource>
+
     <resource relative="text">
       <resource relative="llm">
         <post in="text_in" out="text_out"/>

data/lib/cpee/llm/prompts/system/adapt_mermaid.txt

@@ -0,0 +1,12 @@
+You are an expert in BPMN modeling, specifically in Mermaid.js format.
+Your task is to validate and transform BPMN models based on user-provided modifications, ensuring compliance with BPMN rules and Mermaid.js syntax.
+You are allowed to adjust only those parts of the process model mentioned in the user-provided modification. Other parts of the model have to stay unchanged.
+
+%%%fragments/mermaid/syntax.txt
+
+The provided process model may contain nodes whose ids are not integers (e.g., a1, g0s) and nodes of type script (e.g., a3:script:(Compute Total)). Keep these ids and types unchanged. Only new nodes get new unique integer ids.
+
+All gateways must have both a split and a merge point.
+Each gateway that initiates a split must be properly closed by a merge gateway of the same type (e.g., an exclusive gateway must be merged by another exclusive gateway).
+
+Return only mermaid.js as text without any additional information! Give me just the raw Mermaid.js code without markdown formatting.

data/lib/cpee/llm/prompts/system/adapt_xml_documentation.txt

@@ -0,0 +1,50 @@
+You are an expert BPMN 2.0 process model editor for the CPEE XML process description language.
+Your task is to modify an existing CPEE XML process model according to the user's natural-language modification request.
+The user will always provide:
+* an existing valid CPEE XML process model;
+* one or more textual modification requests;
+
+Core Objective
+Your task is to produce a modified CPEE XML process model that implements the requested changes.
+Only modify the parts of the process that are explicitly or necessarily affected by the user's request.
+Do not redesign, simplify, optimize, refactor, or rewrite unrelated parts of the model.
+Never remove existing functionality unless explicitly requested.
+Never introduce additional behavior that was not requested.
+
+Editing Workflow
+Internally perform the following steps:
+1. Parse the existing CPEE XML description.
+2. Parse the workflow contained in the description element.
+3. Understand the user's requested modifications.
+4. Determine which workflow elements are affected.
+5. Apply only the requested changes.
+6. Update documentation flow if necessary.
+7. Generate the complete updated CPEE XML description.
+
+%%%fragments/cpee_xml.txt
+%%%fragments/cpee_xml/documentation.txt
+
+For the purpose of modelling, arguments can be ignored and don't have to carry any values. Code also can be left empty. If an argument is given a value that refers to process data, it must use the !data.some_value syntax described above.
+
+# Handling Ambiguity
+If the user's request is sufficiently precise, perform the modification directly.
+If multiple valid interpretations exist and the missing information affects the resulting workflow, select the best possible interpretation and perform changes.
+
+# Important
+If user deletes a single task in a branch, remove task but leave the branch. Use default branch.
+eid attributes are IDs. All eid attributes have to be unique for the whole XML and start with an e followed by a number, e.g., "e1".
+id attributes are IDs. All id attributes have to be unique for the whole XML and start with an a followed by a number, e.g., "a1".
+Don't change ANY existing id's or eid's. Only generate new unique id's or eid's for new nodes which have id's or eid's.
+Don't change existing nodes, even when you move them. For example don't add documentation if it is not there.
+
+# Output Requirements
+  Return the complete updated CPEE XML process model.
+  Preserve the overall document structure.
+  Modify only the elements affected by the user's request.
+  Return the entire XML document, including unchanged sections.
+  Do not explain the modifications.
+  Do not summarize the changes.
+  Do not output Markdown.
+  Do not omit unchanged sections.
+  The returned XML must be immediately usable as a valid CPEE process model.
+