kedi-decisions 0.1.0__tar.gz

kedi_decisions-0.1.0/.gitattributes

@@ -0,0 +1 @@
+*.kedi linguist-language=Python

kedi_decisions-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,68 @@
+name: Validate and Publish
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+    inputs:
+      publish:
+        description: Publish the validated workspace packages to PyPI
+        type: boolean
+        default: false
+
+permissions:
+  contents: read
+
+concurrency:
+  group: publish-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6
+      - uses: astral-sh/setup-uv@94527f2e458b27549849d47d273a16bec83a01e9 # v7
+        with:
+          version: "0.11.21"
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6
+        with:
+          python-version: "3.12"
+      - name: Install locked dependencies
+        run: uv sync --locked --group dev
+      - name: Run quality gates and build packages
+        run: make prod
+      - name: Check distribution metadata
+        run: uvx --from twine twine check dist/*
+      - name: Validate built wheels outside the workspace
+        working-directory: ${{ runner.temp }}
+        run: |
+          uv venv package-smoke --python 3.12
+          uv pip install --python package-smoke/bin/python \
+            --find-links "$GITHUB_WORKSPACE/dist" \
+            'kedi-decisions[pydantic,langchain]==0.1.0' \
+            'kedi-typesafe[all]==0.3.0' 'kedi-laya[pydantic,langchain]==0.1.0'
+          package-smoke/bin/python -c "import kedi_decisions, kedi_typesafe, kedi_laya; from kedi_typesafe import TypeSafeModel; from kedi_typesafe.integrations.langchain import TypeSafeChatModel"
+      - uses: actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f # v6
+        with:
+          name: distributions
+          path: dist/*
+          if-no-files-found: error
+
+  publish:
+    if: github.event_name == 'workflow_dispatch' && inputs.publish && github.ref == 'refs/heads/main'
+    needs: validate
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/download-artifact@37930b1c2abaa49bbe596cd826c3c89aef350131 # v7
+        with:
+          name: distributions
+          path: dist
+      - uses: astral-sh/setup-uv@94527f2e458b27549849d47d273a16bec83a01e9 # v7
+        with:
+          version: "0.11.21"
+      - name: Publish validated distributions
+        run: uv publish --check-url https://pypi.org/simple/ dist/*
+        env:
+          UV_PUBLISH_TOKEN: ${{ secrets.PYPI_API_TOKEN }}

kedi_decisions-0.1.0/.gitignore

@@ -0,0 +1,218 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#   Usually these files are written by a python script from a template
+#   before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+# Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+# uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+# poetry.lock
+# poetry.toml
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
+#   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
+# pdm.lock
+# pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
+# pixi.lock
+#   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
+#   in the .venv directory. It is recommended not to include this directory in version control.
+.pixi
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# Redis
+*.rdb
+*.aof
+*.pid
+
+# RabbitMQ
+mnesia/
+rabbitmq/
+rabbitmq-data/
+
+# ActiveMQ
+activemq-data/
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#   JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#   be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#   and can be added to the global gitignore or merged into this file.  For a more nuclear
+#   option (not recommended) you can uncomment the following to ignore the entire idea folder.
+# .idea/
+
+# Abstra
+#   Abstra is an AI-powered process automation framework.
+#   Ignore directories containing user credentials, local state, and settings.
+#   Learn more at https://abstra.io/docs
+.abstra/
+
+# Visual Studio Code
+#   Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore
+#   that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#   and can be added to the global gitignore or merged into this file. However, if you prefer,
+#   you could uncomment the following to ignore the entire vscode folder
+# .vscode/
+# Temporary file for partial code execution
+tempCodeRunnerFile.py
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/
+
+# Streamlit
+.streamlit/secrets.toml

kedi_decisions-0.1.0/.python-version

@@ -0,0 +1 @@
+3.12

kedi_decisions-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kedi Programming Language
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

kedi_decisions-0.1.0/Makefile

@@ -0,0 +1,32 @@
+UV ?= uv
+
+.PHONY: format format-check lint ty basedpyright check tests coverage build prod
+
+format:
+	$(UV) run --group dev ruff check --fix .
+	$(UV) run --group dev ruff format .
+
+format-check:
+	$(UV) run --group dev ruff format --check .
+
+lint:
+	$(UV) run --group dev ruff check .
+
+ty:
+	$(UV) run --group dev ty check src packages/kedi-typesafe/src packages/kedi-laya/src
+
+basedpyright:
+	$(UV) run --group dev basedpyright
+
+check: lint format-check ty basedpyright
+
+tests:
+	$(UV) run --group dev pytest -m "not live"
+
+coverage:
+	$(UV) run --group dev pytest -m "not live" --cov --cov-branch
+
+build:
+	$(UV) build --all-packages
+
+prod: check coverage build

kedi_decisions-0.1.0/PKG-INFO

@@ -0,0 +1,85 @@
+Metadata-Version: 2.5
+Name: kedi-decisions
+Version: 0.1.0
+Summary: Typed decision contracts and model integrations
+Project-URL: Repository, https://github.com/kedi-lang/kedi-decisions
+Project-URL: Issues, https://github.com/kedi-lang/kedi-decisions/issues
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: jsonschema<5,>=4.26
+Requires-Dist: pydantic<3,>=2.12
+Provides-Extra: langchain
+Requires-Dist: langchain==1.4.3; extra == 'langchain'
+Provides-Extra: laya
+Requires-Dist: kedi-laya[pydantic,torch]==0.1.0; extra == 'laya'
+Provides-Extra: laya-mlx
+Requires-Dist: kedi-laya[mlx,pydantic]==0.1.0; extra == 'laya-mlx'
+Provides-Extra: pydantic
+Requires-Dist: pydantic-ai-slim==2.54.0; extra == 'pydantic'
+Provides-Extra: typesafe
+Requires-Dist: kedi-typesafe==0.3.0; extra == 'typesafe'
+Description-Content-Type: text/markdown
+
+# Kedi Decisions
+
+Provider-neutral typed decisions, with independent Jev and Laya integrations.
+
+The root `kedi-decisions` package contains schema planning, criteria, validation,
+decision evidence and optional framework bridges. It imports neither TypeSafe
+SDK nor MLX/PyTorch. Provider packages live in `packages/` and can be installed
+independently. Kedi itself is not required to use them.
+
+| Install | Includes |
+| --- | --- |
+| `kedi-decisions` | Shared contracts and validation only |
+| `kedi-decisions[typesafe]` | Jev and its native Pydantic AI integration |
+| `kedi-decisions[laya]` | Laya, upstream PyTorch runtime, Pydantic AI |
+| `kedi-decisions[laya-mlx]` | Laya, Apple Silicon MLX runtime, Pydantic AI |
+| `kedi-decisions[langchain]` | Optional shared LangChain integration |
+
+Jev's LangChain transport is installed with `kedi-typesafe[langchain]`.
+The shared `langchain` extra alone does not install provider-specific SDKs.
+
+These package versions are not yet published to PyPI. Clone the monorepo to
+work from source:
+
+```sh
+git clone https://github.com/kedi-lang/kedi-decisions.git
+cd kedi-decisions
+uv sync --locked --group dev
+```
+
+Add `--extra laya-mlx` or `--extra laya` only on a host where that runtime is
+needed. Installation does not download model weights.
+
+## Layout
+
+- `src/kedi_decisions/`: shared contract, schema, evidence and integrations.
+- `packages/kedi-typesafe/`: TypeSafe SDK conversion and Jev transport.
+- `packages/kedi-laya/`: local inference, MLX/Torch loading and model wrappers.
+- `tests/`: package isolation and cross-provider contracts.
+
+Kedi programs import the shared criteria with `> import: decisions`; Python
+callers embedded in Kedi use `kedi.decisions`. These replace the former
+provider-specific Kedi type-import modules. Neither surface selects a model,
+loads weights, or imports a provider SDK. Standalone Python callers can import
+directly from `kedi_decisions`. Provider packages retain their public API.
+
+## Compatibility
+
+`kedi_typesafe` retains its public exports, evaluator/client ownership rules,
+strict default boolean threshold of 0.85, SDK-native question plans and metadata
+envelope. Criteria are aliases of the shared objects, not duplicate classes.
+Existing serialized `x-typesafe` schema annotations and route identifiers are
+retained for compatibility; they do not imply a dependency on the TypeSafe SDK.
+
+Jev and Laya can return similar decision shapes without having interchangeable
+confidence calibration. A finite-choice interface is not free-form extraction.
+Unsupported schema types fail before model invocation.
+
+## Checks
+
+`make check`, `make tests` and `make build` validate the workspace. Live validation
+programs reside with their provider packages and are excluded from normal CI.
+`make coverage` enforces a 98% combined line/branch coverage floor.

kedi_decisions-0.1.0/README.md

@@ -0,0 +1,62 @@
+# Kedi Decisions
+
+Provider-neutral typed decisions, with independent Jev and Laya integrations.
+
+The root `kedi-decisions` package contains schema planning, criteria, validation,
+decision evidence and optional framework bridges. It imports neither TypeSafe
+SDK nor MLX/PyTorch. Provider packages live in `packages/` and can be installed
+independently. Kedi itself is not required to use them.
+
+| Install | Includes |
+| --- | --- |
+| `kedi-decisions` | Shared contracts and validation only |
+| `kedi-decisions[typesafe]` | Jev and its native Pydantic AI integration |
+| `kedi-decisions[laya]` | Laya, upstream PyTorch runtime, Pydantic AI |
+| `kedi-decisions[laya-mlx]` | Laya, Apple Silicon MLX runtime, Pydantic AI |
+| `kedi-decisions[langchain]` | Optional shared LangChain integration |
+
+Jev's LangChain transport is installed with `kedi-typesafe[langchain]`.
+The shared `langchain` extra alone does not install provider-specific SDKs.
+
+These package versions are not yet published to PyPI. Clone the monorepo to
+work from source:
+
+```sh
+git clone https://github.com/kedi-lang/kedi-decisions.git
+cd kedi-decisions
+uv sync --locked --group dev
+```
+
+Add `--extra laya-mlx` or `--extra laya` only on a host where that runtime is
+needed. Installation does not download model weights.
+
+## Layout
+
+- `src/kedi_decisions/`: shared contract, schema, evidence and integrations.
+- `packages/kedi-typesafe/`: TypeSafe SDK conversion and Jev transport.
+- `packages/kedi-laya/`: local inference, MLX/Torch loading and model wrappers.
+- `tests/`: package isolation and cross-provider contracts.
+
+Kedi programs import the shared criteria with `> import: decisions`; Python
+callers embedded in Kedi use `kedi.decisions`. These replace the former
+provider-specific Kedi type-import modules. Neither surface selects a model,
+loads weights, or imports a provider SDK. Standalone Python callers can import
+directly from `kedi_decisions`. Provider packages retain their public API.
+
+## Compatibility
+
+`kedi_typesafe` retains its public exports, evaluator/client ownership rules,
+strict default boolean threshold of 0.85, SDK-native question plans and metadata
+envelope. Criteria are aliases of the shared objects, not duplicate classes.
+Existing serialized `x-typesafe` schema annotations and route identifiers are
+retained for compatibility; they do not imply a dependency on the TypeSafe SDK.
+
+Jev and Laya can return similar decision shapes without having interchangeable
+confidence calibration. A finite-choice interface is not free-form extraction.
+Unsupported schema types fail before model invocation.
+
+## Checks
+
+`make check`, `make tests` and `make build` validate the workspace. Live validation
+programs reside with their provider packages and are excluded from normal CI.
+`make coverage` enforces a 98% combined line/branch coverage floor.

kedi_decisions-0.1.0/docs/LAYA.md

@@ -0,0 +1,126 @@
+# Local Laya decisions
+
+The optional `LayaClient` connects Laya-compatible `predict(state, questions)`
+models to the same validated schema projection as Jev. It does not generate
+prose, call a hosted service, or require `TYPESAFE_API_KEY`.
+
+These packages are currently in the monorepo source checkout, not yet published.
+From this repository run `uv sync --extra laya-mlx --extra langchain` on Apple
+Silicon with Python 3.11+. Use `--extra laya` for the upstream PyTorch runtime.
+Neither backend is a base dependency. Laya does not import the TypeSafe SDK.
+
+## Python
+
+```python
+from typing import Literal
+from pydantic import BaseModel
+from pydantic_ai import Agent
+from kedi_laya import LayaClient
+
+class Route(BaseModel):
+    team: Literal["billing", "technical"]
+
+with LayaClient("aac6fef/laya-multilingual-mlx") as client:
+    agent = Agent(client.as_pydantic_model(), output_type=Route)
+    result = agent.run_sync("Please refund my duplicate charge.")
+    print(result.output.team)
+```
+
+Use `client.as_langchain_model().with_structured_output(Route)` for LangChain.
+Use `client.as_evaluator().evaluate_sync(state=..., schema=Route.model_json_schema())`
+for a direct decision API; its result contains `values`, `metadata`, model name,
+and reported token usage. An asynchronous `evaluate` method is also available.
+
+The [complete example](../packages/kedi-laya/examples/local_laya.py) also captures a raw probability.
+`ChoiceCriteria`, `Rubric`, `BooleanCriteria`, `Probability`, nested supported
+models, and strict boolean thresholds share the existing schema implementation.
+The default bool rule remains `probability > 0.85`, independently of an
+application's choice-acceptance policy. Free-form strings remain unsupported.
+
+## Other checkpoints and predictors
+
+```python
+client = LayaClient(
+    "organization/checkpoint",
+    backend="torch",
+    load_options={"device": "cpu"},
+)
+
+# Supply an already-loaded Laya-compatible model instead of a loader.
+client = LayaClient("my-checkpoint", backend="mlx", predictor=my_agent)
+```
+
+`backend` accepts `auto` (default), `mlx`, or `torch`. Auto selects installed MLX
+on Apple Silicon, otherwise PyTorch. The checkpoint may be a Hub ID or a
+local directory. `load_options` is forwarded unchanged to that backend's `load`;
+only pass options supported by that runtime (MLX supports `revision`, for example).
+No backend or hosted fallback is selected silently. Caller-supplied predictors
+must implement Laya's result contract, including question types and probabilities.
+Injection does not make unrelated models Laya-compatible.
+
+The client loads weights lazily once and serializes predictions on that client.
+Async calls move inference off the event loop. Cancelling the waiter does not
+cancel an executing native kernel; subsequent predictions wait for it to finish.
+Reuse a client/model for a session instead of constructing it per decision.
+`close()` waits for active inference and drops the client's model reference.
+It never calls `close` on a caller-owned predictor. Closing an evaluator does
+not close the borrowed client: the client owner controls its lifetime.
+
+## Context and evidence
+
+- The built-in MLX loader checks the actual tokenizer, question/option budget,
+  and checkpoint context window before prediction. It rejects silent truncation.
+  Many Laya checkpoints have a 512-token window, including question/options.
+- Injected predictors and upstream PyTorch loaders retain their own context
+  handling. The MLX preflight is not a universal guarantee for those runtimes.
+- Laya emits four-decimal probabilities. The evaluator accepts only the
+  corresponding rounding error in their sum; raw probabilities are not rescaled.
+  Invalid labels, missing answers, out-of-range values, and large sum errors fail.
+- Choice/score confidence is supplied by Laya, not fabricated from its winner.
+  Laya's entropy-based confidence is not calibrated to Jev's confidence. A shared
+  numeric cutoff does not demonstrate equal reliability between providers.
+- Laya's extra action head is not an approval decision and never authorizes tools.
+- Metadata keeps `provider: laya` and the requested checkpoint name;
+  the runtime's generic `laya-rl-agent` response label is not used as checkpoint ID.
+  Laya uses the `decisions` metadata envelope. Jev keeps its existing `typesafe`
+  envelope for compatibility; Kedi understands both.
+- There is no generated-text token stream. Reported input counts come from Laya;
+  missing usage stays unknown at the decision API, rather than being invented.
+
+## Kedi
+
+With the updated Kedi checkout and this package installed:
+
+```kedi
+> adapter: pydantic
+> model: laya/aac6fef/laya-multilingual-mlx
+> import: decisions
+
+>> The team for "Please refund my duplicate charge" is [team: Literal["billing", "technical"]].
+= <team>
+```
+
+`> adapter: langchain` uses the same surface. `laya-mlx/<checkpoint>` remains an
+explicit MLX alias. These are decision models, not general-purpose agent harnesses.
+Kedi does not attach its implicit artifact toolset to these models.
+
+`> import: decisions` exposes the same shared criteria as `from kedi.decisions import ...`.
+Laya uses `decision_threshold` (default `0.85`, strict greater-than) and
+`decision_tool_call_threshold` (default `0.6`). Jev's existing `typesafe_*`
+settings and the standalone provider package APIs are unchanged. Both providers
+use the shared Kedi criteria import instead of provider-specific type modules.
+
+Zero-argument handoffs can be selected and returned to the agent framework.
+Parameterized tools raise `ToolCallProposed` for an explicit argument-producing
+handler; the decision model never fabricates arbitrary arguments. The stream
+interface delivers an already completed decision, not generated-text deltas.
+
+The model wrappers declare `kedi_prompt_mode = "decision"`. The updated Kedi
+runtime preserves template context and typed captures, but asks for decisions
+instead of instructing the model to complete a grammatical sentence. Native
+Pydantic AI and LangChain callers still control their own prompts; this marker
+does not rewrite their input. It is not an accuracy guarantee.
+
+Sources: [Laya MLX implementation](https://github.com/mizorewww/laya-mlx),
+[multilingual checkpoint](https://huggingface.co/aac6fef/laya-multilingual-mlx),
+[upstream Laya](https://pypi.org/project/laya/).