adaptsapi 0.1.9__tar.gz → 0.2.0__tar.gz

{adaptsapi-0.1.9/src/adaptsapi.egg-info → adaptsapi-0.2.0}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: adaptsapi
-Version: 0.1.9
-Summary: CLI to enqueue triggers via internal API Gateway → SNS
-Home-page: https://github.com/adaptsai/adaptsapi
+Version: 0.2.0
+Summary: Python client library and CLI for the Adapts API — chat with your codebase wikis, generate docs, and more.
+Home-page: https://github.com/AdaptsAI/adapts_api_client
 Author: adapts
 Author-email: "VerifyAI Inc." <dev@adapts.ai>
 License-Expression: LicenseRef-Proprietary
@@ -11,10 +11,11 @@ Project-URL: Source, https://github.com/AdaptsAI/adapts_api_client
 Keywords: adapts,api,cli,sns
 Classifier: Programming Language :: Python :: 3
 Classifier: Operating System :: OS Independent
-Requires-Python: >=3.10
+Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: requests
+Requires-Dist: pydantic[email]>=2.4
 Dynamic: author
 Dynamic: home-page
 Dynamic: license-file
@@ -22,23 +23,22 @@ Dynamic: requires-python
 
 # AdaptsAPI Client
 
-A Python client library and CLI for the Adapts API, designed for triggering documentation generation via API Gateway → SNS.
+A Python client library and CLI for the Adapts API: **chat with your codebase wikis**, **generate wiki docs**, and **generate release notes**.
 
 [![PyPI version](https://badge.fury.io/py/adaptsapi.svg)](https://badge.fury.io/py/adaptsapi)
-[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
 [![License: Proprietary](https://img.shields.io/badge/License-Proprietary-red.svg)](LICENSE)
-[![Test Coverage](https://img.shields.io/badge/coverage-98%25-green.svg)](https://github.com/adaptsai/adaptsapi)
+[![Test Coverage](https://img.shields.io/badge/coverage-98%25-green.svg)](https://github.com/AdaptsAI/adapts_api_client)
 
 ## Features
 
-- 🚀 **Simple Python Client** for making API calls to Adapts services
-- 🔑 **Secure token management** with environment variables or local config
-- 📄 **Flexible payload support** via JSON files or inline data
-- 🔧 **Configurable endpoints** with default endpoint support
-- ✅ **Built-in payload validation** for documentation generation requests
-- 🧪 **Comprehensive test suite** with 98% code coverage
-- 🤖 **GitHub Actions integration** for automated wiki documentation
-- 📦 **CLI tool** for command-line usage
+- 🚀 **`AdaptsClient`** — high-level client with `chat()`, `list_chat_enabled_wikis()`, `list_all_wikis()`, `generate_docs()`
+- 💬 **Chat with wikis** — async start, poll for status, multi-wiki, same-thread follow-ups
+- 📄 **Generate docs & release notes** — submit repos for wiki generation
+- 🔑 **Token loading** via `ADAPTS_API_TOKEN`, `ADAPTS_API_KEY`, `config.json`, or interactive prompt
+- 📦 **CLI**: `adaptsapi (--chat | --chat-status | --chat-enabled-wikis | --list-wikis | --generatedoc | --releasenotes) …`
+- ✅ **Validation**: Pydantic models for chat and generate-docs payloads
+- 🧪 **Test suite** with high coverage; integration demos under `tests/integ/`
 
 ## Installation
 
@@ -51,8 +51,8 @@ pip install adaptsapi
 ### From Source
 
 ```bash
-git clone https://github.com/adaptsai/adaptsapi.git
-cd adaptsapi
+git clone https://github.com/AdaptsAI/adapts_api_client.git
+cd adapts_api_client
 pip install -e .
 ```
 
@@ -60,123 +60,143 @@ pip install -e .
 
 ### 1. Set up your API token
 
-You can provide your API token in three ways (in order of precedence):
+`load_token()` resolves credentials in this order:
 
-1. **Environment variable** (recommended for CI/CD):
-   ```bash
-   export ADAPTS_API_KEY="your-api-token-here"
-   ```
+1. **`ADAPTS_API_TOKEN`** or **`ADAPTS_API_KEY`** (recommended for CI/CD)
+2. **`token`** in `./config.json`
+3. **Interactive prompt** (CLI saves `token` to `config.json`)
 
-2. **Local config file** (`config.json` in current directory):
-   ```json
-   {
-     "token": "your-api-token-here",
-     "endpoint": "https://your-api-endpoint.com/prod/generate_wiki_docs"
-   }
-   ```
+```bash
+export ADAPTS_API_TOKEN="your-api-token-here"
+# or: export ADAPTS_API_KEY="your-api-token-here"
+```
 
-3. **Interactive prompt** (first-time setup):
-   ```bash
-   adaptsapi --data '{"test": "payload"}'
-   # CLI will prompt for token and save to config.json
-   ```
+Optional **`config.json`** (same directory you run the CLI from) for base URL and per-operation paths:
+
+```json
+{
+  "token": "your-api-token-here",
+  "base_url": "https://prod.api.adapts.ai",
+  "generate_wiki_docs_metadata": {
+    "path": "/generate_wiki_docs"
+  },
+  "generate_release_notes_metadata": {
+    "path": "/generate_release_notes"
+  }
+}
+```
+
+You can set a full URL per operation with `"url"` instead of `"path"`. Legacy **`endpoint`** (full generate-docs URL, or host-only base) is still supported—see [Configuration](#configuration).
 
-### 2. Using the Python Client
+First-time CLI without env or `token` in config:
+
+```bash
+adaptsapi --generatedoc --data '{"test": "payload"}'
+# Prompts for token and merges into config.json
+```
+
+### 2. Using the Python client
 
 ```python
-from adaptsapi.generate_docs import post, PayloadValidationError
-
-# Create your payload
-payload = {
-    "email_address": "user@example.com",
-    "user_name": "john_doe",
-    "repo_object": {
-        "repository_name": "my-repo",
-        "source": "github",
-        "repository_url": "https://github.com/user/my-repo",
-        "branch": "main",
-        "size": "12345",
-        "language": "python",
-        "is_private": False,
-        "git_provider_type": "github",
-        "refresh_token": "github_token_here"
-    }
-}
+from adaptsapi import AdaptsClient
 
-# Make the API call
-try:
-    response = post(
-        "https://api.adapts.ai/prod/generate_wiki_docs",
-        "your-api-token",
-        payload
-    )
-    response.raise_for_status()
-    result = response.json()
-    print("✅ Success:", result)
-except PayloadValidationError as e:
-    print(f"❌ Validation error: {e}")
-except Exception as e:
-    print(f"❌ API error: {e}")
+client = AdaptsClient()  # uses ADAPTS_API_KEY env var
+
+# List wikis available for chat
+wikis = client.list_chat_enabled_wikis()
+
+# Chat (blocks until response is ready)
+response = client.chat("What does this repo do?", wiki_name="my-repo_main")
+print(response["response"])
+
+# Chat across multiple wikis
+response = client.chat("Compare these repos.", wiki_names=["wiki_a", "wiki_b"])
+
+# Async chat (returns immediately, poll manually)
+started = client.chat_async("Explain the auth flow.", wiki_name="my-repo_main")
+status = client.poll_chat_status(started["thread_id"], started["created_on"])
+
+# List all wiki generation requests
+all_wikis = client.list_all_wikis()
+```
+
+```python
+# Generate wiki documentation
+client.generate_docs(
+    email="you@example.com",
+    user_name="your_username",
+    repo_name="my-repo",
+    repo_url="https://github.com/user/my-repo",
+    branch="main",
+)
 ```
 
 ### 3. Using the CLI
 
-**Using inline JSON data:**
+Omit **`--endpoint`** when `config.json` supplies defaults (see above).
+
+**Generate docs (inline JSON):**
 ```bash
-adaptsapi \
-  --endpoint "https://api.adapts.ai/prod/generate_wiki_docs" \
+adaptsapi --generatedoc \
+  --endpoint "https://prod.api.adapts.ai/generate_wiki_docs" \
   --data '{"email_address": "user@example.com", "user_name": "john_doe", "repo_object": {...}}'
 ```
 
-**Using a JSON payload file:**
+**Generate docs (payload file):**
 ```bash
-adaptsapi \
-  --endpoint "https://api.adapts.ai/prod/generate_wiki_docs" \
+adaptsapi --generatedoc \
+  --endpoint "https://prod.api.adapts.ai/generate_wiki_docs" \
   --payload-file payload.json
 ```
 
+**Chat:**
+```bash
+adaptsapi --chat --data '{"user_prompt":"What does this do?","wiki_name":"my-repo_main"}'
+adaptsapi --chat-status --data '{"thread_id":"...","created_on":"..."}'
+adaptsapi --chat-enabled-wikis
+adaptsapi --list-wikis
+```
+
+**Release notes** (same payload as wiki docs; uses config default or **`--endpoint`**):
+```bash
+adaptsapi --releasenotes --payload-file payload.json
+```
+
 ## Testing
 
-The library includes a comprehensive test suite with 98% code coverage.
+The suite includes unit tests, CLI/config tests, and optional integration demos.
 
-### Running Tests
+### Running tests
 
-#### Quick Test Run
 ```bash
-# Run all tests
-python -m pytest
+# Full check (pytest + lint + mypy) — same as `make test`
+python run_tests.py --type all
 
-# Run with verbose output
-python -m pytest -v
+# Makefile (uses `.venv/bin/python` when present)
+make test
+```
 
-# Run specific test file
+**Pytest only:**
+```bash
+python -m pytest
+python -m pytest -v
 python -m pytest tests/test_generate_docs.py
-
-# Run with coverage report
 python -m pytest --cov=src/adaptsapi --cov-report=html
 ```
 
-#### Using the Test Runner
+**Test runner:**
 ```bash
-# Run unit tests only (fast, no external dependencies)
 python run_tests.py --type unit
-
-# Run integration tests (requires API key)
-python run_tests.py --type integration
-
-# Run all tests with coverage
+python run_tests.py --type integration   # needs ADAPTS_API_TOKEN / ADAPTS_API_KEY for live calls
 python run_tests.py --type coverage
-
-# Run with custom API key
 python run_tests.py --type integration --api-key "your-api-key"
 ```
 
-#### Test Categories
+**Categories**
 
-- **Unit Tests**: Fast tests that mock external dependencies
-- **Integration Tests**: Tests that make real API calls (marked with `@pytest.mark.integration`)
-- **CLI Tests**: Tests for command-line interface functionality
-- **Config Tests**: Tests for configuration management
+- **Unit**: mocked HTTP and fast paths
+- **Integration / API**: real calls when marked `@pytest.mark.integration` or `@pytest.mark.api` and credentials are set
+- **`tests/integ/`**: runnable demos (`test_chat_demo.py`, `test_get_list_of_all_wikis_demo.py`, `test_generate_docs_demo.py`, `test_workflow.py`)
 
 ### Test Coverage
 
@@ -188,32 +208,35 @@ The test suite covers:
 - ✅ **CLI Functionality**: Command-line argument parsing and file handling
 - ✅ **Configuration**: Token loading and config file management
 
-### Demo Script
+### Integration demos
 
-Run the demonstration script to see the library in action:
+Runnable modules under `tests/integ/` (pytest or `python tests/integ/...`):
 
-```bash
-python test_generate_docs_demo.py
-```
+- `test_chat_demo.py` — chat validation, mocked POST, optional live call
+- `test_get_list_of_all_wikis_demo.py` — list wikis, mocked POST, optional live call
+- `test_generate_docs_demo.py` — validation, metadata, optional live generate-docs call
+- `test_workflow.py` — end-to-end style walkthrough
 
-This script shows:
-- Payload validation examples
-- Metadata population demonstration
-- API call structure
-- Real API testing (if API key is available)
+Set **`ADAPTS_API_TOKEN`** or **`ADAPTS_API_KEY`** for live requests.
 
 ## Usage
 
 ### Command Line Options
 
 ```bash
-adaptsapi [OPTIONS]
+adaptsapi (--chat | --chat-status | --chat-enabled-wikis | --list-wikis | --generatedoc | --releasenotes) [OPTIONS]
 ```
 
 | Option | Description | Required |
 |--------|-------------|----------|
-| `--endpoint URL` | Full URL of the API endpoint | Yes (unless set in config.json) |
-| `--data JSON` | Inline JSON payload string | Yes (or --payload-file) |
+| `--chat` | POST a chat request (`user_prompt`, `wiki_name`/`wiki_names`) | One mode required |
+| `--chat-status` | Poll chat status (`thread_id`, `created_on`) | One mode required |
+| `--chat-enabled-wikis` | List wikis available for chat (no payload) | One mode required |
+| `--list-wikis` | List all wiki generation requests (no payload) | One mode required |
+| `--generatedoc` | POST a generate-docs / wiki payload | One mode required |
+| `--releasenotes` | POST a release-notes payload | One mode required |
+| `--endpoint URL` | Full API URL | No (defaults from `config.json`) |
+| `--data JSON` | Inline JSON payload string | Yes (or --payload-file; not needed for --chat-enabled-wikis / --list-wikis) |
 | `--payload-file FILE` | Path to JSON payload file | Yes (or --data) |
 | `--timeout SECONDS` | Request timeout in seconds (default: 30) | No |
 
@@ -260,6 +283,8 @@ For documentation generation, your payload should follow this structure:
 - `repo_object.commit_message`: Commit message
 - `repo_object.commit_author`: Commit author
 - `repo_object.directory_name`: Specific directory to process
+- `repo_object.previous_commit_hash`: Previous commit hash (common for release notes)
+- `repo_object.pr_number`, `pr_title`, `pr_body`, `pr_url`: Pull request context (strings)
 
 ## GitHub Actions Integration
 
@@ -284,14 +309,14 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v5
         with:
-          python-version: "3.11"
+          python-version: "3.12"
           
       - name: Install adaptsapi
         run: pip install adaptsapi
         
       - name: Generate documentation
         env:
-          ADAPTS_API_KEY: ${{ secrets.ADAPTS_API_KEY }}
+          ADAPTS_API_TOKEN: ${{ secrets.ADAPTS_API_TOKEN }}
         run: |
           python -c "
           import os
@@ -314,12 +339,12 @@ jobs:
           }
           
           resp = post(
-              'https://your-api-endpoint.com/prod/generate_wiki_docs',
-              os.environ['ADAPTS_API_KEY'],
+              'https://prod.api.adapts.ai/generate_wiki_docs',
+              os.environ['ADAPTS_API_TOKEN'],
               payload
           )
           resp.raise_for_status()
-          print('✅ Documentation generated successfully')
+          print('Documentation generated successfully')
           "
 ```
 
@@ -328,25 +353,51 @@ jobs:
 1. Go to your repository on GitHub
 2. Click **Settings** → **Secrets and variables** → **Actions**
 3. Click **New repository secret**
-4. Add `ADAPTS_API_KEY` with your API token value
+4. Add **`ADAPTS_API_TOKEN`** (recommended) or **`ADAPTS_API_KEY`** with your API token value
+
+If the repository already stores the token under `ADAPTS_API_KEY`, map it in the workflow: `ADAPTS_API_TOKEN: ${{ secrets.ADAPTS_API_KEY }}`.
 
 ## Configuration
 
-### Config File Format
+### `config.json`
+
+Placed in the **current working directory**. Common keys:
+
+| Key | Purpose |
+|-----|---------|
+| `token` | API key (if not using env) |
+| `base_url` / `api_base_url` | API host; paths below are appended |
+| `generate_wiki_docs_metadata` | `{ "url": "..." }` or `{ "path": "/generate_wiki_docs" }` |
+| `generate_release_notes_metadata` | `{ "url": "..." }` or `{ "path": "/generate_release_notes" }` |
+| `endpoint` | Legacy full generate-docs URL, or host-only base |
+
+Override the host with **`ADAPTS_API_BASE_URL`**.
+
+**Example (paths + base):**
+
+```json
+{
+  "token": "your-api-token-here",
+  "base_url": "https://prod.api.adapts.ai",
+  "generate_wiki_docs_metadata": { "path": "/generate_wiki_docs" }
+}
+```
 
-The `config.json` file in your current working directory can contain:
+**Example (legacy single endpoint):**
 
 ```json
 {
   "token": "your-api-token-here",
-  "endpoint": "https://your-default-endpoint.com/prod/generate_wiki_docs"
+  "endpoint": "https://prod.api.adapts.ai/generate_wiki_docs"
 }
 ```
 
-### Environment Variables
+### Environment variables
 
-- `ADAPTS_API_KEY`: Your API authentication token (used by the library)
-- `ADAPTS_API_TOKEN`: Alternative token variable (used by CLI)
+| Variable | Purpose |
+|----------|---------|
+| `ADAPTS_API_TOKEN` / `ADAPTS_API_KEY` | API key (`load_token()` checks both) |
+| `ADAPTS_API_BASE_URL` | Base URL when not set in `config.json` |
 
 ## Error Handling
 
@@ -368,14 +419,14 @@ The library provides comprehensive error handling:
 
 ### Prerequisites
 
-- Python 3.10+
+- Python 3.12+
 - pip
 
 ### Setup Development Environment
 
 ```bash
-git clone https://github.com/adaptsai/adaptsapi.git
-cd adaptsapi
+git clone https://github.com/AdaptsAI/adapts_api_client.git
+cd adapts_api_client
 python -m venv .venv
 source .venv/bin/activate  # On Windows: .venv\Scripts\activate
 pip install -r requirements-dev.txt
@@ -399,21 +450,16 @@ This includes:
 - `black` - Code formatting
 - `isort` - Import sorting
 
-### Running Tests
+### Running tests
 
 ```bash
-# Run all tests
 python -m pytest
-
-# Run with coverage
 python -m pytest --cov=src/adaptsapi --cov-report=html
-
-# Run specific test categories
-python -m pytest -m "not integration"  # Unit tests only
-python -m pytest -m "integration"      # Integration tests only
-
-# Run the test runner
+python -m pytest -m "not integration"
+python -m pytest -m "integration"
 python run_tests.py --type all
+make test          # same as run_tests.py --type all
+make build         # test then python -m build
 ```
 
 ### Code Quality
@@ -452,15 +498,16 @@ The project uses `pyproject.toml` for build configuration. Key settings:
 ```toml
 [project]
 name = "adaptsapi"
-version = "0.1.4"
-description = "CLI to enqueue triggers via internal API Gateway → SNS"
+version = "0.2.0"
+description = "Python client library and CLI for the Adapts API"
 readme = { file = "README.md", content-type = "text/markdown" }
-requires-python = ">=3.10"
+requires-python = ">=3.12"
 authors = [
   { name = "VerifyAI Inc.", email = "dev@adapts.ai" }
 ]
 dependencies = [
   "requests",
+  "pydantic[email]>=2.4",
 ]
 ```
 
@@ -491,7 +538,7 @@ python -m build
 
 # Verify the built packages
 ls -la dist/
-# Should show: adaptsapi-0.1.4.tar.gz and adaptsapi-0.1.4-py3-none-any.whl
+# Should show: adaptsapi-0.2.0.tar.gz and adaptsapi-0.2.0-py3-none-any.whl
 ```
 
 #### 3. Test on TestPyPI (Recommended)
@@ -540,7 +587,7 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v5
         with:
-          python-version: "3.10"
+          python-version: "3.12"
           
       - name: Install dependencies
         run: |
@@ -582,7 +629,7 @@ Set these secrets in your GitHub repository:
 
 Follow [semantic versioning](https://semver.org/):
 
-- **MAJOR.MINOR.PATCH** (e.g., 0.1.4)
+- **MAJOR.MINOR.PATCH** (e.g., 0.2.0)
 - **MAJOR**: Breaking changes
 - **MINOR**: New features, backward compatible
 - **PATCH**: Bug fixes, backward compatible
@@ -594,14 +641,14 @@ Update version in these files:
 1. **pyproject.toml**:
    ```toml
    [project]
-   version = "0.1.5"  # Update this
+   version = "0.2.1"  # Update this
    ```
 
 2. **setup.py**:
    ```python
    setup(
        name="adaptsapi",
-       version="0.1.5",  # Update this
+       version="0.2.1",  # Update this
        # ...
    )
    ```
@@ -614,7 +661,7 @@ Before publishing, ensure:
 - [ ] Code is linted: `flake8 src/adaptsapi tests/`
 - [ ] Type checking passes: `mypy src/adaptsapi/`
 - [ ] Documentation is updated
-- [ ] Version numbers are updated in both `pyproject.toml` and `setup.py`
+- [ ] Version numbers are updated in `pyproject.toml`, `setup.py`, `setup.cfg`, and `src/adaptsapi/__init__.py`
 - [ ] CHANGELOG is updated
 - [ ] Package builds successfully: `python -m build`
 - [ ] Package installs correctly: `pip install dist/*.whl`
@@ -659,7 +706,7 @@ If you need to rollback a release:
 
 2. **Yank the release** (recommended):
    ```bash
-   python -m twine delete --username __token__ --password $PYPI_API_TOKEN adaptsapi 0.1.4
+   python -m twine delete --username __token__ --password $PYPI_API_TOKEN adaptsapi 0.2.0
    ```
 
 3. **Publish a new patch version** with fixes
@@ -677,107 +724,81 @@ If you need to rollback a release:
 After publishing, verify the package:
 
 ```bash
-# Install from PyPI
 pip install adaptsapi
 
-# Test imports
 python -c "
-from adaptsapi.generate_docs import post, PayloadValidationError
-from adaptsapi.cli import main
-from adaptsapi.config import load_token
-print('✅ All imports successful!')
+from adaptsapi import AdaptsClient, __version__
+from adaptsapi.chat import post_chat
+from adaptsapi.generate_docs import post
+print(f'adaptsapi {__version__} — all imports OK')
 "
 
-# Test CLI
 adaptsapi --help
-
-# Run tests
-python -m pytest tests/test_generate_docs.py -v
 ```
 
-## API Reference
-
-### Core Functions
-
-#### `post(endpoint, auth_token, payload, timeout=30)`
-
-Make a POST request to the Adapts API with automatic payload validation and metadata population.
-
-**Parameters:**
-- `endpoint` (str): The API endpoint URL
-- `auth_token` (str): Authentication token
-- `payload` (dict): JSON payload to send
-- `timeout` (int): Request timeout in seconds (default: 30)
-
-**Returns:**
-- `requests.Response`: The HTTP response object
+## API reference
 
-**Raises:**
-- `PayloadValidationError`: If payload validation fails
-- `requests.RequestException`: If the HTTP request fails
+### `adaptsapi.generate_docs`
 
-#### `_validate_payload(payload)`
+- **`post(endpoint, token, payload, timeout=30)`** — Wiki docs only (`action`: `code_to_wiki`); validate, populate metadata, POST with `x-api-key`.
+- **`default_generate_docs_url()`** — Generate-docs URL from config (`load_default_endpoint()`), or `None`.
 
-Validate the payload structure and data types.
+Private helpers **`_validate_payload`** and **`_populate_metadata`** are shared with release notes (schema + metadata).
 
-**Parameters:**
-- `payload` (dict): The payload to validate
+### `adaptsapi.release_notes`
 
-**Raises:**
-- `PayloadValidationError`: If validation fails
+- **`post(endpoint, token, payload, timeout=30)`** — Release notes (`action`: `generate_release_notes`); same transport as generate-docs.
+- **`default_release_notes_url()`** — Release-notes URL from config (`load_release_notes_endpoint()`), or `None`.
 
-#### `_populate_metadata(payload)`
+### `adaptsapi.chat`
 
-Automatically populate metadata fields in the payload.
+- **`post_chat(endpoint, token, payload)`** — Start a chat (returns `thread_id` + `created_on`).
+- **`post_chat_status(endpoint, token, payload)`** — Poll for chat response.
+- **`post_chat_enabled_wikis(endpoint, token)`** — List wikis available for chat.
 
-**Parameters:**
-- `payload` (dict): The payload to populate with metadata
+### `adaptsapi.get_list_of_all_wikis`
 
-### CLI Functions
+- **`post(endpoint, token)`** — List all wiki generation requests.
 
-#### `main()`
+### `adaptsapi.config`
 
-Main CLI entry point that handles argument parsing and API calls.
+- **`load_token()`** — `ADAPTS_API_TOKEN` / `ADAPTS_API_KEY`, then `config.json` `token`, then prompt.
+- **`load_api_base_url()`** — `ADAPTS_API_BASE_URL`, then config, then default prod base.
+- **`load_chat_url()`**, **`load_chat_status_url()`**, **`load_chat_enabled_wikis_url()`**, **`load_get_list_of_all_wikis_url()`** — Endpoint URLs from config or defaults.
 
-### Configuration Functions
+### CLI
 
-#### `load_token()`
+- **`adaptsapi.cli.main()`** — Entry point; requires one of **`--chat`**, **`--chat-status`**, **`--chat-enabled-wikis`**, **`--list-wikis`**, **`--generatedoc`**, or **`--releasenotes`**.
 
-Load authentication token from environment variables or config file.
-
-**Returns:**
-- `str`: The authentication token
-
-**Raises:**
-- `ConfigError`: If no token can be found
-
-#### `load_default_endpoint()`
-
-Load default endpoint from config file.
-
-**Returns:**
-- `str | None`: The default endpoint URL or None
-
-## Project Structure
+## Project structure
 
 ```
-adaptsapi/
+adapts_api_client/
 ├── src/adaptsapi/
-│   ├── __init__.py
-│   ├── generate_docs.py    # Main API client functionality
-│   ├── cli.py             # Command-line interface
-│   └── config.py          # Configuration management
+│   ├── __init__.py          # AdaptsClient, AdaptsAPIError, __version__
+│   ├── client.py            # High-level AdaptsClient
+│   ├── chat.py              # Chat API (post_chat, post_chat_status, post_chat_enabled_wikis)
+│   ├── get_list_of_all_wikis.py
+│   ├── generate_docs.py     # Wiki-docs client
+│   ├── release_notes.py     # Release-notes client
+│   ├── cli.py
+│   ├── config.py
+│   └── models/              # Pydantic models (ChatRequest, ChatStatusRequest, …)
 ├── tests/
-│   ├── conftest.py        # Test fixtures and configuration
-│   ├── test_generate_docs.py  # Tests for generate_docs module
-│   ├── test_cli.py        # Tests for CLI functionality
-│   └── test_config.py     # Tests for configuration management
-├── run_tests.py           # Test runner script
-├── test_generate_docs_demo.py  # Demonstration script
-├── requirements.txt       # Runtime dependencies
-├── requirements-dev.txt   # Development dependencies
-├── pytest.ini           # Pytest configuration
-└── TESTING.md           # Detailed testing guide
+│   ├── conftest.py
+│   ├── integ/               # Demos: chat, list_wikis, generate_docs, workflow
+│   ├── test_chat.py
+│   ├── test_client.py
+│   ├── test_get_list_of_all_wikis.py
+│   ├── test_generate_docs.py
+│   ├── test_release_notes.py
+│   ├── test_cli.py
+│   └── test_config.py
+├── Makefile
+├── run_tests.py
+├── requirements-dev.txt
+├── pytest.ini
+└── TESTING.md
 ```
 
 ## License
@@ -793,23 +814,28 @@ This software is licensed under the Adapts API Use-Only License v1.0. See [LICEN
 ## Support
 
 - 📧 Email: dev@adapts.ai
-- 🐛 Issues: [GitHub Issues](https://github.com/adaptsai/adaptsapi/issues)
+- 🐛 Issues: [GitHub Issues](https://github.com/AdaptsAI/adapts_api_client/issues)
 - 📖 Documentation: This README and [TESTING.md](TESTING.md)
 
 ## Changelog
 
-### v0.1.4 (Latest)
-- ✅ Comprehensive test suite with 98% coverage
-- ✅ Improved error handling and validation
-- ✅ Enhanced CLI functionality
-- ✅ Better configuration management
-- ✅ Development tools and documentation
+### v0.2.0 (latest)
+
+- **`AdaptsClient`** — high-level client (`chat`, `chat_async`, `poll_chat_status`, `list_chat_enabled_wikis`, `list_all_wikis`, `generate_docs`)
+- **Chat API**: `post_chat`, `post_chat_status`, `post_chat_enabled_wikis` in `adaptsapi.chat`
+- **`get_list_of_all_wikis`** module
+- **CLI**: `--chat`, `--chat-status`, `--chat-enabled-wikis`, `--list-wikis`
+- Pydantic models: `ChatRequest`, `ChatStatusRequest`
+
+### v0.1.9
+
+- Prompt API client, Pydantic models, `config.json` metadata blocks
+- Release notes module, CLI `--releasenotes`
+- `load_token()` accepts `ADAPTS_API_TOKEN` or `ADAPTS_API_KEY`
 
-### v0.1.3
-- Patch updates
+### v0.1.4 and earlier
 
-### v0.1.2
-- Initial stable release
+- Generate-docs client, CLI, tests, and legacy `endpoint`-only configuration
 
 ---