zai-org / zai-org/feedback

Send x-opencode-session header on API requests (required by OpenCode Go from 09/05)

Open
#492 14 comments 83 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

priority: P2
Dominant language
No language data
Stars
22
Forks
1
PR merge metrics
No merged PRs in 30d

Description

Hi — we operate the OpenCode Go managed-inference API, and a large share of your users call it through ZCode (UA ZCode/3.x, ~33k orgs in the last week).

Starting 09/05, requests without an x-opencode-session header will error on our side — we need a stable per-conversation ID for routing/optimization. We measured all current ZCode builds (incl. 3.10.2) at ~0% header presence, so every ZCode user on Go will break unless the client sends it.

Ask: include x-opencode-session: <stable-id-per-conversation> on all outbound inference HTTP requests. Any stable UUID per conversation works; it just needs to be consistent across requests in the same session.

Happy to confirm the fix from our telemetry once a build ships with it. Thanks!

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by locating the entry point that sends outbound inference HTTP requests and the state representing a conversation. Trace how requests in one conversation are grouped, then ensure each request carries the same stable x-opencode-session value while different conversations can use different values. Done means all outbound inference requests include the required header.

Written by the indexing model from the issue text.

Assessment

Domain
api, backend-api-design
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
65/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.