orchid-api 0.2.0__tar.gz

orchid_api-0.2.0/.editorconfig

@@ -0,0 +1,22 @@
+root = true
+
+[*]
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+charset = utf-8
+
+[*.py]
+indent_style = space
+indent_size = 4
+max_line_length = 120
+
+[*.{yml,yaml,json,toml}]
+indent_style = space
+indent_size = 2
+
+[Makefile]
+indent_style = tab
+
+[*.md]
+trim_trailing_whitespace = false

orchid_api-0.2.0/.github/workflows/ci.yml

@@ -0,0 +1,157 @@
+# orchid-api (FastAPI server) — CI + Semantic Release
+
+name: CI
+
+on:
+  pull_request:
+    branches: [main]
+  push:
+    branches: [main]
+
+jobs:
+  # ── Lint ────────────────────────────────────────────────────
+
+  ruff:
+    name: Ruff lint & format
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - run: pip install ruff
+      - run: ruff check orchid_api/
+      - run: ruff format --check orchid_api/
+
+  commit-lint:
+    name: Commit message check
+    if: github.event_name == 'pull_request'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - run: pip install gitlint
+      - run: gitlint --commits "${{ github.event.pull_request.base.sha }}..${{ github.event.pull_request.head.sha }}"
+
+  # ── Test ────────────────────────────────────────────────────
+
+  test:
+    name: Tests + coverage
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+          cache: pip
+          cache-dependency-path: pyproject.toml
+      - run: pip install -e ".[dev]" pytest-cov
+      - name: Run tests
+        run: |
+          pytest tests/ \
+            --cov=orchid_api \
+            --cov-report=term-missing \
+            --cov-report=xml:coverage.xml \
+            --junitxml=report.xml \
+            -x
+      - name: Upload coverage
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage
+          path: coverage.xml
+          if-no-files-found: ignore
+      - name: Upload test report
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: test-report
+          path: report.xml
+          if-no-files-found: ignore
+      - name: Coverage summary
+        if: hashFiles('coverage.xml') != ''
+        uses: irongut/CodeCoverageSummary@v1.3.0
+        with:
+          filename: "**/coverage.xml"
+          format: markdown
+          output: both
+          badge: true
+          fail_below_min: false
+          thresholds: "50 75"
+      - name: Add coverage PR comment
+        if: github.event_name == 'pull_request' && hashFiles('code-coverage-results.md') != ''
+        uses: marocchino/sticky-pull-request-comment@v2
+        with:
+          header: coverage
+          path: code-coverage-results.md
+
+  # ── Build ───────────────────────────────────────────────────
+
+  build:
+    name: Build wheel
+    runs-on: ubuntu-latest
+    needs: [ruff, test]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - run: pip install build
+      - run: python -m build
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+          retention-days: 7
+
+  # ── Release (semantic-release on main push) ─────────────────
+
+  release:
+    name: Semantic release
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    runs-on: ubuntu-latest
+    needs: [ruff, test, build]
+    permissions:
+      contents: write
+      id-token: write  # required for PyPI trusted publishing
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - run: pip install python-semantic-release build
+      - name: Configure git
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+      - name: Bump version & tag
+        id: version
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          OUTPUT=$(semantic-release version --push --tag --commit 2>&1) || true
+          echo "$OUTPUT"
+          if echo "$OUTPUT" | grep -q "no release will be made"; then
+            echo "released=false" >> "$GITHUB_OUTPUT"
+          else
+            echo "released=true" >> "$GITHUB_OUTPUT"
+          fi
+      - name: Build distribution
+        if: steps.version.outputs.released == 'true'
+        run: python -m build
+      - name: Publish GitHub Release
+        if: steps.version.outputs.released == 'true'
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: semantic-release publish
+      # 4. Publish to PyPI via trusted publishing (OIDC)
+      - name: Publish to PyPI
+        if: steps.version.outputs.released == 'true'
+        uses: pypa/gh-action-pypi-publish@release/v1

orchid_api-0.2.0/.gitignore

@@ -0,0 +1,42 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+*.egg
+dist/
+build/
+*.whl
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# Ruff
+.ruff_cache/
+
+# pytest
+.pytest_cache/
+htmlcov/
+.coverage
+coverage.xml
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# OS
+.DS_Store
+Thumbs.db
+
+# mypy
+.mypy_cache/

orchid_api-0.2.0/.gitlint

@@ -0,0 +1,15 @@
+# Gitlint — enforce Conventional Commits for semantic-release
+# https://jorisroovers.com/gitlint/
+
+[general]
+contrib = contrib-title-conventional-commits
+ignore = merge-commit,revert-commit
+
+[title-max-length]
+line-length = 72
+
+[body-max-line-length]
+line-length = 120
+
+[contrib-title-conventional-commits]
+types = feat,fix,perf,refactor,docs,style,test,build,ci,chore

orchid_api-0.2.0/.pre-commit-config.yaml

@@ -0,0 +1,16 @@
+# Pre-commit hooks — run automatically before each commit
+# Install: pip install pre-commit && pre-commit install
+# Manual:  pre-commit run --all-files
+
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.9.10
+    hooks:
+      - id: ruff
+        args: [--fix, --exit-non-zero-on-fix]
+      - id: ruff-format
+
+  - repo: https://github.com/jorisroovers/gitlint
+    rev: v0.19.1
+    hooks:
+      - id: gitlint

orchid_api-0.2.0/AGENTS.md

@@ -0,0 +1,110 @@
+# orchid-api — AI Context
+
+## What This Package Is
+
+**orchid-api** is the FastAPI server for the Orchid multi-agent AI framework. It imports `orchid` (the library) as a dependency and exposes HTTP endpoints for chat management, message handling, document uploads, and RAG sharing. It does NOT contain agent logic, graph building, or persistence implementations — those live in `orchid/`.
+
+## Package Structure
+
+```
+orchid-api/
+  orchid_api/
+    main.py          FastAPI app + lifespan (graph build, storage init, tracing)
+    settings.py      Pydantic BaseSettings + YAML overlay via _apply_yaml_config()
+    context.py       AppContext dataclass (singleton, populated at startup)
+    auth.py          Bearer token -> AuthContext via pluggable IdentityResolver (ADR-010)
+    models.py        Pydantic response models
+    tracing.py       LangSmith setup
+    routers/
+      chats.py       CRUD: create, list, delete chat sessions
+      messages.py    Send messages + document upload (multipart/form-data)
+      sharing.py     Promote chat RAG data to user-common scope
+      legacy.py      Legacy single-shot /chat endpoint (JSON body)
+  Dockerfile
+  pyproject.toml
+```
+
+## Key Dependencies
+
+| Package | Role |
+|---------|------|
+| `orchid` | Core framework (agents, graph, RAG, persistence) |
+| `fastapi` | HTTP framework |
+| `uvicorn` | ASGI server |
+| `httpx` | Async HTTP client (for identity resolution) |
+| `pydantic-settings` | Environment + YAML config |
+| `python-multipart` | File upload support |
+| `langchain-core` | LangGraph message types |
+
+## Architecture Rules (Apply When Editing This Package)
+
+1. **This is a thin HTTP layer.** Business logic belongs in `orchid/`, not here. Routers call `orchid` APIs and return responses.
+
+2. **Identity resolution happens ONCE in `auth.py`.** The `get_auth_context` dependency resolves the Bearer token into `AuthContext`. No other code initiates OAuth flows (ADR-010).
+
+3. **`AppContext` replaces globals.** All runtime state (runtime, graph, chat_repo, http_client, identity_resolver) lives in `context.py:app_ctx`. The `runtime` field is an `OrchidRuntime` instance that owns the reader, LLM service, and MCP client factory. Routers access it via `from ..context import app_ctx`.
+
+4. **Routers are split by domain (SRP).** `chats.py` = CRUD, `messages.py` = send + upload, `sharing.py` = share, `legacy.py` = backward compat. New endpoints go in the appropriate router, never in `main.py`.
+
+5. **No agent or framework code here.** No `BaseAgent` subclasses, no graph wiring, no RAG logic. Those belong in `orchid/` or consumer projects.
+
+6. **Settings priority:** env vars > `orchid.yml` > hardcoded defaults. The `_YAML_TO_ENV` mapping in `settings.py` translates nested YAML keys to flat env vars.
+
+7. **Don't persist augmented prompts.** Save the original user message to chat history, NOT the version with prepended file content or RAG context.
+
+## Configuration (Settings)
+
+All settings are env vars, optionally populated from `orchid.yml` via `ORCHID_CONFIG`:
+
+| Setting | Default | Purpose |
+|---------|---------|---------|
+| `LITELLM_MODEL` | `ollama/llama3.2` | LLM model identifier |
+| `AGENTS_CONFIG_PATH` | `agents.yaml` | Path to agent YAML config |
+| `VECTOR_BACKEND` | `qdrant` | Vector store backend |
+| `QDRANT_URL` | `http://qdrant:6333` | Qdrant connection URL |
+| `EMBEDDING_MODEL` | `text-embedding-3-small` | Embedding model |
+| `CHAT_STORAGE_CLASS` | `orchid_ai.persistence.sqlite.SQLiteChatStorage` | Storage backend class |
+| `CHAT_DB_DSN` | `~/.orchid/chats.db` | Database connection string |
+| `DEV_AUTH_BYPASS` | `false` | Skip auth (dev only) |
+| `IDENTITY_RESOLVER_CLASS` | `""` | Dotted path to IdentityResolver |
+| `STARTUP_HOOK` | `""` | Async function called at startup |
+
+## Running
+
+```bash
+# Standalone (no Docker):
+pip install orchid-ai orchid-api
+ORCHID_CONFIG=orchid.yml uvicorn orchid_api.main:app --port 8000
+
+# Docker:
+docker build -t orchid-api .
+docker run -p 8000:8000 -v ./orchid.yml:/app/orchid.yml orchid-api
+```
+
+## Endpoints
+
+| Method | Path | Router | Purpose |
+|--------|------|--------|---------|
+| POST | `/chats` | chats | Create chat session |
+| GET | `/chats` | chats | List user's chats |
+| DELETE | `/chats/{id}` | chats | Delete chat |
+| GET | `/chats/{id}/messages` | messages | Load chat history |
+| POST | `/chats/{id}/messages` | messages | Send message (multipart) |
+| POST | `/chats/{id}/upload` | messages | Upload documents for chat RAG |
+| POST | `/chats/{id}/share` | sharing | Promote chat RAG to user scope |
+| POST | `/chat` | legacy | Single-shot (no persistence) |
+| GET | `/health` | main | Readiness check |
+
+## Code Style
+
+- Python 3.11+, Ruff, line length 120
+- `from __future__ import annotations` in every file
+- Imports: `from orchid_ai.xxx` (never `from src.xxx`)
+- No vendor-specific code — platform integrations belong in consumer projects
+
+## Common Pitfalls
+
+- `POST /chats/{id}/messages` uses `multipart/form-data`, not JSON. The legacy `POST /chat` uses JSON.
+- CORS allows `localhost:3000` and `frontend:3000` — add new origins in `main.py` if needed.
+- The `lifespan()` function builds the graph at startup. Changes to agent config require a restart.
+- Embedding dimension mismatch (768 vs 1536 vs 3072) causes silent retrieval failures. Switching models requires re-indexing.

orchid_api-0.2.0/CLAUDE.md

@@ -0,0 +1 @@
+AGENTS.md

orchid_api-0.2.0/CONTRIBUTING.md

@@ -0,0 +1,83 @@
+# Contributing to orchid-api
+
+## Development Setup
+
+```bash
+cd orchid-api
+python -m venv .venv
+source .venv/bin/activate
+pip install -e ../orchid -e ".[dev]"
+pre-commit install
+```
+
+The last command installs git hooks that **automatically run ruff (lint + format) and gitlint (commit message check) before every commit**.
+
+## Commit Message Convention
+
+This project uses **[Conventional Commits](https://www.conventionalcommits.org/)** to enable automatic semantic versioning. Every commit message must follow this format:
+
+```
+<type>(<scope>): <description>
+
+[optional body]
+
+[optional footer(s)]
+```
+
+### Types
+
+| Type | Description | Version Bump |
+|------|-------------|-------------|
+| `feat` | New feature | **minor** (0.X.0) |
+| `fix` | Bug fix | **patch** (0.0.X) |
+| `perf` | Performance improvement | **patch** (0.0.X) |
+| `refactor` | Code refactor (no feature/fix) | none |
+| `docs` | Documentation only | none |
+| `style` | Formatting, whitespace | none |
+| `test` | Adding/updating tests | none |
+| `build` | Build system, dependencies | none |
+| `ci` | CI/CD configuration | none |
+| `chore` | Maintenance tasks | none |
+
+### Breaking Changes
+
+Append `!` after the type or add `BREAKING CHANGE:` in the footer for a **major** bump:
+
+```
+feat!: change /chats/{id}/messages response format
+```
+
+### Examples
+
+```
+feat(routers): add pagination to GET /chats endpoint
+fix(auth): handle expired bearer tokens gracefully
+docs: update API endpoint table in README
+test(sharing): add tests for scope promotion endpoint
+ci: add coverage reporting to GitLab pipeline
+```
+
+### Validation
+
+Commit messages are validated in CI via [gitlint](https://jorisroovers.com/gitlint/). To check locally:
+
+```bash
+pip install gitlint
+gitlint
+```
+
+## Running Tests
+
+```bash
+pytest tests/ -x                       # all tests
+pytest tests/ --cov=orchid_api         # with coverage
+ruff check orchid_api/                 # lint
+ruff format orchid_api/                # format
+```
+
+## Merge Requests
+
+1. Create a feature branch from `main`
+2. Use conventional commit messages
+3. Ensure tests pass and linting is clean
+4. Keep MRs focused -- one feature or fix per MR

orchid_api-0.2.0/Dockerfile

@@ -0,0 +1,40 @@
+# orchid-api — FastAPI + LangGraph agent backend
+#
+# Build context: orchid-api/
+#   docker build -t orchid-api .
+#
+# Multi-stage: install deps → slim runtime
+
+# ── Stage 1: build & install ───────────────────────────────────
+FROM python:3.13-slim AS builder
+
+WORKDIR /app
+
+# System deps for building wheels
+RUN apt-get update && apt-get install -y --no-install-recommends gcc && rm -rf /var/lib/apt/lists/*
+
+# Install orchid-api (pulls orchid from PyPI as a dependency)
+COPY pyproject.toml pyproject.toml
+COPY orchid_api orchid_api
+RUN pip install --no-cache-dir --prefix=/install .
+
+# ── Stage 2: runtime ──────────────────────────────────────────
+FROM python:3.13-slim
+
+WORKDIR /app
+
+# Copy installed packages from builder
+COPY --from=builder /install /usr/local
+
+# Copy application source
+COPY orchid_api orchid_api
+
+ENV PYTHONDONTWRITEBYTECODE=1
+ENV PYTHONUNBUFFERED=1
+
+EXPOSE 8000
+
+HEALTHCHECK --interval=15s --timeout=3s --start-period=10s \
+  CMD python -c "import urllib.request; urllib.request.urlopen('http://localhost:8000/health')" || exit 1
+
+CMD ["uvicorn", "orchid_api.main:app", "--host", "0.0.0.0", "--port", "8000"]

orchid_api-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Orchid Contributors
+
+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.

orchid_api-0.2.0/PKG-INFO

@@ -0,0 +1,22 @@
+Metadata-Version: 2.4
+Name: orchid-api
+Version: 0.2.0
+Summary: Orchid API — FastAPI server for the Orchid agent framework
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: httpx>=0.28.0
+Requires-Dist: langchain-core>=0.3.0
+Requires-Dist: orchid-ai>=1.1.0
+Requires-Dist: pydantic-settings>=2.7.0
+Requires-Dist: pydantic>=2.10.0
+Requires-Dist: python-multipart>=0.0.9
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: uvicorn[standard]>=0.34.0
+Provides-Extra: dev
+Requires-Dist: gitlint>=0.19.0; extra == 'dev'
+Requires-Dist: pre-commit>=4.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.25.0; extra == 'dev'
+Requires-Dist: pytest-cov>=6.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.9.0; extra == 'dev'

orchid_api-0.2.0/README.md

@@ -0,0 +1,136 @@
+<p align="center">
+  <img src="icon.svg" alt="Orchid" width="80" />
+</p>
+
+<h1 align="center">Orchid API</h1>
+
+FastAPI server for the [Orchid](../orchid) multi-agent AI framework.
+
+Provides HTTP endpoints for chat management, message handling, document uploads, and RAG sharing. This is a thin HTTP layer -- all agent logic, graph building, and persistence live in the `orchid` library.
+
+## Features
+
+- Multi-chat session management (create, list, delete)
+- Streaming message send with agent graph invocation
+- File upload with document parsing and chat-scoped RAG
+- Chat sharing (promote RAG data to user scope)
+- Pluggable identity resolution (Bearer token -> AuthContext)
+- LangSmith tracing integration
+- CORS support for frontend clients
+
+## Installation
+
+```bash
+pip install orchid-api
+```
+
+Requires the `orchid` library:
+
+```bash
+pip install orchid-ai orchid-api
+```
+
+## Quick Start
+
+```bash
+# With orchid.yml config:
+ORCHID_CONFIG=path/to/orchid.yml uvicorn orchid_api.main:app --port 8000
+
+# Health check:
+curl http://localhost:8000/health
+```
+
+## Endpoints
+
+| Method | Path | Content-Type | Purpose |
+|--------|------|-------------|---------|
+| `POST` | `/chats` | JSON | Create a chat session |
+| `GET` | `/chats` | -- | List user's chat sessions |
+| `DELETE` | `/chats/{id}` | -- | Delete a chat session |
+| `GET` | `/chats/{id}/messages` | -- | Load chat message history |
+| `POST` | `/chats/{id}/messages` | **multipart/form-data** | Send a message (with optional files) |
+| `POST` | `/chats/{id}/upload` | multipart/form-data | Upload documents for chat RAG |
+| `POST` | `/chats/{id}/share` | -- | Promote chat RAG data to user scope |
+| `POST` | `/chat` | JSON | Legacy single-shot (no persistence) |
+| `GET` | `/health` | -- | Readiness check |
+
+## Architecture
+
+```
+orchid_api/
+  main.py          FastAPI app + lifespan (graph build, storage init, tracing)
+  settings.py      Pydantic BaseSettings + YAML overlay
+  context.py       AppContext dataclass (singleton, populated at startup)
+  auth.py          Bearer token -> AuthContext via pluggable IdentityResolver
+  models.py        Pydantic response models
+  tracing.py       LangSmith setup
+  routers/
+    chats.py       CRUD: create, list, delete chat sessions
+    messages.py    Send messages + document upload (multipart/form-data)
+    sharing.py     Promote chat RAG data to user-common scope
+    legacy.py      Legacy single-shot /chat endpoint (JSON body)
+```
+
+## Configuration
+
+All settings are environment variables, optionally populated from `orchid.yml` via `ORCHID_CONFIG`:
+
+| Setting | Default | Purpose |
+|---------|---------|---------|
+| `LITELLM_MODEL` | `ollama/llama3.2` | LLM model identifier |
+| `AGENTS_CONFIG_PATH` | `agents.yaml` | Path to agent YAML config |
+| `VECTOR_BACKEND` | `qdrant` | Vector store backend (`qdrant` or `null`) |
+| `QDRANT_URL` | `http://qdrant:6333` | Qdrant connection URL |
+| `EMBEDDING_MODEL` | `text-embedding-3-small` | Embedding model |
+| `CHAT_STORAGE_CLASS` | `orchid_ai.persistence.sqlite.SQLiteChatStorage` | Storage backend class |
+| `CHAT_DB_DSN` | `~/.orchid/chats.db` | Database connection string |
+| `DEV_AUTH_BYPASS` | `false` | Skip auth (dev only) |
+| `IDENTITY_RESOLVER_CLASS` | -- | Dotted path to IdentityResolver subclass |
+| `STARTUP_HOOK` | -- | Async function called at startup |
+| `LANGSMITH_TRACING` | `false` | Enable LangSmith tracing |
+| `LANGSMITH_API_KEY` | -- | LangSmith API key |
+
+**Priority:** env vars > `orchid.yml` > hardcoded defaults.
+
+## Docker
+
+```dockerfile
+# Build (from parent directory):
+docker build -f orchid-api/Dockerfile -t orchid-api .
+
+# Run:
+docker run -p 8000:8000 -e ORCHID_CONFIG=/app/config/orchid.yml orchid-api
+```
+
+Or with docker-compose:
+
+```bash
+docker compose -f docker-compose.demo.yml up --build    # SQLite
+docker compose -f docker-compose.local.yml up --build   # PostgreSQL + Qdrant
+```
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+ORCHID_CONFIG=orchid.yml uvicorn orchid_api.main:app --reload --port 8000
+```
+
+## Testing
+
+```bash
+pip install -e ".[dev]"
+pytest tests/ -x
+ruff check orchid_api/
+```
+
+## Code Style
+
+- Python 3.11+, Ruff, line length 120
+- `from __future__ import annotations` in every file
+- Routers split by domain (SRP): chats, messages, sharing, legacy
+- All runtime state in `AppContext` -- no module-level globals
+
+## License
+
+MIT -- see [LICENSE](LICENSE).

orchid_api-0.2.0/icon.svg

@@ -0,0 +1,12 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="512" height="512" viewBox="0 0 24 24" fill="none">
+  <rect width="24" height="24" rx="5" fill="#0D0B11"/>
+  <!-- Glow -->
+  <circle cx="12" cy="12" r="8" fill="#B06AB3" opacity="0.12"/>
+  <!-- Orchid petals -->
+  <path d="M12 2C10.5 5 9.5 7.5 12 11C14.5 7.5 13.5 5 12 2Z" fill="#D490D7"/>
+  <path d="M4 8C6.5 7.5 9 8 11 11C7.5 11.5 5.5 10.5 4 8Z" fill="#C87ECB" opacity="0.9"/>
+  <path d="M20 8C17.5 7.5 15 8 13 11C16.5 11.5 18.5 10.5 20 8Z" fill="#C87ECB" opacity="0.9"/>
+  <path d="M6 18C7.5 15.5 9.5 13.5 12 13C9 14.5 7 16 6 18Z" fill="#B06AB3" opacity="0.85"/>
+  <path d="M18 18C16.5 15.5 14.5 13.5 12 13C15 14.5 17 16 18 18Z" fill="#B06AB3" opacity="0.85"/>
+  <circle cx="12" cy="11.5" r="1.5" fill="#FFFFFF"/>
+</svg>

orchid_api-0.2.0/orchid_api/__init__.py

@@ -0,0 +1 @@
+# Orchid API — FastAPI server