Skip to main content

meadows-protocol

Pure declaration of the MEADOWS protocol: envelope, event names, JWT claims, permissions, labels. No behavior. See MEADOWS-migration-intent.md section 3.1.

What this package contains

  • envelope.py — Message model, MessageType enum, QuotedMessage, mention/everyone parsing
  • events.py — EventName constants (the closed set of Socket.IO events)
  • jwt.py — JWTClaims model, JWTRole, build_claims() helper
  • permissions.py — AVAILABLE_PERMISSIONS (single source of truth)
  • labels.py — Label triplet (origin, label, semver); reserved origins: meadows, system
  • codec.py — reference encoder/decoder, subordinated to the models (not the source of truth)

Install

cd meadows-protocol
uv pip install -e .

Test

uv run pytest -q

Usage

from meadows.protocol import (
    Message,
    MessageType,
    EventName,
    JWTClaims,
    JWTRole,
    build_claims,
    Label,
    AVAILABLE_PERMISSIONS,
)

The protocol boundary (section 3.2 sort rule)

The system contracts what it itself must understand. What only bots and humans need to understand stays opaque.

In protocol: envelope fields, event names, JWT claims, system-message bodies, the label signaling mechanism. Not in protocol: the content payload of ordinary messages (opaque Markdown), domain schemas (SLO results, export formats, todo shapes).

Labels (section 3.5)

A sender declares a body-sort via a triplet: Label("meadows", "interactive-form", "1.0.0").

  • origin: who declares this label. Reserved: meadows, system. Extensible to bot/UI names later.
  • label: the sort name.
  • semver: version of this label's contract.

Forms is the first concrete use case (postponed to iteration 4).

Metadata

Release files for meadows-protocol 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for meadows-protocol 0.1.0
File Size Uploaded Provenance Actions
meadows_protocol-0.1.0.tar.gz 57.2 kB Without provenance Details for meadows_protocol-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for meadows-protocol 0.1.0
File Interpreter ABI Platform Actions
meadows_protocol-0.1.0-py3-none-any.whl Python 3 none any Details for meadows_protocol-0.1.0-py3-none-any.whl

Total release size: 69.2 kB

Release files / meadows_protocol-0.1.0.tar.gz

Download URL meadows_protocol-0.1.0.tar.gz
Size 57.2 kB
Tags Source
SHA-256 checksum
How to use checksums
a372fc366a41cec9325b8162a4655d973e7bbb76a049ddc377e0e99af55acf89
BLAKE2b-256 checksum
How to use checksums
297b23c02408b437648d365a78b2063edf90aa0c69669dfc77c556d410bd6a6c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.15 {"installer":{"name":"uv","version":"0.9.15","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Linux Mint","version":"22.3","id":"zena","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / meadows_protocol-0.1.0-py3-none-any.whl

Download URL meadows_protocol-0.1.0-py3-none-any.whl
Size 12.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
19e9b8a0cfc4b7fbea7c9efeaf2ff9b094c9d3736c97399ddbab7a561b19f32b
BLAKE2b-256 checksum
How to use checksums
ef8b9d36818a52734819872c6e6b8f3a3400452f875502873465d81ac94e0648
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.15 {"installer":{"name":"uv","version":"0.9.15","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Linux Mint","version":"22.3","id":"zena","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for meadows-protocol 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page