lexicor-client 0.1.0a1

Python client SDK for the Lexicor API

Lexicor Python Client

Python SDK for the Lexicor API.

Installation

Once published to PyPI:

pip install lexicor-client

From this repo (editable):

pip install -e sdks/python

From GitHub without a clone:

pip install "git+https://github.com/thebigduck/Lexicor.git#subdirectory=sdks/python"

Publishing / tag process: ../PUBLISH.md.

Quick start

from lexicor_client import LexicorClient

client = LexicorClient("https://api.lexicor.io", api_key="lx-your-key")

ing = client.ingest("Schedule a follow-up with the team next Tuesday.", build_packet=False)
assert ing["parsed"]
my_graph = ing["intent_graph"]
normalized = client.normalize(my_graph)
result = client.roundtrip(my_graph)
comparison = client.compare(my_graph, normalized)

Ingress and LM fallback

Template ingress is the default. Enable model-backed parsing when no template matches (server must have OPENAI_API_KEY):

client.ingest(
    "Some unusual directive…",
    lm_fallback=True,
    build_packet=True,
    render_strategy="ascii_compact",
)

Negotiation and full packets

Advertise capabilities, confirm the session, then build and decode transport packets (same flow as POST /v1/negotiate/* and /v1/packet/*):

agent_id = "my-remote-agent"
client.negotiate_advertise(
    agent_id,
    supported_codecs=["lexicor-line-v1"],
    supported_symbol_tables=["core-sym-1"],
    supported_fidelity_tiers=[0, 1, 2, 3],
)
offer = client.negotiate_offer("sess-001", agent_id)
if offer["type"] != "offer":
    raise RuntimeError(offer.get("reason", "negotiation failed"))
contract = offer["contract"]
client.negotiate_confirm("sess-001")
contract["session_id"] = "sess-001"

built = client.packet_build(
    my_graph,
    session=contract,
    render_strategy="ascii_compact",
    payload_mode="semantic_transport",
)
packet = built["packet"]
decoded = client.packet_decode(packet)
graph = decoded["intent_graph"]

Optional transport= (advanced): pass an httpx.BaseTransport when constructing LexicorClient for custom HTTP behavior.

Features

• Automatic retry with exponential backoff
• Rate limit handling (429 with Retry-After)
• Context manager support
• Type hints throughout