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.6.6

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.6.6
File Size Uploaded Provenance Actions
optio_agents-0.6.6.tar.gz 116.0 kB Without provenance Details for optio_agents-0.6.6.tar.gz

Built distribution (wheel)

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

Total release size: 195.2 kB

Release files / optio_agents-0.6.6.tar.gz

Download URL optio_agents-0.6.6.tar.gz
Size 116.0 kB
Tags Source
SHA-256 checksum
How to use checksums
f071a01faee544db2e00ef430d23336fac43a269901af2f36c5ed49ca64f6f90
BLAKE2b-256 checksum
How to use checksums
c839dcd0b8d4ed0bb6ff79b82f48c9c7480d97d12b9565e530d8490146a5514f
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.6.6-py3-none-any.whl

Download URL optio_agents-0.6.6-py3-none-any.whl
Size 79.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f14f6cb8d055bf926e6ebd9b5a6f2afa9948f3d1d36250147734a606ba2eac5a
BLAKE2b-256 checksum
How to use checksums
fb36bbc9b46ef5d1bb36503d1b73d1547c8c75cb5d0cd71733862bc140233f86
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.6.6

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