Metadata-Version: 2.4
Name: mai-openkb-core
Version: 0.3.0
Summary: Headless OpenKB-compatible core for MAI integrations
Project-URL: Repository, https://github.com/songjack_microsoft/mai-openkb-core
License-Expression: Apache-2.0
License-File: LICENSE
License-File: NOTICE
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.10
Provides-Extra: dev
Requires-Dist: build==1.2.2.post1; extra == 'dev'
Requires-Dist: mypy==1.15.0; extra == 'dev'
Requires-Dist: pytest==9.0.3; extra == 'dev'
Requires-Dist: ruff==0.9.7; extra == 'dev'
Requires-Dist: twine==6.1.0; extra == 'dev'
Description-Content-Type: text/markdown

# mai-openkb-core

`mai-openkb-core` is a small, headless Python library for integrating OpenKB-derived
knowledge-base behavior into MAI services through application-owned adapters.

Install the distribution from PyPI and import the `openkb_core` package:

```bash
pip install mai-openkb-core
```

```python
import openkb_core
```

API version 3 adds `OpenKBEngine.stream_chat_turn(...)` and exposes the
history-aware query used for retrieval as `ChatTurnResult.retrieval_query`.
Conversation authorization and persistence remain host-owned.

This is an independent community project. It is not an official VectifyAI project and is
not endorsed or supported by VectifyAI. Portions derived from OpenKB retain their original
copyright and attribution under the Apache License 2.0; see `LICENSE` and `NOTICE`.

## Development

```bash
python -m pip install -e ".[dev]"
ruff check .
mypy src/openkb_core
pytest
python -m build
python -m twine check dist/*
```

Releases are built and checked locally before upload to PyPI.
