mplang-nightly 0.1.dev268__py3-none-any.whl → 0.1.dev270__py3-none-any.whl

mplang/v1/kernels/context.py

@@ -1,369 +0,0 @@
-# Copyright 2025 Ant Group Co., Ltd.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#   http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-from __future__ import annotations
-
-from collections.abc import Mapping
-from typing import Any
-
-from mplang.v1.core.dtypes import UINT8, DType
-from mplang.v1.core.pfunc import PFunction
-from mplang.v1.core.table import PandasTableLike, TableLike, TableType
-from mplang.v1.core.tensor import TensorLike, TensorType
-from mplang.v1.kernels import base
-from mplang.v1.kernels.base import KernelContext, get_kernel_spec, kernel_exists
-
-# Default bindings
-# Import kernel implementation modules explicitly so their @kernel_def entries
-# register at import time. Keep imports grouped; alias with leading underscore
-# to silence unused variable warnings without F401 pragmas.
-_IMPL_IMPORTED = False
-
-
-def _ensure_impl_imported() -> None:
-    global _IMPL_IMPORTED
-    if _IMPL_IMPORTED:
-        return
-    from mplang.v1.kernels import basic as _impl_basic  # noqa: F401
-    from mplang.v1.kernels import crypto as _impl_crypto  # noqa: F401
-    from mplang.v1.kernels import fhe as _impl_fhe  # noqa: F401
-    from mplang.v1.kernels import mock_tee as _impl_tee  # noqa: F401
-    from mplang.v1.kernels import phe as _impl_phe  # noqa: F401
-    from mplang.v1.kernels import spu as _impl_spu  # noqa: F401
-    from mplang.v1.kernels import sql_duckdb as _impl_sql_duckdb  # noqa: F401
-    from mplang.v1.kernels import stablehlo as _impl_stablehlo  # noqa: F401
-
-    _IMPL_IMPORTED = True
-
-
-# imports consolidated above
-
-_DEFAULT_BINDINGS: dict[str, str] = {
-    # basic
-    "basic.identity": "basic.identity",
-    "basic.read": "basic.read",
-    "basic.write": "basic.write",
-    "basic.constant": "basic.constant",
-    "basic.rank": "basic.rank",
-    "basic.prand": "basic.prand",
-    "basic.table_to_tensor": "basic.table_to_tensor",
-    "basic.tensor_to_table": "basic.tensor_to_table",
-    "basic.debug_print": "basic.debug_print",
-    "basic.pack": "basic.pack",
-    "basic.unpack": "basic.unpack",
-    # crypto
-    "crypto.keygen": "crypto.keygen",
-    "crypto.enc": "crypto.enc",
-    "crypto.dec": "crypto.dec",
-    "crypto.kem_keygen": "crypto.kem_keygen",
-    "crypto.kem_derive": "crypto.kem_derive",
-    "crypto.hkdf": "crypto.hkdf",
-    # phe
-    "phe.keygen": "phe.keygen",
-    "phe.encrypt": "phe.encrypt",
-    "phe.mul": "phe.mul",
-    "phe.add": "phe.add",
-    "phe.decrypt": "phe.decrypt",
-    "phe.dot": "phe.dot",
-    "phe.gather": "phe.gather",
-    "phe.scatter": "phe.scatter",
-    "phe.concat": "phe.concat",
-    "phe.reshape": "phe.reshape",
-    "phe.transpose": "phe.transpose",
-    # fhe
-    "fhe.keygen": "fhe.keygen",
-    "fhe.encrypt": "fhe.encrypt",
-    "fhe.decrypt": "fhe.decrypt",
-    "fhe.add": "fhe.add",
-    "fhe.mul": "fhe.mul",
-    "fhe.dot": "fhe.dot",
-    "fhe.polyval": "fhe.polyval",
-    "fhe.sub": "fhe.sub",
-    "fhe.negate": "fhe.negate",
-    "fhe.square": "fhe.square",
-    # spu
-    "spu.seed_env": "spu.seed_env",
-    "spu.makeshares": "spu.makeshares",
-    "spu.reconstruct": "spu.reconstruct",
-    "spu.run_pphlo": "spu.run_pphlo",
-    # stablehlo
-    "mlir.stablehlo": "mlir.stablehlo",
-    # sql
-    # generic SQL op; backend-specific kernel id for duckdb
-    "sql.run": "duckdb.run_sql",
-    # tee
-    # "tee.quote_gen": "mock_tee.quote_gen",
-    # "tee.attest": "mock_tee.attest",
-}
-
-
-# --- RuntimeContext ---
-
-
-class RuntimeContext:
-    """Per-runtime execution context with isolated op->kernel bindings.
-
-    This object owns ONLY static dispatch metadata ("op bindings") and mutable
-    per-rank kernel side state/cache/stats. It does NOT store per-evaluation
-    variable bindings (those are provided to the evaluator at evaluation time).
-
-    Parameters
-    ----------
-    rank : int
-        Local rank of this participant.
-    world_size : int
-        Total number of participants.
-    initial_bindings : Mapping[str, str] | None, optional
-        Optional partial overrides applied on top of the default binding table
-        during construction (override semantics, not replace). These map
-        op_type -> kernel_id and form a *template* for dispatch. After
-        initialization, all (re)binding must go through ``bind_op`` /
-        ``rebind_op`` on this context (scoped to THIS runtime only).
-    state : dict, optional
-        Mutable per-runtime key/value storage for kernels. Flat key space;
-        callers SHOULD use dotted prefixes (e.g. "stablehlo.compile_cache").
-        Kernels own their *state* (functional correctness data, caches,
-        handles, compiled objects, RNGs, etc.). Runtime does not interpret
-        structure—values may themselves be dicts if a kernel wants its own
-        pocket. Created empty when omitted.
-    stats : dict, optional
-        Mutable statistics/telemetry owned by the runtime (usage counters,
-        timings, profiling aids). Kernels may increment counters but should
-        avoid storing functional state here. A default "op_calls" mapping is
-        ensured. Created empty when omitted.
-    """
-
-    __slots__ = ("_ibindings", "rank", "state", "stats", "world_size")
-
-    def __init__(
-        self,
-        rank: int,
-        world_size: int,
-        initial_bindings: Mapping[str, str] | None = None,
-        *,
-        state: dict[str, Any] | None = None,
-        stats: dict[str, Any] | None = None,
-    ) -> None:
-        _ensure_impl_imported()
-        self.rank = rank
-        self.world_size = world_size
-        # Merge defaults with user overrides (override semantics)
-        self._ibindings: dict[str, str] = {
-            **_DEFAULT_BINDINGS,
-            **(initial_bindings or {}),
-        }
-        self.state = state if state is not None else {}
-        self.stats = stats if stats is not None else {}
-        self.stats.setdefault("op_calls", {})
-
-    def run_kernel(self, pfunc: PFunction, arg_list: list[Any]) -> list[Any]:
-        fn_type = pfunc.fn_type
-        kid = self._ibindings.get(fn_type)
-        if kid is None:
-            raise NotImplementedError(f"no backend kernel registered for op {fn_type}")
-        spec = get_kernel_spec(kid)
-        fn = spec.fn  # kernel implementation
-        if len(arg_list) != len(pfunc.ins_info):
-            raise ValueError(
-                f"kernel {fn_type} arg count mismatch: got {len(arg_list)}, expect {len(pfunc.ins_info)}"
-            )
-        for idx, (ins_spec, val) in enumerate(
-            zip(pfunc.ins_info, arg_list, strict=True)
-        ):
-            if isinstance(ins_spec, TableType):
-                _validate_table_arg(fn_type, idx, ins_spec, val)
-                continue
-            if isinstance(ins_spec, TensorType):
-                _validate_tensor_arg(fn_type, idx, ins_spec, val)
-                continue
-
-        # install kernel context
-        kctx = KernelContext(rank=self.rank, world_size=self.world_size, runtime=self)
-        token = base._CTX_VAR.set(kctx)
-        try:
-            raw = fn(pfunc, *arg_list)
-        finally:
-            base._CTX_VAR.reset(token)
-
-        try:
-            op_calls = self.stats.setdefault("op_calls", {})
-            op_calls[fn_type] = op_calls.get(fn_type, 0) + 1
-        except Exception:  # pragma: no cover - never raise due to stats
-            pass
-        expected = len(pfunc.outs_info)
-        if expected == 0:
-            if raw in (None, (), []):
-                return []
-            raise ValueError(
-                f"kernel {fn_type} should return no values; got {type(raw).__name__}"
-            )
-        if expected == 1:
-            if isinstance(raw, (tuple, list)):
-                if len(raw) != 1:
-                    raise ValueError(
-                        f"kernel {fn_type} produced {len(raw)} outputs, expected 1"
-                    )
-                return [raw[0]]
-            return [raw]
-        if not isinstance(raw, (tuple, list)):
-            raise TypeError(
-                f"kernel {fn_type} must return sequence (len={expected}), got {type(raw).__name__}"
-            )
-        if len(raw) != expected:
-            raise ValueError(
-                f"kernel {fn_type} produced {len(raw)} outputs, expected {expected}"
-            )
-        return list(raw)
-
-    def reset(self) -> None:
-        self.state.clear()
-
-    # ---- runtime state API (flat key space) ----
-    # Keys are treated atomically; convention encourages dotted prefixes
-    # (e.g. 'stablehlo.compile_cache.hash', 'crypto.rng'). Implementation
-    # does NOT parse or create hierarchical dicts—any grouping is purely
-    # by string prefix. Values themselves MAY be dicts if callers want a
-    # manual pocket. This keeps semantics simple and predictable.
-
-    def ensure_state(self, key: str, factory: type | Any = dict) -> Any:
-        """Return value for key; if absent create via factory and store.
-
-        Key is not parsed; dotted forms are allowed but treated as a single
-        map key. Use consistent prefixes for grouping (e.g. 'spu.config').
-        """
-        if not key:
-            raise ValueError("empty state key")
-        val = self.state.get(key)
-        if val is None:
-            val = factory()
-            self.state[key] = val
-        return val
-
-    def get_state(self, key: str, default: Any | None = None) -> Any:
-        if not key:
-            raise ValueError("empty state key")
-        return self.state.get(key, default)
-
-    def set_state(self, key: str, value: Any) -> None:
-        if not key:
-            raise ValueError("empty state key")
-        self.state[key] = value
-
-    def del_state(self, key: str) -> None:
-        if not key:
-            raise ValueError("empty state key")
-        self.state.pop(key, None)
-
-    def list_state(self, prefix: str = "") -> dict[str, Any]:
-        """Return mapping of key -> value; optional prefix filter.
-
-        Prefix match is string-based; if prefix is non-empty include keys
-        where key == prefix or key starts with prefix + '.'.
-        """
-        if not prefix:
-            return dict(self.state)
-        pref = prefix if prefix.endswith(".") else prefix + "."
-        out: dict[str, Any] = {}
-        for k, v in self.state.items():
-            if k == prefix or k.startswith(pref):
-                out[k] = v
-        return out
-
-    # ---- explicit (re)binding API ----
-    def bind_op(self, op_type: str, kernel_id: str, *, force: bool = False) -> None:
-        """Bind an operation to a kernel for THIS context only.
-
-        force=False (default) keeps existing binding (no silent override).
-        """
-        if not kernel_exists(kernel_id):
-            raise KeyError(f"kernel_id {kernel_id} not registered")
-        if not force and op_type in self._ibindings:
-            return
-        self._ibindings[op_type] = kernel_id
-
-    def rebind_op(self, op_type: str, kernel_id: str) -> None:
-        """Force rebind an operation to a different kernel (shorthand)."""
-        self.bind_op(op_type, kernel_id, force=True)
-
-    # Introspection helpers
-    def list_bound_ops(self) -> list[str]:  # pragma: no cover - convenience
-        return sorted(self._ibindings.keys())
-
-    def get_binding(self, op_type: str) -> str | None:  # pragma: no cover
-        return self._ibindings.get(op_type)
-
-    def __repr__(self) -> str:  # pragma: no cover - debug aid
-        return (
-            f"RuntimeContext(rank={self.rank}, world_size={self.world_size}, "
-            f"bound_ops={len(self._ibindings)})"
-        )
-
-
-def _validate_table_arg(
-    fn_type: str, arg_index: int, spec: TableType, value: Any
-) -> None:
-    if not isinstance(value, TableLike):
-        raise TypeError(
-            f"kernel {fn_type} input[{arg_index}] expects TableLike, got {type(value).__name__}"
-        )
-    columns = (
-        value.columns if isinstance(value, PandasTableLike) else value.column_names
-    )
-    if len(columns) != len(spec.columns):
-        raise ValueError(
-            f"kernel {fn_type} input[{arg_index}] column count mismatch: got {len(columns)}, expected {len(spec.columns)}"
-        )
-
-
-def _validate_tensor_arg(
-    fn_type: str, arg_index: int, spec: TensorType, value: Any
-) -> None:
-    # Backend-only handle sentinel (e.g., PHE keys) bypasses all structural checks
-    if tuple(spec.shape) == (-1, 0) and spec.dtype == UINT8:
-        return
-
-    if isinstance(value, (int, float, bool, complex)):
-        val_shape: tuple[Any, ...] = ()
-        duck_dtype: Any = type(value)
-    else:
-        if not isinstance(value, TensorLike):
-            raise TypeError(
-                f"kernel {fn_type} input[{arg_index}] expects TensorLike, got {type(value).__name__}"
-            )
-        val_shape = getattr(value, "shape", ())
-        duck_dtype = getattr(value, "dtype", None)
-
-    if len(spec.shape) != len(val_shape):
-        raise ValueError(
-            f"kernel {fn_type} input[{arg_index}] rank mismatch: got {val_shape}, expected {spec.shape}"
-        )
-
-    for dim_idx, (spec_dim, val_dim) in enumerate(
-        zip(spec.shape, val_shape, strict=True)
-    ):
-        if spec_dim >= 0 and spec_dim != val_dim:
-            raise ValueError(
-                f"kernel {fn_type} input[{arg_index}] shape mismatch at dim {dim_idx}: got {val_dim}, expected {spec_dim}"
-            )
-
-    try:
-        val_dtype = DType.from_any(duck_dtype)
-    except (ValueError, TypeError):  # pragma: no cover
-        raise TypeError(
-            f"kernel {fn_type} input[{arg_index}] has unsupported dtype object {duck_dtype!r}"
-        ) from None
-    if val_dtype != spec.dtype:
-        raise ValueError(
-            f"kernel {fn_type} input[{arg_index}] dtype mismatch: got {val_dtype}, expected {spec.dtype}"
-        )

mplang/v1/kernels/crypto.py

@@ -1,122 +0,0 @@
-# Copyright 2025 Ant Group Co., Ltd.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#   http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-from __future__ import annotations
-
-import os
-
-import numpy as np
-
-from mplang.v1.core import PFunction
-from mplang.v1.kernels.base import cur_kctx, kernel_def
-from mplang.v1.kernels.value import TensorValue
-from mplang.v1.utils.crypto import blake2b
-
-__all__: list[str] = []  # No public exports currently
-
-
-def _get_rng() -> np.random.Generator:
-    """Get (and lazily create) per-rank RNG for crypto kernels.
-
-    Runtime state is untyped, so we narrow the type explicitly for mypy.
-    """
-    kctx = cur_kctx()
-    rt = kctx.runtime
-    rng_obj = rt.get_state("crypto.rng")
-    if rng_obj is None:
-        seed = int(os.environ.get("MPLANG_CRYPTO_SEED", "0")) + kctx.rank * 7919
-        rng_obj = np.random.default_rng(seed)
-        rt.set_state("crypto.rng", rng_obj)
-    assert isinstance(rng_obj, np.random.Generator)  # narrow
-    return rng_obj
-
-
-def _keystream(key: bytes, nonce: bytes, length: int) -> bytes:
-    # WARNING (INSECURE): hash-based keystream (key||nonce||counter)
-    out = bytearray()
-    while len(out) < length:
-        chunk = blake2b(key + nonce)
-        out.extend(chunk)
-    return bytes(out[:length])
-
-
-@kernel_def("crypto.keygen")
-def _crypto_keygen(pfunc: PFunction) -> TensorValue:
-    length = int(pfunc.attrs.get("length", 32))
-    rng = _get_rng()
-    key = rng.integers(0, 256, size=(length,), dtype=np.uint8)
-    return TensorValue(key)
-
-
-@kernel_def("crypto.enc")
-def _crypto_encrypt(
-    pfunc: PFunction, pt_bytes: TensorValue, key: TensorValue
-) -> TensorValue:
-    pt_bytes_np = pt_bytes.to_numpy().astype(np.uint8, copy=False)
-    key_np = key.to_numpy().astype(np.uint8, copy=False)
-    rng = _get_rng()
-    nonce = rng.integers(0, 256, size=(16,), dtype=np.uint8)
-    stream = np.frombuffer(
-        _keystream(key_np.tobytes(), nonce.tobytes(), pt_bytes_np.size), dtype=np.uint8
-    )
-    ct = (pt_bytes_np ^ stream).astype(np.uint8)
-    out = np.concatenate([nonce, ct]).astype(np.uint8)
-    return TensorValue(out)
-
-
-@kernel_def("crypto.dec")
-def _crypto_decrypt(
-    pfunc: PFunction, ct_with_nonce: TensorValue, key: TensorValue
-) -> TensorValue:
-    ct_np = ct_with_nonce.to_numpy().astype(np.uint8, copy=False)
-    key_np = key.to_numpy().astype(np.uint8, copy=False)
-    nonce = ct_np[:16]
-    ct = ct_np[16:]
-    stream = np.frombuffer(
-        _keystream(key_np.tobytes(), nonce.tobytes(), len(ct)), dtype=np.uint8
-    )
-    pt_bytes = (ct ^ stream).astype(np.uint8)
-    return TensorValue(pt_bytes)
-
-
-@kernel_def("crypto.kem_keygen")
-def _crypto_kem_keygen(pfunc: PFunction) -> tuple[TensorValue, TensorValue]:
-    rng = _get_rng()
-    sk = rng.integers(0, 256, size=(32,), dtype=np.uint8)
-    pk_bytes = blake2b(sk.tobytes())[:32]
-    pk = np.frombuffer(pk_bytes, dtype=np.uint8)
-    return (TensorValue(sk), TensorValue(pk))
-
-
-@kernel_def("crypto.kem_derive")
-def _crypto_kem_derive(
-    pfunc: PFunction, sk: TensorValue, peer_pk: TensorValue
-) -> TensorValue:
-    sk_np = sk.to_numpy().astype(np.uint8, copy=False)
-    peer_pk_np = peer_pk.to_numpy().astype(np.uint8, copy=False)
-
-    self_pk_bytes = blake2b(sk_np.tobytes())[:32]
-    self_pk_arr = np.frombuffer(self_pk_bytes, dtype=np.uint8)
-    xored = (self_pk_arr ^ peer_pk_np).astype(np.uint8)
-    secret = np.frombuffer(blake2b(xored.tobytes())[:32], dtype=np.uint8)
-    return TensorValue(secret)
-
-
-@kernel_def("crypto.hkdf")
-def _crypto_hkdf(pfunc: PFunction, secret: TensorValue) -> TensorValue:
-    secret_np = secret.to_numpy().astype(np.uint8, copy=False)
-    info_str = str(pfunc.attrs.get("info", ""))
-    info = info_str.encode("utf-8")
-    out = np.frombuffer(blake2b(secret_np.tobytes() + info)[:32], dtype=np.uint8)
-    return TensorValue(out)