optio-agents
The agent-coordination layer for optio task types.
optio-agents owns the log/deliverables keyword protocol that long-running on-host agents use to talk back to optio, the session driver that parses and dispatches it, the HookContext handle passed to agent task hooks, and the single source of truth for the LLM-facing keyword documentation.
What's in the box
optio_agents.protocol— a line-oriented session driver. A long-running agent on the host writes lines prefixedSTATUS:,DELIVERABLE:,DONE, orERRORto./optio.log.run_log_protocol_sessiontails the log, dispatches progress events, fetches deliverable files, and resolves the session onDONE/ERROR.optio_agents.protocol.parser— the keyword parser (parse_log_line, the typed*Eventdataclasses, deliverable-path validation).optio_agents.protocol.prompt—LOG_CHANNEL_PROMPT, the canonical LLM-facing documentation of the keywords, co-located with the parser regexes it documents so the two cannot drift. Consumers compose it into their own agent-facing prompt.HookContext/HookContextProtocol— the handle passed into task hooks andon_deliverablecallbacks, wrapping aProcessContextplus host primitives (run_on_host,copy_file,read_from_host,download_file).optio_agents.conversation— the abstractConversationProtocol (plusPermissionRequest/PermissionDecision/ConversationClosed): the semantic surface for talking to a live agent session —send,on_event,on_message,on_permission_request,is_pending,interrupt,close. The semantics are backend-agnostic, but the raw events delivered throughon_eventare intentionally backend-specific and passed through transparently. Implemented today byoptio-claudecode(ClaudeCodeConversationover claude's stream-json stdio protocol).
Dependency direction
optio-agents depends on optio-host (host transport: running commands, file transfer, tunnels) and optio-core. It is consumed by agent task packages such as optio-opencode.
Installation
pip install optio-agents
Python 3.11+.
License
Apache-2.0.
Metadata
Release files for optio-agents 0.7.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| optio_agents-0.7.2.tar.gz | 132.0 kB | Without provenance | Details for optio_agents-0.7.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| optio_agents-0.7.2-py3-none-any.whl | Python 3 | none | any | Details for optio_agents-0.7.2-py3-none-any.whl |
Total release size: 221.7 kB
Release files / optio_agents-0.7.2.tar.gz
| Download URL | optio_agents-0.7.2.tar.gz |
|---|---|
| Size | 132.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e0f6da4abe90b247c9bbb4416d3f95825bac307b01af89f5128aa02245e45941
|
|
BLAKE2b-256 checksum How to use checksums |
82ebd6582dd199535d7db6d83bf75cf78186f4d40e1cdba48ae5ba3ccf445a78
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.5
|
Release files / optio_agents-0.7.2-py3-none-any.whl
| Download URL | optio_agents-0.7.2-py3-none-any.whl |
|---|---|
| Size | 89.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f4c222ff5025a89521b4ae3db2327368f381d3d14083b5733142ef71b09af73d
|
|
BLAKE2b-256 checksum How to use checksums |
924cf9e54dfd229d3b02bdb080ed127b7b60a9a95ec4ebcdaa883f0e18808881
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.5
|
Security for optio-agents 0.7.2
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.