crimsonos — Protocol Scaffold (Python)

Phase: SCAFFOLDING · Canonical source of truth: MASTER_ARCHITECTURE.md

This wheel is not the Crimson OS runtime. It ships typed protocol stubs from runtime/crimsonos/ in the monorepo — routing shapes, token schemas, bridge file format, and a demo IG audit. The live system (daemons, NAS, Agent_Bridge ledger, cockpit on :8093) is in the repo and on operator hardware.

What is actually live (per MASTER_ARCHITECTURE §3–§4)

Sovereignty rule (§4): Anything not named in the master control plane is a sub-function under a core node — not a separate running agent.

Canonical control plane (target topology)

OPERATOR (final authority)
    └── Q (orchestrator + counsel)
            Council of Four: Orchestrator · Advisor · IG · Science Officer
    ├── N.E.O.     — backend / inference / sysadmin (Node 0, LIVE)
    ├── Q          — frontend cockpit (Node 1, LIVE)
    ├── CMO_Edge   — edge ops / broadcast (Node 2, PARTIAL)
    └── RINGMASTER — curator → Library (SCAFFOLDING)

Legacy 17 named agent stubs are documented for archive to cold store (MASTER_ARCHITECTURE §13 open items). Do not read them as operational agents.

Full node table (IPs, ports 8092/8093): see MASTER_ARCHITECTURE §9.

What this package contains

Install

pip install crimsonos

Development install from monorepo:

git clone https://github.com/ultranetcommand-neo/Crimson-OS.git
cd Crimson-OS/runtime/crimsonos
pip install -e .

Quick start (scaffold demo)

from crimsonos.dispatcher import Dispatcher
from crimsonos.super_token import LogosToken

dispatcher = Dispatcher()
token = LogosToken(
    content="Route this task.",
    context={"operator_mode": "architect"},
    originating_node=1,
    target_agent="q_orchestrator",
)
result = dispatcher.route(token)
print(result)  # routing decision only — no agent executes

Tutorials and full docs live in the repo, not necessarily in the wheel: runtime/crimsonos/tutorials/, docs/STATUS.md.

What is NOT in this package

• Agent_Stack/ job descriptions as executable agents
• Agent_Bridge markdown ledger on NAS
• 12-ring Silo ontology runtime
• Finance Engine, Expand/Contract/Judge valve, gate daemons
• Cockpit API (:8093), intranet (:8092)

Read the monorepo: Crimson-OS · SILO_INDEX.md · GLOSSARY.md

License

Apache 2.0 · Matt Gibson / Crimson Symphony Media