orchestrata_ultimate.cxp

Reference › orchestrata_ultimate › cxp

Cross-agent eXchange Protocol (CXP) Implementation.

The cxp package implements the Cross-agent eXchange Protocol (Spec 004), the structured way Orchestrata's volks pass work to each other. The packet model itself lives in core.packet; this package supplies everything around it. Its narrative is cxp.

Parts, by role:

• Vocabulary: constants, types, exceptions, interfaces, version and version_compat.
• Packet handling: headers, payload, priority, deterministic_ids, validator, schema, and the serializers json_serializer, binary_serializer and serializer.
• Routing and delivery: router, dispatcher, delivery_status, work_status, prolog_bridge for governance, and the legacy handler.
• Conversations and adapters: threads, thread_store, postman_adapter and session_adapter.
• Transport: transport (the factory), direct_cxp_adapter and direct_transport (the cxpt transport), servicer and reply_router (the service core), proto_codec with the proto messages, endpoint_config, and the standalone ws_client and ws_server.

Flow: a sender builds a packet, which is validated, routed by CXPRouter (with Prolog governance when a bridge is present) and delivered by CXPDispatcher, while trackers hold delivery and work state. Across processes, transport.create_cxp_client returns a DirectCXPClient that sends packets to a DirectCXPServer, which hands them to CXPServicer and the configured packet handler; replies go to per-consumer queues. The gateway server is the main client. Start reading at transport for the wire side or router for the logic.

Curated narrative

The hand-written story of this package: orchestrata_ultimate.cxp.

37 modules, 9,628 lines of code.

Subpackages

Modules

Dependency diagram