Publish hardened LumynaX product package

.gitattributes

@@ -1,5 +1,2 @@
 * text=auto
-*.py text eol=lf
-*.md text eol=lf
-*.yaml text eol=lf
-*.json text eol=lf
+*.json linguist-generated=false

LICENSE

@@ -1,17 +1,6 @@
-                                 Apache License
-                           Version 2.0, January 2004
-                        http://www.apache.org/licenses/
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
 
-Copyright 2026 AbteeX AI Labs
-
-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.
+This repository is published as a product scaffold by AbteeX AI Labs. See the
+Apache License 2.0 text at https://www.apache.org/licenses/LICENSE-2.0.

README.md

@@ -12,193 +12,210 @@ tags:
 - aotearoa
 - sovereign-ai
 - local-first
+- opencode
 language:
 - en
 - mi
 ---
 
 # AbteeX SovereignCode
+<!-- abteex-sovereigncode-card:v2 -->
 
-<!-- abteex-sovereigncode-card:v1 -->
+Standalone release package for `AbteeXAILab/sovereigncode`.
 
-<p align="center"><em>Sovereign intelligence, held in the light.</em></p>
-<p align="center"><em>Ko te mārama te tūāpapa &mdash; the light is the foundation.</em></p>
+## Install
 
-<p align="center">
-  <strong>A local-first coding agent with Data Capsule sovereignty controls.</strong><br/>
-  AbteeX AI Labs &mdash; Aotearoa New Zealand.
-</p>
+```bash
+hf download AbteeXAILab/sovereigncode --local-dir sovereigncode --repo-type model
+cd sovereigncode
+pip install -e .
+python quickstart.py
+```
 
-<p align="center">
-  <a href="#what-it-is">What it is</a> &middot;
-  <a href="#quickstart">Quickstart</a> &middot;
-  <a href="#data-capsule">Data Capsule</a> &middot;
-  <a href="#policy-decision-point">Policy decision point</a> &middot;
-  <a href="#audit-ledger">Audit ledger</a> &middot;
-  <a href="#roadmap">Roadmap</a> &middot;
-  <a href="#companion-products">Companions</a>
-</p>
+## Included Runtime Commands
 
-![SovereignCode](https://img.shields.io/badge/AbteeX-SovereignCode-e08a2c?style=for-the-badge) ![Stage scaffold](https://img.shields.io/badge/stage-product%20scaffold-0a0a0b?style=for-the-badge) ![Runtime python](https://img.shields.io/badge/runtime-python%203.11%2B-726b62?style=for-the-badge) ![License Apache 2.0](https://img.shields.io/badge/license-Apache--2.0-9a5416?style=for-the-badge) ![Card v1](https://img.shields.io/badge/card-v1-111827?style=for-the-badge)
+```bash
+python -m sovereigncode.cli evaluate --capsule examples/capsule.restricted-nz-code.json --request examples/request.allowed-local-edit.json
+python -m sovereigncode.cli plan-turn --capsule examples/capsule.restricted-nz-code.json --request examples/request.allowed-local-edit.json --route-request examples/request.code-restricted.json --registry configs/lumynax_model_registry.json
+```
+
+# AbteeX SovereignCode
 
-## What It Is
+AbteeX SovereignCode is the proposed AbteeX AI Labs coding-agent product built on LumynaX. It is conceptually close to an OpenCode-style terminal coding assistant, but the centre of gravity is AI sovereignty: every model call, tool call, file edit, and outbound action is evaluated against a Data Capsule policy before execution.
 
-**AbteeX SovereignCode** is the AbteeX AI Labs coding-agent product built on the LumynaX release family. It is conceptually close to an OpenCode-style terminal coding assistant, but the centre of gravity is *AI sovereignty*: every model call, tool call, file edit, and outbound action is evaluated against a **Data Capsule** policy before execution.
+## Product Position
 
-It is for organisations that want local-first coding assistance without losing control over source code, regulated records, Iwi or community-held data, health data, procurement records, or other sensitive operational context.
+SovereignCode is for organisations that want local-first coding assistance without losing control over source code, regulated records, Iwi or community-held data, health data, procurement records, or other sensitive operational context.
 
-## Five Commitments
+The product is designed around five commitments:
 
 | Commitment | Product Meaning |
 | --- | --- |
 | Data capsules | Every workspace, dataset, or customer context can carry machine-readable purpose, residency, retention, export, and training controls. |
-| Policy before tools | Shell commands, file writes, network calls, commits, and model calls are checked **before** execution. |
+| Policy before tools | Shell commands, file writes, network calls, commits, and model calls are checked before execution. |
 | Local-first inference | High-impact or restricted data routes to local or LumynaX-governed models by default. |
 | Human review | External effects require explicit approval, visible diffs, and audit records. |
 | Provenance | Model identity, source files, policy decisions, prompts, outputs, and release metadata remain traceable. |
 
 ## Why This Is Different
 
-Most coding agents optimise for speed. SovereignCode optimises for **controlled autonomy**: it can still plan, edit, test, and explain code, but it treats data rights, residency, consent, provenance, and human approval as *runtime primitives* &mdash; not policy text on a wiki.
+Most coding agents optimise for speed. SovereignCode optimises for controlled autonomy: it can still plan, edit, test, and explain code, but it treats data rights, residency, consent, provenance, and human approval as runtime primitives instead of policy text on a wiki.
+
+The initial product scaffold includes:
+
+- A deterministic Data Capsule policy decision point.
+- Personal-detail consent checks for anonymous, pseudonymous, identifiable, and sensitive identifiable contexts.
+- A CLI evaluator for governed code/data requests.
+- A governed coding-turn planner that combines policy, audit, tool grants, and MaramaRoute model selection.
+- Audit-record generation with stable request hashes.
+- Product architecture and launch roadmap.
+- Example capsules for restricted New Zealand source-code work.
+- A path to integrate with LumynaX MaramaRoute for sovereign model selection.
 
 ## Quickstart
 
-Clone and install:
+From the repo root:
 
 ```bash
-hf download AbteeXAILab/sovereigncode --local-dir sovereigncode --repo-type model
-cd sovereigncode
-pip install -r requirements.txt
+py -3 -m tinyluminax.products.sovereigncode.cli evaluate \
+  --capsule products/abx-sovereigncode/examples/capsule.restricted-nz-code.json \
+  --request products/abx-sovereigncode/examples/request.allowed-local-edit.json
 ```
 
-Evaluate an **allowed** local-edit request against the example capsule:
+Expected result: `allowed: true` with obligations such as audit logging, local runtime routing, and visible diff review.
+
+Plan a complete governed coding-agent turn:
 
 ```bash
-python -m sovereigncode.cli evaluate \
-  --capsule examples/capsule.restricted-nz-code.json \
-  --request examples/request.allowed-local-edit.json
+py -3 -m tinyluminax.products.sovereigncode.cli plan-turn \
+  --capsule products/abx-sovereigncode/examples/capsule.restricted-nz-code.json \
+  --request products/abx-sovereigncode/examples/request.allowed-local-edit.json \
+  --route-request products/lumynax-marama-route/examples/request.code-restricted.json \
+  --registry products/lumynax-marama-route/configs/lumynax_model_registry.json
 ```
 
-Expected: `allowed: true` with obligations including `write_immutable_audit_record`, `preserve_capsule_id_in_agent_trace`, and `show_diff_before_write_or_commit`.
-
-Evaluate a **denied** training request:
+Denied training example:
 
 ```bash
-python -m sovereigncode.cli evaluate \
-  --capsule examples/capsule.restricted-nz-code.json \
-  --request examples/request.denied-training.json \
+py -3 -m tinyluminax.products.sovereigncode.cli evaluate \
+  --capsule products/abx-sovereigncode/examples/capsule.restricted-nz-code.json \
+  --request products/abx-sovereigncode/examples/request.denied-training.json \
   --allow-denied-exit-zero
 ```
 
-Expected: `allowed: false` with reason `capsule.training_allowed = false`.
-
-## Data Capsule
-
-A Data Capsule is the policy envelope attached to a workspace, dataset, tenant, case, source-file set, or prompt context.
-
-```json
-{
-  "capsule_id": "cap-nz-code-001",
-  "subject_id": "abx-workspace",
-  "jurisdiction": "NZ",
-  "sensitivity": "restricted",
-  "allowed_purposes": ["coding_assistance", "inference", "test_generation"],
-  "denied_purposes": ["ad_training", "third_party_resale"],
-  "resident_regions": ["NZ"],
-  "data_classes": ["source_code", "policy", "runtime_logs"],
-  "retention_days": 14,
-  "export_allowed": false,
-  "training_allowed": false
-}
-```
+## Product Modules
 
-Capsules carry:
-
-- `allowed_purposes` / `denied_purposes`
-- `resident_regions`
-- `retention_days`
-- `training_allowed` / `export_allowed`
-- `data_classes`
-- `schema_context`
-- `consent_record`
-
-## Policy Decision Point
-
-The PDP answers one question before every sensitive action:
-
-> *Can this actor, for this purpose, in this region, using this model/tool, touch this capsule?*
+| Module | Purpose |
+| --- | --- |
+| Workspace Indexer | Builds a local map of files, policies, secrets, data classes, and repository ownership. |
+| Data Capsule PDP | Decides whether a request is allowed, denied, or allowed with obligations. |
+| Tool Broker | Wraps shell, file, git, network, package, and model actions with policy checks. |
+| LumynaX Runtime Adapter | Routes model calls to local GGUF, local API, or approved LumynaX model endpoints. |
+| Audit Ledger | Stores decision records, prompt/output hashes, file diffs, and approval metadata. |
+| Operator Console | Shows the plan, policy decision, diff, tests, and approval gate before external effects. |
 
-Decisions are one of: `allow`, `deny`, or `allow_with_obligations`. Every decision produces a structured record:
+## New Zealand Launch Shape
 
-| Field | Meaning |
+| Layer | Product Decision |
 | --- | --- |
-| `capsule_id` | The capsule the action touches. |
-| `actor` | Who initiated the action. |
-| `purpose` | Declared purpose (e.g. `coding_assistance`). |
-| `action` | The tool action requested. |
-| `model_id` | Resolved model identity (often via [MaramaRoute](https://huggingface.co/AbteeXAILab/marama-route)). |
-| `decision` | `allow` / `deny` / `allow_with_obligations`. |
-| `reasons` | Ordered list of policy reasons. |
-| `obligations` | Required follow-up actions. |
-| `request_hash` | Stable SHA-256 of the canonical request. |
-| `timestamp` | ISO 8601 UTC. |
-
-## Tool Broker
+| Default region | `NZ` residency, with explicit opt-in for `AU` or global routes. |
+| Default data posture | Local-first for restricted, health, personal, Iwi, taonga, and regulated operational context. |
+| Buyer control | Tenant policy packs define purpose, retention, model allowlists, exports, and approval rules. |
+| Personal sovereignty | Personal data is tagged by detail level and consent scope before it enters prompts or traces. |
+| OpenCode compatibility | Configure SovereignCode through MaramaRoute as an OpenAI-compatible provider. |
+| Commercial wedge | Start with governed code assistance for New Zealand teams that cannot send private workspaces to a generic cloud coding agent. |
 
-The broker is the enforcement layer for shell commands, file writes, git commits, network calls, package installs, model calls, retrieval queries, and training jobs. Every tool call passes through the PDP first.
+## Real Product Surfaces
 
-## Audit Ledger
+| Surface | File |
+| --- | --- |
+| Data Capsule JSON Schema | `schemas/data_capsule.schema.json` |
+| NZ personal sovereignty policy pack | `policy-packs/nz-personal-sovereignty.yaml` |
+| OpenCode-compatible integration guide | `integrations/opencode-compatible-provider.md` |
+| OpenCode provider example | `examples/opencode.marama-route.json` |
+| Personal profile capsule | `examples/capsule.personal-sovereignty-profile.json` |
+| Personal-memory request | `examples/request.personal-memory-read.json` |
+| Product blueprint | `product_blueprint.md` |
 
-Every decision creates an immutable audit record. Records are append-only and hash-chained &mdash; usable as evidence for regulators, customers, and internal review.
+## Source Grounding
 
-## Sovereignty & Run Contract
+The sovereignty model is inspired by the Data Capsule pattern described in the ScienceDirect article identified by PII `S2543925125000166`, especially its emphasis on semantic metadata, ontology-based federation, and dynamic usage-control policies. This repository uses that idea as product architecture inspiration; it does not copy the paper text or implementation.
 
-| Field | Value |
-| --- | --- |
-| Publisher | AbteeX AI Labs |
-| Family | LumynaX sovereign products |
-| Sovereign intent | Local-first coding assistance with policy-before-tools enforcement. |
-| Runtime residency | Operator's environment; restricted data routes to local or LumynaX-governed models. |
-| License | Apache-2.0 |
-| Stage | Product scaffold &mdash; PDP and audit engine executable; full terminal loop in P1. |
-| Router integration | First-class with [LumynaX MaramaRoute](https://huggingface.co/AbteeXAILab/marama-route). |
+## Stage
 
-## Roadmap
+This is a product scaffold, not the final commercial application. The policy engine and router integration are executable now; the terminal UI, tool broker, and full agent loop are the next implementation stage.
 
-| Milestone | Outcome |
-| --- | --- |
-| **P0 scaffold** *(now)* | Policy engine, audit records, CLI, examples, docs. |
-| **P1 terminal loop** | Local terminal agent with plan / edit / test workflow. |
-| **P2 tool broker** | Policy wrappers for shell, git, file writes, package installs, HTTP. |
-| **P3 MaramaRoute integration** | Sovereign model routing for every model call. |
-| **P4 workspace UI** | Browser console showing plan, policy, diffs, tests, approvals. |
-| **P5 enterprise controls** | Tenant policies, SSO hooks, signed audit exports, policy packs. |
 
-## Source Grounding
+# AbteeX SovereignCode Product Blueprint
 
-The sovereignty model is inspired by the Data Capsule pattern described in the ScienceDirect article identified by PII `S2543925125000166` &mdash; especially its emphasis on semantic metadata, ontology-based federation, and dynamic usage-control policies. This repository uses that idea as product architecture inspiration; it does not copy the paper text or implementation.
+## One-Sentence Product
 
-## Companion Products
+SovereignCode is a local-first coding agent for New Zealand teams that need code
+assistance, model routing, personal-data controls, and audit-ready tool use in
+one governed workflow.
 
-| Product | Purpose |
-| --- | --- |
-| [LumynaX MaramaRoute](https://huggingface.co/AbteeXAILab/marama-route) | Sovereign model router across the LumynaX release family. SovereignCode delegates model selection to MaramaRoute. |
-| [LumynaX Live Demo](https://huggingface.co/spaces/AbteeXAILab/lumynax-live-demo) | Public browser demo of a LumynaX-infused GGUF release. |
-| [SovereignCode Live](https://huggingface.co/spaces/AbteeXAILab/sovereigncode-demo) | Interactive policy evaluator &mdash; paste a capsule and request, see the decision. |
-| [AbteeXAILab on Hugging Face](https://huggingface.co/AbteeXAILab) | The full LumynaX release family. |
+## Core User Jobs
 
-## Aotearoa Kaupapa
+| User | Job | SovereignCode Response |
+| --- | --- | --- |
+| Individual developer | Use an AI coding assistant without exposing private files or personal preferences. | Local capsule, pseudonymous personal profile, resident model route, no training by default. |
+| Startup or SME | Refactor and test private code while keeping customer data out of generic SaaS logs. | Workspace capsule, local route, diff review, audit hash. |
+| Council or public-sector team | Use AI on operational code and documents with retention and residency controls. | Tenant policy pack, NZ residency, approval gates, signed audit export. |
+| Iwi or community data steward | Keep community-held context under explicit purpose and consent boundaries. | High-impact sensitivity, local/LumynaX-only model rule, export denial by default. |
+| Internal platform owner | Give developers one coding assistant with central policy. | OpenAI-compatible provider, CLI planner, future SSO and policy server. |
 
-SovereignCode is built in and for Aotearoa New Zealand. Iwi data sovereignty, health-information governance, and procurement transparency are not retro-fits &mdash; they are the runtime contract. The product treats data rights, residency, consent, provenance, and human approval as primitives.
+## Product Pillars
 
-## Limitations & Responsible Use
+1. Capsule-first context: every workspace, profile, dataset, and prompt context
+   resolves to a Data Capsule before agent work starts.
+2. Personal sovereignty: personal detail is classified before prompt assembly,
+   and consent scopes gate how profile context can be used.
+3. Governed autonomy: read, plan, patch, test, shell, network, commit, and
+   publish actions are separate tool grants.
+4. Open integration: OpenCode and similar clients connect through MaramaRoute's
+   OpenAI-compatible gateway.
+5. Audit without hoarding: records retain decision hashes, obligations, model
+   identity, and reasons while prompt retention stays constrained.
 
-- The PDP enforces declared policy. It does not detect every possible deceptive prompt or covert exfiltration channel.
-- The current release is a *product scaffold*. Full terminal loop, tool broker, and workspace UI ship in P1–P4.
-- For high-impact decisions, use human review and domain-specific evaluation.
-- Audit records help, but auditability is a process &mdash; not a guarantee.
+## Minimum Product Loop
 
----
+```text
+developer asks for a coding task
+  -> resolve `.sovereigncode/capsule.json`
+  -> evaluate SovereignRequest
+  -> build MaramaRoute request
+  -> select resident LumynaX model
+  -> produce plan
+  -> request approval for writes or shell
+  -> apply patch
+  -> run tests
+  -> store audit record
+```
 
-<p align="center"><em>Local roots, global work. &middot; Sovereignty is a design property, not a deployment option.</em></p>
-<p align="center"><sub>AbteeX AI Labs &middot; <a href="https://abteex.com">abteex.com</a> &middot; <a href="https://lumynax.com">lumynax.com</a> &middot; <a href="https://huggingface.co/AbteeXAILab">huggingface.co/AbteeXAILab</a></sub></p>
+## Product Modules To Build Next
+
+| Module | MVP Definition | Implementation Notes |
+| --- | --- | --- |
+| Workspace indexer | Reads repo files, ignores secrets/build outputs, tags data classes. | Start with `rg --files`, `.gitignore`, and capsule include/exclude rules. |
+| Tool broker | Wraps file write, shell, git, package install, HTTP, and model calls. | Reuse policy decisions and emit one audit record per effectful tool call. |
+| Terminal UI | Shows plan, selected model, obligations, diff, and test output. | Keep compatible with OpenCode-style terminal use. |
+| Personal profile store | Keeps user preferences and memory under a personal capsule. | Local encrypted file first, tenant vault later. |
+| Audit ledger | Append-only local JSONL with hash chain. | Export signed bundles for enterprise customers. |
+| Tenant policy server | Central policy packs, model allowlists, API keys, quotas. | Only needed after local MVP works. |
+
+## Default Plans
+
+| Plan | Buyer | Included |
+| --- | --- | --- |
+| Local Developer | individual NZ developer | local capsule, local audit, MaramaRoute provider config |
+| Team Sovereign | startup or SME | shared policy pack, route registry, team audit export |
+| Regulated Workspace | council, health-adjacent, community data project | stronger approval gates, retention controls, signed audit, SSO-ready policy server |
+
+## First Non-Negotiables
+
+- Never train on a capsule unless `training_allowed` is explicitly true.
+- Never export restricted or personal context unless `export_allowed` is true
+  and the request carries human approval.
+- Never route high-impact data to a non-local or non-LumynaX-governed model.
+- Never apply file writes without a visible diff obligation.
+- Never hide selected model identity from the audit record.

SMOKE_TESTS.md

@@ -0,0 +1,11 @@
+# SovereignCode Smoke Tests
+
+Run from the package root:
+
+```bash
+pip install -e .
+python quickstart.py
+python -m sovereigncode.cli evaluate --capsule examples/capsule.personal-sovereignty-profile.json --request examples/request.personal-memory-read.json
+```
+
+Expected: all commands exit 0 and emit JSON decisions with audit records.

configs/lumynax_model_registry.json

@@ -0,0 +1,2931 @@
+{
+  "registry_id": "lumynax-marama-route-registry-v0",
+  "publisher": "AbteeX AI Labs",
+  "source_report": "docs/releases/hf-model-card-v4-refresh-2026-05-11.json",
+  "model_count": 74,
+  "models": [
+    {
+      "model_id": "lumynax-coder-qwen25-05b-instruct-gguf",
+      "repo_id": "AbteeXAILab/lumynax-coder-qwen25-05b-instruct-gguf",
+      "title": "LumynaX Coder Qwen2.5 0.5B Instruct GGUF",
+      "family": "qwen",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 32768,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "qwen2.5-coder-0.5b-instruct-q4_k_m.gguf",
+      "active_params_b": null,
+      "total_params_b": 0.5,
+      "quality_rank": 5,
+      "cost_rank": 2,
+      "sovereignty_tier": 3,
+      "supports_tools": true,
+      "supports_json": true,
+      "tags": [
+        "coder",
+        "gguf",
+        "lumynax",
+        "qwen",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "81c904af42045aeac88fa843b8f653d79afa0422",
+        "package_state": "prebuilt_gguf_release",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 491400064
+      }
+    },
+    {
+      "model_id": "lumynax-coder-qwen25-14b-instruct-gguf",
+      "repo_id": "AbteeXAILab/lumynax-coder-qwen25-14b-instruct-gguf",
+      "title": "LumynaX Coder Qwen2.5 14B Instruct GGUF",
+      "family": "qwen",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 32768,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "qwen2.5-coder-14b-instruct-q4_k_m.gguf",
+      "active_params_b": null,
+      "total_params_b": 14.0,
+      "quality_rank": 2,
+      "cost_rank": 6,
+      "sovereignty_tier": 3,
+      "supports_tools": true,
+      "supports_json": true,
+      "tags": [
+        "coder",
+        "gguf",
+        "lumynax",
+        "qwen",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "e408c607528af8457900e4237b26184612f16e49",
+        "package_state": "prebuilt_gguf_release",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 8988110272
+      }
+    },
+    {
+      "model_id": "lumynax-coder-qwen25-15b-instruct-gguf",
+      "repo_id": "AbteeXAILab/lumynax-coder-qwen25-15b-instruct-gguf",
+      "title": "LumynaX Coder Qwen2.5 1.5B Instruct GGUF",
+      "family": "qwen",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 32768,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "qwen2.5-coder-1.5b-instruct-q4_k_m.gguf",
+      "active_params_b": null,
+      "total_params_b": 1.5,
+      "quality_rank": 5,
+      "cost_rank": 4,
+      "sovereignty_tier": 3,
+      "supports_tools": true,
+      "supports_json": true,
+      "tags": [
+        "coder",
+        "gguf",
+        "lumynax",
+        "qwen",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "cbe84212ed061b79297683f6d6247fd22f1fde7c",
+        "package_state": "prebuilt_gguf_release",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 1117320768
+      }
+    },
+    {
+      "model_id": "lumynax-coder-qwen25-7b-instruct-gguf",
+      "repo_id": "AbteeXAILab/lumynax-coder-qwen25-7b-instruct-gguf",
+      "title": "LumynaX Coder Qwen2.5 7B Instruct GGUF",
+      "family": "qwen",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 32768,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "qwen2.5-coder-7b-instruct-q4_k_m.gguf",
+      "active_params_b": null,
+      "total_params_b": 7.0,
+      "quality_rank": 3,
+      "cost_rank": 6,
+      "sovereignty_tier": 3,
+      "supports_tools": true,
+      "supports_json": true,
+      "tags": [
+        "coder",
+        "gguf",
+        "lumynax",
+        "qwen",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "fe5491063e09af13dbdb7fa6cef7f57d5cecc14d",
+        "package_state": "prebuilt_gguf_release",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 4683073536
+      }
+    },
+    {
+      "model_id": "lumynax-embed-bge-m3",
+      "repo_id": "AbteeXAILab/lumynax-embed-bge-m3",
+      "title": "LumynaX Embed BGE M3",
+      "family": "embedding",
+      "runtime": "python_embedding",
+      "modalities": [
+        "text",
+        "embedding"
+      ],
+      "context_tokens": 8192,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "merged_model/pytorch_model.bin",
+      "active_params_b": null,
+      "total_params_b": null,
+      "quality_rank": 4,
+      "cost_rank": 4,
+      "sovereignty_tier": 2,
+      "supports_tools": false,
+      "supports_json": false,
+      "tags": [
+        "embedding",
+        "lumynax",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "05011e1f7ea9cbd714c8fef86695a498685750a8",
+        "package_state": "upstream_weights_hydrated_embedding",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 2273250020
+      }
+    },
+    {
+      "model_id": "lumynax-embed-e5-mistral-7b",
+      "repo_id": "AbteeXAILab/lumynax-embed-e5-mistral-7b",
+      "title": "LumynaX Embed E5 Mistral 7B",
+      "family": "mistral",
+      "runtime": "python_embedding",
+      "modalities": [
+        "text",
+        "embedding"
+      ],
+      "context_tokens": 8192,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "merged_model/model-00001-of-00002.safetensors",
+      "active_params_b": null,
+      "total_params_b": 7.0,
+      "quality_rank": 3,
+      "cost_rank": 8,
+      "sovereignty_tier": 2,
+      "supports_tools": false,
+      "supports_json": false,
+      "tags": [
+        "embedding",
+        "lumynax",
+        "mistral",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "0c8fc35c248b9bbc951df8904c97f41c51a883c2",
+        "package_state": "upstream_weights_hydrated_embedding",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 14221351904
+      }
+    },
+    {
+      "model_id": "lumynax-frontier-minimax-m25-unsloth",
+      "repo_id": "AbteeXAILab/lumynax-frontier-minimax-m25-unsloth",
+      "title": "LumynaX Frontier MiniMax M2.5 Unsloth",
+      "family": "minimax",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 8192,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "MiniMax-M2.5-UD-TQ1_0.gguf",
+      "active_params_b": null,
+      "total_params_b": null,
+      "quality_rank": 1,
+      "cost_rank": 10,
+      "sovereignty_tier": 3,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "frontier",
+        "general",
+        "lumynax",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "ff328be463825aedd9cec5b8f5fe3fce47f7547f",
+        "package_state": "prebuilt_gguf_release",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 55765943424
+      }
+    },
+    {
+      "model_id": "lumynax-infused-gemma-e4b",
+      "repo_id": "AbteeXAILab/lumynax-infused-gemma-e4b",
+      "title": "LumynaX Infused Gemma E4B Model",
+      "family": "gemma",
+      "runtime": "transformers_multimodal",
+      "modalities": [
+        "text",
+        "image",
+        "audio"
+      ],
+      "context_tokens": 4096,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "merged_model/model.safetensors",
+      "active_params_b": null,
+      "total_params_b": 4.0,
+      "quality_rank": 3,
+      "cost_rank": 8,
+      "sovereignty_tier": 2,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "audio",
+        "gemma",
+        "general",
+        "image",
+        "lumynax",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "71c0d98bc3ac1b90d3d59dbc5505910e6edef6a6",
+        "package_state": "base_weights_hydrated",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 15992595884
+      }
+    },
+    {
+      "model_id": "lumynax-infused-gemma-e4b-text-gguf",
+      "repo_id": "AbteeXAILab/lumynax-infused-gemma-e4b-text-gguf",
+      "title": "LumynaX Infused Gemma E4B Text GGUF",
+      "family": "gemma",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 8192,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "lumynax-infused-gemma-e4b-text-gguf-q4_k_m.gguf",
+      "active_params_b": null,
+      "total_params_b": 4.0,
+      "quality_rank": 3,
+      "cost_rank": 6,
+      "sovereignty_tier": 3,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "gemma",
+        "general",
+        "gguf",
+        "lumynax",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "da670d4d4c080f93e37171d69f2e49cbe0740f4c",
+        "package_state": "hf_q4_runtime_bundle",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 5335290080
+      }
+    },
+    {
+      "model_id": "lumynax-infused-gemma4-26b-a4b-gguf",
+      "repo_id": "AbteeXAILab/lumynax-infused-gemma4-26b-a4b-gguf",
+      "title": "LumynaX Infused Gemma4 26B A4B GGUF",
+      "family": "gemma",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 8192,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "lumynax-infused-gemma4-26b-a4b-ud-q4_k_m.gguf",
+      "active_params_b": 4.0,
+      "total_params_b": 26.0,
+      "quality_rank": 1,
+      "cost_rank": 8,
+      "sovereignty_tier": 3,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "gemma",
+        "general",
+        "gguf",
+        "lumynax",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "9ac3619aaa892edf714fad37d566dcc75e3c63e6",
+        "package_state": "prebuilt_gguf_release",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 16947539744
+      }
+    },
+    {
+      "model_id": "lumynax-infused-granite31-1b-a400m-gguf",
+      "repo_id": "AbteeXAILab/lumynax-infused-granite31-1b-a400m-gguf",
+      "title": "LumynaX Infused Granite 3.1 1B A400M Instruct GGUF",
+      "family": "granite",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 8192,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "granite-3.1-1b-a400m-instruct-Q4_K_M.gguf",
+      "active_params_b": null,
+      "total_params_b": 1.0,
+      "quality_rank": 5,
+      "cost_rank": 2,
+      "sovereignty_tier": 3,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "general",
+        "gguf",
+        "granite",
+        "lumynax",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "4962677e55c151eb9540257318fd640ce1f002e7",
+        "package_state": "prebuilt_gguf_release",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 821847360
+      }
+    },
+    {
+      "model_id": "lumynax-infused-granite33-2b-gguf",
+      "repo_id": "AbteeXAILab/lumynax-infused-granite33-2b-gguf",
+      "title": "LumynaX Infused Granite 3.3 2B Instruct GGUF",
+      "family": "granite",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 8192,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "granite-3.3-2b-instruct-Q4_K_M.gguf",
+      "active_params_b": null,
+      "total_params_b": 2.0,
+      "quality_rank": 4,
+      "cost_rank": 4,
+      "sovereignty_tier": 3,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "general",
+        "gguf",
+        "granite",
+        "lumynax",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "008f69d6d7ed46cfa4a26e14f1a36ed7840ca86e",
+        "package_state": "prebuilt_gguf_release",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 1545303328
+      }
+    },
+    {
+      "model_id": "lumynax-infused-granite33-8b-gguf",
+      "repo_id": "AbteeXAILab/lumynax-infused-granite33-8b-gguf",
+      "title": "LumynaX Infused Granite 3.3 8B Instruct GGUF",
+      "family": "granite",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 8192,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "granite-3.3-8b-instruct-Q4_K_M.gguf",
+      "active_params_b": null,
+      "total_params_b": 8.0,
+      "quality_rank": 3,
+      "cost_rank": 6,
+      "sovereignty_tier": 3,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "general",
+        "gguf",
+        "granite",
+        "lumynax",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "9a73a865e7121274789cee80e6543444e034bb01",
+        "package_state": "prebuilt_gguf_release",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 4942873344
+      }
+    },
+    {
+      "model_id": "lumynax-infused-mistral-7b-v03-gguf",
+      "repo_id": "AbteeXAILab/lumynax-infused-mistral-7b-v03-gguf",
+      "title": "LumynaX Infused Mistral 7B Instruct v0.3 GGUF",
+      "family": "mistral",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 8192,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "Mistral-7B-Instruct-v0.3-Q4_K_M.gguf",
+      "active_params_b": null,
+      "total_params_b": 7.0,
+      "quality_rank": 3,
+      "cost_rank": 6,
+      "sovereignty_tier": 3,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "general",
+        "gguf",
+        "lumynax",
+        "mistral",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "b27abdbb78659b9577c68040838a4811bb2a4fc4",
+        "package_state": "prebuilt_gguf_release",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 4372812000
+      }
+    },
+    {
+      "model_id": "lumynax-infused-mistral-small-text-gguf",
+      "repo_id": "AbteeXAILab/lumynax-infused-mistral-small-text-gguf",
+      "title": "LumynaX Infused Mistral Small Text GGUF",
+      "family": "mistral",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 8192,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "lumynax-infused-mistral-small-text-gguf-f16.gguf",
+      "active_params_b": null,
+      "total_params_b": null,
+      "quality_rank": 3,
+      "cost_rank": 10,
+      "sovereignty_tier": 3,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "general",
+        "gguf",
+        "lumynax",
+        "mistral",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "f0dcbb1666de6f53212277f225ca5eb0901d9627",
+        "package_state": "base_weights_hydrated_text_gguf",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 61488486400
+      }
+    },
+    {
+      "model_id": "lumynax-infused-olmo2-1b-0425-gguf",
+      "repo_id": "AbteeXAILab/lumynax-infused-olmo2-1b-0425-gguf",
+      "title": "LumynaX Infused OLMo 2 0425 1B Instruct GGUF",
+      "family": "olmo",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 8192,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "OLMo-2-0425-1B-Instruct-Q4_K_M.gguf",
+      "active_params_b": null,
+      "total_params_b": 1.0,
+      "quality_rank": 5,
+      "cost_rank": 2,
+      "sovereignty_tier": 3,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "general",
+        "gguf",
+        "lumynax",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "6bbec139651766aaf4310e2affe44504a0bb3a02",
+        "package_state": "prebuilt_gguf_release",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 935515296
+      }
+    },
+    {
+      "model_id": "lumynax-infused-olmo2-7b-1124-gguf",
+      "repo_id": "AbteeXAILab/lumynax-infused-olmo2-7b-1124-gguf",
+      "title": "LumynaX Infused OLMo 2 1124 7B Instruct GGUF",
+      "family": "olmo",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 8192,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "olmo-2-1124-7B-instruct-Q4_K_M.gguf",
+      "active_params_b": null,
+      "total_params_b": 7.0,
+      "quality_rank": 3,
+      "cost_rank": 6,
+      "sovereignty_tier": 3,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "general",
+        "gguf",
+        "lumynax",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "c37a2b4ccca91a97d57058b33037a0ce2d32dd91",
+        "package_state": "prebuilt_gguf_release",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 4472020256
+      }
+    },
+    {
+      "model_id": "lumynax-infused-phi-4-text-gguf",
+      "repo_id": "AbteeXAILab/lumynax-infused-phi-4-text-gguf",
+      "title": "LumynaX Infused Phi-4 Text GGUF",
+      "family": "phi",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 8192,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "lumynax-infused-phi-4-text-gguf-f16.gguf",
+      "active_params_b": null,
+      "total_params_b": null,
+      "quality_rank": 3,
+      "cost_rank": 10,
+      "sovereignty_tier": 3,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "general",
+        "gguf",
+        "lumynax",
+        "phi",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "d1ea33475c83c3ce97e63789ab9699e5f534a639",
+        "package_state": "base_weights_hydrated_text_gguf",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 38382657280
+      }
+    },
+    {
+      "model_id": "lumynax-infused-phi3-mini-4k-gguf",
+      "repo_id": "AbteeXAILab/lumynax-infused-phi3-mini-4k-gguf",
+      "title": "LumynaX Infused Phi-3 Mini 4K Instruct GGUF",
+      "family": "phi",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 8192,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "Phi-3-mini-4k-instruct-q4.gguf",
+      "active_params_b": null,
+      "total_params_b": null,
+      "quality_rank": 4,
+      "cost_rank": 4,
+      "sovereignty_tier": 3,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "general",
+        "gguf",
+        "lumynax",
+        "phi",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "726f4baf5b38e0ea150aaac0c893735f5af8b5d3",
+        "package_state": "prebuilt_gguf_release",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 2393231072
+      }
+    },
+    {
+      "model_id": "lumynax-infused-phi4-mini-instruct-gguf",
+      "repo_id": "AbteeXAILab/lumynax-infused-phi4-mini-instruct-gguf",
+      "title": "LumynaX Infused Phi-4 Mini Instruct GGUF",
+      "family": "phi",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 8192,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "Phi-4-mini-instruct-Q4_K_M.gguf",
+      "active_params_b": null,
+      "total_params_b": null,
+      "quality_rank": 4,
+      "cost_rank": 4,
+      "sovereignty_tier": 3,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "general",
+        "gguf",
+        "lumynax",
+        "phi",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "0159c99af7f773fed806a9c298752698ebecfb74",
+        "package_state": "prebuilt_gguf_release",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 2491874272
+      }
+    },
+    {
+      "model_id": "lumynax-infused-qwen2-audio-7b",
+      "repo_id": "AbteeXAILab/lumynax-infused-qwen2-audio-7b",
+      "title": "LumynaX Infused Qwen2 Audio 7B",
+      "family": "qwen",
+      "runtime": "transformers",
+      "modalities": [
+        "audio",
+        "text"
+      ],
+      "context_tokens": 32768,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "merged_model/model-00003-of-00005.safetensors",
+      "active_params_b": null,
+      "total_params_b": 7.0,
+      "quality_rank": 3,
+      "cost_rank": 8,
+      "sovereignty_tier": 2,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "audio",
+        "general",
+        "lumynax",
+        "qwen",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "e743d9eede8807f4a0ecff7d6d81a48c6bfd0aa9",
+        "package_state": "upstream_weights_hydrated_audio",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 16794296368
+      }
+    },
+    {
+      "model_id": "lumynax-infused-qwen25-15b-instruct-gguf",
+      "repo_id": "AbteeXAILab/lumynax-infused-qwen25-15b-instruct-gguf",
+      "title": "LumynaX Infused Qwen2.5 1.5B Instruct GGUF",
+      "family": "qwen",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 32768,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "qwen2.5-1.5b-instruct-q4_k_m.gguf",
+      "active_params_b": null,
+      "total_params_b": 1.5,
+      "quality_rank": 4,
+      "cost_rank": 4,
+      "sovereignty_tier": 3,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "general",
+        "gguf",
+        "lumynax",
+        "qwen",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "56236805876d7cde2954862e1dd3588a55a6912e",
+        "package_state": "prebuilt_gguf_release",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 1117320736
+      }
+    },
+    {
+      "model_id": "lumynax-infused-qwen25-3b-instruct-gguf",
+      "repo_id": "AbteeXAILab/lumynax-infused-qwen25-3b-instruct-gguf",
+      "title": "LumynaX Infused Qwen2.5 3B Instruct GGUF",
+      "family": "qwen",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 32768,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "qwen2.5-3b-instruct-q4_k_m.gguf",
+      "active_params_b": null,
+      "total_params_b": 3.0,
+      "quality_rank": 4,
+      "cost_rank": 4,
+      "sovereignty_tier": 3,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "general",
+        "gguf",
+        "lumynax",
+        "qwen",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "03272f747319be4d718c9feef64d5078bb8a0c07",
+        "package_state": "prebuilt_gguf_release",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 2104932768
+      }
+    },
+    {
+      "model_id": "lumynax-infused-qwen25-7b-instruct-gguf",
+      "repo_id": "AbteeXAILab/lumynax-infused-qwen25-7b-instruct-gguf",
+      "title": "LumynaX Infused Qwen2.5 7B Instruct GGUF",
+      "family": "qwen",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 32768,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "qwen2.5-7b-instruct-q3_k_m.gguf",
+      "active_params_b": null,
+      "total_params_b": 7.0,
+      "quality_rank": 3,
+      "cost_rank": 4,
+      "sovereignty_tier": 3,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "general",
+        "gguf",
+        "lumynax",
+        "qwen",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "a499dae1ce806b58f9727ca417615fd03958d115",
+        "package_state": "prebuilt_gguf_release",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 3808391072
+      }
+    },
+    {
+      "model_id": "lumynax-infused-qwen25-omni-7b-voice",
+      "repo_id": "AbteeXAILab/lumynax-infused-qwen25-omni-7b-voice",
+      "title": "LumynaX Infused Qwen2.5 Omni 7B Voice",
+      "family": "qwen",
+      "runtime": "transformers",
+      "modalities": [
+        "audio",
+        "text"
+      ],
+      "context_tokens": 32768,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "merged_model/model-00003-of-00005.safetensors",
+      "active_params_b": null,
+      "total_params_b": 7.0,
+      "quality_rank": 3,
+      "cost_rank": 10,
+      "sovereignty_tier": 2,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "audio",
+        "general",
+        "lumynax",
+        "qwen",
+        "text",
+        "voice"
+      ],
+      "metadata": {
+        "hub_sha": "8f2e5068851d87406998a678b3f69990fccb4ee3",
+        "package_state": "upstream_weights_hydrated_audio",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 22362861192
+      }
+    },
+    {
+      "model_id": "lumynax-infused-qwen3-06b-gguf",
+      "repo_id": "AbteeXAILab/lumynax-infused-qwen3-06b-gguf",
+      "title": "LumynaX Infused Qwen3 0.6B GGUF",
+      "family": "qwen",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 32768,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "Qwen3-0.6B-Q8_0.gguf",
+      "active_params_b": null,
+      "total_params_b": 0.6,
+      "quality_rank": 5,
+      "cost_rank": 2,
+      "sovereignty_tier": 3,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "general",
+        "gguf",
+        "lumynax",
+        "qwen",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "1b61730d710869c3789fffcc422a4f15539cffcf",
+        "package_state": "prebuilt_gguf_release",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 639446688
+      }
+    },
+    {
+      "model_id": "lumynax-infused-qwen3-14b-gguf",
+      "repo_id": "AbteeXAILab/lumynax-infused-qwen3-14b-gguf",
+      "title": "LumynaX Infused Qwen3 14B GGUF",
+      "family": "qwen",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 32768,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "Qwen3-14B-Q4_K_M.gguf",
+      "active_params_b": null,
+      "total_params_b": 14.0,
+      "quality_rank": 2,
+      "cost_rank": 8,
+      "sovereignty_tier": 3,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "general",
+        "gguf",
+        "lumynax",
+        "qwen",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "3fae690abff170d811eb5934efe6155621528d25",
+        "package_state": "prebuilt_gguf_release",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 9001752960
+      }
+    },
+    {
+      "model_id": "lumynax-infused-qwen3-17b-gguf",
+      "repo_id": "AbteeXAILab/lumynax-infused-qwen3-17b-gguf",
+      "title": "LumynaX Infused Qwen3 1.7B GGUF",
+      "family": "qwen",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 32768,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "Qwen3-1.7B-Q8_0.gguf",
+      "active_params_b": null,
+      "total_params_b": 1.7,
+      "quality_rank": 5,
+      "cost_rank": 4,
+      "sovereignty_tier": 3,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "general",
+        "gguf",
+        "lumynax",
+        "qwen",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "5eb95b799e57e502872c9ed47e63580ee81558ff",
+        "package_state": "prebuilt_gguf_release",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 1834426016
+      }
+    },
+    {
+      "model_id": "lumynax-infused-qwen3-30b-a3b-gguf",
+      "repo_id": "AbteeXAILab/lumynax-infused-qwen3-30b-a3b-gguf",
+      "title": "LumynaX Infused Qwen3 30B A3B GGUF",
+      "family": "qwen",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 32768,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "lumynax-infused-qwen3-30b-a3b-q4_k_m.gguf",
+      "active_params_b": 3.0,
+      "total_params_b": 30.0,
+      "quality_rank": 1,
+      "cost_rank": 8,
+      "sovereignty_tier": 3,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "general",
+        "gguf",
+        "lumynax",
+        "qwen",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "acfc6b800fc3979e419d4abfd51554b4d6e78abd",
+        "package_state": "prebuilt_gguf_release",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 18556686912
+      }
+    },
+    {
+      "model_id": "lumynax-infused-qwen3-8b-gguf",
+      "repo_id": "AbteeXAILab/lumynax-infused-qwen3-8b-gguf",
+      "title": "LumynaX Infused Qwen3 8B GGUF",
+      "family": "qwen",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 32768,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "lumynax-infused-qwen3-8b-q4_k_m.gguf",
+      "active_params_b": null,
+      "total_params_b": 8.0,
+      "quality_rank": 3,
+      "cost_rank": 6,
+      "sovereignty_tier": 3,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "general",
+        "gguf",
+        "lumynax",
+        "qwen",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "c61c9a6fa0b95ec8a3da1912b897ca1fcc19d48a",
+        "package_state": "prebuilt_gguf_release",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 5027783488
+      }
+    },
+    {
+      "model_id": "lumynax-infused-qwen3-coder-30b-a3b-gguf",
+      "repo_id": "AbteeXAILab/lumynax-infused-qwen3-coder-30b-a3b-gguf",
+      "title": "LumynaX Infused Qwen3 Coder 30B A3B GGUF",
+      "family": "qwen",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 32768,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "lumynax-infused-qwen3-coder-30b-a3b-q4_k_m.gguf",
+      "active_params_b": 3.0,
+      "total_params_b": 30.0,
+      "quality_rank": 1,
+      "cost_rank": 8,
+      "sovereignty_tier": 3,
+      "supports_tools": true,
+      "supports_json": true,
+      "tags": [
+        "coder",
+        "gguf",
+        "lumynax",
+        "qwen",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "243f8578284934be06d3cb3d055de1b4a28059cc",
+        "package_state": "prebuilt_gguf_release",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 18556689568
+      }
+    },
+    {
+      "model_id": "lumynax-infused-qwen3-text-gguf",
+      "repo_id": "AbteeXAILab/lumynax-infused-qwen3-text-gguf",
+      "title": "LumynaX Infused Qwen3 Text GGUF",
+      "family": "qwen",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 32768,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "lumynax-infused-qwen3-text-gguf-f16.gguf",
+      "active_params_b": null,
+      "total_params_b": null,
+      "quality_rank": 3,
+      "cost_rank": 10,
+      "sovereignty_tier": 3,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "general",
+        "gguf",
+        "lumynax",
+        "qwen",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "405002e7153a01f4fcc96d610f6af761de8c0574",
+        "package_state": "base_weights_hydrated_text_gguf",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 37797343976
+      }
+    },
+    {
+      "model_id": "lumynax-infused-smollm-135m-gguf",
+      "repo_id": "AbteeXAILab/lumynax-infused-smollm-135m-gguf",
+      "title": "LumynaX Infused SmolLM 135M Instruct GGUF",
+      "family": "smollm",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 8192,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "SmolLM-135M-Instruct.Q4_K_M.gguf",
+      "active_params_b": null,
+      "total_params_b": null,
+      "quality_rank": 5,
+      "cost_rank": 2,
+      "sovereignty_tier": 3,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "general",
+        "gguf",
+        "lumynax",
+        "smollm",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "192518901ec475229151f3ce654a866a47a2a6f3",
+        "package_state": "prebuilt_gguf_release",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 105454208
+      }
+    },
+    {
+      "model_id": "lumynax-infused-smollm2-17b-gguf",
+      "repo_id": "AbteeXAILab/lumynax-infused-smollm2-17b-gguf",
+      "title": "LumynaX Infused SmolLM2 1.7B Instruct GGUF",
+      "family": "smollm",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 8192,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "smollm2-1.7b-instruct-q4_k_m.gguf",
+      "active_params_b": null,
+      "total_params_b": 1.7,
+      "quality_rank": 5,
+      "cost_rank": 4,
+      "sovereignty_tier": 3,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "general",
+        "gguf",
+        "lumynax",
+        "smollm",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "b71d0ad33a3e8f2f1582ceba7520e086a665bf46",
+        "package_state": "prebuilt_gguf_release",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 1055609536
+      }
+    },
+    {
+      "model_id": "lumynax-infused-smollm2-360m-gguf",
+      "repo_id": "AbteeXAILab/lumynax-infused-smollm2-360m-gguf",
+      "title": "LumynaX Infused SmolLM2 360M Instruct GGUF",
+      "family": "smollm",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 8192,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "smollm2-360m-instruct-q8_0.gguf",
+      "active_params_b": null,
+      "total_params_b": null,
+      "quality_rank": 5,
+      "cost_rank": 2,
+      "sovereignty_tier": 3,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "general",
+        "gguf",
+        "lumynax",
+        "smollm",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "a808313b05ac18b70e2b4de03a0ddb238d545c74",
+        "package_state": "prebuilt_gguf_release",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 386404992
+      }
+    },
+    {
+      "model_id": "lumynax-infused-smollm3-3b-gguf",
+      "repo_id": "AbteeXAILab/lumynax-infused-smollm3-3b-gguf",
+      "title": "LumynaX Infused SmolLM3 3B GGUF",
+      "family": "smollm",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 8192,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "SmolLM3-Q4_K_M.gguf",
+      "active_params_b": null,
+      "total_params_b": 3.0,
+      "quality_rank": 4,
+      "cost_rank": 4,
+      "sovereignty_tier": 3,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "general",
+        "gguf",
+        "lumynax",
+        "smollm",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "3cbfc3ed26da900885f8135bfcbd4331a6c5b5b9",
+        "package_state": "prebuilt_gguf_release",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 1915305312
+      }
+    },
+    {
+      "model_id": "lumynax-infused-zephyr-7b-beta-gguf",
+      "repo_id": "AbteeXAILab/lumynax-infused-zephyr-7b-beta-gguf",
+      "title": "LumynaX Infused Zephyr 7B Beta GGUF",
+      "family": "lumynax",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 8192,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "zephyr-7b-beta.Q4_K_M.gguf",
+      "active_params_b": null,
+      "total_params_b": 7.0,
+      "quality_rank": 3,
+      "cost_rank": 6,
+      "sovereignty_tier": 3,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "general",
+        "gguf",
+        "lumynax",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "790aa3f7411fbd5b6ae8af3eedbefaf5c23c5a60",
+        "package_state": "prebuilt_gguf_release",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 4368438976
+      }
+    },
+    {
+      "model_id": "lumynax-moe-moonlight-16b-a3b-gguf",
+      "repo_id": "AbteeXAILab/lumynax-moe-moonlight-16b-a3b-gguf",
+      "title": "LumynaX MoE Moonlight 16B A3B GGUF",
+      "family": "lumynax",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 8192,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "lumynax-moe-moonlight-16b-a3b-iq4_xs.gguf",
+      "active_params_b": 3.0,
+      "total_params_b": 16.0,
+      "quality_rank": 3,
+      "cost_rank": 6,
+      "sovereignty_tier": 3,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "general",
+        "gguf",
+        "lumynax",
+        "moe",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "88926e39e3730c2d2bfe00088404fce8217c1c74",
+        "package_state": "prebuilt_gguf_release",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 8744947840
+      }
+    },
+    {
+      "model_id": "lumynax-moe-olmoe-1b-7b-gguf",
+      "repo_id": "AbteeXAILab/lumynax-moe-olmoe-1b-7b-gguf",
+      "title": "LumynaX MoE OLMoE 1B-7B Instruct GGUF",
+      "family": "olmo",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 8192,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "olmoe-1b-7b-0924-instruct-q4_k_m.gguf",
+      "active_params_b": null,
+      "total_params_b": 1.0,
+      "quality_rank": 3,
+      "cost_rank": 6,
+      "sovereignty_tier": 3,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "general",
+        "gguf",
+        "lumynax",
+        "moe",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "4515dabcc14be52616348757c7195a8bb2e490f8",
+        "package_state": "prebuilt_gguf_release",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 4213512672
+      }
+    },
+    {
+      "model_id": "lumynax-multimodal-glm46v-flash",
+      "repo_id": "AbteeXAILab/lumynax-multimodal-glm46v-flash",
+      "title": "LumynaX Multimodal GLM 4.6V Flash",
+      "family": "lumynax",
+      "runtime": "llama_cpp_multimodal",
+      "modalities": [
+        "text",
+        "image"
+      ],
+      "context_tokens": 4096,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "lumynax-multimodal-glm46v-flash-ud-iq2_m.gguf",
+      "active_params_b": null,
+      "total_params_b": null,
+      "quality_rank": 3,
+      "cost_rank": 6,
+      "sovereignty_tier": 2,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "image",
+        "lumynax",
+        "multimodal",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "3f0a751fedde7cd6a3b8a083b7bdf128c8ca3ccd",
+        "package_state": "prebuilt_gguf_release",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 5778988768
+      }
+    },
+    {
+      "model_id": "lumynax-multimodal-kimi-vl-a3b-thinking",
+      "repo_id": "AbteeXAILab/lumynax-multimodal-kimi-vl-a3b-thinking",
+      "title": "LumynaX Multimodal Kimi VL A3B Thinking",
+      "family": "kimi",
+      "runtime": "llama_cpp_multimodal",
+      "modalities": [
+        "text",
+        "image"
+      ],
+      "context_tokens": 4096,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "lumynax-multimodal-kimi-vl-a3b-thinking-q4_k_m.gguf",
+      "active_params_b": 3.0,
+      "total_params_b": 3.0,
+      "quality_rank": 3,
+      "cost_rank": 8,
+      "sovereignty_tier": 2,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "image",
+        "kimi",
+        "lumynax",
+        "multimodal",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "460182aeb56feb94262a59e274be38f3b9638188",
+        "package_state": "prebuilt_gguf_release",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 11158846304
+      }
+    },
+    {
+      "model_id": "lumynax-nz-3b",
+      "repo_id": "AbteeXAILab/lumynax-nz-3b",
+      "title": "LumynaX NZ 3B V1",
+      "family": "lumynax",
+      "runtime": "transformers",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 4096,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "merged_model/model-00001-of-00055.safetensors",
+      "active_params_b": null,
+      "total_params_b": 3.0,
+      "quality_rank": 3,
+      "cost_rank": 8,
+      "sovereignty_tier": 2,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "general",
+        "lumynax",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "190ba7e1a81e9e980a8cf44d4a9d53dedca6322c",
+        "package_state": "standalone_dense_model",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 12343804840
+      }
+    },
+    {
+      "model_id": "lumynax-nz-qwen25-coder-3b-gguf",
+      "repo_id": "AbteeXAILab/lumynax-nz-qwen25-coder-3b-gguf",
+      "title": "LumynaX NZ Qwen2.5 Coder 3B GGUF",
+      "family": "qwen",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 32768,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "lumynax-nz-qwen25-coder-3b-q4_k_m.gguf",
+      "active_params_b": null,
+      "total_params_b": 3.0,
+      "quality_rank": 4,
+      "cost_rank": 4,
+      "sovereignty_tier": 3,
+      "supports_tools": true,
+      "supports_json": true,
+      "tags": [
+        "coder",
+        "gguf",
+        "lumynax",
+        "qwen",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "b6603695131d11f937f8bd06b77985f1affd8398",
+        "package_state": "prebuilt_gguf_release",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 2104932800
+      }
+    },
+    {
+      "model_id": "lumynax-reasoning-deepseek-distill-text-gguf",
+      "repo_id": "AbteeXAILab/lumynax-reasoning-deepseek-distill-text-gguf",
+      "title": "LumynaX Reasoning DeepSeek Distill Text GGUF",
+      "family": "deepseek",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 8192,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "lumynax-reasoning-deepseek-distill-text-gguf-f16.gguf",
+      "active_params_b": null,
+      "total_params_b": null,
+      "quality_rank": 2,
+      "cost_rank": 10,
+      "sovereignty_tier": 3,
+      "supports_tools": true,
+      "supports_json": true,
+      "tags": [
+        "deepseek",
+        "gguf",
+        "lumynax",
+        "reasoning",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "ff5915ca508ffd3b6d12121a2682f8d5ff8cb7be",
+        "package_state": "base_weights_hydrated_text_gguf",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 38535825664
+      }
+    },
+    {
+      "model_id": "lumynax-reasoning-deepseek-r1-qwen-15b-gguf",
+      "repo_id": "AbteeXAILab/lumynax-reasoning-deepseek-r1-qwen-15b-gguf",
+      "title": "LumynaX Reasoning DeepSeek R1 Distill Qwen 1.5B GGUF",
+      "family": "qwen",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 8192,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "DeepSeek-R1-Distill-Qwen-1.5B-Q4_K_M.gguf",
+      "active_params_b": null,
+      "total_params_b": 1.5,
+      "quality_rank": 5,
+      "cost_rank": 4,
+      "sovereignty_tier": 3,
+      "supports_tools": true,
+      "supports_json": true,
+      "tags": [
+        "deepseek",
+        "gguf",
+        "lumynax",
+        "qwen",
+        "reasoning",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "cb2a747d711fb83c6197855046e59c56828dbbaa",
+        "package_state": "prebuilt_gguf_release",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 1117321312
+      }
+    },
+    {
+      "model_id": "lumynax-reasoning-deepseek-r1-qwen-7b-gguf",
+      "repo_id": "AbteeXAILab/lumynax-reasoning-deepseek-r1-qwen-7b-gguf",
+      "title": "LumynaX Reasoning DeepSeek R1 Distill Qwen 7B GGUF",
+      "family": "qwen",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 8192,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "DeepSeek-R1-Distill-Qwen-7B-Q4_K_M.gguf",
+      "active_params_b": null,
+      "total_params_b": 7.0,
+      "quality_rank": 3,
+      "cost_rank": 6,
+      "sovereignty_tier": 3,
+      "supports_tools": true,
+      "supports_json": true,
+      "tags": [
+        "deepseek",
+        "gguf",
+        "lumynax",
+        "qwen",
+        "reasoning",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "02dbc4451a0a26e9760f740418cf4b9796ef2aa4",
+        "package_state": "prebuilt_gguf_release",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 4683073248
+      }
+    },
+    {
+      "model_id": "lumynax-reasoning-gpt-oss-20b-gguf",
+      "repo_id": "AbteeXAILab/lumynax-reasoning-gpt-oss-20b-gguf",
+      "title": "LumynaX Reasoning GPT-OSS 20B GGUF",
+      "family": "lumynax",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 8192,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "lumynax-reasoning-gpt-oss-20b-mxfp4.gguf",
+      "active_params_b": null,
+      "total_params_b": 20.0,
+      "quality_rank": 1,
+      "cost_rank": 8,
+      "sovereignty_tier": 3,
+      "supports_tools": true,
+      "supports_json": true,
+      "tags": [
+        "gguf",
+        "lumynax",
+        "reasoning",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "3f07992371177a312240df950d91ae1b2ff57714",
+        "package_state": "prebuilt_gguf_release",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 12109566560
+      }
+    },
+    {
+      "model_id": "lumynax-reasoning-phi4-mini-gguf",
+      "repo_id": "AbteeXAILab/lumynax-reasoning-phi4-mini-gguf",
+      "title": "LumynaX Reasoning Phi-4 Mini GGUF",
+      "family": "phi",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 8192,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "Phi-4-mini-reasoning-Q4_K_M.gguf",
+      "active_params_b": null,
+      "total_params_b": null,
+      "quality_rank": 2,
+      "cost_rank": 4,
+      "sovereignty_tier": 3,
+      "supports_tools": true,
+      "supports_json": true,
+      "tags": [
+        "gguf",
+        "lumynax",
+        "phi",
+        "reasoning",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "ef04425cd19f96de197b2418a16aca6e5c868f45",
+        "package_state": "prebuilt_gguf_release",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 2491875232
+      }
+    },
+    {
+      "model_id": "lumynax-tiny",
+      "repo_id": "AbteeXAILab/lumynax-tiny",
+      "title": "LumynaX Tiny Seed V1",
+      "family": "lumynax",
+      "runtime": "transformers",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 4096,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "merged_model/model.safetensors",
+      "active_params_b": null,
+      "total_params_b": null,
+      "quality_rank": 5,
+      "cost_rank": 2,
+      "sovereignty_tier": 2,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "general",
+        "lumynax",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "c4ccf84ef0b646fbc61c83f24117aaea95225dd6",
+        "package_state": "standalone_dense_model",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 4292528
+      }
+    },
+    {
+      "model_id": "lumynax-tiny-qwen25-05b-gguf",
+      "repo_id": "AbteeXAILab/lumynax-tiny-qwen25-05b-gguf",
+      "title": "LumynaX Tiny Qwen2.5 0.5B GGUF",
+      "family": "qwen",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 32768,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "see_model_card",
+      "quantization": "see_release_manifest",
+      "primary_artifact": "lumynax-tiny-qwen25-05b-q4_k_m.gguf",
+      "active_params_b": null,
+      "total_params_b": 0.5,
+      "quality_rank": 5,
+      "cost_rank": 2,
+      "sovereignty_tier": 3,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "general",
+        "gguf",
+        "lumynax",
+        "qwen",
+        "text"
+      ],
+      "metadata": {
+        "hub_sha": "01266863890302b1d1f42bddfda1ff7146386359",
+        "package_state": "prebuilt_gguf_release",
+        "public_status": "public and non-gated",
+        "validation_status": "pass",
+        "total_weight_size": 491400032
+      }
+    },
+    {
+      "model_id": "lumynax-frontier-qwen3-235b-a22b-instruct",
+      "repo_id": "AbteeXAILab/lumynax-frontier-qwen3-235b-a22b-instruct",
+      "title": "LumynaX Frontier Qwen3 235B A22B Instruct",
+      "family": "qwen",
+      "runtime": "transformers",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 262144,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ",
+        "AU",
+        "global"
+      ],
+      "license_id": "apache-2.0",
+      "quantization": "bf16 / fp8 / Q4_K_M (community GGUF)",
+      "primary_artifact": "model.safetensors (sharded)",
+      "active_params_b": 22,
+      "total_params_b": 235,
+      "quality_rank": 1,
+      "cost_rank": 5,
+      "sovereignty_tier": 2,
+      "supports_tools": true,
+      "supports_json": true,
+      "tags": [
+        "frontier",
+        "moe",
+        "reasoning",
+        "qwen3",
+        "tools",
+        "json",
+        "long-context"
+      ],
+      "metadata": {
+        "upstream_repo": "Qwen/Qwen3-235B-A22B-Instruct-2507",
+        "release_version": "v0.1.0",
+        "package_state": "scaffold_pulls_upstream",
+        "public_status": "public and non-gated",
+        "validation_status": "scaffold_verified"
+      }
+    },
+    {
+      "model_id": "lumynax-frontier-minimax-m2-230b",
+      "repo_id": "AbteeXAILab/lumynax-frontier-minimax-m2-230b",
+      "title": "LumynaX Frontier MiniMax M2 230B Agentic",
+      "family": "minimax",
+      "runtime": "transformers",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 204800,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ",
+        "AU",
+        "global"
+      ],
+      "license_id": "other",
+      "quantization": "bf16 / Q4_K_M (community GGUF)",
+      "primary_artifact": "model.safetensors (sharded)",
+      "active_params_b": 10,
+      "total_params_b": 230,
+      "quality_rank": 1,
+      "cost_rank": 5,
+      "sovereignty_tier": 2,
+      "supports_tools": true,
+      "supports_json": true,
+      "tags": [
+        "frontier",
+        "moe",
+        "agentic",
+        "minimax",
+        "tools",
+        "json"
+      ],
+      "metadata": {
+        "upstream_repo": "MiniMaxAI/MiniMax-M2",
+        "release_version": "v0.1.0",
+        "package_state": "scaffold_pulls_upstream",
+        "public_status": "public and non-gated",
+        "validation_status": "scaffold_verified"
+      }
+    },
+    {
+      "model_id": "lumynax-frontier-mixtral-8x22b-instruct-gguf",
+      "repo_id": "AbteeXAILab/lumynax-frontier-mixtral-8x22b-instruct-gguf",
+      "title": "LumynaX Frontier Mixtral 8x22B Instruct GGUF",
+      "family": "mistral",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 65536,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "apache-2.0",
+      "quantization": "Q4_K_M (default) \u00b7 Q5_K_M \u00b7 Q8_0",
+      "primary_artifact": "Mixtral-8x22B-Instruct-v0.1.Q4_K_M.gguf",
+      "active_params_b": 39,
+      "total_params_b": 141,
+      "quality_rank": 2,
+      "cost_rank": 4,
+      "sovereignty_tier": 3,
+      "supports_tools": true,
+      "supports_json": true,
+      "tags": [
+        "frontier",
+        "moe",
+        "mixtral",
+        "gguf",
+        "llama-cpp",
+        "tools"
+      ],
+      "metadata": {
+        "upstream_repo": "mistralai/Mixtral-8x22B-Instruct-v0.1",
+        "release_version": "v0.1.0",
+        "package_state": "scaffold_pulls_upstream_gguf",
+        "public_status": "public and non-gated",
+        "validation_status": "scaffold_verified"
+      }
+    },
+    {
+      "model_id": "lumynax-frontier-dbrx-instruct-132b-gguf",
+      "repo_id": "AbteeXAILab/lumynax-frontier-dbrx-instruct-132b-gguf",
+      "title": "LumynaX Frontier DBRX Instruct 132B GGUF",
+      "family": "dbrx",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 32768,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "other",
+      "quantization": "Q4_K_M (default) \u00b7 Q5_K_M \u00b7 Q8_0",
+      "primary_artifact": "dbrx-instruct.Q4_K_M.gguf",
+      "active_params_b": 36,
+      "total_params_b": 132,
+      "quality_rank": 2,
+      "cost_rank": 4,
+      "sovereignty_tier": 3,
+      "supports_tools": true,
+      "supports_json": true,
+      "tags": [
+        "frontier",
+        "moe",
+        "dbrx",
+        "databricks",
+        "gguf",
+        "llama-cpp"
+      ],
+      "metadata": {
+        "upstream_repo": "databricks/dbrx-instruct",
+        "release_version": "v0.1.0",
+        "package_state": "scaffold_pulls_upstream_gguf",
+        "public_status": "public and non-gated",
+        "validation_status": "scaffold_verified"
+      }
+    },
+    {
+      "model_id": "lumynax-multimodal-qwen25-vl-72b-instruct-gguf",
+      "repo_id": "AbteeXAILab/lumynax-multimodal-qwen25-vl-72b-instruct-gguf",
+      "title": "LumynaX Multimodal Qwen2.5 VL 72B Instruct GGUF",
+      "family": "qwen",
+      "runtime": "llama_cpp_multimodal",
+      "modalities": [
+        "text",
+        "vision"
+      ],
+      "context_tokens": 131072,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "other",
+      "quantization": "Q4_K_M (default) \u00b7 Q5_K_M \u00b7 Q8_0",
+      "primary_artifact": "Qwen2.5-VL-72B-Instruct-Q4_K_M.gguf",
+      "active_params_b": null,
+      "total_params_b": 72,
+      "quality_rank": 2,
+      "cost_rank": 4,
+      "sovereignty_tier": 3,
+      "supports_tools": true,
+      "supports_json": true,
+      "tags": [
+        "multimodal",
+        "vision",
+        "qwen",
+        "gguf",
+        "llama-cpp",
+        "image-text-to-text"
+      ],
+      "metadata": {
+        "upstream_repo": "Qwen/Qwen2.5-VL-72B-Instruct",
+        "release_version": "v0.1.0",
+        "package_state": "scaffold_pulls_upstream_gguf",
+        "public_status": "public and non-gated",
+        "validation_status": "scaffold_verified"
+      }
+    },
+    {
+      "model_id": "lumynax-multimodal-pixtral-large-124b",
+      "repo_id": "AbteeXAILab/lumynax-multimodal-pixtral-large-124b",
+      "title": "LumynaX Multimodal Pixtral Large 124B",
+      "family": "mistral",
+      "runtime": "transformers_multimodal",
+      "modalities": [
+        "text",
+        "vision"
+      ],
+      "context_tokens": 131072,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ",
+        "AU"
+      ],
+      "license_id": "other",
+      "quantization": "bf16 / fp8",
+      "primary_artifact": "model.safetensors (sharded)",
+      "active_params_b": null,
+      "total_params_b": 124,
+      "quality_rank": 2,
+      "cost_rank": 5,
+      "sovereignty_tier": 2,
+      "supports_tools": true,
+      "supports_json": true,
+      "tags": [
+        "multimodal",
+        "vision",
+        "pixtral",
+        "mistral",
+        "image-text-to-text"
+      ],
+      "metadata": {
+        "upstream_repo": "mistralai/Pixtral-Large-Instruct-2411",
+        "release_version": "v0.1.0",
+        "package_state": "scaffold_pulls_upstream",
+        "public_status": "public (Mistral research licence \u2014 non-commercial use)",
+        "validation_status": "scaffold_verified"
+      }
+    },
+    {
+      "model_id": "lumynax-reasoning-glm46-355b-moe",
+      "repo_id": "AbteeXAILab/lumynax-reasoning-glm46-355b-moe",
+      "title": "LumynaX Reasoning GLM-4.6 355B MoE",
+      "family": "glm",
+      "runtime": "transformers",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 204800,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ",
+        "AU",
+        "global"
+      ],
+      "license_id": "mit",
+      "quantization": "bf16 / fp8 / Q4_K_M (community)",
+      "primary_artifact": "model.safetensors (sharded)",
+      "active_params_b": 32,
+      "total_params_b": 355,
+      "quality_rank": 1,
+      "cost_rank": 5,
+      "sovereignty_tier": 2,
+      "supports_tools": true,
+      "supports_json": true,
+      "tags": [
+        "frontier",
+        "reasoning",
+        "moe",
+        "glm",
+        "tools",
+        "long-context"
+      ],
+      "metadata": {
+        "upstream_repo": "zai-org/GLM-4.6",
+        "release_version": "v0.1.0",
+        "package_state": "scaffold_pulls_upstream",
+        "public_status": "public and non-gated",
+        "validation_status": "scaffold_verified"
+      }
+    },
+    {
+      "model_id": "lumynax-multimodal-internvl3-78b-instruct",
+      "repo_id": "AbteeXAILab/lumynax-multimodal-internvl3-78b-instruct",
+      "title": "LumynaX Multimodal InternVL3 78B Instruct",
+      "family": "internvl",
+      "runtime": "transformers_multimodal",
+      "modalities": [
+        "text",
+        "vision"
+      ],
+      "context_tokens": 32768,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ",
+        "AU",
+        "global"
+      ],
+      "license_id": "mit",
+      "quantization": "bf16 (safetensors mirror) \u2014 community GGUF when available",
+      "primary_artifact": "model.safetensors (33 shards)",
+      "active_params_b": null,
+      "total_params_b": 78,
+      "quality_rank": 2,
+      "cost_rank": 4,
+      "sovereignty_tier": 2,
+      "supports_tools": true,
+      "supports_json": true,
+      "tags": [
+        "multimodal",
+        "vision",
+        "internvl",
+        "opengvlab",
+        "image-text-to-text"
+      ],
+      "metadata": {
+        "upstream_repo": "OpenGVLab/InternVL3-78B-Instruct",
+        "release_version": "v0.1.0",
+        "package_state": "weights_mirrored_safetensors",
+        "public_status": "public and non-gated",
+        "validation_status": "scaffold_verified"
+      }
+    },
+    {
+      "model_id": "lumynax-speech-whisper-large-v3-turbo",
+      "repo_id": "AbteeXAILab/lumynax-speech-whisper-large-v3-turbo",
+      "title": "LumynaX Speech Whisper Large v3 Turbo",
+      "family": "whisper",
+      "runtime": "transformers",
+      "modalities": [
+        "audio"
+      ],
+      "context_tokens": 30,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ",
+        "AU",
+        "global"
+      ],
+      "license_id": "mit",
+      "quantization": "fp16 safetensors",
+      "primary_artifact": "model.safetensors",
+      "active_params_b": null,
+      "total_params_b": 0.8,
+      "quality_rank": 1,
+      "cost_rank": 2,
+      "sovereignty_tier": 3,
+      "supports_tools": false,
+      "supports_json": false,
+      "tags": [
+        "asr",
+        "speech",
+        "whisper",
+        "audio"
+      ],
+      "metadata": {
+        "upstream_repo": "openai/whisper-large-v3-turbo",
+        "release_version": "v0.1.0",
+        "package_state": "weights_mirrored",
+        "public_status": "public and non-gated",
+        "validation_status": "scaffold_verified"
+      }
+    },
+    {
+      "model_id": "lumynax-speech-kokoro-82m-tts",
+      "repo_id": "AbteeXAILab/lumynax-speech-kokoro-82m-tts",
+      "title": "LumynaX Speech Kokoro 82M TTS",
+      "family": "kokoro",
+      "runtime": "transformers",
+      "modalities": [
+        "text",
+        "audio"
+      ],
+      "context_tokens": 510,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ",
+        "AU",
+        "global"
+      ],
+      "license_id": "apache-2.0",
+      "quantization": "fp32 (small)",
+      "primary_artifact": "kokoro-v1_0.pth",
+      "active_params_b": null,
+      "total_params_b": 0.082,
+      "quality_rank": 1,
+      "cost_rank": 1,
+      "sovereignty_tier": 3,
+      "supports_tools": false,
+      "supports_json": false,
+      "tags": [
+        "tts",
+        "speech",
+        "kokoro",
+        "audio"
+      ],
+      "metadata": {
+        "upstream_repo": "hexgrad/Kokoro-82M",
+        "release_version": "v0.1.0",
+        "package_state": "weights_mirrored",
+        "public_status": "public and non-gated",
+        "validation_status": "scaffold_verified"
+      }
+    },
+    {
+      "model_id": "lumynax-reranker-bge-v2-m3",
+      "repo_id": "AbteeXAILab/lumynax-reranker-bge-v2-m3",
+      "title": "LumynaX Reranker BGE v2 M3",
+      "family": "bge",
+      "runtime": "transformers",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 8192,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ",
+        "AU",
+        "global"
+      ],
+      "license_id": "mit",
+      "quantization": "fp32 safetensors",
+      "primary_artifact": "model.safetensors",
+      "active_params_b": null,
+      "total_params_b": 0.568,
+      "quality_rank": 1,
+      "cost_rank": 1,
+      "sovereignty_tier": 3,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "reranker",
+        "retrieval",
+        "bge",
+        "embedding-companion"
+      ],
+      "metadata": {
+        "upstream_repo": "BAAI/bge-reranker-v2-m3",
+        "release_version": "v0.1.0",
+        "package_state": "weights_mirrored",
+        "public_status": "public and non-gated",
+        "validation_status": "scaffold_verified"
+      }
+    },
+    {
+      "model_id": "lumynax-guard-text-moderation",
+      "repo_id": "AbteeXAILab/lumynax-guard-text-moderation",
+      "title": "LumynaX Guard Text Moderation",
+      "family": "roberta",
+      "runtime": "transformers",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 512,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ",
+        "AU",
+        "global"
+      ],
+      "license_id": "mit",
+      "quantization": "fp32 safetensors",
+      "primary_artifact": "model.safetensors",
+      "active_params_b": null,
+      "total_params_b": 0.279,
+      "quality_rank": 2,
+      "cost_rank": 1,
+      "sovereignty_tier": 3,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "safety",
+        "moderation",
+        "classifier",
+        "guardrail"
+      ],
+      "metadata": {
+        "upstream_repo": "KoalaAI/Text-Moderation",
+        "release_version": "v0.1.0",
+        "package_state": "weights_mirrored",
+        "public_status": "public and non-gated",
+        "validation_status": "scaffold_verified"
+      }
+    },
+    {
+      "model_id": "lumynax-math-qwen25-math-7b-gguf",
+      "repo_id": "AbteeXAILab/lumynax-math-qwen25-math-7b-gguf",
+      "title": "LumynaX Math Qwen2.5 Math 7B GGUF",
+      "family": "qwen",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 4096,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "apache-2.0",
+      "quantization": "Q4_K_M GGUF",
+      "primary_artifact": "Qwen2.5-Math-7B-Instruct-Q4_K_M.gguf",
+      "active_params_b": null,
+      "total_params_b": 7,
+      "quality_rank": 2,
+      "cost_rank": 2,
+      "sovereignty_tier": 3,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "math",
+        "reasoning",
+        "qwen",
+        "gguf"
+      ],
+      "metadata": {
+        "upstream_repo": "Qwen/Qwen2.5-Math-7B-Instruct",
+        "release_version": "v0.1.0",
+        "package_state": "weights_mirrored",
+        "public_status": "public and non-gated",
+        "validation_status": "scaffold_verified"
+      }
+    },
+    {
+      "model_id": "lumynax-translate-nllb-200-3b",
+      "repo_id": "AbteeXAILab/lumynax-translate-nllb-200-3b",
+      "title": "LumynaX Translate NLLB-200 3.3B",
+      "family": "nllb",
+      "runtime": "transformers",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 1024,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ",
+        "AU",
+        "global"
+      ],
+      "license_id": "cc-by-nc-4.0",
+      "quantization": "fp32 safetensors",
+      "primary_artifact": "model.safetensors",
+      "active_params_b": null,
+      "total_params_b": 3.3,
+      "quality_rank": 2,
+      "cost_rank": 3,
+      "sovereignty_tier": 3,
+      "supports_tools": false,
+      "supports_json": false,
+      "tags": [
+        "translation",
+        "nllb",
+        "te-reo",
+        "aotearoa",
+        "languages"
+      ],
+      "metadata": {
+        "upstream_repo": "facebook/nllb-200-3.3B",
+        "release_version": "v0.1.0",
+        "package_state": "weights_mirrored",
+        "public_status": "public and non-gated",
+        "validation_status": "scaffold_verified"
+      }
+    },
+    {
+      "model_id": "lumynax-coder-deepseek-v2-lite-16b-gguf",
+      "repo_id": "AbteeXAILab/lumynax-coder-deepseek-v2-lite-16b-gguf",
+      "title": "LumynaX Coder DeepSeek-Coder V2 Lite 16B GGUF",
+      "family": "deepseek",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 163840,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "other",
+      "quantization": "Q4_K_M GGUF",
+      "primary_artifact": "DeepSeek-Coder-V2-Lite-Instruct-Q4_K_M.gguf",
+      "active_params_b": 2.4,
+      "total_params_b": 16,
+      "quality_rank": 2,
+      "cost_rank": 2,
+      "sovereignty_tier": 3,
+      "supports_tools": true,
+      "supports_json": true,
+      "tags": [
+        "coder",
+        "moe",
+        "deepseek",
+        "gguf",
+        "long-context"
+      ],
+      "metadata": {
+        "upstream_repo": "deepseek-ai/DeepSeek-Coder-V2-Lite-Instruct",
+        "release_version": "v0.1.0",
+        "package_state": "weights_mirrored",
+        "public_status": "public and non-gated",
+        "validation_status": "scaffold_verified"
+      }
+    },
+    {
+      "model_id": "lumynax-chat-hermes-3-llama31-8b-gguf",
+      "repo_id": "AbteeXAILab/lumynax-chat-hermes-3-llama31-8b-gguf",
+      "title": "LumynaX Chat Hermes-3 Llama-3.1 8B GGUF",
+      "family": "llama",
+      "runtime": "llama_cpp",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 131072,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ"
+      ],
+      "license_id": "llama3.1",
+      "quantization": "Q4_K_M GGUF",
+      "primary_artifact": "Hermes-3-Llama-3.1-8B-Q4_K_M.gguf",
+      "active_params_b": null,
+      "total_params_b": 8,
+      "quality_rank": 2,
+      "cost_rank": 2,
+      "sovereignty_tier": 3,
+      "supports_tools": true,
+      "supports_json": true,
+      "tags": [
+        "chat",
+        "hermes",
+        "llama",
+        "gguf",
+        "tools",
+        "function-calling"
+      ],
+      "metadata": {
+        "upstream_repo": "NousResearch/Hermes-3-Llama-3.1-8B",
+        "release_version": "v0.1.0",
+        "package_state": "weights_mirrored",
+        "public_status": "public and non-gated",
+        "validation_status": "scaffold_verified"
+      }
+    },
+    {
+      "model_id": "lumynax-doc-nougat-base",
+      "repo_id": "AbteeXAILab/lumynax-doc-nougat-base",
+      "title": "LumynaX Doc Nougat Base (academic PDF -> markdown)",
+      "family": "nougat",
+      "runtime": "transformers",
+      "modalities": [
+        "text",
+        "vision"
+      ],
+      "context_tokens": 4096,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ",
+        "AU",
+        "global"
+      ],
+      "license_id": "cc-by-4.0",
+      "quantization": "fp32 safetensors",
+      "primary_artifact": "model.safetensors",
+      "active_params_b": null,
+      "total_params_b": 0.35,
+      "quality_rank": 2,
+      "cost_rank": 1,
+      "sovereignty_tier": 3,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "doc-ai",
+        "ocr",
+        "nougat",
+        "pdf",
+        "markdown"
+      ],
+      "metadata": {
+        "upstream_repo": "facebook/nougat-base",
+        "release_version": "v0.1.0",
+        "package_state": "weights_mirrored",
+        "public_status": "public and non-gated",
+        "validation_status": "scaffold_verified"
+      }
+    },
+    {
+      "model_id": "lumynax-doc-donut-base",
+      "repo_id": "AbteeXAILab/lumynax-doc-donut-base",
+      "title": "LumynaX Doc Donut Base (document understanding)",
+      "family": "donut",
+      "runtime": "transformers",
+      "modalities": [
+        "text",
+        "vision"
+      ],
+      "context_tokens": 1536,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ",
+        "AU",
+        "global"
+      ],
+      "license_id": "mit",
+      "quantization": "fp32 safetensors",
+      "primary_artifact": "model.safetensors",
+      "active_params_b": null,
+      "total_params_b": 0.2,
+      "quality_rank": 2,
+      "cost_rank": 1,
+      "sovereignty_tier": 3,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "doc-ai",
+        "donut",
+        "document-vqa"
+      ],
+      "metadata": {
+        "upstream_repo": "naver-clova-ix/donut-base",
+        "release_version": "v0.1.0",
+        "package_state": "weights_mirrored",
+        "public_status": "public and non-gated",
+        "validation_status": "scaffold_verified"
+      }
+    },
+    {
+      "model_id": "lumynax-ocr-trocr-large-printed",
+      "repo_id": "AbteeXAILab/lumynax-ocr-trocr-large-printed",
+      "title": "LumynaX OCR TrOCR Large Printed",
+      "family": "trocr",
+      "runtime": "transformers",
+      "modalities": [
+        "text",
+        "vision"
+      ],
+      "context_tokens": 512,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ",
+        "AU",
+        "global"
+      ],
+      "license_id": "mit",
+      "quantization": "fp32 safetensors",
+      "primary_artifact": "model.safetensors",
+      "active_params_b": null,
+      "total_params_b": 0.55,
+      "quality_rank": 2,
+      "cost_rank": 2,
+      "sovereignty_tier": 3,
+      "supports_tools": false,
+      "supports_json": false,
+      "tags": [
+        "ocr",
+        "printed",
+        "trocr"
+      ],
+      "metadata": {
+        "upstream_repo": "microsoft/trocr-large-printed",
+        "release_version": "v0.1.0",
+        "package_state": "weights_mirrored",
+        "public_status": "public and non-gated",
+        "validation_status": "scaffold_verified"
+      }
+    },
+    {
+      "model_id": "lumynax-ocr-trocr-large-handwritten",
+      "repo_id": "AbteeXAILab/lumynax-ocr-trocr-large-handwritten",
+      "title": "LumynaX OCR TrOCR Large Handwritten",
+      "family": "trocr",
+      "runtime": "transformers",
+      "modalities": [
+        "text",
+        "vision"
+      ],
+      "context_tokens": 512,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ",
+        "AU",
+        "global"
+      ],
+      "license_id": "mit",
+      "quantization": "fp32 safetensors",
+      "primary_artifact": "model.safetensors",
+      "active_params_b": null,
+      "total_params_b": 0.55,
+      "quality_rank": 2,
+      "cost_rank": 2,
+      "sovereignty_tier": 3,
+      "supports_tools": false,
+      "supports_json": false,
+      "tags": [
+        "ocr",
+        "handwritten",
+        "trocr"
+      ],
+      "metadata": {
+        "upstream_repo": "microsoft/trocr-large-handwritten",
+        "release_version": "v0.1.0",
+        "package_state": "weights_mirrored",
+        "public_status": "public and non-gated",
+        "validation_status": "scaffold_verified"
+      }
+    },
+    {
+      "model_id": "lumynax-doc-layoutlmv3-base",
+      "repo_id": "AbteeXAILab/lumynax-doc-layoutlmv3-base",
+      "title": "LumynaX Doc LayoutLMv3 Base (document layout+text)",
+      "family": "layoutlm",
+      "runtime": "transformers",
+      "modalities": [
+        "text",
+        "vision"
+      ],
+      "context_tokens": 512,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ",
+        "AU",
+        "global"
+      ],
+      "license_id": "cc-by-nc-4.0",
+      "quantization": "fp32 safetensors",
+      "primary_artifact": "model.safetensors",
+      "active_params_b": null,
+      "total_params_b": 0.13,
+      "quality_rank": 2,
+      "cost_rank": 1,
+      "sovereignty_tier": 3,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "doc-ai",
+        "layout",
+        "layoutlm"
+      ],
+      "metadata": {
+        "upstream_repo": "microsoft/layoutlmv3-base",
+        "release_version": "v0.1.0",
+        "package_state": "weights_mirrored",
+        "public_status": "public and non-gated",
+        "validation_status": "scaffold_verified"
+      }
+    },
+    {
+      "model_id": "lumynax-doc-table-transformer-detection",
+      "repo_id": "AbteeXAILab/lumynax-doc-table-transformer-detection",
+      "title": "LumynaX Doc Table Transformer (detection)",
+      "family": "table-transformer",
+      "runtime": "transformers",
+      "modalities": [
+        "vision"
+      ],
+      "context_tokens": 0,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ",
+        "AU",
+        "global"
+      ],
+      "license_id": "mit",
+      "quantization": "fp32 safetensors",
+      "primary_artifact": "model.safetensors",
+      "active_params_b": null,
+      "total_params_b": 0.029,
+      "quality_rank": 2,
+      "cost_rank": 1,
+      "sovereignty_tier": 3,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "doc-ai",
+        "tables",
+        "detection",
+        "detr"
+      ],
+      "metadata": {
+        "upstream_repo": "microsoft/table-transformer-detection",
+        "release_version": "v0.1.0",
+        "package_state": "weights_mirrored",
+        "public_status": "public and non-gated",
+        "validation_status": "scaffold_verified"
+      }
+    },
+    {
+      "model_id": "lumynax-embed-nomic-v2-moe",
+      "repo_id": "AbteeXAILab/lumynax-embed-nomic-v2-moe",
+      "title": "LumynaX Embed Nomic v2 MoE (modern retrieval)",
+      "family": "nomic",
+      "runtime": "python_embedding",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 512,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ",
+        "AU",
+        "global"
+      ],
+      "license_id": "apache-2.0",
+      "quantization": "fp32 safetensors",
+      "primary_artifact": "model.safetensors",
+      "active_params_b": 0.305,
+      "total_params_b": 0.475,
+      "quality_rank": 1,
+      "cost_rank": 1,
+      "sovereignty_tier": 3,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "embedding",
+        "retrieval",
+        "nomic",
+        "moe",
+        "modern"
+      ],
+      "metadata": {
+        "upstream_repo": "nomic-ai/nomic-embed-text-v2-moe",
+        "release_version": "v0.1.0",
+        "package_state": "weights_mirrored",
+        "public_status": "public and non-gated",
+        "validation_status": "scaffold_verified"
+      }
+    },
+    {
+      "model_id": "lumynax-embed-granite-278m-multilingual",
+      "repo_id": "AbteeXAILab/lumynax-embed-granite-278m-multilingual",
+      "title": "LumynaX Embed IBM Granite 278M Multilingual",
+      "family": "granite",
+      "runtime": "python_embedding",
+      "modalities": [
+        "text"
+      ],
+      "context_tokens": 512,
+      "jurisdiction": "NZ",
+      "residency": [
+        "NZ",
+        "AU",
+        "global"
+      ],
+      "license_id": "apache-2.0",
+      "quantization": "fp32 safetensors",
+      "primary_artifact": "model.safetensors",
+      "active_params_b": null,
+      "total_params_b": 0.278,
+      "quality_rank": 2,
+      "cost_rank": 1,
+      "sovereignty_tier": 3,
+      "supports_tools": false,
+      "supports_json": true,
+      "tags": [
+        "embedding",
+        "retrieval",
+        "granite",
+        "multilingual",
+        "ibm"
+      ],
+      "metadata": {
+        "upstream_repo": "ibm-granite/granite-embedding-278m-multilingual",
+        "release_version": "v0.1.0",
+        "package_state": "weights_mirrored",
+        "public_status": "public and non-gated",
+        "validation_status": "scaffold_verified"
+      }
+    }
+  ]
+}

configs/provider_aliases.yaml

@@ -0,0 +1,30 @@
+provider_id: abteex-marama
+base_path: /v1
+default_model_alias: lumynax/auto
+aliases:
+  lumynax/auto:
+    task_type: general
+    requires_local: true
+    description: Select the best resident LumynaX model for the request.
+  lumynax/code:
+    task_type: code
+    requires_local: true
+    requires_json: true
+    description: Prefer coder-tagged LumynaX models with tool and JSON support.
+  lumynax/reasoning:
+    task_type: reasoning
+    requires_local: true
+    description: Prefer reasoning-tagged models inside residency constraints.
+  lumynax/multimodal:
+    task_type: multimodal
+    requires_local: false
+    description: Prefer text-plus-image LumynaX models when policy allows.
+default_route:
+  jurisdiction: NZ
+  data_sensitivity: internal
+  min_context_tokens: 4096
+  max_fallbacks: 3
+telemetry:
+  retain_prompt_by_default: false
+  retain_route_decision_days: 365
+  hash_request_payload: true

configs/routing_policy.yaml

@@ -0,0 +1,20 @@
+policy_id: lumynax-marama-route-default-v0
+default_jurisdiction: NZ
+default_requires_local: true
+high_sensitivity:
+  - personal
+  - restricted
+  - health
+  - iwi
+  - taonga
+required_for_high_sensitivity:
+  min_sovereignty_tier: 2
+  residency_must_match_request_jurisdiction: true
+  retain_prompt_by_default: false
+preferred_runtimes:
+  - llama_cpp
+  - transformers_multimodal
+  - python_embedding
+fallbacks:
+  max_default_fallbacks: 3
+  include_rejection_reasons: true

examples/capsule.personal-sovereignty-profile.json

@@ -0,0 +1,45 @@
+{
+  "capsule_id": "cap-personal-profile-001",
+  "subject_id": "operator-local-profile",
+  "jurisdiction": "NZ",
+  "sensitivity": "personal",
+  "allowed_purposes": [
+    "personal_memory",
+    "coding_assistance",
+    "inference"
+  ],
+  "denied_purposes": [
+    "ad_training",
+    "third_party_resale",
+    "public_leaderboard"
+  ],
+  "resident_regions": [
+    "NZ"
+  ],
+  "data_classes": [
+    "personal",
+    "preferences",
+    "source_code",
+    "runtime_logs"
+  ],
+  "retention_days": 7,
+  "export_allowed": false,
+  "training_allowed": false,
+  "personal_detail_level": "pseudonymous",
+  "consent_scopes": [
+    "personal_memory",
+    "coding_assistance"
+  ],
+  "data_subject_rights": [
+    "access",
+    "correction",
+    "deletion_request",
+    "processing_objection"
+  ],
+  "schema_context": "https://schema.org",
+  "consent_record": "local-profile-consent-v0",
+  "metadata": {
+    "storage": "local_encrypted_profile_store",
+    "prompt_rule": "summarise preferences without exposing raw personal notes"
+  }
+}

examples/opencode.marama-route.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://opencode.ai/config.json",
+  "provider": {
+    "abteex-marama": {
+      "npm": "@ai-sdk/openai-compatible",
+      "name": "AbteeX MaramaRoute",
+      "options": {
+        "baseURL": "http://127.0.0.1:8787/v1",
+        "apiKey": "{env:ABTEEX_MARAMA_API_KEY}",
+        "headers": {
+          "X-AbteeX-Tenant": "{env:ABTEEX_TENANT_ID}",
+          "X-AbteeX-Workspace-Capsule": "{env:SOVEREIGNCODE_CAPSULE_ID}"
+        }
+      },
+      "models": {
+        "lumynax/auto": {
+          "name": "LumynaX Auto Sovereign Route"
+        },
+        "lumynax/code": {
+          "name": "LumynaX Code Route"
+        },
+        "lumynax/reasoning": {
+          "name": "LumynaX Reasoning Route"
+        }
+      }
+    }
+  }
+}

examples/request.code-restricted.json

@@ -0,0 +1,14 @@
+{
+  "prompt": "Refactor this private Python service and explain the diff.",
+  "task_type": "code",
+  "modalities": [
+    "text"
+  ],
+  "jurisdiction": "NZ",
+  "data_sensitivity": "restricted",
+  "min_context_tokens": 4096,
+  "requires_local": true,
+  "requires_tools": false,
+  "requires_json": true,
+  "max_fallbacks": 3
+}

examples/request.openai-chat-code.json

@@ -0,0 +1,44 @@
+{
+  "model": "lumynax/code",
+  "messages": [
+    {
+      "role": "system",
+      "content": "You are a governed coding assistant for a New Zealand workspace."
+    },
+    {
+      "role": "user",
+      "content": "Refactor this private Python repository function and return a JSON diff plan."
+    }
+  ],
+  "response_format": {
+    "type": "json_object"
+  },
+  "tools": [
+    {
+      "type": "function",
+      "function": {
+        "name": "propose_patch",
+        "description": "Propose a patch without writing it.",
+        "parameters": {
+          "type": "object",
+          "properties": {
+            "files": {
+              "type": "array",
+              "items": { "type": "string" }
+            }
+          }
+        }
+      }
+    }
+  ],
+  "route": {
+    "jurisdiction": "NZ",
+    "data_sensitivity": "restricted",
+    "task_type": "code",
+    "requires_local": true,
+    "requires_tools": true,
+    "requires_json": true,
+    "min_context_tokens": 4096,
+    "max_fallbacks": 3
+  }
+}

examples/request.personal-memory-read.json

@@ -0,0 +1,19 @@
+{
+  "actor": "developer",
+  "purpose": "personal_memory",
+  "action": "read_context",
+  "region": "NZ",
+  "model_id": "local/lumynax",
+  "data_classes": [
+    "personal",
+    "preferences"
+  ],
+  "tool_name": "personal_profile_reader",
+  "writes_files": false,
+  "exports_data": false,
+  "trains_model": false,
+  "human_approved": false,
+  "personal_detail_level": "pseudonymous",
+  "consent_scope": "personal_memory",
+  "requested_retention_days": 7
+}

integrations/opencode-compatible-provider.md

@@ -0,0 +1,96 @@
+# OpenCode-Compatible Provider Integration
+
+## Goal
+
+Make AbteeX SovereignCode usable from OpenCode and similar coding agents without
+requiring those tools to understand Data Capsules directly.
+
+The integration shape is:
+
+```text
+OpenCode
+  -> OpenAI-compatible provider config
+  -> MaramaRoute gateway `/v1`
+  -> SovereignCode policy and tool broker
+  -> LumynaX model runtime
+```
+
+## Current Compatibility Target
+
+OpenCode supports custom OpenAI-compatible providers through
+`@ai-sdk/openai-compatible` and a provider `baseURL`. OpenRouter exposes an
+OpenAI-like chat endpoint at `/api/v1/chat/completions`, with normalized request
+and response payloads. MaramaRoute should therefore expose:
+
+- `GET /v1/models`
+- `POST /v1/chat/completions`
+- `POST /v1/route`
+- `GET /v1/route/{decision_id}`
+
+References checked on 2026-05-17:
+
+- https://opencode.ai/docs/providers
+- https://openrouter.ai/docs/api-reference/overview/
+- https://openrouter.ai/docs/api-reference/chat-completion
+
+## OpenCode Provider Config
+
+Use `examples/opencode.marama-route.json` as the project-local provider file.
+
+The important fields are:
+
+| Field | Value |
+| --- | --- |
+| `provider.abteex-marama.npm` | `@ai-sdk/openai-compatible` |
+| `provider.abteex-marama.options.baseURL` | Local or hosted MaramaRoute `/v1` URL |
+| `provider.abteex-marama.options.apiKey` | Environment backed key |
+| `provider.abteex-marama.models` | LumynaX model aliases exposed by MaramaRoute |
+
+## SovereignCode Responsibilities
+
+OpenCode sends a normal chat request. SovereignCode and MaramaRoute add:
+
+- capsule resolution from workspace policy files
+- purpose and personal-detail checks before prompt assembly
+- model routing based on residency, modality, task, and sensitivity
+- visible approval gates before file writes, shell commands, network export, or commit
+- audit records for policy decisions and route decisions
+
+## Workspace Files
+
+A governed workspace should carry:
+
+```text
+.sovereigncode/
+  capsule.json
+  tenant-policy.yaml
+  approvals/
+  audit/
+opencode.json
+```
+
+The agent can start with `capsule.json` and `opencode.json`. The full tool
+broker can add approvals and audit persistence in the next build stage.
+
+## Minimum Viable Flow
+
+1. User opens a project in OpenCode.
+2. OpenCode uses the `abteex-marama` provider.
+3. MaramaRoute dry-runs the chat payload and selects a LumynaX model.
+4. SovereignCode checks the workspace Data Capsule before exposing context.
+5. The coding agent proposes a plan.
+6. File writes require a visible diff and an audit record.
+7. Shell, network, commit, and publish actions require explicit approval.
+
+## Similar Clients
+
+Any client that can point at an OpenAI-compatible endpoint should use the same
+gateway:
+
+| Client type | Expected integration |
+| --- | --- |
+| OpenCode | `opencode.json` custom provider |
+| Continue-style IDE assistant | OpenAI-compatible base URL and model ids |
+| Aider-style terminal assistant | OpenAI-compatible base URL and key |
+| Internal agent runner | Direct `/v1/route` and `/v1/chat/completions` calls |
+| Browser console | Same API behind tenant auth |

marama_route/__init__.py

@@ -0,0 +1,22 @@
+from __future__ import annotations
+
+from .gateway import (
+    build_chat_route_response,
+    build_models_response,
+    route_chat_payload,
+    routing_request_from_chat_payload,
+)
+from .registry import ModelEndpoint, RoutingRequest, load_model_registry
+from .router import RouteDecision, SovereignModelRouter
+
+__all__ = [
+    "ModelEndpoint",
+    "RouteDecision",
+    "RoutingRequest",
+    "SovereignModelRouter",
+    "build_chat_route_response",
+    "build_models_response",
+    "load_model_registry",
+    "route_chat_payload",
+    "routing_request_from_chat_payload",
+]

marama_route/cli.py

@@ -0,0 +1,83 @@
+from __future__ import annotations
+
+import argparse
+import json
+from collections.abc import Sequence
+from pathlib import Path
+from typing import Any
+
+from .gateway import build_models_response, route_chat_payload
+from .registry import RoutingRequest, load_model_registry
+from .router import SovereignModelRouter
+
+
+def _load_json_mapping(path: Path) -> dict[str, Any]:
+    payload = json.loads(path.read_text(encoding="utf-8-sig"))
+    if not isinstance(payload, dict):
+        raise ValueError(f"Expected mapping in {path}")
+    return payload
+
+
+def _route(args: argparse.Namespace) -> int:
+    models = load_model_registry(args.registry)
+    payload = _load_json_mapping(args.request)
+    decision = SovereignModelRouter(models).route(RoutingRequest.from_payload(payload))
+    print(json.dumps(decision.to_dict(), indent=2, sort_keys=True))
+    return 0 if decision.selected_model is not None else 2
+
+
+def _models(args: argparse.Namespace) -> int:
+    models = load_model_registry(args.registry)
+    print(json.dumps(build_models_response(models), indent=2, sort_keys=True))
+    return 0
+
+
+def _chat_dry_run(args: argparse.Namespace) -> int:
+    models = load_model_registry(args.registry)
+    payload = _load_json_mapping(args.request)
+    result = route_chat_payload(payload, models)
+    print(json.dumps(result, indent=2, sort_keys=True))
+    selected = result["route_decision"]["selected_model"]
+    return 0 if selected is not None else 2
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog="lumynax-marama-route",
+        description="Route requests across LumynaX sovereign model releases.",
+    )
+    subparsers = parser.add_subparsers(dest="command")
+    route = subparsers.add_parser("route", help="Select a LumynaX model for a request.")
+    route.add_argument("--registry", type=Path, required=True, help="MaramaRoute model registry JSON.")
+    route.add_argument("--request", type=Path, required=True, help="Routing request JSON.")
+    route.set_defaults(handler=_route)
+
+    models = subparsers.add_parser(
+        "models",
+        help="Emit an OpenAI-compatible /v1/models response.",
+    )
+    models.add_argument("--registry", type=Path, required=True, help="MaramaRoute model registry JSON.")
+    models.set_defaults(handler=_models)
+
+    chat = subparsers.add_parser(
+        "chat-dry-run",
+        help="Route an OpenAI-compatible chat request without invoking a backend.",
+    )
+    chat.add_argument("--registry", type=Path, required=True, help="MaramaRoute model registry JSON.")
+    chat.add_argument("--request", type=Path, required=True, help="OpenAI chat request JSON.")
+    chat.set_defaults(handler=_chat_dry_run)
+    return parser
+
+
+def main(argv: Sequence[str] | None = None) -> int:
+    parser = build_parser()
+    args = parser.parse_args(argv)
+    handler = getattr(args, "handler", None)
+    if handler is None:
+        parser.print_help()
+        return 0
+    return int(handler(args))
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

marama_route/gateway.py

@@ -0,0 +1,204 @@
+from __future__ import annotations
+
+import hashlib
+import json
+import time
+from typing import Any
+
+from .registry import ModelEndpoint, RoutingRequest
+from .router import RouteDecision, SovereignModelRouter
+
+
+def routing_request_from_chat_payload(payload: dict[str, Any]) -> RoutingRequest:
+    """Translate an OpenAI-compatible chat request into a routing request."""
+
+    route_options = _mapping(
+        payload.get("route")
+        or payload.get("routing")
+        or _mapping(payload.get("metadata")).get("marama_route"),
+    )
+    prompt, modalities = _prompt_and_modalities(payload)
+    tools = payload.get("tools")
+    response_format = _mapping(payload.get("response_format"))
+    task_type = str(route_options.get("task_type") or _infer_task_type(prompt, modalities))
+
+    return RoutingRequest.from_payload(
+        {
+            "prompt": prompt,
+            "task_type": task_type,
+            "modalities": sorted(modalities),
+            "jurisdiction": route_options.get("jurisdiction", "NZ"),
+            "data_sensitivity": route_options.get("data_sensitivity", "internal"),
+            "min_context_tokens": route_options.get("min_context_tokens", 4096),
+            "requires_local": route_options.get("requires_local", True),
+            "requires_tools": bool(tools) or bool(route_options.get("requires_tools")),
+            "requires_json": _requires_json(response_format, route_options),
+            "license_allowlist": route_options.get("license_allowlist", ()),
+            "max_fallbacks": route_options.get("max_fallbacks", 3),
+            "metadata": {
+                "requested_model": payload.get("model", "auto"),
+                "source_protocol": "openai_chat_completions",
+            },
+        },
+    )
+
+
+def build_models_response(models: tuple[ModelEndpoint, ...]) -> dict[str, Any]:
+    """Return an OpenAI-compatible `/v1/models` listing."""
+
+    return {
+        "object": "list",
+        "data": [
+            {
+                "id": model.model_id,
+                "object": "model",
+                "created": 0,
+                "owned_by": model.repo_id.split("/", maxsplit=1)[0],
+                "metadata": {
+                    "repo_id": model.repo_id,
+                    "runtime": model.runtime,
+                    "modalities": list(model.modalities),
+                    "context_tokens": model.context_tokens,
+                    "residency": list(model.residency),
+                    "sovereignty_tier": model.sovereignty_tier,
+                    "supports_tools": model.supports_tools,
+                    "supports_json": model.supports_json,
+                    "tags": list(model.tags),
+                },
+            }
+            for model in models
+        ],
+    }
+
+
+def build_chat_route_response(
+    payload: dict[str, Any],
+    decision: RouteDecision,
+) -> dict[str, Any]:
+    """Return a dry-run chat response with route metadata and no generated text."""
+
+    selected = decision.selected_model
+    created = int(time.time())
+    request_hash = hashlib.sha256(
+        json.dumps(payload, sort_keys=True, default=str).encode("utf-8"),
+    ).hexdigest()
+    model_id = selected.model_id if selected is not None else str(payload.get("model", ""))
+
+    return {
+        "id": f"marama-route-{request_hash[:16]}",
+        "object": "chat.completion",
+        "created": created,
+        "model": model_id,
+        "choices": [
+            {
+                "index": 0,
+                "finish_reason": "route_only",
+                "message": {
+                    "role": "assistant",
+                    "content": "",
+                },
+            },
+        ],
+        "usage": {
+            "prompt_tokens": 0,
+            "completion_tokens": 0,
+            "total_tokens": 0,
+        },
+        "marama_route": {
+            "dry_run": True,
+            "selected_model": selected.to_dict() if selected is not None else None,
+            "fallback_models": [model.to_dict() for model in decision.fallback_models],
+            "rejected_count": len(decision.rejected),
+            "reasons": list(decision.reasons),
+            "scores": dict(decision.scores),
+            "request_hash": request_hash,
+        },
+    }
+
+
+def route_chat_payload(
+    payload: dict[str, Any],
+    models: tuple[ModelEndpoint, ...],
+) -> dict[str, Any]:
+    request = routing_request_from_chat_payload(payload)
+    decision = SovereignModelRouter(models).route(request)
+    return {
+        "routing_request": request.to_dict(),
+        "route_decision": decision.to_dict(),
+        "chat_completion_response": build_chat_route_response(payload, decision),
+    }
+
+
+def _mapping(value: object) -> dict[str, Any]:
+    return dict(value) if isinstance(value, dict) else {}
+
+
+def _requires_json(
+    response_format: dict[str, Any],
+    route_options: dict[str, Any],
+) -> bool:
+    if bool(route_options.get("requires_json")):
+        return True
+    response_type = str(response_format.get("type", "")).lower()
+    return response_type in {"json_object", "json_schema"}
+
+
+def _prompt_and_modalities(payload: dict[str, Any]) -> tuple[str, set[str]]:
+    modalities = {"text"}
+    pieces: list[str] = []
+    messages = payload.get("messages")
+    if isinstance(messages, list):
+        for message in messages:
+            if not isinstance(message, dict):
+                continue
+            content = message.get("content")
+            text, content_modalities = _content_text_and_modalities(content)
+            pieces.append(text)
+            modalities.update(content_modalities)
+    elif isinstance(payload.get("prompt"), str):
+        pieces.append(str(payload["prompt"]))
+    return "\n".join(piece for piece in pieces if piece), modalities
+
+
+def _content_text_and_modalities(content: object) -> tuple[str, set[str]]:
+    if isinstance(content, str):
+        return content, {"text"}
+    if not isinstance(content, list):
+        return "", {"text"}
+
+    pieces: list[str] = []
+    modalities = {"text"}
+    for part in content:
+        if not isinstance(part, dict):
+            continue
+        part_type = str(part.get("type", "")).lower()
+        if part_type in {"text", "input_text"}:
+            pieces.append(str(part.get("text", "")))
+        elif part_type in {"image", "image_url", "input_image"}:
+            modalities.add("image")
+        elif part_type in {"audio", "input_audio"}:
+            modalities.add("audio")
+    return "\n".join(piece for piece in pieces if piece), modalities
+
+
+def _infer_task_type(prompt: str, modalities: set[str]) -> str:
+    prompt_lower = prompt.lower()
+    if "image" in modalities or "vision" in modalities:
+        return "multimodal"
+    code_markers = (
+        "refactor",
+        "diff",
+        "unit test",
+        "python",
+        "typescript",
+        "javascript",
+        "repository",
+        "function",
+        "class ",
+        "stack trace",
+    )
+    if any(marker in prompt_lower for marker in code_markers):
+        return "code"
+    if "reason" in prompt_lower or "prove" in prompt_lower:
+        return "reasoning"
+    return "general"

marama_route/registry.py

@@ -0,0 +1,150 @@
+from __future__ import annotations
+
+import json
+from dataclasses import dataclass, field
+from pathlib import Path
+from typing import Any
+
+
+def _text_tuple(value: object, *, default: tuple[str, ...] = ()) -> tuple[str, ...]:
+    if value in (None, ""):
+        return default
+    if isinstance(value, str):
+        return (value,)
+    if isinstance(value, (list, tuple, set)):
+        return tuple(str(item).strip() for item in value if str(item).strip())
+    return (str(value).strip(),)
+
+
+@dataclass(frozen=True, slots=True)
+class ModelEndpoint:
+    model_id: str
+    repo_id: str
+    family: str
+    runtime: str
+    modalities: tuple[str, ...] = ("text",)
+    context_tokens: int = 4096
+    jurisdiction: str = "NZ"
+    residency: tuple[str, ...] = ("NZ",)
+    license_id: str = "see_model_card"
+    quantization: str = "see_manifest"
+    primary_artifact: str = ""
+    active_params_b: float | None = None
+    total_params_b: float | None = None
+    quality_rank: int = 5
+    cost_rank: int = 5
+    sovereignty_tier: int = 2
+    supports_tools: bool = False
+    supports_json: bool = False
+    tags: tuple[str, ...] = ()
+    metadata: dict[str, Any] = field(default_factory=dict)
+
+    @classmethod
+    def from_payload(cls, payload: dict[str, Any]) -> ModelEndpoint:
+        return cls(
+            model_id=str(payload.get("model_id") or payload.get("repo_id") or ""),
+            repo_id=str(payload.get("repo_id") or payload.get("model_id") or ""),
+            family=str(payload.get("family") or "lumynax"),
+            runtime=str(payload.get("runtime") or "llama_cpp"),
+            modalities=_text_tuple(payload.get("modalities"), default=("text",)),
+            context_tokens=int(payload.get("context_tokens") or 4096),
+            jurisdiction=str(payload.get("jurisdiction") or "NZ").upper(),
+            residency=tuple(str(item).upper() for item in _text_tuple(payload.get("residency"), default=("NZ",))),
+            license_id=str(payload.get("license_id") or "see_model_card"),
+            quantization=str(payload.get("quantization") or "see_manifest"),
+            primary_artifact=str(payload.get("primary_artifact") or ""),
+            active_params_b=(
+                float(payload["active_params_b"]) if payload.get("active_params_b") is not None else None
+            ),
+            total_params_b=(
+                float(payload["total_params_b"]) if payload.get("total_params_b") is not None else None
+            ),
+            quality_rank=int(payload.get("quality_rank") or 5),
+            cost_rank=int(payload.get("cost_rank") or 5),
+            sovereignty_tier=int(payload.get("sovereignty_tier") or 2),
+            supports_tools=bool(payload.get("supports_tools", False)),
+            supports_json=bool(payload.get("supports_json", False)),
+            tags=tuple(item.lower() for item in _text_tuple(payload.get("tags"))),
+            metadata=dict(payload.get("metadata") or {}),
+        )
+
+    def to_dict(self) -> dict[str, Any]:
+        return {
+            "model_id": self.model_id,
+            "repo_id": self.repo_id,
+            "family": self.family,
+            "runtime": self.runtime,
+            "modalities": list(self.modalities),
+            "context_tokens": self.context_tokens,
+            "jurisdiction": self.jurisdiction,
+            "residency": list(self.residency),
+            "license_id": self.license_id,
+            "quantization": self.quantization,
+            "primary_artifact": self.primary_artifact,
+            "active_params_b": self.active_params_b,
+            "total_params_b": self.total_params_b,
+            "quality_rank": self.quality_rank,
+            "cost_rank": self.cost_rank,
+            "sovereignty_tier": self.sovereignty_tier,
+            "supports_tools": self.supports_tools,
+            "supports_json": self.supports_json,
+            "tags": list(self.tags),
+            "metadata": dict(self.metadata),
+        }
+
+
+@dataclass(frozen=True, slots=True)
+class RoutingRequest:
+    prompt: str
+    task_type: str = "general"
+    modalities: tuple[str, ...] = ("text",)
+    jurisdiction: str = "NZ"
+    data_sensitivity: str = "internal"
+    min_context_tokens: int = 4096
+    requires_local: bool = True
+    requires_tools: bool = False
+    requires_json: bool = False
+    license_allowlist: tuple[str, ...] = ()
+    max_fallbacks: int = 3
+    metadata: dict[str, Any] = field(default_factory=dict)
+
+    @classmethod
+    def from_payload(cls, payload: dict[str, Any]) -> RoutingRequest:
+        return cls(
+            prompt=str(payload.get("prompt") or ""),
+            task_type=str(payload.get("task_type") or "general").lower(),
+            modalities=tuple(item.lower() for item in _text_tuple(payload.get("modalities"), default=("text",))),
+            jurisdiction=str(payload.get("jurisdiction") or "NZ").upper(),
+            data_sensitivity=str(payload.get("data_sensitivity") or "internal").lower(),
+            min_context_tokens=int(payload.get("min_context_tokens") or 4096),
+            requires_local=bool(payload.get("requires_local", True)),
+            requires_tools=bool(payload.get("requires_tools", False)),
+            requires_json=bool(payload.get("requires_json", False)),
+            license_allowlist=tuple(item.lower() for item in _text_tuple(payload.get("license_allowlist"))),
+            max_fallbacks=int(payload.get("max_fallbacks") or 3),
+            metadata=dict(payload.get("metadata") or {}),
+        )
+
+    def to_dict(self) -> dict[str, Any]:
+        return {
+            "prompt": self.prompt,
+            "task_type": self.task_type,
+            "modalities": list(self.modalities),
+            "jurisdiction": self.jurisdiction,
+            "data_sensitivity": self.data_sensitivity,
+            "min_context_tokens": self.min_context_tokens,
+            "requires_local": self.requires_local,
+            "requires_tools": self.requires_tools,
+            "requires_json": self.requires_json,
+            "license_allowlist": list(self.license_allowlist),
+            "max_fallbacks": self.max_fallbacks,
+            "metadata": dict(self.metadata),
+        }
+
+
+def load_model_registry(path: Path) -> tuple[ModelEndpoint, ...]:
+    payload = json.loads(path.read_text(encoding="utf-8-sig"))
+    raw_models = payload.get("models") if isinstance(payload, dict) else payload
+    if not isinstance(raw_models, list):
+        raise ValueError(f"Expected model list in {path}")
+    return tuple(ModelEndpoint.from_payload(item) for item in raw_models if isinstance(item, dict))

marama_route/router.py

@@ -0,0 +1,113 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Any
+
+from .registry import ModelEndpoint, RoutingRequest
+
+HIGH_SENSITIVITY = frozenset({"personal", "restricted", "health", "iwi", "taonga"})
+
+
+@dataclass(frozen=True, slots=True)
+class RouteDecision:
+    selected_model: ModelEndpoint | None
+    fallback_models: tuple[ModelEndpoint, ...]
+    rejected: tuple[dict[str, str], ...]
+    reasons: tuple[str, ...]
+    scores: dict[str, float]
+
+    def to_dict(self) -> dict[str, Any]:
+        return {
+            "selected_model": self.selected_model.to_dict() if self.selected_model else None,
+            "fallback_models": [model.to_dict() for model in self.fallback_models],
+            "rejected": list(self.rejected),
+            "reasons": list(self.reasons),
+            "scores": dict(self.scores),
+        }
+
+
+class SovereignModelRouter:
+    def __init__(self, models: tuple[ModelEndpoint, ...]) -> None:
+        self.models = models
+
+    def route(self, request: RoutingRequest) -> RouteDecision:
+        accepted: list[ModelEndpoint] = []
+        rejected: list[dict[str, str]] = []
+        requested_modalities = set(request.modalities)
+        license_allowlist = set(request.license_allowlist)
+
+        for model in self.models:
+            model_modalities = set(item.lower() for item in model.modalities)
+            if not requested_modalities.issubset(model_modalities):
+                rejected.append({"model_id": model.model_id, "reason": "modality_mismatch"})
+                continue
+            if model.context_tokens < request.min_context_tokens:
+                rejected.append({"model_id": model.model_id, "reason": "context_too_small"})
+                continue
+            if request.requires_tools and not model.supports_tools:
+                rejected.append({"model_id": model.model_id, "reason": "tools_required"})
+                continue
+            if request.requires_json and not model.supports_json:
+                rejected.append({"model_id": model.model_id, "reason": "json_required"})
+                continue
+            if license_allowlist and model.license_id.lower() not in license_allowlist:
+                rejected.append({"model_id": model.model_id, "reason": "license_not_allowed"})
+                continue
+            if request.requires_local and request.jurisdiction not in model.residency:
+                rejected.append({"model_id": model.model_id, "reason": "residency_mismatch"})
+                continue
+            if request.data_sensitivity in HIGH_SENSITIVITY and model.sovereignty_tier < 2:
+                rejected.append({"model_id": model.model_id, "reason": "sovereignty_tier_too_low"})
+                continue
+            accepted.append(model)
+
+        scores = {model.model_id: self._score(model, request) for model in accepted}
+        ranked = tuple(sorted(accepted, key=lambda model: (scores[model.model_id], model.model_id), reverse=True))
+        selected = ranked[0] if ranked else None
+        fallbacks = ranked[1 : 1 + request.max_fallbacks]
+        reasons = self._reasons(selected, request)
+        return RouteDecision(
+            selected_model=selected,
+            fallback_models=fallbacks,
+            rejected=tuple(rejected),
+            reasons=reasons,
+            scores=scores,
+        )
+
+    def _score(self, model: ModelEndpoint, request: RoutingRequest) -> float:
+        score = 0.0
+        tags = set(model.tags)
+        prompt_lower = request.prompt.lower()
+        if request.jurisdiction in model.residency:
+            score += 8.0
+        if request.task_type in tags or request.task_type in model.family.lower():
+            score += 7.0
+        if request.task_type == "code" and ("coder" in model.model_id or "coder" in tags):
+            score += 10.0
+        if request.task_type == "reasoning" and ("reasoning" in model.model_id or "reasoning" in tags):
+            score += 9.0
+        if "iwi" in prompt_lower or "data sovereignty" in prompt_lower:
+            score += 3.0 * model.sovereignty_tier
+        if "gguf" in model.runtime.lower() or model.runtime == "llama_cpp":
+            score += 2.5
+        if model.supports_json and request.requires_json:
+            score += 3.0
+        if model.supports_tools and request.requires_tools:
+            score += 3.0
+        score += max(0, 10 - model.quality_rank) * 1.7
+        score -= model.cost_rank * 0.25
+        if model.active_params_b is not None and model.active_params_b <= 8:
+            score += 0.5
+        return round(score, 4)
+
+    def _reasons(self, selected: ModelEndpoint | None, request: RoutingRequest) -> tuple[str, ...]:
+        if selected is None:
+            return ("no model satisfied sovereignty and capability constraints",)
+        reasons = [
+            f"selected `{selected.model_id}` for task_type `{request.task_type}`",
+            f"residency `{request.jurisdiction}` satisfied",
+            f"runtime `{selected.runtime}`",
+        ]
+        if request.data_sensitivity in HIGH_SENSITIVITY:
+            reasons.append("high-sensitivity routing kept inside sovereign tier constraints")
+        return tuple(reasons)

policy-packs/nz-personal-sovereignty.yaml

@@ -0,0 +1,59 @@
+policy_id: abx-sovereigncode-nz-personal-sovereignty-v0
+jurisdiction: NZ
+purpose: governed personal, workspace, and community-context coding assistance
+default_residency:
+  - NZ
+allowed_personal_detail_levels:
+  - none
+  - anonymous
+  - pseudonymous
+  - identifiable
+  - sensitive_identifiable
+default_personal_detail_level: pseudonymous
+consent_scopes:
+  coding_assistance:
+    allowed_actions:
+      - read_context
+      - propose_patch
+      - generate_tests
+    blocked_actions_without_approval:
+      - write_file
+      - execute_shell
+      - commit
+      - publish
+      - network_export
+  personal_memory:
+    allowed_actions:
+      - read_preference
+      - summarise_profile
+    blocked_actions_without_approval:
+      - export_profile
+      - train_adapter
+      - share_with_third_party
+retention_defaults:
+  restricted_code_days: 14
+  personal_trace_days: 7
+  audit_record_days: 365
+data_subject_rights:
+  - access
+  - correction
+  - deletion_request
+  - processing_objection
+obligations:
+  - write_immutable_audit_record
+  - minimise_personal_detail_in_prompt
+  - keep_personal_trace_inside_capsule_retention
+  - show_diff_before_write_or_commit
+  - route_only_to_resident_runtime
+  - require_human_review_for_external_effects
+model_rules:
+  high_impact_requires_lumynax_or_local: true
+  restricted_requires_nz_residency: true
+  public_may_route_to_approved_global: true
+export_rules:
+  default_export_allowed: false
+  require_export_manifest: true
+  require_named_recipient: true
+training_rules:
+  default_training_allowed: false
+  require_explicit_capsule_training_allowed: true

product_blueprint.md

@@ -0,0 +1,73 @@
+# AbteeX SovereignCode Product Blueprint
+
+## One-Sentence Product
+
+SovereignCode is a local-first coding agent for New Zealand teams that need code
+assistance, model routing, personal-data controls, and audit-ready tool use in
+one governed workflow.
+
+## Core User Jobs
+
+| User | Job | SovereignCode Response |
+| --- | --- | --- |
+| Individual developer | Use an AI coding assistant without exposing private files or personal preferences. | Local capsule, pseudonymous personal profile, resident model route, no training by default. |
+| Startup or SME | Refactor and test private code while keeping customer data out of generic SaaS logs. | Workspace capsule, local route, diff review, audit hash. |
+| Council or public-sector team | Use AI on operational code and documents with retention and residency controls. | Tenant policy pack, NZ residency, approval gates, signed audit export. |
+| Iwi or community data steward | Keep community-held context under explicit purpose and consent boundaries. | High-impact sensitivity, local/LumynaX-only model rule, export denial by default. |
+| Internal platform owner | Give developers one coding assistant with central policy. | OpenAI-compatible provider, CLI planner, future SSO and policy server. |
+
+## Product Pillars
+
+1. Capsule-first context: every workspace, profile, dataset, and prompt context
+   resolves to a Data Capsule before agent work starts.
+2. Personal sovereignty: personal detail is classified before prompt assembly,
+   and consent scopes gate how profile context can be used.
+3. Governed autonomy: read, plan, patch, test, shell, network, commit, and
+   publish actions are separate tool grants.
+4. Open integration: OpenCode and similar clients connect through MaramaRoute's
+   OpenAI-compatible gateway.
+5. Audit without hoarding: records retain decision hashes, obligations, model
+   identity, and reasons while prompt retention stays constrained.
+
+## Minimum Product Loop
+
+```text
+developer asks for a coding task
+  -> resolve `.sovereigncode/capsule.json`
+  -> evaluate SovereignRequest
+  -> build MaramaRoute request
+  -> select resident LumynaX model
+  -> produce plan
+  -> request approval for writes or shell
+  -> apply patch
+  -> run tests
+  -> store audit record
+```
+
+## Product Modules To Build Next
+
+| Module | MVP Definition | Implementation Notes |
+| --- | --- | --- |
+| Workspace indexer | Reads repo files, ignores secrets/build outputs, tags data classes. | Start with `rg --files`, `.gitignore`, and capsule include/exclude rules. |
+| Tool broker | Wraps file write, shell, git, package install, HTTP, and model calls. | Reuse policy decisions and emit one audit record per effectful tool call. |
+| Terminal UI | Shows plan, selected model, obligations, diff, and test output. | Keep compatible with OpenCode-style terminal use. |
+| Personal profile store | Keeps user preferences and memory under a personal capsule. | Local encrypted file first, tenant vault later. |
+| Audit ledger | Append-only local JSONL with hash chain. | Export signed bundles for enterprise customers. |
+| Tenant policy server | Central policy packs, model allowlists, API keys, quotas. | Only needed after local MVP works. |
+
+## Default Plans
+
+| Plan | Buyer | Included |
+| --- | --- | --- |
+| Local Developer | individual NZ developer | local capsule, local audit, MaramaRoute provider config |
+| Team Sovereign | startup or SME | shared policy pack, route registry, team audit export |
+| Regulated Workspace | council, health-adjacent, community data project | stronger approval gates, retention controls, signed audit, SSO-ready policy server |
+
+## First Non-Negotiables
+
+- Never train on a capsule unless `training_allowed` is explicitly true.
+- Never export restricted or personal context unless `export_allowed` is true
+  and the request carries human approval.
+- Never route high-impact data to a non-local or non-LumynaX-governed model.
+- Never apply file writes without a visible diff obligation.
+- Never hide selected model identity from the audit record.

product_manifest.json

@@ -5,15 +5,34 @@
   "family": "LumynaX sovereign products",
   "stage": "product_scaffold",
   "positioning": "OpenCode-style local coding agent with Data Capsule sovereignty controls",
+  "target_region": "NZ",
+  "target_users": [
+    "New Zealand developers",
+    "regulated SMEs",
+    "local government teams",
+    "health-adjacent operators",
+    "Iwi and community data stewards",
+    "privacy-conscious individual developers"
+  ],
   "primary_modules": [
     "data_capsule_policy",
+    "personal_detail_consent",
     "tool_broker",
     "lumynax_runtime_adapter",
     "audit_ledger",
-    "human_review_gate"
+    "human_review_gate",
+    "opencode_compatible_provider"
   ],
   "runtime_entrypoints": [
-    "python -m tinyluminax.products.sovereigncode.cli"
+    "python -m tinyluminax.products.sovereigncode.cli evaluate",
+    "python -m tinyluminax.products.sovereigncode.cli plan-turn"
+  ],
+  "integration_surfaces": [
+    "OpenAI-compatible /v1/chat/completions via MaramaRoute",
+    "OpenAI-compatible /v1/models via MaramaRoute",
+    "OpenCode custom provider config",
+    "local CLI policy evaluator",
+    "governed coding-turn planner"
   ],
   "brand_system": {
     "paper": "#fffefa",

pyproject.toml

@@ -4,22 +4,14 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "abteex-sovereigncode"
-version = "0.1.0"
-description = "AbteeX SovereignCode — local-first coding agent with Data Capsule sovereignty controls."
+version = "0.2.0"
+description = "AbteeX SovereignCode: local-first coding agent with Data Capsule sovereignty controls."
 readme = "README.md"
-requires-python = ">=3.10"
+requires-python = ">=3.11"
 license = { text = "Apache-2.0" }
 authors = [{ name = "AbteeX AI Labs" }]
-keywords = ["lumynax", "sovereignty", "data-capsule", "coding-agent", "aotearoa", "new-zealand"]
-classifiers = [
-  "License :: OSI Approved :: Apache Software License",
-  "Programming Language :: Python :: 3.10",
-  "Programming Language :: Python :: 3.11",
-  "Programming Language :: Python :: 3.12",
-  "Intended Audience :: Developers",
-  "Topic :: Software Development :: Libraries",
-]
-dependencies = ["pyyaml>=6.0"]
+keywords = ["lumynax", "sovereignty", "data-capsule", "coding-agent", "opencode", "new-zealand"]
+dependencies = ["PyYAML>=6.0"]
 
 [project.urls]
 Homepage = "https://abteex.com"

quickstart.py

@@ -1,30 +1,41 @@
-"""Quickstart for AbteeX SovereignCode.
-
-Runs the two example policy evaluations and prints structured decisions and audit records.
-"""
+"""Quickstart smoke for AbteeX SovereignCode."""
 from __future__ import annotations
 
 import json
 from pathlib import Path
 
-from sovereigncode import build_audit_record, evaluate, load_capsule, load_policy, load_request
+from sovereigncode.cli import main
 
 
-ROOT = Path(__file__).parent
-EXAMPLES = ROOT / "examples"
-CONFIGS = ROOT / "configs"
+ROOT = Path(__file__).resolve().parent
 
 
-def run(label: str, capsule_path: Path, request_path: Path) -> None:
-    capsule = load_capsule(capsule_path)
-    request = load_request(request_path)
-    policy = load_policy(CONFIGS / "default_policy.yaml")
-    decision = evaluate(capsule, request, policy)
-    audit = build_audit_record(capsule, request, decision.to_dict())
-    print(f"\n=== {label} ===")
-    print(json.dumps({"decision": decision.to_dict(), "audit": audit.to_dict()}, indent=2, ensure_ascii=False))
+def run(args: list[str]) -> int:
+    print("\n$ python -m sovereigncode.cli " + " ".join(args))
+    return main(args)
 
 
 if __name__ == "__main__":
-    run("ALLOWED local edit", EXAMPLES / "capsule.restricted-nz-code.json", EXAMPLES / "request.allowed-local-edit.json")
-    run("DENIED training",   EXAMPLES / "capsule.restricted-nz-code.json", EXAMPLES / "request.denied-training.json")
+    checks = [
+        [
+            "evaluate",
+            "--capsule",
+            str(ROOT / "examples" / "capsule.restricted-nz-code.json"),
+            "--request",
+            str(ROOT / "examples" / "request.allowed-local-edit.json"),
+        ],
+        [
+            "plan-turn",
+            "--capsule",
+            str(ROOT / "examples" / "capsule.restricted-nz-code.json"),
+            "--request",
+            str(ROOT / "examples" / "request.allowed-local-edit.json"),
+            "--route-request",
+            str(ROOT / "examples" / "request.code-restricted.json"),
+            "--registry",
+            str(ROOT / "configs" / "lumynax_model_registry.json"),
+        ],
+    ]
+    exits = [run(item) for item in checks]
+    print(json.dumps({"checks": len(exits), "passed": all(code == 0 for code in exits)}, indent=2))
+    raise SystemExit(0 if all(code == 0 for code in exits) else 1)

requirements.txt

@@ -1 +1 @@
-pyyaml>=6.0
+PyYAML>=6.0

schemas/data_capsule.schema.json

@@ -0,0 +1,88 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://abteex.com/schemas/sovereigncode/data-capsule.schema.json",
+  "title": "AbteeX SovereignCode Data Capsule",
+  "type": "object",
+  "required": ["capsule_id", "subject_id", "jurisdiction", "sensitivity"],
+  "additionalProperties": true,
+  "properties": {
+    "capsule_id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "subject_id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "jurisdiction": {
+      "type": "string",
+      "default": "NZ"
+    },
+    "sensitivity": {
+      "type": "string",
+      "enum": ["public", "internal", "restricted", "personal", "health", "iwi", "taonga"]
+    },
+    "allowed_purposes": {
+      "type": "array",
+      "items": { "type": "string" },
+      "default": ["inference", "coding_assistance"]
+    },
+    "denied_purposes": {
+      "type": "array",
+      "items": { "type": "string" },
+      "default": []
+    },
+    "resident_regions": {
+      "type": "array",
+      "items": { "type": "string" },
+      "default": ["NZ"]
+    },
+    "data_classes": {
+      "type": "array",
+      "items": { "type": "string" },
+      "default": ["source_code"]
+    },
+    "retention_days": {
+      "type": "integer",
+      "minimum": 0,
+      "default": 30
+    },
+    "export_allowed": {
+      "type": "boolean",
+      "default": false
+    },
+    "training_allowed": {
+      "type": "boolean",
+      "default": false
+    },
+    "personal_detail_level": {
+      "type": "string",
+      "enum": ["none", "anonymous", "pseudonymous", "identifiable", "sensitive_identifiable"],
+      "default": "none"
+    },
+    "consent_scopes": {
+      "type": "array",
+      "items": { "type": "string" },
+      "default": []
+    },
+    "data_subject_rights": {
+      "type": "array",
+      "items": { "type": "string" },
+      "default": ["access", "correction", "deletion_request", "processing_objection"]
+    },
+    "revoked": {
+      "type": "boolean",
+      "default": false
+    },
+    "schema_context": {
+      "type": "string",
+      "default": "https://schema.org"
+    },
+    "consent_record": {
+      "type": "string"
+    },
+    "metadata": {
+      "type": "object"
+    }
+  }
+}

sovereigncode/__init__.py

@@ -1,15 +1,22 @@
-"""AbteeX SovereignCode — local-first coding agent with Data Capsule sovereignty controls."""
-from .policy import Decision, evaluate, load_capsule, load_policy, load_request
-from .audit import AuditRecord, build_audit_record, request_hash
+from __future__ import annotations
+
+from .audit import AuditRecord, build_audit_record
+from .planner import SovereignCodingTurnPlan, ToolGrant, plan_coding_turn
+from .policy import (
+    DataCapsule,
+    PolicyDecision,
+    SovereignRequest,
+    SovereigntyPolicyEngine,
+)
 
 __all__ = [
-    "Decision",
-    "evaluate",
-    "load_capsule",
-    "load_policy",
-    "load_request",
     "AuditRecord",
+    "DataCapsule",
+    "PolicyDecision",
+    "SovereignRequest",
+    "SovereignCodingTurnPlan",
+    "SovereigntyPolicyEngine",
+    "ToolGrant",
     "build_audit_record",
-    "request_hash",
+    "plan_coding_turn",
 ]
-__version__ = "0.1.0"

sovereigncode/audit.py

@@ -1,51 +1,61 @@
-"""Audit ledger primitives.
-
-Every policy decision creates a record. Records are hash-stable, append-only,
-and chainable for tamper-evident exports.
-"""
 from __future__ import annotations
 
 import hashlib
-import json
-from dataclasses import asdict, dataclass, field
-from datetime import datetime, timezone
-from typing import Any, Dict, List
-
-
-def _canonical(obj: Any) -> str:
-    return json.dumps(obj, sort_keys=True, separators=(",", ":"), ensure_ascii=False)
+from dataclasses import dataclass
+from datetime import UTC, datetime
+from typing import Any
 
+from .policy import DataCapsule, PolicyDecision, SovereignRequest
 
-def request_hash(request: Dict[str, Any]) -> str:
-    return hashlib.sha256(_canonical(request).encode("utf-8")).hexdigest()
 
-
-@dataclass
+@dataclass(frozen=True, slots=True)
 class AuditRecord:
+    timestamp: str
     capsule_id: str
     actor: str
     purpose: str
     action: str
     model_id: str
-    decision: str
-    reasons: List[str]
-    obligations: List[str]
+    allowed: bool
+    reasons: tuple[str, ...]
+    obligations: tuple[str, ...]
+    audit_tags: tuple[str, ...]
     request_hash: str
-    timestamp: str = field(default_factory=lambda: datetime.now(timezone.utc).isoformat(timespec="seconds"))
-
-    def to_dict(self) -> Dict[str, Any]:
-        return asdict(self)
-
 
-def build_audit_record(capsule: Dict[str, Any], request: Dict[str, Any], decision_dict: Dict[str, Any]) -> AuditRecord:
+    def to_dict(self) -> dict[str, Any]:
+        return {
+            "timestamp": self.timestamp,
+            "capsule_id": self.capsule_id,
+            "actor": self.actor,
+            "purpose": self.purpose,
+            "action": self.action,
+            "model_id": self.model_id,
+            "allowed": self.allowed,
+            "reasons": list(self.reasons),
+            "obligations": list(self.obligations),
+            "audit_tags": list(self.audit_tags),
+            "request_hash": self.request_hash,
+        }
+
+
+def build_audit_record(
+    capsule: DataCapsule,
+    request: SovereignRequest,
+    decision: PolicyDecision,
+) -> AuditRecord:
+    digest = hashlib.sha256(
+        repr((capsule.to_dict(), request.to_dict(), decision.to_dict())).encode("utf-8"),
+    ).hexdigest()
     return AuditRecord(
-        capsule_id=str(capsule.get("capsule_id", "")),
-        actor=str(request.get("actor", "")),
-        purpose=str(request.get("purpose", "")),
-        action=str(request.get("action", "")),
-        model_id=str(request.get("model_id", "")),
-        decision=str(decision_dict.get("decision", "")),
-        reasons=list(decision_dict.get("reasons", [])),
-        obligations=list(decision_dict.get("obligations", [])),
-        request_hash=request_hash(request),
+        timestamp=datetime.now(UTC).isoformat(),
+        capsule_id=capsule.capsule_id,
+        actor=request.actor,
+        purpose=request.purpose,
+        action=request.action,
+        model_id=request.model_id,
+        allowed=decision.allowed,
+        reasons=decision.reasons,
+        obligations=decision.obligations,
+        audit_tags=decision.audit_tags,
+        request_hash=digest,
     )

sovereigncode/cli.py

@@ -1,47 +1,107 @@
-"""SovereignCode CLI: evaluate a request against a capsule and policy."""
 from __future__ import annotations
 
 import argparse
 import json
-import sys
+from collections.abc import Sequence
 from pathlib import Path
+from typing import Any
+
+import yaml
+
+from marama_route import RoutingRequest, load_model_registry
 
 from .audit import build_audit_record
-from .policy import evaluate, load_capsule, load_policy, load_request
+from .planner import plan_coding_turn
+from .policy import DataCapsule, SovereignRequest, SovereigntyPolicyEngine
 
 
-DEFAULT_POLICY = Path(__file__).parent.parent / "configs" / "default_policy.yaml"
+def _load_mapping(path: Path) -> dict[str, Any]:
+    text = path.read_text(encoding="utf-8-sig")
+    if path.suffix.lower() == ".json":
+        payload = json.loads(text)
+    else:
+        payload = yaml.safe_load(text)
+    if not isinstance(payload, dict):
+        raise ValueError(f"Expected mapping in {path}")
+    return payload
 
 
-def main() -> int:
-    parser = argparse.ArgumentParser(prog="sovereigncode", description="AbteeX SovereignCode — Data Capsule policy evaluator.")
-    sub = parser.add_subparsers(dest="cmd", required=True)
+def _evaluate(args: argparse.Namespace) -> int:
+    capsule = DataCapsule.from_payload(_load_mapping(args.capsule))
+    request = SovereignRequest.from_payload(_load_mapping(args.request))
+    decision = SovereigntyPolicyEngine().evaluate(capsule, request)
+    payload: dict[str, Any] = {"decision": decision.to_dict()}
+    if args.audit:
+        payload["audit_record"] = build_audit_record(capsule, request, decision).to_dict()
+    print(json.dumps(payload, indent=2, sort_keys=True))
+    return 0 if decision.allowed or args.allow_denied_exit_zero else 2
 
-    ev = sub.add_parser("evaluate", help="Evaluate a request against a capsule.")
-    ev.add_argument("--capsule", required=True, help="Path to capsule JSON.")
-    ev.add_argument("--request", required=True, help="Path to request JSON.")
-    ev.add_argument("--policy", default=str(DEFAULT_POLICY), help="Path to policy YAML (default: configs/default_policy.yaml).")
-    ev.add_argument("--allow-denied-exit-zero", action="store_true", help="Exit 0 even when the decision is deny (useful for examples).")
 
-    args = parser.parse_args()
+def _plan_turn(args: argparse.Namespace) -> int:
+    capsule = DataCapsule.from_payload(_load_mapping(args.capsule))
+    request = SovereignRequest.from_payload(_load_mapping(args.request))
+    routing_request = RoutingRequest.from_payload(_load_mapping(args.route_request))
+    models = load_model_registry(args.registry)
+    plan = plan_coding_turn(capsule, request, routing_request, models)
+    print(json.dumps(plan.to_dict(), indent=2, sort_keys=True))
+    return 0 if plan.allowed or args.allow_blocked_exit_zero else 2
 
-    if args.cmd == "evaluate":
-        capsule = load_capsule(args.capsule)
-        request = load_request(args.request)
-        policy = load_policy(args.policy)
-        decision = evaluate(capsule, request, policy)
-        audit = build_audit_record(capsule, request, decision.to_dict())
-        out = {
-            "decision": decision.to_dict(),
-            "audit": audit.to_dict(),
-        }
-        print(json.dumps(out, indent=2, ensure_ascii=False))
-        if not decision.allowed and not args.allow_denied_exit_zero:
-            return 2
-        return 0
 
-    return 1
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog="abteex-sovereigncode",
+        description="Evaluate AbteeX SovereignCode Data Capsule policies.",
+    )
+    subparsers = parser.add_subparsers(dest="command")
+    evaluate = subparsers.add_parser("evaluate", help="Evaluate a governed code/data request.")
+    evaluate.add_argument("--capsule", type=Path, required=True, help="Data Capsule JSON/YAML file.")
+    evaluate.add_argument("--request", type=Path, required=True, help="Sovereign request JSON/YAML file.")
+    evaluate.add_argument("--audit", action=argparse.BooleanOptionalAction, default=True)
+    evaluate.add_argument(
+        "--allow-denied-exit-zero",
+        action=argparse.BooleanOptionalAction,
+        default=False,
+        help="Return exit code 0 even when policy denies the request.",
+    )
+    evaluate.set_defaults(handler=_evaluate)
+
+    plan_turn = subparsers.add_parser(
+        "plan-turn",
+        help="Plan a governed coding-agent turn with model routing.",
+    )
+    plan_turn.add_argument("--capsule", type=Path, required=True, help="Data Capsule JSON/YAML file.")
+    plan_turn.add_argument("--request", type=Path, required=True, help="Sovereign request JSON/YAML file.")
+    plan_turn.add_argument(
+        "--route-request",
+        type=Path,
+        required=True,
+        help="MaramaRoute routing request JSON/YAML file.",
+    )
+    plan_turn.add_argument(
+        "--registry",
+        type=Path,
+        required=True,
+        help="MaramaRoute model registry JSON.",
+    )
+    plan_turn.add_argument(
+        "--allow-blocked-exit-zero",
+        action=argparse.BooleanOptionalAction,
+        default=False,
+        help="Return exit code 0 even when the planned turn is blocked.",
+    )
+    plan_turn.set_defaults(handler=_plan_turn)
+    return parser
+
+
+def main(argv: Sequence[str] | None = None) -> int:
+    parser = build_parser()
+    args = parser.parse_args(argv)
+    handler = getattr(args, "handler", None)
+    if handler is None:
+        parser.print_help()
+        return 0
+    return int(handler(args))
 
 
 if __name__ == "__main__":
-    sys.exit(main())
+    raise SystemExit(main())

sovereigncode/planner.py

@@ -0,0 +1,129 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Any
+
+from marama_route import (
+    ModelEndpoint,
+    RouteDecision,
+    RoutingRequest,
+    SovereignModelRouter,
+)
+
+from .audit import AuditRecord, build_audit_record
+from .policy import (
+    DataCapsule,
+    PolicyDecision,
+    SovereignRequest,
+    SovereigntyPolicyEngine,
+)
+
+
+@dataclass(frozen=True, slots=True)
+class ToolGrant:
+    tool: str
+    allowed: bool
+    reason: str
+
+    def to_dict(self) -> dict[str, Any]:
+        return {
+            "tool": self.tool,
+            "allowed": self.allowed,
+            "reason": self.reason,
+        }
+
+
+@dataclass(frozen=True, slots=True)
+class SovereignCodingTurnPlan:
+    allowed: bool
+    policy_decision: PolicyDecision
+    audit_record: AuditRecord
+    route_decision: RouteDecision | None
+    tool_grants: tuple[ToolGrant, ...]
+    obligations: tuple[str, ...]
+    blocked_reasons: tuple[str, ...]
+    integration_targets: tuple[str, ...]
+
+    def to_dict(self) -> dict[str, Any]:
+        return {
+            "allowed": self.allowed,
+            "policy_decision": self.policy_decision.to_dict(),
+            "audit_record": self.audit_record.to_dict(),
+            "route_decision": (
+                self.route_decision.to_dict() if self.route_decision is not None else None
+            ),
+            "tool_grants": [grant.to_dict() for grant in self.tool_grants],
+            "obligations": list(self.obligations),
+            "blocked_reasons": list(self.blocked_reasons),
+            "integration_targets": list(self.integration_targets),
+        }
+
+
+def plan_coding_turn(
+    capsule: DataCapsule,
+    request: SovereignRequest,
+    routing_request: RoutingRequest,
+    models: tuple[ModelEndpoint, ...],
+) -> SovereignCodingTurnPlan:
+    """Plan one governed coding-agent turn against policy and model routing."""
+
+    policy_decision = SovereigntyPolicyEngine().evaluate(capsule, request)
+    audit_record = build_audit_record(capsule, request, policy_decision)
+    route_decision: RouteDecision | None = None
+    blocked_reasons = list(policy_decision.reasons)
+
+    if policy_decision.allowed:
+        route_decision = SovereignModelRouter(models).route(routing_request)
+        if route_decision.selected_model is None:
+            blocked_reasons.extend(route_decision.reasons)
+
+    tool_grants = _build_tool_grants(request, policy_decision)
+    allowed = policy_decision.allowed and route_decision is not None
+    allowed = allowed and route_decision.selected_model is not None
+
+    return SovereignCodingTurnPlan(
+        allowed=allowed,
+        policy_decision=policy_decision,
+        audit_record=audit_record,
+        route_decision=route_decision,
+        tool_grants=tool_grants,
+        obligations=policy_decision.obligations,
+        blocked_reasons=tuple(dict.fromkeys(blocked_reasons)),
+        integration_targets=(
+            "opencode_openai_compatible_provider",
+            "openrouter_style_gateway",
+            "local_cli_agent",
+        ),
+    )
+
+
+def _build_tool_grants(
+    request: SovereignRequest,
+    decision: PolicyDecision,
+) -> tuple[ToolGrant, ...]:
+    if not decision.allowed:
+        return (
+            ToolGrant("read_workspace", False, "blocked by policy decision"),
+            ToolGrant("write_files", False, "blocked by policy decision"),
+            ToolGrant("execute_shell", False, "blocked by policy decision"),
+            ToolGrant("network_export", False, "blocked by policy decision"),
+        )
+
+    return (
+        ToolGrant("read_workspace", True, "policy allows governed context read"),
+        ToolGrant(
+            "write_files",
+            request.writes_files,
+            "allowed only with visible diff and audit obligation",
+        ),
+        ToolGrant(
+            "execute_shell",
+            request.action == "execute_shell" and request.human_approved,
+            "requires explicit human approval",
+        ),
+        ToolGrant(
+            "network_export",
+            request.exports_data and request.human_approved,
+            "requires export permission, manifest, and approval",
+        ),
+    )

sovereigncode/policy.py

@@ -1,115 +1,290 @@
-"""Deterministic Data Capsule policy decision point (PDP).
-
-Answers, for every sensitive action: can this actor, for this purpose, in this
-region, using this model/tool, touch this capsule?
-
-Returns one of three outcomes: allow, deny, or allow_with_obligations.
-"""
 from __future__ import annotations
 
-import json
 from dataclasses import dataclass, field
-from pathlib import Path
-from typing import Any, Dict, List
+from typing import Any
 
-try:
-    import yaml  # type: ignore
-except ImportError:  # pragma: no cover
-    yaml = None
+HIGH_IMPACT_SENSITIVITY = frozenset({"personal", "restricted", "health", "iwi", "taonga"})
+DESTRUCTIVE_ACTIONS = frozenset({"delete_file", "execute_shell", "network_export", "publish", "commit"})
+PERSONAL_DETAIL_LEVELS = {
+    "none": 0,
+    "anonymous": 1,
+    "pseudonymous": 2,
+    "identifiable": 3,
+    "sensitive_identifiable": 4,
+}
 
 
-@dataclass
-class Decision:
-    allowed: bool
-    decision: str  # "allow" | "deny" | "allow_with_obligations"
-    reasons: List[str] = field(default_factory=list)
-    obligations: List[str] = field(default_factory=list)
+def _tuple_of_text(value: object, *, default: tuple[str, ...] = ()) -> tuple[str, ...]:
+    if value in (None, ""):
+        return default
+    if isinstance(value, str):
+        return (value,)
+    if isinstance(value, (list, tuple, set)):
+        return tuple(str(item).strip() for item in value if str(item).strip())
+    return (str(value).strip(),)
+
+
+def _normal(value: str) -> str:
+    return value.strip().lower().replace(" ", "_").replace("-", "_")
+
+
+def _personal_detail_rank(value: str) -> int:
+    return PERSONAL_DETAIL_LEVELS.get(_normal(value), 0)
 
-    def to_dict(self) -> Dict[str, Any]:
+
+@dataclass(frozen=True, slots=True)
+class DataCapsule:
+    """Policy wrapper for a governed data subject, dataset, or workspace."""
+
+    capsule_id: str
+    subject_id: str
+    jurisdiction: str = "NZ"
+    sensitivity: str = "internal"
+    allowed_purposes: tuple[str, ...] = ("inference", "coding_assistance")
+    denied_purposes: tuple[str, ...] = ()
+    resident_regions: tuple[str, ...] = ("NZ",)
+    data_classes: tuple[str, ...] = ("source_code",)
+    retention_days: int = 30
+    export_allowed: bool = False
+    training_allowed: bool = False
+    personal_detail_level: str = "none"
+    consent_scopes: tuple[str, ...] = ()
+    data_subject_rights: tuple[str, ...] = (
+        "access",
+        "correction",
+        "deletion_request",
+        "processing_objection",
+    )
+    revoked: bool = False
+    schema_context: str = "https://schema.org"
+    consent_record: str = ""
+    metadata: dict[str, Any] = field(default_factory=dict)
+
+    @classmethod
+    def from_payload(cls, payload: dict[str, Any]) -> DataCapsule:
+        return cls(
+            capsule_id=str(payload.get("capsule_id") or payload.get("id") or ""),
+            subject_id=str(payload.get("subject_id") or payload.get("subject") or ""),
+            jurisdiction=str(payload.get("jurisdiction") or "NZ"),
+            sensitivity=_normal(str(payload.get("sensitivity") or "internal")),
+            allowed_purposes=tuple(_normal(item) for item in _tuple_of_text(payload.get("allowed_purposes"), default=("inference",))),
+            denied_purposes=tuple(_normal(item) for item in _tuple_of_text(payload.get("denied_purposes"))),
+            resident_regions=tuple(str(item).upper() for item in _tuple_of_text(payload.get("resident_regions"), default=("NZ",))),
+            data_classes=tuple(_normal(item) for item in _tuple_of_text(payload.get("data_classes"), default=("source_code",))),
+            retention_days=int(payload.get("retention_days") or 30),
+            export_allowed=bool(payload.get("export_allowed", False)),
+            training_allowed=bool(payload.get("training_allowed", False)),
+            personal_detail_level=_normal(
+                str(payload.get("personal_detail_level") or "none"),
+            ),
+            consent_scopes=tuple(
+                _normal(item) for item in _tuple_of_text(payload.get("consent_scopes"))
+            ),
+            data_subject_rights=tuple(
+                _normal(item)
+                for item in _tuple_of_text(
+                    payload.get("data_subject_rights"),
+                    default=(
+                        "access",
+                        "correction",
+                        "deletion_request",
+                        "processing_objection",
+                    ),
+                )
+            ),
+            revoked=bool(payload.get("revoked", False)),
+            schema_context=str(payload.get("schema_context") or "https://schema.org"),
+            consent_record=str(payload.get("consent_record") or ""),
+            metadata=dict(payload.get("metadata") or {}),
+        )
+
+    def to_dict(self) -> dict[str, Any]:
         return {
-            "allowed": self.allowed,
-            "decision": self.decision,
-            "reasons": list(self.reasons),
-            "obligations": list(self.obligations),
+            "capsule_id": self.capsule_id,
+            "subject_id": self.subject_id,
+            "jurisdiction": self.jurisdiction,
+            "sensitivity": self.sensitivity,
+            "allowed_purposes": list(self.allowed_purposes),
+            "denied_purposes": list(self.denied_purposes),
+            "resident_regions": list(self.resident_regions),
+            "data_classes": list(self.data_classes),
+            "retention_days": self.retention_days,
+            "export_allowed": self.export_allowed,
+            "training_allowed": self.training_allowed,
+            "personal_detail_level": self.personal_detail_level,
+            "consent_scopes": list(self.consent_scopes),
+            "data_subject_rights": list(self.data_subject_rights),
+            "revoked": self.revoked,
+            "schema_context": self.schema_context,
+            "consent_record": self.consent_record,
+            "metadata": dict(self.metadata),
         }
 
 
-def _load_yaml_or_json(path: Path) -> Dict[str, Any]:
-    text = path.read_text(encoding="utf-8")
-    if path.suffix.lower() in (".yaml", ".yml"):
-        if yaml is None:
-            raise RuntimeError("pyyaml is required to load YAML policies. `pip install pyyaml`.")
-        return yaml.safe_load(text)
-    return json.loads(text)
+@dataclass(frozen=True, slots=True)
+class SovereignRequest:
+    actor: str
+    purpose: str
+    action: str
+    region: str = "NZ"
+    model_id: str = "local/lumynax"
+    data_classes: tuple[str, ...] = ("source_code",)
+    tool_name: str = ""
+    writes_files: bool = False
+    exports_data: bool = False
+    trains_model: bool = False
+    human_approved: bool = False
+    personal_detail_level: str = "none"
+    consent_scope: str = ""
+    requested_retention_days: int | None = None
+    metadata: dict[str, Any] = field(default_factory=dict)
+
+    @classmethod
+    def from_payload(cls, payload: dict[str, Any]) -> SovereignRequest:
+        return cls(
+            actor=str(payload.get("actor") or "unknown"),
+            purpose=_normal(str(payload.get("purpose") or "inference")),
+            action=_normal(str(payload.get("action") or "read_context")),
+            region=str(payload.get("region") or "NZ").upper(),
+            model_id=str(payload.get("model_id") or "local/lumynax"),
+            data_classes=tuple(_normal(item) for item in _tuple_of_text(payload.get("data_classes"), default=("source_code",))),
+            tool_name=str(payload.get("tool_name") or ""),
+            writes_files=bool(payload.get("writes_files", False)),
+            exports_data=bool(payload.get("exports_data", False)),
+            trains_model=bool(payload.get("trains_model", False)),
+            human_approved=bool(payload.get("human_approved", False)),
+            personal_detail_level=_normal(
+                str(payload.get("personal_detail_level") or "none"),
+            ),
+            consent_scope=_normal(str(payload.get("consent_scope") or "")),
+            requested_retention_days=(
+                int(payload["requested_retention_days"])
+                if payload.get("requested_retention_days") is not None
+                else None
+            ),
+            metadata=dict(payload.get("metadata") or {}),
+        )
 
+    def to_dict(self) -> dict[str, Any]:
+        return {
+            "actor": self.actor,
+            "purpose": self.purpose,
+            "action": self.action,
+            "region": self.region,
+            "model_id": self.model_id,
+            "data_classes": list(self.data_classes),
+            "tool_name": self.tool_name,
+            "writes_files": self.writes_files,
+            "exports_data": self.exports_data,
+            "trains_model": self.trains_model,
+            "human_approved": self.human_approved,
+            "personal_detail_level": self.personal_detail_level,
+            "consent_scope": self.consent_scope,
+            "requested_retention_days": self.requested_retention_days,
+            "metadata": dict(self.metadata),
+        }
 
-def load_capsule(path: str | Path) -> Dict[str, Any]:
-    return _load_yaml_or_json(Path(path))
 
+@dataclass(frozen=True, slots=True)
+class PolicyDecision:
+    allowed: bool
+    reasons: tuple[str, ...]
+    obligations: tuple[str, ...]
+    audit_tags: tuple[str, ...]
 
-def load_request(path: str | Path) -> Dict[str, Any]:
-    return _load_yaml_or_json(Path(path))
+    def to_dict(self) -> dict[str, Any]:
+        return {
+            "allowed": self.allowed,
+            "reasons": list(self.reasons),
+            "obligations": list(self.obligations),
+            "audit_tags": list(self.audit_tags),
+        }
 
 
-def load_policy(path: str | Path) -> Dict[str, Any]:
-    return _load_yaml_or_json(Path(path))
+class SovereigntyPolicyEngine:
+    """Deterministic policy decision point for AbteeX SovereignCode."""
 
+    def evaluate(self, capsule: DataCapsule, request: SovereignRequest) -> PolicyDecision:
+        reasons: list[str] = []
+        obligations: list[str] = [
+            "write_immutable_audit_record",
+            f"retain_trace_no_more_than_{capsule.retention_days}_days",
+            "preserve_capsule_id_in_agent_trace",
+        ]
+        audit_tags: list[str] = [
+            f"jurisdiction:{capsule.jurisdiction.upper()}",
+            f"sensitivity:{capsule.sensitivity}",
+            f"purpose:{request.purpose}",
+        ]
 
-def evaluate(capsule: Dict[str, Any], request: Dict[str, Any], policy: Dict[str, Any]) -> Decision:
-    reasons: List[str] = []
-    obligations: List[str] = list(policy.get("default_obligations", []))
+        if capsule.revoked:
+            reasons.append("capsule consent has been revoked")
+        if request.purpose in capsule.denied_purposes:
+            reasons.append(f"purpose `{request.purpose}` is explicitly denied")
+        if request.purpose not in capsule.allowed_purposes:
+            reasons.append(f"purpose `{request.purpose}` is not in allowed_purposes")
+        if request.region.upper() not in capsule.resident_regions:
+            reasons.append(f"request region `{request.region}` is outside resident_regions")
+        if request.trains_model and not capsule.training_allowed:
+            reasons.append("model training is not allowed for this capsule")
+        if request.exports_data and not capsule.export_allowed:
+            reasons.append("data export is not allowed for this capsule")
+        if request.requested_retention_days and request.requested_retention_days > capsule.retention_days:
+            reasons.append("requested retention exceeds capsule retention_days")
+        if not set(request.data_classes).issubset(set(capsule.data_classes)):
+            reasons.append("request data_classes exceed capsule data_classes")
+        if _personal_detail_rank(request.personal_detail_level) > _personal_detail_rank(
+            capsule.personal_detail_level,
+        ):
+            reasons.append("requested personal_detail_level exceeds capsule consent")
+        if (
+            request.consent_scope
+            and capsule.consent_scopes
+            and request.consent_scope not in capsule.consent_scopes
+        ):
+            reasons.append("request consent_scope is not covered by the capsule")
 
-    purpose = request.get("purpose")
-    if purpose in capsule.get("denied_purposes", []):
-        reasons.append(f"purpose `{purpose}` is in capsule.denied_purposes")
-        return Decision(False, "deny", reasons, obligations)
+        model_is_lumynax_or_local = any(
+            marker in request.model_id.lower()
+            for marker in ("lumynax", "local", "llama.cpp", "gguf")
+        )
+        if capsule.sensitivity in HIGH_IMPACT_SENSITIVITY and not model_is_lumynax_or_local:
+            reasons.append("high-impact data requires a local or LumynaX-governed model")
 
-    allowed_purposes = capsule.get("allowed_purposes", [])
-    if allowed_purposes and purpose not in allowed_purposes:
-        reasons.append(f"purpose `{purpose}` is not in capsule.allowed_purposes")
-        return Decision(False, "deny", reasons, obligations)
+        if request.action in DESTRUCTIVE_ACTIONS and not request.human_approved:
+            reasons.append(f"action `{request.action}` requires human approval")
 
-    region = request.get("region")
-    resident_regions = capsule.get("resident_regions", [])
-    if region and resident_regions and region not in resident_regions:
-        reasons.append(f"region `{region}` is not in capsule.resident_regions `{resident_regions}`")
-        return Decision(False, "deny", reasons, obligations)
+        if request.writes_files:
+            obligations.append("show_diff_before_write_or_commit")
+        if request.exports_data:
+            obligations.append("attach_export_manifest_and_recipient")
+        if request.trains_model:
+            obligations.append("attach_training_consent_record")
+        if capsule.sensitivity in HIGH_IMPACT_SENSITIVITY:
+            obligations.extend(
+                (
+                    "redact_unneeded_personal_data",
+                    "route_only_to_resident_runtime",
+                    "require_human_review_for_external_effects",
+                ),
+            )
+        if "personal" in capsule.data_classes or capsule.sensitivity == "personal":
+            obligations.extend(
+                (
+                    "honour_data_subject_access_and_correction",
+                    "minimise_personal_detail_in_prompt",
+                    "keep_personal_trace_inside_capsule_retention",
+                ),
+            )
 
-    sensitivity = str(capsule.get("sensitivity", "")).lower()
-    high_sensitivity = set(map(str.lower, policy.get("high_impact_sensitivity", [])))
-    is_high = sensitivity in high_sensitivity
-    requires_local = (
-        policy.get("remote_model_rule", {}).get("restricted_data_requires_local_or_lumynax")
-        and is_high
-    )
-    model_id = str(request.get("model_id", "")).lower()
-    if requires_local and not (model_id.startswith("local/") or "lumynax" in model_id):
-        reasons.append("restricted data requires a local or LumynaX-governed model")
-        return Decision(False, "deny", reasons, obligations)
-
-    if request.get("trains_model"):
-        rule = policy.get("training_rule", {})
-        if rule.get("requires_capsule_training_allowed") and not capsule.get("training_allowed", False):
-            reasons.append("training_rule requires capsule.training_allowed = true")
-            return Decision(False, "deny", reasons, obligations)
-
-    if request.get("exports_data"):
-        rule = policy.get("export_rule", {})
-        if rule.get("requires_capsule_export_allowed") and not capsule.get("export_allowed", False):
-            reasons.append("export_rule requires capsule.export_allowed = true")
-            return Decision(False, "deny", reasons, obligations)
-
-    denied_without_approval = set(policy.get("denied_without_human_approval", []))
-    action = request.get("action")
-    if action in denied_without_approval and not request.get("human_approved", False):
-        reasons.append(f"action `{action}` requires human approval")
-        return Decision(False, "deny", reasons, obligations)
-
-    if request.get("writes_files"):
-        obligations.append("show_diff_before_write_or_commit")
-    if is_high:
-        obligations.append("route_to_local_or_lumynax_model")
-
-    obligations = sorted(set(obligations))
-    reasons.append(f"capsule {capsule.get('capsule_id')} permits purpose `{purpose}` in region `{region}`")
-    return Decision(True, "allow_with_obligations" if obligations else "allow", reasons, obligations)
+        allowed = not reasons
+        if not allowed:
+            audit_tags.append("decision:deny")
+        else:
+            audit_tags.append("decision:allow")
+        return PolicyDecision(
+            allowed=allowed,
+            reasons=tuple(reasons),
+            obligations=tuple(dict.fromkeys(obligations)),
+            audit_tags=tuple(dict.fromkeys(audit_tags)),
+        )