Metadata-Version: 2.4
Name: aipelago-sdk
Version: 0.6.2
Summary: The SDK islands are written against: @tool, @hook and the ToolContext a handler receives.
Author-email: Jiaan Liu <jiaanliux@gmail.com>
License-Expression: Apache-2.0
License-File: LICENSE
Requires-Python: >=3.11
Requires-Dist: pydantic==2.12.0
Description-Content-Type: text/markdown

# aipelago-sdk

The author-facing API for Aipelago islands: `@tool`, `@hook`, and the `ToolContext`
the kernel injects into every handler.

The same API on every distribution of the kernel, so an island written for one
runs on all of them. A distribution's developer CLI (for Ailands, `pip install
ailands`) depends on this package, so installing the CLI brings it in.

```python
from aipelago.sdk import tool, ToolContext

@tool("weather.today")
async def today(ctx: ToolContext, args: dict) -> dict:
    return {"forecast": "sun"}
```

Installing this package needs no kernel: it exists so you can type-check and
unit-test an island on your own machine.
