kangal-plugin-sdk 1.0.2

Public runtime and manifest contract for Kangal plugins

Kangal Plugin SDK

The Kangal Plugin SDK provides the public Python runtime and signed manifest contract for custom Kangal gateway policies.

Install

python -m pip install kangal-plugin-sdk

Python 3.11 or newer is required.

Create a plugin

from typing import Any

from kangal_plugin_sdk import Plugin


class AddRequestHeader(Plugin):
    async def before_request(
        self,
        request: Any,
        headers: dict[str, str],
        tenant_id: str,
    ) -> dict[str, str]:
        return {**headers, "X-Kangal-Plugin": "active"}

The package also exposes helpers for canonical manifest hashing, protocol validation, and Ed25519 manifest signing. Start from the complete plugin SDK guide and the header policy example.

Verify a release

Every GitHub release includes a wheel, source distribution, and SHA256SUMS.txt. Each package artifact also receives a keyless Sigstore bundle that binds its digest to the GitHub Actions release identity.