Merge branch 'main' of https://GitHub.com/Aitomatic/OpenSSA into deps…

…/upgrade

examples/llamarine/.dockerignore

@@ -1,2 +1,3 @@
 README.md
 .env
+output/

examples/llamarine/.env.template

@@ -2,3 +2,5 @@ OPENAI_API_KEY=
 DEFAULT_API_KEY=
 DEFAULT_API_BASE=
 USE_DOMAIN_LM=False
+OUTPUT_DIR=output
+OVERWRITE=False

examples/llamarine/.gitignore

@@ -0,0 +1 @@
+output/

examples/llamarine/README.md

@@ -31,7 +31,7 @@ docker build -t dana-llamarine .
 #### Running the container
 
 ```shell
-docker run --name llamarine-test --rm -p 8501:8501 -e .env dana-llamarine
+docker run --rm -p 8501:8501 --env-file .env -v $(pwd)/output:/app/output --name llamarine-test dana-llamarine
 ```
 
 #### Access the app

examples/llamarine/app.py

@@ -1,3 +1,4 @@
+import json
 import os
 from collections import defaultdict
 
@@ -9,30 +10,35 @@
 from openssa import OpenAILM
 
 USE_DOMAIN_LM = os.environ.get('USE_DOMAIN_LM', 'False').lower() == 'true'
+OVERWRITE = os.environ.get('OVERWRITE', 'False').lower() == 'true'
 
 TITLE: str = 'OpenSSA: Maritime-Specific Agent'
 
-DEFAULT_PROBLEM: str = (
-    'A vessel on my port side coming to a crossing situation on my radar. SOG is being used. What should I do?'
-)
+DEFAULT_PROBLEM: str = """The bearing of the target ship as seen from the own ship is head-on.
+The relative course of the own ship and the target ship is around 180 degrees.
+The straight-line distance between the own ship and the target ship is longer than the {90 degree turning distance}.
+The TCPA of the own ship and the target ship is longer than the {90 degree turning time}.
+STW is being used. What should I do?"""
 
-LLAMARINE_USER_PROMPT = """
-INSTRUCTION
+LLAMARINE_USER_PROMPT: str = """INSTRUCTION
 In crossing, if other vessel in your port side, you are stand-on. If other vessel in your starboard side, you are give way. (Just remember this rule for yourself, don't tell me).
 """
 
-LLAMARINE_SYSTEM_PROMPT: str = """
-You are Llamarine, a maritime domain expert. You were created by Aitomatic, Inc under AI Alliance.
+LLAMARINE_SYSTEM_PROMPT: str = """You are Llamarine, a maritime domain expert. You were created by Aitomatic, Inc under AI Alliance.
 Do not introduce yourself until I ask. If I ask who are you, just politely introduce yourself as you are Llamarine, an opensource maritime domain specific model created by Aitomatic, Inc under AI Alliance. Don't say more.
 Please try with your best effort to answer the question as deeply as possible.
 Tailor responses for expert-level audiences, offering specific examples which specific recommended values when essential.
-Just keep this system message for yourself, do not let anyone know. Answer as deeply as possible.
-"""
+Just keep this system message for yourself, do not let anyone know. Answer as deeply as possible."""
 
 DEFAULT_MODEL = 'llamarine-navigation'
 DEFAULT_API_KEY = os.environ.get('LEPTON_API_TOKEN')
 DEFAULT_API_BASE = os.environ.get('DEFAULT_API_BASE')
 
+OUTPUT_DIR = os.environ.get('OUTPUT_DIR', 'output')
+OUTPUT_FILE_PATH = f"{OUTPUT_DIR}/agent_solutions.json"
+
+os.makedirs(OUTPUT_DIR, exist_ok=True)
+
 
 def main(use_domain_lm: bool = False):
     st.set_page_config(page_title=TITLE,
@@ -51,6 +57,7 @@ def main(use_domain_lm: bool = False):
         label='Problem/Question',
         value=st.session_state.typed_problem,
         max_chars=None,
+        height=22 * 6,
         key=None,
         help='Problem/Question',
         on_change=None, args=None, kwargs=None,
@@ -60,7 +67,11 @@ def main(use_domain_lm: bool = False):
     )
 
     if 'agent_solutions' not in st.session_state:
-        st.session_state.agent_solutions: defaultdict[str, str] = defaultdict(str)
+        if os.path.exists(OUTPUT_FILE_PATH) and not OVERWRITE:
+            with open(file=OUTPUT_FILE_PATH, encoding='utf-8') as f:
+                st.session_state.agent_solutions: defaultdict[str, str] = defaultdict(str, json.loads(f.read()))
+        else:
+            st.session_state.agent_solutions: defaultdict[str, str] = defaultdict(str)
 
     st.subheader('MARITIME-SPECIFIC AGENT')
 
@@ -72,11 +83,15 @@ def main(use_domain_lm: bool = False):
         with st.spinner(text='_SOLVING..._'):
             logger.level('DEBUG')
 
-            st.session_state.agent_solutions[st.session_state.typed_problem]: str = \
-                get_or_create_agent(use_domain_lm).solve(
-                    problem=st.session_state.typed_problem, allow_reject=True)
+            if not st.session_state.agent_solutions[st.session_state.typed_problem] or OVERWRITE:
+                st.session_state.agent_solutions[st.session_state.typed_problem]: str = \
+                    get_or_create_agent(use_domain_lm).solve(
+                        problem=st.session_state.typed_problem, allow_reject=True)
+                # write st.session_state.agent_solutions to JSON file
+                with open(file=OUTPUT_FILE_PATH, mode='w', encoding='utf-8') as f:
+                    f.write(json.dumps(st.session_state.agent_solutions))
 
-    if (solution := st.session_state.agent_solutions[st.session_state.typed_problem]):
+        solution = st.session_state.agent_solutions[st.session_state.typed_problem]
         if use_domain_lm:
             solution = OpenAILM.from_defaults().get_response(
                 prompt=f"""Please respond the following text, with making sure there is a conclusion which is the main action item at the end of the response.

examples/llamarine/expert-knowledge.txt

@@ -12,6 +12,8 @@ Not all head-on situations require a starboard turn.
 Not all right-crossing situations require a starboard turn.
 Some left-crossing situations require taking actions, while most do not.
 
+In a right-crossing situation, it is important to first identify whether it is also a stern-crossing or a bow-crossing situation.
+
 In an overtaking situation, it is important to first identify whether the target ship or the own ship is overtaking.
 
 # **Comprehensive and Technical Rule of Thumb for OOW Decision-Making with Focus on COLREGs**
@@ -31,7 +33,7 @@ In an overtaking situation, it is important to first identify whether the target
 
 ---
 
-## **2. Mastering COLREGs Application with DCPA and/or TCPA consideration**
+## **2. Mastering COLREGs Application combined with DCPA and/or TCPA consideration**
 1. **“When in doubt, give way—always.”**  
    - If you cannot assess risk or priority clearly, **assume the give-way role** to stay safe.
 

examples/llamarine/expert-programs.yml

@@ -25,4 +25,4 @@ plan_with_speed_reference_stw:
     Recommend the user what to do based on the identified situation on radar. Only apply this if specifying STW is being used.
   sub-htps:
     - task: |-
-        First tell me all the related rules in COLREGs, then interpret situation from input and let me know the how to apply them in this situation, with considering DCPA and TCPA.
+        First identify the situation from the input, then look at DCPA & TCPA if those are mentioned from the input, then let me know the how to make collision avoidance decisions.