HostApi — 플러그인이 호스트와 대화하는 단일 통로

PluginHostApi 표면 (verbatim)

PluginRuntimeContext

// lvis-plugin-sdk/src/index.ts:1001
export interface PluginRuntimeContext {
  pluginId: string;
  pluginRoot: string;     // dist root
  hostRoot: string;       // host app root
  pluginDataDir: string;  // ~/.lvis/plugins/<id>/
  config?: Record<string, unknown>;
  log: (message: string, meta?: unknown) => void;
  hostApi: PluginHostApi;
}

Lifecycle — start / stop 둘 뿐

// lvis-plugin-sdk/src/index.ts:1036
export interface RuntimePlugin {
  start?: () => Promise<void> | void;
  stop?:  () => Promise<void> | void;
  handlers: Record<string, PluginToolHandler>;  // 도구명 -> 실행 함수
}

// Factory
export type RuntimePluginFactory =
  (context: PluginRuntimeContext) => Promise<RuntimePlugin> | RuntimePlugin;

onInstall/onActivate/onUninstall 같은 플러그인-측 hook은 없습니다. install/uninstall 은 hostApi.onPluginsChanged 로 관찰 만 가능합니다.

plugin.json 의 핵심 필드

• Required: id, name, version, entry, tools, description.
• tools: string[] — 도구 이름. 정규식 ^[a-zA-Z_][a-zA-Z0-9_]*$, maxLength 64. 도트/하이픈 금지 (vendor 요구).
• toolSchemas: 도구별 { description, category: "read"|"write"|"shell"|"network", pathFields?, writesToOwnSandbox?, version?, inputSchema }.
• capabilities: 닫힌 enum 12종 — ms-graph-consumer, external-auth-consumer, mail-source, calendar-source, routine-provider, meeting-recorder, knowledge-index, background-watcher, worker-client, document-indexer, lifecycle-observer, host:overlay.
• keywords, eventSubscriptions, emittedEvents, ui[], auth, pluginAccess, dependencies, configSchema, hostSecrets, llmKeySource, installPolicy, publisher.

실제 사용 예 — work-assistant 가 ms-graph 호출

// lvis-plugin-work-assistant/src/hostPlugin.ts:204
const today = await context.hostApi.callTool("msgraph_calendar_today", {});

// :753 — 미팅 종료 이벤트 구독
context.hostApi.onEvent("meeting.ended", (data) => { ... });

// :441 — 자기 알림 emit
context.hostApi.emitEvent(notificationEventForIntent(intent), payload);