Merge branch 'refs/heads/dev'

# Conflicts:
#	openbrain/tools/obtool.py
#	openbrain/tools/tool_event_mesh_tester.py
#	openbrain/tools/tool_input_and_context_tester.py
#	openbrain/tools/tool_leadmo_create_appointment.py
#	openbrain/tools/tool_leadmo_create_contact.py
#	openbrain/tools/tool_leadmo_get_contact_info_from_context.py
#	openbrain/tools/tool_leadmo_get_simple_calendar_appointment_slots.py
#	openbrain/tools/tool_leadmo_stop_conversation.py
#	openbrain/tools/tool_leadmo_update_contact.py
#	openbrain/tools/tool_lls_scrub_phone_number.py
#	openbrain/tools/tool_simple_calculator.py

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -1,6 +1,8 @@
 name: 🚀 Feature request
 description: Suggest an idea for this project
 title: "<One feature request per issue>"
+projects:
+  - "svange/openbrain"
 labels: [feature]
 body:
   - type: textarea

.github/workflows/pipeline.yaml

@@ -41,6 +41,7 @@ jobs:
 
   deploy-infrastructure:
     name: Deploy infrastructure
+    if: false
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
@@ -162,13 +163,20 @@ jobs:
       #----------------------------------------------
     - name: Test with pytest
       run: |
-        poetry run pytest tests -m ci_cd
+        poetry run pytest tests -m "not redundant and not tools and not remote_tests"
+
+    - name: upload pytest.log
+      uses: actions/upload-artifact@v4
+      with:
+          name: pytest.log
+          path: pytest.log
+
 
     - name: Skip tests if release commit
       run: echo "Skipping tests for release commit"
 
   publish-prerelease:
-    if: false && github.ref == 'refs/heads/dev'
+    if: github.ref == 'refs/heads/dev'
     needs: [run-tests]
     runs-on: ubuntu-latest
     name: Publish to PyPi test
@@ -271,3 +279,17 @@ jobs:
           pypi_token: ${{ secrets.PYPI_TOKEN }}
           release_branch: ${{ github.ref_name }}
           github_token: ${{ secrets.GH_TOKEN }}
+
+  deploy_docs:
+    needs: [publish-release]
+    uses: ./.github/workflows/publish_docs.yml
+    secrets: inherit
+
+  deploy_docs_prerelease:
+    needs: [publish-prerelease]
+    uses: ./.github/workflows/publish_docs.yml
+    secrets: inherit
+
+  deploy_docs_now:
+    uses: ./.github/workflows/publish_docs.yml
+    secrets: inherit

.github/workflows/publish_docs.yml

@@ -0,0 +1,98 @@
+name: Deploy Sphinx documentation to Pages
+
+on:
+  workflow_call:
+#    inputs:
+#      version:
+#        description: 'Version of the documentation to build'
+#        required: true
+#        type: string
+#    secrets: inherit
+
+env:
+  GH_TOKEN: ${{ secrets.GH_TOKEN }}
+
+jobs:
+  pages:
+    runs-on: ubuntu-20.04
+    steps:
+    - name: print inputs
+      run: |
+        echo ${{ inputs.version }}
+
+      #----------------------------------------------
+      #       check-out repo and set-up python
+      #----------------------------------------------
+    - name: Check out repository
+      uses: actions/checkout@v4
+    - name: Set up python
+      id: setup-python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.10'
+
+      #----------------------------------------------
+      #  -----  install & configure poetry  -----
+      #----------------------------------------------
+    - name: Install Poetry
+      uses: snok/install-poetry@v1
+      with:
+        virtualenvs-create: true
+        virtualenvs-in-project: true
+        installer-parallel: true
+
+      #----------------------------------------------
+      #       load cached venv if cache exists
+      #----------------------------------------------
+    - name: Load cached venv
+
+      id: cached-poetry-dependencies
+      uses: actions/cache@v4
+      with:
+        path: .venv
+        key: venv-${{ runner.os }}-${{ steps.setup-python.outputs.python-version }}-${{ hashFiles('**/poetry.lock') }}
+      #----------------------------------------------
+      # install dependencies if cache does not exist
+      #----------------------------------------------
+    - name: Install dependencies
+      if: steps.cached-poetry-dependencies.outputs.cache-hit != 'true'
+      run: poetry install --no-interaction --no-root
+
+      #----------------------------------------------
+      # install your root project, if required
+      #----------------------------------------------
+    - name: Install project
+      run: poetry install -E docs --no-interaction
+#
+#    - name: Get version
+#      id: put_version_in_file
+#      run: |
+#        echo "---------------------------------------------------------------------------"
+#        poetry run semantic-release version --print-last-released-tag >> last_version.txt
+#        echo "Getting next version"
+#        echo "---------------------------------------------------------------------------"
+#        cat last_version.txt
+#        echo "---------------------------------------------------------------------------"
+#
+#    - name: Set outputs
+#      id: vars
+#      run: echo "last_ver=$(head -n1 last_version.txt)" >> $GITHUB_OUTPUT
+#
+#    - name: Check outputs
+#      run: |
+#        echo "${{ steps.vars.outputs.last_ver }}"
+
+    - name: deploy
+      run: |
+        poetry run sphinx-build -b html ./docs/source ./docs/build
+
+#    - id: deployment
+#      uses: sphinx-notes/pages@v3
+#      with:
+#        publish: false
+#        documentation_path: ./docs/source
+
+    - uses: peaceiris/actions-gh-pages@v4
+      with:
+        github_token: ${{ secrets.GH_TOKEN }}
+        publish_dir: ./docs/build

docs/Makefile

@@ -0,0 +1,20 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line, and also
+# from the environment for the first two.
+SPHINXOPTS    ?=
+SPHINXBUILD   ?= sphinx-build
+SOURCEDIR     = source
+BUILDDIR      = build
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

docs/make.bat

@@ -0,0 +1,35 @@
+@ECHO OFF
+
+pushd %~dp0
+
+REM Command file for Sphinx documentation
+
+if "%SPHINXBUILD%" == "" (
+	set SPHINXBUILD=sphinx-build
+)
+set SOURCEDIR=source
+set BUILDDIR=build
+
+%SPHINXBUILD% >NUL 2>NUL
+if errorlevel 9009 (
+	echo.
+	echo.The 'sphinx-build' command was not found. Make sure you have Sphinx
+	echo.installed, then set the SPHINXBUILD environment variable to point
+	echo.to the full path of the 'sphinx-build' executable. Alternatively you
+	echo.may add the Sphinx directory to PATH.
+	echo.
+	echo.If you don't have Sphinx installed, grab it from
+	echo.https://www.sphinx-doc.org/
+	exit /b 1
+)
+
+if "%1" == "" goto help
+
+%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
+goto end
+
+:help
+%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
+
+:end
+popd

docs/source/_autosummary/openbrain.agents.exceptions.rst

@@ -0,0 +1,15 @@
+openbrain.agents.exceptions
+===========================
+
+.. automodule:: openbrain.agents.exceptions
+
+
+   .. rubric:: Exceptions
+
+   .. autosummary::
+
+      AgentError
+      AgentToolError
+      AgentToolIncompleteContactError
+      AgentToolIncompleteLeadError
+      AgentToolLeadMomentumError

docs/source/_autosummary/openbrain.agents.gpt_agent.rst

@@ -0,0 +1,11 @@
+openbrain.agents.gpt\_agent
+===========================
+
+.. automodule:: openbrain.agents.gpt_agent
+
+
+   .. rubric:: Classes
+
+   .. autosummary::
+
+      GptAgent

docs/source/_autosummary/openbrain.agents.rst

@@ -0,0 +1,14 @@
+openbrain.agents
+================
+
+.. automodule:: openbrain.agents
+
+
+.. rubric:: Modules
+
+.. autosummary::
+   :toctree:
+   :recursive:
+
+   exceptions
+   gpt_agent

docs/source/_autosummary/openbrain.cli.rst

@@ -0,0 +1,11 @@
+openbrain.cli
+=============
+
+.. automodule:: openbrain.cli
+
+
+   .. rubric:: Classes
+
+   .. autosummary::
+
+      CliChatBot

docs/source/_autosummary/openbrain.exceptions.rst

@@ -0,0 +1,11 @@
+openbrain.exceptions
+====================
+
+.. automodule:: openbrain.exceptions
+
+
+   .. rubric:: Exceptions
+
+   .. autosummary::
+
+      ObMissingEnvironmentVariable

docs/source/_autosummary/openbrain.orm.exceptions.rst

@@ -0,0 +1,15 @@
+openbrain.orm.exceptions
+========================
+
+.. automodule:: openbrain.orm.exceptions
+
+
+   .. rubric:: Exceptions
+
+   .. autosummary::
+
+      OrmAgentInstantiationError
+      OrmNotImplementedError
+      OrmProfileNotFoundError
+      OrmSaveAgentConfigError
+      OrmSessionNotFoundError

docs/source/_autosummary/openbrain.orm.model_agent_config.rst

@@ -0,0 +1,12 @@
+openbrain.orm.model\_agent\_config
+==================================
+
+.. automodule:: openbrain.orm.model_agent_config
+
+
+   .. rubric:: Classes
+
+   .. autosummary::
+
+      AgentConfig
+      DefaultSettings

docs/source/_autosummary/openbrain.orm.model_chat_message.rst

@@ -0,0 +1,11 @@
+openbrain.orm.model\_chat\_message
+==================================
+
+.. automodule:: openbrain.orm.model_chat_message
+
+
+   .. rubric:: Classes
+
+   .. autosummary::
+
+      ChatMessage

docs/source/_autosummary/openbrain.orm.model_chat_session.rst

@@ -0,0 +1,11 @@
+openbrain.orm.model\_chat\_session
+==================================
+
+.. automodule:: openbrain.orm.model_chat_session
+
+
+   .. rubric:: Classes
+
+   .. autosummary::
+
+      ChatSession

docs/source/_autosummary/openbrain.orm.model_client.rst

@@ -0,0 +1,11 @@
+openbrain.orm.model\_client
+===========================
+
+.. automodule:: openbrain.orm.model_client
+
+
+   .. rubric:: Classes
+
+   .. autosummary::
+
+      Client

docs/source/_autosummary/openbrain.orm.model_common_base.rst

@@ -0,0 +1,20 @@
+openbrain.orm.model\_common\_base
+=================================
+
+.. automodule:: openbrain.orm.model_common_base
+
+
+   .. rubric:: Functions
+
+   .. autosummary::
+
+      snake_to_camel_case
+
+   .. rubric:: Classes
+
+   .. autosummary::
+
+      Ephemeral
+      InMemoryDb
+      Recordable
+      Serializable

docs/source/_autosummary/openbrain.orm.rst

@@ -0,0 +1,18 @@
+openbrain.orm
+=============
+
+.. automodule:: openbrain.orm
+
+
+.. rubric:: Modules
+
+.. autosummary::
+   :toctree:
+   :recursive:
+
+   exceptions
+   model_agent_config
+   model_chat_message
+   model_chat_session
+   model_client
+   model_common_base