strands-compose-chat 0.1.0__tar.gz

strands_compose_chat-0.1.0/.dockerignore

@@ -0,0 +1,30 @@
+# Python
+.venv/
+__pycache__/
+*.pyc
+*.pyo
+.ruff_cache/
+.coverage
+*.egg-info/
+dist/
+build/
+*cache
+
+# Node
+*/node_modules/
+*/dist/
+
+# Dev / tooling
+.git/
+.kiro/
+.env
+*.sqlite
+*.db
+tasks
+
+# Tests
+tests/
+.pytest_cache/
+
+# Docs / misc
+*.md

strands_compose_chat-0.1.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,117 @@
+name: Bug Report
+description: Report a bug in strands-compose-chat
+title: "[BUG] "
+labels: ["bug", "triage"]
+assignees: []
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to fill out this bug report for strands-compose-chat!
+
+  - type: checkboxes
+    id: checks
+    attributes:
+      label: Checks
+      options:
+        - label: I have updated to the latest version of strands-compose-chat
+          required: true
+        - label: I have checked the documentation and this is not expected behavior
+          required: true
+        - label: I have searched [./issues](./issues?q=) and there are no duplicates of my issue
+          required: true
+
+  - type: input
+    id: chat-version
+    attributes:
+      label: strands-compose-chat Version
+      description: Which version of strands-compose-chat are you using?
+      placeholder: e.g., 0.1.0
+    validations:
+      required: true
+
+  - type: input
+    id: strands-compose-agentcore-version
+    attributes:
+      label: strands-compose-agentcore Version
+      description: Which version of strands-compose-agentcore are you using?
+      placeholder: e.g., 0.9.1
+    validations:
+      required: true
+
+  - type: input
+    id: python-version
+    attributes:
+      label: Python Version
+      description: Which version of Python are you using?
+      placeholder: e.g., 3.11.5
+    validations:
+      required: true
+
+  - type: input
+    id: os
+    attributes:
+      label: Operating System
+      description: Which operating system are you using?
+      placeholder: e.g., Ubuntu 22.04 / Windows 11 / macOS 14
+    validations:
+      required: true
+
+  - type: dropdown
+    id: installation-method
+    attributes:
+      label: Installation Method
+      description: How did you install strands-compose-chay?
+      options:
+        - pip
+        - uv
+        - git clone
+        - other
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps-to-reproduce
+    attributes:
+      label: Steps to Reproduce
+      description: Detailed steps to reproduce the behavior
+      placeholder: |
+        1. config.yaml and code snippet (minimal reproducible example)
+        2. Run the command...
+        3. See error...
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected-behavior
+    attributes:
+      label: Expected Behavior
+      description: A clear description of what you expected to happen
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual-behavior
+    attributes:
+      label: Actual Behavior
+      description: What actually happened — include full traceback if applicable
+    validations:
+      required: true
+
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: Additional Context
+      description: Any other relevant information, logs, screenshots, etc.
+
+  - type: textarea
+    id: possible-solution
+    attributes:
+      label: Possible Solution
+      description: Optional — if you have suggestions on how to fix the bug
+
+  - type: input
+    id: related-issues
+    attributes:
+      label: Related Issues
+      description: Optional — link to related issues if applicable

strands_compose_chat-0.1.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: strands-compose-chat Discussions
+    url: https://github.com/strands-compose/chat/discussions
+    about: Please ask and answer questions here
+  - name: strands-compose-chat Documentation
+    url: https://github.com/strands-compose/chat/tree/main/docs
+    about: Visit the documentation for help

strands_compose_chat-0.1.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,46 @@
+name: Feature Request
+description: Suggest a new feature or enhancement for strands-compose-chat
+title: "[FEATURE] "
+labels: ["enhancement", "triage"]
+assignees: []
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for suggesting a new feature for strands-compose-chat!
+
+  - type: textarea
+    id: problem-statement
+    attributes:
+      label: Problem Statement
+      description: Describe the problem you're trying to solve. What is currently difficult or impossible to do?
+      placeholder: I would like strands-compose-chat to...
+    validations:
+      required: true
+
+  - type: textarea
+    id: proposed-solution
+    attributes:
+      label: Proposed Solution
+      description: Optional — describe your proposed solution. How would this feature work?
+
+  - type: textarea
+    id: use-case
+    attributes:
+      label: Use Case
+      description: Provide specific use cases for the feature. How would people use it?
+      placeholder: This would help with...
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives Considered
+      description: Optional — have you considered alternative approaches? What are their pros and cons?
+
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: Additional Context
+      description: Any other context, screenshots, code examples, or references that might help understand the request.

strands_compose_chat-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,37 @@
+## Description
+
+<!-- Provide a detailed description of the changes in this PR -->
+
+## Related Issues
+
+<!-- Link to related issues using #issue-number format -->
+
+## Type of Change
+
+<!-- Choose one and delete the rest -->
+
+- Bug fix
+- New feature
+- Breaking change
+- Documentation update
+- Other (please describe):
+
+## Testing
+
+How have you tested the change?
+
+- [ ] I ran `uv run just check` (lint + type check)
+- [ ] I ran `uv run just test` for overall testing
+- [ ] I added or updated tests that prove my fix is effective or my feature works
+- [ ] I verified existing examples in `examples/` still work
+
+## Checklist
+
+- [ ] I have read the [CONTRIBUTING](CONTRIBUTING.md) document
+- [ ] I have updated the documentation accordingly
+- [ ] My changes generate no new warnings
+- [ ] Any dependent changes have been merged and published
+
+---
+
+By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

strands_compose_chat-0.1.0/.github/dependabot.yml

@@ -0,0 +1,20 @@
+version: 2
+updates:
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "daily"
+    open-pull-requests-limit: 100
+    commit-message:
+      prefix: ci
+    groups:
+      dev-dependencies:
+        patterns:
+          - "pytest"
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "daily"
+    open-pull-requests-limit: 100
+    commit-message:
+      prefix: ci

strands_compose_chat-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,123 @@
+# Continuous Integration — runs on every push and pull request.
+
+name: CI
+
+on:
+  push:
+    branches: ["main"]
+  pull_request:
+    branches: ["main"]
+  workflow_call:
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+  # Quality checks
+  check:
+    name: Quality checks
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v7
+
+      - uses: astral-sh/setup-uv@v8.2.0
+        with:
+          enable-cache: true
+
+      - name: Install dev deps
+        run: uv sync --all-groups --all-extras
+
+      - name: Ruff — format check
+        run: uv run just check-format
+
+      - name: Ruff — lint
+        run: uv run just check-code
+
+      - name: ty — type check
+        run: uv run just check-type
+
+      - name: Bandit — security scan
+        run: uv run just check-security
+
+  # Fast tier: unit + SQLite-backed
+  test-fast:
+    name: Fast tier (Python ${{ matrix.python-version }}, ${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    permissions:
+      contents: read
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v7
+
+      - uses: astral-sh/setup-uv@v8.2.0
+        with:
+          enable-cache: true
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dev deps
+        run: uv sync --all-groups --all-extras
+
+      - name: Run tests
+        run: uv run just test-fast
+
+  # Postgres tier: dialect-sensitive tests + migration guard
+  test-postgres:
+    name: Postgres tier
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    services:
+      postgres:
+        image: postgres:17
+        env:
+          POSTGRES_USER: testuser
+          POSTGRES_PASSWORD: testpassword  # pragma: allowlist secret
+          POSTGRES_DB: testdb
+        ports:
+          - 5432:5432
+        options: >-
+          --health-cmd "pg_isready -U testuser -d testdb"
+          --health-interval 5s
+          --health-timeout 5s
+          --health-retries 5
+    env:
+      DATABASE_URL: "postgresql+psycopg://testuser:testpassword@localhost:5432/testdb"  # pragma: allowlist secret
+    steps:
+      - uses: actions/checkout@v7
+
+      - uses: astral-sh/setup-uv@v8.2.0
+        with:
+          enable-cache: true
+
+      - name: Install dev deps
+        run: uv sync --all-groups --all-extras
+
+      - name: Verify Postgres is reachable
+        run: |
+          uv run python - <<'EOF'
+          import sys
+          import psycopg
+
+          try:
+              with psycopg.connect(
+                  "postgresql://testuser:testpassword@localhost:5432/testdb",
+                  connect_timeout=10,
+              ) as conn:
+                  conn.execute("SELECT 1")
+          except Exception as exc:
+              print(f"ERROR: database connection failed — {exc}", file=sys.stderr)
+              sys.exit(1)
+          EOF
+
+      - name: Run tests
+        run: uv run just test-postgres db_host=localhost

strands_compose_chat-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,134 @@
+# Publish to PyPI — triggered by pushing a version tag (v*.*.*).
+# Uses Trusted Publishing (OIDC — no API tokens required).
+#
+# One-time setup on PyPI:
+#   1. Create a project for "strands-compose" at https://pypi.org/manage/account/publishing/
+#   2. Configure Trusted Publisher:
+#     - Owner:       strands-compose
+#     - Repository:  chat
+#     - Workflow:    publish.yml
+#     - Environment: release
+
+name: Publish
+
+on:
+  push:
+    tags:
+      - "v[0-9]+.[0-9]+.[0-9]+"
+      - "v[0-9]+.[0-9]+.[0-9]+.post*"
+      - "v[0-9]+.[0-9]+.[0-9]+rc*"
+
+permissions:
+  contents: read
+
+jobs:
+  # Gate: run CI checks before publishing
+  ci:
+    uses: ./.github/workflows/ci.yml
+    permissions:
+      contents: read
+
+  # Build distribution package
+  build:
+    name: Build
+    needs: ci
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v7
+
+      - uses: astral-sh/setup-uv@v8.2.0
+        with:
+          enable-cache: true
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: "22"
+          cache: "npm"
+          cache-dependency-path: ui/package-lock.json
+
+      - name: Build frontend
+        run: |
+          cd ui
+          npm ci
+          npm run build:backend
+
+      - name: Build wheel + sdist
+        run: uv build --out-dir dist/
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v7
+        with:
+          name: dist
+          path: dist/
+          if-no-files-found: error
+
+  # Publish to PyPI
+  publish:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment: release
+    permissions:
+      id-token: write
+    steps:
+      - name: Download build artifacts
+        uses: actions/download-artifact@v8
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/
+
+  # Create GitHub Release with CHANGELOG notes
+  github-release:
+    name: GitHub Release
+    needs: publish
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.x"
+
+      - name: Extract changelog for this version
+        id: changelog
+        run: |
+          VERSION="${GITHUB_REF_NAME#v}"
+          NOTES=$(python -c "
+          import re, pathlib
+          text = pathlib.Path('CHANGELOG.md').read_text()
+          match = re.search(
+              r'(?:^|\n)(## v?' + re.escape('$VERSION') + r'[^\n]*\n.*?)(?=\n## |\Z)',
+              text, re.DOTALL
+          )
+          print(match.group(1).strip() if match else 'See CHANGELOG.md for details.')
+          " VERSION="$VERSION")
+          {
+            echo 'notes<<EOF'
+            echo "$NOTES"
+            echo EOF
+          } >> "$GITHUB_OUTPUT"
+
+      - name: Download all artifacts
+        uses: actions/download-artifact@v8
+        with:
+          path: dist-all/
+          merge-multiple: true
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v3
+        with:
+          body: ${{ steps.changelog.outputs.notes }}
+          files: dist-all/**/*
+          prerelease: ${{ contains(github.ref_name, 'rc') || contains(github.ref_name, 'alpha') || contains(github.ref_name, 'beta') }}

strands_compose_chat-0.1.0/.gitignore

@@ -0,0 +1,30 @@
+.claude
+.kiro/specs
+
+.venv/
+venv/
+*.pyc
+*.pyo
+*/__pycache__/
+*.sqlite3
+.*_cache
+.hypothesis
+
+.coverage*
+.req.txt
+
+*.log
+*.ipynb
+
+.env*
+
+# IDE
+.idea/
+.vscode/
+
+proxy.py
+*.sqlite
+seed_dummy_db.py
+
+# Built frontend artifacts — populated by `just build-ui` or Docker build stage.
+src/strands_compose_chat/static/