swarmauri_cipher_suite_fips203 0.1.0.dev11__tar.gz

swarmauri_cipher_suite_fips203-0.1.0.dev11/PKG-INFO

@@ -0,0 +1,109 @@
+Metadata-Version: 2.4
+Name: swarmauri_cipher_suite_fips203
+Version: 0.1.0.dev11
+Summary: FIPS 203 ML-KEM cipher suite bindings for Swarmauri
+License-Expression: Apache-2.0
+Keywords: swarmauri,sdk,standards,cipher,suite,fips,fips203,ml-kem,crystals-kyber,post-quantum,cryptography
+Author: Jacob Stewart
+Author-email: jacob@swarmauri.com
+Requires-Python: >=3.10,<3.13
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Development Status :: 3 - Alpha
+Classifier: Topic :: Security :: Cryptography
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Dist: swarmauri_base
+Requires-Dist: swarmauri_core
+Description-Content-Type: text/markdown
+
+![Swarmauri Logo](https://github.com/swarmauri/swarmauri-sdk/blob/master/assets/swarmauri.brand.theme.svg)
+
+<p align="center">
+    <a href="https://pypi.org/project/swarmauri_cipher_suite_fips203/">
+        <img src="https://img.shields.io/pypi/dm/swarmauri_cipher_suite_fips203" alt="PyPI - Downloads"/></a>
+    <a href="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/standards/swarmauri_cipher_suite_fips203/">
+        <img alt="Hits" src="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/standards/swarmauri_cipher_suite_fips203.svg"/></a>
+    <a href="https://pypi.org/project/swarmauri_cipher_suite_fips203/">
+        <img src="https://img.shields.io/pypi/pyversions/swarmauri_cipher_suite_fips203" alt="PyPI - Python Version"/></a>
+    <a href="https://pypi.org/project/swarmauri_cipher_suite_fips203/">
+        <img src="https://img.shields.io/pypi/l/swarmauri_cipher_suite_fips203" alt="PyPI - License"/></a>
+    <a href="https://pypi.org/project/swarmauri_cipher_suite_fips203/">
+        <img src="https://img.shields.io/pypi/v/swarmauri_cipher_suite_fips203?label=swarmauri_cipher_suite_fips203&color=green" alt="PyPI - swarmauri_cipher_suite_fips203"/></a>
+</p>
+
+---
+
+# Swarmauri Cipher Suite FIPS 203
+
+Cipher suite bindings for the post-quantum ML-KEM key encapsulation mechanisms
+standardised in NIST FIPS 203.
+
+## Features
+
+- Enumerates the ML-KEM-512, ML-KEM-768, and ML-KEM-1024 parameter sets
+- Describes NIST security level metadata for downstream policy enforcement
+- Normalises wrap / unwrap requests with provider-oriented descriptors
+- Ships entry-point metadata for seamless Swarmauri component discovery
+
+## Installation
+
+### pip
+
+```bash
+pip install swarmauri_cipher_suite_fips203
+```
+
+### Poetry
+
+```bash
+poetry add swarmauri_cipher_suite_fips203
+```
+
+### uv
+
+To add the dependency to a `pyproject.toml` managed by `uv`:
+
+```bash
+uv add swarmauri_cipher_suite_fips203
+```
+
+Or install it into the active environment:
+
+```bash
+uv pip install swarmauri_cipher_suite_fips203
+```
+
+## Usage
+
+```python
+from swarmauri_cipher_suite_fips203 import Fips203CipherSuite
+
+suite = Fips203CipherSuite(name="mlkem")
+
+# Describe a ML-KEM-768 key encapsulation request
+descriptor = suite.normalize(op="wrap", alg="ML-KEM-768")
+print(descriptor["constraints"]["nistLevel"])  # -> 3
+print(descriptor["mapped"]["provider"])       # -> ml-kem:ML-KEM-768
+```
+
+The suite raises `ValueError` if a non-ML-KEM algorithm is requested, allowing
+callers to surface the policy violation immediately.
+
+## Entry Point
+
+The suite registers under the `swarmauri.cipher_suites` entry point as
+`Fips203CipherSuite`.
+
+## Want to help?
+
+If you want to contribute to swarmauri-sdk, read up on our
+[guidelines for contributing](https://github.com/swarmauri/swarmauri-sdk/blob/master/CONTRIBUTING.md)
+that will help you get started.
+

swarmauri_cipher_suite_fips203-0.1.0.dev11/README.md

@@ -0,0 +1,83 @@
+![Swarmauri Logo](https://github.com/swarmauri/swarmauri-sdk/blob/master/assets/swarmauri.brand.theme.svg)
+
+<p align="center">
+    <a href="https://pypi.org/project/swarmauri_cipher_suite_fips203/">
+        <img src="https://img.shields.io/pypi/dm/swarmauri_cipher_suite_fips203" alt="PyPI - Downloads"/></a>
+    <a href="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/standards/swarmauri_cipher_suite_fips203/">
+        <img alt="Hits" src="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/standards/swarmauri_cipher_suite_fips203.svg"/></a>
+    <a href="https://pypi.org/project/swarmauri_cipher_suite_fips203/">
+        <img src="https://img.shields.io/pypi/pyversions/swarmauri_cipher_suite_fips203" alt="PyPI - Python Version"/></a>
+    <a href="https://pypi.org/project/swarmauri_cipher_suite_fips203/">
+        <img src="https://img.shields.io/pypi/l/swarmauri_cipher_suite_fips203" alt="PyPI - License"/></a>
+    <a href="https://pypi.org/project/swarmauri_cipher_suite_fips203/">
+        <img src="https://img.shields.io/pypi/v/swarmauri_cipher_suite_fips203?label=swarmauri_cipher_suite_fips203&color=green" alt="PyPI - swarmauri_cipher_suite_fips203"/></a>
+</p>
+
+---
+
+# Swarmauri Cipher Suite FIPS 203
+
+Cipher suite bindings for the post-quantum ML-KEM key encapsulation mechanisms
+standardised in NIST FIPS 203.
+
+## Features
+
+- Enumerates the ML-KEM-512, ML-KEM-768, and ML-KEM-1024 parameter sets
+- Describes NIST security level metadata for downstream policy enforcement
+- Normalises wrap / unwrap requests with provider-oriented descriptors
+- Ships entry-point metadata for seamless Swarmauri component discovery
+
+## Installation
+
+### pip
+
+```bash
+pip install swarmauri_cipher_suite_fips203
+```
+
+### Poetry
+
+```bash
+poetry add swarmauri_cipher_suite_fips203
+```
+
+### uv
+
+To add the dependency to a `pyproject.toml` managed by `uv`:
+
+```bash
+uv add swarmauri_cipher_suite_fips203
+```
+
+Or install it into the active environment:
+
+```bash
+uv pip install swarmauri_cipher_suite_fips203
+```
+
+## Usage
+
+```python
+from swarmauri_cipher_suite_fips203 import Fips203CipherSuite
+
+suite = Fips203CipherSuite(name="mlkem")
+
+# Describe a ML-KEM-768 key encapsulation request
+descriptor = suite.normalize(op="wrap", alg="ML-KEM-768")
+print(descriptor["constraints"]["nistLevel"])  # -> 3
+print(descriptor["mapped"]["provider"])       # -> ml-kem:ML-KEM-768
+```
+
+The suite raises `ValueError` if a non-ML-KEM algorithm is requested, allowing
+callers to surface the policy violation immediately.
+
+## Entry Point
+
+The suite registers under the `swarmauri.cipher_suites` entry point as
+`Fips203CipherSuite`.
+
+## Want to help?
+
+If you want to contribute to swarmauri-sdk, read up on our
+[guidelines for contributing](https://github.com/swarmauri/swarmauri-sdk/blob/master/CONTRIBUTING.md)
+that will help you get started.

swarmauri_cipher_suite_fips203-0.1.0.dev11/pyproject.toml

@@ -0,0 +1,80 @@
+[project]
+name = "swarmauri_cipher_suite_fips203"
+version = "0.1.0.dev11"
+description = "FIPS 203 ML-KEM cipher suite bindings for Swarmauri"
+license = "Apache-2.0"
+readme = "README.md"
+requires-python = ">=3.10,<3.13"
+authors = [{ name = "Jacob Stewart", email = "jacob@swarmauri.com" }]
+classifiers = [
+    "License :: OSI Approved :: Apache Software License",
+    "Natural Language :: English",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Development Status :: 3 - Alpha",
+    "Topic :: Security :: Cryptography",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+]
+dependencies = [
+    "swarmauri_core",
+    "swarmauri_base",
+]
+keywords = [
+    "swarmauri",
+    "sdk",
+    "standards",
+    "cipher",
+    "suite",
+    "fips",
+    "fips203",
+    "ml-kem",
+    "crystals-kyber",
+    "post-quantum",
+    "cryptography",
+]
+
+[tool.uv.sources]
+swarmauri_core = { workspace = true }
+swarmauri_base = { workspace = true }
+
+[tool.pytest.ini_options]
+norecursedirs = ["combined", "scripts"]
+markers = [
+    "test: standard test",
+    "unit: Unit tests",
+    "i9n: Integration tests",
+    "r8n: Regression tests",
+    "acceptance: Acceptance tests",
+    "perf: Performance tests",
+    "example: README-backed usage examples",
+]
+timeout = 300
+log_cli = true
+log_cli_level = "INFO"
+log_cli_format = "%(asctime)s [%(levelname)s] %(message)s"
+log_cli_date_format = "%Y-%m-%d %H:%M:%S"
+asyncio_default_fixture_loop_scope = "function"
+
+[dependency-groups]
+dev = [
+    "pytest>=8.0",
+    "pytest-asyncio>=0.24.0",
+    "pytest-xdist>=3.6.1",
+    "pytest-json-report>=1.5.0",
+    "pytest-timeout>=2.3.1",
+    "pytest-benchmark>=4.0.0",
+    "flake8>=7.0",
+    "ruff>=0.9.9",
+]
+
+[build-system]
+requires = ["poetry-core>=1.0.0"]
+build-backend = "poetry.core.masonry.api"
+
+[project.entry-points.'swarmauri.cipher_suites']
+Fips203CipherSuite = "swarmauri_cipher_suite_fips203:Fips203CipherSuite"

swarmauri_cipher_suite_fips203-0.1.0.dev11/swarmauri_cipher_suite_fips203/Fips203CipherSuite.py

@@ -0,0 +1,83 @@
+from __future__ import annotations
+
+from typing import Iterable, Mapping, Optional
+
+from swarmauri_base.cipher_suites import CipherSuiteBase
+from swarmauri_base.ComponentBase import ComponentBase
+from swarmauri_core.cipher_suites import (
+    Alg,
+    CipherOp,
+    Features,
+    KeyRef,
+    NormalizedDescriptor,
+    ParamMapping,
+)
+
+_ML_KEM: tuple[Alg, ...] = ("ML-KEM-512", "ML-KEM-768", "ML-KEM-1024")
+_ML_KEM_LEVEL = {"ML-KEM-512": 1, "ML-KEM-768": 3, "ML-KEM-1024": 5}
+
+
+@ComponentBase.register_type(CipherSuiteBase, "Fips203CipherSuite")
+class Fips203CipherSuite(CipherSuiteBase):
+    """FIPS 203 compliant ML-KEM cipher suite."""
+
+    def suite_id(self) -> str:
+        return "fips-203"
+
+    def supports(self) -> Mapping[CipherOp, Iterable[Alg]]:
+        return {"wrap": _ML_KEM, "unwrap": _ML_KEM}
+
+    def default_alg(self, op: CipherOp, *, for_key: Optional[KeyRef] = None) -> Alg:
+        return "ML-KEM-768"
+
+    def policy(self) -> Mapping[str, object]:
+        return {
+            "fips": "203",
+            "nist_document": "ML-KEM",
+            "nist_security_levels": _ML_KEM_LEVEL,
+        }
+
+    def features(self) -> Features:
+        return {
+            "suite": "fips-203",
+            "version": 1,
+            "dialects": {"provider": list(_ML_KEM)},
+            "ops": {
+                "wrap": {"default": "ML-KEM-768", "allowed": list(_ML_KEM)},
+            },
+            "constraints": {"nistSecurityLevels": _ML_KEM_LEVEL},
+            "compliance": {"fips203": True, "pqc": True},
+            "notes": [
+                "Implements the CRYSTALS-Kyber based ML-KEM selections from FIPS 203.",
+            ],
+        }
+
+    def normalize(
+        self,
+        *,
+        op: CipherOp,
+        alg: Optional[Alg] = None,
+        key: Optional[KeyRef] = None,
+        params: Optional[ParamMapping] = None,
+        dialect: Optional[str] = None,
+    ) -> NormalizedDescriptor:
+        allowed = set(self.supports().get(op, ()))
+        chosen = alg or self.default_alg(op)
+        if chosen not in allowed:
+            raise ValueError(f"{chosen=} not supported for {op=}")
+
+        resolved = dict(params or {})
+        chosen_dialect = "provider" if dialect is None else dialect
+        mapped = {"provider": f"ml-kem:{chosen}"}
+
+        constraints = {"nistLevel": _ML_KEM_LEVEL[chosen], "category": "post-quantum"}
+
+        return {
+            "op": op,
+            "alg": chosen,
+            "dialect": chosen_dialect,
+            "mapped": mapped,
+            "params": resolved,
+            "constraints": constraints,
+            "policy": self.policy(),
+        }

swarmauri_cipher_suite_fips203-0.1.0.dev11/swarmauri_cipher_suite_fips203/__init__.py

@@ -0,0 +1,5 @@
+"""FIPS 203 (ML-KEM) cipher suite implementation."""
+
+from .Fips203CipherSuite import Fips203CipherSuite
+
+__all__ = ["Fips203CipherSuite"]