Header sesi nanobot OpenCode Go hilang: pemeriksaan versi dan rute

nanobot mulai mengirim header x-opencode-session pada v0.3.5, yang diterbitkan pada 15 September 2026; rilis hingga v0.3.0 hanya mengirim ID x-session-affinity generik, yang merupakan kesenjangan versi di balik kegagalan header sesi yang hilang terhadap OpenCode Go. Jalankan nanobot --version sebelum mengubah hal lain: jika hasilnya v0.3.0 atau lebih lama, pembaruan tersebut adalah seluruh perbaikan untuk header itu saja. Hal yang tidak diselesaikan oleh pembaruan tersebut adalah bagian lain dari kontrak klien OpenCode Go, dan bagian itulah yang perlu dibaca sebelum Anda menyimpulkan bahwa rute tersebut sehat.

Pertama, satu klarifikasi karena namanya bertabrakan. OpenCode Go di sini adalah langganan model yang masih aktif seharga $10/bulan yang didokumentasikan di opencode.ai/docs/go — bukan agen terminal OpenCode berbasis bahasa Go yang diarsipkan, yang README-nya sendiri menyatakan bahwa proyek tersebut dilanjutkan dengan nama Crush bersama penulis asli dan tim Charm. Ini bukan catatan migrasi untuk produk yang sudah dihentikan; ini adalah halaman pemecahan masalah untuk layanan yang masih dijual dan telah memperketat persyaratan klien. Dan nanobot di sini adalah HKUDS/nanobot, framework agen pribadi Python berlisensi MIT — 48.459 bintang, tidak diarsipkan, terakhir menerima push pada hari pemeriksaan ini (GitHub API, 21 September 2026) — bukan proyek Go dengan nama sama di obot-platform.

Error tersebut, dan versi nanobot yang membawanya

Pemberitahuan yang memulai hal ini diterima pelanggan sebagai notifikasi provider, bukan sebagai dokumentasi. Seorang pengguna mengutipnya secara verbatim dalam anomalyco/opencode#47438, yang dibuka pada 5 September 2026 terhadap klien OpenCode sendiri dan menjelaskannya sebagai notifikasi dari provider model yang diterima melalui email: "Some of your requests to OpenCode Go are missing an x-opencode-session header. If we don't have this we cannot properly optimize our service. Starting 09/06 requests missing this header may error." Tidak ada dokumentasi OpenCode yang kami temukan memuat kata-kata tersebut. Changelog OpenCode, yang dibaca pada 21 September 2026, mencakup 4 Agustus hingga 14 September 2026 pada v1.18.31 dan tidak memiliki entri yang menyebut x-opencode-session sama sekali. Dokumentasi Go OpenCode merumuskannya sebagai permintaan, bukan penolakan: “Kirim ID sesi yang stabil di x-opencode-session untuk setiap percakapan agar kami dapat mengoptimalkan perutean dan caching prompt.”

Tanggal 09/06 itu sendiri memiliki sumber publik resmi, hanya saja bukan sumber dokumentasi: issue #5661 dan PR #5662 nanobot sama-sama mengutip postingan @opencode di X tertanggal 3 September 2026, yang dikutip menyatakan bahwa alat yang tidak memiliki header tersebut kehilangan optimisasi cache prompt dan bahwa "Starting 09/06 requests missing this header may error." Postingan itulah pengumuman yang menjadi dasar penulisan perbaikan nanobot; halaman ini tidak mengambilnya secara independen.

Kegagalan keras tersebut hanya dibuktikan oleh pihak ketiga. vastsa/PI-Desktop#48, yang dibuka dan ditutup pada 7 September 2026, mencatat HTTP 400 dengan "type": "MissingSessionID" dan pesan yang menyatakan bahwa permintaan tidak memiliki x-opencode-session dan tidak dapat diarahkan secara efisien, dengan menunjuk ke anchor dokumentasi Go. Dokumentasi Go OpenCode tidak memiliki referensi error yang mencantumkan kode status atau string tipe tersebut, jadi baca kewajiban yang didokumentasikan dan penolakan yang dilaporkan sebagai dua tingkat kekuatan klaim yang berbeda dari vendor yang sama.

Tidak ada v0.3.1 hingga v0.3.4 dalam riwayat tag, jadi "v0.3.0 dan yang lebih lama" adalah seluruh rentang yang terdampak. Dua pemeriksaan mengonfirmasi pemetaan rilis tersebut pada 21 September 2026, bukan menyimpulkannya: isi rilis mencantumkan PR #5662 berdasarkan nomornya, dan panggilan GitHub compare melaporkan bahwa v0.3.5 memiliki 84 commit lebih banyak dan nol commit lebih sedikit daripada 20f115bf, yang menempatkan commit tersebut di dalam tag. Perhatikan bahwa dokumentasi nanobot v0.3.5 tidak pernah menyebut header tersebut — satu-satunya catatan perubahan adalah catatan rilis, PR, dan issue.

Apa yang sebenarnya dilakukan perbaikan tersebut, dan apa yang memicunya

Dibaca pada tag v0.3.5 di nanobot/providers/openai_compat_provider.py, logikanya singkat dan perlu diketahui secara tepat. nanobot memperlakukan target sebagai target OpenCode ketika spesifikasi provider bernama opencode, opencode_zen, atau opencode_go, atau ketika hostname URL dasar adalah opencode.ai atau subdomainnya. Jika terdapat konteks percakapan, nilai header adalah digest heksadesimal SHA-256 dari ID sesi, sehingga tetap opak dan aman ASCII untuk ID non-ASCII. Jika tidak ada konteks percakapan, instance provider menggunakan UUID acak yang tetap selama masa hidupnya sendiri — stabil untuk instance tersebut, bukan per percakapan. Header yang Anda konfigurasi sendiri mengalahkan keduanya, dengan pencocokan nama yang tidak membedakan huruf besar-kecil.

Klausa hostname adalah kalimat yang perlu diingat: header dilampirkan karena ke mana permintaan dikirim, bukan karena blok provider mana yang Anda tulis. Blok providers.custom generik yang diarahkan ke URL dasar opencode.ai tetap akan mendapatkannya. Permintaan ke host lain mana pun tidak akan mendapatkannya — persyaratan host tersebut adalah urusan vendornya sendiri, dan tidak ada bagian di sini yang menjawabnya.

Pembaruan dilakukan seperti biasa: paket PyPI adalah nanobot-ai, pada versi 0.3.5 dalam pyproject.toml tag tersebut, dan README v0.3.5 mendokumentasikan uv tool install nanobot-ai serta python -m pip install nanobot-ai. Konfirmasikan dengan nanobot --version, atau python -m nanobot --version jika entry point tidak berada di PATH, lalu nanobot status, yang menurut referensi CLI digunakan untuk memeriksa kesiapan provider dan model tanpa memanggil model.

Mengapa OpenCode Go bukan endpoint biasa yang kompatibel dengan OpenAI

Inilah bagian yang membuat perbaikan header terasa belum lengkap. OpenCode Go menyatakan beberapa kondisi sisi klien yang tidak dimiliki URL dasar biasa yang kompatibel dengan OpenAI, dan header sesi hanyalah salah satunya. Semua baris di bawah berasal dari dokumennya sendiri, yang diperiksa pada 21 September 2026.

Baris user agent perlu diperhatikan. PR #5662 hanya mengubah header sesi. Dari pembacaan source nanobot v0.3.5, modul provider yang kompatibel dengan OpenAI — yang melayani spesifikasi opencode, opencode_zen dan opencode_go — tidak menetapkan User-Agent di mana pun, sedangkan modul provider GitHub Copilot, xAI Grok, dan OpenAI Codex masing-masing menetapkan user agent bermerek nanobot. Jadi pada jalur tersebut, permintaan membawa apa pun yang dikirim SDK dasar secara default. Tidak ada permintaan yang dikirim melalui jaringan di sini untuk mengamati nilainya, dan OpenCode belum menerbitkan penegakan untuk baris tersebut, jadi ini adalah pembacaan source, bukan kegagalan yang direproduksi. Solusi yang didokumentasikan adalah header yang Anda tetapkan sendiri — referensi nanobot menjelaskan providers.<name>.extraHeaders sebagai header yang digabungkan ke dalam permintaan provider:

{
  "providers": {
    "opencodeGo": {
      "apiKey": "${OPENCODE_API_KEY}",
      "extraHeaders": { "User-Agent": "nanobot/0.3.5" }
    }
  },
  "modelPresets": {
    "primary": {
      "provider": "opencode_go",
      "model": "opencode-go/<a model OpenCode lists under chat/completions>",
      "maxTokens": 8192,
      "contextWindowTokens": 65536
    }
  }
}

Beri nama klien Anda sendiri secara jujur di sana. Menempatkan salah satu nama klien tervalidasi OpenCode di field tersebut merupakan penyamaran identitas, bukan identifikasi, dan bukan hal yang diminta dokumentasi.

Baris endpoint memiliki konsekuensi khusus nanobot yang tidak dapat diperbaiki oleh header apa pun. Referensi provider v0.3.5 menyatakan untuk menggunakan ID model yang dicantumkan OpenCode di bawah endpoint chat/completions, karena model yang hanya dicantumkan di bawah responses, messages atau endpoint khusus provider tidak ditangani oleh jalur yang kompatibel dengan OpenAI tersebut. Dalam konfigurasi, OpenCode Go adalah providers.opencodeGo dengan preset yang nilai provider-nya adalah opencode_go, dan ID model membawa prefix opencode-go/ yang dihapus nanobot sebelum pengiriman. Terakhir, halaman Go OpenCode menerbitkan daftar klien tervalidasi (Hermes, Claude Code, Codex, ZCode, Pi, jcode, dan Kilo Code CLI) serta daftar klien dengan dukungan sesi yang hilang atau tidak lengkap (DeepSeek Harness, GitHub Copilot Chat, Kimi Code, dan MiMo Code). nanobot tidak ada dalam kedua daftar tersebut per 21 September 2026 — tidak adanya putusan yang dipublikasikan, bukan dukungan dan bukan pemblokiran. Halaman tersebut juga mencatat persyaratan versi per klien yang tidak dicakup di sini, jadi jangan membaca versi minimum untuk klien-klien tersebut dari halaman ini.

Verifikasi dengan satu permintaan yang disamarkan

Dokumentasi nanobot v0.3.5 tidak menjelaskan cara mencetak header keluarannya, jadi konfirmasikan kontrak tersebut secara langsung terhadap langganan Anda sendiri sebelum menyimpulkan apa pun tentang klien. Baca hanya baris status.

# Read the status line only. Key redacted; session id is your own, stable per conversation.
curl -sS -o /dev/null -D - https://opencode.ai/zen/go/v1/chat/completions \
  -H "authorization: Bearer $OPENCODE_API_KEY" \
  -H "x-opencode-session: $(printf 'my-conversation-1' | shasum -a 256 | cut -d' ' -f1)" \
  -H "user-agent: nanobot/0.3.5" \
  -H "content-type: application/json" \
  -d '{"model":"<model-id>","messages":[{"role":"user","content":"ping"}],"max_tokens":8}'

Itu memisahkan dua kegagalan dengan jelas: 400 yang menyebut MissingSessionID berarti header tersebut, dan hal lainnya bukan header tersebut. Jangan mengganti id acak baru pada setiap permintaan hanya agar kesalahan menghilang, dan jangan menggunakan nama milik klien lain. Dokumentasi meminta id yang stabil untuk setiap percakapan tepat karena perutean dan caching prompt mengandalkan id tersebut, sehingga id per permintaan menggagalkan caching yang Anda bayar sambil terlihat seperti perbaikan. Dua jawaban yang sah adalah melakukan upgrade, atau memindahkan beban kerja tersebut ke rute yang tidak memiliki persyaratan itu.

Biayanya dan rute mana yang unggul

Pisahkan perangkat lunak dari token. nanobot sendiri berharga $0 — berlisensi MIT dan di-host sendiri, menurut catatan repositori yang dibaca pada 21 September 2026 — jadi semua yang tercantum di bawah ini adalah tagihan model dan mesin tempat model tersebut berjalan.

Baris Zen berasal dari dokumentasinya sendiri, dibaca pada 21 September 2026; Zen dan Go adalah produk yang ditagihkan secara terpisah, jadi tarif Zen bukanlah tarif yang dibayar pelanggan Go, dan daftar milik Zen sendiri menandai beberapa model sebagai gratis sementara saat provider mengumpulkan masukan. Harga OpenCode mencakup sisi biaya milik klien.

Langganan tersebut tidak dapat dikonversi menjadi tabel di bawah ini, dan berpura-pura sebaliknya adalah kesalahan termudah di sini. Jatah Go dinyatakan dalam dolar dengan tarif per model milik Go sendiri, dan setiap model memiliki batasnya sendiri: contoh yang dikerjakan dalam dokumentasi adalah model seharga $60 per bulan yang memungkinkan penggunaan senilai $12 per 5 jam dan $30 per minggu, sementara baris model yang dibaca pada 21 September 2026 menunjukkan GLM-5.3-Flash seharga $0,15 untuk input dan $0,50 untuk output per 1 juta, dengan batas bulanan $60 dan perkiraan 31.580 permintaan per bulan. Itu adalah perkiraan OpenCode untuk katalognya sendiri, bukan jaminan, dan salah satu baris memuat promosi bertanggal yang berakhir tak lama setelah tulisan ini dibuat. Untuk beban kerja yang cocok dengan daftar model dan jendela waktu Go, $10 dapat membeli banyak penggunaan terukur; perbandingannya sebenarnya adalah apakah model dan lonjakan penggunaan Anda muat di dalamnya.

Gateway terukur menetapkan harga yang berbeda untuk beban kerja yang sama. Ini adalah perhitungan token ilustratif, bukan biaya tugas yang diukur dan bukan batas maksimum tagihan: asumsikan satu asisten nanobot yang menggunakan 3.000.000 token input yang tidak di-cache dan 300.000 token output dalam sebulan, dengan tarif katalog Kunavo per satu juta token yang berlaku saat ini.

Skalakan angka tersebut berdasarkan lalu lintas Anda sendiri sebelum menganggapnya sebagai anggaran, dan perhatikan bahwa jadwal latar belakang dapat mengubah kolom input jauh lebih besar daripada pilihan model — biaya dan penyiapan API nanobot bekerja melalui frekuensi yang diaktifkan nanobot secara default. Jumlah katalog Kunavo adalah batas bawah penagihan, bukan batas maksimum: ketika upstream melaporkan biayanya, tagihan adalah nilai yang lebih besar antara biaya katalog dan biaya upstream dikalikan markup yang berlaku. Biaya cache, alat, dan hosting berada di luar contoh ini, dan isi ulang minimum adalah $10 dalam kredit prabayar — minimum pendanaan, bukan biaya tugas atau langganan. Lihat detail penagihan.

Hal yang dapat dan tidak dapat dibantu Kunavo

Bersikap terus terang tentang hal ini lebih penting daripada melakukan konversi. Kunavo tidak menjual kembali OpenCode Go atau Zen, dan mengarahkan nanobot ke https://api.kunavo.com/v1 tidak memperbaiki langganan OpenCode Go. Sebaliknya, Kunavo menghindari persyaratan tersebut, karena x-opencode-session merupakan milik host opencode.ai — dan berdasarkan aturan nama host dalam sumber v0.3.5, nanobot juga tidak akan menambahkan header tersebut pada URL dasar lainnya. Apa yang akan dilakukan endpoint Kunavo terhadap header semacam itu belum diuji di sini, begitu pula nanobot terhadap Kunavo: tidak ada halaman integrasi nanobot, dan setiap pernyataan konfigurasi di atas merupakan pembacaan dokumentasi vendor dan sumber yang dikirimkan, bukan hasil kompatibilitas.

Jadi, perlakukan rute-rute tersebut sebagai alternatif dengan kompromi yang berbeda, bukan sebagai perbaikan dan solusi sementara. Jika rute yang kompatibel dengan OpenAI dan ditagihkan sesuai pemakaian cocok untuk beban kerja Anda, quickstart menjelaskan konvensi endpoint dan membuat akun Kunavo adalah langkah sebelum mengisi dana untuk sebuah kunci — pertahankan rute yang berfungsi saat mencobanya, jalankan satu tugas yang dibatasi, lalu baca catatan akun Anda tentang tugas tersebut. Jika Anda datang untuk mencari agen terminal Go yang telah diarsipkan, bukan langganannya, dokumentasi integrasi Crush menjelaskan penggantinya, dan dokumentasi integrasi OpenCode menjelaskan klien TypeScript saat ini. Untuk perbandingan yang lebih luas, lihat API yang kompatibel dengan OpenAI dan direktori API agen; untuk kegagalan OpenCode yang berbeda, provider atau model tidak ditemukan adalah diagnostiknya.

Pertanyaan umum

Diperiksa pada 21 September 2026: dokumentasi Go dan Zen opencode.ai serta changelognya; GitHub API untuk rilis, tag, PR #5662, issue #5661, dan panggilan compare yang membuktikan commit tersebut berada di dalam tag v0.3.5; anomalyco/opencode#47438 dan vastsa/PI-Desktop#48 untuk pemberitahuan yang dikutip dan laporan 400; serta arsip sumber v0.3.5 untuk setiap klaim tentang apa yang dikirim nanobot. Tanggal 09/06 ditelusuri ke postingan @opencode di X pada 3 September 2026 yang dikutip oleh issue dan PR nanobot, tetapi halaman ini tidak mengambilnya; pemberitahuan pelanggan yang dikutip dan kontrak kesalahan 400 berasal dari laporan pengguna, dan keduanya tidak muncul dalam dokumentasi atau changelog OpenCode. Tidak ada pihak di sini yang menjalankan nanobot terhadap OpenCode Go atau Kunavo, maupun mereproduksi kegagalan tersebut; tarif token Kunavo berasal dari katalog yang berlaku dan setiap angka dolar adalah perhitungan ilustratif berdasarkan asumsi yang dinyatakan.