scitrera-messaging-spec

Python reference implementation of the Scitrera Ecosystem Messaging Spec, including the v1.0 chat schema, provider-qualified tool catalog, workspace execution binding, and session attach/recovery protocol.

from scitrera_messaging_spec import (
    ChatMessage, TextPart, ToolCallPart, ToolResultPart,
    apply_event, MessageStarted, PartAppended, TokenDelta,
    to_openai_chat_completion,
)

m = ChatMessage(
    id="msg_1",
    role="assistant",
    content=[
        TextPart(text="hello"),
        ToolCallPart(id="c1", name="get_time", args={}, status="completed"),
        ToolResultPart(call_id="c1", output_text="3pm"),
    ],
)
print(m.model_dump_json())

See the message spec and tool catalog, workspace execution, and session protocol for the normative contracts.

Install

pip install scitrera-messaging-spec

Or, for local development, from a checkout:

pip install -e python