IOC L9 Protocol Models

Pydantic models and protocol definitions for the Internet of Cognition (IoC) Layer 9 protocol stack.

Installation

pip install ioc-l9-all-models

Quick Start

# import L9 protocol models
from ai.outshift.data_model import L9, L9Header, L9Payload, Message, Actor, ParticipantSet, Kind

# import SAB subprotocol models + builder (SAB reuses the canonical L9 header)
# from ai.outshift.subprotocols.sab import SABMessageBuilder, SABNegotiatePayloadData

# Create an L9 message
msg = L9(
    header=L9Header(
        protocol="SSTP",
        subprotocol="TFP",
        version="1.0",
        kind=Kind.intent,
        subkind="",
        participants=ParticipantSet(
            actors=[Actor(id="actor-1", role="analyst")],
            groups={"team_alpha": ["actor-1"]},
        ),
    ),
    payload=L9Payload(
        type="text",
        data={"content": "Hello from L9!"},
    ),
)

print(msg.model_dump_json(indent=2))

What's Included

• L9/SSTP — Core protocol Pydantic models (L9, L9Header, L9Payload, Actor, Message, etc.)
• SIEP — Semantic Information Exchange Protocol
• CIP — Cognition and Interoperability Protocol
• SAB — Semantic Alignment Broadcast
• TFP — Team Formation via Polling

Requirements

• Python >= 3.10, < 3.14
• pydantic >= 2.0

Links

• Source Code
• Issue Tracker

License

Apache License 2.0 - See LICENSE for details.