feat(askAi): no-issue: add Ask AI chatbot

.github/scripts/install-postgres-ubuntu.sh

@@ -17,7 +17,7 @@ echo "deb http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main"
 # remove existing postgresql and install desired version
 sudo apt update
 sudo apt remove -y postgresql\*
-sudo apt install -y "postgresql-$pgversion"
+sudo apt install -y "postgresql-$pgversion" "postgresql-$pgversion-pgvector"
 
 # add postgresql binaries to path
 echo "/usr/lib/postgresql/$pgversion/bin" >> $GITHUB_PATH

.gitignore

@@ -22,6 +22,7 @@ dev
 deploy
 build
 packages/*/dist
+packages/shared/src/baml_src/baml_client
 *.tsbuildinfo
 packages/*/{src,app}/**/*.d.ts
 database/docs

database/model/ask_ai/conversations.md

@@ -0,0 +1,27 @@
+{% docs ask_ai__table__conversations %}
+Stores Ask AI chatbot conversation threads. Each conversation belongs to a single user and groups a sequence of messages. Conversations support soft-deletion via `deleted_at` so history can be recovered. Not synced between facility and central servers.
+{% enddocs %}
+
+{% docs ask_ai__conversations__id %}
+Primary key. UUID string assigned by the application.
+{% enddocs %}
+
+{% docs ask_ai__conversations__user_id %}
+Foreign key to `public.users.id`. The user who owns this conversation.
+{% enddocs %}
+
+{% docs ask_ai__conversations__title %}
+Optional human-readable title for the conversation. Nullable — not set until the conversation has been given a name.
+{% enddocs %}
+
+{% docs ask_ai__conversations__created_at %}
+Timestamp when the conversation was created.
+{% enddocs %}
+
+{% docs ask_ai__conversations__updated_at %}
+Timestamp when the conversation was last modified.
+{% enddocs %}
+
+{% docs ask_ai__conversations__deleted_at %}
+Soft-delete timestamp. Null when the conversation is active. Set when the conversation is deleted, allowing recovery if needed.
+{% enddocs %}

database/model/ask_ai/conversations.yml

@@ -0,0 +1,43 @@
+version: 2
+sources:
+  - name: ask_ai__tamanu
+    schema: ask_ai
+    description: "{{ doc('ask_ai__generic__schema') }}"
+    tables:
+      - name: conversations
+        description: "{{ doc('ask_ai__table__conversations') }}"
+        config:
+          tags: []
+          meta:
+            triggers: []
+        columns:
+          - name: id
+            data_type: character varying(255)
+            description: "{{ doc('ask_ai__conversations__id') }}"
+            data_tests:
+              - unique
+              - not_null
+          - name: user_id
+            data_type: character varying(255)
+            description: "{{ doc('ask_ai__conversations__user_id') }}"
+            data_tests:
+              - not_null
+          - name: title
+            data_type: text
+            description: "{{ doc('ask_ai__conversations__title') }}"
+            config:
+              meta:
+                masking: text
+          - name: created_at
+            data_type: timestamp with time zone
+            description: "{{ doc('ask_ai__conversations__created_at') }}"
+            data_tests:
+              - not_null
+          - name: updated_at
+            data_type: timestamp with time zone
+            description: "{{ doc('ask_ai__conversations__updated_at') }}"
+            data_tests:
+              - not_null
+          - name: deleted_at
+            data_type: timestamp with time zone
+            description: "{{ doc('ask_ai__conversations__deleted_at') }}"

database/model/ask_ai/generic.md

@@ -0,0 +1,3 @@
+{% docs ask_ai__generic__schema %}
+Contains tables for the Ask AI chatbot feature, including conversation history and messages.
+{% enddocs %}

database/model/ask_ai/messages.md

@@ -0,0 +1,27 @@
+{% docs ask_ai__table__messages %}
+Stores individual messages within an Ask AI conversation. Each message is either from the user or the assistant, and together they form the conversation history sent to the LLM. Not soft-deleted — messages are permanently retained for the lifetime of the conversation. Not synced between facility and central servers.
+{% enddocs %}
+
+{% docs ask_ai__messages__id %}
+Primary key. UUID string assigned by the application.
+{% enddocs %}
+
+{% docs ask_ai__messages__conversation_id %}
+Foreign key to `ask_ai.conversations.id`. The conversation this message belongs to.
+{% enddocs %}
+
+{% docs ask_ai__messages__role %}
+The sender of the message. Either `user` (a message typed by the logged-in user) or `assistant` (a response generated by the LLM).
+{% enddocs %}
+
+{% docs ask_ai__messages__content %}
+The full text content of the message.
+{% enddocs %}
+
+{% docs ask_ai__messages__created_at %}
+Timestamp when the message was created.
+{% enddocs %}
+
+{% docs ask_ai__messages__updated_at %}
+Timestamp when the message was last modified.
+{% enddocs %}

database/model/ask_ai/messages.yml

@@ -0,0 +1,50 @@
+version: 2
+sources:
+  - name: ask_ai__tamanu
+    schema: ask_ai
+    description: "{{ doc('ask_ai__generic__schema') }}"
+    tables:
+      - name: messages
+        description: "{{ doc('ask_ai__table__messages') }}"
+        config:
+          tags: []
+          meta:
+            triggers: []
+        columns:
+          - name: id
+            data_type: character varying(255)
+            description: "{{ doc('ask_ai__messages__id') }}"
+            data_tests:
+              - unique
+              - not_null
+          - name: conversation_id
+            data_type: character varying(255)
+            description: "{{ doc('ask_ai__messages__conversation_id') }}"
+            data_tests:
+              - not_null
+          - name: role
+            data_type: text
+            description: "{{ doc('ask_ai__messages__role') }}"
+            data_tests:
+              - not_null
+            config:
+              meta:
+                masking: text
+          - name: content
+            data_type: text
+            description: "{{ doc('ask_ai__messages__content') }}"
+            data_tests:
+              - not_null
+            config:
+              meta:
+                masking: text
+          - name: created_at
+            data_type: timestamp with time zone
+            description: "{{ doc('ask_ai__messages__created_at') }}"
+            data_tests:
+              - not_null
+          - name: updated_at
+            data_type: timestamp with time zone
+            description: "{{ doc('ask_ai__messages__updated_at') }}"
+            data_tests:
+              - not_null

database/model/public/procedures.yml

@@ -69,45 +69,51 @@ sources:
             description: "{{ doc('procedures__encounter_id') }}"
             data_tests:
               - relationships:
-                  to: source('tamanu', 'encounters')
-                  field: id
+                  arguments:
+                    to: source('tamanu', 'encounters')
+                    field: id
           - name: location_id
             data_type: character varying(255)
             description: "{{ doc('procedures__location_id') }}"
             data_tests:
               - relationships:
-                  to: source('tamanu', 'locations')
-                  field: id
+                  arguments:
+                    to: source('tamanu', 'locations')
+                    field: id
           - name: procedure_type_id
             data_type: character varying(255)
             description: "{{ doc('procedures__procedure_type_id') }}"
             data_tests:
               - dbt_utils.relationships_where:
-                  to: source('tamanu', 'reference_data')
-                  field: id
-                  to_condition: type = 'procedureType'
+                  arguments:
+                    to: source('tamanu', 'reference_data')
+                    field: id
+                    to_condition: type = 'procedureType'
           - name: anaesthetic_id
             data_type: character varying(255)
             description: "{{ doc('procedures__anaesthetic_id') }}"
             data_tests:
               - dbt_utils.relationships_where:
-                  to: source('tamanu', 'reference_data')
-                  field: id
-                  to_condition: type = 'drug'
+                  arguments:
+                    to: source('tamanu', 'reference_data')
+                    field: id
+                    to_condition: type = 'drug'
           - name: physician_id
             data_type: character varying(255)
             description: "{{ doc('procedures__physician_id') }}"
             data_tests:
               - relationships:
-                  to: source('tamanu', 'users')
-                  field: id
+                  arguments:
+                    to: source('tamanu', 'users')
+                    field: id
           - name: anaesthetist_id
             data_type: character varying(255)
             description: "{{ doc('procedures__anaesthetist_id') }}"
             data_tests:
               - relationships:
-                  to: source('tamanu', 'users')
-                  field: id
+                  arguments:
+                    to: source('tamanu', 'users')
+                    field: id
           - name: start_time
             data_type: character(19)
             description: "{{ doc('procedures__start_time') }}"