kollabor-rpc

kollabor-rpc is the lightweight RPC transport foundation for Kollabor daemon and attach-mode state access.

It provides request/response models, error types, a method-dispatch server, a client, and Unix-socket transport helpers. The current package is intentionally small and stdlib-only.

Current Role

Represent RPC requests and responses with stable IDs.
Dispatch named methods to async handlers.
Provide client helpers for request/response calls.
Wrap common RPC errors such as timeout, missing method, and handler failure.
Provide Unix socket connection helpers with a larger buffer limit.

Architecture

Module	Responsibility
`models.py`	`RpcRequest`, `RpcResponse`, request ID helpers
`errors.py`	RPC exception hierarchy
`server.py`	handler registration and dispatch
`client.py`	request client abstraction
`transport.py`	Unix transport helpers and buffer settings

Usage

from kollabor_rpc import RpcServer

server = RpcServer()


async def ping(params):
    return {"ok": True, "echo": params.get("echo")}


server.register("ping", ping)
reply = await server.handle_wire({
    "request_id": "req_1",
    "method": "ping",
    "params": {"echo": "hello"},
})

Known Gaps

This package is still a transport foundation; higher-level StateService method contracts live outside the package.
Wire-format compatibility should be documented alongside the hub/attach socket protocol.
Current tests focus on integration through hub sockets; package-local unit coverage should grow as the API stabilizes.

Roadmap

Phase 1: Contract docs

Document the exact frame format used by attach clients and hub sockets.
Add examples for both direct dispatch and socket-backed clients.
Clarify which errors are transport failures versus handler failures.

Phase 2: StateService integration

Keep RPC generic, but document the StateService method namespace that uses it.
Add contract tests for high-value state methods.
Add compatibility checks for attached streaming and request/reply flows.

Phase 3: Operational hardening

Add timeout/cancellation guidance for callers.
Improve observability for slow handlers and failed frames.
Keep the package stdlib-only unless a transport dependency becomes essential.

Development

Targeted validation examples:

python -m py_compile packages/kollabor-rpc/src/kollabor_rpc/*.py
python -m pytest tests/test_hub_rpc_integration.py -q

Dependencies

None. This package is intentionally stdlib-only.

License

MIT

Metadata

Release files for kollabor-rpc 0.15.7

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

Source distribution (sdist)

Source distribution for kollabor-rpc 0.15.7
File	Size	Uploaded
kollabor_rpc-0.15.7.tar.gz	15.7 kB	Oct 13, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for kollabor-rpc 0.15.7
File	Interpreter	ABI	Platform	Reset
kollabor_rpc-0.15.7-py3-none-any.whl 10.2 kB Oct 13, 2026	Python 3	none	any	Details

Total release size: 25.9 kB

Release files / kollabor_rpc-0.15.7.tar.gz

Download URL	kollabor_rpc-0.15.7.tar.gz
Size	15.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`b8d2a6559c176a5aae131ee775b7fd37b1fc84b4c927d9b45361a92e728bfc8d`
BLAKE2b-256 checksum How to use checksums	`18f32a067ad02e2b8505a9211aadccf027f25bd0d07a282487ab57ec0f945588`
Upload date	Oct 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.15`

Release files / kollabor_rpc-0.15.7-py3-none-any.whl

Download URL	kollabor_rpc-0.15.7-py3-none-any.whl
Size	10.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`6feb5ac3b70cfdaad6c7782c0ac93699a38490e196f6674246247b0467c6c494`
BLAKE2b-256 checksum How to use checksums	`d244bfd84b5f43500de57ebf37202aa1c5d2ac3b9fa7a16942b32e435843eb8b`
Upload date	Oct 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.15`