launchdarkly-ai-opencode-agents 0.0.0__tar.gz → 0.2.0__tar.gz

launchdarkly_ai_opencode_agents-0.2.0/.gitignore

@@ -0,0 +1,38 @@
+__pycache__/
+*.pyc
+*.pyo
+.venv/
+dist/
+*.egg-info/
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# macOS
+.DS_Store
+
+# Editor
+.vscode/
+.cursor/
+
+# Logs
+*.log
+
+# Test coverage
+coverage/
+.coverage
+htmlcov/
+
+# Type checking
+.mypy_cache/
+
+# Test cache
+.pytest_cache/
+
+# Run output / scratch
+tmp/
+output/
+
+.claude/

launchdarkly_ai_opencode_agents-0.2.0/CHANGELOG.md

@@ -0,0 +1,31 @@
+# Changelog
+
+## [0.2.0](https://github.com/launchdarkly/python-ai-sdk/compare/launchdarkly-ai-opencode-agents-0.1.0...launchdarkly-ai-opencode-agents-0.2.0) (2026-10-23)
+
+
+### ⚠ BREAKING CHANGES
+
+* **opencode:** start and stop opencode serve in the handler ([#198](https://github.com/launchdarkly/python-ai-sdk/issues/198))
+
+### Features
+
+* **opencode-agents:** add an OpenCode handler ([#159](https://github.com/launchdarkly/python-ai-sdk/issues/159)) ([fc08e8c](https://github.com/launchdarkly/python-ai-sdk/commit/fc08e8c383bfb6e5e505b7a07d57f5bd9dd79a11))
+* **opencode-agents:** emit the AG-UI text and tool subset ([#162](https://github.com/launchdarkly/python-ai-sdk/issues/162)) ([7677621](https://github.com/launchdarkly/python-ai-sdk/commit/7677621a88ba433a2117b1b5a007631cbf7d74d0))
+* **opencode-agents:** open one OpenCode session per call ([#179](https://github.com/launchdarkly/python-ai-sdk/issues/179)) ([b225113](https://github.com/launchdarkly/python-ai-sdk/commit/b225113d66bbc980cb72c3007620bca061ab6035))
+* **opencode-agents:** render agent instruction templates ([#182](https://github.com/launchdarkly/python-ai-sdk/issues/182)) ([83175aa](https://github.com/launchdarkly/python-ai-sdk/commit/83175aa680dc18697ddcc1d17863cdfdaf08d7e6))
+* **opencode:** start and stop opencode serve in the handler ([#198](https://github.com/launchdarkly/python-ai-sdk/issues/198)) ([0748dcf](https://github.com/launchdarkly/python-ai-sdk/commit/0748dcf209076f98cffa38fc59d1987293d5015f))
+
+
+### Bug Fixes
+
+* **opencode-agents:** own the HTTP client ([#194](https://github.com/launchdarkly/python-ai-sdk/issues/194)) ([ed2d419](https://github.com/launchdarkly/python-ai-sdk/commit/ed2d41914ee3f843fe087d754914cd4f2ae1dac8))
+* **opencode-agents:** skip judges and record structured history ([#177](https://github.com/launchdarkly/python-ai-sdk/issues/177)) ([6fadf1d](https://github.com/launchdarkly/python-ai-sdk/commit/6fadf1da3abc49c0a82ffc4c2532484aceac8d76))
+
+## Changelog
+
+## Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

launchdarkly_ai_opencode_agents-0.2.0/PKG-INFO

@@ -0,0 +1,61 @@
+Metadata-Version: 2.5
+Name: launchdarkly-ai-opencode-agents
+Version: 0.2.0
+Summary: OpenCode agent handler for LaunchDarkly AI SDK
+Project-URL: Homepage, https://github.com/launchdarkly/python-ai-sdk
+Project-URL: Repository, https://github.com/launchdarkly/python-ai-sdk
+Project-URL: Bug Tracker, https://github.com/launchdarkly/python-ai-sdk/issues
+Author-email: LaunchDarkly <team@launchdarkly.com>
+License-Expression: Apache-2.0
+Keywords: agents,ai,launchdarkly,opencode
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.12
+Requires-Dist: httpx>=0.27
+Requires-Dist: launchdarkly-ai-server
+Requires-Dist: opentelemetry-api>=1.25
+Description-Content-Type: text/markdown
+
+# `launchdarkly-ai-opencode-agents`
+
+OpenCode handler for `launchdarkly-ai-server`. `async with handler` starts `opencode serve` and waits until it is healthy. The process stops when that context exits. It does not depend on an OpenCode SDK.
+
+**`provides_for`:** `['*', 'agent']` — matches an agent-mode variation for any provider.
+
+```bash
+pip install launchdarkly-ai-server launchdarkly-server-sdk launchdarkly-ai-opencode-agents
+```
+
+```python
+import asyncio
+import os
+
+from launchdarkly_ai_opencode_agents import create_opencode_handler
+from launchdarkly_ai_server import config, init_client, shutdown
+
+
+async def main() -> None:
+    await init_client()
+    handler = create_opencode_handler(
+        cwd="/work",
+        config="/home/app/.vega/opencode.json",
+        env=os.environ.copy(),
+    )
+    async with handler:
+        async for event in config(key="my-agent", handler=handler).stream(
+            "Hello", {"kind": "user", "key": "user-1"}
+        ):
+            print(event)
+    await shutdown()
+
+
+asyncio.run(main())
+```
+
+`cwd` is the working directory, `config` is the OpenCode config file, and `env` is the child environment. The handler sets `OPENCODE_CONFIG` from `config`, replaces any `OPENCODE_SERVER_USERNAME` in `env` with `opencode`, replaces any `OPENCODE_SERVER_PASSWORD` with a generated secret, and binds `opencode serve` to loopback. Requests to that server use that username and secret as basic auth. A caller does not pass a URL, an HTTP client, or a transport. `command` overrides the `opencode` executable; a test passes a fake executable there.
+
+Entering the handler starts `opencode serve` and returns once it is healthy. The process stops when the context exits, after `config().stream()` returns. Put a wall-clock limit around `config().stream()`, not around the context. A judge routed here runs as a full OpenCode agent: the server's tools, in `cwd`, apply to the judge prompt. There is no tool-less judge mode. The handler yields AG-UI text and tool events. `config().stream()` yields `chunk` then `done`.

launchdarkly_ai_opencode_agents-0.2.0/README.md

@@ -0,0 +1,39 @@
+# `launchdarkly-ai-opencode-agents`
+
+OpenCode handler for `launchdarkly-ai-server`. `async with handler` starts `opencode serve` and waits until it is healthy. The process stops when that context exits. It does not depend on an OpenCode SDK.
+
+**`provides_for`:** `['*', 'agent']` — matches an agent-mode variation for any provider.
+
+```bash
+pip install launchdarkly-ai-server launchdarkly-server-sdk launchdarkly-ai-opencode-agents
+```
+
+```python
+import asyncio
+import os
+
+from launchdarkly_ai_opencode_agents import create_opencode_handler
+from launchdarkly_ai_server import config, init_client, shutdown
+
+
+async def main() -> None:
+    await init_client()
+    handler = create_opencode_handler(
+        cwd="/work",
+        config="/home/app/.vega/opencode.json",
+        env=os.environ.copy(),
+    )
+    async with handler:
+        async for event in config(key="my-agent", handler=handler).stream(
+            "Hello", {"kind": "user", "key": "user-1"}
+        ):
+            print(event)
+    await shutdown()
+
+
+asyncio.run(main())
+```
+
+`cwd` is the working directory, `config` is the OpenCode config file, and `env` is the child environment. The handler sets `OPENCODE_CONFIG` from `config`, replaces any `OPENCODE_SERVER_USERNAME` in `env` with `opencode`, replaces any `OPENCODE_SERVER_PASSWORD` with a generated secret, and binds `opencode serve` to loopback. Requests to that server use that username and secret as basic auth. A caller does not pass a URL, an HTTP client, or a transport. `command` overrides the `opencode` executable; a test passes a fake executable there.
+
+Entering the handler starts `opencode serve` and returns once it is healthy. The process stops when the context exits, after `config().stream()` returns. Put a wall-clock limit around `config().stream()`, not around the context. A judge routed here runs as a full OpenCode agent: the server's tools, in `cwd`, apply to the judge prompt. There is no tool-less judge mode. The handler yields AG-UI text and tool events. `config().stream()` yields `chunk` then `done`.

launchdarkly_ai_opencode_agents-0.2.0/agents.md

@@ -0,0 +1,47 @@
+# Agent Guide — `launchdarkly-ai-opencode-agents`
+
+```python
+provides_for = ('*', 'agent')
+```
+
+Each call starts `opencode serve`, speaks the stable HTTP API (`/session`, `/session/{id}/message`, `/event`, `/session/{id}/abort`), and stops the process when the stream finishes or the caller closes it. The package does not import or construct `anomalyco/opencode-sdk-python`.
+
+This package is Python-only. There is no JS counterpart in this slice. The spec section, API surface list, and `usage-ids.txt` row live in `launchdarkly/ai-sdks-monorepo`, which is not this repository. The usage helper ids are `opencode-agents.createOpenCodeHandler` and `opencode-agents.opencodeAgents`. The package is a normal pre-v1 package, same as the other handlers.
+
+## File map
+
+| File | Role |
+| --- | --- |
+| `handler.py` | Reducer, `create_opencode_handler`, `opencode_agents` |
+| `process.py` | Starts and stops `opencode serve` for one call |
+| `server.py` | The HTTP session this process just started |
+| `spans.py` | `invoke_agent` root, and the `chat` / `execute_tool` constructors the parity checks call |
+| `_version.py` | Package name and version sent with usage events |
+
+## Dependencies
+
+`launchdarkly-ai-server`, `httpx`, and `opentelemetry-api`. `launchdarkly-server-sdk` is what `init_client()` loads for a normal process. No OpenCode SDK. The `opencode` executable is the default command.
+
+## init_client
+
+Call `init_client()` before `config()`, the same way as the other handlers. The example in `README.md` does.
+
+## OTel
+
+A run opens one `invoke_agent` span and sets `launchdarkly.operation.type`. The handler stream is the AG-UI text and tool subset. `config().stream()` is `chunk` then `done`.
+
+## Call shape
+
+`create_opencode_handler(*, cwd, config, env, capture_content=None, model=None, agent=None, command=None)` returns a `ProviderHandler`. `cwd` is the working directory. `config` is the path of the OpenCode config file. `env` replaces the child environment, and the handler sets `OPENCODE_CONFIG` from `config`. Each start also sets `OPENCODE_SERVER_USERNAME` to `opencode` and `OPENCODE_SERVER_PASSWORD` to a generated secret, replacing either value inherited from `env`, and sends that pair as basic auth. `command` defaults to `opencode`. A test passes a fake executable instead of a URL. There is no `base_url`, client, or transport argument.
+
+`async with handler` starts the process and returns once `/global/health` returns 200 and `healthy: true`. Concurrent entries share that process. The process stops when the last context exits, after `config().stream()` returns, including when the caller times out or closes the stream. A wall-clock budget goes around `config().stream()`, not around the context. Closing the stream still aborts the session. Without the context, one call starts and stops its own process.
+
+Assistant text is emitted only after `message.updated` marks that message `role == "assistant"`. A part snapshot is the full text of that part so far; a later delta appends. A text delta without `partID` is dropped.
+
+## Common pitfalls
+
+`provides_for` is `('*', 'agent')`, so a judge is routed here too. Each call starts its own process, so the judge prompt does not enter the agent's session and does not need `skip_judges=True`. The judge still runs as a full OpenCode agent, with the server's tools, in `cwd`. This package does not take a tool-less judge agent.
+
+The reducer does not adopt the first session on the bus. Other sessions are dropped, including their `session.error`. `session.idle` for this session ends the run.
+
+`env` is not merged with the parent environment. A bare `opencode` command needs `PATH` in `env`.

launchdarkly_ai_opencode_agents-0.2.0/api-report/launchdarkly_ai_opencode_agents.txt

@@ -0,0 +1,4 @@
+# Public API of launchdarkly_ai_opencode_agents. Generated by `make api-report`; do not edit.
+create_opencode_handler(*, cwd: str | os.PathLike[str], config: str | os.PathLike[str], env: Mapping[str, str], capture_content: bool | None = None, model: ModelResolver | None = None, agent: str | None = None, command: Command = None) -> ProviderHandler
+opencode_agents(config_key: str, user_input: str, context: dict[str, Any], **kwargs: Any) -> Any
+OpenCodeSessionError(Exception)  [class]

launchdarkly_ai_opencode_agents-0.2.0/pyproject.toml

@@ -0,0 +1,34 @@
+[project]
+name = "launchdarkly-ai-opencode-agents"
+version = "0.2.0"
+requires-python = ">=3.12"
+dependencies = [
+  "launchdarkly-ai-server",
+  "httpx>=0.27",
+  "opentelemetry-api>=1.25",
+]
+description = "OpenCode agent handler for LaunchDarkly AI SDK"
+readme = "README.md"
+license = "Apache-2.0"
+authors = [{name = "LaunchDarkly", email = "team@launchdarkly.com"}]
+keywords = ["launchdarkly", "ai", "opencode", "agents"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: Apache Software License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: Software Development :: Libraries",
+]
+
+[project.urls]
+Homepage = "https://github.com/launchdarkly/python-ai-sdk"
+Repository = "https://github.com/launchdarkly/python-ai-sdk"
+"Bug Tracker" = "https://github.com/launchdarkly/python-ai-sdk/issues"
+
+[build-system]
+requires = ["hatchling>=1.32,<2"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/launchdarkly_ai_opencode_agents"]

launchdarkly_ai_opencode_agents-0.2.0/src/launchdarkly_ai_opencode_agents/__init__.py

@@ -0,0 +1,17 @@
+"""LaunchDarkly AI SDK - integration for OpenCode agents.
+
+See https://launchdarkly.com/docs for usage.
+"""
+
+from launchdarkly_ai_server import register_ai_sdk_package
+
+from ._version import PACKAGE_NAME, __version__
+from .handler import OpenCodeSessionError, create_opencode_handler, opencode_agents
+
+__all__ = [
+    "OpenCodeSessionError",
+    "create_opencode_handler",
+    "opencode_agents",
+]
+
+register_ai_sdk_package(PACKAGE_NAME, __version__)

launchdarkly_ai_opencode_agents-0.2.0/src/launchdarkly_ai_opencode_agents/_version.py

@@ -0,0 +1,4 @@
+"""This package's identity, as sent with ``$ld:ai:sdk:info`` and ``$ld:ai:sdk:usage``."""
+
+PACKAGE_NAME = "launchdarkly-ai-opencode-agents"
+__version__ = "0.2.0"  # x-release-please-version