optio-opencode 0.1.0__py3-none-any.whl

optio_opencode/types.py

@@ -0,0 +1,55 @@
+"""Public data types for optio-opencode consumers.
+
+The generic ``DeliverableCallback`` / ``HookCallback`` types and
+``SSHConfig`` are owned by ``optio-host`` (since they describe the
+log/deliverables protocol and SSH config in general). This module
+re-exports them so existing ``from optio_opencode.types import ...``
+imports keep working unchanged.
+"""
+
+from dataclasses import dataclass, field
+from typing import Any, Callable
+
+from optio_host.protocol.session import DeliverableCallback, HookCallback
+from optio_host.types import SSHConfig
+
+
+__all__ = ["DeliverableCallback", "HookCallback", "SSHConfig", "OpencodeTaskConfig"]
+
+
+@dataclass
+class OpencodeTaskConfig:
+    """Configuration for one optio-opencode task instance."""
+    consumer_instructions: str
+    opencode_config: dict[str, Any] = field(default_factory=dict)
+    ssh: SSHConfig | None = None
+    on_deliverable: DeliverableCallback | None = None
+    install_if_missing: bool = True
+    # Absolute path on the host where the opencode binary is/should be
+    # installed. ``None`` (default) → ``~/.local/bin`` (user home resolved
+    # at task start). The same directory is used for installation, for
+    # smart-install's PATH lookup, and for the post-"ok" ``command -v``
+    # resolution, so an explicit override stays consistent across all
+    # three. Must be an absolute path when set.
+    opencode_install_dir: str | None = None
+    workdir_exclude: list[str] | None = None
+    supports_resume: bool = True
+    before_execute: HookCallback | None = None
+    after_execute: HookCallback | None = None
+    # Optional pair of synchronous bytes->bytes transforms wrapping the
+    # opencode session JSON blob at GridFS write/read. When both are set,
+    # the snapshot session blob is encrypted at rest. When both are None
+    # (default), plaintext is used (backward-compatible). Setting only one
+    # raises a config error: asymmetric usage is always a mistake.
+    session_blob_encrypt: Callable[[bytes], bytes] | None = None
+    session_blob_decrypt: Callable[[bytes], bytes] | None = None
+
+    def __post_init__(self) -> None:
+        e = self.session_blob_encrypt is not None
+        d = self.session_blob_decrypt is not None
+        if e != d:
+            raise ValueError(
+                "OpencodeTaskConfig: session_blob_encrypt and "
+                "session_blob_decrypt must be set together (both callables) "
+                "or both left as None; one without the other is a config error."
+            )

optio_opencode-0.1.0.dist-info/METADATA

@@ -0,0 +1,84 @@
+Metadata-Version: 2.4
+Name: optio-opencode
+Version: 0.1.0
+Summary: Run opencode web as an optio task; local subprocess or remote via SSH.
+Author-email: Kristof Csillag <kristof.csillag@deai-labs.com>
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://github.com/deai-network/optio
+Project-URL: Repository, https://github.com/deai-network/optio
+Project-URL: Issues, https://github.com/deai-network/optio/issues
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Framework :: AsyncIO
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: optio-core<0.2,>=0.1
+Requires-Dist: optio-host<0.2,>=0.1
+Requires-Dist: asyncssh>=2.14
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+
+# optio-opencode
+
+Run [opencode web](https://github.com/opencode-ai/opencode) as an [optio](https://github.com/deai-network/optio) task — local subprocess or remote over SSH — with opencode's UI reachable through optio's UI components.
+
+## What it does
+
+Given an `OpencodeTaskConfig` (workdir contents, prompt, deliverable callback), `optio-opencode`:
+
+1. Provisions a fresh workdir on the chosen host (local or remote).
+2. Writes `AGENTS.md` (base prompt + your instructions) and `opencode.json` (your config) into it.
+3. Installs the opencode binary if missing (remote mode only).
+4. Launches `opencode web` with a random auth password.
+5. Registers the opencode UI as a widget that optio's UI components can embed via the widget proxy — SSH tunnel hidden from optio-api.
+6. Tails a log file the LLM writes to and translates structured lines into optio events:
+   - `STATUS: …` → `ctx.report_progress(percent, message)`
+   - `DELIVERABLE: <path>` → fetches the file, invokes your `on_deliverable` callback
+   - `DONE [summary]` → clean completion
+   - `ERROR [message]` → failure
+7. Cleans up workdir and SSH connection on teardown.
+
+The same `OpencodeTaskConfig` works for local and remote modes; only `SSHConfig` differs.
+
+## When to use it
+
+You want an opencode-driven assistant session as a managed optio task — surfaced through optio's UI, with progress reporting and file deliverables — without writing the host management, log parsing, or widget plumbing yourself.
+
+## Installation
+
+```bash
+pip install optio-opencode
+```
+
+Python 3.11+. Depends on `optio-core`, `optio-host`, and `asyncssh`.
+
+## Minimal example
+
+```python
+from optio_opencode import create_opencode_task, OpencodeTaskConfig
+from optio_host import SSHConfig
+
+config = OpencodeTaskConfig(
+    workdir_files={"AGENTS.md": "Do the thing.", "opencode.json": "{...}"},
+    on_deliverable=lambda ctx, path, text: print(f"got {path}: {len(text)} bytes"),
+    ssh=SSHConfig(host="worker-1", user="optio", key_path="~/.ssh/id_optio"),
+)
+
+task = create_opencode_task(config)
+# Schedule / run via optio-core as usual.
+```
+
+Set `ssh=None` for local subprocess mode.
+
+## License
+
+Apache-2.0.

optio_opencode-0.1.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+optio_opencode/__init__.py,sha256=o9iKS_N-sTNR8rliw7teae1-yfYyZXz5QWyPnlCplMc,1040
+optio_opencode/host_actions.py,sha256=NO6iGf-b_GIzinqtcDKeC3EtQFjEMnP17aL6euZlMk8,17331
+optio_opencode/prompt.py,sha256=8L1QSdyu92wNiQOHtFdxR6aR0336CBTYzLaWzjwCiZw,6122
+optio_opencode/session.py,sha256=oySS6pgCH6oOVjquwlrn6Kg4CPD30C3jwuMngB3X5WM,22394
+optio_opencode/snapshots.py,sha256=wKX4OpCMYe-M9-LNZYVBxlaDtw9s15eZhR3c2mxreXw,3285
+optio_opencode/types.py,sha256=Cs46PA6Mv1NraNObd_avWAx5xd8LMQ2elwkL2FpG-aE,2491
+optio_opencode-0.1.0.dist-info/METADATA,sha256=DXDzoM32H1DH59GomwmxnanOsasMjvU_pIRd14ChKp8,3444
+optio_opencode-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+optio_opencode-0.1.0.dist-info/top_level.txt,sha256=1jAPllx4JDiN8gzJtbS206_8fTFSwitP9dv1WkxyiYM,15
+optio_opencode-0.1.0.dist-info/RECORD,,

optio_opencode-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

optio_opencode-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+optio_opencode