jsonllm-kernel 0.1.1__tar.gz

jsonllm_kernel-0.1.1/PKG-INFO

@@ -0,0 +1,117 @@
+Metadata-Version: 2.4
+Name: jsonllm-kernel
+Version: 0.1.1
+Summary: Deterministic event-sourced kernel for modular LLM automation
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: openai>=1.0.0
+Requires-Dist: pydantic>=2.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+
+# JSONLLM Kernel
+
+Deterministic event-sourced kernel for modular LLM automation.
+
+`LLM ingress -> strict events -> deterministic module policy/planner/executor -> append-only JSONL`
+
+## What this is
+
+- A kernel that enforces deterministic invariants (schema, lineage, provenance, idempotency).
+- A module system where third parties implement domain logic.
+- A self-serve workflow to scaffold and validate modules without maintainer support.
+
+## Core guarantees
+
+- LLM only emits `IntentNormalized` (`module_id=kernel.ingress`).
+- Side effects run only in deterministic workers.
+- Mandatory lineage: `IntentNormalized -> IntentAccepted/Rejected -> ActionProposed -> ActionOutcome`.
+- `ActionProposed.action_id` must be allowlisted.
+- `actor` authority and `module_id` provenance are validated.
+
+## Repository layout
+
+- `src/event_pipeline.py`: CLI orchestrator
+- `src/jsonllm_kernel/contracts.py`: event/config contracts
+- `src/jsonllm_kernel/module_api.py`: module SDK (`BaseModule`, types)
+- `src/jsonllm_kernel/module_loader.py`: `module.toml` loader/validator
+- `src/jsonllm_kernel/scaffold.py`: module scaffolding templates
+- `src/jsonllm_kernel/conformance.py`: module conformance suite
+- `src/jsonllm_kernel/project_init.py`: workspace bootstrap from packaged templates
+- `src/jsonllm_kernel/templates/`: packaged default catalog and modules
+- `modules/`: example modules
+- `catalog/`: allowlist + security configs
+
+## Install
+
+```bash
+python3 -m pip install -r requirements.txt
+export OPENAI_API_KEY="your_key"
+```
+
+Or install as package/CLI:
+
+```bash
+python3 -m pip install -e .
+jsonllm --help
+```
+
+## Start in a brand-new directory
+
+```bash
+mkdir /tmp/my-jsonllm-workspace
+jsonllm init-project /tmp/my-jsonllm-workspace
+jsonllm --workspace /tmp/my-jsonllm-workspace list-modules
+```
+
+`--workspace` (or env `JSONLLM_WORKSPACE`) controls where `catalog/`, `modules/`, and `data/` are read/written.
+
+## CLI
+
+```bash
+jsonllm --workspace /path/to/workspace list-modules
+jsonllm --workspace /path/to/workspace init-module my_domain
+jsonllm --workspace /path/to/workspace test-module --module-id my_domain
+jsonllm --workspace /path/to/workspace new-intent --request-text "..." --aggregate-id req-1
+jsonllm --workspace /path/to/workspace run-policy
+jsonllm --workspace /path/to/workspace run-planner
+jsonllm --workspace /path/to/workspace run-executor
+```
+
+Equivalent while developing in this repo:
+
+```bash
+python3 src/event_pipeline.py --workspace . list-modules
+```
+
+## Module self-serve workflow
+
+1. Scaffold module:
+
+```bash
+jsonllm --workspace /path/to/workspace init-module my_domain
+```
+
+2. Implement `policy/plan/execute` in `modules/my_domain/module.py`.
+3. Update `modules/my_domain/module.toml` (intents/actions/permissions).
+4. Ensure actions are in `catalog/allowed-actions.json`.
+5. Run conformance:
+
+```bash
+jsonllm --workspace /path/to/workspace test-module --module-id my_domain
+```
+
+6. Run end-to-end pipeline.
+
+## Compatibility and standards
+
+- Module API version is declared by `module_api_version` in `module.toml`.
+- Loader rejects incompatible module API versions.
+- See:
+  - `docs/MODULE_COMPATIBILITY.md`
+  - `docs/MODULE_COOKBOOK.md`
+
+## Example modules
+
+- `modules/core_builtin`: generic routes for search/extraction/classification.
+- `modules/math_sum`: tangible deterministic computation (`math.sum.v1`) writing outputs to `data/outputs/`.

jsonllm_kernel-0.1.1/README.md

@@ -0,0 +1,106 @@
+# JSONLLM Kernel
+
+Deterministic event-sourced kernel for modular LLM automation.
+
+`LLM ingress -> strict events -> deterministic module policy/planner/executor -> append-only JSONL`
+
+## What this is
+
+- A kernel that enforces deterministic invariants (schema, lineage, provenance, idempotency).
+- A module system where third parties implement domain logic.
+- A self-serve workflow to scaffold and validate modules without maintainer support.
+
+## Core guarantees
+
+- LLM only emits `IntentNormalized` (`module_id=kernel.ingress`).
+- Side effects run only in deterministic workers.
+- Mandatory lineage: `IntentNormalized -> IntentAccepted/Rejected -> ActionProposed -> ActionOutcome`.
+- `ActionProposed.action_id` must be allowlisted.
+- `actor` authority and `module_id` provenance are validated.
+
+## Repository layout
+
+- `src/event_pipeline.py`: CLI orchestrator
+- `src/jsonllm_kernel/contracts.py`: event/config contracts
+- `src/jsonllm_kernel/module_api.py`: module SDK (`BaseModule`, types)
+- `src/jsonllm_kernel/module_loader.py`: `module.toml` loader/validator
+- `src/jsonllm_kernel/scaffold.py`: module scaffolding templates
+- `src/jsonllm_kernel/conformance.py`: module conformance suite
+- `src/jsonllm_kernel/project_init.py`: workspace bootstrap from packaged templates
+- `src/jsonllm_kernel/templates/`: packaged default catalog and modules
+- `modules/`: example modules
+- `catalog/`: allowlist + security configs
+
+## Install
+
+```bash
+python3 -m pip install -r requirements.txt
+export OPENAI_API_KEY="your_key"
+```
+
+Or install as package/CLI:
+
+```bash
+python3 -m pip install -e .
+jsonllm --help
+```
+
+## Start in a brand-new directory
+
+```bash
+mkdir /tmp/my-jsonllm-workspace
+jsonllm init-project /tmp/my-jsonllm-workspace
+jsonllm --workspace /tmp/my-jsonllm-workspace list-modules
+```
+
+`--workspace` (or env `JSONLLM_WORKSPACE`) controls where `catalog/`, `modules/`, and `data/` are read/written.
+
+## CLI
+
+```bash
+jsonllm --workspace /path/to/workspace list-modules
+jsonllm --workspace /path/to/workspace init-module my_domain
+jsonllm --workspace /path/to/workspace test-module --module-id my_domain
+jsonllm --workspace /path/to/workspace new-intent --request-text "..." --aggregate-id req-1
+jsonllm --workspace /path/to/workspace run-policy
+jsonllm --workspace /path/to/workspace run-planner
+jsonllm --workspace /path/to/workspace run-executor
+```
+
+Equivalent while developing in this repo:
+
+```bash
+python3 src/event_pipeline.py --workspace . list-modules
+```
+
+## Module self-serve workflow
+
+1. Scaffold module:
+
+```bash
+jsonllm --workspace /path/to/workspace init-module my_domain
+```
+
+2. Implement `policy/plan/execute` in `modules/my_domain/module.py`.
+3. Update `modules/my_domain/module.toml` (intents/actions/permissions).
+4. Ensure actions are in `catalog/allowed-actions.json`.
+5. Run conformance:
+
+```bash
+jsonllm --workspace /path/to/workspace test-module --module-id my_domain
+```
+
+6. Run end-to-end pipeline.
+
+## Compatibility and standards
+
+- Module API version is declared by `module_api_version` in `module.toml`.
+- Loader rejects incompatible module API versions.
+- See:
+  - `docs/MODULE_COMPATIBILITY.md`
+  - `docs/MODULE_COOKBOOK.md`
+
+## Example modules
+
+- `modules/core_builtin`: generic routes for search/extraction/classification.
+- `modules/math_sum`: tangible deterministic computation (`math.sum.v1`) writing outputs to `data/outputs/`.

jsonllm_kernel-0.1.1/pyproject.toml

@@ -0,0 +1,37 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "jsonllm-kernel"
+version = "0.1.1"
+description = "Deterministic event-sourced kernel for modular LLM automation"
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+  "openai>=1.0.0",
+  "pydantic>=2.0.0",
+]
+
+[project.optional-dependencies]
+dev = ["pytest>=8.0.0"]
+
+[project.scripts]
+jsonllm = "event_pipeline:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+py-modules = ["event_pipeline"]
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["jsonllm_kernel*"]
+
+[tool.setuptools.package-data]
+jsonllm_kernel = [
+  "templates/*",
+  "templates/catalog/*",
+  "templates/modules/*",
+  "templates/modules/*/*",
+]

jsonllm_kernel-0.1.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+