Plugin 아키텍처 내부 구조

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

로드 파이프라인

1. 후보 Plugin 루트 발견
2. 네이티브 또는 호환 번들 매니페스트와 패키지 메타데이터 읽기
3. 안전하지 않은 후보 거부
4. Plugin 구성 정규화(plugins.enabled, allow, deny, entries, slots, load.paths)
5. 각 후보의 활성화 여부 결정
6. 활성화된 네이티브 모듈 로드: 빌드된 번들 모듈은 네이티브 로더를 사용하고, 서드파티 로컬 소스 TypeScript는 비상용 Jiti 폴백을 사용
7. 네이티브 register(api) 훅 호출 및 등록 정보를 Plugin 레지스트리에 수집
8. 명령/런타임 표면에 레지스트리 노출

​

매니페스트 우선 동작

• Plugin 식별
• 선언된 채널/Skills/구성 스키마 또는 번들 기능 발견
• plugins.entries.<id>.config 검증
• Control UI 레이블/플레이스홀더 보강
• 설치/카탈로그 메타데이터 표시
• Plugin 런타임을 로드하지 않고 저비용 활성화 및 설정 설명자 보존

• CLI 로드는 요청된 기본 명령을 소유한 Plugin으로 좁혀집니다
• 채널 설정/Plugin 확인은 요청된 채널 id를 소유한 Plugin으로 좁혀집니다
• 명시적 공급자 설정/런타임 확인은 요청된 공급자 id를 소유한 Plugin으로 좁혀집니다
• Gateway 시작 계획은 명시적 시작 import와 시작 옵트아웃에 activation.onStartup을 사용합니다. 시작 메타데이터가 없는 Plugin은 더 좁은 활성화 트리거를 통해서만 로드됩니다

​

Plugin 캐시 경계

• PluginLoaderCacheState 및 호환 활성 런타임 레지스트리
• 같은 런타임 표면을 반복해서 import하지 않기 위해 사용되는 jiti/모듈 캐시와 공개 표면 로더 캐시
• 설치된 Plugin 아티팩트를 위한 파일 시스템 캐시
• 경로 정규화 또는 중복 해결을 위한 호출별 단기 맵

• 발견 결과
• 직접 매니페스트 레지스트리
• 설치된 Plugin 인덱스에서 재구성된 매니페스트 레지스트리
• 공급자 소유자 조회, 모델 억제, 공급자 정책, 또는 공개 아티팩트 메타데이터
• 변경된 매니페스트, 설치된 인덱스, 또는 로드 경로가 다음 메타데이터 읽기에서 표시되어야 하는 기타 매니페스트 파생 답변

​

레지스트리 모델

• Plugin 레코드(식별자, 소스, 원본, 상태, 진단)
• 도구
• 레거시 훅과 타입이 지정된 훅
• 채널
• 공급자
• Gateway RPC 핸들러
• HTTP 라우트
• CLI 등록자
• 백그라운드 서비스
• Plugin 소유 명령

• Plugin 모듈 -> 레지스트리 등록
• 코어 런타임 -> 레지스트리 소비

​

대화 바인딩 콜백

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" 또는 "denied"
• decision: "allow-once", "allow-always", 또는 "deny"
• binding: 승인된 요청에 대해 해결된 바인딩
• request: 원래 요청 요약, 분리 힌트, 발신자 id, 대화 메타데이터

​

공급자 런타임 훅

• 저비용 사전 런타임 조회를 위한 매니페스트 메타데이터: setup.providers[].envVars, 사용 중단된 호환성 providerAuthEnvVars, providerAuthAliases, providerAuthChoices, channelEnvVars.
• 구성 시점 훅: catalog(레거시 discovery) 및 applyConfigDefaults.
• 런타임 훅: 인증, 모델 확인, 스트림 래핑, 사고 수준, 리플레이 정책, 사용량 엔드포인트를 포괄하는 40개 이상의 선택적 훅. 전체 목록은 훅 순서와 사용법을 참조하세요.

​

훅 순서와 사용법

​

프로바이더 예시

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);
  },
});

​

내장 예시

​

Runtime helper

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는 파일/voice-note 표면을 위한 일반 core TTS 출력 payload를 반환합니다.
• core messages.tts 구성 및 프로바이더 선택을 사용합니다.
• PCM 오디오 버퍼 + 샘플 레이트를 반환합니다. Plugin은 프로바이더에 맞게 리샘플링/인코딩해야 합니다.
• listVoices는 프로바이더별로 선택 사항입니다. 벤더 소유 voice picker 또는 설정 flow에 사용하세요.
• 음성 목록에는 locale, gender, personality tag 같은 더 풍부한 metadata가 포함될 수 있어, 프로바이더 인식 picker에 사용할 수 있습니다.
• OpenAI와 ElevenLabs는 현재 telephony를 지원합니다. Microsoft는 지원하지 않습니다.

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,
    };
  },
});

• TTS 정책, fallback, reply delivery는 core에 두세요.
• 벤더 소유 synthesis 동작에는 speech provider를 사용하세요.
• 레거시 Microsoft edge 입력은 microsoft 프로바이더 ID로 정규화됩니다.
• 선호되는 소유권 모델은 회사 중심입니다. OpenClaw가 이러한 capability contract를 추가함에 따라 하나의 벤더 Plugin이 text, speech, image, 향후 media provider를 소유할 수 있습니다.

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

• orchestration, fallback, config, channel wiring은 core에 두세요.
• 벤더 동작은 프로바이더 Plugin에 두세요.
• 추가 확장은 타입이 지정된 상태를 유지해야 합니다. 새 optional method, 새 optional result field, 새 optional capability를 사용하세요.
• 비디오 생성도 이미 같은 패턴을 따릅니다.
  • core가 capability contract와 runtime helper를 소유합니다
  • 벤더 Plugin이 api.registerVideoGenerationProvider(...)를 등록합니다
  • 기능/channel Plugin이 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.*는 이미지/오디오/비디오 이해를 위한 선호 공유 표면입니다.
• extractStructuredWithModel(...)은 범위가 제한된 프로바이더 소유 image-first extraction을 위한 Plugin-facing seam입니다. 최소 하나의 이미지 입력을 포함하세요. 텍스트 입력은 보조 context입니다. product Plugin은 자체 route와 schema를 소유하고 OpenClaw는 provider/runtime boundary를 소유합니다.
• core media-understanding 오디오 구성(tools.media.audio)과 프로바이더 fallback 순서를 사용합니다.
• transcription 출력이 생성되지 않으면(예: 건너뛴/지원되지 않는 입력) { text: undefined }를 반환합니다.
• api.runtime.stt.transcribeAudioFile(...)는 호환성 alias로 유지됩니다.

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와 model은 persistent session change가 아니라 per-run override(선택 사항)입니다.
• OpenClaw는 trusted caller에 대해서만 이러한 override field를 적용합니다.
• Plugin 소유 fallback run의 경우 operator는 plugins.entries.<id>.subagent.allowModelOverride: true로 opt in해야 합니다.
• trusted Plugin을 특정 canonical provider/model target으로 제한하려면 plugins.entries.<id>.subagent.allowedModels를 사용하고, 명시적으로 모든 target을 허용하려면 "*"를 사용하세요.
• Untrusted Plugin subagent run은 계속 작동하지만, override request는 조용히 fallback되는 대신 거부됩니다.
• Plugin이 생성한 subagent session에는 생성한 Plugin ID가 tag로 지정됩니다. Fallback api.runtime.subagent.deleteSession(...)은 이러한 소유 session만 삭제할 수 있으며, 임의 session deletion에는 여전히 admin-scoped Gateway request가 필요합니다.

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,
  },
});

• 프로바이더 선택, credential resolution, 공유 request semantics는 core에 두세요.
• 벤더별 search transport에는 web-search provider를 사용하세요.
• api.runtime.webSearch.*는 agent tool wrapper에 의존하지 않고 search behavior가 필요한 feature/channel Plugin을 위한 선호 공유 표면입니다.

​

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(...): 구성된 image-generation provider chain을 사용해 이미지를 생성합니다.
• listProviders(...): 사용 가능한 image-generation provider와 그 capability를 나열합니다.

​

Gateway HTTP route

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

• path: gateway HTTP server 아래의 route path입니다.
• auth: 필수입니다. 일반 gateway auth를 요구하려면 "gateway"를 사용하고, Plugin-managed auth/webhook verification에는 "plugin"을 사용하세요.
• match: 선택 사항입니다. "exact"(기본값) 또는 "prefix"입니다.
• replaceExisting: 선택 사항입니다. 같은 Plugin이 자체 기존 route registration을 대체할 수 있게 합니다.
• handler: route가 request를 처리했으면 true를 반환합니다.

• api.registerHttpHandler(...)는 제거되었으며 Plugin 로드 오류를 일으킵니다. 대신 api.registerHttpRoute(...)를 사용하세요.
• Plugin 라우트는 auth를 명시적으로 선언해야 합니다.
• 정확한 path + match 충돌은 replaceExisting: true가 아니면 거부되며, 한 Plugin은 다른 Plugin의 라우트를 대체할 수 없습니다.
• 서로 다른 auth 수준의 중첩 라우트는 거부됩니다. exact/prefix 폴스루 체인은 동일한 auth 수준에서만 유지하세요.
• auth: "plugin" 라우트는 운영자 런타임 범위를 자동으로 받지 않습니다. 이는 권한 있는 Gateway 헬퍼 호출이 아니라 Plugin이 관리하는 Webhook/서명 검증을 위한 것입니다.
• auth: "gateway" 라우트는 Gateway 요청 런타임 범위 안에서 실행되지만, 해당 범위는 의도적으로 보수적입니다.
  • 공유 비밀 bearer auth(gateway.auth.mode = "token" / "password")는 호출자가 x-openclaw-scopes를 보내더라도 Plugin 라우트 런타임 범위를 operator.write에 고정합니다.
  • 신뢰할 수 있는 ID를 포함하는 HTTP 모드(예: private ingress의 trusted-proxy 또는 gateway.auth.mode = "none")는 헤더가 명시적으로 있을 때만 x-openclaw-scopes를 적용합니다.
  • 이러한 ID 포함 Plugin 라우트 요청에서 x-openclaw-scopes가 없으면 런타임 범위는 operator.write로 폴백합니다.
• 실무 규칙: gateway-auth Plugin 라우트를 암시적 관리자 표면이라고 가정하지 마세요. 라우트에 관리자 전용 동작이 필요하다면 ID 포함 auth 모드를 요구하고 명시적 x-openclaw-scopes 헤더 계약을 문서화하세요.

​

Plugin SDK 가져오기 경로

• index.js — 번들 Plugin 엔트리
• api.js — 헬퍼/타입 barrel
• runtime-api.js — 런타임 전용 barrel
• setup-entry.js — 설정 Plugin 엔트리

​

메시지 도구 스키마

• presentation: 의미론적 프레젠테이션 블록(text, context, divider, buttons, select)
• delivery-pin: 고정 전달 요청

​

채널 대상 해석

• messaging.inferTargetChatType({ to })는 정규화된 대상을 디렉터리 조회 전에 direct, group, channel 중 무엇으로 처리할지 결정합니다.
• messaging.targetResolver.looksLikeId(raw, normalized)는 입력이 디렉터리 검색 대신 ID처럼 보이는 해석으로 바로 건너뛰어야 하는지 core에 알려줍니다.
• messaging.targetResolver.resolveTarget(...)은 정규화 후 또는 디렉터리 미스 후 core에 최종 공급자 소유 해석이 필요할 때의 Plugin 폴백입니다.
• messaging.resolveOutboundSessionRoute(...)는 대상이 해석된 뒤 공급자별 세션 라우트 구성을 소유합니다.

• peers/groups 검색 전에 발생해야 하는 범주 결정에는 inferTargetChatType을 사용하세요.
• “이를 명시적/네이티브 대상 ID로 처리”하는 검사에는 looksLikeId를 사용하세요.
• 광범위한 디렉터리 검색이 아니라 공급자별 정규화 폴백에는 resolveTarget을 사용하세요.
• chat id, thread id, JID, handle, room id 같은 공급자 네이티브 ID는 범용 SDK 필드가 아니라 target 값 또는 공급자별 params 안에 유지하세요.

​

설정 기반 디렉터리

• allowlist 기반 DM peers
• 설정된 channel/group 맵
• 계정 범위 정적 디렉터리 폴백

• 쿼리 필터링
• 제한 적용
• 중복 제거/정규화 헬퍼
• ChannelDirectoryEntry[] 빌드

​

공급자 카탈로그

• { provider }: 하나의 공급자 항목
• { providers }: 여러 공급자 항목

• simple: 단순 API 키 또는 env 기반 공급자
• profile: auth profile이 있을 때 나타나는 공급자
• paired: 여러 관련 공급자 항목을 합성하는 공급자
• late: 다른 암시적 공급자 이후의 마지막 패스

• discovery는 레거시 별칭으로 계속 작동하지만 지원 중단 경고를 내보냅니다.
• catalog와 discovery가 모두 등록되면 OpenClaw는 catalog를 사용합니다.
• augmentModelCatalog는 더 이상 권장되지 않습니다. 번들 공급자는 registerModelCatalogProvider를 통해 보조 행을 게시해야 합니다.

​

읽기 전용 채널 검사

• resolveAccount(...)는 런타임 경로입니다. 자격 증명이 완전히 구체화되어 있다고 가정할 수 있으며, 필요한 비밀이 없으면 빠르게 실패할 수 있습니다.
• openclaw status, openclaw status --all, openclaw channels status, openclaw channels resolve, doctor/config repair 흐름 같은 읽기 전용 명령 경로는 설정을 설명하기 위해 런타임 자격 증명을 구체화할 필요가 없어야 합니다.

• 설명적인 계정 상태만 반환하세요.
• enabled와 configured를 보존하세요.
• 관련된 경우 다음과 같은 자격 증명 소스/상태 필드를 포함하세요.
  • tokenSource, tokenStatus
  • botTokenSource, botTokenStatus
  • appTokenSource, appTokenStatus
  • signingSecretSource, signingSecretStatus
• 읽기 전용 가용성을 보고하기 위해 원시 토큰 값을 반환할 필요는 없습니다. 상태 스타일 명령에는 tokenStatus: "available"(및 일치하는 소스 필드)을 반환하는 것으로 충분합니다.
• 자격 증명이 SecretRef로 설정되어 있지만 현재 명령 경로에서 사용할 수 없는 경우 configured_unavailable을 사용하세요.

​

패키지 팩

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

• 채널 등록 자체
• Gateway가 수신을 시작하기 전에 사용할 수 있어야 하는 모든 HTTP route
• 같은 시간 창 동안 존재해야 하는 모든 Gateway method, tool 또는 service

• singleAccountKeysToMove
• namedAccountPromotionKeys
• resolveSingleAccountPromotionTarget(...)

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

​

채널 catalog metadata

{
  "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: 더 풍부한 catalog/status 표면을 위한 보조 label
• docsLabel: docs link의 link text override
• preferOver: 이 catalog entry가 우선해야 하는 낮은 우선순위의 Plugin/channel id
• selectionDocsPrefix, selectionDocsOmitLabel, selectionExtras: selection-surface copy control
• markdownCapable: outbound formatting 결정을 위해 채널을 markdown-capable로 표시
• exposure.configured: false로 설정하면 configured-channel listing 표면에서 채널 숨김
• exposure.setup: false로 설정하면 interactive setup/configure picker에서 채널 숨김
• exposure.docs: docs navigation 표면에서 채널을 internal/private로 표시
• showConfigured / showInSetup: 호환성을 위해 여전히 허용되는 legacy alias; exposure 권장
• quickstartAllowFrom: 채널을 표준 quickstart allowFrom flow에 opt in
• forceAccountBinding: account가 하나만 있어도 명시적 account binding 요구
• preferSessionLookupForAnnounceTarget: announce target을 resolve할 때 session lookup 선호

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

​

컨텍스트 엔진 Plugin

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);
    },
  }));
}

​

새 capability 추가

1. core contract 정의 Core가 소유해야 하는 공유 동작을 결정하세요: policy, fallback, config merge, lifecycle, channel-facing semantic, runtime helper shape.
2. typed Plugin registration/runtime 표면 추가 가장 작고 유용한 typed capability 표면으로 OpenClawPluginApi 및/또는 api.runtime을 확장하세요.
3. core + channel/feature consumer 연결 채널과 feature Plugin은 vendor implementation을 직접 import하지 말고 core를 통해 새 capability를 소비해야 합니다.
4. vendor implementation 등록 그런 다음 vendor Plugin이 해당 capability에 backend를 등록합니다.
5. contract coverage 추가 시간이 지나도 ownership과 registration shape가 명시적으로 유지되도록 test를 추가하세요.

​

Capability checklist

• src/<capability>/types.ts의 core contract type
• src/<capability>/runtime.ts의 core runner/runtime helper
• src/plugins/types.ts의 Plugin API registration 표면
• src/plugins/registry.ts의 Plugin registry wiring
• feature/channel Plugin이 이를 소비해야 할 때 src/plugins/runtime/*의 Plugin runtime exposure
• src/test-utils/plugin-registration.ts의 capture/test helper
• src/plugins/contracts/registry.ts의 ownership/contract assertion
• docs/의 operator/Plugin docs

​

Capability template

// 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가 capability contract + orchestration을 소유
• vendor Plugin이 vendor implementation을 소유
• feature/channel Plugin이 runtime helper를 소비
• contract test가 ownership을 명시적으로 유지

​

관련 항목

• Plugin architecture — public capability model과 shape
• Plugin SDK subpaths
• Plugin SDK setup
• Building plugins