Please send x-opencode-session header on API requests (OpenCode Go requires it from 09/05) #5495

thdxr · 2026-09-03T06:18:33Z

thdxr
Sep 3, 2026

Hi - we operate the OpenCode Go managed-inference API, and about 25k of your users orgs call it through deepseek-harness. Starting 09/05, requests without an x-opencode-session header will error on our side (we need a stable per-conversation ID for routing and optimization). We measured all recent harness versions at near-zero header presence, so harness users on Go will break. Ask: include x-opencode-session set to a stable UUID per conversation on all outbound inference HTTP requests. Happy to confirm from our telemetry once a build ships it. Thanks!

thdxr · 2026-09-03T07:31:55Z

thdxr
Sep 3, 2026
Author

we started looking for the deepseek header that has this info so it should be ok

0 replies

thdxr · 2026-09-03T22:42:51Z

thdxr
Sep 3, 2026
Author

Update from our telemetry: we can now see the session header when it arrives, and the picture is model-specific. muse-spark-* requests arrive with session context 74-90% of the time, but deepseek-v4-flash is at ~2.5% and mimo-v2.5 / glm-5.3-flash / everything else are near 0%. Flash is your highest-volume model through us, so that is where most of the breakage will land on 09/06.

So the ask narrows: whatever attaches the session header on the Spark-serving path needs to run on all provider adapters, not just that one. Happy to re-measure the moment a build ships it.

1 reply

JanEickholt Sep 4, 2026

even if telemetry sounds bad, i think it allowed you to jump from 30-60tps to 120-190tps for glm5.3-flash(?) which is crazy work - assuming it's really for better routing (more cache hits and less rejections?) it's likely worth it.

Assume: the hard deadline will break user environments, since DSH is still WIP
-> plugins (community maintained) aren't all made for the latest version of the harness and will therefore break on update

Allowing a bit more generous breakage deadline would be appreciated (likely reason for current downvotes)

RaulLazaro · 2026-09-04T16:42:28Z

RaulLazaro
Sep 4, 2026

Proposed Fix: `sessionHeader` config field

I've investigated this and implemented a fix that adds a new sessionHeader field to the llm-pi-ai provider profile configuration. When set, the adapter sends the named header with the current session id on every request.

The change

packages/llm/llm-pi-ai/src/config.ts:

Added sessionHeader?: string to PiAiProviderProfile interface
Added sessionHeader: z.string() to the profile schema

packages/llm/llm-pi-ai/src/adapter.ts:

Modified requestHeaders() to accept optional sessionHeader and sessionId parameters
Updated streamWithSnapshot() to pass these values from the profile and GenerateOptions.sessionId

Usage

llm-pi-ai:
  providers:
    opencode-go:
      sessionHeader: "x-opencode-session"

This makes every request to OpenCode Go include x-opencode-session: <session-id> where <session-id> is the unique session id from GenerateOptions.sessionId.

Why this approach

The existing headers config only supports static values — all sessions share the same id
GenerateOptions.sessionId is already unique per conversation but was not being used for headers
This is a minimal, non-breaking change: providers that do not set sessionHeader are unaffected

Testing

All existing llm-pi-ai tests pass (config, adapter, catalog, context, convert, dynamic-config, loader-composition — 229 tests total). Typecheck passes.

The code is available at: https://github.com/RaulLazaro/deepseek-harness/tree/feat/opencode-session-header

0 replies

hairyf · 2026-09-04T16:56:24Z

hairyf
Sep 4, 2026

How interesting, would it solve opencode's own problem of reducing intelligence? Why should we have to adapt to it for this

0 replies

yonikremer · 2026-09-04T19:20:14Z

yonikremer
Sep 4, 2026

I am trying to use my opencode go sub with deepseek harness and I get this error:

<!DOCTYPE html>
<html lang="en" dir="ltr" data-locale="en">

<head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <meta property="og:image" content="/social-share.png">
    <meta property="twitter:image" content="/social-share.png">
    <style>
        [data-component="top"] {
            min-height: 80px;
            display: flex;
            align-items: center
        }
    </style>
    <script>window._$HY || (e => { let t = e => e && e.hasAttribute && (e.hasAttribute("data-hk") ? e : t(e.host && e.host.nodeType ? e.host : e.parentNode));["click", "input"].forEach((o => document.addEventListener(o, (o => { if (!e.events) return; let s = t(o.composedPath && o.composedPath()[0] || o.target); s && !e.completed.has(s) && e.events.push([s, o]) })))) })(_$HY = { events: [], completed: new WeakSet, r: {}, fe() { } });</script>
    <!--xs-->
    <link href="/_build/assets/entry-client-VF7ouASi.css" rel="stylesheet" />
    <link href="/_build/assets/i18n-FGYzf9v2.js" rel="modulepreload" />
    <link href="/_build/assets/index-Bi4VkekL.js" rel="modulepreload" />
    <link href="/_build/assets/query-2KXZ8HkE.js" rel="modulepreload" />
    <link href="/_build/assets/action-Dh7AQNie.js" rel="modulepreload" />
    <link href="/_build/assets/HttpStatusCode-qYNerCsA.js" rel="modulepreload" />
    <link href="/_build/assets/entry-client-BoJEquep.js" rel="modulepreload" />
    <meta data-sm="0000000100000000000010" name="description" content="OpenCode - The open source coding agent." />
    <link data-sm="00000001000000000000200" rel="icon" type="image/png" href="/favicon-96x96-v3.png" sizes="96x96" />
    <link data-sm="00000001000000000000210" rel="shortcut icon" href="/favicon-v3.ico" />
    <link data-sm="00000001000000000000220" rel="apple-touch-icon" sizes="180x180" href="/apple-touch-icon-v3.png" />
    <link data-sm="00000001000000000000230" rel="manifest" href="/site.webmanifest" />
    <meta data-sm="00000001000000000000240" name="apple-mobile-web-app-title" content="OpenCode" />
    <title data-sm="000000010000000000010000010">Not Found | opencode</title>
    <link href="/_build/assets/_..-BfykJ4fq.css" rel="stylesheet" />
    <link href="/_build/assets/logo-ornate-dark-CCGQN_4x.js" rel="modulepreload" />
    <link href="/_build/assets/_...404_-D-3nMGsf.js" rel="modulepreload" />
</head>

<body>
    <div id="app"><!--!$e000000-->
        <main data-hk="00000001000000000001000000" data-page="not-found"><!--$--><!--/--><!--$--><!--/-->
            <div data-component="content">
                <section data-component="top"><a href="/" data-slot="logo-link"><img data-slot="logo light"
                            src="data:image/svg+xml,%3csvg%20width='234'%20height='42'%20viewBox='0%200%20234%2042'%20fill='none'%20xmlns='http://www.w3.org/2000/svg'%3e%3cpath%20d='M18%2030H6V18H18V30Z'%20fill='%23CFCECD'/%3e%3cpath%20d='M18%2012H6V30H18V12ZM24%2036H0V6H24V36Z'%20fill='%23656363'/%3e%3cpath%20d='M48%2030H36V18H48V30Z'%20fill='%23CFCECD'/%3e%3cpath%20d='M36%2030H48V12H36V30ZM54%2036H36V42H30V6H54V36Z'%20fill='%23656363'/%3e%3cpath%20d='M84%2024V30H66V24H84Z'%20fill='%23CFCECD'/%3e%3cpath%20d='M84%2024H66V30H84V36H60V6H84V24ZM66%2018H78V12H66V18Z'%20fill='%23656363'/%3e%3cpath%20d='M108%2036H96V18H108V36Z'%20fill='%23CFCECD'/%3e%3cpath%20d='M108%2012H96V36H90V6H108V12ZM114%2036H108V12H114V36Z'%20fill='%23656363'/%3e%3cpath%20d='M144%2030H126V18H144V30Z'%20fill='%23CFCECD'/%3e%3cpath%20d='M144%2012H126V30H144V36H120V6H144V12Z'%20fill='%23211E1E'/%3e%3cpath%20d='M168%2030H156V18H168V30Z'%20fill='%23CFCECD'/%3e%3cpath%20d='M168%2012H156V30H168V12ZM174%2036H150V6H174V36Z'%20fill='%23211E1E'/%3e%3cpath%20d='M198%2030H186V18H198V30Z'%20fill='%23CFCECD'/%3e%3cpath%20d='M198%2012H186V30H198V12ZM204%2036H180V6H198V0H204V36Z'%20fill='%23211E1E'/%3e%3cpath%20d='M234%2024V30H216V24H234Z'%20fill='%23CFCECD'/%3e%3cpath%20d='M216%2012V18H228V12H216ZM234%2024H216V30H234V36H210V6H234V24Z'%20fill='%23211E1E'/%3e%3c/svg%3e"
                            alt="opencode logo light"><img data-slot="logo dark"
                            src="data:image/svg+xml,%3csvg%20width='234'%20height='42'%20viewBox='0%200%20234%2042'%20fill='none'%20xmlns='http://www.w3.org/2000/svg'%3e%3cpath%20d='M18%2030H6V18H18V30Z'%20fill='%234B4646'/%3e%3cpath%20d='M18%2012H6V30H18V12ZM24%2036H0V6H24V36Z'%20fill='%23B7B1B1'/%3e%3cpath%20d='M48%2030H36V18H48V30Z'%20fill='%234B4646'/%3e%3cpath%20d='M36%2030H48V12H36V30ZM54%2036H36V42H30V6H54V36Z'%20fill='%23B7B1B1'/%3e%3cpath%20d='M84%2024V30H66V24H84Z'%20fill='%234B4646'/%3e%3cpath%20d='M84%2024H66V30H84V36H60V6H84V24ZM66%2018H78V12H66V18Z'%20fill='%23B7B1B1'/%3e%3cpath%20d='M108%2036H96V18H108V36Z'%20fill='%234B4646'/%3e%3cpath%20d='M108%2012H96V36H90V6H108V12ZM114%2036H108V12H114V36Z'%20fill='%23B7B1B1'/%3e%3cpath%20d='M144%2030H126V18H144V30Z'%20fill='%234B4646'/%3e%3cpath%20d='M144%2012H126V30H144V36H120V6H144V12Z'%20fill='%23F1ECEC'/%3e%3cpath%20d='M168%2030H156V18H168V30Z'%20fill='%234B4646'/%3e%3cpath%20d='M168%2012H156V30H168V12ZM174%2036H150V6H174V36Z'%20fill='%23F1ECEC'/%3e%3cpath%20d='M198%2030H186V18H198V30Z'%20fill='%234B4646'/%3e%3cpath%20d='M198%2012H186V30H198V12ZM204%2036H180V6H198V0H204V36Z'%20fill='%23F1ECEC'/%3e%3cpath%20d='M234%2024V30H216V24H234Z'%20fill='%234B4646'/%3e%3cpath%20d='M216%2012V18H228V12H216ZM234%2024H216V30H234V36H210V6H234V24Z'%20fill='%23F1ECEC'/%3e%3c/svg%3e"
                            alt="opencode logo dark"></a>
                    <h1 data-slot="title">404 - Page Not Found</h1>
                </section>
                <section data-component="actions">
                    <div data-slot="action"><a href="/">Home</a></div>
                    <div data-slot="action"><a href="/docs">Docs</a></div>
                    <div data-slot="action"><a href="https://github.com/anomalyco/opencode">GitHub</a></div>
                    <div data-slot="action"><a href="/discord">Discord</a></div>
                </section>
            </div>
        </main><!--!$/e000000-->
    </div><!--$-->
    <script type="module" async src="/_build/assets/entry-client-BoJEquep.js"></script><!--/-->
</body>

</html>

Is that related? @thdxr. By the way, the sub works perfectly in claude code

0 replies

Navigation Menu

Uh oh!

Please send x-opencode-session header on API requests (OpenCode Go requires it from 09/05) #5495

Uh oh!

{{title}}

Uh oh!

Replies: 5 comments 1 reply

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{editor}}'s edit

{{editor}}'s edit

Uh oh!

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{editor}}'s edit

{{editor}}'s edit

Uh oh!

Uh oh!

{{title}}

Uh oh!

Select a reply

Uh oh!

Uh oh!

Please send x-opencode-session header on API requests (OpenCode Go requires it from 09/05) #5495

Uh oh!

thdxr Sep 3, 2026

Replies: 5 comments · 1 reply

Uh oh!

thdxr Sep 3, 2026 Author

Uh oh!

thdxr Sep 3, 2026 Author

Uh oh!

Uh oh!

JanEickholt Sep 4, 2026

Uh oh!

RaulLazaro Sep 4, 2026

Proposed Fix: sessionHeader config field

The change

Usage

Why this approach

Testing

Uh oh!

Uh oh!

hairyf Sep 4, 2026

Uh oh!

yonikremer Sep 4, 2026

thdxr
Sep 3, 2026

Replies: 5 comments 1 reply

thdxr
Sep 3, 2026
Author

thdxr
Sep 3, 2026
Author

RaulLazaro
Sep 4, 2026

Proposed Fix: `sessionHeader` config field

hairyf
Sep 4, 2026

yonikremer
Sep 4, 2026