Arkady Plugin SDK

Python SDK для разработки плагинов Arkady.

Разработка

Репозиторий использует just как командный раннер. Установить можно любым удобным пакетным менеджером или через uv:

uv tool install rust-just

Основные команды разработки:

just dev       # Синхронизировать дефолтные dev-зависимости
just fmt       # Применить автоформатирование
just lint      # Форматирование + автофиксы линта
just check     # Проверить lockfile, форматирование и линт
just test      # Запустить тесты SDK
just build     # Собрать source- и wheel-дистрибутивы
just docs      # Сгенерировать документацию по схемам

Поддержка polling-режима для LLM

SDK 0.9.0 добавляет поддержку вызова LLM через polling. Теперь модель может объявить фичу polling и реализовать методы опроса — плагины могут отправлять долгоживущие задания провайдеру и позже проверять статус через короткий цикл запрос/ответ.

Результаты polling бывают трёх состояний:

running — возвращает состояние, которым владеет плагин, для следующей проверки.
succeeded — возвращает финальный результат LLM.
failed — возвращает терминальную ошибку.

Управление версиями

SDK следует Semantic Versioning (a.b.c):

a: мажорная версия — значимые архитектурные изменения или несовместимые правки API
b: минорная версия — добавление новых фич с сохранением обратной совместимости
c: патч-версия — обратно совместимые исправления багов

Для пользователей SDK

При объявлении зависимости от этого SDK рекомендуется указывать ограничения версии так, чтобы:

разрешать патч- и минорные обновления (баг-фиксы и новые фичи)
запрещать мажорные обновления во избежание breaking changes

Пример в зависимостях вашего проекта:

arkady_plugin >= 0.8

Справочник по версиям манифеста

Для спецификации манифеста введены два поля версионирования:

meta.version — версия спецификации манифеста, для обратной совместимости. При установке старого плагина в новую версию Arkady сложно гарантировать отсутствие breaking changes, но по этому полю Arkady может их обнаружить. Если версия не поддерживается — Arkady использует только поддерживаемую часть функционала плагина.
meta.minimum_arkady_version — минимальная версия Arkady, для прямой совместимости. При установке нового плагина в старую версию Arkady многие новые фичи могут быть недоступны, но указание минимальной версии Arkady подсказывает пользователю, до какой версии нужно обновиться.

Справочник Meta.Version

Версия манифеста	Описание
0.0.2	Поскольку `ToolProviderType` теперь поддерживает `mcp`, старая реализация ломается при выборе пользователем `mcp`-инструмента в Arkady — версия поднята до 0.0.2, чтобы Arkady знал: `mcp` отключён при meta.version ниже 0.0.2.
0.0.1	Первый релиз

Справочник Meta.MinimumArkadyVersion

Минимальная версия Arkady	Версия SDK	Описание
1.2.0	0.2.0	Поддержка получения информации о приложении
1.4.0	0.0.1-beta.49	Поддержка мультимодального вывода LLM
1.4.0	0.3.1	Поддержка OAuth для плагинов
1.5.1	0.4.0	Поддержка типа параметра `dynamic-select`
1.5.1	0.4.0	Поддержка structured output для LLM
1.6.0	0.4.1	Поддержка поля `dark-icon` в манифесте
1.7.0	0.4.2	Поддержка OAuth для плагинов
1.8.1	0.4.4	Поддержка filename в MultiModalPromptMessageContent
1.9.0	0.5.0	Поддержка функционала Datasource для плагинов
1.10.0	0.6.0	Поддержка функционала Trigger для плагинов
1.11.0	0.7.0	Поддержка мультимодального Reranking / Embeddings
1.14.0	0.8.1	Чистка зависимостей и структуры проекта
1.14.2	0.9.0	Поддержка polling-вызовов LLM-плагинов

English version: README.en.md

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

arkady_plugin_sdk-0.10.4.tar.gz (321.8 kB view details)

Uploaded Aug 20, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

arkady_plugin_sdk-0.10.4-py3-none-any.whl (381.0 kB view details)

Uploaded Aug 20, 2026 Python 3

File details

Details for the file arkady_plugin_sdk-0.10.4.tar.gz.

File metadata

Download URL: arkady_plugin_sdk-0.10.4.tar.gz
Upload date: Aug 20, 2026
Size: 321.8 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for arkady_plugin_sdk-0.10.4.tar.gz
Algorithm	Hash digest
SHA256	`f280c10ae35a39594a1d500d83bf662f51b59908a5eff067d640550334b23a41`
MD5	`cca0ad5aa4328b938ed16d8aff94d8e5`
BLAKE2b-256	`6cab63b063419c08b409658c156e3e3a347f04b6cd65f18249bb8ea65ba20630`

See more details on using hashes here.

Provenance

The following attestation bundles were made for arkady_plugin_sdk-0.10.4.tar.gz:

Publisher: release.yml on reraaaaa/arkady-plugin-sdk

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: arkady_plugin_sdk-0.10.4.tar.gz
- Subject digest: f280c10ae35a39594a1d500d83bf662f51b59908a5eff067d640550334b23a41
- Sigstore transparency entry: 2536607047
- Sigstore integration time: Aug 20, 2026
Source repository:
- Permalink: reraaaaa/arkady-plugin-sdk@c3f61b779d2e2f3682fd8bd357b069e52e16b077
- Branch / Tag: refs/tags/v0.10.4
- Owner: https://github.com/reraaaaa
- Access: private
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@c3f61b779d2e2f3682fd8bd357b069e52e16b077
- Trigger Event: push

File details

Details for the file arkady_plugin_sdk-0.10.4-py3-none-any.whl.

File metadata

Download URL: arkady_plugin_sdk-0.10.4-py3-none-any.whl
Upload date: Aug 20, 2026
Size: 381.0 kB
Tags: Python 3
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for arkady_plugin_sdk-0.10.4-py3-none-any.whl
Algorithm	Hash digest
SHA256	`ffd798da66ecb708e0b52039e954651563de892415e807a6d14d65355b2bde1c`
MD5	`c4b5bbc9b5d5b8ced448cfcb6681812c`
BLAKE2b-256	`25a2232ad298457dfbd5f63a19ce11febd2dd9854151c596068c660502750490`

See more details on using hashes here.

Provenance

The following attestation bundles were made for arkady_plugin_sdk-0.10.4-py3-none-any.whl:

Publisher: release.yml on reraaaaa/arkady-plugin-sdk

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: arkady_plugin_sdk-0.10.4-py3-none-any.whl
- Subject digest: ffd798da66ecb708e0b52039e954651563de892415e807a6d14d65355b2bde1c
- Sigstore transparency entry: 2536607090
- Sigstore integration time: Aug 20, 2026
Source repository:
- Permalink: reraaaaa/arkady-plugin-sdk@c3f61b779d2e2f3682fd8bd357b069e52e16b077
- Branch / Tag: refs/tags/v0.10.4
- Owner: https://github.com/reraaaaa
- Access: private
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@c3f61b779d2e2f3682fd8bd357b069e52e16b077
- Trigger Event: push

Release history Release notifications | RSS feed

This release

0.10.4 This release

Aug 20, 2026 2 files

arkady-plugin-sdk 0.10.4

Arkady Plugin SDK

Разработка

Поддержка polling-режима для LLM

Управление версиями

Для пользователей SDK

Справочник по версиям манифеста

Справочник Meta.Version

Справочник Meta.MinimumArkadyVersion

Project links

Key dates

1 maintainer

Credits

GitHub Statistics

License expression

Requires

Tags

Download files

Source Distribution

Built Distribution

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

Release history Release notifications | RSS feed