İçeriğe geç

SDK

OpenCode'u kendi betiklerinizden, CI işlerinizden ve araçlarınızdan yönetin. SDK, OpenCode'u kendi yapılandırmanız ve modellerinizle sürecinizin içinde çalıştırır. Tipli istemcisi oturum oluşturur, prompt gönderir ve her olayı aktarır.

Özellikler

CI'ı koddan düzelt

Kısa bir betik OpenCode'dan başarısız testleri düzeltmesini ister ve testleri yeniden çalıştırır.

Her adımı izle

Ajanın çağırdığı her aracı anında görmek için olayları aktarın.

Kendi araçların

OpenCode'u birkaç satırla botlara, panolara ve iş akışlarına bağlayın.

Kendi sürecinizde

OpenCode'u kendi yapılandırmanız ve modellerinizle sürecinizin içinde çalıştırır.

  • TypeScript istemcisi@opencode/client ile aynı değerlere sahip tipli istekler ve olaylar.
  • Koddan oturumlarHerhangi bir betikten oturum oluşturun ve prompt gönderin.
  • Her modelOpenCode kurulumunuzdaki modelleri kullanır.
  • npm ya da bunnpm i @opencode/sdk ya da bun add @opencode/sdk ile kurun.
  • Süreç içi hostOpenCode'u ağ adımı olmadan bellekte çalıştırır.
  • EklentilerinizSüreç içi host'u oluştururken kendi eklentilerinizi verin.
  • Promise ya da EffectAynı değerlerle bir Promise API'si ve bir Effect API'si.
  • Cloudflare WorkersOpenCode'u Workers üzerinde bir Cloudflare Durable Object içinde çalıştırın.

  • npmnpm i @opencode/sdk
  • bunbun add @opencode/sdk
SDK dokümanlarını okuyun

Yenilikler

  1. v2.3.1

    Timed-Out Shell Commands Keep Running

    A shell command still running when its timeout expires now moves to the background instead of being killed, so long builds and test runs finish and report back. A foreground timeout: 0 now means the default 120 seconds.#63699

    Compaction Without the Wait

    As a session nears automatic compaction, the summary is now written in the background, so your next prompt doesn't pause for it. Set compaction.background: false to turn it off; a background summary that ends up unused still costs tokens.#64290

    v2.3.1 sürümünün tüm öne çıkanlarını gör

    İyileştirmeler

    • Core, SDKServer requests that crash now return a 500 with a readable JSON UnknownError body instead of an empty one. Storage problems name the cause (for example "Storage is full" or "Storage is read-only"); other crashes include a ref you can find in the server log.#64022
    • Core, SDKExperimental schedules are now automations, behind the automations flag (the old schedules flag still works). An automation runs on a time, an interval, a cron or a pushed MCP event, and either sends a prompt (to the creating session, another session or a new subagent) or runs a Code Mode program that decides whether to send one. Use /automation or the automation_* tools. Active or paused plain prompt schedules carry over; schedules with a condition or run limit, and finished ones, are dropped.#64160

    Düzeltmeler

    • SDKApps embedding the SDK with an in-memory database no longer import the user's legacy auth.json credentials. Only a database file opened by path imports them.#63716
  2. v2.3.0

    Event subscriptions can now receive experimental.mcp.event events from MCP event subscriptions

    v2.3.0 sürümünün tüm öne çıkanlarını gör

    İyileştirmeler

    • SDKModel capability schemas now advertise supported freeform tool-input formats.
    • SDKSession throughput is now measured from the first streamed token.
    • SDKSession creation documentation now clarifies the parentID field.
  3. v2.2.7

    session.generate returns tokens and cost along with text

    v2.2.7 sürümünün tüm öne çıkanlarını gör

    Uyumsuz değişiklikler

    SDK: fewer endpoints wait for plugins to load

    On a Location that is still loading plugins, agent.list returns the agents loaded so far, and integration.list, usage.limits, vcs.init, rpc.call and artifact.* no longer wait up to 5 seconds. Entries and actions that a plugin provides appear when it finishes loading, so refresh on the matching *.updated event. Model, provider, generate.*, voice.* and websearch.query endpoints still wait.

    #62796#63040

    İyileştirmeler

    • SDKcredential.updated includes the integrationID and credentialID of the login that changed.#62762
    • SDKPredicate questions in client.experimental.generate.decisions accept optional criteria: { true?, false? }.#62819
Tüm güncellemeleri gör