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

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.2
File Size Uploaded Provenance Actions
optio_agents-0.6.2.tar.gz 113.1 kB Without provenance Details for optio_agents-0.6.2.tar.gz

Built distribution (wheel)

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

Total release size: 190.6 kB

Release files / optio_agents-0.6.2.tar.gz

Download URL optio_agents-0.6.2.tar.gz
Size 113.1 kB
Tags Source
SHA-256 checksum
How to use checksums
bd22023f082cdf14b202008424a5a882d62a60c74e398448ba6646a10fae87db
BLAKE2b-256 checksum
How to use checksums
2b3567d43a1d3a602e74525565f705f080347abc1e3262f6602923d3435309a1
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.2-py3-none-any.whl

Download URL optio_agents-0.6.2-py3-none-any.whl
Size 77.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
cab1ece2e5962040edcd1a229d5b15960bc5a074300e4cfc80a1eafd8875b4a3
BLAKE2b-256 checksum
How to use checksums
a356400e2c0bbeaf17516e433dc9aeb3403da619d9668be7cd7f51fe4b4034cb
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.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.

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