django-chat-ui 0.1.0__tar.gz

django_chat_ui-0.1.0/.github/workflows/compat-matrix.yml

@@ -0,0 +1,27 @@
+name: Compatibility Matrix
+
+on:
+  push:
+    branches: [master, main]
+  pull_request:
+    branches: [master, main]
+
+jobs:
+  tox:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Install Python versions
+        run: uv python install 3.10 3.12 3.13 3.14
+
+      - name: Install dependencies
+        run: uv sync
+
+      - name: Run compatibility matrix (tox)
+        run: uv run tox run

django_chat_ui-0.1.0/.github/workflows/js-tests.yml

@@ -0,0 +1,24 @@
+name: JavaScript Tests
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: "npm"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run Tests & Coverage
+        run: npm run coverage

django_chat_ui-0.1.0/.github/workflows/pre-commit.yml

@@ -0,0 +1,28 @@
+name: Pre-commit
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+
+jobs:
+  pre-commit:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      # The hooks run on python3.14 (default_language_version), found
+      # through the venv's bin on PATH under `uv run`.
+      - name: Set up Python
+        run: uv python install 3.14
+
+      - name: Install dependencies
+        run: uv sync --python 3.14
+
+      - name: Run pre-commit
+        run: uv run pre-commit run --all-files

django_chat_ui-0.1.0/.github/workflows/pytest.yml

@@ -0,0 +1,44 @@
+name: Python and Playwright Tests
+
+on:
+  push:
+    branches: [master, main]
+  pull_request:
+    branches: [master, main]
+
+jobs:
+  test-python:
+    name: Python Tests
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        run: uv python install
+
+      - name: Install dependencies
+        run: uv sync
+
+      - name: Install Playwright browsers
+        run: uv run playwright install --with-deps chromium
+
+      # matrix-js-sdk, for the test of a Matrix client against the server.
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: "npm"
+
+      - name: Install the JavaScript dependencies
+        run: npm ci
+
+      - name: Run Pytest
+        run: uv run pytest
+
+      - name: Run Pytest with a site's own models
+        run: uv run pytest --ds tests.settings_swapped --cov-append

django_chat_ui-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,55 @@
+name: Release
+
+on:
+  release:
+    types:
+      - published
+
+jobs:
+  release-build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Show project version
+        run: |
+          grep "version" pyproject.toml
+
+      - name: Build release distributions
+        run: uv build
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+  pypi-publish:
+    runs-on: ubuntu-latest
+    needs:
+      - release-build
+    permissions:
+      id-token: write
+      contents: read
+
+    environment:
+      name: pypi
+      url: https://pypi.org/project/django-chat-ui/
+
+    steps:
+      - name: Retrieve release distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+      - name: Publish release distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/

django_chat_ui-0.1.0/.gitignore

@@ -0,0 +1,42 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+build/
+dist/
+.installed.cfg
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Testing / coverage
+.pytest_cache/
+.coverage
+.coverage.*
+coverage/
+htmlcov/
+.mypy_cache/
+.ruff_cache/
+.tox/
+
+# Django
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+media/
+
+# Node / JS
+node_modules/
+
+# Editors / OS
+.vscode/
+.idea/
+.DS_Store
+
+# Docs
+docs/_build/

django_chat_ui-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,66 @@
+default_language_version:
+  python: &python-version python3.14
+
+repos:
+- repo: https://github.com/pre-commit/pre-commit-hooks
+  rev: 3e8a8703264a2f4a69428a0aa4dcb512790b2c8c  # frozen: v6.0.0
+  hooks:
+  - id: check-added-large-files
+  - id: check-case-conflict
+  - id: check-json
+  - id: check-merge-conflict
+  - id: check-symlinks
+  - id: check-toml
+  - id: debug-statements
+  - id: end-of-file-fixer
+  - id: trailing-whitespace
+
+- repo: https://github.com/biomejs/pre-commit
+  rev: d1ce4972fb5ad09afd33b432bca71e8c5dfbb2b5  # frozen: v2.5.6
+  hooks:
+  - id: biome-check
+    additional_dependencies:
+    - '@biomejs/biome@2.3.8'
+    language_version: default
+
+- repo: https://github.com/adamchainz/django-upgrade
+  rev: bdcc9646c249f00ec9781751791e7b75b48b3722  # frozen: 1.31.1
+  hooks:
+  - id: django-upgrade
+    args: [--target-version, "4.2"]
+
+- repo: https://github.com/astral-sh/ruff-pre-commit
+  rev: 39d9ac5938dadb73df0564a45f163e25ff9fa6e2  # frozen: v0.16.1
+  hooks:
+  - id: ruff-check
+    args: [--fix]
+  - id: ruff-format
+
+- repo: local
+  hooks:
+  - id: mypy
+    name: mypy
+    entry: mypy
+    language: python
+    additional_dependencies:
+    - mypy>=1.10
+    - django-stubs[compatible-mypy]>=5
+    - django>=4.2
+    - pytest-django>=4.8
+    types: [python]
+    files: ^(src|example)/
+    pass_filenames: false
+    args: [src/django_chat_ui, example]
+
+# Only needed if the library ships Django templates (src/<pkg>/templates/).
+# Remove this hook if it doesn't.
+- repo: https://github.com/adamchainz/djade-pre-commit
+  rev: 52a7ce253113456c2a1113186a4a19b15c8b68af  # frozen: 1.9.0
+  hooks:
+  - id: djade
+    files: '(/|^)templates/'
+
+- repo: https://github.com/tox-dev/pyproject-fmt
+  rev: d600c142bb19f521ae6a6a345f94a2efd7937759  # frozen: v2.26.0
+  hooks:
+  - id: pyproject-fmt

django_chat_ui-0.1.0/CHANGELOG.md

@@ -0,0 +1,53 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2026-10-24
+
+### Added
+
+- Matrix as the protocol: the components are Matrix clients (`ChatClient`
+  over the Client-Server API: `/sync` with long polling or polling, a local
+  echo of what's sent, receipts, typing, reactions, media), and the Django
+  app a Matrix homeserver without federation (docs/protocol.md): access
+  tokens (`m.login.password`) or the site's session, rooms, their state,
+  `/messages`, media, CORS. Tested with matrix-js-sdk.
+- This package's extensions to Matrix, namespaced under
+  `io.github.rodolvbg.chat`, each with a fallback any other client shows:
+  the conversations' capabilities and channel, quick replies and their
+  answers, cards, WhatsApp's templates, shared contacts, link previews,
+  system notices, a `delivered` receipt, a message's `failed` status, and
+  messages being written (an AI's), as ephemeral events; their JSON Schema.
+- `<chat-thread>`, `<chat-inbox>` and `<chat-widget>`: web components without
+  a build step, safe under a strict Content Security Policy (HTML of
+  messages rebuilt from the specification's safe subset).
+- `homeserver.js`: a scriptable Matrix homeserver in memory, for demos and
+  tests.
+- The Django app: conversations, participants and their events (Matrix
+  rooms, users and events); `services` and `content` for integrations;
+  `ChatBackend` to decide who chats and what happens (its hooks inline, in
+  a thread, or wherever `run_hook()` sends them), with the event types and
+  message types of a site's extensions; `{% chat_ui %}`; the admin;
+  `chat_ui_prune`.
+- A site's own models of conversations and participants
+  (`CHAT_UI_CONVERSATION_MODEL`, `CHAT_UI_PARTICIPANT_MODEL`), subclasses
+  of `AbstractConversation` and `AbstractParticipant`; their fields reach
+  the clients through `ChatBackend.serialize_conversation()` and
+  `serialize_participant()`.
+- `services.stream_text()`: a message written as an AI model streams it,
+  shown as it comes, sent when it ends or fails.
+- `django_chat_ui.agui.AgUiAgent`: AI agents that speak AG-UI answer in a
+  conversation, as they write.
+- Light or dark as the page around them: Django's admin's theme, the
+  `dark` class of Unfold and Tailwind, or the page's background, before the
+  system's; following a theme switch (`theme.js`).
+- Replies, where a conversation's `replies` capability allows them: "↩" on
+  a message answers it (a bar over the composer says which, Escape cancels
+  it), and the answer quotes it, leading to it; `ChatClient.send(…,
+  { replyTo })`.
+- Reactions, where a conversation's `reactions` capability allows them (any
+  emoji, or a list).
+- Spanish translation.

django_chat_ui-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rodolfo Becerra
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.