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.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 optio-agents 0.6.7
File Size Uploaded Provenance Actions
optio_agents-0.6.7.tar.gz 118.9 kB Without provenance Details for optio_agents-0.6.7.tar.gz

Built distribution (wheel)

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

Total release size: 199.8 kB

Release files / optio_agents-0.6.7.tar.gz

Download URL optio_agents-0.6.7.tar.gz
Size 118.9 kB
Tags Source
SHA-256 checksum
How to use checksums
706fa2e21382232c556eea0021193e782af28ec07eec5a1a9558844233d167c3
BLAKE2b-256 checksum
How to use checksums
dcd7fa0a6db77ed3b0db7b0576125bcda1c4a341a2c9ceb369119d32e81a1f81
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.7-py3-none-any.whl

Download URL optio_agents-0.6.7-py3-none-any.whl
Size 80.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1fb04128a6afec765550dca6b6ec424a2823c1927a9517728011ccee05f7d95b
BLAKE2b-256 checksum
How to use checksums
01794f7ba506647943b7b2ca93031332856a4eb7be6207f2f112926195eb56fe
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.7

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