lorebo-sdk 0.1.0__tar.gz

lorebo_sdk-0.1.0/.gitignore

@@ -0,0 +1,14 @@
+__pycache__/
+*.py[oc]
+build/
+dist/
+*.egg-info
+.venv/
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+node_modules/
+.idea/
+.env
+typescript/README.md
+typescript/LICENSE

lorebo_sdk-0.1.0/LICENSE

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

lorebo_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,297 @@
+Metadata-Version: 2.5
+Name: lorebo-sdk
+Version: 0.1.0
+Summary: Save and retrieve Lorebo knowledge from your application with any LLM
+Project-URL: Homepage, https://github.com/lexrag/lorebo-sdk
+Project-URL: Documentation, https://github.com/lexrag/lorebo-sdk#quick-start
+Project-URL: Repository, https://github.com/lexrag/lorebo-sdk
+Project-URL: Issues, https://github.com/lexrag/lorebo-sdk/issues
+Author: LexRAG
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agents,knowledge-base,llm,lorebo,mcp,pydantic-ai
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: AsyncIO
+Classifier: Framework :: Pydantic
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Requires-Dist: fastmcp-slim[client]>=4.1
+Requires-Dist: httpx>=0.28
+Requires-Dist: pydantic-ai-slim[mcp]>=2.59
+Requires-Dist: pydantic>=2.11
+Provides-Extra: anthropic
+Requires-Dist: pydantic-ai-slim[anthropic]>=2.59; extra == 'anthropic'
+Provides-Extra: bedrock
+Requires-Dist: pydantic-ai-slim[bedrock]>=2.59; extra == 'bedrock'
+Provides-Extra: google
+Requires-Dist: pydantic-ai-slim[google]>=2.59; extra == 'google'
+Provides-Extra: groq
+Requires-Dist: pydantic-ai-slim[groq]>=2.59; extra == 'groq'
+Provides-Extra: mistral
+Requires-Dist: pydantic-ai-slim[mistral]>=2.59; extra == 'mistral'
+Provides-Extra: openai
+Requires-Dist: pydantic-ai-slim[openai]>=2.59; extra == 'openai'
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <a href="https://github.com/lexrag/lorebo-sdk">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/lexrag/lorebo-sdk/main/assets/lorebo-logo-on-dark.svg">
+      <img src="https://raw.githubusercontent.com/lexrag/lorebo-sdk/main/assets/lorebo-logo-primary.svg" width="264" alt="Lorebo">
+    </picture>
+  </a>
+</p>
+
+<h1 align="center">Lorebo SDK</h1>
+
+<p align="center"><strong>Give your application a knowledge base that people and AI share.</strong></p>
+
+<p align="center">
+  <a href="https://github.com/lexrag/lorebo-sdk/actions/workflows/check.yml"><img src="https://github.com/lexrag/lorebo-sdk/actions/workflows/check.yml/badge.svg" alt="Checks"></a>
+  <a href="https://github.com/lexrag/lorebo-sdk/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-593EDC" alt="MIT license"></a>
+  <a href="https://pypi.org/project/lorebo-sdk/"><img src="https://img.shields.io/badge/Python-3.12+-3776AB" alt="Python 3.12+"></a>
+  <a href="https://www.npmjs.com/package/lorebo-sdk"><img src="https://img.shields.io/badge/TypeScript-Node_22+-3178C6" alt="TypeScript, Node 22+"></a>
+</p>
+
+<p align="center">
+  <a href="#quick-start">Quick start</a> ·
+  <a href="#results">Results</a> ·
+  <a href="#choosing-a-base">Choosing a base</a> ·
+  <a href="#errors">Errors</a> ·
+  <a href="#connecting-to-lorebo">Connecting to Lorebo</a>
+</p>
+
+Lorebo turns useful AI work into knowledge you own:
+readable, connected pages that people and AI agents can find, correct and reuse.
+
+The Lorebo SDK lets your application use that knowledge with two calls:
+
+- **`capture`** saves the durable part of a text as Lorebo pages. It searches
+  first, updates pages that already cover the topic and creates the rest.
+- **`explore`** answers a question from the pages in Lorebo and returns the
+  pages the answer relies on.
+
+Both calls run the official Lorebo skills with the language model you choose.
+The SDK is available for Python and TypeScript with the same behavior.
+
+## Requirements
+
+- A Lorebo MCP endpoint:
+  - Lorebo Desktop serves `http://127.0.0.1:8757/mcp` on your machine.
+  - [Lorebo Headless](https://github.com/orgs/lexrag/packages/container/package/lorebo-headless) serves `http://127.0.0.1:8758/mcp` when run locally with the example below.
+- A language model that supports tool calls and structured output.
+- Python 3.12+ or Node.js 22+.
+
+## Connecting to Lorebo
+
+With Desktop already running, use its local MCP URL in the quick start.
+To run Headless with Docker instead:
+
+```bash
+docker run --detach --name lorebo \
+  --publish 127.0.0.1:8758:8758 \
+  --volume lorebo-data:/data \
+  ghcr.io/lexrag/lorebo-headless:stable
+```
+
+Use `http://127.0.0.1:8758/mcp` as the SDK URL and `None` (`null` in
+TypeScript) as the token. The volume preserves your bases when the container
+is recreated. Back up the complete volume before upgrading and stop the old
+container before starting another writer on it. The official image is Linux
+amd64; ARM hosts need amd64 emulation.
+
+For a remote deployment, use the HTTPS URL and authentication configured by
+your deployment operator. The SDK's `token` argument sends an optional HTTP
+Bearer token; it does not configure the server's authentication or perform
+Lorebo broker OAuth sign-in. Keep the native server behind the authenticated
+deployment perimeter. No provider API key or Lorebo credential belongs in source
+code; configure model-provider credentials through the provider's environment
+settings.
+
+## Quick start
+
+### Python
+
+```bash
+pip install "lorebo-sdk[openai]"
+```
+
+The extra installs the model provider. `anthropic`, `google`, `groq`,
+`mistral` and `bedrock` are available too.
+
+```python
+import asyncio
+
+from lorebo_sdk.client import Lorebo
+
+
+async def main() -> None:
+    lorebo = Lorebo.from_url(
+        url="http://127.0.0.1:8757/mcp",
+        token=None,
+        model="openai:gpt-5-mini",
+        base_ref="local:your-entry-id",
+    )
+
+    captured = await lorebo.capture("Our API listens on port 8757, on loopback only.")
+    print(captured.summary)
+
+    explored = await lorebo.explore("Which port does our API use?")
+    print(explored.answer)
+
+
+asyncio.run(main())
+```
+
+`model` accepts any [Pydantic AI](https://ai.pydantic.dev/models/) model or model name.
+
+### TypeScript
+
+```bash
+npm install lorebo-sdk ai @ai-sdk/openai
+```
+
+```ts
+import { openai } from "@ai-sdk/openai";
+import { createLorebo } from "lorebo-sdk";
+
+const lorebo = createLorebo({
+  url: "http://127.0.0.1:8757/mcp",
+  token: null,
+  model: openai("gpt-5-mini"),
+  baseRef: "local:your-entry-id",
+});
+
+const captured = await lorebo.capture("Our API listens on port 8757, on loopback only.");
+console.log(captured.summary);
+
+const explored = await lorebo.explore("Which port does our API use?");
+console.log(explored.answer);
+```
+
+`model` accepts any [AI SDK](https://ai-sdk.dev/providers) language model.
+
+## Results
+
+`capture` returns what changed in Lorebo:
+
+| Field     | Meaning                             |
+| --------- | ----------------------------------- |
+| `summary` | One or two sentences for your user. |
+| `created` | Pages this call created.            |
+| `updated` | Existing pages this call changed.   |
+
+`explore` returns the answer and its sources:
+
+| Field     | Meaning                                             |
+| --------- | --------------------------------------------------- |
+| `answer`  | Plain-text answer for your user.                    |
+| `sources` | Pages the answer relies on, each read in this call. |
+
+Each page has an `id`, a `title` and the `base_ref` (`baseRef` in TypeScript)
+of the base that holds it. The SDK builds these lists from Lorebo's responses,
+not from the model's text, so they only contain pages that exist.
+
+Summaries and answers are plain text written for your user, without the model's
+reasoning, tool names or page IDs. Nothing is printed to your console.
+
+## Choosing a base
+
+A Lorebo installation can hold several knowledge bases. Pass `base_ref` to
+lock every call to one of them:
+
+```python
+lorebo = Lorebo.from_url(..., base_ref="local:your-entry-id")
+```
+
+When the model tries to use another base, the call stops with
+`LockedBaseError` before anything is written there.
+
+With multi-base permissions, pass `None` (`null` in TypeScript) to let the skill choose. `capture` then
+picks the base the knowledge belongs to, or creates one when none fits.
+`explore` picks the base that holds the answer.
+
+For a local Headless container, run `docker exec lorebo lorebo-headless --json
+base list` and use `local:<entry_id>` for the active base. Desktop also displays
+the base reference on Base Home. Use the registry entry ID, not the database's
+logical base ID.
+
+When the server exposes multi-base MCP tools, list bases with an unlocked client:
+
+```python
+for base in await lorebo.list_bases():
+    print(base.base_ref, base.label)
+```
+
+```ts
+for (const base of await lorebo.listBases()) {
+  console.log(base.baseRef, base.label);
+}
+```
+
+`create_base` (`createBase` in TypeScript) creates a base from your code.
+Actions remain subject to the connected runtime's account entitlements and
+agent permissions for each base.
+On Free, lock the client to the active base; multi-base discovery and base
+creation through MCP require the corresponding Pro permissions.
+
+## What the model can do
+
+The model only sees the Lorebo tools its skill needs:
+
+- `explore` can read and search pages.
+- `capture` can also create, update and link pages.
+- Without a locked base, both can list bases and `capture` can create one when
+  the connected runtime exposes and permits those tools.
+
+Tools that delete pages, delete bases, restore backups or change sharing are
+never offered.
+
+## Errors
+
+Every SDK error extends `LoreboError`:
+
+| Error               | Raised when                                                    |
+| ------------------- | -------------------------------------------------------------- |
+| `LockedBaseError`   | The model tried to use a base other than the locked one.       |
+| `LoreboToolError`   | Lorebo rejected a call or returned an unexpected response.     |
+| `RunLimitError`     | The skill did not finish within the step limit of 24.          |
+| `SkillPackageError` | A Lorebo skill could not be downloaded or failed verification. |
+
+Python imports them from `lorebo_sdk.errors`, TypeScript from `lorebo-sdk/errors`.
+Errors from the model provider are passed through unchanged.
+
+## Lorebo skills
+
+Each SDK release is pinned to one version of the official `lorebo-capture`
+and `lorebo-explore` skills. They are downloaded from `downloads.lorebo.com`
+on first use, checked against a SHA-256 digest built into the SDK and kept in
+memory for the life of the client.
+
+## Development
+
+```bash
+uv sync
+uv run mypy
+uv run ruff check .
+uv run pytest
+```
+
+```bash
+cd typescript
+npm ci
+npm run check
+npm run build
+npm pack --dry-run
+```
+
+Package publication is described in
+[Releasing](https://github.com/lexrag/lorebo-sdk/blob/main/docs/releasing.md).
+
+## License
+
+[MIT](https://github.com/lexrag/lorebo-sdk/blob/main/LICENSE)

lorebo_sdk-0.1.0/README.md

@@ -0,0 +1,258 @@
+<p align="center">
+  <a href="https://github.com/lexrag/lorebo-sdk">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/lexrag/lorebo-sdk/main/assets/lorebo-logo-on-dark.svg">
+      <img src="https://raw.githubusercontent.com/lexrag/lorebo-sdk/main/assets/lorebo-logo-primary.svg" width="264" alt="Lorebo">
+    </picture>
+  </a>
+</p>
+
+<h1 align="center">Lorebo SDK</h1>
+
+<p align="center"><strong>Give your application a knowledge base that people and AI share.</strong></p>
+
+<p align="center">
+  <a href="https://github.com/lexrag/lorebo-sdk/actions/workflows/check.yml"><img src="https://github.com/lexrag/lorebo-sdk/actions/workflows/check.yml/badge.svg" alt="Checks"></a>
+  <a href="https://github.com/lexrag/lorebo-sdk/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-593EDC" alt="MIT license"></a>
+  <a href="https://pypi.org/project/lorebo-sdk/"><img src="https://img.shields.io/badge/Python-3.12+-3776AB" alt="Python 3.12+"></a>
+  <a href="https://www.npmjs.com/package/lorebo-sdk"><img src="https://img.shields.io/badge/TypeScript-Node_22+-3178C6" alt="TypeScript, Node 22+"></a>
+</p>
+
+<p align="center">
+  <a href="#quick-start">Quick start</a> ·
+  <a href="#results">Results</a> ·
+  <a href="#choosing-a-base">Choosing a base</a> ·
+  <a href="#errors">Errors</a> ·
+  <a href="#connecting-to-lorebo">Connecting to Lorebo</a>
+</p>
+
+Lorebo turns useful AI work into knowledge you own:
+readable, connected pages that people and AI agents can find, correct and reuse.
+
+The Lorebo SDK lets your application use that knowledge with two calls:
+
+- **`capture`** saves the durable part of a text as Lorebo pages. It searches
+  first, updates pages that already cover the topic and creates the rest.
+- **`explore`** answers a question from the pages in Lorebo and returns the
+  pages the answer relies on.
+
+Both calls run the official Lorebo skills with the language model you choose.
+The SDK is available for Python and TypeScript with the same behavior.
+
+## Requirements
+
+- A Lorebo MCP endpoint:
+  - Lorebo Desktop serves `http://127.0.0.1:8757/mcp` on your machine.
+  - [Lorebo Headless](https://github.com/orgs/lexrag/packages/container/package/lorebo-headless) serves `http://127.0.0.1:8758/mcp` when run locally with the example below.
+- A language model that supports tool calls and structured output.
+- Python 3.12+ or Node.js 22+.
+
+## Connecting to Lorebo
+
+With Desktop already running, use its local MCP URL in the quick start.
+To run Headless with Docker instead:
+
+```bash
+docker run --detach --name lorebo \
+  --publish 127.0.0.1:8758:8758 \
+  --volume lorebo-data:/data \
+  ghcr.io/lexrag/lorebo-headless:stable
+```
+
+Use `http://127.0.0.1:8758/mcp` as the SDK URL and `None` (`null` in
+TypeScript) as the token. The volume preserves your bases when the container
+is recreated. Back up the complete volume before upgrading and stop the old
+container before starting another writer on it. The official image is Linux
+amd64; ARM hosts need amd64 emulation.
+
+For a remote deployment, use the HTTPS URL and authentication configured by
+your deployment operator. The SDK's `token` argument sends an optional HTTP
+Bearer token; it does not configure the server's authentication or perform
+Lorebo broker OAuth sign-in. Keep the native server behind the authenticated
+deployment perimeter. No provider API key or Lorebo credential belongs in source
+code; configure model-provider credentials through the provider's environment
+settings.
+
+## Quick start
+
+### Python
+
+```bash
+pip install "lorebo-sdk[openai]"
+```
+
+The extra installs the model provider. `anthropic`, `google`, `groq`,
+`mistral` and `bedrock` are available too.
+
+```python
+import asyncio
+
+from lorebo_sdk.client import Lorebo
+
+
+async def main() -> None:
+    lorebo = Lorebo.from_url(
+        url="http://127.0.0.1:8757/mcp",
+        token=None,
+        model="openai:gpt-5-mini",
+        base_ref="local:your-entry-id",
+    )
+
+    captured = await lorebo.capture("Our API listens on port 8757, on loopback only.")
+    print(captured.summary)
+
+    explored = await lorebo.explore("Which port does our API use?")
+    print(explored.answer)
+
+
+asyncio.run(main())
+```
+
+`model` accepts any [Pydantic AI](https://ai.pydantic.dev/models/) model or model name.
+
+### TypeScript
+
+```bash
+npm install lorebo-sdk ai @ai-sdk/openai
+```
+
+```ts
+import { openai } from "@ai-sdk/openai";
+import { createLorebo } from "lorebo-sdk";
+
+const lorebo = createLorebo({
+  url: "http://127.0.0.1:8757/mcp",
+  token: null,
+  model: openai("gpt-5-mini"),
+  baseRef: "local:your-entry-id",
+});
+
+const captured = await lorebo.capture("Our API listens on port 8757, on loopback only.");
+console.log(captured.summary);
+
+const explored = await lorebo.explore("Which port does our API use?");
+console.log(explored.answer);
+```
+
+`model` accepts any [AI SDK](https://ai-sdk.dev/providers) language model.
+
+## Results
+
+`capture` returns what changed in Lorebo:
+
+| Field     | Meaning                             |
+| --------- | ----------------------------------- |
+| `summary` | One or two sentences for your user. |
+| `created` | Pages this call created.            |
+| `updated` | Existing pages this call changed.   |
+
+`explore` returns the answer and its sources:
+
+| Field     | Meaning                                             |
+| --------- | --------------------------------------------------- |
+| `answer`  | Plain-text answer for your user.                    |
+| `sources` | Pages the answer relies on, each read in this call. |
+
+Each page has an `id`, a `title` and the `base_ref` (`baseRef` in TypeScript)
+of the base that holds it. The SDK builds these lists from Lorebo's responses,
+not from the model's text, so they only contain pages that exist.
+
+Summaries and answers are plain text written for your user, without the model's
+reasoning, tool names or page IDs. Nothing is printed to your console.
+
+## Choosing a base
+
+A Lorebo installation can hold several knowledge bases. Pass `base_ref` to
+lock every call to one of them:
+
+```python
+lorebo = Lorebo.from_url(..., base_ref="local:your-entry-id")
+```
+
+When the model tries to use another base, the call stops with
+`LockedBaseError` before anything is written there.
+
+With multi-base permissions, pass `None` (`null` in TypeScript) to let the skill choose. `capture` then
+picks the base the knowledge belongs to, or creates one when none fits.
+`explore` picks the base that holds the answer.
+
+For a local Headless container, run `docker exec lorebo lorebo-headless --json
+base list` and use `local:<entry_id>` for the active base. Desktop also displays
+the base reference on Base Home. Use the registry entry ID, not the database's
+logical base ID.
+
+When the server exposes multi-base MCP tools, list bases with an unlocked client:
+
+```python
+for base in await lorebo.list_bases():
+    print(base.base_ref, base.label)
+```
+
+```ts
+for (const base of await lorebo.listBases()) {
+  console.log(base.baseRef, base.label);
+}
+```
+
+`create_base` (`createBase` in TypeScript) creates a base from your code.
+Actions remain subject to the connected runtime's account entitlements and
+agent permissions for each base.
+On Free, lock the client to the active base; multi-base discovery and base
+creation through MCP require the corresponding Pro permissions.
+
+## What the model can do
+
+The model only sees the Lorebo tools its skill needs:
+
+- `explore` can read and search pages.
+- `capture` can also create, update and link pages.
+- Without a locked base, both can list bases and `capture` can create one when
+  the connected runtime exposes and permits those tools.
+
+Tools that delete pages, delete bases, restore backups or change sharing are
+never offered.
+
+## Errors
+
+Every SDK error extends `LoreboError`:
+
+| Error               | Raised when                                                    |
+| ------------------- | -------------------------------------------------------------- |
+| `LockedBaseError`   | The model tried to use a base other than the locked one.       |
+| `LoreboToolError`   | Lorebo rejected a call or returned an unexpected response.     |
+| `RunLimitError`     | The skill did not finish within the step limit of 24.          |
+| `SkillPackageError` | A Lorebo skill could not be downloaded or failed verification. |
+
+Python imports them from `lorebo_sdk.errors`, TypeScript from `lorebo-sdk/errors`.
+Errors from the model provider are passed through unchanged.
+
+## Lorebo skills
+
+Each SDK release is pinned to one version of the official `lorebo-capture`
+and `lorebo-explore` skills. They are downloaded from `downloads.lorebo.com`
+on first use, checked against a SHA-256 digest built into the SDK and kept in
+memory for the life of the client.
+
+## Development
+
+```bash
+uv sync
+uv run mypy
+uv run ruff check .
+uv run pytest
+```
+
+```bash
+cd typescript
+npm ci
+npm run check
+npm run build
+npm pack --dry-run
+```
+
+Package publication is described in
+[Releasing](https://github.com/lexrag/lorebo-sdk/blob/main/docs/releasing.md).
+
+## License
+
+[MIT](https://github.com/lexrag/lorebo-sdk/blob/main/LICENSE)

lorebo_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,74 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "lorebo-sdk"
+version = "0.1.0"
+description = "Save and retrieve Lorebo knowledge from your application with any LLM"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "LexRAG" }]
+requires-python = ">=3.12"
+keywords = ["lorebo", "knowledge-base", "mcp", "llm", "agents", "pydantic-ai"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Framework :: AsyncIO",
+    "Framework :: Pydantic",
+    "Typing :: Typed",
+]
+dependencies = [
+    "fastmcp-slim[client]>=4.1",
+    "httpx>=0.28",
+    "pydantic>=2.11",
+    "pydantic-ai-slim[mcp]>=2.59",
+]
+
+[project.optional-dependencies]
+openai = ["pydantic-ai-slim[openai]>=2.59"]
+anthropic = ["pydantic-ai-slim[anthropic]>=2.59"]
+google = ["pydantic-ai-slim[google]>=2.59"]
+groq = ["pydantic-ai-slim[groq]>=2.59"]
+mistral = ["pydantic-ai-slim[mistral]>=2.59"]
+bedrock = ["pydantic-ai-slim[bedrock]>=2.59"]
+
+[project.urls]
+Homepage = "https://github.com/lexrag/lorebo-sdk"
+Documentation = "https://github.com/lexrag/lorebo-sdk#quick-start"
+Repository = "https://github.com/lexrag/lorebo-sdk"
+Issues = "https://github.com/lexrag/lorebo-sdk/issues"
+
+[dependency-groups]
+dev = [
+    "fastmcp-slim[server]>=4.1",
+    "mypy>=1.17",
+    "pytest>=8.4",
+    "pytest-asyncio>=1.0",
+    "ruff>=0.12",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/lorebo_sdk"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/lorebo_sdk", "tests", "README.md", "LICENSE"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+
+[tool.mypy]
+strict = true
+files = ["src", "tests"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py312"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B"]