@ai-development-environment/control-agent 0.0.119 → 0.0.121
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +53 -0
- package/dist/control-agent.js +20346 -22807
- package/package.json +7 -7
package/README.md
CHANGED
|
@@ -64,6 +64,59 @@ control-agent status
|
|
|
64
64
|
control-agent doctor
|
|
65
65
|
```
|
|
66
66
|
|
|
67
|
+
## OpenCode 2
|
|
68
|
+
|
|
69
|
+
The OpenCode integration requires OpenCode `>=2.1.1 <3`. The agent uses
|
|
70
|
+
`@opencode/client` 2.1.1; the Docker image includes `@opencode/cli` 2.1.1.
|
|
71
|
+
Install the CLI on each machine running a control agent:
|
|
72
|
+
|
|
73
|
+
```bash
|
|
74
|
+
npm install -g @opencode/cli@2.1.1
|
|
75
|
+
# Or, on macOS:
|
|
76
|
+
brew install anomalyco/tap/opencode-v2
|
|
77
|
+
opencode --version
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
OpenCode 1's `opencode-ai` package and the former `@opencode-ai/sdk/v2` entrypoint
|
|
81
|
+
do not provide this integration. Remove a package-managed OpenCode 1 installation
|
|
82
|
+
before installing OpenCode 2, since both expose the `opencode` command. Set
|
|
83
|
+
`CONTROL_AGENT_OPENCODE_EXECUTABLE` to the full executable path when the agent
|
|
84
|
+
should use a specific installation. An invalid override fails explicitly.
|
|
85
|
+
|
|
86
|
+
Connect providers using OpenCode's `/connect` interface or `opencode auth login`.
|
|
87
|
+
Models, credentials, and variants are resolved for each registered worktree.
|
|
88
|
+
The agent starts authenticated services on loopback with private state under
|
|
89
|
+
its configuration directory. Runs with control-plane MCP tools receive their
|
|
90
|
+
own service and connection headers. The agent does not start or stop the user's
|
|
91
|
+
shared OpenCode service.
|
|
92
|
+
|
|
93
|
+
Supported existing configuration and `.opencode/skills` files can remain in
|
|
94
|
+
place. Native v2 MCP configuration groups connections under `mcp.servers`.
|
|
95
|
+
OpenCode 1 plugin implementations require porting to the new plugin API;
|
|
96
|
+
terminal preferences migrate to global `cli.json`. Review the official
|
|
97
|
+
[migration guide](https://opencode.ai/v2/docs/migrate-v1/) and
|
|
98
|
+
[MCP configuration](https://opencode.ai/v2/docs/mcp-servers/).
|
|
99
|
+
|
|
100
|
+
History sync retries while OpenCode's native history migration is pending and
|
|
101
|
+
reports migration errors without replacing saved transcripts. Full native forms
|
|
102
|
+
support typed fields, defaults, conditional visibility, validation, external-step
|
|
103
|
+
acknowledgements, and cancellation. A rejected native answer remains editable.
|
|
104
|
+
|
|
105
|
+
Deploy the server and its additive database migration before upgrading agents.
|
|
106
|
+
Existing questions and answers retain their original representation; new native
|
|
107
|
+
fields are stored alongside it.
|
|
108
|
+
|
|
109
|
+
From the repository root, verify the integration with:
|
|
110
|
+
|
|
111
|
+
```bash
|
|
112
|
+
npm run agent:test:run
|
|
113
|
+
npm run test:opencode-v2
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
The native smoke test requires the CLI. It uses temporary XDG directories and a
|
|
117
|
+
deterministic local model endpoint, then closes its owned service and removes
|
|
118
|
+
the temporary data.
|
|
119
|
+
|
|
67
120
|
The credential and stable agent ID are stored at `~/.config/control-agent/config.json`.
|
|
68
121
|
|
|
69
122
|
## See also
|