تخطَّ إلى المحتوى

SDK

تحكّم في OpenCode من سكربتاتك ومهام CI وأدواتك. يشغّل SDK OpenCode داخل عمليتك، بإعداداتك ونماذجك، وينشئ عميله المُنمّط الجلسات ويرسل المطالبات ويبث كل حدث.

الميزات

أصلح CI من الكود

سكربت قصير يطلب من OpenCode إصلاح الاختبارات الفاشلة، ثم يشغّلها من جديد.

تابع كل خطوة

ابثّ الأحداث لترى كل أداة يستدعيها الوكيل لحظة استدعائها.

ابنِ أدواتك

اربط OpenCode بالروبوتات ولوحات المعلومات وسير العمل ببضعة أسطر.

داخل عمليتك

يشغّل OpenCode داخل عمليتك، بإعداداتك ونماذجك.

  • عميل TypeScriptطلبات وأحداث مُنمّطة، بنفس قيم @opencode/client.
  • جلسات من الكودأنشئ الجلسات وأرسل المطالبات من أي سكربت.
  • أي نموذجيستخدم النماذج المضبوطة في إعداد OpenCode لديك.
  • npm أو bunثبّته عبر npm i @opencode/sdk أو bun add @opencode/sdk.
  • مضيف داخل العمليةيشغّل OpenCode في الذاكرة، دون المرور بالشبكة.
  • ملحقاتكمرّر ملحقاتك عند إنشاء المضيف داخل العملية.
  • Promise أو Effectواجهة Promise API وواجهة Effect API بنفس القيم.
  • Cloudflare Workersشغّل OpenCode داخل Cloudflare Durable Object على Workers.

  • npmnpm i @opencode/sdk
  • bunbun add @opencode/sdk
اقرأ وثائق SDK

سجل التغييرات

  1. v2.2.7

    session.generate returns tokens and cost along with text

    كل أبرز ما في v2.2.7

    تغييرات جذرية

    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

    تحسينات

    • 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
  2. v2.2.6

    Improvements

    كل أبرز ما في v2.2.6

    تحسينات

    • SDKAdded client.experimental.job.list() and its Effect equivalent for listing background shell, subagent, and image jobs, with session, descendant, kind, and status filters.#60698
    • SDKServer embedders can provide a custom fetch implementation for OpenCode HTTP, model, web, and remote MCP traffic.#61582
  3. v2.2.4

    Publish Interactive Artifacts

    Enable "experimental": { "artifacts": true } in opencode.json to let agents publish, update, and serve HTML or static artifacts through the built-in local provider or plugin-provided storage.#60351

    كل أبرز ما في v2.2.4

    تحسينات

    • SDKExtended client.experimental.persistentPty.update to rename terminals or clear a user title, and exposed userTitle plus persistent-pty.updated events.#60329
كل التحديثات