django-spire 0.18.3__py3-none-any.whl → 0.19.0__py3-none-any.whl

django_spire/ai/chat/templates/django_spire/ai/chat/widget/dialog_widget.html

@@ -4,75 +4,124 @@
     <div
         class="row"
         x-data="{
-            request_message_view: new ViewGlue('{% url "django_spire:ai:chat:message:request:new" %}'),
-            load_messages_view: new ViewGlue('{% url "django_spire:ai:chat:message:load_chat" chat_id=chat.id %}'),
-            chat_id: '{{ chat.id }}',
+            chat_id: '{{ chat.id|default:'0' }}',
+            chat_name: '{{ chat.name_shortened|default:'New Chat'|escapejs }}',
             message_body: '',
+            request_message_view: new ViewGlue('{% url "django_spire:ai:chat:message:request:new" %}'),
 
             init() {
-                setTimeout(() => this.$refs.target_div.scrollTop = this.$refs.target_div.scrollHeight, 1500)
+                if (this.chat_id && this.chat_id !== '0' && this.chat_id !== '') {
+                    this.load_messages()
+                }
+
+                setTimeout(() => {
+                    if (this.$refs.target_div) {
+                        this.smooth_scroll_to_bottom()
+                    }
+                }, 1500)
 
                 this.speech_recognition.onresult = () => {
                     this.message_body = this.speech_transcript
                     this.send_chat({message_body: this.message_body, synthesis_speech_for_response: true})
                 }
             },
+
             load_messages() {
-                this.load_messages_view.render_insert_adjacent(this.$refs.target_div, {})
+                let load_messages_view = new ViewGlue(`/django_spire/ai/chat/message/load/chat/${this.chat_id}/`)
+                load_messages_view.render_insert_adjacent(this.$refs.target_div, {})
             },
+
+            smooth_scroll_to_bottom() {
+                let target = this.$refs.target_div
+                let start = target.scrollTop
+                let end = target.scrollHeight - target.clientHeight
+                let duration = 400
+                let start_time = performance.now()
+
+                function animate(current_time) {
+                    let elapsed = current_time - start_time
+                    let progress = Math.min(elapsed / duration, 1)
+                    let ease = progress * (2 - progress)
+
+                    target.scrollTop = start + (end - start) * ease
+
+                    if (progress < 1) {
+                        requestAnimationFrame(animate)
+                    }
+                }
+
+                requestAnimationFrame(animate)
+            },
+
             async send_chat({message_body = '', synthesis_speech_for_response = false}) {
                 if (message_body !== '') {
-                    await this.request_message_view.render_insert_adjacent(
+                    let was_new_chat = (this.chat_id === '0' || this.chat_id === 0 || this.chat_id === '')
+
+                    let response_html = await this.request_message_view.render_insert_adjacent(
                         this.$refs.target_div,
                         {
-                            message_body: message_body,
                             chat_id: this.chat_id,
+                            message_body: message_body,
                             synthesis_speech: synthesis_speech_for_response
                         }
                     )
+
+                    if (was_new_chat) {
+                        this.chat_name = message_body
+
+                        let message_element = this.$refs.target_div.querySelector('[data-message-chat-id]')
+
+                        if (message_element) {
+                            this.chat_id = message_element.dataset.messageChatId
+                            $dispatch('new-chat-created', {chat_id: parseInt(this.chat_id)})
+                        }
+                    }
+
                     this.message_body = ''
+                    $dispatch('chat-loaded')
+                }
+            },
+
+            speak_text(text) {
+                if ('speechSynthesis' in window) {
+                    let utterance = new SpeechSynthesisUtterance(text)
+                    window.speechSynthesis.speak(utterance)
                 }
             }
         }"
+        @send-message.window="send_chat({message_body: $event.detail.message_body})" @speak.window="speak_text($event.detail.text)"
     >
         <div class="col-12">
-            <div class="row px-0 border-bottom">
-                <div class="col-auto ps-2 pe-0 h-100 d-block d-md-none text-app-primary"
-                     style="font-size: 1.6rem; margin-top: -0.2rem;">
-                    <i x-show="!select_chat_visible" @click="open_chat_select()" class="bi bi-chat-left-text"></i>
-                </div>
-                <div class="col text-center fw-bold pb-2">
-                    {{ chat.name_shortened }}
+            <div class="row border-bottom px-0">
+                <div class="col text-center pb-2" x-text="chat_name">
                 </div>
             </div>
 
             <div class="row mb-3">
-                <div x-init="load_messages()" x-ref="target_div" class="col-12 overflow-auto p-4"
-                     style="height: calc(100vh - 90px - var(--app-top-navigation-height));">
+                <div class="col-12 overflow-auto p-4" style="height: calc(100vh - 90px - var(--app-top-navigation-height));" x-ref="target_div">
                 </div>
             </div>
 
             <div class="row">
                 <div class="col-auto text-center ps-2 pe-1">
-                    <button class="btn btn-app-primary-outlined" x-show="!speech_listening" @click="start_listening()">
+                    <button @click="start_listening()" class="btn btn-app-primary-outlined" x-show="!speech_listening">
                         <i class="bi bi-mic"></i>
                     </button>
-                    <button class="btn btn-app-danger" x-show="speech_listening" @click="stop_listening()">
+                    <button @click="stop_listening()" class="btn btn-app-danger" x-show="speech_listening">
                         <i class="bi bi-mic-fill"></i>
                     </button>
                 </div>
+
                 <div class="col text-center px-1">
-                    <input type="text" x-init="$el.focus()" x-model="message_body" @keyup.enter="send_chat({message_body: message_body})"
-                           class="form-control" autocomplete="off" name="request_message">
+                    <input @keyup.enter="send_chat({message_body: message_body})" autocomplete="off" class="form-control" name="request_message" type="text" x-init="$el.focus()" x-model="message_body">
                 </div>
+
                 <div class="col-auto text-center ps-1 pe-2">
-                    <button class="btn btn-app-primary-outlined" @click="send_chat({message_body: message_body})">
+                    <button @click="send_chat({message_body: message_body})" class="btn btn-app-primary">
                         <i class="bi bi-send"></i>
                     </button>
                 </div>
             </div>
-
         </div>
     </div>
-
 {% endblock %}

django_spire/ai/chat/templates/django_spire/ai/chat/widget/selection_widget.html

@@ -0,0 +1,42 @@
+<div
+    class="row"
+    x-data="{
+        active_chat_id: 0,
+        chat_content_type: '',
+        chat_load_recent_view: new ViewGlue('{% url "django_spire:ai:chat:template:recent" %}'),
+        chat_object_id: '',
+
+        init() {
+            this.load_recent_chats()
+            $dispatch('load-chat', {chat_id: 0})
+        },
+        async load_recent_chats() {
+            await this.chat_load_recent_view.render_inner(this.$refs.chat_recent_list)
+            $dispatch('chat-activated', {chat_id: this.active_chat_id})
+        }
+    }"
+    @chat-loaded.window="load_recent_chats()"
+    @new-chat-created.window="active_chat_id = $event.detail.chat_id; $dispatch('chat-activated', {chat_id: $event.detail.chat_id})"
+    @load-chat.window="active_chat_id = $event.detail.chat_id; $dispatch('chat-activated', {chat_id: $event.detail.chat_id})">
+
+    <div class="col-12 px-0">
+        <div class="px-2 pb-3">
+            <button @click="$dispatch('load-chat', {chat_id: 0})" class="btn btn-app-primary-outlined p-1 w-100">
+                <i class="bi bi-plus-lg me-2"></i>New Chat
+            </button>
+        </div>
+
+        <div class="border-top border-app-primary"></div>
+
+        <div class="px-3 py-2">
+            <div class="text-muted text-uppercase" style="font-size: 0.75rem; font-weight: 600; letter-spacing: 0.5px;">
+                Recent Chats
+            </div>
+        </div>
+
+        <div class="overflow-auto" style="height: calc(100vh - 180px - var(--app-top-navigation-height));">
+            <div class="px-2" x-ref="chat_recent_list">
+            </div>
+        </div>
+    </div>
+</div>

django_spire/ai/chat/tests/test_urls/test_json_urls.py

@@ -1,15 +1,17 @@
+from __future__ import annotations
+
 from django_spire.ai.chat.tests.test_urls.factories import create_test_chat
 from django_spire.core.tests.test_cases import BaseTestCase
 from django.urls import reverse
 
 
 class ChatJsonUrlTests(BaseTestCase):
-    def setUp(self):
+    def setUp(self) -> None:
         super().setUp()
 
         self.test_chat = create_test_chat(user=self.super_user)
 
-    def test_delete_view_url_path(self):
+    def test_delete_view_url_path(self) -> None:
         response = self.client.post(
             reverse(
                 'django_spire:ai:chat:json:delete',

django_spire/ai/chat/urls/__init__.py

@@ -6,5 +6,5 @@ urlpatterns = [
     path('json/', include('django_spire.ai.chat.urls.json_urls', namespace='json')),
     path('message/', include('django_spire.ai.chat.urls.message_urls', namespace='message')),
     path('page/', include('django_spire.ai.chat.urls.page_urls', namespace='page')),
-    path('template/', include('django_spire.ai.chat.urls.template_urls', namespace='template')),
+    path('template/', include('django_spire.ai.chat.urls.template.template_urls', namespace='template')),
 ]

django_spire/ai/chat/urls/json_urls.py

@@ -8,5 +8,5 @@ app_name = 'json'
 urlpatterns = [
     path('<int:pk>/delete', json_views.delete_chat_view, name='delete'),
     path('<int:pk>/rename', json_views.rename_chat_view, name='rename'),
-    path('workflow_process', json_views.chat_workflow_process_view, name='workflow_process'),
+    path('workflow_process', json_views.chat_workflow_view, name='workflow_process'),
 ]

django_spire/ai/chat/urls/page_urls.py

@@ -6,5 +6,5 @@ from django_spire.ai.chat.views import page_views
 app_name = 'page'
 
 urlpatterns = [
-    path('home/', page_views.home_view, name='home'),
+    path('home/', page_views.chat_view, name='home'),
 ]

django_spire/ai/chat/urls/{template_urls.py → template/template_urls.py}

@@ -1,6 +1,6 @@
 from django.urls import path
 
-from django_spire.ai.chat.views import template_views
+from django_spire.ai.chat.views.template import template_views
 
 
 app_name = 'template'

django_spire/ai/chat/views/json_views.py

@@ -3,10 +3,11 @@ from __future__ import annotations
 import json
 
 from typing import TYPE_CHECKING
+
 from django.http import JsonResponse
 
+from django_spire.ai.chat.intelligence.workflows.chat_workflow import chat_workflow
 from django_spire.ai.chat.models import Chat
-from django_spire.ai.chat.tools import chat_workflow_process
 
 if TYPE_CHECKING:
     from django.core.handlers.wsgi import WSGIRequest
@@ -50,6 +51,6 @@ def rename_chat_view(request: WSGIRequest, pk: int) -> JsonResponse:
     return JsonResponse({'type': 'success'})
 
 
-def chat_workflow_process_view(request: WSGIRequest) -> JsonResponse:
+def chat_workflow_view(request: WSGIRequest) -> JsonResponse:
     body = json.loads(request.body.decode('utf-8'))
-    return JsonResponse({'response': chat_workflow_process(request, body)})
+    return JsonResponse({'response': chat_workflow(request, body)})

django_spire/ai/chat/views/message_request_views.py

@@ -2,28 +2,45 @@ from __future__ import annotations
 
 import json
 
+from typing import TYPE_CHECKING
+
 from django.conf import settings
 from django.http import HttpResponse
+from django.utils.timezone import now
 
+from django_spire.ai.chat.choices import MessageResponseType
 from django_spire.ai.chat.message_intel import DefaultMessageIntel
 from django_spire.ai.chat.models import Chat
-from django_spire.ai.chat.responses import MessageResponseGroup, MessageResponse
-from django_spire.ai.chat.choices import MessageResponseType
-from django_spire.consts import AI_CHAT_WORKFLOW_SENDER_SETTINGS_NAME
+from django_spire.ai.chat.responses import MessageResponse, MessageResponseGroup
 
+if TYPE_CHECKING:
+    from django.core.handlers.wsgi import WSGIRequest
 
-def request_message_render_view(request):
+
+def request_message_render_view(request: WSGIRequest) -> HttpResponse:
     body_data = json.loads(request.body)
 
-    chat = (
-        Chat.objects
-        .by_user(request.user)
-        .get(id=body_data['chat_id'])
-    )
+    chat_id = body_data['chat_id']
 
-    if chat.is_empty:
-        chat.name = body_data['message_body']
-        chat.save()
+    current_datetime = now()
+    formatted_timestamp = current_datetime.strftime('%b %d, %Y at %I:%M %p')
+
+    if chat_id in {0, '0', ''}:
+        chat = Chat.objects.create(
+            user=request.user,
+            name=body_data['message_body'],
+            last_message_datetime=current_datetime
+        )
+    else:
+        chat = (
+            Chat.objects
+            .by_user(request.user)
+            .get(id=chat_id)
+        )
+
+        if chat.is_empty:
+            chat.name = body_data['message_body']
+            chat.save()
 
     message_response_group = MessageResponseGroup()
 
@@ -32,7 +49,8 @@ def request_message_render_view(request):
         sender='You',
         message_intel=DefaultMessageIntel(
             text=body_data['message_body']
-        )
+        ),
+        message_timestamp=formatted_timestamp
     )
 
     message_response_group.add_message_response(
@@ -56,7 +74,7 @@ def request_message_render_view(request):
         message_response_group.render_to_html_string(
             context_data={
                 "chat_id": chat.id,
-                "chat_workflow_name": getattr(settings, AI_CHAT_WORKFLOW_SENDER_SETTINGS_NAME),
+                "chat_workflow_name": settings.AI_PERSONA_NAME,
             }
         )
     )

django_spire/ai/chat/views/message_response_views.py

@@ -2,38 +2,41 @@ from __future__ import annotations
 
 import json
 
+from typing import TYPE_CHECKING
+
 from django.conf import settings
 from django.http import HttpResponse
+from django.utils.timezone import now
 
+from django_spire.ai.chat.intelligence.workflows.chat_workflow import chat_workflow
 from django_spire.ai.chat.models import Chat
 from django_spire.ai.chat.responses import MessageResponse
 from django_spire.ai.chat.choices import MessageResponseType
-from django_spire.ai.chat.tools import chat_workflow_process
-from django_spire.consts import AI_CHAT_WORKFLOW_SENDER_SETTINGS_NAME
-
 
-def response_message_render_view(request):
-    body_data = json.loads(request.body)
+if TYPE_CHECKING:
+    from django.core.handlers.wsgi import WSGIRequest
 
-    chat_workflow_name = getattr(settings, AI_CHAT_WORKFLOW_SENDER_SETTINGS_NAME)
 
-    if chat_workflow_name is None:
-        message = f'"{AI_CHAT_WORKFLOW_SENDER_SETTINGS_NAME}" must be set in the django settings.'
-        raise ValueError(message)
+def response_message_render_view(request: WSGIRequest) -> HttpResponse:
+    body_data = json.loads(request.body)
 
     chat = Chat.objects.by_user(request.user).get(id=body_data['chat_id'])
 
-    message_intel = chat_workflow_process(
+    message_intel = chat_workflow(
         request,
         body_data['message_body'],
         message_history=chat.generate_message_history(),
     )
 
+    current_datetime = now()
+    formatted_timestamp = current_datetime.strftime('%b %d, %Y at %I:%M %p')
+
     response_message = MessageResponse(
         type=MessageResponseType.RESPONSE,
-        sender=chat_workflow_name,
+        sender=settings.AI_PERSONA_NAME,
         message_intel=message_intel,
         synthesis_speech=body_data.get('synthesis_speech', False),
+        message_timestamp=formatted_timestamp
     )
 
     chat.add_message_response(response_message)

django_spire/ai/chat/views/message_views.py

@@ -1,12 +1,17 @@
 from __future__ import annotations
 
+from typing import TYPE_CHECKING
+
 from django.http import HttpResponse
 
 from django_spire.ai.chat.models import Chat
 from django_spire.ai.chat.responses import MessageResponseGroup
 
+if TYPE_CHECKING:
+    from django.core.handlers.wsgi import WSGIRequest
+
 
-def load_messages_render_view(request, chat_id):
+def load_messages_render_view(request: WSGIRequest, chat_id: int) -> HttpResponse:
     chat = (
         Chat.objects
         .by_user(request.user)
@@ -24,6 +29,7 @@ def load_messages_render_view(request, chat_id):
         message_group.render_to_html_string(
             {
                 'chat_id': chat.id,
+                'is_loading': True,
             }
         )
     )

django_spire/ai/chat/views/page_views.py

@@ -12,7 +12,7 @@ if TYPE_CHECKING:
 
 
 @AppAuthController('ai_chat').permission_required('can_delete')
-def home_view(request: WSGIRequest) -> TemplateResponse:
+def chat_view(request: WSGIRequest) -> TemplateResponse:
     breadcrumbs = Breadcrumbs()
     breadcrumbs.add_breadcrumb(name='AI Chat')
 
@@ -22,5 +22,5 @@ def home_view(request: WSGIRequest) -> TemplateResponse:
         page_title='AI Chat',
         page_description='Chat with AI',
         breadcrumbs=breadcrumbs,
-        template='django_spire/ai/chat/page/home_page.html',
+        template='django_spire/ai/chat/page/chat_page.html',
     )

django_spire/ai/chat/views/{template_views.py → template/template_views.py}

@@ -23,13 +23,7 @@ def dialog_widget_view(request) -> TemplateResponse:
     chat_id = body_data['chat_id']
 
     if chat_id == 0:
-        chat = Chat.objects.get_empty_or_create(
-            user=request.user
-        )
-        chat.name = 'New Chat'
-        chat.last_message_datetime = now()
-        chat.save()
-
+        chat = None
     else:
         chat = Chat.objects.get(
             id=chat_id,

django_spire/ai/context/admin.py

@@ -0,0 +1,15 @@
+from __future__ import annotations
+
+from django.contrib import admin
+
+from django_spire.ai.context import models
+
+
+@admin.register(models.Organization)
+class OrganizationAdmin(admin.ModelAdmin):
+    list_display = ('id', 'name', 'created_datetime', 'is_deleted')
+
+
+@admin.register(models.Person)
+class PersonAdmin(admin.ModelAdmin):
+    list_display = ('id', 'first_name', 'created_datetime', 'is_deleted')

django_spire/ai/context/apps.py

@@ -0,0 +1,16 @@
+from __future__ import annotations
+
+from django.apps import AppConfig
+
+from django_spire.utils import check_required_apps
+
+
+class AiContextConfig(AppConfig):
+    default_auto_field = 'django.db.models.BigAutoField'
+    name = 'django_spire.ai.context'
+    label = 'django_spire_ai_context'
+
+    REQUIRED_APPS = ('django_spire_ai',)
+
+    def ready(self) -> None:
+        check_required_apps(self.label)

django_spire/ai/context/choices.py

@@ -0,0 +1,11 @@
+from django.db.models import TextChoices
+
+
+class PersonRoleChoices(TextChoices):
+    ADMIN = 'admin', 'Admin'
+    HUMAN_RESOURCES = 'human_resources', 'Human Resources'
+    SALES = 'sales', 'Sales'
+    MANAGER = 'manager', 'Manager'
+    MARKETING = 'marketing', 'Marketing'
+    TECHNICAL = 'technical', 'Technical'
+    IT_SUPPORT = 'it_support', 'IT Support'

django_spire/ai/context/intelligence/prompts/organization_prompts.py

@@ -0,0 +1,19 @@
+from __future__ import annotations
+
+from dandy import Prompt
+from django.forms import model_to_dict
+
+from django_spire.ai.context.models import Organization
+
+
+def organization_info_prompt() -> Prompt:
+    org = Organization.objects.get_only_or_none()
+
+    if org is None:
+        return Prompt().text('There is no organization information available.')
+
+    org_dict = model_to_dict(
+        org, exclude=['id', 'created_datetime', 'is_active', 'is_deleted']
+    )
+
+    return Prompt().heading('Organization Information').dict(org_dict)

django_spire/ai/context/migrations/0001_initial.py

@@ -0,0 +1,67 @@
+# Generated by Django 5.2.7 on 2025-10-27 16:34
+
+import django.db.models.deletion
+import django.utils.timezone
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+        ('django_spire_auth_user', '0001_initial'),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='Organization',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('is_active', models.BooleanField(default=True, editable=False)),
+                ('is_deleted', models.BooleanField(default=False, editable=False)),
+                ('created_datetime', models.DateTimeField(default=django.utils.timezone.localtime, editable=False)),
+                ('name', models.CharField(blank=True, max_length=255, null=True)),
+                ('legal_name', models.CharField(blank=True, max_length=255, null=True)),
+                ('description', models.TextField(blank=True, null=True)),
+                ('sector', models.CharField(blank=True, max_length=255, null=True)),
+                ('sub_sector', models.CharField(blank=True, max_length=255, null=True)),
+                ('website', models.URLField(blank=True, max_length=255, null=True)),
+                ('street_address', models.CharField(blank=True, max_length=255, null=True)),
+                ('unit_number', models.CharField(blank=True, max_length=32, null=True)),
+                ('city', models.CharField(blank=True, max_length=255, null=True)),
+                ('province', models.CharField(blank=True, max_length=255, null=True)),
+                ('postal_code', models.CharField(blank=True, max_length=16, null=True)),
+                ('country', models.CharField(blank=True, max_length=255, null=True)),
+                ('phone', models.CharField(blank=True, max_length=255, null=True)),
+                ('email', models.EmailField(blank=True, max_length=255, null=True)),
+            ],
+            options={
+                'verbose_name': 'Organization Context',
+                'verbose_name_plural': 'Organization Context',
+                'db_table': 'django_spire_ai_context_organization',
+            },
+        ),
+        migrations.CreateModel(
+            name='Person',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('is_active', models.BooleanField(default=True, editable=False)),
+                ('is_deleted', models.BooleanField(default=False, editable=False)),
+                ('created_datetime', models.DateTimeField(default=django.utils.timezone.localtime, editable=False)),
+                ('is_internal_to_organization', models.BooleanField(default=True)),
+                ('role', models.CharField(choices=[('admin', 'Admin'), ('human_resources', 'Human Resources'), ('sales', 'Sales'), ('manager', 'Manager'), ('marketing', 'Marketing'), ('technical', 'Technical'), ('it_support', 'IT Support')], default='admin', max_length=16)),
+                ('role_details', models.TextField(blank=True, null=True)),
+                ('first_name', models.CharField(blank=True, max_length=255, null=True)),
+                ('last_name', models.CharField(blank=True, max_length=255, null=True)),
+                ('phone', models.CharField(blank=True, max_length=255, null=True)),
+                ('email', models.EmailField(blank=True, max_length=255, null=True)),
+                ('user', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='ai_context_people', related_query_name='ai_context_person', to='django_spire_auth_user.authuser')),
+            ],
+            options={
+                'verbose_name': 'Person Context',
+                'verbose_name_plural': 'People Context',
+                'db_table': 'django_spire_ai_context_person',
+            },
+        ),
+    ]