Internal arsitektur Plugin

​

Alur pemuatan

1. menemukan akar Plugin kandidat
2. membaca manifes bundel native atau kompatibel dan metadata paket
3. menolak kandidat yang tidak aman
4. menormalkan konfigurasi Plugin (plugins.enabled, allow, deny, entries, slots, load.paths)
5. menentukan pengaktifan untuk setiap kandidat
6. memuat modul native yang diaktifkan: modul bundel bawaan menggunakan pemuat native; sumber lokal TypeScript pihak ketiga menggunakan mekanisme cadangan darurat Jiti
7. memanggil kait native register(api) dan mengumpulkan registrasi ke registri Plugin
8. mengekspos registri ke permukaan perintah/waktu jalan

​

Perilaku mengutamakan manifes

• mengidentifikasi Plugin
• menemukan kanal/Skills/skema konfigurasi yang dideklarasikan atau kapabilitas bundel
• memvalidasi plugins.entries.<id>.config
• memperkaya label/placeholder Control UI
• menampilkan metadata instalasi/katalog
• mempertahankan deskriptor aktivasi dan penyiapan yang murah tanpa memuat waktu jalan Plugin

• pemuatan CLI dipersempit ke Plugin yang memiliki perintah utama yang diminta
• penyiapan kanal/resolusi Plugin dipersempit ke Plugin yang memiliki id kanal yang diminta
• penyiapan/resolusi waktu jalan penyedia eksplisit dipersempit ke Plugin yang memiliki id penyedia yang diminta
• perencanaan startup Gateway menggunakan activation.onStartup untuk impor startup eksplisit dan pengecualian startup; Plugin tanpa metadata startup hanya dimuat melalui pemicu aktivasi yang lebih sempit

​

Batas cache Plugin

• PluginLoaderCacheState dan registri waktu jalan aktif yang kompatibel
• cache jiti/modul dan cache pemuat permukaan publik yang digunakan untuk menghindari impor permukaan waktu jalan yang sama berulang kali
• cache sistem file untuk artefak Plugin terpasang
• peta per panggilan berumur pendek untuk normalisasi jalur atau resolusi duplikat

• hasil penemuan
• registri manifes langsung
• registri manifes yang direkonstruksi dari indeks Plugin terpasang
• pencarian pemilik penyedia, penekanan model, kebijakan penyedia, atau metadata artefak publik
• jawaban turunan manifes lainnya yang seharusnya membuat manifes yang berubah, indeks terpasang, atau jalur pemuatan terlihat pada pembacaan metadata berikutnya

​

Model registri

• catatan Plugin (identitas, sumber, asal, status, diagnostik)
• alat
• kait lama dan kait bertipe
• kanal
• penyedia
• handler RPC Gateway
• rute HTTP
• registrar CLI
• layanan latar belakang
• perintah yang dimiliki Plugin

• modul Plugin -> registrasi registri
• waktu jalan inti -> konsumsi registri

​

Callback pengikatan percakapan

export default {
  id: "my-plugin",
  register(api) {
    api.onConversationBindingResolved(async (event) => {
      if (event.status === "approved") {
        // A binding now exists for this plugin + conversation.
        console.log(event.binding?.conversationId);
        return;
      }

      // The request was denied; clear any local pending state.
      console.log(event.request.conversation.conversationId);
    });
  },
};

• status: "approved" atau "denied"
• decision: "allow-once", "allow-always", atau "deny"
• binding: pengikatan yang diselesaikan untuk permintaan yang disetujui
• request: ringkasan permintaan asli, petunjuk pelepasan, id pengirim, dan metadata percakapan

​

Kait waktu jalan penyedia

• Metadata manifes untuk pencarian murah sebelum waktu jalan: setup.providers[].envVars, kompatibilitas usang providerAuthEnvVars, providerAuthAliases, providerAuthChoices, dan channelEnvVars.
• Kait waktu konfigurasi: catalog (discovery lama) ditambah applyConfigDefaults.
• Kait waktu jalan: 40+ kait opsional yang mencakup autentikasi, resolusi model, pembungkusan stream, level berpikir, kebijakan replay, dan endpoint penggunaan. Lihat daftar lengkap di Urutan dan penggunaan kait.

​

Urutan dan penggunaan kait

​

Contoh penyedia

api.registerProvider({
  id: "example-proxy",
  label: "Example Proxy",
  auth: [],
  catalog: {
    order: "simple",
    run: async (ctx) => {
      const apiKey = ctx.resolveProviderApiKey("example-proxy").apiKey;
      if (!apiKey) {
        return null;
      }
      return {
        provider: {
          baseUrl: "https://proxy.example.com/v1",
          apiKey,
          api: "openai-completions",
          models: [{ id: "auto", name: "Auto" }],
        },
      };
    },
  },
  resolveDynamicModel: (ctx) => ({
    id: ctx.modelId,
    name: ctx.modelId,
    provider: "example-proxy",
    api: "openai-completions",
    baseUrl: "https://proxy.example.com/v1",
    reasoning: false,
    input: ["text"],
    cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
    contextWindow: 128000,
    maxTokens: 8192,
  }),
  prepareRuntimeAuth: async (ctx) => {
    const exchanged = await exchangeToken(ctx.apiKey);
    return {
      apiKey: exchanged.token,
      baseUrl: exchanged.baseUrl,
      expiresAt: exchanged.expiresAt,
    };
  },
  resolveUsageAuth: async (ctx) => {
    const auth = await ctx.resolveOAuthToken();
    return auth ? { token: auth.token } : null;
  },
  fetchUsageSnapshot: async (ctx) => {
    return await fetchExampleProxyUsage(ctx.token, ctx.timeoutMs, ctx.fetchFn);
  },
});

​

Contoh bawaan

​

Helper runtime

const clip = await api.runtime.tts.textToSpeech({
  text: "Hello from OpenClaw",
  cfg: api.config,
});

const result = await api.runtime.tts.textToSpeechTelephony({
  text: "Hello from OpenClaw",
  cfg: api.config,
});

const voices = await api.runtime.tts.listVoices({
  provider: "elevenlabs",
  cfg: api.config,
});

• textToSpeech mengembalikan payload output TTS inti normal untuk permukaan file/catatan suara.
• Menggunakan konfigurasi messages.tts inti dan pemilihan penyedia.
• Mengembalikan buffer audio PCM + laju sampel. Plugin harus melakukan resample/encode untuk penyedia.
• listVoices bersifat opsional per penyedia. Gunakan untuk pemilih suara milik vendor atau alur penyiapan.
• Daftar suara dapat menyertakan metadata yang lebih kaya seperti locale, gender, dan tag kepribadian untuk pemilih sadar penyedia.
• OpenAI dan ElevenLabs mendukung telephony saat ini. Microsoft tidak.

api.registerSpeechProvider({
  id: "acme-speech",
  label: "Acme Speech",
  isConfigured: ({ config }) => Boolean(config.messages?.tts),
  synthesize: async (req) => {
    return {
      audioBuffer: Buffer.from([]),
      outputFormat: "mp3",
      fileExtension: ".mp3",
      voiceCompatible: false,
    };
  },
});

• Pertahankan kebijakan TTS, fallback, dan pengiriman balasan di inti.
• Gunakan penyedia speech untuk perilaku sintesis milik vendor.
• Input Microsoft lama edge dinormalisasi ke id penyedia microsoft.
• Model kepemilikan yang disukai berorientasi perusahaan: satu Plugin vendor dapat memiliki penyedia teks, speech, gambar, dan media masa depan saat OpenClaw menambahkan kontrak kapabilitas tersebut.

api.registerMediaUnderstandingProvider({
  id: "google",
  capabilities: ["image", "audio", "video"],
  describeImage: async (req) => ({ text: "..." }),
  transcribeAudio: async (req) => ({ text: "..." }),
  describeVideo: async (req) => ({ text: "..." }),
});

• Pertahankan orkestrasi, fallback, config, dan wiring channel di inti.
• Pertahankan perilaku vendor di Plugin penyedia.
• Ekspansi aditif harus tetap bertipe: metode opsional baru, field hasil opsional baru, kapabilitas opsional baru.
• Pembuatan video sudah mengikuti pola yang sama:
  • inti memiliki kontrak kapabilitas dan helper runtime
  • Plugin vendor mendaftarkan api.registerVideoGenerationProvider(...)
  • Plugin fitur/channel mengonsumsi api.runtime.videoGeneration.*

const image = await api.runtime.mediaUnderstanding.describeImageFile({
  filePath: "/tmp/inbound-photo.jpg",
  cfg: api.config,
  agentDir: "/tmp/agent",
});

const video = await api.runtime.mediaUnderstanding.describeVideoFile({
  filePath: "/tmp/inbound-video.mp4",
  cfg: api.config,
});

const extraction = await api.runtime.mediaUnderstanding.extractStructuredWithModel({
  provider: "codex",
  model: "gpt-5.5",
  input: [
    {
      type: "image",
      buffer: receiptImageBuffer,
      fileName: "receipt.png",
      mime: "image/png",
    },
    { type: "text", text: "Use the printed fields as the source of truth." },
  ],
  instructions: "Return entities and searchable tags.",
  schemaName: "example.evidence",
  jsonSchema: {
    type: "object",
    properties: {
      entities: { type: "array", items: { type: "string" } },
      tags: { type: "array", items: { type: "string" } },
    },
  },
  cfg: api.config,
});

const { text } = await api.runtime.mediaUnderstanding.transcribeAudioFile({
  filePath: "/tmp/inbound-audio.ogg",
  cfg: api.config,
  // Optional when MIME cannot be inferred reliably:
  mime: "audio/ogg",
});

• api.runtime.mediaUnderstanding.* adalah permukaan bersama yang disukai untuk pemahaman gambar/audio/video.
• extractStructuredWithModel(...) adalah seam yang menghadap Plugin untuk ekstraksi milik penyedia yang terbatas dan mengutamakan gambar. Sertakan setidaknya satu input gambar; input teks adalah konteks tambahan. Plugin produk memiliki route dan skemanya, sementara OpenClaw memiliki batas penyedia/runtime.
• Menggunakan konfigurasi audio pemahaman-media inti (tools.media.audio) dan urutan fallback penyedia.
• Mengembalikan { text: undefined } ketika tidak ada output transkripsi yang dihasilkan (misalnya input dilewati/tidak didukung).
• api.runtime.stt.transcribeAudioFile(...) tetap sebagai alias kompatibilitas.

const result = await api.runtime.subagent.run({
  sessionKey: "agent:main:subagent:search-helper",
  message: "Expand this query into focused follow-up searches.",
  provider: "openai",
  model: "gpt-4.1-mini",
  deliver: false,
});

• provider dan model adalah override per-run opsional, bukan perubahan sesi persisten.
• OpenClaw hanya menghormati field override tersebut untuk pemanggil tepercaya.
• Untuk run fallback milik Plugin, operator harus ikut serta dengan plugins.entries.<id>.subagent.allowModelOverride: true.
• Gunakan plugins.entries.<id>.subagent.allowedModels untuk membatasi Plugin tepercaya ke target kanonis provider/model tertentu, atau "*" untuk mengizinkan target apa pun secara eksplisit.
• Run subagent Plugin yang tidak tepercaya tetap berfungsi, tetapi permintaan override ditolak alih-alih diam-diam melakukan fallback.
• Sesi subagent yang dibuat Plugin ditandai dengan id Plugin pembuat. Fallback api.runtime.subagent.deleteSession(...) hanya dapat menghapus sesi yang dimiliki tersebut; penghapusan sesi arbitrer tetap membutuhkan permintaan Gateway berscope admin.

const providers = api.runtime.webSearch.listProviders({
  config: api.config,
});

const result = await api.runtime.webSearch.search({
  config: api.config,
  args: {
    query: "OpenClaw plugin runtime helpers",
    count: 5,
  },
});

• Pertahankan pemilihan penyedia, resolusi kredensial, dan semantik permintaan bersama di inti.
• Gunakan penyedia pencarian web untuk transport pencarian khusus vendor.
• api.runtime.webSearch.* adalah permukaan bersama yang disukai untuk Plugin fitur/channel yang membutuhkan perilaku pencarian tanpa bergantung pada wrapper tool agent.

​

api.runtime.imageGeneration

const result = await api.runtime.imageGeneration.generate({
  config: api.config,
  args: { prompt: "A friendly lobster mascot", size: "1024x1024" },
});

const providers = api.runtime.imageGeneration.listProviders({
  config: api.config,
});

• generate(...): hasilkan gambar menggunakan rantai penyedia pembuatan-gambar yang dikonfigurasi.
• listProviders(...): cantumkan penyedia pembuatan-gambar yang tersedia dan kapabilitasnya.

​

Route HTTP Gateway

api.registerHttpRoute({
  path: "/acme/webhook",
  auth: "plugin",
  match: "exact",
  handler: async (_req, res) => {
    res.statusCode = 200;
    res.end("ok");
    return true;
  },
});

• path: path rute di bawah server HTTP gateway.
• auth: wajib. Gunakan "gateway" untuk mewajibkan autentikasi gateway normal, atau "plugin" untuk autentikasi/verifikasi webhook yang dikelola plugin.
• match: opsional. "exact" (bawaan) atau "prefix".
• replaceExisting: opsional. Memungkinkan plugin yang sama mengganti pendaftaran rute miliknya yang sudah ada.
• handler: kembalikan true ketika rute menangani permintaan.

• api.registerHttpHandler(...) telah dihapus dan akan menyebabkan kesalahan pemuatan plugin. Gunakan api.registerHttpRoute(...) sebagai gantinya.
• Rute plugin harus mendeklarasikan auth secara eksplisit.
• Konflik path + match yang persis ditolak kecuali replaceExisting: true, dan satu plugin tidak dapat mengganti rute plugin lain.
• Rute yang bertumpang tindih dengan tingkat auth berbeda ditolak. Pertahankan rantai fallthrough exact/prefix hanya pada tingkat auth yang sama.
• Rute auth: "plugin" tidak menerima cakupan runtime operator secara otomatis. Rute ini untuk webhook/verifikasi tanda tangan yang dikelola plugin, bukan panggilan pembantu Gateway yang memiliki hak istimewa.
• Rute auth: "gateway" berjalan di dalam cakupan runtime permintaan Gateway, tetapi cakupan tersebut sengaja konservatif:
  • autentikasi bearer rahasia bersama (gateway.auth.mode = "token" / "password") menjaga cakupan runtime rute plugin tetap tersemat ke operator.write, meskipun pemanggil mengirim x-openclaw-scopes
  • mode HTTP tepercaya yang membawa identitas (misalnya trusted-proxy atau gateway.auth.mode = "none" pada ingress privat) menghormati x-openclaw-scopes hanya ketika header tersebut hadir secara eksplisit
  • jika x-openclaw-scopes tidak ada pada permintaan rute plugin yang membawa identitas tersebut, cakupan runtime kembali ke operator.write
• Aturan praktis: jangan menganggap rute plugin dengan auth gateway sebagai permukaan admin implisit. Jika rute Anda membutuhkan perilaku khusus admin, wajibkan mode auth yang membawa identitas dan dokumentasikan kontrak header eksplisit x-openclaw-scopes.

​

Path impor Plugin SDK

• index.js — entri plugin yang dibundel
• api.js — barrel pembantu/tipe
• runtime-api.js — barrel khusus runtime
• setup-entry.js — entri plugin setup

​

Skema alat pesan

• presentation untuk blok presentasi semantik (text, context, divider, buttons, select)
• delivery-pin untuk permintaan pengiriman yang disematkan

​

Resolusi target channel

• messaging.inferTargetChatType({ to }) memutuskan apakah target yang dinormalisasi harus diperlakukan sebagai direct, group, atau channel sebelum lookup direktori.
• messaging.targetResolver.looksLikeId(raw, normalized) memberi tahu core apakah input harus langsung melewati ke resolusi mirip id alih-alih pencarian direktori.
• messaging.targetResolver.reservedLiterals mencantumkan kata polos yang merupakan referensi channel/sesi untuk penyedia tersebut. Resolusi mempertahankan entri direktori yang dikonfigurasi sebelum menolak literal cadangan, lalu gagal tertutup pada lookup direktori yang luput.
• messaging.targetResolver.resolveTarget(...) adalah fallback plugin ketika core membutuhkan resolusi akhir milik penyedia setelah normalisasi atau setelah lookup direktori yang luput.
• messaging.resolveOutboundSessionRoute(...) memiliki konstruksi rute sesi khusus penyedia setelah target di-resolve.

• Gunakan inferTargetChatType untuk keputusan kategori yang sebaiknya terjadi sebelum mencari peer/grup.
• Gunakan looksLikeId untuk pemeriksaan “perlakukan ini sebagai id target eksplisit/native”.
• Gunakan resolveTarget untuk fallback normalisasi khusus penyedia, bukan untuk pencarian direktori yang luas.
• Simpan id native penyedia seperti id chat, id thread, JID, handle, dan id room di dalam nilai target atau params khusus penyedia, bukan di field SDK generik.

​

Direktori berbasis config

• peer DM yang digerakkan allowlist
• peta channel/grup yang dikonfigurasi
• fallback direktori statis bercakupan akun

• pemfilteran kueri
• penerapan batas
• helper deduplikasi/normalisasi
• pembuatan ChannelDirectoryEntry[]

​

Katalog penyedia

• { provider } untuk satu entri penyedia
• { providers } untuk beberapa entri penyedia

• simple: penyedia API-key biasa atau berbasis env
• profile: penyedia yang muncul saat profil autentikasi ada
• paired: penyedia yang menyintesis beberapa entri penyedia terkait
• late: lintasan terakhir, setelah penyedia implisit lainnya

• discovery masih berfungsi sebagai alias lama, tetapi mengeluarkan peringatan penghentian
• jika catalog dan discovery sama-sama terdaftar, OpenClaw menggunakan catalog
• augmentModelCatalog tidak lagi disarankan; penyedia bawaan sebaiknya menerbitkan baris tambahan melalui registerModelCatalogProvider

​

Inspeksi channel baca-saja

• resolveAccount(...) adalah jalur runtime. Jalur ini boleh mengasumsikan kredensial sudah sepenuhnya tersedia dan dapat gagal cepat saat rahasia wajib tidak ada.
• Jalur perintah baca-saja seperti openclaw status, openclaw status --all, openclaw channels status, openclaw channels resolve, dan alur doctor/perbaikan konfigurasi tidak seharusnya perlu menyiapkan kredensial runtime hanya untuk mendeskripsikan konfigurasi.

• Hanya kembalikan status akun deskriptif.
• Pertahankan enabled dan configured.
• Sertakan kolom sumber/status kredensial bila relevan, seperti:
  • tokenSource, tokenStatus
  • botTokenSource, botTokenStatus
  • appTokenSource, appTokenStatus
  • signingSecretSource, signingSecretStatus
• Anda tidak perlu mengembalikan nilai token mentah hanya untuk melaporkan ketersediaan baca-saja. Mengembalikan tokenStatus: "available" (dan kolom sumber yang sesuai) sudah cukup untuk perintah bergaya status.
• Gunakan configured_unavailable saat kredensial dikonfigurasi melalui SecretRef tetapi tidak tersedia di jalur perintah saat ini.

​

Paket package

{
  "name": "my-pack",
  "openclaw": {
    "extensions": ["./src/safety.ts", "./src/tools.ts"],
    "setupEntry": "./src/setup-entry.ts"
  }
}

• pendaftaran kanal itu sendiri
• rute HTTP apa pun yang harus tersedia sebelum Gateway mulai mendengarkan
• metode, alat, atau layanan Gateway apa pun yang harus ada selama jendela yang sama

• singleAccountKeysToMove
• namedAccountPromotionKeys
• resolveSingleAccountPromotionTarget(...)

{
  "name": "@scope/my-channel",
  "openclaw": {
    "extensions": ["./index.ts"],
    "setupEntry": "./setup-entry.ts",
    "startup": {
      "deferConfiguredChannelFullLoadUntilAfterListen": true
    }
  }
}

​

Metadata katalog kanal

{
  "name": "@openclaw/nextcloud-talk",
  "openclaw": {
    "extensions": ["./index.ts"],
    "channel": {
      "id": "nextcloud-talk",
      "label": "Nextcloud Talk",
      "selectionLabel": "Nextcloud Talk (self-hosted)",
      "docsPath": "/channels/nextcloud-talk",
      "docsLabel": "nextcloud-talk",
      "blurb": "Self-hosted chat via Nextcloud Talk webhook bots.",
      "order": 65,
      "aliases": ["nc-talk", "nc"]
    },
    "install": {
      "npmSpec": "@openclaw/nextcloud-talk",
      "localPath": "<bundled-plugin-local-path>",
      "defaultChoice": "npm"
    }
  }
}

• detailLabel: label sekunder untuk permukaan katalog/status yang lebih kaya
• docsLabel: timpa teks tautan untuk tautan docs
• preferOver: id Plugin/kanal berprioritas lebih rendah yang harus dikalahkan entri katalog ini
• selectionDocsPrefix, selectionDocsOmitLabel, selectionExtras: kontrol salinan permukaan pemilihan
• markdownCapable: menandai kanal sebagai mampu markdown untuk keputusan pemformatan keluar
• exposure.configured: sembunyikan kanal dari permukaan daftar kanal yang dikonfigurasi ketika disetel ke false
• exposure.setup: sembunyikan kanal dari pemilih penyiapan/konfigurasi interaktif ketika disetel ke false
• exposure.docs: tandai kanal sebagai internal/privat untuk permukaan navigasi docs
• showConfigured / showInSetup: alias lama yang masih diterima untuk kompatibilitas; utamakan exposure
• quickstartAllowFrom: ikutkan kanal ke alur quickstart standar allowFrom
• forceAccountBinding: wajibkan pengikatan akun eksplisit bahkan ketika hanya ada satu akun
• preferSessionLookupForAnnounceTarget: utamakan pencarian sesi saat menyelesaikan target pengumuman

• ~/.openclaw/mpm/plugins.json
• ~/.openclaw/mpm/catalog.json
• ~/.openclaw/plugins/catalog.json

​

Plugin mesin konteks

import { buildMemorySystemPromptAddition } from "openclaw/plugin-sdk/core";

export default function (api) {
  api.registerContextEngine("lossless-claw", (ctx) => ({
    info: { id: "lossless-claw", name: "Lossless Claw", ownsCompaction: true },
    async ingest() {
      return { ingested: true };
    },
    async assemble({ messages, availableTools, citationsMode }) {
      return {
        messages,
        estimatedTokens: 0,
        systemPromptAddition: buildMemorySystemPromptAddition({
          availableTools: availableTools ?? new Set(),
          citationsMode,
        }),
      };
    },
    async compact() {
      return { ok: true, compacted: false };
    },
  }));
}

import {
  buildMemorySystemPromptAddition,
  delegateCompactionToRuntime,
} from "openclaw/plugin-sdk/core";

export default function (api) {
  api.registerContextEngine("my-memory-engine", (ctx) => ({
    info: {
      id: "my-memory-engine",
      name: "My Memory Engine",
      ownsCompaction: false,
    },
    async ingest() {
      return { ingested: true };
    },
    async assemble({ messages, availableTools, citationsMode }) {
      return {
        messages,
        estimatedTokens: 0,
        systemPromptAddition: buildMemorySystemPromptAddition({
          availableTools: availableTools ?? new Set(),
          citationsMode,
        }),
      };
    },
    async compact(params) {
      return await delegateCompactionToRuntime(params);
    },
  }));
}

​

Menambahkan kapabilitas baru

1. definisikan kontrak inti Tentukan perilaku bersama apa yang harus dimiliki inti: kebijakan, fallback, penggabungan konfigurasi, siklus hidup, semantik yang berhadapan dengan kanal, dan bentuk helper runtime.
2. tambahkan permukaan pendaftaran/runtime Plugin bertipe Perluas OpenClawPluginApi dan/atau api.runtime dengan permukaan kapabilitas bertipe paling kecil yang berguna.
3. rangkai konsumen inti + kanal/fitur Kanal dan Plugin fitur harus mengonsumsi kapabilitas baru melalui inti, bukan dengan mengimpor implementasi vendor secara langsung.
4. daftarkan implementasi vendor Plugin vendor kemudian mendaftarkan backend mereka terhadap kapabilitas tersebut.
5. tambahkan cakupan kontrak Tambahkan tes agar kepemilikan dan bentuk pendaftaran tetap eksplisit seiring waktu.

​

Checklist kapabilitas

• tipe kontrak inti di src/<capability>/types.ts
• helper runner/runtime inti di src/<capability>/runtime.ts
• permukaan pendaftaran API Plugin di src/plugins/types.ts
• perangkaian registry Plugin di src/plugins/registry.ts
• eksposur runtime Plugin di src/plugins/runtime/* ketika Plugin fitur/kanal perlu mengonsumsinya
• helper capture/test di src/test-utils/plugin-registration.ts
• asersi kepemilikan/kontrak di src/plugins/contracts/registry.ts
• docs operator/Plugin di docs/

​

Templat kapabilitas

// core contract
export type VideoGenerationProviderPlugin = {
  id: string;
  label: string;
  generateVideo: (req: VideoGenerationRequest) => Promise<VideoGenerationResult>;
};

// plugin API
api.registerVideoGenerationProvider({
  id: "openai",
  label: "OpenAI",
  async generateVideo(req) {
    return await generateOpenAiVideo(req);
  },
});

// shared runtime helper for feature/channel plugins
const clip = await api.runtime.videoGeneration.generate({
  prompt: "Show the robot walking through the lab.",
  cfg,
});

expect(findVideoGenerationProviderIdsForPlugin("openai")).toEqual(["openai"]);

• core memiliki kontrak kapabilitas + orkestrasi
• Plugin vendor memiliki implementasi vendor
• Plugin fitur/channel menggunakan helper runtime
• pengujian kontrak menjaga kepemilikan tetap eksplisit

​

Terkait

• Arsitektur Plugin — model dan bentuk kapabilitas publik
• Subpath SDK Plugin
• Penyiapan SDK Plugin
• Membangun Plugin