opencode-runtime 0.4.0__py3-none-any.whl → 0.4.1__py3-none-any.whl

opencode_runtime/__init__.py

@@ -2,7 +2,7 @@
 opencode-runtime: runtime infrastructure for multi-user OpenCode deployments.
 """
 
-__version__ = "0.4.0"
+__version__ = "0.4.1"
 
 from .event import OpenCodeEvent
 from .runtime import OpenCodeRuntime

opencode_runtime/client.py

@@ -154,7 +154,7 @@ class OpenCodeClient:
           delta string when ``properties.field == "text"``.
         * ``message.part.updated`` — full part snapshot (text, tool, thinking,
           …); ``event.text`` is the text content when ``part.type == "text"``.
-        * ``session.status`` — status change (e.g. ``{type: "running"}``).
+        * ``session.status`` — status change (e.g. ``{type: "busy"}``).
         * ``session.idle`` — terminal; model finished.
         * ``session.error`` — terminal; something went wrong.
         * ``permission.asked`` — tool permission request; caller must handle.
@@ -222,7 +222,3 @@ class OpenCodeClient:
                         return
                     if event_type == "session.error":
                         return
-                    if event_type == "session.status":
-                        status = props.get("status", {})
-                        if isinstance(status, dict) and status.get("type") == "idle":
-                            return

opencode_runtime/event.py

@@ -9,9 +9,10 @@ class OpenCodeEvent:
     """A normalized event from the OpenCode server SSE stream.
 
     Attributes:
-        type:  Event type string, e.g. "message.delta", "message.completed",
+        type:  Event type string, e.g. "message.part.delta", "message.part.updated",
                "session.error". Mirrors the OpenCode bus event types.
-        text:  Text content for message.delta events; None for other types.
+        text:  Text content for message.part.delta events (when properties.field == "text")
+               and message.part.updated events (when part.type == "text"); None otherwise.
         raw:   The raw event payload from the server. Use this escape hatch
                when you need fields beyond type and text.
     """

opencode_runtime/response.py

@@ -9,7 +9,7 @@ class OpenCodeResponse:
     """Collected response from a completed ask() call.
 
     Attributes:
-        text:  Full assistant text, concatenated from all message.delta events.
+        text:  Full assistant text, concatenated from all message.part.delta events.
         raw:   List of raw event objects received during the session, in order.
                Use this as an escape hatch when you need parts beyond plain text.
     """

opencode_runtime/server.py

@@ -327,7 +327,7 @@ class ServerManager:
         if server_dir is not None:
             process_env["HOME"] = str(server_dir)
             process_env["TMPDIR"] = str(server_dir / "tmp")
-            process_env["OPENCODE_CONFIG_HOME"] = str(server_dir)
+            process_env["OPENCODE_CONFIG"] = str(server_dir / "opencode.json")
 
         if server_dir is not None:
             log_file = open(server_dir / "opencode.log", "ab")

opencode_runtime/session.py

@@ -77,7 +77,10 @@ class OpenCodeSession:
         async for event in self.stream(message, **kwargs):
             raw_events.append(event.raw)
             if event.type == "session.error":
-                raise OpenCodeServerError(event.text or "unknown error from opencode server")
+                props = (event.raw or {}).get("properties") or {}
+                err = props.get("error") or {}
+                msg = (err.get("data") or {}).get("message") or err.get("name") or "unknown error"
+                raise OpenCodeServerError(msg)
             if event.type == "message.part.delta" and event.text:
                 text += event.text
 

opencode_runtime-0.4.1.dist-info/METADATA

@@ -0,0 +1,125 @@
+Metadata-Version: 2.4
+Name: opencode-runtime
+Version: 0.4.1
+Summary: Embed OpenCode in your Python application.
+Project-URL: Homepage, https://github.com/ashish16052/opencode-runtime
+Project-URL: Repository, https://github.com/ashish16052/opencode-runtime
+Project-URL: Issues, https://github.com/ashish16052/opencode-runtime/issues
+Author: Ashish Mohite
+License-Expression: Apache-2.0
+License-File: LICENSE
+Keywords: AI coding agent,agent runtime,lifecycle management,multi-user,opencode,workspace isolation
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Requires-Dist: httpx
+Provides-Extra: dev
+Requires-Dist: build; extra == 'dev'
+Requires-Dist: hatchling; extra == 'dev'
+Requires-Dist: mypy; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-asyncio; extra == 'dev'
+Requires-Dist: pytest-timeout; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Requires-Dist: twine; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# opencode-runtime
+
+**Embed OpenCode in your Python application.**
+
+OpenCode is a great CLI coding agent. But to embed it in a product, SaaS
+backend, or multi-user automation system, you need more than a CLI process.
+
+opencode-runtime turns OpenCode into a managed application runtime for
+Python. It uses OpenCode as the agent harness and adds what you need to
+run it as part of an application: lifecycle management, per-user
+workspaces, reusable sessions, health checks, streaming output, and
+multi-server orchestration.
+
+## Install
+
+```sh
+pip install opencode-runtime
+npm install -g opencode-ai   # opencode must be on PATH
+```
+
+## Use
+
+### Your first session
+
+```python
+from opencode_runtime import OpenCodeRuntime
+
+async with OpenCodeRuntime() as r:
+    session = await r.session()
+    response = await session.ask("Explain this repo")
+    print(response.text)
+```
+
+### One server per user, automatically
+
+Every `(workspace, user_id)` pair gets its own isolated server, workspace, and conversation history — started on first use, reused after:
+
+```python
+async with OpenCodeRuntime(runtime_dir=".opencode-runtime") as r:
+    s1 = await r.session(workspace="org_a", user_id="u_1")
+    s2 = await r.session(workspace="org_b", user_id="u_2")
+```
+
+### Stream every token as it arrives
+
+```python
+async for event in session.stream("Review this PR"):
+    if event.type == "message.part.delta" and event.text:
+        print(event.text, end="", flush=True)
+```
+
+## Inspect
+
+Servers started from Python are visible and manageable from the terminal:
+
+```sh
+opencode-runtime ps
+```
+
+```
+  ID                  PID    PORT    STATUS     UPTIME    WORKSPACE   USER    PROJECT
+  ──────────────────────────────────────────────────────────────────────────────────
+  39dce5beb4debfaa   12051   58409   ● alive    Up 5m     org_a       u_1     ~/Developer/myproject
+  81fa29acb3e9210f   12088   58411   ● alive    Up 3m     org_b       u_2     ~/Developer/myproject
+```
+
+```sh
+opencode-runtime health 39dce5beb4debfaa
+opencode-runtime stop-all
+```
+
+## Guides
+
+- [OpenCode config](docs/opencode-config.md) — models, permissions, agents, skills
+- [Sessions](docs/sessions.md) — continuation, resume across restarts
+- [Users & workspaces](docs/users-and-workspaces.md) — multi-tenant isolation
+- [Streaming](docs/streaming.md) — event types, tool calls, permissions, cost
+- [CLI](docs/cli.md) — manage your fleet from the terminal
+- [HTTP client](docs/http-client.md) — direct server access
+
+## Requirements
+
+- Python 3.10+
+- `opencode` 1.0+ on PATH
+
+## Contributing
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md).
+
+## License
+
+Apache 2.0

opencode_runtime-0.4.1.dist-info/RECORD

@@ -0,0 +1,16 @@
+opencode_runtime/__init__.py,sha256=RNZO_09NXusYD_xhbeJLb2HCp_0JeogNEi6247mPcL4,362
+opencode_runtime/cli.py,sha256=byy2ezufQvk5f_e1nwDN8ZIFflIwgvuC9SX7HQGYTkU,8938
+opencode_runtime/client.py,sha256=XZw413XiTOaAeKY5WufmMFsDAlullel50i_N5A0wYyM,9069
+opencode_runtime/event.py,sha256=7tWTLXTVUB6g3Ni7jiG2VYdHhjU9rpiwrY0MT1RnEMQ,960
+opencode_runtime/exceptions.py,sha256=uarBFCh8ovI3w4ZB4oQuffv97-5nwTdkZQrkBcOWtWs,471
+opencode_runtime/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+opencode_runtime/registry.py,sha256=rxr3D4iqceskmPBYvRC_lbtME8hoMR4I6rsdYCqllLA,2309
+opencode_runtime/response.py,sha256=MmT4qiakWD55J8cFg64VOztusfWkynrucdjbm0srNks,541
+opencode_runtime/runtime.py,sha256=magKzC-kN7g9bsttNhSLEif9hD92_qrHgJgvXDOauYU,5255
+opencode_runtime/server.py,sha256=eu2JwLwkpICRviZx4OmN2z2_gVWCkfnm4qhcQRW3bSw,12595
+opencode_runtime/session.py,sha256=9ES_mVvXWFhLPNnFFY9KwvRi_4zoVNTe8EToU8oe3ng,5777
+opencode_runtime-0.4.1.dist-info/METADATA,sha256=IkOu8zi4YGNidowr_OUYpypcvCYsq4R1-z8ul8-ocZc,4179
+opencode_runtime-0.4.1.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+opencode_runtime-0.4.1.dist-info/entry_points.txt,sha256=4lbdu1KELOg8TD6F7gC-Xrt3VJXdk3RTaH8cQHVy-Tc,63
+opencode_runtime-0.4.1.dist-info/licenses/LICENSE,sha256=EVYfwpsynn_pB9fQ0OhMX-ghTZM10CrFAPv1JbLODi4,11343
+opencode_runtime-0.4.1.dist-info/RECORD,,

{opencode_runtime-0.4.0.dist-info → opencode_runtime-0.4.1.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: hatchling 1.30.1
+Generator: hatchling 1.31.0
 Root-Is-Purelib: true
 Tag: py3-none-any

opencode_runtime-0.4.0.dist-info/METADATA

@@ -1,299 +0,0 @@
-Metadata-Version: 2.4
-Name: opencode-runtime
-Version: 0.4.0
-Summary: Python runtime for deploying and managing OpenCode instances at scale.
-Project-URL: Homepage, https://github.com/ashish16052/opencode-runtime
-Project-URL: Repository, https://github.com/ashish16052/opencode-runtime
-Project-URL: Issues, https://github.com/ashish16052/opencode-runtime/issues
-Author: Ashish Mohite
-License-Expression: Apache-2.0
-License-File: LICENSE
-Keywords: AI coding agent,agent runtime,lifecycle management,multi-user,opencode,workspace isolation
-Classifier: Development Status :: 3 - Alpha
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: Apache Software License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Requires-Python: >=3.10
-Requires-Dist: httpx
-Provides-Extra: dev
-Requires-Dist: build; extra == 'dev'
-Requires-Dist: hatchling; extra == 'dev'
-Requires-Dist: mypy; extra == 'dev'
-Requires-Dist: pytest; extra == 'dev'
-Requires-Dist: pytest-asyncio; extra == 'dev'
-Requires-Dist: pytest-timeout; extra == 'dev'
-Requires-Dist: ruff; extra == 'dev'
-Requires-Dist: twine; extra == 'dev'
-Description-Content-Type: text/markdown
-
-# opencode-runtime
-
-Python runtime for deploying and managing OpenCode instances at scale.
-
----
-
-Running OpenCode for a single developer is simple.
-
-Running OpenCode for many users, isolated repositories, persistent workspaces,
-multiple OpenCode instances, and production workloads requires infrastructure.
-
-OpenCode Runtime provides that infrastructure.
-
-**Use this when you need to:**
-- Run OpenCode for multiple users or teams from a Python backend
-- Give each user an isolated workspace with no shared state
-- Embed OpenCode in a SaaS product or internal platform
-- Manage OpenCode instance lifecycles (start, health-check, reuse, stop)
-- Stream OpenCode responses to your application in real time
-
-**What it provides:**
-- **One instance per user** — automatically started, isolated, and reused
-- **Filesystem isolation** — each user gets a private workspace; no shared state
-- **Lifecycle management** — health-checked startup, graceful shutdown, stale process recovery
-- **Streaming** — consume every OpenCode event as it arrives
-- **Native OpenCode config** — your existing `opencode.json`, agents, and skills drop in unchanged
-
-## Install
-
-```sh
-pip install opencode-runtime
-```
-
-Requires `opencode` on PATH:
-
-```sh
-npm install -g opencode-ai
-```
-
-## Usage
-
-### Ask
-
-```python
-from opencode_runtime import OpenCodeRuntime
-
-async with OpenCodeRuntime() as r:
-    session = await r.session()
-    response = await session.ask("Explain this repo")
-    print(response.text)
-```
-
-### Config
-
-Pass a raw `opencode.json` dict to control model, permissions, and any other OpenCode-native setting:
-
-```python
-from opencode_runtime import OpenCodeRuntime
-
-async with OpenCodeRuntime(
-    config={"model": "anthropic/claude-sonnet-4-5", "permission": {"bash": "deny"}},
-) as r:
-    session = await r.session()
-    response = await session.ask("Analyse the architecture")
-    print(response.text)
-```
-
-### Materials
-
-Pass a directory of OpenCode-native files — `AGENTS.md`, `opencode.json`, `.opencode/skills/`, etc. — and they are copied into the server before it starts:
-
-```python
-from opencode_runtime import OpenCodeRuntime
-
-async with OpenCodeRuntime(materials="./opencode-materials") as r:
-    session = await r.session()
-    response = await session.ask("Follow the instructions in AGENTS.md")
-    print(response.text)
-```
-
-### Isolation
-
-Set `project_dir` and `runtime_dir` to give the server its own `HOME`, config, and conversation history — separate from your real environment:
-
-```python
-from opencode_runtime import OpenCodeRuntime
-
-async with OpenCodeRuntime(
-    project_dir="/path/to/project",
-    runtime_dir=".opencode-runtime",
-    materials="./opencode-materials",
-) as r:
-    session = await r.session()
-    response = await session.ask("What does this project do?") 
-    print(response.text)
-```
-
-### Per-user sessions
-
-Each unique `user_id` gets its own isolated server and conversation history:
-
-```python
-from opencode_runtime import OpenCodeRuntime
-
-async with OpenCodeRuntime(runtime_dir=".opencode-runtime") as r:
-    session = await r.session(user_id="u_1")
-    response = await session.ask("What does this project do?")
-    print(response.text)
-```
-
-### Multi-tenant
-
-Add `workspace` to isolate by tenant. Different `(workspace, user_id)` → different server. Same combination → server reused:
-
-```python
-from opencode_runtime import OpenCodeRuntime
-
-async with OpenCodeRuntime(runtime_dir=".opencode-runtime") as r:
-    s1 = await r.session(workspace="org_a", user_id="u_1")
-    s2 = await r.session(workspace="org_b", user_id="u_2")
-    r1 = await s1.ask("What does this project do?")
-    r2 = await s2.ask("List the main dependencies")
-```
-
-### Session continuation
-
-Multiple `ask()` calls on the same session continue the same conversation — OpenCode keeps the full history server-side:
-
-```python
-from opencode_runtime import OpenCodeRuntime
-
-async with OpenCodeRuntime() as r:
-    session = await r.session()
-    await session.ask("Explain this repo")
-    await session.ask("Which file should I start with?")  # has full context
-```
-
-To resume a conversation in a future session, store `session.session_id` and pass it back:
-
-```python
-# First session
-async with OpenCodeRuntime() as r:
-    session = await r.session()
-    await session.ask("Explain this repo")
-    saved_id = session.session_id  # persist this
-
-# Later — resumes the same conversation
-async with OpenCodeRuntime() as r:
-    session = await r.session(session_id=saved_id)
-    await session.ask("What were we discussing?")
-```
-
-### Raw client
-
-Access any OpenCode server endpoint directly:
-
-```python
-from opencode_runtime import OpenCodeRuntime
-
-async with OpenCodeRuntime() as r:
-    session = await r.session()
-    agents = await session.raw_client.get("/agent")
-    mcp    = await session.raw_client.get("/mcp")
-```
-
-### Streaming
-
-For live output, use `stream()`. It yields every event OpenCode emits as an
-`OpenCodeEvent` with three fields: `type` (event kind), `text` (populated for
-text-bearing events, `None` otherwise), and `raw` (full server payload). See
-the [OpenCode server docs](https://opencode.ai/docs/server#events) for all event types.
-
-```python
-from opencode_runtime import OpenCodeRuntime
-
-async with OpenCodeRuntime() as r:
-    session = await r.session()
-    async for event in session.stream("Review this PR"):
-        if event.type == "message.part.delta" and event.text:
-            print(event.text, end="", flush=True)
-```
-
-## CLI
-
-`opencode-runtime` ships with a CLI for managing opencode servers from the terminal. Useful for inspecting what your application is running, debugging sessions, or managing servers independently.
-
-### Start a server
-
-```sh
-opencode-runtime serve
-```
-
-The server runs in the background. Use `ps`, `stop`, and `health` to manage it.
-
-### Multi-tenant
-
-Each unique `(workspace, user-id)` combination gets its own isolated server:
-
-```sh
-opencode-runtime serve --workspace org_a --user-id u_1
-opencode-runtime serve --workspace org_b --user-id u_2
-```
-
-### List servers
-
-```sh
-opencode-runtime ps
-```
-
-```
-  ID                  PID    PORT    STATUS     UPTIME    WORKSPACE   USER    PROJECT
-  ──────────────────────────────────────────────────────────────────────────────────
-  39dce5beb4debfaa   12051   58409   ● alive    Up 5m     org_a       u_1     ~/Developer/myproject
-  81fa29acb3e9210f   12088   58411   ● alive    Up 3m     org_b       u_2     ~/Developer/myproject
-```
-
-### Check health
-
-```sh
-opencode-runtime health 39dce5beb4debfaa
-```
-
-### Stop a server
-
-```sh
-opencode-runtime stop 39dce5beb4debfaa
-```
-
-### Stop all servers
-
-```sh
-opencode-runtime stop-all
-```
-
-### Library + CLI
-
-Start a server from Python, then inspect and manage it from the terminal:
-
-```python
-from opencode_runtime import OpenCodeRuntime
-
-async with OpenCodeRuntime() as r:
-    session = await r.session()
-    response = await session.ask("Review this PR")
-    print(response.text)
-```
-
-```sh
-# while app.py is running
-opencode-runtime ps
-opencode-runtime health 39dce5beb4debfaa
-opencode-runtime stop   39dce5beb4debfaa
-```
-
-## Requirements
-
-- Python 3.10+
-- `opencode` 1.0+ on PATH
-
-## Contributing
-
-See [CONTRIBUTING.md](./CONTRIBUTING.md).
-
-## License
-
-Apache 2.0

opencode_runtime-0.4.0.dist-info/RECORD

@@ -1,16 +0,0 @@
-opencode_runtime/__init__.py,sha256=j6GRSnhDThfOBeAxqJw3oZ2_QwB3IbSK312J37e0ajw,362
-opencode_runtime/cli.py,sha256=byy2ezufQvk5f_e1nwDN8ZIFflIwgvuC9SX7HQGYTkU,8938
-opencode_runtime/client.py,sha256=OtPELbo48XC-r3atNcOpuS54tMNVJq3xKc2DhHZTOwQ,9305
-opencode_runtime/event.py,sha256=Y3QoElyk_tgTNqpSsG2MPo4-rjorTAPBEkoAPyzr8CQ,845
-opencode_runtime/exceptions.py,sha256=uarBFCh8ovI3w4ZB4oQuffv97-5nwTdkZQrkBcOWtWs,471
-opencode_runtime/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-opencode_runtime/registry.py,sha256=rxr3D4iqceskmPBYvRC_lbtME8hoMR4I6rsdYCqllLA,2309
-opencode_runtime/response.py,sha256=p-xTPmPXs1icHk_dgztTMNh7Il1DwBbN775CuOyKfDI,536
-opencode_runtime/runtime.py,sha256=magKzC-kN7g9bsttNhSLEif9hD92_qrHgJgvXDOauYU,5255
-opencode_runtime/server.py,sha256=giYJ2ebCmB5ialgOjsJefpooipCLjSSglkhcZN6z0Yo,12582
-opencode_runtime/session.py,sha256=1CT8phyzpj_jxaLXrp1vC6gKUnebUEwberPwdpIQ9j8,5612
-opencode_runtime-0.4.0.dist-info/METADATA,sha256=69B_qmK1TOGsCC-syndWfcfCjz7AWua0hHdbuMAL1yw,8814
-opencode_runtime-0.4.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
-opencode_runtime-0.4.0.dist-info/entry_points.txt,sha256=4lbdu1KELOg8TD6F7gC-Xrt3VJXdk3RTaH8cQHVy-Tc,63
-opencode_runtime-0.4.0.dist-info/licenses/LICENSE,sha256=EVYfwpsynn_pB9fQ0OhMX-ghTZM10CrFAPv1JbLODi4,11343
-opencode_runtime-0.4.0.dist-info/RECORD,,