Skip to main content

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 prefixed STATUS:, DELIVERABLE:, DONE, or ERROR to ./optio.log. run_log_protocol_session tails the log, dispatches progress events, fetches deliverable files, and resolves the session on DONE / ERROR.
  • optio_agents.protocol.parser — the keyword parser (parse_log_line, the typed *Event dataclasses, 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 and on_deliverable callbacks, wrapping a ProcessContext plus host primitives (run_on_host, copy_file, read_from_host, download_file).
  • optio_agents.conversation — the abstract Conversation Protocol (plus PermissionRequest / 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 through on_event are intentionally backend-specific and passed through transparently. Implemented today by optio-claudecode (ClaudeCodeConversation over 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.9.0

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

Source distribution (sdist)

Source distribution for optio-agents 0.9.0
File Size Uploaded Provenance Actions
optio_agents-0.9.0.tar.gz 151.0 kB Without provenance Details for optio_agents-0.9.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for optio-agents 0.9.0
File Interpreter ABI Platform Actions
optio_agents-0.9.0-py3-none-any.whl Python 3 none any Details for optio_agents-0.9.0-py3-none-any.whl

Total release size: 251.1 kB

Release files / optio_agents-0.9.0.tar.gz

Download URL optio_agents-0.9.0.tar.gz
Size 151.0 kB
Tags Source
SHA-256 checksum
How to use checksums
e3958a29200edb9e8917e46bcc842d0aca8f327cde46baf0e3d72dd8c968d408
BLAKE2b-256 checksum
How to use checksums
2488b2e80ca274569f8ee2ddaba2fd1531cf88ed912e1e093e1e71469cf0b7d9
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.9.0-py3-none-any.whl

Download URL optio_agents-0.9.0-py3-none-any.whl
Size 100.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
0d05c2c7d63ab00b23d1512c6c46241c77d5172fea1e598228f3712d38f8118a
BLAKE2b-256 checksum
How to use checksums
d8310fb34100842d10180d8bdd65f32e4a93d89ad5eb828362d6dd9f03c5bee8
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.9.0

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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page