Metadata-Version: 2.1
Name: agent-brain-uds
Version: 10.2.1
Summary: Agent Brain UDS - Unix-domain-socket transport for Agent Brain (socket path resolution, permission validation, httpx UDS client factory)
Home-page: https://github.com/SpillwaveSolutions/agent-brain
License: MIT
Keywords: agent-brain,uds,unix-domain-socket,transport,httpx,ipc
Author: Spillwave Solutions
Requires-Python: >=3.10,<4.0
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: httpx (>=0.28.0,<0.29.0)
Project-URL: Documentation, https://github.com/SpillwaveSolutions/agent-brain/wiki
Project-URL: Repository, https://github.com/SpillwaveSolutions/agent-brain
Description-Content-Type: text/markdown

# agent-brain-uds

Unix-domain-socket transport for [Agent Brain](https://github.com/SpillwaveSolutions/agent-brain).

**Client-side only.** This package provides:

- Socket path resolution (`resolve_socket_path`) consistent with `agent-brain-server`'s state-dir layout.
- Permission validation (`validate_socket`) — owner-UID match, no group/world bits, no-symlink check.
- `httpx`-compatible client factory (`make_client` / `make_async_client`) speaking HTTP/1.1 over UDS.

The corresponding server-side bind (`agent_brain_server.api.uds_bind`) lives in `agent-brain-server` to keep the dep direction acyclic.

## Status

Phase 0 scaffold (10.0.7) — public surface lands in Phase 1.
See [`docs/plans/2026-05-28-mcp-uds-transport-design.md`](../docs/plans/2026-05-28-mcp-uds-transport-design.md).

## License

MIT

