Skip to content

Repository files navigation

NORDEF Matrix Open Control

A model-independent safety belt for AI agents.

NORDEF Matrix Open Control places deterministic policy, cryptographic human approval, replay protection, shared-channel controls, and hash-chained evidence outside the language model.

A model can propose. The control plane decides what may proceed. Human authority lives outside model text.

Why this exists

The 2026 OpenAI–Hugging Face incident showed that capable agents can:

  • pursue unintended shortcuts when tasks are impossible;
  • build unauthorized communication channels through shared infrastructure;
  • adopt goals and techniques from other agents;
  • escape intended network boundaries through allowed dependencies;
  • seek credentials and interact with unrelated third-party systems;
  • attempt to spoof tool calls or manipulate evaluation transcripts.

A system prompt alone is not an enforcement boundary. This project provides a small reference control plane that does not depend on a particular model or model provider.

Current LAB capabilities

  • deterministic 0 / 1 / 2 decisions;
  • untrusted-content boundary before model transport;
  • shared writable channel detection;
  • exact action/target/scope/side-effect request hashes;
  • Ed25519-signed human mandates with TTL ≤ 900 seconds;
  • persistent one-time nonce replay prevention;
  • test-only attestations rejected from authorization;
  • append-only SHA-256 evidence chain;
  • raw protected input stored only as a hash;
  • dry-run action manifest after valid authorization;
  • execute=false for every path in this LAB candidate;
  • incident-pattern evaluation bank.

Truth boundary

This is a LAB reference implementation, not a claim of general AI safety.

It does not:

  • train or modify a language model;
  • guarantee detection of every prompt injection;
  • replace operating-system, network, container, identity, or hardware isolation;
  • provide a live shell, firewall, cloud, customer, or production connector;
  • make technical attribution about an attacker;
  • allow a model to authorize itself.

Real enforcement must be placed in components the agent cannot modify: network policy, identity systems, executor permissions, evidence storage, and human approval hardware/processes.

Quick verification

cd /path/to/nordef-matrix-open-control-v3
PYTHONPATH=src python3 -m unittest discover -s tests -v

PYTHONPATH=src python3 scripts/run_eval.py \
  --bank evals/openai_hf_incident_patterns.jsonl \
  --state-dir /tmp/nordef-open-control-eval

Expected result:

29 tests: PASS
10 eval cases: PASS
0 actions executed

Decision states

Code Meaning Default result
0 read-only / controlled may reach model transport; no action execution
1 review / side effect requested held for human root or authorized dry-run only
2 blocked does not reach model transport when blocked at input boundary

A valid mandate proves authorization only. It does not mean an action ran. This candidate emits an immutable dry-run manifest with execute=false.

Root mandate contract

A signed mandate binds:

  • human subject;
  • exact action;
  • exact target;
  • exact scope;
  • side-effect flag;
  • issue and expiry timestamps;
  • one-time nonce;
  • canonical request hash;
  • trusted key ID;
  • non-test status.

The verifier rejects stale, future, overlong, mismatched, replayed, malformed, unknown-key, invalid-signature, and test-only mandates.

Project layout

src/nordef_open_control/
  policy.py       deterministic input/action policy
  channels.py     cross-agent shared-channel boundary
  root_gate.py    Ed25519 mandate verification
  replay.py       persistent one-time nonce registry
  evidence.py     sanitized append-only hash chain
  control.py      model-independent orchestration gate
  eval.py         deterministic eval-bank runner

evals/            incident-pattern JSONL bank
scripts/          command-line verifier
tests/            unit and integration tests

Open-source boundary

This repository is intended to be the safety belt, not a release of proprietary models, routing systems, private infrastructure, credentials, customer data, or internal connectors.

Status

  • Version: 3.0.0-lab
  • Side effects: OFF
  • Live routing: OFF
  • Customer use: OFF
  • Public publication: not performed

Created by Morten Büür / Nordlys Datacenter with Eirik / NORDEF Matrix.

About

NORDEF Matrix Open Control: model-independent AI safety belt with 0/1/2 decisions, Ed25519 root gate, replay protection, evidence chain, and incident-pattern eval bank

Resources

Security policy

Stars

160 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages