Skip to content

Solution for long term memory for agent coding CLIs and to facilitate handoff between different agent vendors

Rust

fix(opencode): route Zen models by API transport

Lucas Oliveirafef95a058da8
diff --git a/CHANGELOG.md b/CHANGELOG.md
index ca172515..ec2859ee 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -118,6 +118,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
subagent under its parent's session id, so a subagent's events no longer
mark that session as a subagent: the parent's Stop, SessionEnd, summary and
handoff are kept. (#1041, #1048)
+- The OpenCode provider now selects the published Zen endpoint for supported
+ models: Responses, Anthropic Messages, or OpenAI-compatible Chat Completions.
+ (#1080)
### Docs
- Corrected the Codex support matrix to describe managed-run recovery from a
diff --git a/crates/ai-memory-llm/src/lib.rs b/crates/ai-memory-llm/src/lib.rs
index b9d5b2b2..efcf3565 100644
--- a/crates/ai-memory-llm/src/lib.rs
+++ b/crates/ai-memory-llm/src/lib.rs
@@ -16,8 +16,8 @@
//! * **OpenAI**: `response_format = { type: "json_schema", strict: true }`.
//! * **OpenAI OAuth/Codex**: ChatGPT/Codex Responses API with
//! `text.format = { type: "json_schema", strict: true }`.
-//! * **OpenCode Go**: Responses API for GPT-5.6 Luna; OpenAI-compatible Chat
-//! Completions for the rest of the catalogue.
+//! * **OpenCode Zen/Go**: model-published Responses, Anthropic Messages, or
+//! OpenAI-compatible Chat Completions transport.
//! * **GitHub Copilot**: GitHub token exchange to a short-lived Copilot API
//! token, then OpenAI-style Chat Completions with JSON schema format.
//! * **Gemini**: `generationConfig.responseMimeType = "application/json"`
diff --git a/crates/ai-memory-llm/src/opencode.rs b/crates/ai-memory-llm/src/opencode.rs
index da876841..1afdb941 100644
--- a/crates/ai-memory-llm/src/opencode.rs
+++ b/crates/ai-memory-llm/src/opencode.rs
@@ -1,7 +1,7 @@
//! OpenCode Go/Zen provider.
//!
-//! Selects the wire API published for each model: GPT-5.6 Luna uses the
-//! Responses API and other models use OpenAI-compatible Chat Completions.
+//! Selects the wire API published for each model: Responses, Anthropic Messages,
+//! or OpenAI-compatible Chat Completions.
//! Defaults to Go's catalogue at `https://opencode.ai/zen/go/v1`; set
//! `AI_MEMORY_LLM_BASE_URL` (or call [`OpenCodeProvider::with_base_url`]) to
//! point at Zen's general catalogue instead. Accepts an `sk-...` API key from
@@ -15,6 +15,7 @@ use async_trait::async_trait;
use secrecy::{ExposeSecret, SecretString};
use serde::{Deserialize, Serialize};
+use crate::AnthropicProvider;
use crate::error::{LlmError, LlmResult};
use crate::openai::{
STRUCTURED_OUTPUT_SCHEMA_NAME, enforce_strict_object_schemas, normalize_openai_base,
@@ -45,8 +46,8 @@ pub const OPENCODE_SESSION_HEADER: &str = "x-opencode-session";
/// OpenCode Go LLM provider.
///
/// Routes through `https://opencode.ai/zen/go/v1` using the model's published
-/// Responses or Chat Completions wire format. Authenticate with the `sk-...`
-/// key obtained from <https://opencode.ai/auth>.
+/// Responses, Anthropic Messages, or Chat Completions wire format. Authenticate
+/// with the `sk-...` key obtained from <https://opencode.ai/auth>.
pub struct OpenCodeProvider {
transport: OpenCodeTransport,
}
@@ -54,6 +55,7 @@ pub struct OpenCodeProvider {
enum OpenCodeTransport {
ChatCompletions(OpenAiCompatProvider),
Responses(OpenCodeResponsesProvider),
+ AnthropicMessages(AnthropicProvider),
}
impl OpenCodeProvider {
@@ -72,13 +74,18 @@ impl OpenCodeProvider {
) -> LlmResult<Self> {
let model = model.into();
let base_url = base_url.into();
- let transport = if model_uses_responses_api(&model) {
- OpenCodeTransport::Responses(OpenCodeResponsesProvider::new(api_key, model, base_url)?)
- } else {
- OpenCodeTransport::ChatCompletions(
+ let transport = match model_api(&model) {
+ OpenCodeApi::Responses => OpenCodeTransport::Responses(OpenCodeResponsesProvider::new(
+ api_key, model, base_url,
+ )?),
+ OpenCodeApi::AnthropicMessages => OpenCodeTransport::AnthropicMessages(
+ AnthropicProvider::new(api_key, model)?
+ .with_base_url(anthropic_base_url(&base_url)),
+ ),
+ OpenCodeApi::ChatCompletions => OpenCodeTransport::ChatCompletions(
OpenAiCompatProvider::new(base_url, Some(api_key), model)?
.with_client_headers(crate::DEFAULT_USER_AGENT, OPENCODE_SESSION_HEADER),
- )
+ ),
};
Ok(Self { transport })
}
@@ -106,6 +113,9 @@ impl OpenCodeProvider {
OpenCodeTransport::Responses(provider) => {
OpenCodeTransport::Responses(provider.with_timeout_secs(secs))
}
+ OpenCodeTransport::AnthropicMessages(provider) => {
+ OpenCodeTransport::AnthropicMessages(provider.with_timeout_secs(secs))
+ }
};
self
}
@@ -120,6 +130,9 @@ impl OpenCodeProvider {
OpenCodeTransport::Responses(provider) => {
OpenCodeTransport::Responses(provider.with_reasoning_effort(effort))
}
+ OpenCodeTransport::AnthropicMessages(provider) => {
+ OpenCodeTransport::AnthropicMessages(provider.with_reasoning_effort(effort))
+ }
};
self
}
@@ -137,6 +150,9 @@ impl OpenCodeProvider {
OpenCodeTransport::Responses(provider) => {
OpenCodeTransport::Responses(provider.with_base_url(url))
}
+ OpenCodeTransport::AnthropicMessages(provider) => OpenCodeTransport::AnthropicMessages(
+ provider.with_base_url(anthropic_base_url(&url)),
+ ),
};
self
}
@@ -153,6 +169,9 @@ impl OpenCodeProvider {
OpenCodeTransport::Responses(provider) => {
OpenCodeTransport::Responses(provider.with_extra_headers(headers))
}
+ OpenCodeTransport::AnthropicMessages(provider) => {
+ OpenCodeTransport::AnthropicMessages(provider.with_extra_headers(headers))
+ }
};
self
}
@@ -162,6 +181,7 @@ impl OpenCodeProvider {
match &self.transport {
OpenCodeTransport::ChatCompletions(provider) => provider.base_url(),
OpenCodeTransport::Responses(provider) => &provider.base_url,
+ OpenCodeTransport::AnthropicMessages(_) => "",
}
}
}
@@ -176,6 +196,7 @@ impl LlmProvider for OpenCodeProvider {
match &self.transport {
OpenCodeTransport::ChatCompletions(provider) => provider.model(),
OpenCodeTransport::Responses(provider) => &provider.model,
+ OpenCodeTransport::AnthropicMessages(provider) => provider.model(),
}
}
@@ -198,6 +219,7 @@ impl LlmProvider for OpenCodeProvider {
OpenCodeTransport::Responses(provider) => {
provider.complete(request, operation_id).await
}
+ OpenCodeTransport::AnthropicMessages(provider) => provider.complete(request).await,
}
}
@@ -227,16 +249,98 @@ impl LlmProvider for OpenCodeProvider {
.complete_structured(request, schema, operation_id)
.await
}
+ OpenCodeTransport::AnthropicMessages(provider) => {
+ provider.complete_structured_raw(request, schema).await
+ }
}
}
}
-fn model_uses_responses_api(model: &str) -> bool {
- // OpenCode Go publishes Luna only through /responses. Its
- // /chat/completions route returns an internal-server error for these calls.
- model.eq_ignore_ascii_case("gpt-5.6-luna")
+enum OpenCodeApi {
+ Responses,
+ AnthropicMessages,
+ ChatCompletions,
}
+fn model_api(model: &str) -> OpenCodeApi {
+ if matches_model(model, RESPONSES_MODELS) {
+ OpenCodeApi::Responses
+ } else if matches_model(model, ANTHROPIC_MESSAGES_MODELS) {
+ OpenCodeApi::AnthropicMessages
+ } else {
+ OpenCodeApi::ChatCompletions
+ }
+}
+
+fn matches_model(model: &str, models: &[&str]) -> bool {
+ models
+ .iter()
+ .any(|candidate| model.eq_ignore_ascii_case(candidate))
+}
+
+fn anthropic_base_url(base_url: &str) -> String {
+ base_url
+ .trim_end_matches('/')
+ .strip_suffix("/v1/messages")
+ .or_else(|| base_url.trim_end_matches('/').strip_suffix("/v1"))
+ .unwrap_or_else(|| base_url.trim_end_matches('/'))
+ .to_string()
+}
+
+const RESPONSES_MODELS: &[&str] = &[
+ "gpt-6-astra",
+ "gpt-6-sol",
+ "gpt-6.1-sol",
+ "gpt-6-luna",
+ "gpt-5.6-sol",
+ "gpt-5.6-terra",
+ "gpt-5.6-luna",
+ "gpt-5.5",
+ "gpt-5.5-pro",
+ "gpt-5.4",
+ "gpt-5.4-pro",
+ "gpt-5.4-mini",
+ "gpt-5.4-nano",
+ "gpt-5.3-codex",
+ "gpt-5.3-codex-spark",
+ "gpt-5.2",
+ "gpt-5.2-codex",
+ "gpt-5.1",
+ "gpt-5.1-codex",
+ "gpt-5.1-codex-max",
+ "gpt-5.1-codex-mini",
+ "gpt-5",
+ "gpt-5-codex",
+ "gpt-5-nano",
+ "grok-4.7",
+ "grok-4.6",
+ "grok-4.5",
+ "grok-build-0.1",
+ "muse-spark-1.3",
+ "muse-spark-1.2",
+ "muse-spark-1.3-contributor-free",
+];
+
+const ANTHROPIC_MESSAGES_MODELS: &[&str] = &[
+ "claude-fable-5.1",
+ "claude-fable-5",
+ "claude-opus-5.5",
+ "claude-opus-5",
+ "claude-opus-4.8",
+ "claude-opus-4.7",
+ "claude-opus-4.6",
+ "claude-opus-4.5",
+ "claude-sonnet-5",
+ "claude-sonnet-4.6",
+ "claude-sonnet-4.5",
+ "claude-haiku-4.5",
+ "qwen3.8-flash",
+ "qwen3.7-max",
+ "qwen3.7-plus",
+ "qwen3.6-plus",
+ "qwen3.5-plus",
+];
+
struct OpenCodeResponsesProvider {
client: reqwest::Client,
api_key: SecretString,
@@ -486,7 +590,7 @@ mod tests {
fn responses_response_with_content(content: &str) -> serde_json::Value {
json!({
- "model": "gpt-5.6-luna",
+ "model": "gpt-6-luna",
"output": [{
"type": "message",
"content": [{ "type": "output_text", "text": content }],
@@ -495,6 +599,14 @@ mod tests {
})
}
+ fn anthropic_response_with_content(content: &str) -> serde_json::Value {
+ json!({
+ "model": "claude-sonnet-4.6",
+ "content": [{ "type": "text", "text": content }],
+ "usage": { "input_tokens": 1, "output_tokens": 1 },
+ })
+ }
+
fn header_value<'a>(request: &'a Request, name: &str) -> Option<&'a str> {
request
.headers
@@ -530,8 +642,71 @@ mod tests {
assert_eq!(provider.base_url(), "https://opencode.ai/zen/v1");
}
+ #[test]
+ fn luna_models_select_the_responses_transport() {
+ for model in ["gpt-5.6-luna", "gpt-6-luna", "GPT-6-LUNA"] {
+ let provider = OpenCodeProvider::new(SecretString::from("sk-test"), model).unwrap();
+ assert!(matches!(
+ provider.transport,
+ OpenCodeTransport::Responses(_)
+ ));
+ }
+ }
+
+ #[test]
+ fn published_models_select_their_documented_transports() {
+ for model in RESPONSES_MODELS {
+ let provider = OpenCodeProvider::new(SecretString::from("sk-test"), *model).unwrap();
+ assert!(matches!(
+ provider.transport,
+ OpenCodeTransport::Responses(_)
+ ));
+ }
+ for model in ANTHROPIC_MESSAGES_MODELS {
+ let provider = OpenCodeProvider::new(SecretString::from("sk-test"), *model).unwrap();
+ assert!(matches!(
+ provider.transport,
+ OpenCodeTransport::AnthropicMessages(_)
+ ));
+ }
+ }
+
+ #[test]
+ fn chat_completions_models_keep_the_existing_transport() {
+ let provider =
+ OpenCodeProvider::new(SecretString::from("sk-test"), "deepseek-v4-flash").unwrap();
+ assert!(matches!(
+ provider.transport,
+ OpenCodeTransport::ChatCompletions(_)
+ ));
+ }
+
+ #[test]
+ fn responses_provider_preserves_custom_base_url() {
+ let provider = OpenCodeProvider::new(SecretString::from("sk-test"), "gpt-6-luna")
+ .unwrap()
+ .with_base_url("https://opencode.ai/zen/v1");
+ assert_eq!(provider.base_url(), "https://opencode.ai/zen/v1");
+ }
+
+ #[test]
+ fn responses_endpoint_normalizes_custom_base_urls() {
+ assert_eq!(
+ normalize_openai_base("https://opencode.ai/zen/v1", "responses"),
+ "https://opencode.ai/zen/v1/responses"
+ );
+ assert_eq!(
+ normalize_openai_base("https://opencode.ai/zen", "responses"),
+ "https://opencode.ai/zen/v1/responses"
+ );
+ assert_eq!(
+ normalize_openai_base("https://opencode.ai/zen/v1/responses", "responses"),
+ "https://opencode.ai/zen/v1/responses"
+ );
+ }
+
#[tokio::test]
- async fn luna_completion_uses_responses_api() {
+ async fn gpt_6_luna_completion_uses_responses_api() {
let server = MockServer::start().await;
Mock::given(method("POST"))
.and(path("/v1/responses"))
@@ -543,7 +718,7 @@ mod tests {
let provider = OpenCodeProvider::new_with_base_url(
SecretString::from("sk-test"),
- "gpt-5.6-luna",
+ "gpt-6-luna",
server.uri(),
)
.unwrap();
@@ -554,7 +729,7 @@ mod tests {
.unwrap();
assert_eq!(response.text, "ok");
- assert_eq!(response.model, "gpt-5.6-luna");
+ assert_eq!(response.model, "gpt-6-luna");
assert_eq!(response.usage.unwrap().input_tokens, 1);
let requests = server.received_requests().await.unwrap();
let body: serde_json::Value = serde_json::from_slice(&requests[0].body).unwrap();
@@ -571,6 +746,34 @@ mod tests {
);
}
+ #[tokio::test]
+ async fn claude_completion_uses_anthropic_messages_api() {
+ let server = MockServer::start().await;
+ Mock::given(method("POST"))
+ .and(path("/zen/v1/messages"))
+ .respond_with(
+ ResponseTemplate::new(200).set_body_json(anthropic_response_with_content("ok")),
+ )
+ .mount(&server)
+ .await;
+
+ let provider = OpenCodeProvider::new_with_base_url(
+ SecretString::from("sk-test"),
+ "claude-sonnet-4.6",
+ format!("{}/zen/v1", server.uri()),
+ )
+ .unwrap();
+ let response = provider
+ .complete(ChatRequest::user_prompt("hello"))
+ .await
+ .unwrap();
+
+ assert_eq!(response.text, "ok");
+ let requests = server.received_requests().await.unwrap();
+ assert_eq!(requests.len(), 1);
+ assert_eq!(header_value(&requests[0], "x-api-key"), Some("sk-test"));
+ }
+
#[tokio::test]
async fn luna_structured_completion_uses_responses_api() {
let server = MockServer::start().await;